Integração de Apontamentos de Abastecimento entre TOTVS Agro Bioenergia e CTA SMART

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 CTA SMART com o TOTVS Agro Bioenergia. A comunicação entre os dois sistemas ocorre através de APIs (Application Programming Interface).

02. PREMISSAS

• A integração é feita em dois cenários, envio de dados mestres e recebimento de apontamento de abastecimento. Caso não tenham o mesmo código existe a possibilidade de realizar De/Paras. São os envios de dados mestres e suas respectivas tabelas no TOTVS Agro Bioenergia:
  
  • Prestador de Serviço - TRANSPORTA;
  • Centro de Custo - CC_CSTG;
  • Modelo de Equipamento - MODELOS;
  • Material - MATERIAIS;
  • Motorista - FUNCIONARS;
  • Categoria de Equipamento - CATEG_OPERS
  • Atendentes- FUNCIONARS;
  • Operação - OPERACOES;
  • Equipamento - EQUIPTOS;
  • Consumo Médio/Relação Operação Modelo - CONS_MEDIO;
  • Recebimento de abastecimentos - RABASTEC;
• Atentar para os seguintes cadastros:
  
  • O Código do equipamento no TOTVS Agro Bioenergia é um campo numérico, permitindo informar apenas números.

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 CTA SMART efetuando as tratativas iniciais, como buscar os IDs, através dos códigos equalizados, dos registros e inserir as informações no TOTVS Agro Bioenergia;

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 https://conectadados.totvs.app/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 CTA SMART:

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

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

c. Na tela de formulário devem ser informados o Usuário, Senha os Tokens de autenticação CTA SMART:

d. Com a gravação das informações de autenticação, será redirecionado para a página de conectores, o conector da CTA SMART 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;

       3. Após estas configurações o TOTVS Agro Conecta Dados Server começará enviar os dados mestres para a CTA SMARTe 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 por minutos) e se a integração está habilitada (Aceita o valor "N"/"S"), nomeados respectivamente por PLATAFORMA_SCHEDULE, IS_INTEGRACAO_PLATAFORMA_ATIVO

05. PARAMETRIZAÇÃO

Tabela: PARAMETERS

04. GLOSSÁRIO