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 5 são mostradas as tabelas que possuem essa integração.
...
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 o 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 o Datasulos ERPs, que envia dados de notas fiscais de volta para o TOTVS Agro Beneficiamento a fim de atualizar o status dos blocos.
...
A integração de características técnicas integra as características cadastradas no no ERP Datasul com o TOTVS Agro Beneficiamento, no momento em que o botão "Recuperar Características Técnicas" é pressionado, nas configurações do Datasul no de ERP no TOTVS Agro Beneficiamento. Para configurar essas características recuperadas e/ou disparar a integração é necessário navegar até Configurações → Datasul → Configurações de Integrações → (ERP Datasul selecionado no campo 'Tipo ERP') → Relacionar Características Técnicas :
...
Classificação Visual → Envia a classificação visual para o Datasul ERP, quando for realizada a classificação visual em uma etiqueta (Qualidade → Classificação Visual). Ao classificar uma etiqueta, a integração com o Datasul 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 Datasul ERP, quando for realizado o upload de uma classificação HVI (Qualidade → Importação HVI). Ao realizar esse processo, a integração com o Datasul é ERP é disparada. Essa integração possui uma rotina agendada, caso não seja enviada após o ato da importação.
...
Bloco → Envia o bloco e seus itens para o Datasul ERP, quando uma blocagem for salva 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 Datasul é ERP é disparada. Essa integração possui uma rotina agendada, caso não seja enviada após o ato de salvar ou aceitar.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 Datasul envia 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
DatasulERP
Para configurar o TOTVS Agro Beneficiamento para integrar com o Datasul ERP, é necessário navegar até Configurações → DatasulConfiguraçõ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.
...
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 | - | DatasulERP | 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 | - | DatasulERP | 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 | - | DatasulERP | BlocagemService | blocagens_itens | - | Na inserção do bloco é gerado o JSON na tabela |
Blocos | TOTVS Agro Beneficiamento | - | DatasulERP | 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 | - | DatasulERP | BlocagemItemService | blocagens_itens_exclusao_erp | - | Na exclusão do item do bloco e gerado json na tabela |
Exclusão de Blocos | TOTVS Agro Beneficiamento | - | DatasulERP | 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 | DatasulERP | - | 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
Notas fiscais
...
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 Datasul 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.
...