Pular para o conteúdo principal
Ver como MarkdownDocs para agentes

NSU, chaves de acesso e modelos de documento

Três identificadores aparecem em todos os produtos de recepção: o NSU, a chave de acesso e o modelo do documento.

NSU — Número Sequencial Único​

O NSU é um número sequencial atribuído por CNPJ pelo ambiente nacional (AN da SEFAZ ou ADN da SEFIN) a cada documento ou evento publicado. A recepção automática avança o NSU a cada polling, garantindo que nada seja perdido nem reprocessado.

  • A deduplicação é feita pelo par (companyId, nsu) — único por empresa.
  • Ao ativar a captura, você pode definir o NSU/data de início; a SEFAZ disponibiliza um histórico de ~90 dias.
Tipo do NSU

No OData de NF-e/CT-e o nsu é tratado como número (long); nos endpoints REST individuais ele aparece como string. Trate-o como string ao persistir para evitar perda de precisão.

Chave de acesso​

A chave identifica unicamente um documento autorizado:

DocumentoTamanhoObservação
NF-e / NFC-e44 dígitosModelos 55 / 65
CT-e44 dígitosModelo 57
NFS-e (padrão nacional)50 dígitosModelo 56
DPS (Declaração de Prestação de Serviço)42 dígitos (Id = DPS + 42)Pré-autorização da NFS-e

Chaves de evento​

Eventos (cancelamento, CC-e, manifestação etc.) têm identificador próprio, composto por tpEvento (6 díg.) + chave do documento (44 díg.) + nSeqEvento (2 díg.). O formato é idêntico para NF-e e CT-e:

  • Atributo XML Id: prefixo literal ID seguido da composição tpEvento + chave + nSeqEvento (o XSD eventoCTeTiposBasico define ID[0-9]{52} para CT-e).
  • Entregue no webhook / API (eventId): a composição sem o prefixo ID. A documentação oficial de webhook publica 51 dígitos para o evento de NF-e — confirme o tamanho exato com o documento/engenharia.

Modelos fiscais​

ModeloDocumento
55NF-e — Nota Fiscal Eletrônica
56NFS-e — Nota Fiscal de Serviço Eletrônica (padrão nacional)
57CT-e — Conhecimento de Transporte Eletrônico
65NFC-e — Nota Fiscal de Consumidor Eletrônica

Veja também​

NFE.io

A NFE.io é uma empresa de tecnologia que fornece soluções para automatizar e simplificar a emissão e gestão de notas fiscais eletrônicas. Com suas ferramentas, as empresas podem economizar tempo e reduzir erros, aumentando a eficiência e precisão do processo de emissão de notas fiscais.

Um dos principais cases de sucesso da NFE.io é a implementação da solução na empresa de transporte Rodonaves. Com a automatização da emissão e gestão de notas fiscais eletrônicas, a Rodonaves conseguiu reduzir em até 80% o tempo gasto nesse processo, o que se traduziu em uma significativa melhoria na eficiência operacional. Além disso, a empresa também conseguiu eliminar erros e atrasos na emissão de notas fiscais, o que melhorou a relação com seus clientes e aumentou a confiança dos órgãos fiscais.

Outro exemplo é a implementação da NFE.io na empresa de comércio eletrônico, a Loja Integrada. Com a automatização da emissão de notas fiscais, a Loja Integrada conseguiu aumentar a velocidade de emissão de notas em até 10 vezes, o que permitiu que a empresa atendesse a uma maior quantidade de clientes e, consequentemente, aumentar as suas vendas.

Além desses exemplos, a NFE.io também tem outros cases de sucesso com empresas de setores como indústria, construção, varejo e serviços, mostrando a versatilidade e eficácia da sua solução.

Em resumo, a NFE.io é uma empresa de tecnologia que oferece soluções para automatizar e simplificar a emissão e gestão de notas fiscais eletrônicas, ajudando as empresas a economizar tempo e reduzir erros, melhorando a eficiência e precisão do processo. Com cases de sucesso em diferentes setores, a NFE.io tem se destacado como uma empresa líder em automação fiscal.