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:
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ção | Origem | Cross | Destino | Classe | Tabela | Rotina | Regras para integração |
Ordem de Produção | TOTVS Agro Beneficiamento | PIMS Connector (ProductionOrder) | Datasul | OrdemServicoGeracoJsonIntegracaoScheduled | ordens_servicos | Rotina 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ção | TOTVS Agro Beneficiamento | PIMSConnector (ProductionAppointment) | Datasul | BeneficiamentoItensGerarJsonIntegracaoScheduled | beneficiamentos_itens | Rotina 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 Estorno | TOTVS Agro Beneficiamento | PIMSConnector (ProductionAppointment) | Datasul | OrdemServicoService | estorno_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.