Histórico da Página

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 foi construída para efetuar a comunicação entre o SAAF (Sistema Automatizado de Abastecimento de Frotas) SCA+ da empresa IONICS UNIDATA e os sistemas sistema TOTVS Agro Multicultivo e TOTVS Agro Bioenergia. A comunicação entre as soluções SAAF e TOTVS Agro Conecta Dados ocorre através do protocolo SOAPSCA+ e TOTVS Agro Data Client ocorre através de APIs REST. Essa integração consiste no envio de registros cadastrados nos sistemas TOTVS Agro e recebimento e validação de abastecimentos registrados no SAAF. recebimento de apontamentos de abastecimento do SCA+ para o Multicultivo e na resposta de abastecimentos integrados do Multicultivo para o SCA+.

02. PREMISSAS

Existem ações que devem ser executadas antes do início da importação pelo SAAF dos registros dos sistemas TOTVS Agro. Estão disponibilizados registros de equipamento, locais de abastecimento, usuários e materiais.

• TOTVS Agro Data Client:

  • Agro Data Client Deverá realizar a consulta de apontamentos de abastecimento nas APIs do SCA+, realizar a conversão da estrutura dos apontamentos para uma comum do Multicultivo, envio da lista de apontamentos convertidos para as APIs do Multicultivo, validar o retorno dos apontamentos recebidos do MC e enviar a lista de Abastecimentos integrados para o SCA+;

• SAAF:

  • Caso os equipamentos tenham sido cadastrados com códigos alfanuméricos nos sistemas TOTVS Agro, deve ser habilitada a opção para o recebimento de códigos alfanuméricos;
  • As plantas de abastecimento devem ser cadastradas conforme as Instâncias (TOTVS Agro Bioenergia) ou conforme as Unidades Administrativas (TOTVS Agro Multicultivo). No cadastro da planta, o código da instância ou unid. adm. deve ser atribuído ao campo "Id. Planta" no sistema SAAF Retaguarda;
  • Os tanques lógicos dos abastecimentos devem ser configurados conforme os pontos de abastecimento dos sistemas TOTVS Agro, no cadastro do tanque, o código do ponto deve ser atribuído ao campo "Id. Teclado" no sistema SAAF Retaguarda;
  • O endereço do WSDL disponibilizado pelo TOTVS Agro Conecta Dados para consumo do SAAF estará disponível em: http(s)://IP:PORTA/ws/IInterfaceSAAFERP?wsdl. Deve ser configurado no sistema Exchange Cloud, no campo "WSDL Service" informar "IInterfaceSAAFERPservice" e no campo "WSDL Port Descrição" informar "IInterfaceSAAFERPPort";
  • O IP e PORTA são definidos no momento da instalação do TOTVS Agro Conecta Dados.

• TOTVS Agro Conecta Dados:

  • Deverão ser executados os scripts para criação das views, na base do TOTVS Agro Bioenergia ou Multicultivo, que conterão os registros formatados para a exportação;
  • Caso a integração ocorra com o TOTVS Agro Bioenergia serão necessários uma instância padrão, um usuário padrão e uma senha padrão, que deve ser criptografada pelo aplicativo Senhas, para validação dos apontamentos de abastecimento. Estes dados são informados no momento da instalação do TOTVS Agro Conecta Dados.

03. EXEMPLO DE UTILIZAÇÃO

• Esta solução funciona como um conector entre as aplicações no sentido de enviar registros e receber apontamentos para validação e gravação nas bases dos sistemas TOTVS do sistema TOTVS Agro Multicultivo e TOTVS Agro Bioenergia.

04. DEMAIS FUNCIONALIDADES

• O TOTVS Agro Conecta Dados O TOTVS Agro Data Client trabalhará de forma passiva ativa com a automação de postos, tanto as chamadas para exportação dos registros ou importação dos abastecimentos serão realizadas pelo SAAF.

  Exportação de registros pelo TOTVS Agro Conecta Dados:

• No banco local do TOTVS Agro Conecta Dados ficará salvo somente o código do registro exportado, o id da transação (cada página de exportação conterá um id numérico de transação gerado randomicamente) e se ele foi integrado pelo SAAF;
Também ficará salvo no banco local a data e hora das exportações para que após a carga inicial, seja possível o envio somente dos registros que tiveram alterações

realizando a consulta e o envio de abastecimentos.

• Importação de registros pelo TOTVS Agro Conecta Dados:

  • Apontamento de Abastecimento:
    • Todo apontamento de abastecimento importado passará por validação. Validado, será gravado da base de dados dos sistemas TOTVS Agro, caso contrário, não será gravado o apontamento. As informações sobre o sucesso ou insucesso na validação e gravação serão enviadas na resposta da importação e serão visíveis no SAAFenviado para o SCA+. Só são enviados para o SCA+ os apontamentos que foram integrados com sucesso.

• Relatórios no TOTVS Agro Bioenergia:

  • Utilizar o botão imprimir do movimento em (Manfro Lubrificação e Abastecimento → Apontamentos → Abastecimento → Apontamento);
  • Manfro Lubrificação e Abastecimento → Visões → Relatórios → Consumo de Combustíveis.

  Relatórios no TOTVS Agro Multicultivo:

  • Utilizar o botão imprimir do movimento em (TOTVS Agro Multicultivo → Apontamentos → Manutenção → Abastecimento).

05. PARAMETRIZAÇÃO

...

• Consulte parametrização para o TOTVS Agro Multicultivo em: Parametrização TOTVS Agro Multicultivo para integração com automação de postos de combustíveis (

  SAAF

  SCA Plus -

  IONICS

  UNIDATA).

06. GLOSSÁRIO