Glossary

The tax and technical terms used in this documentation.

Term	What it is
NFS-e	Nota Fiscal de Serviço eletrônica (electronic service invoice). It is the invoice this API issues.
NF-e	Nota Fiscal eletrônica, for goods. The API queries it; it does not issue it.
CT-e	Conhecimento de Transporte eletrônico (electronic transport document). The API queries it; it does not issue it.
Sistema Nacional NFS-e	The federal government system that authorizes NFS-e in the national standard. Sudrel transmits to it.
Produção restrita (restricted production)	The official test environment of the Sistema Nacional. It is where an invoice issued with a `sdr_test_` key goes.
Ambiente de Dados Nacional (ADN)	Where the NFS-e received and issued by the CNPJ come from.
DPS	Declaração de Prestação de Serviço (service provision statement): the document Sudrel sends to the Sistema Nacional. Once authorized, it becomes the NFS-e. It has a series and a number.
NSU	Número Sequencial Único (unique sequential number): the position of a document in the national environment distribution.
Chave de acesso (access key)	The official 50-digit identifier of an authorized NFS-e (44 in NF-e and CT-e).
Tomador (service recipient)	Who receives the service (and pays).
Prestador (service provider)	Who provides the service and issues the invoice. In issuance, it is your company.
Competência (accrual period)	The month the service refers to, for tax purposes (`AAAA-MM`).
Código de tributação nacional (national tax code)	The 6-digit code of the service in the national list (e.g. `010701`).
NBS	Nomenclatura Brasileira de Serviços (Brazilian service nomenclature). Required together with IBS and CBS.
ISS	Imposto Sobre Serviços, the municipal service tax.
IBS e CBS (IBS and CBS)	The consumption taxes of the tax reform. The DPS of the regular regime already declares them.
Retenção (withholding)	Tax that the recipient deducts from the payment and pays on behalf of the service provider.
Autorização (authorization)	The Sistema Nacional accepted the DPS and generated the NFS-e.
Rejeição (rejection)	The Sistema Nacional refused the DPS, with an `E` code (e.g. `E0039`).
Transmissão (transmission)	Sending the DPS to the Sistema Nacional, with recovery from technical failures.
Cancelamento (cancellation)	Event that voids an authorized NFS-e.
Substituição (replacement)	Issuing a new invoice that automatically cancels the previous one, once authorized.
Prontidão (readiness)	The check of what the company needs to issue. See Readiness.
Lote (batch)	Many invoices in one call, with a result per row.
Referência (reference)	The invoice identifier in your system (`referencia`). Unique per company and environment.
Idempotência (idempotency)	Repeating the same call without creating anything extra. See Idempotency.
Cursor	The marker that says where to continue a list. Opaque value.
Webhook	An HTTP call that Sudrel makes to your system when something happens.
Evento (event)	Something that happened in the account (invoice authorized, document received...). It stays in the event log for 90 days.
Ajuste (adjustment)	What Sudrel filled in, omitted or derived in the invoice because of the municipality or the tax scenario. Comes in `ajustes`.
MCP	Model Context Protocol: the standard that lets an AI assistant query systems. See AI and MCP.