Pular para o conteúdo
notemnotemDocumentação

Primeiros passos

Glossário

Termo Significado
Organização Espaço que agrupa empresas, equipe e integrações. Ex.: um sistema parceiro (VistoCash) ou um grupo empresarial. Quem cria a organização é responsável por ela e pela cobrança.
Integração Conexão de um sistema com a notem, pertencente a uma organização. Tem chaves por ambiente (até duas ativas durante troca) e opera todas as empresas da organização.
Chave de acesso (da integração) Credencial secreta usada no cabeçalho Authorization. Define também o ambiente.
Ambiente homologacao (testes, sem validade fiscal) ou producao (validade fiscal).
Empresa (emitente / prestador) Empresa com CNPJ que emite a nota de serviço.
Tomador Quem contratou o serviço e recebe a nota (pessoa física, jurídica ou estrangeira).
Intermediário Terceiro que intermedia o serviço, quando houver.
Certificado A1 Certificado digital e-CNPJ (ICP-Brasil) da empresa, usado para assinar e transmitir as notas.
Situação da empresa Indica se a empresa está pronta para emitir (certificado, configuração fiscal, serviço, município).
Configuração fiscal Dados tributários da empresa: Simples Nacional, regime de apuração, regime especial, tributos aproximados.
Serviço Modelo de um serviço prestado pela empresa: código nacional, descrição, tributação do ISS, retenção.
Código de tributação nacional Código de 6 dígitos da lista nacional de serviços (cTribNac).
NBS Nomenclatura Brasileira de Serviços (9 dígitos). Usada no IBS/CBS.
ISS Imposto sobre serviços, municipal.
IBS / CBS Tributos da reforma tributária sobre bens e serviços. Obrigatórios na NFS-e conforme cronograma oficial (Simples Nacional a partir de 01/01/2027).
Simples Nacional Regime tributário simplificado. Situações: não optante, MEI, ME/EPP.
Município de incidência Município onde o ISS é devido.
Convênio Adesão do município ao sistema nacional da NFS-e. Sem convênio ativo no ambiente, não é possível emitir para aquele município.
DPS Declaração de Prestação de Serviço: o pedido de emissão enviado ao governo. Aprovada, gera a NFS-e.
Série / número da DPS Identificação sequencial da DPS. Séries atribuídas automaticamente a partir de 00900; faixa de aplicativo próprio: 00001 a 49999. Séries existentes são preservadas; números usados nunca são reaproveitados.
NFS-e Nota Fiscal de Serviço eletrônica autorizada pelo governo.
Chave de acesso da NFS-e Identificador oficial da nota, com 50 posições. Quando o emitente tem CNPJ alfanumérico, as 14 posições do CNPJ podem conter letras.
CNPJ alfanumérico Formato da Receita Federal para novas inscrições desde julho de 2026: 12 posições com números ou letras e 2 dígitos verificadores. A notem aceita os dois formatos.
DANFSe Representação em PDF da NFS-e.
Competência Data (mês) a que o serviço se refere. Não pode ser posterior à data de emissão.
Situação da nota Em processamento, em verificação, autorizada, rejeitada, cancelamento em análise, cancelada, substituída, cancelada pela prefeitura.
Em verificação O governo não confirmou o resultado da emissão; a notem confirma automaticamente, sem duplicar a nota.
Evento Fato registrado sobre uma nota (cancelamento, manifestação, ação da prefeitura).
Manifestação Confirmação ou rejeição da nota pelo tomador, prestador ou intermediário.
Substituição Emissão de uma nova nota que cancela e substitui uma anterior.
Webhook Aviso automático que a notem envia ao sistema parceiro quando algo acontece.
Idempotência Garantia de que reenviar o mesmo pedido (com a mesma Idempotency-Key) não duplica a operação.
id_externo Identificador do próprio sistema parceiro, guardado pela notem para localizar o recurso.
id_requisicao Identificador de cada chamada à API, usado no suporte.