Integração com TOTVS Connector

01. Visão Geral

A integração com TOTVS Connector tem como objetivo sincronizar dados do TOTVS Agro Multicultivo e TOTVS Pesagem com o TOTVS Agro Beneficiamento. Os dados integrados do TOTVS Agro Multicultivo possuem apenas uma direção de envio, sendo ela do TOTVS Agro Multicultivo para o TOTVS Agro Beneficiamento. Para a integração de dados do TOTVS Pesagem, a sincronização ocorre do TOTVS Pesagem para o TOTVS Agro Beneficiamento e vice-versa. No item 6 são mostradas as tabelas que possuem essas integrações.

02. O que é o TOTVS Connector ?

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

03. TOTVS Agro Multicultivo

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

04. TOTVS Pesagem

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

05. Integrações com TOTVS Agro Beneficiamento

• TOTVS Pesagem

  • Visão Geral

O TOTVS Pesagem possui integração com o TOTVS Agro Beneficiamento, recuperando dados para alimentar as tabelas tipos_pesagem_t_pesag e atributos_t_pesag, também sincronizando automaticamente o peso do produto no ato de beneficiamento e peso do lote de matéria prima, quando habilitado nas configurações e sincronizando balanças cadastradas no TOTVS Pesagem.

• • Configurando o TOTVS Pesagem para integrar com o TOTVS Agro Beneficiamento

Para configurar o TOTVS Agro Beneficiamento no TOTVS Pesagem, é necessário utilizar o Swagger do TOTVS Connector Client, que já deve estar configurado no projeto atual.

Passos para configurar o TOTVS Pesagem no Swagger:

1) Testar JSON para realizar a conexão com a base de dados do TOTVS Pesagem:

Solicitar os dados de conexão com a base de dados do TOTVS Pesagem
- IP
- Porta
- Nome do banco de dados
- Usuário e Senha

Utilizar o seguinte endpoint (POST): /api/v1/productConnections/connectionTest

{
"productName": "TA-PESAGEM",
"productVersion": "productVersion",
"url": "jdbc:postgresql://IP_BANCO_DADOS_T_PESAGEM:PORTA/NOME_BANCO_DADOS",
"username": "Usuario",
"dataBaseType": "senha",
"enabled": true
}

2) Se o teste da conexão for realizada com sucesso, realizar o POST do JSON no seguinte endpoint:  /api/v1/productConnections

{
"productName": "TA-PESAGEM",
"productVersion": "productVersion",
"url": "jdbc:postgresql://IP_BANCO_DADOS_T_PESAGEM:PORTA/NOME_BANCO_DADOS",
"username": "Usuario",
"dataBaseType": "senha",
"enabled": true
}

3) Relacionar o esquemas com o produto

TOTVS Pesagem

SubCarga,
Tipo_Pesagem,
Pesag_Atributos,
PesagemComposicao

Realizar o post do JSON no seguinte endpoint:  /api/v1/productConnections/schemas com a seguinte estrutura:

{
"idProductConnection": "ID_PRODUCT_CONNECTION_T_PESAGEM",
"idSchemaDefinition": "idSchemaDefinition",
"enableStandalone": true
}

• • Configurando o TOTVS Agro Beneficiamento para integrar com o TOTVS Pesagem

Para configurar o TOTVS Pesagem no TOTVS Agro Beneficiamento, é necessário navegar até Configurações → TOTVS Pesagem :

Aqui é possível definir o tipo da pesagem, atributo barra , atributo fazenda, habilitar e desabilitar o preenchimento automático do peso no lote de matéria prima.

Também é necessário configurar o serviço que buscas as balanças em cada etiqueta SAI. Para fazer isso, é necessário navegar até Cadastros → Minha Produção → Etiquetas SAI, selecionar a etiqueta sai desejada, clicar no botão editar e preencher o respectivos campos com os dados do serviço do TOTVS Pesagem :

Ao inserir os dados corretamente nesses campos, será possível buscar as balanças cadastradas no TOTVS Pesagem, clicando no botão "Buscar balanças".

• • Regras para a integração ser realizada

• TOTVS Agro Multicultivo

  • Visão Geral

O TOTVS Agro Multicultivo possui integração com o TOTVS Agro Beneficiamento, integrando dados das tabelas unidades_medidas, armazens, culturas, fazendas, setores, talhoes e cultivares do TOTVS Agro Multicultivo no TOTVS Agro Beneficiamento 

• • Configurando o TOTVS Agro Multicultivo para integrar com o TOTVS Agro Beneficiamento

Para configurar o TOTVS Agro Beneficiamento no TOTVS Agro Multicultivo, é necessário utilizar o Swagger do TOTVS Connector Client, que já deve estar configurado no projeto atual.

Passos para configurar o TOTVS Agro Multicultivo no Swagger:

1) Testar JSON para realizar a conexão com a base de dados do TOTVS Agro Multicultivo:

Solicitar os dados de conexão com a base de dados do TOTVS Agro Multicultivo
- IP
- Porta
- Nome do banco de dados
- Usuário e Senha

Utilizar o seguinte endpoint (POST): /api/v1/productConnections/connectionTest

{
"productName": "PIMSMC",
"productVersion": "productVersion",
"url": "jdbc:postgresql://IP_BANCO_DADOS_PIMSMC:PORTA/NOME_BANCO_DADOS",
"username": "Usuario",
"dataBaseType": "senha",
"enabled": true
}

2)  Se o teste da conexão for realizada com sucesso, realizar o POST do JSON no seguinte endpoint: /api/v1/productConnections utilizando a seguinte estrutura:

{
"productName": "PIMSMC",
"url": "jdbc:sqlserver://187.94.62.241:1434;databaseName=PIMSMC",
"username": "username",
"password": "password",
"dataBaseType": "dataBaseType",
"productVersion": "productVersion",
}

3) Relacionar os schemas com o produto

Cultura
LocalProducao1,
LocalProducao2,
LocalProducao3, → Para sincronizar o Talhão é necessário antes Safra e Periodo de Produção
Deposito,
Cultivar,
UnidadeMedida,
Instancia, →Para sincronizar a Fazenda
Periodo Safra → Para sincronizar o Talhão

Realizar o post do JSON no seguinte endpoint:  /api/v1/productConnections/schemas com a seguinte estrutura:

{
"idProductConnection": "ID_PRODUCT_CONNECTION_PIMSMC",
"idSchemaDefinition": "idSchemaDefinition",
"enableStandalone": true
}

• • Configurando o TOTVS Agro Beneficiamento para integrar com o TOTVS Agro Multicultivo

Para configurar a integração do TOTVS Agro Multicultivo no TOTVS Agro Beneficiamento, não é necessário aplicar nenhuma configuração no TOTVS Agro Beneficiamento, apenas ter configurado o TOTVS Connector.

• • Regras para a integração ser realizada

06. Tabelas que possuem sincronismo

• TOTVS Pesagem

  • Tipo de Pesagem

Referente a tabela tipos_pesagem_t_pesag, a qual possui dados recebidos do TOTVS Pesagem para integrar os tipos de pesagem cadastrados no TOTVS Pesagem.

• • Atributos de Pesagem

Referente a tabela atributos_t_pesag,  a qual possui dados recebidos do TOTVS Pesagem para integrar os atributos cadastrados no TOTVS Pesagem.

• • Pesagem Composição

Referente a rotina de integração do peso na tabela lotes_materia_prima, possui uma tabela transitória: lote_materia_prima_composicao. Os dados de peso são recebidos do TOTVS Pesagem. Caso o lote de matéria-prima seja encontrado no TOTVS Agro Beneficiamento, atualiza na tabela lotes_materia_prima, caso contrario é adicionado a tabela transitória lote_materia_prima_composicao.

• TOTVS Agro Multicultivo

  • Unidade de Medida

Referente a tabela unidades_medidas, a qual possui dados recebidos do TOTVS Agro Multicultivo para integrar as unidades de medidas cadastradas no TOTVS Agro Multicultivo.

• • Depósito

Referente a tabela armazens, a qual possui dados recebidos do TOTVS Agro Multicultivo para integrar os depósitos cadastrados no TOTVS Agro Multicultivo.

• • Cultura

Referente a tabela culturas, a qual possui dados recebidos do TOTVS Agro Multicultivo para integrar as culturas cadastradas no TOTVS Agro Multicultivo.

• • Fazenda

Referente a tabela fazendas, a qual possui dados recebidos do TOTVS Agro Multicultivo para integrar as fazendas cadastradas no TOTVS Agro Multicultivo.

• • Setor

Referente a tabela setores, a qual possui dados recebidos do TOTVS Agro Multicultivo para integrar os setores cadastrados no TOTVS Agro Multicultivo. Possui uma tabela transitória: setores_tcc.

• • Talhão

Referente a tabela talhoes, a qual possui dados recebidos do TOTVS Agro Multicultivo para integrar os talhões cadastrados no TOTVS Agro Multicultivo. Possui uma tabela transitória: talhoes_tcc.

• • Cultivar

Referente a tabela cultivares, a qual possui dados recebidos do TOTVS Agro Multicultivo para integrar os cultivares cadastrados no TOTVS Agro Multicultivo. 

07. Observações importantes

• Envio de dados

Como as aplicações, TOTVS Agro Beneficiamento e TOTVS Connector Client, estão em servidores diferentes, é preciso de conexão com a Internet para o envio dos dados entre as aplicações. Diante disso, é possível acontecer atrasos e lentidões no envio dos registros entre as aplicações. 

• Tabelas transitórias

O TOTVS Agro Beneficiamento possui tabelas transitórias para integrar dados do TOTVS Agro Multicultivo e TOTVS Pesagem que possuem relacionamentos e não estão integrados no TOTVS Agro Beneficiamento (Exemplo: é possível integrar um talhão que vem do TOTVS Agro Multicultivo sem possuir o setor integrado no TOTVS Agro Beneficiamento, entrando em uma tabela transitória). Caso os relacionamentos obrigatórios sejam integrados no TOTVS Agro Beneficiamento, os registros são removidos da tabela transitória e inseridos em suas tabelas definitivas.