Histórico da Página
...
A integração via REST API tem como objetivo sincronizar dados do TOTVS AGRO Beneficiamento com o os ERPs Protheus e Datasul. A sincronização de dados ocorre do TOTVS Agro Beneficiamento para o Datasulos ERPs e vice-versa. No item 4 5 são mostradas as tabelas que possuem essa integração.
...
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
| Integração | Origem | Cross | Destino | Classe | Tabela | Rotina | Regras |
| Caracteristicas Técnicas | TOTVS Agro Beneficiamento | - | Datasul | CaracteristicasTecnicasDatasulService | caracteristicas_tecnicas_datasul | - | Url do Datasul, Usuário e senha configurados no TOTVS Agro Beneficiamento. As tabelas de configuração do beneficiamento deverão estar configuradas com o produto beneficiado. Tabela config_beneficiamento_produtos. Cadastro via Swagger |
| Classificação HVI | TOTVS Agro Beneficiamento | - | ERP | BeneficiamentoItensClassificacoesService | beneficiamentos_itens_classificacoes | - | Na importação HVI ou na opção Salvar da Classificação visual gera json na tabela |
| Classificação HVI | TOTVS Agro Beneficiamento | - | ERP | BeneficiamentoItensClassificacoesIntegracaoScheduled | beneficiamentos_itens_classificacoes | Rotina Agendada | Url do Datasul, Usuário e senha configurados no TOTVS Agro Beneficiamento. As características técnicas devem estar relacionados com os códigos correspondentes |
| Blocos | TOTVS Agro Beneficiamento | - | ERP | BlocagemService | blocagens_itens | - | Na inserção do bloco é gerado o JSON na tabela |
| Blocos | TOTVS Agro Beneficiamento | - | ERP | BlocagemItemScheduled | blocagens_itens | Rotina Agendada | URL do Datasul, Usuário e senha configurados. As caracteristicas técnicas devem estar relacionadas com os códigos correspondentes |
| Exclusão de Blocos | TOTVS Agro Beneficiamento | - | ERP | BlocagemItemService | blocagens_itens_exclusao_erp | - | Na exclusão do item do bloco e gerado json na tabela |
| Exclusão de Blocos | TOTVS Agro Beneficiamento | - | ERP | BlocagemItemExclusaoScheduled | blocagens_itens_exclusao_erp | Rotina Agendada | URL do Datasul, Usuário e senha configurados. As caracteristicas técnicas devem estar relacionadas com os códigos correspondentes |
| Nota Fiscal | ERP | - | TOTVS Agro Beneficiamento | BlocagemService | notas_fiscais / blocagens | - |
...
Blocos
...
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.
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas