SUMARIO

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 a TicketLog para 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 menu Parâ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

  • Sem rótulos