Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

 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

 

Projeto1

M_CTR010

IRM1

PCREQ-5853

Requisito1

PCREQ-5854

Subtarefa1

M_CTR010-1059

Chamado2

 

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

 

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

 
FINA040 - Contas a ReceberAlteraçãoFinanceiro / Atualizações/ Contas a Receber / Contas a Receber 
FINA070 - Baixas a ReceberAlteraçãoFinanceiro / Atualizações / Contas a Receber / Baixas a Receber 


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 Plano de Contas
  • Cadastro Centro de Custos
  • Cadastro Item Contábil
  • Cadastro Classe de Valor
  • Cadastro de Conta Gerencial
  • 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 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 Conta Gerencial

ListOfManagerialAccountingEntity

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). 

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 ListOfManagerialAccountingEntity será uma mensagem do tipo “event” que será utilizada para o cadastro de conta gerencial.

A conta gerencial será uma entidade contábil que no RM TIN pode representar a sub-unidade no Protheus será representado por uma entidade gerencial.

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.

Após a criação da entidade o cliente, no sistema Protheus, deve eleger qual entidade será a conta gerencial e informa no parâmetro MV_CTBCGER.

Essa mensagem é em formato de lista, onde o RM TIN irá enviar uma lista de contas gerenciais, o sistema Protheus irá cadastrar a lista, realizando a validação dos dados. Caso o sistema encontre algum dado inválido a mensagem irá retornar o erro e nenhuma das contas gerenciais da mensagem será gravada no Protheus.

O Protheus irá considerar a empresa/filial da primeira conta gerencial como de todas da lista.

 

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_ShortCodeNãoCódigo reduzido ( Não Utilizado no Protheus)

BusinessContentType

_Description

Não

Descrição

BusinessContentType

_AnalyticalOrSynthetic

Não

Classe do Item: 1- Sintético, 2-Analítico

BusinessContentType

_ActiveOrInactive

Não

Situação: 1-Ativo;2-Inativo, Bloqueado ou Excluido

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.

Atenção: O Objetivo dessa mensagem é a requisição do saldo contábil de uma combinação de entidade. Caso seja necessário o saldo de uma lista de entidades, a mensagem ExportOfAccountMovements pode ser utilizada.

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

_ AccountantAccountCode

Não

Conta Contábil

BusinessContentType

_ AccountantAccountInternalId

Não

InternalID da conta contábil

BusinessContentType

_CostCenterCode

Não

Centro de Custo

BusinessContentType

_CostCenterInternalId

Não

InternalID do Centro de Custo

BusinessContentType

_AccountantItemCode

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

ManagerialAccountingEntityCode

Não

Código que indentifica a Conta Gerencial.O Protheus irá utilizar a entidade contábil gerencial configurada no parâmetro MV_CTBCGER

BusinessContentType

ManagerialAccountingEntityInternalId

Não

Internal Id da Entidade Contábil Gerencial

 

As tags  de retorno serão:

 

 

TAG SUPERIOR

TAG

Obrigatórios

Observação

ReturnContentType

_ CurrentBalance

Não

Saldo Atual. Saldo crédito - saldo débito

ReturnContentType

_ CurrentDebtBalance

Não

Saldo Atual Débito

ReturnContentType

_ CurrentCreditBalance

Não

Saldo Atual Crédito

ReturnContentType

_ PreviousBalance

Não

Saldo Anterior.Saldo crédito - saldo débito

ReturnContentType

_ PreviousDebtBalance

Não

Saldo Anterior Débito

ReturnContentType

_ PreviousCreditBalance

Não

Saldo Anterior Crédito

ReturnContentType

_ PeriodMovement

Não

Movimento do Período. Movimento Crédito - Movimento Débito

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

ManagerialAccountingEntityDebit

Não

O Protheus irá utilizar a entidade contábil gerencial configurada no parâmetro MV_CTBCGER

BusinessContentType

ManagerialAccountingEntityDebitInternalId

Não

InternalID Entidade Conta Gerencial

BusinessContentType

ManagerialAccountingEntityCredit

Não

O Protheus irá utilizar a entidade contábil gerencial configurada no parâmetro MV_CTBCGER

BusinessContentType

ManagerialAccountingEntityCreditInternalId

Não

InternalID Entidade Conta Gerencial

 

  • 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.

ListOfManagerialAccountingEntity

Dicionário de Dados

Parâmetros:


Nome Var.

MV_CTBCGER

Tipo

Caracter

Descrição

Indique a entidade gerencial utilizada como Conta 

Cont.Descric.

Gerencial.Essa entidade será usada na integração  

Cont.Descric.

por mensagem única ManagerialAccountingEntity     

 

 

 

 

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