Integração com automação de postos de combustíveis (SAAF - IONICS)

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) da empresa IONICS e os sistemas 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 SOAP. Essa integração consiste no envio de registros cadastrados nos sistemas TOTVS Agro e recebimento e validação de abastecimentos registrados no SAAF. 

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.

• 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 Agro Multicultivo e TOTVS Agro Bioenergia.

04. DEMAIS FUNCIONALIDADES

• O TOTVS Agro Conecta Dados trabalhará de forma passiva 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.

• 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 SAAF.

• 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 Bioenergia em: Parametrização TOTVS Agro Bioenergia para integração com automação de postos de combustíveis (SAAF - IONICS).
• 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 - IONICS).

06. GLOSSÁRIO