Ticket Log
Objetivo
O conector da Ticket Log é uma solução ágil projetada para otimizar a operação de gestão de frotas e mobilidade. Com este conector, as empresas podem integrar seus fluxos de recolha autônoma, permitindo que os dados de cupons fiscais, autorizações de abastecimento e processamento de Notas Fiscais Eletrônicas (NFes) sejam sincronizados e processados automaticamente pela Fluid.
O objetivo principal é fornecer uma comunicação direta com a API da Ticket Log para validar abastecimentos, enviar NFes e consultar status operacionais, garantindo maior controle logístico e financeiro sem a necessidade de conferências manuais.
Para mais informações sobre as regras de negócio e detalhes da API, consulte a documentação oficial ou o suporte de integração da Ticket Log.
Criando um fluxo utilizando o conector Ticket Log
Para criar um fluxo utilizando o conector da Ticket Log, é necessário estabelecer uma conexão válida e, em seguida, configurar os recursos desejados no canvas da Fluid.
Criando conexão Ticket Log
A autenticação para utilização da API da Ticket Log deve ser executada através do esquema HTTP Basic (Basic Auth). Neste esquema de autenticação, é utilizado um par de login e senha.
Ao criar a conexão na Fluid, você não precisa se preocupar em montar o cabeçalho manualmente, pois a plataforma se encarrega do processo.
Configurando a conexão
Na criação da conexão, preencha os parâmetros exigidos na tela:
- Ambiente: Defina para qual ambiente a conexão apontará, selecionando entre Sandbox (para testes em homologação) ou Produção (para operações reais e dados oficiais).
- User (Usuário): O login fornecido pela Ticket Log para a integração.
- Password (Senha): A senha correspondente ao usuário.
Como funciona por baixo dos panos: A Fluid direcionará as chamadas automaticamente para a URL base do ambiente selecionado e gerará o cabeçalho HTTP Authorization em cada requisição. O valor desse cabeçalho é a palavra Basic seguida do resultado da codificação em Base64 da string usuario:senha. Por exemplo, para usuário "teste" e senha "teste", a Fluid enviará Basic dGVzdGU6dGVzdGU=
Acesse o artigo Criar ConexãoCriar Conexão para saber como configurar a conexão de forma geral.
Configurando um fluxo com Ticket Log
Crie um fluxoCrie um fluxo e arraste o conector Ticket Log para o canvas.
Selecione o conector e, na aba de Parametrização, preencha os seguintes parâmetros de configuração:
- Recurso: Entidade da Ticket Log para a qual será realizada a ação.
- Operação: Ação específica que será executada para o recurso selecionado.
Operações disponíveis por Recurso
1. Recolha Autônoma
- Buscar Autorização: Consulta uma autorização de abastecimento através dos dados do cupom fiscal. Requer dados como o código do estabelecimento, data/hora, valor do cupom e volume abastecido.
- Consultar Status NFe: Consulta o status do processamento da NFe enviada para a Recolha Autônoma. Requer o código do estabelecimento e o OID do Arquivo NFe.
- Enviar NFe: Realiza o envio do arquivo XML da NFe para vinculação a uma autorização de abastecimento. A configuração é feita através de envio de template/corpo JSON contendo o arquivo em Base64 e seu Hash MD5.
Na prática
Neste tópico, criaremos um exemplo de fluxo para consultar uma autorização de abastecimento específica utilizando os dados de um cupom fiscal.
Configuração da Parametrização:
- Recurso: Recolha Autônoma
- Operação: Buscar Autorização
- Corpo da Requisição: Campos Dinâmicos
- Código do Estabelecimento: 495034 (Código Ticketlog do estabelecimento onde ocorreu a transação)
- Data e Hora do Cupom: 2026-05-19T09:52:00-03:00 (Data e hora no formato ISO 8601)
- Valor do Cupom: 127.95 (Valor em R$ com 2 casas decimais)
- Volume Abastecido: 25.64 (Volume em litros realizado na transação)
Dica: Você também pode selecionar a opção "Template" no Corpo da Requisição caso prefira montar o JSON completo manualmente através do editor de código.
Para tratar os dados recebidos (como o código da autorização e status), utilize o De/paraDe/para nos passos seguintes.
Exemplo de Retorno
Com o passo configurado, ao disparar o fluxo, o conector enviará os parâmetros formatados adequadamente para a API da Ticket Log e retornará um objeto detalhado com o resultado da busca, indicando o sucesso ou exibindo listas de erros em caso de validações falhas:
Conclusão
Nesta documentação, vimos como é simples configurar a conexão e estruturar um fluxo prático utilizando o conector da Ticket Log na Fluid para buscar autorizações de abastecimento.
A partir dessa estrutura básica, você pode facilmente expandir a integração para outras operações, como o envio e a consulta de status de NFes. Ao automatizar essas etapas no seu fluxo, você aproveita ao máximo as vantagens do conector: elimina o tempo gasto com conferências manuais, reduz falhas humanas e garante que a sua gestão de frotas e controle financeiro operem com muito mais agilidade e segurança.