Glossário

Os termos fiscais e técnicos usados nesta documentação.

Termo	O que é
NFS-e	Nota Fiscal de Serviço eletrônica. É a nota que esta API emite.
NF-e	Nota Fiscal eletrônica, de mercadoria. A API consulta; não emite.
CT-e	Conhecimento de Transporte eletrônico. A API consulta; não emite.
Sistema Nacional NFS-e	O sistema do governo federal que autoriza as NFS-e no padrão nacional. A Sudrel transmite para ele.
Produção restrita	O ambiente de testes oficial do Sistema Nacional. É para onde vai a nota emitida com a chave `sdr_test_`.
Ambiente de Dados Nacional (ADN)	De onde vêm as NFS-e recebidas e emitidas pelo CNPJ.
DPS	Declaração de Prestação de Serviço: o documento que a Sudrel envia ao Sistema Nacional. Autorizada, ela vira a NFS-e. Tem série e número.
NSU	Número Sequencial Único: a posição de um documento na distribuição do ambiente nacional.
Chave de acesso	O identificador oficial de 50 dígitos de uma NFS-e autorizada (44 na NF-e e no CT-e).
Tomador	Quem recebe o serviço (e paga).
Prestador	Quem presta o serviço e emite a nota. Na emissão, é a sua empresa.
Competência	O mês a que o serviço se refere, para fins de imposto (`AAAA-MM`).
Código de tributação nacional	O código de 6 dígitos do serviço na lista nacional (ex.: `010701`).
NBS	Nomenclatura Brasileira de Serviços. Exigida junto do IBS e da CBS.
ISS	Imposto Sobre Serviços, municipal.
IBS e CBS	Os tributos da reforma tributária sobre consumo. A DPS do regime regular já os declara.
Retenção	Imposto que o tomador desconta do pagamento e recolhe no lugar do prestador.
Autorização	O Sistema Nacional aceitou a DPS e gerou a NFS-e.
Rejeição	O Sistema Nacional recusou a DPS, com um código `E` (ex.: `E0039`).
Transmissão	O envio da DPS ao Sistema Nacional, com a recuperação de falhas técnicas.
Cancelamento	Evento que anula uma NFS-e autorizada.
Substituição	Emitir uma nota nova que cancela a anterior automaticamente, quando autorizada.
Prontidão	A checagem do que a empresa precisa ter para emitir. Ver Prontidão.
Lote	Muitas notas numa chamada, com resultado por linha.
Referência	O identificador da nota no seu sistema (`referencia`). Única por empresa e ambiente.
Idempotência	Repetir a mesma chamada sem criar nada a mais. Ver Idempotência.
Cursor	O marcador que diz de onde continuar uma lista. Valor opaco.
Webhook	Uma chamada HTTP que a Sudrel faz ao seu sistema quando algo acontece.
Evento	Algo que aconteceu na conta (nota autorizada, documento recebido...). Fica no log de eventos por 90 dias.
Ajuste	O que a Sudrel preencheu, omitiu ou derivou na nota por causa do município ou do cenário tributário. Vem em `ajustes`.
MCP	Model Context Protocol: o padrão que permite a um assistente de IA consultar sistemas. Ver IA e MCP.