NFS-e and tax reform: preparing invoice issuance
Check the municipality, issuer, layout version and tests needed to adapt NFS-e to tax reform under the technical notes applicable to your operation.
Updated:

Direct answer: the National NFS-e already has technical documentation for IBS and CBS, but municipalities, issuers and integrations do not necessarily use the same version on the same date. Identify who issues, in which environment, under which layout and with which validations active.
What is changing
The National NFS-e Portal’s technical notes add groups and rules for consumption-tax reform. Documentation evolves by version and can distinguish production, restricted production and features not yet available. A field in a manual is not proof that it is active in your issuer.
| Information | Where to confirm |
|---|---|
| Standard in use | Municipality, agreement and issuer supplier |
| Available environment | Production or restricted-production portal |
| Layout version | Technical note and XSD schema |
| Validation rule | Rules annex for the same version |
| Activation date | Official document/issuer timetable |
Four issuing situations
Municipality using the national standard: confirm registration, version, IBS/CBS fields and system integration. Test normal issuance, cancellation, replacement, adjustment and classification errors.
Municipality retaining an integrated local solution: it may exchange data with the national environment without identical screens or workflows. Use municipal documentation together with the applicable national standard.
Provider issuing across municipalities: testing headquarters alone is insufficient. Registrations, service codes, withholding, place of taxation and authorization may vary. Build a matrix by establishment and municipality served.
ERP prepares the declaration, another system authorizes it: validate the translation from order to ERP, API and authorized document. A correct screen amount does not guarantee correct XML. Validation ends with the authorized response and accounting reconciliation.
NFS-e, NBS and service codes are different
The Brazilian Services Nomenclature (NBS), LC 116 service-list item, municipal code and IBS/CBS group classification serve different purposes. Similar descriptions do not make them interchangeable. See NBS and tax reform.
Acceptance-testing checklist
- Identify municipality, issuer, API and version for each establishment.
- Back up existing services, customers, benefits and withholding records.
- Connect each new field to its data source and maintenance owner.
- Test individual, company, foreign and public-sector customers when relevant.
- Test discounts, reimbursements, cancellations, replacements and adjustment invoices.
- Compare DPS, authorized NFS-e, XML, API response and accounting entry.
- Retain environment, date, version and result evidence.
- Define how to prevent issuance with incomplete records.
Errors an authorized document may conceal
Wrong municipal service classification or place of taxation; incompatible IBS/CBS treatment; undocumented reduced base or benefit; insufficient customer/destination data; and authorized XML not reflected in finance or accounting.
Technical authorization only confirms that the file passed the available validations. It does not replace responsibility for the substantive classification.
Frequently asked questions
Did National NFS-e eliminate every municipal issuer?
Do not assume that. Check adoption and integration with the municipality and current standard.
Can I test directly in production?
Use restricted production when available and follow issuer guidance. Test data must not contaminate real books or obligations.
Is keeping the invoice PDF enough?
No. Preserve authorized XML, protocols, events and records supporting calculation and accounting.
See what changes in 2026 and IBS/CBS on service invoices.
Official sources
- Receita Federal — Orientações da Reforma Tributária para 2026
- Portal Nacional da NFS-e — documentação técnica da RTC
- Lei Complementar nº 214/2025 — texto compilado
Editorial update: 14 October 2026. Confirm obligations and layout versions in the official rules for the relevant period.
Sources and references
Accounting, tax and legal analysis for business decisions.
VMAHUB connects accounting, tax and legal work with business risk analysis and decisions. The next step is to understand how this topic applies to your operation and which documents support the assessment.