Integração de Apontamentos de Abastecimento entre TOTVS Agro Multicultivo e Solinftec

CONTEÚDO

1. Visão Geral
2. Premissas
3. Utilização
4. Demais Funcionalidades
5. Parametrização
6. Glossário

01. VISÃO GERAL

Esta integração visa integrar apontamentos de abastecimento de equipamentos gerados pela Solinftec com o TOTVS Agro Multicultivo. A comunicação entre os dois sistemas ocorre através de APIs (Application Programming Interface).

02. PREMISSAS

• Para o funcionamento correto das integrações entre as aplicações os seguintes cadastros precisam estar equalizados (mesmo código). Atualmente estes cadastros não possuem DE PARA.
  
  • Ponto de Manutenção / Ponto de Abastecimento
  • Material
  • Funcionário
  • Equipamento
  • Operação
• Atentar para os seguintes cadastros:
  
  • O Código do equipamento no TOTVS Agro Multicultivo é um campo alfanumérico, permitindo informar letras ou zeros a esquerda e na Solinftec só permite informar números.
• Alterar o rótulo do Centro de Custo para Filial, e configurar para que envie o código da Unidade Administrativa/Instância.

03. EXEMPLO DE UTILIZAÇÃO

• Esta solução funciona como um conector entre as aplicações no sentido de buscar os apontamentos de abastecimento de equipamentos na Solinftec efetuando as tratativas iniciais, como buscar os IDs, através dos códigos equalizados, dos registros e inserir as informações no TOTVS Agro Multicultivo;
• A requisição para API de abastecimentos da Solinftec será realizado a cada 20 minutos.

04. AUTENTICAÇÃO E CONFIGURAÇÃO

1. Configuração do cliente:

                a. A página de configuração do TOTVS Agro Conecta Dados pode acessar através do link http://localhost:8080/tenants/"TENANT"/conectores. Cada cliente possui o seu próprio TENANT;

                b. No primeiro acesso será solicitado as informações referentes ao cliente, conforme formulário:

             c. Após o cadastro, haverá o redirecionamento para a página com os conectores das integrações disponíveis. 

       2. Autenticação no sistema Solinftec:

  a. Localizar o conector da Solinftec e clicar no botão Autenticação:

b. A seguinte tela será exibida, deve se clicar para abertura do formulário para informar os dados de autenticação:

c. Na tela de formulário devem ser informados o Cliente, Senha e Tenant para conexão com a plataforma da Solinftec:

d. Com a gravação das informações de autenticação, será redirecionado para a página de conectores, o conector da Solinftec ficará com a borda esquerda verde, indicando que a conexão foi estabelecida, e é NECESSÁRIO que seja habilitada, clicando na borda direita com um ícone com três barras horizontais;

e. Para as integrações realizadas com a tenant SCDI, ao ativar a integração para Recebimento de Abastecimentos, será necessário informar o Identificador da API de abastecimentos de acordo com a configuração da Solinftec (ao sair do campo de preenchimento o identificador será salvo automaticamente);

f. Também é NECESSÁRIO a configuração do TOTAL DE DIAS RETROATIVOS para busca dos apontamentos, voltando para a página de conectores, acessar as configurações do conector da Solinftec;

       3. Após estas configurações o TOTVS Agro Conecta Dados Server começará buscar os apontamentos de abastecimento na plataforma da Solinftec e disponibilizará para consumo via fila de mensagens.

      4. Existem outros dois parâmetros no TOTVS Agro Conecta Dados Client, o tempo de execução da busca de apontamentos de abastecimento (definido com expressão CRON) e se a integração está habilitada. O parâmetro de habilitação da integração pode ser alterado via requisição POST para a URL: /abastecimento/plataforma/habilitar, contendo no corpo da requisição um objeto JSON: { "habilitar": "S" }, serão admitidos somente os valores "S" (habilitar) ou "N" (desabilitar). O parâmetro para busca dos apontamentos tem valor definido para executar a cada 20 minutos.

05. PARAMETRIZAÇÃO

Tabela: PARAMETERS

04. GLOSSÁRIO