Lançamentos Contábeis (AccountingEntry)

Tem como objetivo retornar à contabilização de custo ao ERP. Esse processo é realizado através da rotina de Contabilização de Retorno de Custos. 

Retorno da Contabilização de Custos ao ERP (AccountingEntry)

Identificador da Mensagem: AccountingEntry
Versão: 2.000
Módulo <Protheus>: <BackOffice – Controladoria >
Módulo <PIMS Multicultivos>: <CUSTAG>
Tipo de Envio: <Assíncrona/Síncrona>

O PIMS Multicultivos é responsável por realizar o processamento de custo agrícola e reateio dos valores atribuídos aos centros de custos e contas a serem enviadas ao Protheus. O processo de integração é iniciado ao realizar os processos de Custos, que irá realizar a composição das informações a serem enviadas ao ERP. Após finalizar o processamento de custo é necessário realizar a Contabilização de Retorno de Custos ao ERP, este processo que inicia a integração.

O processo é realizado através do Menu: Processamentos / Processamento Custos / Contabilização de Retorno de Custos ao ERP.

As informações de Lote e Data de contabilização são informadas pelo usuário antes de realizar a contabilização de Retorno de Custo ao ERP. Os campos de Lote e Data somente estarão habilitados após os processos de custo devidamente realizados. Existe entidade do Sub-Lote, montado através do parâmetro QT_REG_SUB_LOTE_CONTABIL.

O parâmetro QT_REG_SUB_LOTE_CONTABIL é de vital importância no processo de Integração, pois este parâmetro é utilizado para diminuir o tamanho do XML que será enviado ao Protheus.

O processo de integração é iniciado ao acionar o botão aplicar, onde internamente o processo de integração realizará a manipulação de alguns Status, conforme abaixo:

• 0 - Não processado;
• 1 - Em processamento;
• 2 - Enviado ao ERP aguardando retorno;
• 3 - Erro no envio da integração;
• 4 - Processado pelo ERP.

Observação: Para o funcionamento do processo de integração entre PIMS x Protheus, o agendamento de Contabilização de Retorno de Custos ao ERP (ProcessarCaptacaoRetornoCustos), presente no PIMS Multicultivos não deve estar habilitado, pois este agendamento é utilizado para integração entre PIMS Multicultivos x Datasul utilizando o TOTVS ESB.

No PIMSConnector a integração inicializa ao realizar as configurações do agendamento LancamentoContabilDataDriver presente no PIMSConnector, este agendamento é responsável pelo envio e recebimento dos lançamentos contábeis entre PIMS x Protheus. O agendamento é realizado através do menu: Agendamentos / AccountingEntry (Integração de Lançamentos Contábeis).

O PIMSConnector ao executar o agendamento LancamentoContabilDataDriver, recuperará as informações da tabela BRG_RETCUSTO, que estejam com o campo FG_STATUS = 0 e CD_INT_UUID esteja vazio. Os Status manipulados pelo PIMSConnector são os mesmos utilizados pelo PIMS Multicultivos e estão descritos no tópico anterior.

Após recuperação dos lançamentos contábeis o PIMSConnector, validará as informações e montará o XML a ser enviado ao Protheus. A mensagem utilizada no processo de integração de lançamentos contábeis será AccountingEntry na versão 2.000, que terão as seguintes TAGS preenchidas no XML:

• CompanyId - Empresa Geradora do Lançamento;
• BranchId - Filial Geradora do Lançamento;
• PeriodStartDate - Data Inicial do Período Contábil;
• PeriodEndDate -Data Final do Período Contábil;
• BatchNumber - Número do Lote Contábil;
• SubLot - Número do Sub-Lote Contábil;
• Document - Número do Documento Contábil;
• Item - Linha do Lançamento;
• ItemType - Tipo da Linha do Lançamento;
• EntryNumber - Número do Lançamento;
• MovementDate -Data do Movimento Contábil;
• DebitAccountCode - Conta de Débito com máscara;
• CreditAccountCode - Conta de Credito com máscara;
• EntryValue - Valor do Lançamento;
• CostCenterDebitCode - Centro de Custo Crédito;
• CostCenterCreditCode - Centro de Custo Crédito;
• ComplementaryHistory - Histórico Complementar.
• ManagerialAccountingEntity05DebitCode - Código da Quinta Entidade de Débito
• ManagerialAccountingEntity05DebitInternalId -  Interno Id da Quinta Entidade de Débito
• ManagerialAccountingEntity05CreditCode  - Código da Quinta Entidade de Crédito
• ManagerialAccountingEntity05CreditInternalId - Interno Id da Quinta Entidade de Crédito
• ManagerialAccountingEntity06DebitCode - Código da Sexta Entidade de Débito 
• ManagerialAccountingEntity06DebitInternalId - Interno Id da Sexta Entidade de Débito
• ManagerialAccountingEntity06CreditCode - Código da Sexta Entidade de Credito
• ManagerialAccountingEntity06CreditInternalId - Interno Id da Sexta Entidade de Crédito 
• ManagerialAccountingEntity07DebitCode - Código da Sétima Entidade de Débito 
• ManagerialAccountingEntity07DebitInternalId - Interno Id da Sétima Entidade de Débito
• ManagerialAccountingEntity07CreditCode - Código da Sétima Entidade de Crédito
• ManagerialAccountingEntity07CreditInternalId - Interno Id  da Sétima Entidade de Crédito
• ManagerialAccountingEntity08DebitCode - Código da Oitava Entidade de Débito
• ManagerialAccountingEntity08DebitInternalId - Interno Id da Oitava Entidade de Débito
• ManagerialAccountingEntity08CreditCode - Código da Oitava Entidade de Credito
• ManagerialAccountingEntity08CreditInternalId - Interno Id da Oitava Entidade de Crédito
• ManagerialAccountingEntity09DebitCode - Código da Nona Entidade de Débito 
• ManagerialAccountingEntity09DebitInternalId - Interno Id da Nona Entidade de Débito
• ManagerialAccountingEntity09CreditCode -  Código da Nona Entidade de Crédito
• ManagerialAccountingEntity09CreditInternalId - Interno Id da Nona Entidade de Crédito
• BusinessUnitCreditCode - Código da Unidade de Negócio de Crédito
• BusinessUnitCreditInternalId - Interno Id da Unidade de Negócio Crédito
• BusinessUnitDebitCode - Código da Unidade de Negócio de Débito
• BusinessUnitDebitInternalId - Interno Id da Unidade de Negócio Débito

O processo de envio dos lançamentos contábeis ao Protheus poderá ser realizado de forma síncrona ou assíncrona. Deve se atenta-se ao utilizar o processamento de integração em modo Síncrona, pois, este processo realiza o envio das informações item a item e aguarda o processamento ser realizado com sucesso ou erro, podendo gerar assim, lentidão na integração.

O processo de integração no Protheus inicia com a configuração do Adapter CTBA102, conforme ilustrado na imagem abaixo:

Ao receber as informações o Protheus irá validar os campos abaixo e caso exista alguma inconsistência será retornado ao PIMSConnector uma mensagem de erro informando que não foi localizado as informações no cadastro de DE/PARA da mensagem única:

• Empresa;
• Filial;
• Centro de Custo;
• Conta Contábil;
• Data da Contabilização.

O Protheus ao validar a estrutura do XML (AccountingEntry) do Lançamento Contábil enviado pelo PIMS realizará a inclusão dos Lançamento Contábil na rotina CTBA102.

Caso o Protheus reporte algum erro de processamento nos Lançamentos Contábeis, o PIMSConnector iniciará o processo de envio dos XMLs com a exclusão desses lançamentos já integrados no Protheus, e mudará o status de processamento na BRG_RETCUSTO do PIMS Multicultivos para erro.

Fluxo da Integração

A integração de Retorno de Contabilização de Custo é realizada no PIMS Multicultivos e integrada com Protheus conforme fluxos abaixo:

Processo da Integração de Contabilização de Retorno de Custo

Fluxo da Integração de Retorno de Custo

Limitações/Restrições

• Esta integração está disponível a partir da versão 11.8 do Protheus e 12.1.6 do PIMS Multicultivos;

• A integração de Contabilização do Retorno de Custo para o PIMS Multicultivos é realizada em modo exclusivo entre as Unidades Administrativas.