Histórico da Página

1. Visão Geral
2. REST API
3. Integrações com TOTVS Agro Beneficiamento
   1. Características Técnicas 
   2. Blocos
4. Tabelas que possuem sincronismo
5. Observações importantes

01. Visão Geral

A integração com via REST API tem como objetivo sincronizar dados do TOTVS AGRO Beneficiamento com o os ERPs Protheus e Datasul. Os dados possuem apenas uma direção de envio, sendo ela do TOTVS Agro Beneficiamento para o Datasul. No item 4 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. Como as tabelas possuem apenas uma direção de envio, a inserção e atualização dessa Tabela são feitas em apenas uma aplicação. 

02. REST API

O conteúdo desse tópico pode se 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 :

Image Added

Nessa tela é possível selecionar qual característica técnica do Datasul se relacionará com qual atributo no TOTVS Agro Beneficiamento

...

04. Tabelas que possuem sincronismo

...

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 :

Image Added

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.