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. O atributo XML Id do evento é o prefixo literal ID seguido dessa composição. NF-e e CT-e diferem no tamanho da sequência e no que a API entrega:

  • NF-e: no Id do XML, nSeqEvento tem 2 dígitos. No webhook e na API (eventId), o identificador é montado pela NFE.io como tpEvento + chave + sequência, sem o prefixo ID e sem zero à esquerda na sequência: 51 dígitos para as sequências de 1 a 9 e 52 a partir da 10.
  • CT-e (leiaute 4.00): nSeqEvento com 3 dígitos; o XSD eventoCTeTiposBasico_v4.00 define ID[0-9]{53}. O identificador mantém o prefixo ID no webhook (accessKey do evento) e na rota de XML do evento (eventId): 55 caracteres no total. Exemplo: ID11011135240198765432000100570010000009871234567890001 (cancelamento 110111, sequência 001).

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.