Integração de Apontamentos de Abastecimento entre TOTVS Agro Multicultivo e Korth Guardian Web

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 Korth Guardian 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.
  
  • Unidade Administrativa
  • 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.

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 Korth Guardian 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 Korth Guardian será realizado a cada 20 minutos.

04. AUTENTICAÇÃ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 Korth Guardian:

  a. Localizar o conector da Korth Guardian 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 Login e Senha para conexão com a plataforma da Korth Guardian:

d. Com a gravação das informações de autenticação, será redirecionado para a página de conectores, o conector da Korth Guardian 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. Também é NECESSÁRIO a configuração do TOTAL DE DIAS RETROATIVOS para busca dos apontamentos (LIMITADO A 90 DIAS) , voltando para a página de conectores, acessar as configurações do conector da Korth Guardian;

       3. Após estas configurações o TOTVS Agro Conecta Dados começará buscar os apontamentos de abastecimento na plataforma da Korth Guardian 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