Decodificador TLV & QR Code Fiscal ZATCA (Fatoora)
Decodifique, inspecione e valide estruturas TLV (Tag-Length-Value) e QR Codes fiscais da ZATCA Fatoora (Fases 1 e 2) diretamente no navegador.
O que é TLV e Como Funciona o QR Code Fiscal ZATCA?
O padrão TLV (Tag-Length-Value) é um esquema de codificação binária compacto em que cada campo é representado sequencialmente por seu identificador numérico (Tag), comprimento em bytes (Length) e o conteúdo bruto (Value).
A autoridade tributária da Arábia Saudita (ZATCA / GAZT) adotou esse padrão para o projeto Fatoora. Na Fase 1, o QR Code armazena as tags 1 a 5 (razão social, CNPJ/VAT, timestamp, total e imposto). Na Fase 2 (Integração), são adicionadas as tags 6 a 9 contendo o hash SHA-256 da fatura XML e as assinaturas digitais ECDSA.
Anatomia das 9 Tags Fiscais da ZATCA (Fatoora)
Especificação normativa das tags oficiais do QR Code fiscal saudita:
| Tag | Campo Oficial | Formato | Definição Técnica | Exemplo Canônico |
|---|---|---|---|---|
| 1 | Seller's Name | UTF-8 | Nome ou razão social da empresa emissora da fatura fiscal. | Modern Bakery Ltd |
| 2 | VAT Number | 15 dígitos | Identificador fiscal que deve obrigatoriamente iniciar e terminar com 3. | 310123456700003 |
| 3 | Timestamp | ISO 8601 | Data e hora exata no padrão YYYY-MM-DDTHH:mm:ssZ. | 2026-09-11T08:00:00Z |
| 4 | Invoice Total | Decimal | Valor total a pagar pela fatura, incluindo impostos e descontos. | 115.00 |
| 5 | VAT Total | Decimal | Valor total do imposto sobre valor agregado retido na operação. | 15.00 |
| 6 | Invoice Hash | SHA-256 (32B) | Digest criptográfico gerado a partir da fatura eletrônica UBL XML. | 4a1b2c3d... |
| 7 | ECDSA Signature | DER (64-72B) | Assinatura digital gerada pelo dispositivo sobre o hash da fatura. | 3045022100... |
| 8 | Public Key | X.509 PubKey | Chave pública do certificado digital do dispositivo de emissão. | 3059301306... |
| 9 | Stamp Signature | Binary | Carimbo criptográfico de validação emitido pela autoridade ZATCA. | Carimbo Digital |
Processo de Decodificação e Validação Determinística
O fluxo de inspeção opera linearmente sobre os bytes sem qualquer tráfego de rede:
- 1. Extração Binária e Desempacotamento de Tags: O payload Base64 ou Hex é convertido para buffer binário e iterado byte a byte. O motor lê a Tag (1 byte) e o Comprimento (1 byte), extraindo o valor com proteção estrita contra buffer overflow.
- 2. Verificação de Regras Tributárias e Criptográficas: Os campos decodificados são validados segundo as diretrizes da ZATCA: conformidade do VAT de 15 dígitos (início e fim 3), consistência matemática entre Total e IVA, e formato de data ISO 8601.