Histórico da Página
...
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 |
Notas:O PIMS Multicultivos é responsável por realizar o processamento de custo agrícola e reatei-o reateio dos valores atribuídos aos centros de custos e contas a ser enviados serem enviadas ao Protheus. O processo de integração é iniciado ao realizar os processos de Custos, que irá realizar o 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 estevam 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 este parâmetro 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;:
- 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 agendado 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 --> Integrações PIMS --> LancamentoContabilDataDriver/ AccountingEntry (Integração de Lançamentos Contábeis).
O PIMSConnector ao executar o agendamento LancamentoContabilDataDriver, recuperará das 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 realizar 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 validará as informações abaixo, caso não exista 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 de 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. Processo
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.