Benchmarks
Wie schnell ist es?
ZeRechnung wurde mit 14 anderen Go-Bibliotheken verglichen, dann mit 32 Bibliotheken in TypeScript, Python und Rust: dieselben Dateien aus dem offiziellen ZUGFeRD-Korpus, dieselbe Maschine, dieselbe Messumgebung. Jedes Ergebnis wird geprüft, bevor die Zeit gemessen wird.
Zeiten von ZeRechnung
XML extrahieren
30,2 µs
×2,5 schneller als die nächstschnellere Go-Bibliothek
XML in ein Modell einlesen
16,9 µs
×7,3 schneller als die nächstschnellere Go-Bibliothek
Lesen und validieren
24,3 µs
×5,1 schneller als die nächstschnellere Go-Bibliothek
XML schreiben
3,0 µs
×6,7 schneller als die nächstschnellere Go-Bibliothek
XML in ein PDF einbetten
89,2 µs
×5,9 schneller als die nächstschnellere Go-Bibliothek
Ein vollständiges Factur-X-PDF prüfen
74,2 µs
×15 schneller als die nächstschnellere Go-Bibliothek
Gemessen am 17. November 2026 auf einem Apple M4 Pro, auf einer einzigen Goroutine, mit ZeRechnung v0.1.0.
Im Vergleich mit den anderen Go-Bibliotheken
Die anderen Bibliotheken lesen XML mit encoding/xml, dessen Tokenizer allein bei einer Rechnung von 13 KB schon 100 µs braucht. ZeRechnung hat einen eigenen XML-Parser und bleibt deutlich unter dieser Untergrenze. Ein PDF-Parser mit Lazy Loading, der nur die benötigten Objekte liest, und ein inkrementelles Update zum Hinzufügen der Rechnung erledigen den Rest.
Die Balken sind logarithmisch skaliert: Jede Gitterlinie ist zehnmal langsamer als die vorherige. Die Zeiten sind Mediane aus drei Durchläufen.
XML extrahieren
EN-16931-PDF, 149 KB| Bibliothek | Zeit, logarithmische Skala | Zeit pro Operation |
|---|---|---|
| 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 | scheitert: sucht das XML per regulärem Ausdruck und übersieht dabei komprimierte Streams | |
| 10 µs100 µs1 ms | ||
XML in ein Modell einlesen
CII-XML, 13 KB| Bibliothek | Zeit, logarithmische Skala | Zeit pro Operation |
|---|---|---|
| ZeRechnung | 16,9 µs | |
| fXverliert die Steueraufschlüsselung | 124 µs ×7,3 | |
| angelo | 131 µs ×7,8 | |
| dotwave | 144 µs ×8,5 | |
| tahaspeichert Beträge als ganze Cent | 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 |
Gestrichelte Linie: 100 µs, die Zeit, die encoding/xml allein braucht, um die Datei in Tokens zu zerlegen.
Lesen und validieren
CII-XML, 13 KB| Bibliothek | Zeit, logarithmische Skala | Zeit pro Operation | Gültige Rechnungen, als ungültig gemeldet |
|---|---|---|---|
| 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 |
Letzte Spalte: wie viele der 26 gültigen Rechnungen des Korpus die Bibliothek als ungültig meldet. Die offiziellen Schematrons melden 6, die richtige Antwort ist also 6.
XML schreiben
CII-XML, 13 KB| Bibliothek | Zeit, logarithmische Skala | Zeit pro Operation |
|---|---|---|
| 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 |
XML in ein PDF einbetten
Ausgangs-PDF mit xref-Streams, 144 KB| Bibliothek | Zeit, logarithmische Skala | Zeit pro Operation |
|---|---|---|
| ZeRechnung | 89,2 µs | |
| pdf0 | 522 µs ×5,9 | |
| pdfcpufür den Benchmark geschriebener Low-Level-Code | 546 µs ×6,1 | |
| gopdfattach | 1,12 ms ×13 | |
| dotwave | 1,24 ms ×14 | |
| DCNWS | 1,66 ms ×19 | |
| lithokonvertiert das gesamte PDF und schreibt es neu | 36,16 ms ×405 | |
| kanjo | liefert ein PDF, das sich nicht wieder einlesen lässt | |
| andee | liefert ein PDF, das sich nicht wieder einlesen lässt | |
| 10 µs100 µs1 ms10 ms100 ms | ||
Ein vollständiges Factur-X-PDF prüfen
EN-16931-PDF, 149 KB| Bibliothek | Zeit, logarithmische Skala | Zeit pro Operation |
|---|---|---|
| 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 |
Im Vergleich mit anderen Sprachen
Für jede Operation die schnellste Bibliothek jeder Sprache unter denen, die sie erfolgreich ausführen. ZeRechnung ist in 13 von 16 Spalten am schnellsten. Rust kommt am nächsten heran, ohne alle Regeln der EN 16931 anzuwenden. Die Ausnahmen sind im Wiki erklärt.
XML extrahieren
EN-16931-PDF, 149 KB| Bibliothek | Zeit, logarithmische Skala | Zeit pro Operation |
|---|---|---|
| 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 |
XML in ein Modell einlesen
CII-XML, 13 KB| Bibliothek | Zeit, logarithmische Skala | Zeit pro Operation |
|---|---|---|
| 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 | |
| pychevalPythonliest 7 der 26 XML-Dateien | 221 µs ×14 | |
| 10 µs100 µs1 ms |
XML in ein Modell einlesen
CII-XML, 1,3 MB, mit einem Base64-Anhang| Bibliothek | Zeit, logarithmische Skala | Zeit pro Operation |
|---|---|---|
| mcp-einvoicing-dePythonlxml, in C geschrieben, behält den Anhang als Text | 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 |
Mit allen Regeln der EN 16931 validieren
CII-XML, 13 KB| Bibliothek | Zeit, logarithmische Skala | Zeit pro Operation |
|---|---|---|
| ZeRechnungGo | 23,1 µs | |
| pdf0Go | 126 µs ×5,5 | |
| einvoice-validatorRust | 473 µs ×20 | |
| @sweberdev/summandTypeScript | 802 µs ×35 | |
| saxonchePythonmit den offiziellen XSLT-Dateien | 903 µs ×39 | |
| 10 µs100 µs1 ms |
XML schreiben
CII-XML, 13 KB| Bibliothek | Zeit, logarithmische Skala | Zeit pro Operation |
|---|---|---|
| ZeRechnungGo | 3,1 µs | |
| zugferd-rsRust | 6,7 µs ×2,2 | |
| @ekwo-ai/factur-xTypeScriptModell von Hand aufgebaut | 10,9 µs ×3,5 | |
| fXGo | 20,2 µs ×6,5 | |
| pychevalPython | 76,6 µs ×25 | |
| 1 µs10 µs100 µs |
XML in ein PDF einbetten
Ausgangs-PDF mit xref-Streams, 144 KB| Bibliothek | Zeit, logarithmische Skala | Zeit pro Operation |
|---|---|---|
| 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 |
Ein vollständiges Factur-X-PDF prüfen
EN-16931-PDF, 149 KB| Bibliothek | Zeit, logarithmische Skala | Zeit pro Operation |
|---|---|---|
| ZeRechnungGo | 75,0 µs | |
| zugferd-pdfPythonprüft nur den Container | 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 |
Schnell und korrekt
Geschwindigkeit ist wertlos, wenn die Prüfergebnisse falsch sind. Von den 26 gültigen Rechnungen des offiziellen Korpus melden die offiziellen Schematrons 6: zweimal die Regel BR-CL-25 und CII-SR-465 bei den vier XRECHNUNG-Beispielen. ZeRechnung meldet genau diese 6 und extrahiert das XML aus allen 104 PDF-Dateien des Korpus. Seine CI vergleicht außerdem jeden Pull Request mit den Validatoren von KoSIT und Mustang.
Von den 32 Bibliotheken in anderen Sprachen liefern sechs dieselben Prüfergebnisse wie die Referenz. Die am häufigsten heruntergeladenen prüfen nur das XSD-Schema oder erzeugen nur Rechnungen.
Methode
Ein Modul pro Bibliothek, aufgerufen über ihre öffentliche API auf dem direktesten Weg, den ihre Dokumentation anbietet. Jede Messung beginnt mit einer Korrektheitsprüfung: Das extrahierte XML muss eine CII-Rechnung sein, und ein durch Einbetten erzeugtes PDF muss sich wieder einlesen lassen. Die Messprogramme liegen im Repository, jeder kann die Messungen also wiederholen.
| Rechner | 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 |
| Angezeigter Wert | Median aus 3 Durchläufen, auf einem Thread, mit den Bytes bereits im Speicher |