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>
Mensagem Padrão | PROTHEUS | PIMS Multicultivos | ||
Tabela | Campo | Tabela | Campo | |
MovementDate | CTT2 | DDATALANC | BRG_RETCUSTO | DT_CONTABILIZACAO |
CompanyId | CTT2 | - | BRG_RETCUSTO | CD_EMPRESA |
BranchId | CTT2 | CT2_FILIAL | BRG_RETCUSTO | CD_FILIAL |
CostCenterDebitCode | CTT2 | CT2_DCD | BRG_RETCUSTO | CD_CCUSTO_DEBITO |
DebitAccountCode | CTT2 | CT2_DEBITO | BRG_RETCUSTO | CD_CONTACUSTO_DEBITO |
CostCenterCreditCode | CTT2 | CT2_DCC | BRG_RETCUSTO | CD_CCUSTO_CREDITO |
CreditAccountCode | CTT2 | CT2_CREDIT | BRG_RETCUSTO | CD_CONTACUSTO_CREDITO |
BatchNumber | CTT2 | CT2_LOTE | BRG_RETCUSTO | NO_LOTE |
SubLot | CTT2 | CT2_SBLOTE | BRG_RETCUSTO | NO_SUB_LOTE |
ComplementaryHistory | CTT2 | CT2_HP | BRG_RETCUSTO | HISTORICO_PADRAO |
EntryValue | CTT2 | CT2_VLR01 | BRG_RETCUSTO | VALOR |
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.
Nome Parâmetro | Contexto | Descrição | Valor |
QT_REG_SUB_LOTE_CONTABIL | PIMSGRAOS.CONTABILIZACAO_RETORNO_ERP | Número de registros para Sub Lote Contábil | A Definir na Implantação |
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:
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:
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:
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.
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