TLV-Dekodierer & ZATCA (Fatoora) Steuer-QR-Code-Prüfer
Dekodieren, untersuchen und validieren Sie TLV-Strukturen (Tag-Length-Value) und ZATCA Fatoora-QR-Codes (Phasen 1 und 2) direkt im Browser.
100% Client-Side WebCrypto
Beispiele:
Base64- oder Hexadezimal-TLV-Nutzdaten einfügen
Fügen Sie den Base64-String des QR-Codes oder die hexadezimale TLV-Sequenz ein.
Aufgeschlüsselte TLV-Tags (0)
Fügen Sie eine Base64- oder Hexadezimal-Zeichenfolge ein, um TLV-Datensätze zu untersuchen.
Was ist TLV und wie funktioniert der ZATCA-Steuer-QR-Code?
Der TLV-Standard (Tag-Length-Value) ist ein kompaktes binäres Kodierungsschema, bei dem jedes Feld sequenziell durch eine Kennung (Tag), eine Byte-Länge (Length) und die Rohdaten (Value) abgebildet wird.
Die saudi-arabische Steuerbehörde (ZATCA / GAZT) nutzt diesen Standard für die Fatoora-E-Rechnungspflicht. In Phase 1 enthält der QR-Code die Tags 1 bis 5. In Phase 2 kommen die Tags 6 bis 9 mit SHA-256-Rechnungshashes und ECDSA-Signaturen hinzu.
Anatomie der 9 ZATCA (Fatoora) Steuertags
Regulatorische Spezifikation der offiziellen saudi-arabischen E-Rechnungs-QR-Code-Tags:
| Tag | Offizielles Feld | Format | Technische Definition | Kanonisches Beispiel |
|---|---|---|---|---|
| 1 | Seller's Name | UTF-8 | Vollständiger Firmenname des Rechnungsstellers. | Modern Bakery Ltd |
| 2 | VAT Number | 15 Ziffern | Steuernummer, die mit 3 beginnen und mit 3 enden muss. | 310123456700003 |
| 3 | Timestamp | ISO 8601 | Rechnungsdatum im Format YYYY-MM-DDTHH:mm:ssZ. | 2026-09-11T08:00:00Z |
| 4 | Invoice Total | Dezimal | Gesamtbetrag der Rechnung inklusive aller Steuern. | 115.00 |
| 5 | VAT Total | Dezimal | Gesamter Mehrwertsteuerbetrag der Transaktion. | 15.00 |
| 6 | Invoice Hash | SHA-256 (32B) | Kryptografischer SHA-256-Hash des Rechnungs-XML-Körpers. | 4a1b2c3d... |
| 7 | ECDSA Signature | DER (64-72B) | Digitale Signatur des Geräts über den Rechnungshash. | 3045022100... |
| 8 | Public Key | X.509 PubKey | Öffentlicher Schlüssel des Gerätezertifikats. | 3059301306... |
| 9 | Stamp Signature | Binär | Kryptografischer Validierungsstempel der ZATCA. | Digitaler Stempel |
Deterministischer Dekodierungs- und Verifizierungsprozess
Die Parsing-Engine analysiert lineare Binärpuffer ohne Netzwerkabfragen:
- 1. Binäre Extraktion und Tag-Parsing: Die Base64- oder Hex-Daten werden in ein Byte-Array gewandelt. Die Engine liest Tag (1 Byte) und Länge (1 Byte) mit sicherem Schutz vor Pufferüberläufen aus.
- 2. Steuerliche und Mathematische Validierung: Die dekodierten Werte werden gegen ZATCA-Kriterien geprüft: 15-stellige Steuernummer (Beginn/Ende 3), Konsistenz zwischen Gesamtbetrag und MwSt. sowie ISO 8601 Datum.