Integração via REST API

01. Visão Geral

A integração via REST API tem como objetivo sincronizar dados do TOTVS AGRO Beneficiamento com os ERPs Protheus e Datasul. A sincronização de dados ocorre do TOTVS Agro Beneficiamento para os ERPs e vice-versa. No item 5 são mostradas as tabelas que possuem essa integração.

02. REST API

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

03. Datasul

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

04. Protheus

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

05. Integrações com TOTVS Agro Beneficiamento

• Visão geral

O TOTVS Agro Beneficiamento possui integração direta com os ERPs Datasul e Protheus, utilizando uma API REST, com o objetivo de enviar dados de características técnicas, classificação HVI e blocos do TOTVS Agro Beneficiamento para os ERPs, que envia dados de notas fiscais de volta para o TOTVS Agro Beneficiamento a fim de atualizar o status dos blocos.

• Características técnicas

A integração de características técnicas integra as características cadastradas no ERP Datasul com o TOTVS Agro Beneficiamento, no momento em que o botão "Recuperar Características Técnicas" é pressionado, nas configurações de ERP no TOTVS Agro Beneficiamento. Para configurar essas características recuperadas e/ou disparar a integração é necessário navegar até Configurações → Configurações de Integrações → (ERP Datasul selecionado no campo 'Tipo ERP') → Relacionar Características Técnicas :

Nessa tela é possível selecionar qual característica técnica do Datasul se relacionará com qual atributo no TOTVS Agro Beneficiamento após a integração ser realizada. Também é possível disparar a integração, clicando no botão "Recuperar Características Técnicas", que irá fazer uma chamada na API do Datasul e irá recuperar as características técnicas para serem relacionadas.

• Classificação HVI

Classificação Visual → Envia a classificação visual para o ERP, quando for realizada a classificação visual em uma etiqueta (Qualidade → Classificação Visual). Ao classificar uma etiqueta, a integração com o ERP é disparada. Essa integração possui uma rotina agendada, caso não seja enviada após o ato da classificação.

Classificação HVI → Envia a classificação de HVI para o ERP, quando for realizado o upload de uma classificação HVI (Qualidade → Importação HVI). Ao realizar esse processo, a integração com o ERP é disparada. Essa integração possui uma rotina agendada, caso não seja enviada após o ato da importação.

• Blocos

Bloco → Envia o bloco e seus itens para o ERP, quando uma blocagem for inserida(Blocagem → Manutenção de Blocos) ou quando for realizado o aceite de uma sugestão de blocos (Blocagem → Sugestão de Blocos). Ao realizar um desses processos, a integração com o ERP é disparada. Essa integração possui uma rotina agendada, caso não seja enviada após o ato de inserir ou aceitar.

Exclusão de bloco →  Envia o a exclusão do bloco e seus itens para o ERP, quando uma blocagem for excluída (Blocagem → Manutenção de Blocos). Ao realizar esse processo, a integração com o ERP é disparada. Essa integração possui uma rotina agendada, caso não seja enviada após o ato de excluir.

• Notas fiscais

O ERP envia dados de notas fiscais ao TOTVS Agro Beneficiamento com a finalidade de determinar qual bloco já foi comercializado, não permitindo que esse bloco seja alterado.

• Configurando o TOTVS Agro Beneficiamento para integrar com o ERP

Para configurar o TOTVS Agro Beneficiamento para integrar com o ERP, é necessário navegar até Configurações → Configurações de Integrações :

Será necessário configurar todos os campos e relacionar as características técnicas (se Datasul) para que a integração ocorra com sucesso.

• Regras para a integração ser realizada

06. Tabelas que possuem sincronismo

• Características Técnicas

Referente a tabela caracteristicas_tecnicas_datasul, essa integração irá buscar na API do Datasul todas as características técnicas cadastradas, caso todas as regras forem atendidas (ver tabela acima), tornando possível relaciona-las com atributos no TOTVS Agro Beneficiamento.

• Classificação HVI

Referente a tabela beneficiamentos_itens_classificacoes, essa integração é disparada quando uma classificação visual for realizada ou um HVI for importado, gerando um JSON, caso todas as regras forem atendidas (ver tabela acima), na coluna json_erp e a enviará ao ERP. 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. Esse processo de envio da integração também ocorre através de uma rotina agendada.

• Blocos

Referente a tabela blocagens_itens, essa integração é disparada quando um bloco for inserido ou aceito na sugestão de blocos, gerando um JSON, caso todas as regras forem atendidas (ver tabela acima), na coluna json_erp e a enviará ao ERP. 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. Esse processo de envio da integração também ocorre através de uma rotina agendada.

• Exclusão de Blocos

Referente a tabela blocagens_itens_exclusao_erp, essa integração é disparada quando um bloco excluído, gerando um JSON, caso todas as regras forem atendidas (ver tabela acima), na coluna json_erp e a enviará ao ERP. 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. Esse processo de envio da integração também ocorre através de uma rotina agendada.

• Notas fiscais

Referente a tabela notas_fiscais / blocagens_itens, nessa integração o ERP envia ao TOTVS Agro Beneficiamento a informação de que itens um bloco foram comercializado, assim atualizando o status dos mesmos para "Entregue" no TOTVS Agro Beneficiamento e não permitindo realizar mais alterações.

07. Observações importantes

• Rotinas agendadas

Algumas rotinas de integração com o ERP 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.