Histórico da Página
...
01. Visão Geral
A integração 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 :
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
...
04. Tabelas que possuem sincronismo
Ordem de Produção
Reporte de Produção
Reporte de Produção Estorno
Características Técnicas
Classificação HVI
Blocos
Exclusã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 | - |
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.
...