Histórico da Página

Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico.

Informações Gerais

Especificação
Produto	Protheus	Módulo	Contabilidade Gerencial
Segmento Executor
Projeto¹	M_CTR010	IRM¹	PCREQ-5853
Requisito¹	PCREQ-5854	Subtarefa¹	M_CTR010-1059
Chamado²
Release de Entrega Planejada		Réplica
País	(X) Brasil ( ) Argentina ( ) Mexico ( ) Chile ( ) Paraguai ( ) Equador ( ) USA ( ) Colombia ( ) Outro _____________.
Outros	<Caso necessário informe outras referências que sejam pertinentes a esta especificação. Exemplo: links de outros documentos ou subtarefas relacionadas>.

Legenda: 1 – Inovação 2 – Manutenção (Os demais campos devem ser preenchidos para ambos os processos).

Objetivo

Definições necessárias à disponibilização no ambiente Protheus Contabilidade Gerencial das funcionalidades para o atendimento da instrução normativa No. 21 de 13/03/79 que uniformiza o procedimento de apuração de resultado de contratos, com prazo de execução superior a um ano, de construção por empreitada.

A apuração será realizada no sistema TIN utilizando serviços do Protheus para consulta de saldos e lançamentos contábeis.

Essa integração será realizada utilizando a tecnologia de mensagem única.

Definição da Regra de Negócio

Rotina	Tipo de Operação	Opção de Menu	Regras de Negócio
CTBA030 - Centro de Custos	Envolvida	Contabilidade / Atualizações/Entidade/Custos
CTBA040 – Item contábil	Alteração	Contabilidade / Atualizações/ Entidade/Custos
CTBA140 – Moedas Contábeis	Envolvida	Contabilidade->Atualizações->Cadastros->Moedas Contábeis
CTBA060 – Classe de Valor	Envolvida	Contabilidade->Atualizações->Entidade->Custos
CTBA102- Lançamento contábil	Envolvido	Contabilidade->Atualizações->Movimentos->Lançamento Contábeis Automáticos
CTBA020 - Plano de Contas	Alteração	Contabilidade / Atualizações/Entidade/Custos
CTBA050 – Entidade Contábil	Envolvido	Contabilidade / Atualizações/ Configurações/Entidades Contábeis
CTBA800 – Cadastros de Entidades	Alteração	Contabilidade / Atualizações/ Configurações/Entidades Contábeis

Esta solução foi criada para integrar o módulo Contabilidade Gerencial do Microsiga Protheus com a funcionalidade presente no pacote CorporeRM também chamado de TIN para a apuração e contabilização do andamento do contrato(POC) .

O módulo TIN da RM desta maneira terá acesso as funcionalidades contábeis do Back Office Microsiga Protheus.

Esta integração utilizará o conceito de mensagem única

A Mensagem Única é um mecanismo natural de integração entre os produtos Totvs que padroniza o processo de transferência de informações comuns, tornando a integração um processo ágil, simples e com menor interdependência.

As funcionalidades envolvidas na integração RM TIN X Back Office Protheus para o calculo do POC são:

Contabilidade

Cadastro Moeda Contábil
Cadastro Plano de Contas
Cadastro Centro de Custos
Cadastro Item Contábil
Cadastro Classe de Valor
Cadastro de Entidade Contábeis Gerenciais
Lançamento Contábil
Consulta de Saldo Contábil

Financeiro

Financiamento

Para atender a integração das funcionalidades citadas serão necessárias a utilização das Mensagens Únicas a seguir:

Contabilidade	Mensagem	Tipo	Versão
Cadastro Moeda Contábil	Currency	Event	2_000
Cadastro Plano de Contas	AccountAntAccount	Event	2_000
Cadastro Centro de Custos	CostCenter	Event	2_000
Cadastro Item Contábil	AccountingItem	Event	1_000
Cadastro Classe de Valor	ClassValue	Event	1_000
Cadastro de Entidade Contábeis Gerenciais	ManagerialAccountingEntity	Event	1_000
Lançamento Contábil	AccountingEntry	Event	2_001
Consulta de Saldo Contábil	AccountingBalance	Request	1_000

Financeiro	Mensagem	Tipo	Versão
Financiamento	Financing	Event	1_002

Visão Geral dos Processos

A seguir serão apresentados os processos contemplados no projeto em questão. Lembrando que esta especificação trata apenas os processos dos módulos (Contábil e Financeiro).

Opcional

Protótipo de Tela

<Caso necessário inclua protótipos de telas com o objetivo de facilitar o entendimento do requisito, apresentar conceitos e funcionalidades do software>.

Protótipo 01

Image Removed

Opcional

Fluxo do Processo

<Nesta etapa incluir representações gráficas que descrevam o problema a ser resolvido e o sistema a ser desenvolvido. Exemplo: Diagrama - Caso de Uso, Diagrama de Atividades, Diagrama de Classes, Diagrama de Entidade e Relacionamento e Diagrama de Sequência>.

Opcional

Dicionário de Dados

Arquivo ou Código do Script: AAA – Negociação Financeira / *Versao=CP.2014.12_03*/

Índice	Chave
01	<FI9_FILIAL+FI9_IDDARF+FI9_STATUS>
02	<FI9_FILIAL+FI9_FORNEC+ FI9_LOJA+FI9_EMISS+FI9_IDDARF>
03	<FI9_FILIAL+FI9_FORNEC+ FI9_LOJA+FI9_PREFIX+FI9_NUM+FI9_PARCEL+FI9_TIPO>

Campo	<AAA_PERESP>
Tipo	<N>
Tamanho	<6>
Valor Inicial	<Varia de acordo com o tipo informado. Por exemplo, quando o campo “tipo” for date, neste campo pode ser informado uma data>.
Mandatório	Sim ( ) Não ( )
Descrição	<Referência Mínima para Cálculo>
Título	<Ref.Calc.>
Picture	<@E999.99>
Help de Campo	<Informar o % que o aluno pagará em dinheiro. Esse % poderá ser alterado durante a negociação>

(Opcional)

Grupo de Perguntas

<Informações utilizadas na linha Protheus>.

Nome: FINSRF2

X1_ORDEM	01
X1_PERGUNT	Emissão De
X1_TIPO	D
X1_TAMANHO	8
X1_GSC	G
X1_VAR01	MV_PAR01
X1_DEF01	Comum
X1_CNT01	'01/01/08'
X1_HELP	Data inicial do intervalo de emissões das guias de DARF a serem consideradas na seleção dos dados para o relatório

(Opcional)

Consulta Padrão

<Informações utilizadas na linha Protheus>

Consulta: AMB

Descrição	Configurações de Planejamento
Tipo	Consulta Padrão
Tabela	“AMB”
Índice	“Código”
Campo	“Código”; ”Descrição”
Retorno	AMB->AMB_CODIGO

Cadastros Contábeis

As mensagens a seguir não serão alteradas nesse projeto, porém são pré requisitos para a integração contábil:

Cadastro Moeda Contábil
Cadastro Plano de Contas
Cadastro Centro de Custos
Cadastro Classe de Valor

Item Contábil

A mensagem AccountingItem será uma mensagem do tipo “event” e substituirá a mensagem atual “Departament”. O motivo da substituição é que a mensagem atual “Departament” do adpter CTBI040, foi criado em duplicidade com a mensagem do fonte CSAI100.

As tags de envio serão:

TAG SUPERIOR	TAG	Obrigatórios	Observação
BusinessContentType	_ CompanyId	Não	Empresa
BusinessContentType	_ BranchId	Não	Filial
BusinessContentType	_ CompanyInternalId	Não	InternalID da Empresa/Filial
BusinessContentType	_Code	Não	Código
BusinessContentType	_InternalId	Não	InternalID
BusinessContentType	_ Name	Não	Descrição
BusinessContentType	_ Class	Não	Classe do Item: 1- Sintético, 2-Analítico
BusinessContentType	_ RegisterSituation	Não	Situação: Active- Ativo, Inactive - Inativo

As tags de retorno serão:

TAG SUPERIOR	TAG	Obrigatórios	Observação
ReturnContentType	_ ListOfInternalId	Não	InternalID

Para o processamento do InternalID utilizar a função CFGA070Int para pegar o código interno a partir do código recebido pelo XML

Cadastro de Entidade Contábeis Gerenciais

A mensagem ManagerialAccountingEntity será uma mensagem do tipo “event” que será utilizada para o cadastro das entidades gerenciais.

No Protheus o cliente pode, através do wizard “CTBWIZENT” criar da entidade 05 até a entidade 09. Essa entidades são cadastradas na tabela CV0, além de criar os campos nas tabelas do sistema.

O RM TIN irá utilizar uma das entidades como equivalente a “Conta Gerencial”, e dependendo da configuração do cliente irá eleger uma das entidades do Protheus.

As tags de envio serão:

TAG SUPERIOR	TAG	Obrigatórios	Observação
BusinessContentType	_ CompanyId	Não	Empresa
BusinessContentType	_ BranchId	Não	Filial
BusinessContentType	_ CompanyInternalId	Não	InternalID da Empresa/Filial
BusinessContentType	_Plane	Não	Plano. Deve informar qual entidade será cadastrada, Entidade 05 até a entidade 09. O TIN irá enviar o código da entidade configurada pelo usuário no RM
BusinessContentType	_Code	Não	Código
BusinessContentType	_InternalId	Não	InternalID
BusinessContentType	_ Name	Não	Descrição
BusinessContentType	_ Class	Não	Classe do Item: 1- Sintético, 2-Analítico
BusinessContentType	_ RegisterSituation	Não	Situação: Active- Ativo, Inactive – Inativo
BusinessContentType	_PostingNature	Não	Natureza da Entidade: 1- Devedora, 2-Credora

As tags de retorno serão:

TAG SUPERIOR	TAG	Obrigatórios	Observação
ReturnContentType	_ ListOfInternalId	Não	InternalID

Para o processamento do InternalID utilizar a função CFGA070Int para pegar o código interno a partir do código recebido pelo XML

Mensagem de Saldo Contábil

A mensagem AccountingBalance será uma mensagem do tipo “request” ou seja ela irá apenas retornar as informações requistadas pelo sistema externo, não alterando nenhuma informação no sistema Protheus. Essa mensagem deverá ser utilizada para o retorno do saldo de uma entidade ou combinação de entidade como por exemplo Conta + Centro de Custo em um determinado período.

Esse novo serviço será acessado apenas por meio de requisição de mensagem única e será síncrona.

As tags de envio serão:

TAG SUPERIOR	TAG	Obrigatórios	Observação
BusinessContentType	_ InitialDate	Não	Data Inicial
BusinessContentType	_ FinalDate	Não	Data Final
BusinessContentType	_ BalanceType	Não	Tipo de saldo contábil. Caso a tag não seja informada será considerado o tipo de saldo 1 - Fiscal
BusinessContentType	_CurrencyCode	Não	Moeda. Caso a tag não seja informada será considerada a moeda 01
BusinessContentType	_CurrencyInternalId	Não	Internal Id Moeda. Caso a tag não seja informada será considerada a moeda 01
BusinessContentType	_ Account	Não	Conta Contábil
BusinessContentType	_ AccountInternalId	Não	InternalID da conta contábil
BusinessContentType	_ CostCenter	Não	Centro de Custo
BusinessContentType	_ CostCenterInternalId	Não	InternalID do Centro de Custo
BusinessContentType	_ AccountItem	Não	Item Contábil
BusinessContentType	_ AccountItemInternalId	Não	InternalID do Item Contábil
BusinessContentType	_ ClassValue	Não	Classe de Valor
BusinessContentType	_ ClassValueInternalId	Não	InternalID da Classe de Valor
BusinessContentType	ManagerialAccountingEntity05	Não	Entidade Gerencial 05
BusinessContentType	ManagerialAccountingEntity05InternalId	Não	InternalID da Entidade Gerencial 05
BusinessContentType	ManagerialAccountingEntity06	Não	Entidade Gerencial 06
BusinessContentType	ManagerialAccountingEntity06InternalId	Não	InternalID da Entidade Gerencial 06
BusinessContentType	ManagerialAccountingEntity07	Não	Entidade Gerencial 07
BusinessContentType	ManagerialAccountingEntity07InternalId	Não	InternalID da Entidade Gerencial 07
BusinessContentType	ManagerialAccountingEntity08	Não	Entidade Gerencial 08
BusinessContentType	ManagerialAccountingEntity08InternalId	Não	InternalID da Entidade Gerencial 08
BusinessContentType	ManagerialAccountingEntity09	Não	Entidade Gerencial 09
BusinessContentType	ManagerialAccountingEntity09InternalId	Não	InternalID da Entidade Gerencial 09

As tags de retorno serão:

TAG SUPERIOR	TAG	Obrigatórios	Observação
ReturnContentType	_ CurrentBalance	Não	Saldo Atual
ReturnContentType	_ CurrentBalanceSignal	Não	Sinal do Saldo ( 1 – Devedor, 2 – Credor)
ReturnContentType	_ CurrentDebtBalance	Não	Saldo Atual Débito
ReturnContentType	_ CurrentCreditBalance	Não	Saldo Atual Crédito
ReturnContentType	_ PreviousBalance	Não	Saldo Anterior
ReturnContentType	_ PreviousBalanceSignal	Não	Sinal do Saldo ( 1 – Devedor, 2 – Credor)
ReturnContentType	_ PreviousDebtBalance	Não	Saldo Anterior Débito
ReturnContentType	_ PreviousCreditBalance	Não	Saldo Anterior Crédito
ReturnContentType	_ PeriodMovement	Não	Movimento do Período
ReturnContentType	_ PeriodMovementSignal	Não	Sinal do Saldo ( 1 – Devedor, 2 – Credor)
ReturnContentType	_ PeriodDebtMovement	Não	Movimento do Período Crédito
ReturnContentType	_ PeriodCreditMovement	Não	Movimento do Período Débito

Para o processamento do InternalID utilizar a função CFGA070Int para pegar o código interno a partir do código recebido pelo XML

Mensagem de Lançamento Contábil

Atualmente a mensagem AccountingEntry utiliza até a entidade de centro de custo (Conta e Centro de Custo), após esse desenvolvimento o sistema irá permitir utilizar as seguintes entidades na mensagem única:

Item Contábil
Classe de Valor
Conta Gerencial

As novas tags de envio serão:

TAG SUPERIOR	TAG	Obrigatórios	Observação
BusinessContentType	_ AccountingItemDebitCode	Não	Item contábil Débito
BusinessContentType	_ AccountingItemDebitInternalId	Não	InternalID do Item contábil Débito
BusinessContentType	_ AccountingItemCreditCode	Não	Item contábil Crédito
BusinessContentType	_ AccountingItemCreditInternalId	Não	InternalID do Item contábil Crédito
BusinessContentType	_ ClassValueDebitCode	Não	Classe de Valor Débito
BusinessContentType	_ ClassValueDebitInternalId	Não	InternalID da Classe de Valor Débito
BusinessContentType	_ ClassValueCreditCode	Não	Classe de Valor Crédito
BusinessContentType	_ ClassValueCreditInternalId	Não	InternalID da Classe de Valor Crédito
BusinessContentType	ManagerialAccountingEntity05Debit	Não	Entidade Gerencial 05 Debito
BusinessContentType	ManagerialAccountingEntity05DebitInternalId	Não	InternalID Entidade Gerencial 05 Debito
BusinessContentType	ManagerialAccountingEntity05Credit	Não	Entidade Gerencial 05 Crédito
BusinessContentType	ManagerialAccountingEntity05CreditInternalId	Não	InternalID Entidade Gerencial 05 Crédito

Para o processamento do InternalID utilizar a função CFGA070Int para pegar o código interno a partir do código recebido pelo XML

O adapter CTBI102 deverá ser alterado para respeitar as novas tags.

(Opcional)

Estrutura de Menu

<Informações utilizadas na linha Datasul>.

Procedimentos

Procedimento
Descrição	(Max 40 posições)	(Max 40 posições)	(Max 40 posições)
Módulo
Programa base
Nome Menu	(Max 32 posições)	(Max 32 posições)	(Max 32 posições)
Interface	GUI/WEB/ChUI/Flex	GUI/WEB/ChUI/Flex	GUI/WEB/ChUI/Flex
Registro padrão	Sim	Sim	Sim
Visualiza Menu	Sim/Não	Sim/Não	Sim/Não
Release de Liberação

Programas

Programa
Descrição	(Max 40 posições)	(Max 40 posições)	(Max 40 posições)
Nome Externo
Nome Menu/Programa	(Max 32 posições)	(Max 32 posições)	(Max 32 posições)
Nome Verbalizado[1]	(Max 254 posições)	(Max 254 posições)	(Max 254 posições)
Procedimento
Template	(Verificar lista de opções no man01211)	(Verificar lista de opções no man01211)	(Verificar lista de opções no man01211)
Tipo[2]	Consulta/Manutenção/ Relatório/Tarefas	Consulta/Manutenção/ Relatório/Tarefas	Consulta/Manutenção/ Relatório/Tarefas
Interface	GUI/WEB/ChUI/Flex	GUI/WEB/ChUI/Flex	GUI/WEB/ChUI/Flex
Categoria[3]
Executa via RPC	Sim/Não	Sim/Não	Sim/Não
Registro padrão	Sim	Sim	Sim
Outro Produto	Não	Não	Não
Visualiza Menu	Sim/Não	Sim/Não	Sim/Não
Query on-line	Sim/Não	Sim/Não	Sim/Não
Log Exec.	Sim/Não	Sim/Não	Sim/Não
Rotina (EMS)
Sub-Rotina (EMS)
Localização dentro da Sub Rotina (EMS)
Compact[4]	Sim/Não	Sim/Não	Sim/Não
Home[5]	Sim/Não	Sim/Não	Sim/Não
Posição do Portlet[6]	0 – Top Left 1 – Top Right 2 – Bottom Left 3 – Bottom Right	0 – Top Left 1 – Top Right 2 – Bottom Left 3 – Bottom Right	0 – Top Left 1 – Top Right 2 – Bottom Left 3 – Bottom Right
Informar os papeis com os quais o programa deve ser vinculado

Cadastro de Papéis

<O cadastro de papéis é obrigatório para os projetos de desenvolvimento FLEX a partir do Datasul 10>.

<Lembrete: o nome dos papeis em inglês descrito neste ponto do documento, devem ser homologados pela equipe de tradução>.

Código Papel	(máx 3 posições)
Descrição em Português*
Descrição em Inglês*

[1] Nome Verbalizado é obrigatório para desenvolvimentos no Datasul 10 em diante.

[2] Tipo é obrigatório para desenvolvimento no Datasul 10 em diante

[3] Categorias são obrigatórias para os programas FLEX.

[4] Obrigatório quando o projeto for FLEX

[5] Obrigatório quando o projeto for FLEX

[6] Obrigatório quando o projeto for FLEX

Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico.

Árvore de páginas

Versões comparadas

Versão antiga 3

Nova versão 4

Chave

Informações Gerais

Objetivo

Definição da Regra de Negócio

Visão Geral dos Processos

Opcional

Protótipo de Tela

Opcional

Fluxo do Processo

Opcional

Dicionário de Dados

(Opcional)

Grupo de Perguntas

(Opcional)

Consulta Padrão

(Opcional)

Estrutura de Menu