ZATCA Base64 & TLV Decoder

Deconstructing ZATCA TLV Binary Payloads into Readable Tax Data

Under the hood, every Saudi ZATCA QR code contains a Base64-encoded string representing a binary Tag-Length-Value (TLV) structure. Software developers integrating POS or ERP systems with the Fatoora portal frequently need to inspect these raw strings.

This utility decodes the Base64 string into raw bytes, traverses the TLV tag boundaries, and maps every tag to its official ZATCA specification label, verifying length fields and UTF-8 string encoding.

How to Use

1. Paste the Base64 string extracted from your invoice QR code into the input panel.
2. The tool parses the TLV byte stream and validates the Tag and Length headers.
3. View parsed fields: Seller Name, VAT Number, Timestamp, Total, VAT, and Phase 2 signatures.
4. Copy individual fields or export the full parsed payload as formatted JSON.

Key Features & Capabilities

• Traverses binary TLV bytes according to official ZATCA e-invoicing technical specifications.
• Validates 15-digit VAT number structure and ISO 8601 timestamp formats.
• Parses Phase 2 cryptographic fields: ECDSA signature, SHA-256 hash, and public key.
• 100% private in-browser decoding with instant performance.

Common Developer Workflows

• Unit testing ERP invoice generation engines before submitting to the ZATCA API.
• Debugging barcode generation errors and invalid TLV length bytes.
• Extracting VAT invoice metadata from database audit logs.
• Verifying Phase 2 cryptographic stamp integrity.

Frequently Asked Questions