TOTVS AGRO

Páginas filhas
  • Integração com PIMS Connector

01. Visão Geral

A integração com o PIMS Connector tem como objetivo sincronizar dados do TOTVS Agro Beneficiamento com o Datasul, utilizando o PIMS Connector como um intermediador. A integração ocorre somente do TOTVS Agro Beneficiamento para o PIMS Connector (e assim para o Datasul), ou seja, os dados possuem apenas uma direção de envio. No item 5 são mostradas as tabelas que possuem essa integração. 

02. PIMS Connector

O conteúdo desse tópico pode ser encontrado aqui.

03. Datasul

O conteúdo desse tópico pode ser encontrado aqui.

04. Integrações com TOTVS Agro Beneficiamento

  • Visão geral

O TOTVS Agro Beneficiamento possui integração com o Datasul, sendo essa integração intermediada pelo PIMS Connector, com o objetivo de enviar dados de ordem, reporte e estorno de produção do TOTVS Agro Beneficiamento para o Datasul.

  • Ordem de Produção

Envia a ordem de serviço que está com status finalizada para o PIMS Connector, que irá enviar ao Datasul. Realizado através de uma rotina agendada.

  • Reporte e Estorno de Produção

Reporte de produção → Envia o reporte de produção de cada item beneficiado que estiver com a ordem de serviço finalizada e estiver integrado (coluna numero_op_datasul preenchida) para o PIMS Connector, que irá enviar ao Datasul. Realizado através de uma rotina agendada.

Estorno de produção → Envia os beneficiamentos integrados que sofreram estorno no TOTVS Agro Beneficiamento para o PIMS Connector, que irá enviar ao Datasul.

  • Configurando o PIMS Connector para integrar com o TOTVS Agro Beneficiamento

A configuração do servidor do PIMS Connector é feita pela equipe de Cloud, que irá disponibilizar a URL do servidor para ser inserida no item abaixo.

No servidor do PIMS Connector, é necessário configurar URL do roteamento de mensagens EAI, que é o método de comunicação com o Datasul. Para fazer isso, será necessário navegar até Administração → EAI → Adapter e criar uma nova rota para comunicação com o Datasul

A configuração do Datasul com o PIMS Connector é feita pela equipe do Datasul.

  • Configurando o TOTVS Agro Beneficiamento para integrar com o PIMS Connector

Para configurar o PIMS Connector no TOTVS Agro Beneficiamento, é necessário navegar até Configurações → PIMS Connector:

Configurações do PIMS Connector no TOTVS Agro Beneficiamento

Aqui é possível definir o URL do servidor do PIMS Connector, usuário e senha que serão utilizados para fazer o login no serviço.

  • Regras para a integração ser realizada

IntegraçãoOrigemCrossDestinoClasseTabelaRotinaRegras para integração
Ordem de ProduçãoTOTVS Agro BeneficiamentoPIMS Connector (ProductionOrder)DatasulOrdemServicoGeracoJsonIntegracaoScheduledordens_servicosRotina Agendada(1,2,3,4) - A ordem deve estar finalizada, o agendamento gerará o Json na coluna json_erp e enviará ao PIMS Connector
Reporte ProduçãoTOTVS Agro Beneficiamento

PIMSConnector

(ProductionAppointment)

DatasulBeneficiamentoItensGerarJsonIntegracaoScheduledbeneficiamentos_itensRotina Agendada(1,2,3,4) - A ordem deve estar finalizada e com a coluna numero_op_datasul deve estar preenchida, o agendamento gerará o Json e enviará primeiro os estornos e tendo sucesso envia o reporte de produçao de cada item beneficiado. Cada item beneficiado gera uma mensagem de integração.
Reporte Produção EstornoTOTVS Agro Beneficiamento

PIMSConnector

(ProductionAppointment)

DatasulOrdemServicoServiceestorno_op_datasul-Json gerado quando o beneficiamento é estornado e a tabela de beneficiamentos_itens possuir número do reporte de produção gerado pelo Datasul. A integração é realizado pela classe BeneficiamentoItensGerarJsonIntegracaoScheduled
Regras para integração: (1) Url PIMS Connector, Usuário e Senha configurados no TOTVS Agro Beneficiamento (2) Url do Datasul, Usuário e Senha configurados no Datasul (3) EAI2 Datasul configurados com as mensagens do PIMS Connector (4) Agendamento do TOTVS Agro Beneficiamento deve estar ativo. Pode ser acompanhado pelo Monitor de Integrações.

05. Tabelas que possuem sincronismo

  • Ordem de Produção

Referente a tabela ordens_servicos, a rotina agendada irá gerar um JSON, caso todas as regras forem sejam (ver tabela acima), na coluna json_erp e enviará ao PIMS Connector e depois ao Datasul. Caso a integração seja bem sucedida, a coluna integrado_erp ficará como true, caso contrário a coluna integrado_erp ficará como false e a coluna erro_integracao_erp será populada, também tornando possível a visualização através do monitoramento de integrações. 

  • Reporte de Produção

Referente a tabela beneficiamentos_itens, a rotina agendada irá gerar um JSON , caso todas as regras forem sejam (ver tabela acima), na coluna json_erp e enviará ao PIMS Connector e depois ao Datasul. Caso a integração seja bem sucedida, a coluna integrado_erp ficará como true, caso contrário a coluna integrado_erp ficará como false e a coluna erro_integracao_erp será populada, também tornando possível a visualização através do monitoramento de integrações. 

  • Estorno de Produção

Referente a tabela estorno_op_datasul, a rotina é executada quando um beneficiamento for estornado, gerando um JSON , caso todas as regras sejam atendidas (ver tabela acima), na coluna json_erp e enviará ao PIMS Connector e depois ao Datasul. Caso a integração seja bem sucedida, a coluna integrado_erp ficará como true, caso contrário a coluna integrado_erp ficará como false e a coluna erro_integracao_erp será populada.

06. Observações importantes

  • Rotinas agendadas

Algumas rotinas de integração com o PIMS Connector são agendadas e ocorrem em um intervalo de 10 em 10 minutos, ou seja, a cada 10 minutos o TOTVS Agro Beneficiamento irá disparar essas integrações.


  • Sem rótulos