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
Integração | Origem | Cross | Destino | Classe | Tabela/Rotina | Tabela Transitória | Regras para Integração |
Tipo de Pesagem | TOTVS Pesagem | TOTVS Connector | TOTVS Agro Beneficiamento | TipoPesagemListener | tipos_pesagem_t_pesag | - | (1,2,3) |
Atributos de Pesagem | TOTVS Pesagem | TOTVS Connector | TOTVS Agro Beneficiamento | AtributoPesagemListener | atributos_t_pesag | - | (1,2,3) |
Pesagem Composição | TOTVS Pesagem | TOTVS Connector | TOTVS Agro Beneficiamento | PesagemComposicaoListener | lotes_materia_prima | lote_materia_prima_composicao | (1,2,3,5) Atualiza o campo peso_liquido quando encontra o lote ou gera a tabela lote_materia_prima_composição. A pesagem deve estar com status de 'C' completa, tipo de pesagem deve ser o mesmo da opção configurações e deve ser enviado a etiqueta e a fazenda (atributos). No log da API é gravado o conteúdo de todas as pesagens recebidas independente da configuração do Beneficiamento |
Dispositivos (Balanças) | TOTVS Agro Beneficiamento | - | TOTVS Pesagem | TPesagClient | Consulta as balanças cadastradas no TPesag para configurar na etiqueta SAI do Beneficiamento | - | URL de Comunicação / Usuário / Senha configurados no TOTVS Agro Beneficiamento. TOTVS Pesagem deve ter o TOKEN enviado pelo TOTVS Agro Beneficiamento configurado arquivo próprio para disponibilizar TOKEN de acessos aos serviços do TOTVS Pesagem. |
Peso Disponibilizado pela Balança | TOTVS Agro Beneficiamento | - | TOTVS Pesagem | TPesagClient | Obter o peso do produto beneficiado | - | URL de Comunicação / Usuário / Senha configurados no TOTVS Agro Beneficiamento. TOTVS Pesagem deve ter o TOKEN enviado pelo TOTVS Agro Beneficiamento configurado arquivo próprio para disponibilizar TOKEN de acessos aos serviços do TOTVS Pesagem. |
Regras para integração: (1) Tabela tcc_event coluna processed_at preenchida (2) Não houver erro no tcc-client (3) Esquema de integração configurado (4) Tabelas vinculadas devem estar processadas (5) Agendamento para processamento de tabela transitória |
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
Integração | Origem | Cross | Destino | Classe | Tabela | Tabela Transitória | Regras para Integração |
Unidade de Medida | TOTVS Agro Multicultivo | TOTVS Connector | TOTVS Agro Beneficiamento | UnidadeMedidaListener | unidades_medidas | - | (1,2,3) |
Depósito | TOTVS Agro Multicultivo | TOTVS Connector | TOTVS Agro Beneficiamento | ArmazemListener | armazens | - | (1,2,3) |
Cultura | TOTVS Agro Multicultivo | TOTVS Connector | TOTVS Agro Beneficiamento | CulturaListener | culturas | - | (1,2,3) |
Fazenda | TOTVS Agro Multicultivo | TOTVS Connector | TOTVS Agro Beneficiamento | FazendaListener | fazendas | - | (1,2,3) |
Setor | TOTVS Agro Multicultivo | TOTVS Connector | TOTVS Agro Beneficiamento | SetorListener | setores | setores_tcc | (1,2,3,4,5) Quando não existir a fazenda no beneficiamento gera a tabela setores_tcc |
Talhão | TOTVS Agro Multicultivo | TOTVS Connector | TOTVS Agro Beneficiamento | TalhaoListener | talhoes | talhoes_tcc | (1,2,3,4,5) Quando não existir o setor no beneficiamento gera a tabela talhoes_tcc |
Cultivar | TOTVS Agro Multicultivo | TOTVS Connector | TOTVS Agro Beneficiamento | CultivarListener | cultivares | - | (1,2,3) Campo variedade MDM deve estar preenchido |
Regras para integração: (1) Tabela tcc_event coluna processed_at preenchida (2) Não houver erro no tcc-client (3) Esquema de integração configurado (4) Tabelas vinculadas devem estar processadas (5) Agendamento para processamento de tabela transitória |
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.