--- title: Ticket Log slug: ticket-log docTags: createdAt: 2026-06-23T20:52:03.700Z --- ## 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=` :::hint{type="info"} Acesse o artigo [Criar Conexão](docId:1pCVN0mJbFKUjHMhj86K-) para saber como configurar a conexão de forma geral. ::: ### Configurando um fluxo com Ticket Log [Crie um fluxo](docId\:OcJTBFHi9Rerkr2d6OwIP) 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. ![](https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/CeHUoWcF886seBwxo9mAw_image.png) 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)* :::hint{type="info"} **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/para](docId\:VOQdaUkjjknbSWVRHbzQW) 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: :::BlockQuote \{ "codigoAutorizacao": 9085044512 } ::: ### 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.