A conciliação de combustível no n8n deve relacionar cada abastecimento a uma cobrança, um veículo e um comprovante. O fluxo precisa preservar registros sem correspondência, identificar duplicidades e separar divergências para revisão. Somar a fatura e comparar com uma planilha não basta para explicar qual transação está faltando.
Uma implantação útil começa com arquivos exportados dos sistemas que a empresa já utiliza. APIs podem entrar depois, quando houver acesso autorizado e contrato documentado. O desenho abaixo trata do fechamento de despesas de frotas; não pressupõe integração nativa com operadoras de cartão combustível nem substitui a aprovação financeira.
Resumo rápido
- Padronize valores, datas, veículos e identificadores antes de cruzar fontes.
- Use correspondência exata quando existir uma referência compartilhada.
- Encaminhe candidatos ambíguos para revisão, sem escolher o primeiro.
- Registre ajustes, estornos e reprocessamentos separadamente.
- Faça o piloto em modo de conferência, sem pagamento automático.
1. Separe conciliação de monitoramento da frota
Conciliação responde se uma despesa registrada tem correspondência nas demais fontes e se os valores concordam. Monitoramento operacional procura eventos como abastecimento incompatível com a rota ou consumo inesperado. As atividades podem trocar informações, mas precisam manter resultados e responsáveis separados.
Um abastecimento pode estar corretamente conciliado e ainda merecer investigação operacional. O contrário também ocorre: uma compra legítima pode ficar pendente porque o comprovante chegou depois. O status financeiro não deve ser usado como prova automática de regularidade do motorista ou do posto.
Para o recorte operacional, veja o guia de telemetria e alertas de frotas. Para regras gerais de reembolso, consulte auditoria de despesas contra políticas internas. Neste fluxo, o objeto principal é a ligação rastreável entre documentos e lançamentos.
Defina também o que significa “conciliado”. Uma definição possível é haver referência única, valor compatível, veículo cadastrado e documento localizado. Essa é uma política proposta para o projeto, não uma regra universal. Registre a versão da política e a data de vigência, para conseguir explicar decisões antigas após uma mudança.
2. Monte um contrato de dados para as três fontes
Comece com três conjuntos: transações da operadora, registros internos de abastecimento e comprovantes. Cada origem deve conservar seu identificador original. Acrescente um identificador interno, o arquivo de origem, a linha importada e o momento da coleta. Isso permite voltar ao material recebido quando uma transformação estiver errada.
| Fonte | Campos úteis | Cuidado |
|---|---|---|
| Operadora | ID da transação, valor, data, referência do cartão | Estorno pode chegar separado |
| Controle interno | Veículo, centro de custo, litros, autorização | Cadastro pode mudar no tempo |
| Comprovante | Identificador, emitente, itens e total | Imagem legível não garante extração correta |
| Cadastro de veículos | ID estável, placa e período de vínculo | Não usar apenas o nome do motorista |
| Conciliação | IDs relacionados, regra, status e responsável | Preservar histórico de revisões |
Converta valores monetários para centavos inteiros na etapa de normalização. Não compare números obtidos por leitura permissiva de textos como “1.234,56”. Defina explicitamente a convenção de cada arquivo e rejeite valores que não correspondam a ela. Datas precisam de origem, fuso e distinção entre data do abastecimento e data da cobrança.
Placa é um atributo útil, mas um identificador interno estável reduz problemas quando há correções cadastrais. Mantenha o vínculo entre cartão e veículo com período de validade. Um cartão realocado não deve fazer transações antigas aparecerem no veículo novo durante um reprocessamento.
Guarde o arquivo recebido sem sobrescrever a versão anterior. Um hash do arquivo ajuda a reconhecer reenvios, mas não substitui a chave de cada transação. O fornecedor pode reenviar o mesmo conteúdo em ordem diferente ou atualizar uma linha mantendo o nome do arquivo. São situações que exigem controles separados.
3. Desenhe o workflow no n8n em etapas pequenas
Monte primeiro um caminho manual: importar amostras, normalizar campos, validar estrutura, procurar correspondências e produzir uma fila de conferência. Agendamento só deve entrar quando os resultados forem previsíveis. Use credenciais próprias do ambiente e restrinja quem pode visualizar os documentos processados.
Quando houver API contratada, o nó HTTP Request pode realizar as chamadas conforme a documentação do fornecedor. Configure autenticação, paginação e tratamento das respostas. O recurso genérico do n8n não comprova que uma operadora específica disponibiliza API ou autoriza aquele uso; confirme essas condições diretamente antes de implementar.
No caminho de arquivos, mantenha um padrão de colunas negociado com o financeiro. Arquivos com coluna removida, moeda diferente ou cabeçalho inesperado devem parar na validação. Não substitua silenciosamente um campo ausente por zero. O fluxo precisa diferenciar “valor zero” de “valor desconhecido”.
Use o nó Code para transformações curtas e explícitas. Um exemplo de validação para valores brasileiros, antes da conversão, é aceitar apenas uma expressão definida pelo contrato. O trecho a seguir recebe valor_br como texto sem separador de milhar, por exemplo 320,50. Outros formatos vão para rejeição.
return $input.all().map(item => {
const texto = String(item.json.valor_br ?? '').trim();
if (!/^d+,d{2}$/.test(texto)) {
return { json: { ...item.json,
status_importacao: 'revisar_formato_valor' } };
}
const [reais, centavos] = texto.split(',');
const valor = Number(reais) * 100 + Number(centavos);
if (!Number.isSafeInteger(valor)) {
return { json: { ...item.json,
status_importacao: 'revisar_limite_numerico' } };
}
return { json: { ...item.json, valor_centavos: valor,
status_importacao: 'validado' } };
});Esse contrato cobre compras positivas. Estornos precisam de um campo de natureza e de uma regra específica, em vez de passarem pela mesma validação sem distinção. Preserve o sinal e a referência à compra original no modelo definitivo. Uma entrada rejeitada deve continuar visível no relatório de importação.
4. Faça o casamento sem esconder diferenças
A primeira tentativa deve usar uma referência compartilhada e única. Antes do cruzamento, verifique se essa referência aparece mais de uma vez em qualquer origem. Se houver repetição, interrompa o casamento automático daquele grupo. Uma junção de duas listas com duplicatas pode multiplicar linhas e inflar os totais.
O nó Merge oferece combinações por campos correspondentes. Escolha uma configuração que preserve os itens necessários à auditoria e teste explicitamente os não encontrados. Não use apenas a saída de correspondências como se representasse a totalidade do fechamento. Mantenha também as sobras de cada fonte.
Se não existir referência comum, forme candidatos usando veículo, período e valor. Uma janela de tempo é uma convenção do processo, não evidência definitiva. Se dois candidatos cumprirem os critérios, marque ambiguidade. Não selecione por posição na planilha ou pelo primeiro retorno da API.
Trate tolerância monetária como parâmetro aprovado, expresso em centavos. O projeto pode começar exigindo igualdade exata e encaminhar qualquer diferença para análise. Se houver arredondamento documentado, registre sua origem e a regra utilizada. Não adote uma tolerância ampla apenas para diminuir a fila de pendências.
Uma classificação prática inclui “conciliado por ID”, “candidato para revisão”, “sem comprovante”, “sem cobrança”, “duplicado” e “estornado”. Acrescente os IDs das linhas, a versão da regra e o motivo. O operador deve conseguir explicar a decisão sem reabrir e interpretar todo o workflow.
Calcule totais de entrada, totais relacionados e totais pendentes em cada origem. Eles não precisam ser idênticos entre fontes com datas de corte diferentes, mas a diferença deve ser explicada por registros específicos. Defina também como tratar compras parceladas ou cobranças agregadas antes de aceitá-las no mesmo caminho.
5. Exemplo: distribuidora com frota em Goiânia
Imagine uma distribuidora de Goiânia que usa veículos próprios para entregas e recebe um arquivo de transações da operadora. O controle interno traz veículo e autorização; os comprovantes ficam em uma pasta organizada pelo financeiro. O cenário é ilustrativo e não representa resultados medidos de uma empresa real.
Em uma linha fictícia, o arquivo informa compra de R$ 320,50 e o controle interno contém a mesma referência e valor. O comprovante correspondente foi localizado. O fluxo registra as três ligações e sugere conciliação. A aprovação final continua com o responsável definido na política da empresa.
Em outra linha, a cobrança existe, mas há dois comprovantes com valor idêntico no mesmo dia. Mesmo que um pareça mais próximo do horário informado, o workflow deixa ambos como candidatos. O financeiro consulta a autorização ou outro identificador para decidir. Igualdade de valor, sozinha, não resolve a identidade do evento.
Uma terceira compra recebe estorno na exportação seguinte. O sistema mantém a transação original e vincula o estorno, recalculando o saldo conforme a natureza do evento. Excluir a compra antiga apagaria a explicação do que aconteceu e dificultaria comparar os relatórios dos dois períodos.
A equipe testa ainda um comprovante entregue após o fechamento. A pendência passa por nova revisão com registro de data e responsável. O relatório original permanece preservado; uma versão posterior mostra a mudança. Assim, a atualização não reescreve silenciosamente o histórico que já foi apresentado à gestão.
6. Proteja o reprocessamento e teste as falhas
Use uma chave persistente para cada transação e uma restrição de unicidade no armazenamento. A execução do n8n pode ser repetida depois de um erro; essa repetição não deve criar uma segunda despesa. Idempotência significa que repetir a mesma entrada mantém o efeito correto, em vez de duplicá-lo.
Separe falha técnica de pendência de negócio. API indisponível, arquivo ilegível e ausência de credencial são falhas técnicas. Comprovante ausente ou diferença de valor são pendências do processo. Cada grupo precisa de fila, responsável e prazo próprios, para o financeiro não receber mensagens que só a equipe técnica consegue resolver.
A documentação do n8n descreve workflows de erro. Use-os para registrar a execução afetada e avisar a equipe responsável sem expor dados completos em notificações. Para pendências comerciais, construa uma saída explícita no fluxo principal. Uma linha divergente não precisa derrubar todo o lote.
Antes de agendar, execute uma bateria pequena: arquivo repetido, referência duplicada, valor malformado, comprovante atrasado, estorno e falha após gravar parcialmente. Confira tanto as linhas quanto os totais. O critério de aprovação é conseguir reprocessar sem duplicações e explicar cada diferença, não apenas ver a execução terminar em verde.
Erros comuns
Usar IA para decidir identidade financeira. Um modelo pode ajudar a sugerir campos de um comprovante, mas os valores precisam de validação. Preserve a imagem e a extração original. Não transforme confiança declarada pelo modelo em autorização para pagar.
Descartar registros não encontrados. A ausência de correspondência é um resultado relevante. Uma junção que mostra somente os pares encontrados pode produzir um relatório aparentemente limpo enquanto oculta despesas sem suporte documental.
Confundir litragens com valores. Litros, preço unitário e total têm escalas e regras de arredondamento diferentes. Valide cada campo conforme sua finalidade. Não use uma multiplicação arredondada para alterar o valor cobrado sem justificativa registrada.
Automatizar aprovação antes de estabilizar a conferência. Comece com leitura e sugestões. Depois de revisar exceções reais, decida quais transições podem ser automáticas. Integração com pagamento é outro projeto, com critérios próprios de autorização e reversão.
Perguntas frequentes
Preciso de IA para conciliar combustível?
Não. Identificadores, normalização e regras determinísticas resolvem o núcleo do cruzamento. IA pode apoiar a leitura de documentos, desde que a extração seja conferida e não substitua a rastreabilidade.
O n8n conecta diretamente a qualquer cartão combustível?
Não se deve presumir isso. Verifique a documentação e o contrato da sua operadora. O workflow pode começar com exportações autorizadas e incorporar HTTP Request quando existir uma API disponível para a empresa.
Qual tolerância de valor devo usar?
Aquela aprovada e justificada pelo processo. Começar com igualdade exata torna as diferenças visíveis. Qualquer tolerância posterior deve estar documentada, versionada e aplicada de maneira consistente.
Como tratar abastecimento sem comprovante?
Mantenha a transação como pendente e solicite o documento pelo processo interno. Registre prazo e responsável. A ausência não autoriza concluir automaticamente que houve irregularidade ou que a despesa deve ser descartada.
