Brazil’s Technical Note 2014.002 v1.40 updates the NFeDistribuicaoDFe web service to support alphanumeric CNPJs. ERP and e-invoicing systems must handle CNPJ fields as character values, process compressed XML returns, follow NSU sequencing, and respect query limits to avoid rejection 656 – Improper Consumption.
Brazil Technical Note 2014.002 v1.40: NF-e Distribution Web Service Switched to Alphanumeric CNPJ Support
Public
Brazil
Author: Ljubica Blagojević
Category:
Technical description
Views:
495
Content accuracy validation date:
08.07.2026
Content accuracy validation time:
08:05h
The main change in version 1.40 is the adjustment of CNPJ fields from numeric (“N”) to character (“C”) format to support Brazil’s new alphanumeric CNPJ structure. The implementation dates shown in the document are July 8, 2026, for both testing and production environments.
The NFeDistribuicaoDFe service allows authorized users with a valid digital certificate to retrieve NF-e documents and related events of interest. The service supports three main query types: distNSU, for distributing documents from the last NSU; consNSU, for consulting a specific NSU; and consChNFe, for consulting an NF-e by access key.
Returned documents are provided in XML format, compressed with Gzip in the docZip field, with up to 50 documents per batch. Documents are generally available for retrieval for up to 90 days after being received by the National NF-e Environment.
The technical note also reinforces rules against misuse of the service. If no more documents are available, users must wait one hour before sending another request. Repeated or out-of-sequence queries may trigger rejection code 656 – Improper Consumption, temporarily blocking the CNPJ from further queries.
Overall, the update is mainly technical but important for ERP, e-invoicing, middleware, and tax compliance systems in Brazil. Companies must ensure that their NF-e distribution integrations can process alphanumeric CNPJ values, follow NSU sequencing rules, handle compressed XML returns, and respect query limits.
Other news from Brazil
Brazil Publishes Test CNPJs for Fiscal Document Homologation
Brazil
Author: Ivana Picajkić
Brazil's Federal Tax Authority released an Excel spreadsheet with simulated CNPJs and State Registration numbers for use in the homologation environment. Read more
Subscribe to get access to the latest news, documents, webinars and educations.
Already subscriber? Login
Brazil Technical Note 2026.004 v1.01: NF-e and NFC-e Schemas Updated for Alphanumeric CNPJ Format
Public
Brazil
Author: Ljubica Blagojević
Brazil
Author: Ljubica Blagojević
Brazil’s Technical Note 2026.004 v1.01 updates NF-e and NFC-e systems to support the new alphanumeric CNPJ format, which applies only to new registrations while existing CNPJs remain unchanged. The new CNPJ keeps 14 characters, with the first 12 positions alphanumeric and the last 2 numeric check digits. The change affects XML schemas, CNPJ fields, access keys, validations, barcode standards, DF-e... Read more
Brazil Technical Note 2026.002: NFGas Layouts Updated for New IBS, CBS, and ICMS Fields
Public
Brazil
Author: Ljubica Blagojević
Brazil
Author: Ljubica Blagojević
Brazil’s Technical Note 2026.002 updates NFGas for the Consumption Tax Reform, adding rules for IBS/CBS, cashback, SUFRAMA incentives, advance payments, and ICMS fields. For Normal Regime issuers, the IBS/CBS group becomes mandatory on August 3, 2026. Other validations enter production on August 31, 2026. NFGas issuers and software providers must update XML layouts, tax fields, validations, and re... Read more
Brazil Introduces Simplified DANFE Type 2: Key Visual and Operational Updates for 2026
Public
Brazil
Author: Ljubica Blagojević
Brazil
Author: Ljubica Blagojević
Brazil’s Technical Note 2026.003 v1.00 introduces the Simplified DANFE Type 2, allowing NF-e model 55 to be used in some end-consumer transactions usually covered by NFC-e model 65. The change is visual and operational only; it does not alter the NF-e XML, schemas, or validation rules. It defines the printed layout, QR code formats, consumer identification rules, contingency messages, and formatti... Read more
Brazil Technical Note 2025.002: NF-e and NFC-e Layouts Overhauled for New IBS, CBS, and IS Fields
Public
Brazil
Author: Ljubica Blagojević
Brazil
Author: Ljubica Blagojević
Brazil’s Technical Note 2025.002 IBS/CBS/IS updates NF-e and NFC-e for Tax Reform, adding new fields and rules for IBS, CBS, and IS. It introduces Group UB, item-level tax classification, Credit/Debit Notes, and rules for SUFRAMA, cashback, advance payments, references, and fuel taxation. For Normal Regime taxpayers, IBS/CBS fields become mandatory on August 3, 2026. ERP, POS, and invoicing system... Read more
Brazil Technical Note 2026.002 v1.00: Key NF-e and NFC-e Updates for Retail and E-Commerce
Public
Brazil
Author: Ljubica Blagojević
Brazil
Author: Ljubica Blagojević
Brazil’s Technical Note 2026.002 v1.00 updates NF-e and NFC-e rules for retail, e-commerce, and delivery. It introduces cStat 120 authorization with warning and the new Simplified DANFE Type 2, allowing NF-e use in some NFC-e-like transactions. It also adds stricter rules for CFOPs, buyer identification, QR codes, contingency, transport data, and invoice limits. Retailers, POS/ERP providers, and e... Read more
Brazil Tax Reform: 2028 Set as Crucial Stabilization Phase Ahead of Gradual IBS Rollout
Public
Brazil
Author: Ljubica Blagojević
Brazil
Author: Ljubica Blagojević
Brazil’s 2028 tax reform phase will focus on stabilizing CBS and Selective Tax (IS) after their 2027 launch and preparing for IBS from 2029. Businesses and software providers should use this period to adjust pricing, cash flow, tax credits, reporting, ERP systems, and compliance tools before the more complex transition begins. Brazil’s transition to the new tax model will remain a major oper... Read more