Brazil

Taggun’s core receipt and invoice extraction is available for documents from Brazil. Which optional fields and country-specific results are returned depends on the endpoint, request parameters, account settings, and submitted document. Country-specific results may be omitted or returned without a usable value. For currency, date format, language, and tax-system context, see Supported Countries & Languages.

Supported Document Types

Taggun has enhanced support for the document types commonly used in Brazil:

NF-e (NFE) — electronic fiscal invoice for goods or product transactions. NFS-e is the distinct services document and is not a documented tipNota value.
NFC-e (NFCE) — electronic consumer fiscal receipt, often including a QR code.
SAT (SAT) — fiscal coupon produced through São Paulo's SAT system.

QR Code Extraction for SEFAZ Workflows

Attempts to detect and decode visible, supported QR codes; success depends on visibility, image quality, and format.
Returns decoded SEFAZ (Secretaria da Fazenda) URLs or other QR content in entities.qrCodeData.data.
Your integration is responsible for following the URL and making any tax-authority, authenticity, or compliance decision.

For the general QR feature, see QR Code Extraction.

Document Classification

Automatic detection and classification of SAT, NFE, or NFCE.
Returns the detected fiscal document class for use in your workflow. Classification is not a tax-authority verification or compliance decision; your integration owns those checks.
The field can be empty when a class cannot be identified.

Tax ID Processing

CNPJ normalisation and validation (format: 12.345.678/0001-95) for issuing organisations.
CPF extraction (format: 123.456.789-09) for recipient tax IDs.

Additional Extractions

Chave de Acesso: the 44-digit unique access key for electronic invoice validation.
Line items and detailed transaction data.

Response Fields

The following properties can be enabled for the verbose endpoints:

These optional properties and envelopes may be omitted, null, empty, or present without a populated data value. Guard both the object and data before use.

Field Name	Type	Access Path	Description
Merchant CNPJ	string \| null	`merchantTaxId.data`	The detected CNPJ of the merchant issuing the receipt or invoice, when available.
Document Type	string \| null	`entities.brazilReceiptDetails.tipNota.data`	The detected fiscal document class: `SAT`, `NFE`, or `NFCE`, when available.
Issuer	string \| null	`entities.brazilReceiptDetails.issuedOrganization.data`	The issuer identifier on the fiscal document, when available.
Recipient	string \| null	`entities.brazilReceiptDetails.recipient.data`	The recipient identifier on the fiscal document, when available.
Chave de Acesso	string \| null	`entities.brazilReceiptDetails.chaveAcesso.data`	The 44-digit access key of the electronic invoice, when present.
QR Code	string \| null	`entities.qrCodeData.data`	Decoded content from a visible supported QR code, when available. This is a top-level field, not under `brazilReceiptDetails`. See QR Code Extraction.

Availability

📘
Availability
Enable Regional → Brazil Receipt Details for the dedicated fiscal envelope and Regional → Merchant Tax ID for merchantTaxId when those controls are available. QR Code Extraction is a separate Startup+ account capability, not a normal Feature Settings registry control. Contact [email protected] if a needed capability is unavailable. See Plans & Feature Access.

Need something not covered here? Contact [email protected] — see Contacting Support.