Introdução

Este documento orienta o time de suporte técnico e franquias na validação da comunicação entre o EMSys3 e a API da TicketLog, utilizando o Postman para testes.

O objetivo é garantir que credenciais e parâmetros estejam configurados corretamente antes do uso em produção.

Caso ocorram falhas na comunicação, recomenda-se verificar as configurações e credenciais. Persistindo o problema, o cliente deve contatar a TicketLog para suporte.

Seguindo as etapas descritas, o time poderá testar e validar a integração de forma segura e padronizada, agilizando a análise e resolução de chamados.

Importante: Este documento não deve ser publicado ou compartilhado externamente.

Exemplo de Requisição POST no Postman

Método e URL

• Método: POST

• URL: (Informe aqui o endpoint fornecido pela TicketLog)

Autenticação

• Authorization → Type → Basic Auth

• Username: Usuário da Ticketlog

• Password: Senha da Ticketlog

Observações importantes:

• As informações de autenticação podem ser verificadas no EMSys3, acessando o menu Parâmetros da Empresa → TicketLog.

Observação: A senha é de responsabilidade do cliente. Caso o cliente não possua as credenciais, ele deve entrar em contato diretamente com aTicketLogpara obtê-las.

Headers

• Content-Type: application/json

• POSTMAN

Configuração da Requisição no Postman

Método e URL

No Postman, selecione o método POST e informe a seguinte URL: https://srv1.ticketlog.com.br/ticketlog-servicos/credenciamento/recolhaAutonoma/buscarAutorizacao

Configuração de Autenticação

Após definir o método POST e a URL, siga os passos abaixo:

1. Selecione a aba Authorization no Postman.

2. No campo Auth Type, escolha a opção Basic Auth.

3. Serão exibidos dois campos:

   • Username: informe o usuário da TicketLog

   • Password: informe a senha da TicketLog

Observação: As credenciais (usuário e senha) devem ser informadas conforme os dados configurados no EMSys3, no menuParâmetros da Empresa → TicketLog.

Na aba Headers, na coluna Key informe Content-Type e na coluna Value informe application/json.

Body (raw JSON)

Inclua no corpo da requisição (formato JSON) as seguintes informações:

{ "codigoEstabelecimento": "Código do estabelecimento na TicketLog", "valorCupom": "Valor total do cupom", "dataHoraCupom": "AAAA-MM-DDTHH:MM:00-03:00", "volumeAbastecido": "Quantidade abastecida (duas casas decimais, ex: 68.70)" }

Descrição dos Campos

• codigoEstabelecimento: Código do estabelecimento cadastrado na TicketLog.

          Pode ser validado no EMSys3, acessando:Parâmetro de Empresa → Aba Ticket → Campo “Cód. do Estabelecimento Ticket” ou “Cód. Estabelecimento Express”

• valorCupom, dataHoraCupom e volumeAbastecido: Esses dados podem ser consultados no EMSys, em Vendas → TicketLog.

          Exemplo:

Após preencher as informações no Postman, clicar em SEND

Validação da Comunicação com a API da TicketLog

• Caso o Postman retorne um código de autorização da transação, significa que a comunicação com a API da TicketLog foi realizada com sucesso.

• Ao realizar o mesmo teste no EMSys3, utilizando as mesmas credenciais (usuário e senha), o sistema também deve conseguir se comunicar com a API.

  • Se ocorrerem erros no EMSys3, é necessário verificar os logs do sistema para identificar o motivo da falha.

• Se o erro ocorrer tanto no EMSys3 quanto no Postman, o problema provavelmente está relacionado a configuração incorreta ou credenciais inválidas (usuário/senha).
  Nesse caso, o cliente deve validar as informações diretamente com a TicketLog.

Manuais Relacionados

Manual do EMSys:

https://share.linx.com.br/pages/viewpage.action?pageId=180573772

Manual da Ticketlog consulta API:

https://www.ticketlog.com.br/arq/2022/Pre%C3%A7o%20Negociado/api-RecolhaAut%C3%B4noma.pdf