Conciliar faturas de energia no mercado livre exige cruzar a cobrança recebida com o contrato vigente, a unidade consumidora, o período de medição e os documentos que explicam ajustes. O n8n pode organizar essa conferência e encaminhar diferenças para análise. A decisão de pagar, contestar ou alterar um lançamento continua com os responsáveis da empresa.
O ponto central é montar um dossiê por unidade e competência, preservando a separação entre compra de energia, uso da rede e serviços contratados. Ler corretamente um PDF é apenas a entrada. A conciliação começa quando os valores extraídos encontram uma regra documentada de comparação.
Resumo rápido
- Identifique unidade, fornecedor, contrato e período antes de comparar valores.
- Separe cobrança da distribuidora, energia contratada e serviços adicionais.
- Use regras determinísticas para cálculos e deixe cláusulas ambíguas na fila humana.
- Controle documentos substituídos, reprocessamentos e ajustes de meses anteriores.
- Registre evidências e responsáveis antes de liberar qualquer ação financeira.
O que precisa entrar na conciliação
O Portal do Consumidor da CCEE explica a separação entre a fatura da distribuidora e a do fornecedor escolhido no mercado livre, além da manutenção do relacionamento de uso da rede. Isso ajuda a entender por que duas cobranças no mesmo mês não significam, por si só, duplicidade. Consulte a orientação da CCEE para indústrias e grandes comércios antes de desenhar o cadastro.
Na implantação proposta aqui, cada documento recebe uma natureza: distribuição, energia, gestão ou ajuste. Essa classificação é interna e precisa refletir os contratos reais. O fluxo não deve concluir que uma cobrança está indevida só porque o fornecedor ou o formato mudou.
Reúna contrato de compra, aditivos, documentos da distribuidora, memória de cálculo fornecida pelo comercializador e demonstrativos de medição disponíveis à empresa. Quando existir representação varejista, confirme com o responsável quais informações chegam por esse representante. Não presuma acesso direto da empresa a todos os sistemas da CCEE.
Se a dificuldade atual é transformar documentos em campos, comece pelo guia de extração de dados de faturas de energia. Aqui o objetivo é a etapa seguinte: relacionar cobranças e identificar exceções comerciais com rastreabilidade.
Monte um cadastro com regras versionadas
Crie um identificador interno estável para cada unidade. Vincule a ele os números usados pela distribuidora, pelo ERP e pelo fornecedor. CNPJ sozinho é insuficiente quando uma empresa tem várias instalações. Mantenha também o histórico de titularidade e as datas de vigência dos vínculos.
Transforme cláusulas aprovadas em uma tabela de parâmetros. Registre unidade de medida, base do preço, regra de reajuste, período de aplicação, condições de flexibilidade e responsável pela interpretação. A tabela é uma representação operacional do contrato; não substitui o documento assinado nem resolve dúvidas jurídicas automaticamente.
| Objeto | Referência para conferir | Exceção a encaminhar |
|---|---|---|
| Compra de energia | Contrato e memória de cálculo | Preço aplicado sem regra correspondente |
| Uso da rede | Documentos da distribuidora e contrato aplicável | Componente sem identificação suficiente |
| Serviço de gestão | Escopo e cobrança contratada | Serviço fora da vigência cadastrada |
| Ajuste retroativo | Documento e competência de origem | Ajuste repetido ou sem memória |
| Documento substituto | Vínculo com a versão anterior | Duas versões marcadas para pagamento |
Um reajuste novo não pode sobrescrever o parâmetro antigo. Guarde início e fim de vigência e identifique a versão usada em cada conferência. Assim, reprocessar uma cobrança histórica não aplica silenciosamente as condições atuais a um mês passado.
Para valores monetários, use aritmética decimal no componente de cálculo. Defina a regra de arredondamento e compare subtotais antes do total geral. Converter MWh para kWh exige uma transformação explícita; um campo chamado apenas “consumo” deixa espaço para um erro de escala.
Desenhe o fluxo no n8n por estados
Uma sequência inicial pode usar coleta autorizada de arquivos, registro no repositório, normalização, consulta aos parâmetros, cálculo, classificação de diferenças e criação de tarefa no ERP. O nó HTTP Request permite integrar serviços por API, conforme a documentação oficial do n8n. A existência desse nó não garante que seu fornecedor disponibilize API.
Defina estados claros: recebido, aguardando documento, pronto para conferir, divergente, revisado e encerrado. Uma execução tecnicamente bem-sucedida pode terminar em “aguardando documento”. Isso é diferente de conciliação concluída. O painel deve mostrar separadamente falhas de integração e pendências do negócio.
- Receba o arquivo e calcule uma impressão digital para reconhecer reenvios idênticos.
- Associe a unidade e a natureza da cobrança usando identificadores confirmados.
- Localize o contrato e os parâmetros vigentes no período correto.
- Execute somente comparações para as quais existem dados e regra aprovada.
- Abra uma ocorrência com os campos divergentes e as referências utilizadas.
- Grave o retorno do ERP e a decisão humana, sem apagar o histórico.
Para o registro de cobrança, use uma chave de negócio composta por unidade, fornecedor, natureza, período e identificador do documento. O hash reconhece arquivos iguais, mas documentos distintos podem tratar da mesma obrigação. Já uma segunda via com conteúdo diferente não deve criar automaticamente uma nova dívida.
Faça a gravação protegida por unicidade no banco. Duas execuções simultâneas podem consultar “não existe” e tentar inserir juntas. Quando houver timeout do ERP depois do envio, consulte o identificador externo antes de repetir a criação. Esse cuidado precisa estar no desenho da integração.
Trate diferenças sem esconder a origem
Separe discrepância de valor, falta de documento, inconsistência de período e dúvida contratual. Cada uma exige uma ação diferente. “Divergência de R$ 320” é uma descrição fraca; “preço unitário recebido diferente da versão contratual aplicada ao período” oferece um caminho verificável de investigação.
Não transforme tolerância em autorização genérica. Uma diferença pequena pode refletir arredondamento, mas também cadastro incorreto. Se a equipe aprovar uma tolerância, registre a justificativa, o componente ao qual se aplica e a data de revisão. Nunca use a mesma margem para todos os tipos de cobrança.
Períodos merecem atenção especial. Data de emissão, vencimento, intervalo medido e competência financeira têm funções diferentes. Um ajuste lançado agora pode se referir a um mês anterior. Preserve as duas referências e explique como ele afeta o fechamento, sem mudar a competência por aproximação.
A IA pode ajudar a redigir uma descrição curta da ocorrência a partir de campos confirmados. Para calcular diferenças e escolher parâmetros contratuais, priorize regras explícitas. Quando uma cláusula estiver ambígua, encaminhe o trecho e a dúvida para o especialista, sem produzir uma interpretação definitiva.
A documentação de tratamento de erros do n8n orienta o uso de fluxos de erro. Configure alertas com o identificador do dossiê e o passo que falhou. Evite anexar contratos completos ou dados de pagamento em notificações abertas a toda a empresa.
Exemplo: indústria de alimentos em Contagem
Considere uma indústria fictícia em Contagem, Minas Gerais, com duas instalações. A equipe recebe cobranças da distribuidora e de uma comercializadora, além de uma memória de cálculo separada. O exemplo ilustra a organização do processo e não representa uma auditoria, tarifa real ou economia esperada.
Na instalação A, um documento informa 120 MWh e preço ilustrativo de R$ 250 por MWh para um componente contratual simples. A multiplicação gera R$ 30.000 para aquele componente. Esse cálculo não representa o total da fatura: tributos, serviços e ajustes precisam de referências próprias e revisão adequada.
O arquivo recebido apresenta R$ 30.300 nesse mesmo componente. O n8n registra diferença de R$ 300, vincula contrato e memória e abre uma ocorrência. A equipe encontra um ajuste descrito em anexo, mas referido ao mês anterior. Em vez de declarar cobrança indevida, pede a identificação da origem e verifica se o ajuste já foi considerado.
Na instalação B, falta a memória de cálculo. O fluxo marca “aguardando documento” e atribui a pendência ao gestor do contrato. A ausência do anexo não vira aprovação automática por comparação com o valor do mês passado. O histórico pode apoiar uma investigação, mas não substitui a referência contratual.
Depois da revisão, o analista registra a explicação aceita ou a contestação enviada, com referência ao protocolo. A aprovação financeira acontece no processo existente da empresa. Para estruturar essa passagem, use os princípios de aprovação humana em automações, com responsáveis e evidências disponíveis.
Erros comuns
Comparar somente o total com o mês anterior. Mudanças de consumo e composição tornam essa regra insuficiente. Use o histórico como sinal auxiliar e examine componentes com bases comparáveis.
Somar documentos sem entender a natureza. Uma segunda via, um demonstrativo e uma fatura podem repetir valores sem criar três obrigações. Mantenha vínculos entre documentos e registre qual deles sustenta o lançamento financeiro.
Tratar parâmetros ausentes como zero. Ausência de preço, volume ou tributo precisa bloquear o cálculo daquele item. Um resultado matemático completo com dados inventados é menos útil que uma pendência bem descrita.
Concluir que o fluxo garante conformidade regulatória. Automação de conferência não substitui revisão especializada. A orientação oficial deve sustentar o cadastro; cláusulas específicas e eventuais controvérsias exigem análise dos responsáveis.
Não testar reenvio e substituição. No piloto, repita o mesmo arquivo, envie uma versão corrigida, simule indisponibilidade do ERP e processe um ajuste retroativo. Verifique o estado final e a ausência de lançamentos duplicados. Uma tela sem erro não prova que a conciliação está correta.
Meça documentos sem unidade associada, pendências por motivo, tempo até revisão e correções após encerramento. Compare períodos equivalentes, anotando mudanças de volume. Esses indicadores mostram onde melhorar o fluxo sem prometer redução de custo de energia.
Perguntas frequentes
O n8n consegue dizer se minha fatura está legalmente correta?
Ele pode executar as conferências que você programou com referências aprovadas. A conclusão regulatória ou contratual depende do contexto e dos profissionais responsáveis. Uma divergência automática é um pedido de investigação, não uma decisão jurídica.
Preciso integrar diretamente com a CCEE?
Não necessariamente. Comece pelos documentos e canais autorizados disponíveis à empresa e ao seu representante. Confirme acessos e responsabilidades com o gestor do contrato antes de planejar qualquer integração.
Posso pagar automaticamente o que passar nas regras?
Comece com conferência e preparação de tarefas. Qualquer mudança na autorização de pagamentos precisa seguir a política financeira da empresa, com segregação de funções e revisão de exceções. Não inclua pagamento apenas porque a integração permite escrita.
Como lidar com contrato alterado no meio do período?
Preserve as versões e encaminhe o caso até existir regra aprovada para a divisão aplicável. Não escolha a versão pela data de recebimento do arquivo. Registre quais documentos e datas sustentaram a decisão.
O fluxo serve para poucas unidades?
Sim, desde que o esforço de manter cadastro e regras faça sentido. Um piloto com uma unidade permite conferir a qualidade das entradas e o tratamento das exceções antes de expandir para toda a operação.
