ZeRechnung
Idioma: Português
Esta tradução ainda não foi revista por um falante nativo. Sugerir uma correção

Desempenho

Qual é a velocidade?

O ZeRechnung foi medido face a outras 14 bibliotecas Go e depois face a 32 bibliotecas TypeScript, Python e Rust: os mesmos ficheiros do corpus oficial do ZUGFeRD, a mesma máquina, o mesmo código de medição. Cada resultado é verificado antes de ser cronometrado.

Tempos do ZeRechnung

Extrair o XML

30,2 µs

×2,5 mais rápido do que a biblioteca Go seguinte

Ler o XML para um modelo

16,9 µs

×7,3 mais rápido do que a biblioteca Go seguinte

Ler e validar

24,3 µs

×5,1 mais rápido do que a biblioteca Go seguinte

Escrever o XML

3,0 µs

×6,7 mais rápido do que a biblioteca Go seguinte

Incorporar o XML num PDF

89,2 µs

×5,9 mais rápido do que a biblioteca Go seguinte

Verificar um PDF Factur-X completo

74,2 µs

×15 mais rápido do que a biblioteca Go seguinte

Medido a 17 de novembro de 2026 num Apple M4 Pro, numa só goroutine, com o ZeRechnung v0.1.0.

Face às outras bibliotecas Go

As outras bibliotecas leem o XML com encoding/xml, cujo tokenizador, por si só, demora 100 µs numa fatura de 13 KB. O ZeRechnung tem o seu próprio leitor XML e fica muito abaixo desse patamar. Um leitor PDF preguiçoso, que só lê os objetos de que precisa, e uma atualização incremental para acrescentar a fatura fazem o resto.

As barras estão numa escala logarítmica: cada linha da grelha é dez vezes mais lenta do que a anterior. Os tempos são medianas de três execuções.

Extrair o XML

PDF EN 16931, 149 KB
BibliotecaTempo, escala logarítmicaTempo por operação
ZeRechnung 30,2 µs
speedata 75,2 µs ×2,5
litho 106 µs ×3,5
papierleicht 113 µs ×3,7
DCNWS 209 µs ×6,9
pdfcpu 317 µs ×10
fX 332 µs ×11
dotwave 343 µs ×11
angelo 356 µs ×12
kanjo 386 µs ×13
gopdfattach 396 µs ×13
andee 516 µs ×17
taha falha: procura o XML com uma expressão regular, o que deixa escapar os fluxos comprimidos

Ler o XML para um modelo

XML CII, 13 KB
BibliotecaTempo, escala logarítmicaTempo por operação
ZeRechnung 16,9 µs
fXperde a discriminação do IVA 124 µs ×7,3
angelo 131 µs ×7,8
dotwave 144 µs ×8,5
tahaguarda os montantes em cêntimos inteiros 147 µs ×8,7
DCNWS 165 µs ×9,8
andee 182 µs ×11
speedata 225 µs ×13
kanjo 253 µs ×15
gobl.de 564 µs ×33

Linha tracejada: 100 µs, o tempo que encoding/xml demora só para dividir o ficheiro em tokens.

Ler e validar

XML CII, 13 KB
BibliotecaTempo, escala logarítmicaTempo por operaçãoFaturas válidas assinaladas como inválidas
ZeRechnung 24,3 µs 6/26
fX 123 µs ×5,1 26/26
pdf0 126 µs ×5,2 6/26
taha 147 µs ×6,0 15/26
angelo 172 µs ×7,1 4/26
andee 208 µs ×8,6 22/26
kanjo 293 µs ×12 9/26
DCNWS 754 µs ×31 2/26
speedata 1,28 ms ×53 0/26
gobl.de 1,77 ms ×73 20/26
papierleicht 14,65 ms ×603 6/26

Última coluna: quantas das 26 faturas válidas do corpus a biblioteca assinala como inválidas. Os schematrons oficiais assinalam 6, por isso 6 é a resposta certa.

Escrever o XML

XML CII, 13 KB
BibliotecaTempo, escala logarítmicaTempo por operação
ZeRechnung 3,0 µs
fX 20,2 µs ×6,7
dotwave 22,1 µs ×7,4
speedata 30,5 µs ×10
DCNWS 36,2 µs ×12
kanjo 98,3 µs ×33
andee 311 µs ×104
taha 652 µs ×217

Incorporar o XML num PDF

PDF de base com fluxos xref, 144 KB
BibliotecaTempo, escala logarítmicaTempo por operação
ZeRechnung 89,2 µs
pdf0 522 µs ×5,9
pdfcpureceita de baixo nível escrita para a medição 546 µs ×6,1
gopdfattach 1,12 ms ×13
dotwave 1,24 ms ×14
DCNWS 1,66 ms ×19
lithoconverte e reescreve todo o PDF 36,16 ms ×405
kanjo devolve um PDF que não é possível voltar a ler
andee devolve um PDF que não é possível voltar a ler

Verificar um PDF Factur-X completo

PDF EN 16931, 149 KB
BibliotecaTempo, escala logarítmicaTempo por operação
ZeRechnung 74,2 µs
DCNWS 1,14 ms ×15
pdf0 2,20 ms ×30
papierleicht 15,78 ms ×213
litho 19,87 ms ×268

Face a outras linguagens

Para cada operação, a biblioteca mais rápida de cada linguagem entre as que são bem-sucedidas. O ZeRechnung é o mais rápido em 13 das 16 colunas. O Rust é o que mais se aproxima, sem aplicar todas as regras EN 16931. As exceções são explicadas na wiki.

Extrair o XML

PDF EN 16931, 149 KB
BibliotecaTempo, escala logarítmicaTempo por operação
ZeRechnungGo 29,3 µs
einvoice-validatorRust 32,5 µs ×1,1
speedataGo 75,2 µs ×2,6
zugferd-pdfPython 78,5 µs ×2,7
@attestwire/en16931TypeScript 184 µs ×6,3

Ler o XML para um modelo

XML CII, 13 KB
BibliotecaTempo, escala logarítmicaTempo por operação
ZeRechnungGo 16,3 µs
zugferd-rsRust 24,0 µs ×1,5
@ekwo-ai/factur-xTypeScript 69,6 µs ×4,3
fXGo 124 µs ×7,6
pychevalPythonlê 7 dos 26 ficheiros XML 221 µs ×14

Ler o XML para um modelo

XML CII, 1,3 MB, com um anexo em base64
BibliotecaTempo, escala logarítmicaTempo por operação
mcp-einvoicing-dePythonlxml, escrita em C, mantém o anexo como texto 702 µs
ZeRechnungGo 1,11 ms ×1,6
pdf-invoiceRust 1,63 ms ×2,3
@conformo/toolkitTypeScript 1,74 ms ×2,5
dotwaveGo 6,76 ms ×9,6

Validar com todas as regras EN 16931

XML CII, 13 KB
BibliotecaTempo, escala logarítmicaTempo por operação
ZeRechnungGo 23,1 µs
pdf0Go 126 µs ×5,5
einvoice-validatorRust 473 µs ×20
@sweberdev/summandTypeScript 802 µs ×35
saxonchePythoncom o XSLT oficial 903 µs ×39

Escrever o XML

XML CII, 13 KB
BibliotecaTempo, escala logarítmicaTempo por operação
ZeRechnungGo 3,1 µs
zugferd-rsRust 6,7 µs ×2,2
@ekwo-ai/factur-xTypeScriptmodelo construído à mão 10,9 µs ×3,5
fXGo 20,2 µs ×6,5
pychevalPython 76,6 µs ×25

Incorporar o XML num PDF

PDF de base com fluxos xref, 144 KB
BibliotecaTempo, escala logarítmicaTempo por operação
ZeRechnungGo 87,8 µs
pdf-invoiceRust 178 µs ×2,0
pdf0Go 522 µs ×5,9
mcp-einvoicing-dePython 662 µs ×7,5
@stackforge-eu/factur-xTypeScript 1,14 ms ×13

Verificar um PDF Factur-X completo

PDF EN 16931, 149 KB
BibliotecaTempo, escala logarítmicaTempo por operação
ZeRechnungGo 75,0 µs
zugferd-pdfPythonsó verifica o contentor 212 µs ×2,8
@attestwire/en16931TypeScript 359 µs ×4,8
en16931Rust 479 µs ×6,4
DCNWSGo 1,14 ms ×15

Rápido e correto

A velocidade de nada serve se os veredictos estiverem errados. Nas 26 faturas válidas do corpus oficial, os schematrons oficiais assinalam 6: a regra BR-CL-25 duas vezes e a CII-SR-465 nos quatro exemplos XRECHNUNG. O ZeRechnung assinala exatamente essas 6 e extrai o XML dos 104 ficheiros PDF do corpus. A sua CI compara ainda cada pull request com os validadores KoSIT e Mustang.

Das 32 bibliotecas noutras linguagens, seis dão os mesmos veredictos que a referência. As mais descarregadas só verificam o esquema XSD ou apenas geram faturas.

Método

Um módulo por biblioteca, chamada através da sua API pública, da forma mais direta que a sua documentação propõe. Cada medição começa com uma verificação de exatidão: o XML extraído tem de ser uma fatura CII, e um PDF produzido por uma incorporação tem de poder ser lido de novo. O código de medição está no repositório, por isso qualquer pessoa o pode voltar a executar.

MáquinaApple M4 Pro · 24 GB · macOS 26.6
Go1.26.4 · go test -bench . -benchmem -count 3 -benchtime 1s
TypeScriptNode 22.15.0
PythonCPython 3.13.18
Rustrustc 1.93.1, release
Valor apresentadomediana de 3 execuções, numa só thread, com os bytes já em memória