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| Biblioteca | Tempo, escala logarítmica | Tempo 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 | |
| 10 µs100 µs1 ms | ||
Ler o XML para um modelo
XML CII, 13 KB| Biblioteca | Tempo, escala logarítmica | Tempo 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 | |
| 10 µs100 µs1 ms |
Linha tracejada: 100 µs, o tempo que encoding/xml demora só para dividir o ficheiro em tokens.
Ler e validar
XML CII, 13 KB| Biblioteca | Tempo, escala logarítmica | Tempo por operação | Faturas 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 | |
| 10 µs100 µs1 ms10 ms100 ms |
Ú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| Biblioteca | Tempo, escala logarítmica | Tempo 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 | |
| 1 µs10 µs100 µs1 ms |
Incorporar o XML num PDF
PDF de base com fluxos xref, 144 KB| Biblioteca | Tempo, escala logarítmica | Tempo 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 | |
| 10 µs100 µs1 ms10 ms100 ms | ||
Verificar um PDF Factur-X completo
PDF EN 16931, 149 KB| Biblioteca | Tempo, escala logarítmica | Tempo 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 | |
| 10 µs100 µs1 ms10 ms100 ms |
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| Biblioteca | Tempo, escala logarítmica | Tempo 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 | |
| 10 µs100 µs1 ms |
Ler o XML para um modelo
XML CII, 13 KB| Biblioteca | Tempo, escala logarítmica | Tempo 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 | |
| 10 µs100 µs1 ms |
Ler o XML para um modelo
XML CII, 1,3 MB, com um anexo em base64| Biblioteca | Tempo, escala logarítmica | Tempo 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 | |
| 100 µs1 ms10 ms |
Validar com todas as regras EN 16931
XML CII, 13 KB| Biblioteca | Tempo, escala logarítmica | Tempo 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 | |
| 10 µs100 µs1 ms |
Escrever o XML
XML CII, 13 KB| Biblioteca | Tempo, escala logarítmica | Tempo 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 | |
| 1 µs10 µs100 µs |
Incorporar o XML num PDF
PDF de base com fluxos xref, 144 KB| Biblioteca | Tempo, escala logarítmica | Tempo 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 | |
| 10 µs100 µs1 ms10 ms |
Verificar um PDF Factur-X completo
PDF EN 16931, 149 KB| Biblioteca | Tempo, escala logarítmica | Tempo 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 | |
| 10 µs100 µs1 ms10 ms |
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áquina | Apple M4 Pro · 24 GB · macOS 26.6 |
|---|---|
| Go | 1.26.4 · go test -bench . -benchmem -count 3 -benchtime 1s |
| TypeScript | Node 22.15.0 |
| Python | CPython 3.13.18 |
| Rust | rustc 1.93.1, release |
| Valor apresentado | mediana de 3 execuções, numa só thread, com os bytes já em memória |