Fatura UBL/Peppol para PDF

Peppol, UBL e por que você ainda precisa de uma cópia legível

Durante décadas uma fatura era um documento que dava para ler. Desde a obrigatoriedade de faturamento eletrônico B2B da Bélgica, e com regras equivalentes entrando em vigor por toda a Europa, uma parcela crescente das faturas passou a ser arquivos de dados estruturados — XML construído segundo um padrão para que o software de contabilidade consiga lê-los sem ninguém redigitar nada. É uma melhoria genuína para a automação e um incômodo genuíno para as pessoas, porque abrir um deles no navegador entrega uma parede de tags em vez de uma fatura. Esta ferramenta transforma esse arquivo no documento que você esperava: emitente e destinatário, as linhas, a discriminação do IVA, os totais e os dados de pagamento, dispostos para ler, imprimir ou anexar a um e-mail.

UBL, Peppol BIS, Factur-X: o que os nomes significam

UBL 2.1 é a linguagem XML que está por baixo dos documentos comerciais. Peppol BIS Billing 3.0 é um conjunto de regras específico e mais apertado construído sobre o UBL, e é o que a maior parte do faturamento eletrônico europeu realmente usa — ele diz quais campos são obrigatórios e como devem ser preenchidos, para que dois sistemas que nunca se viram ainda assim se entendam. O Peppol em si é a rede pela qual esses documentos trafegam. Já o Factur-X, conhecido como ZUGFeRD na Alemanha, é uma ideia completamente diferente: um PDF normal com o XML estruturado embutido dentro dele, de modo que um único arquivo serve tanto ao humano quanto à máquina. Se você tem um desses, não precisa gerar nada — precisa extrair o XML que já está lá dentro, o que é uma ferramenta separada neste site.

O que esta ferramenta lê e o que ela não lê

Ela trata documentos Invoice do UBL 2.1, incluindo Peppol BIS Billing 3.0. Ainda não trata notas de crédito, outros tipos de documento UBL nem arquivos Factur-X. A leitura é deliberadamente concentrada nos campos que formam uma fatura legível: as duas partes, as linhas da fatura, os subtotais de IVA, os totais e o IBAN. Se um documento usa alguma extensão exótica que o seu ERP acrescentou, essa extensão não vai aparecer no PDF — a fatura ainda será gerada, mas trate o PDF como uma representação legível, e não como uma reprodução byte a byte de tudo o que está no arquivo.

O PDF é uma cópia. O XML é a fatura.

Isto importa mais do que qualquer outra coisa nesta página. Onde o faturamento eletrônico estruturado é obrigatório, o arquivo XML é a fatura legal; um PDF gerado a partir dele é uma cópia legível por humanos e não o substitui. Guarde o XML original para o seu arquivo e para o seu contador, e trate o PDF pelo que ele é — algo para ler, conferir, imprimir ou encaminhar. A mesma lógica vale no sentido contrário: transformar uma fatura em PDF em XML depois não faz dela uma troca Peppol válida, porque a validade vem de como o documento foi enviado, não da sua extensão de arquivo. Se um cliente pede uma fatura eletrônica, mandar um PDF de uma não cumpre a exigência.

Quando um arquivo não converte

As causas mais comuns são simples. O arquivo é uma nota de crédito em vez de uma fatura; é um PDF Factur-X em vez de XML puro; é um tipo diferente de documento UBL; ou está genuinamente malformado porque alguma coisa deu errado lá atrás. Antes de concluir que a fatura está quebrada, vale passá-la por uma verificação estrutural para ver se ela é lida e se os campos obrigatórios estão presentes — isso é uma ferramenta validadora separada aqui, e ela usa exatamente o mesmo leitor desta página, então se o validador aprovar, esta página também vai. Só tenha claro o que essa verificação é e o que não é: ela confirma a estrutura e os campos exigidos, não a conformidade oficial completa com o Schematron do Peppol.

O que acontece com os dados da sua fatura

Esta é uma das poucas ferramentas deste site que precisa de um servidor, porque o PDF é gerado lá. O seu arquivo é lido na memória para montar o documento e descartado no instante em que a resposta é enviada — nada é gravado em disco, nada é registrado, nada é inspecionado. O servidor fica na UE. Considerando que uma fatura carrega nomes, endereços, valores e dados bancários, esse não é um detalhe que tratamos com leveza, e é a razão de tudo o que pode rodar no seu navegador neste site rodar mesmo no seu navegador.

Por que um PDF legível ainda é importante

Desde que a obrigatoriedade de faturamento eletrônico B2B da Bélgica entrou em vigor, as empresas trocam arquivos estruturados Peppol BIS Billing 3.0 (baseados em UBL 2.1) em vez de PDFs. Isso é ótimo para o software de contabilidade, mas as pessoas ainda querem uma cópia que possam ler, imprimir ou anexar a um e-mail — esta ferramenta gera essa cópia.