Validador de fatura UBL/Peppol

Verifique a estrutura antes que a rede a verifique por você

A forma cara de descobrir que um arquivo de fatura está quebrado é enviá-lo: ele viaja até o seu cliente ou um ponto de acesso, é rejeitado horas ou dias depois, e o relógio do pagamento recomeça do zero. A forma barata é gastar trinta segundos aqui primeiro. Este validador responde às perguntas diretas e úteis: o arquivo é sequer um XML bem formado, ele é de fato uma Invoice UBL, e estão presentes os campos que qualquer fatura legível precisa — número, datas, as duas partes, linhas e totais. Os arquivos são verificados na memória do servidor e descartados imediatamente, que é a forma adequada de tratar um documento que carrega nomes, valores e dados bancários. Ele se justifica especialmente em duas situações: uma pequena empresa gerando suas primeiras faturas UBL a partir de um modelo ou de um módulo de ERP desconhecido, e um desenvolvedor testando um pipeline de exportação que quer uma opinião externa rápida sobre a saída antes de apontá-la para a rede de verdade.

O que é uma verificação estrutural — e o que é o Schematron

A honestidade importa aqui. A validação oficial do Peppol BIS Billing 3.0 é um conjunto de regras Schematron: centenas de regras de negócio que verificam coisas como se os códigos de categoria de IVA são consistentes e se os totais de imposto batem com a soma das linhas. Esta ferramenta não executa essas regras. Leia os dois resultados de acordo com isso: uma falha aqui é definitiva — um arquivo que não é processável, ou que carece de campos obrigatórios, vai falhar em qualquer lugar, então corrija-o antes de enviar. Uma aprovação aqui significa que a estrutura é utilizável, não que toda regra de negócio foi satisfeita; a rede ainda pode rejeitá-lo por uma violação em nível de regra. Estrutural primeiro, Schematron depois, é a ordem natural de verificação. O limite é proposital, não preguiça: os conjuntos de regras oficiais são versionados e mantidos de forma centralizada, e executá-los corretamente é tarefa da própria infraestrutura Peppol — imitar isso de forma malfeita serviria pior do que simplesmente declarar o limite com clareza.

As falhas que realmente vemos

A maioria dos arquivos rejeitados se encaixa em um punhado de padrões. O arquivo é uma nota de crédito em vez de uma fatura — um tipo de documento UBL diferente, que este validador ainda não cobre. É um PDF Factur-X em vez de XML puro — a fatura está incorporada dentro de um PDF e precisa ser extraída primeiro com a ferramenta Factur-X deste site. Ele foi truncado ou recodificado em algum ponto do trajeto por e-mail, então o XML deixou de ser processável. Ou uma exportação de ERP deixou campos obrigatórios de parte ou de total vazios porque um registro de dados-mestre estava incompleto. O validador nomeia o que está faltando, o que geralmente aponta direto para qual desses casos aconteceu. Uma variante mais sutil vale a pena conhecer: um arquivo que abre normalmente em um editor de texto ainda pode falhar ao ser processado porque um gateway de e-mail ou uma etapa de copiar e colar mudou a sua codificação de caracteres — invisível a olho nu, fatal para o XML. Reexporte a partir do sistema de origem em vez de reparar manualmente.

O mesmo analisador do renderizador de PDF — e quando acionar o seu provedor

Este validador compartilha o seu analisador, linha por linha, com a ferramenta de fatura eletrônica para PDF deste site. Isso te dá um fluxo de trabalho pequeno e confiável: valide o arquivo, depois renderize-o e leia a fatura como uma pessoa leria — um IBAN errado ou um total absurdo geralmente é mais fácil de notar em uma página do que em XML. E saiba onde está o limite: se um arquivo passa aqui, renderiza de forma sensata e ainda assim é rejeitado pela rede Peppol, o problema está no nível de regra de negócio ou de transmissão. Essa conversa é com o seu ponto de acesso ou fornecedor de software, que consegue ver o relatório oficial de validação — leve a mensagem de erro deles com você, porque ela nomeia exatamente a regra que foi acionada.

O que esta ferramenta realmente verifica

Isso confirma que o arquivo é um XML bem formado, tem uma raiz Invoice do UBL e contém os campos que uma fatura legível precisa: número da fatura, datas, dados do fornecedor e do cliente, itens e totais. É uma verificação estrutural básica, não a validação oficial por Schematron do Peppol BIS Billing 3.0 — ela não detecta toda violação de regra de negócio (por exemplo, totais de impostos que não fecham corretamente), apenas se a estrutura é utilizável.