Como transmitir a NFS-e ao ADN
O Ambiente de Distribuição Nacional tem duas metades: quem manda o lote de documentos e quem recebe o que ele distribui. Esta página traz as 35 regras de negócio das duas, com o código de erro de cada uma, como o Anexo IV oficial as define.
São dois certificados, e o erro diz qual falhou
O certificado de transmissão abre o canal e responde por 3 regras (E1200, E1206, E1262). O certificado que assina o lote é outro, e tem regras próprias (E1245, E1246). Um lote pode abrir o canal com certificado válido e ser recusado porque o que assinou o envelope não traz CNPJ — e quem lê só "erro de certificado" vai conferir o lado errado.
Recepção do lote: 19 regras em 4 etapas
A ordem das etapas é a da fonte, e ela importa: o lote que não passa da primeira nunca chega à validação do XML. Todas as regras têm efeito de rejeição — a recepção não tem estado intermediário.
Validação do Certificado de Transmissão
| Código | O que é verificado | Mensagem oficial |
|---|---|---|
| E1200 | Certificado de Transmissor Inválido: - Certificado de Transmissor inexistente na mensagem - Versão difere "3" - Se informado o Basic Constraint deve ser true (não pode ser Certificado de AC) - KeyUsage não define "Autenticação Cliente" | Certificado de Transmissão Inválido |
| E1203 | Validade do Certificado (data início e data fim) | Certificado de Transmissão expirado |
| E1205 | Verifica a Cadeia de Certificação: - Certificado da AC emissora não cadastrado na RFB - Certificado de AC revogado - Certificado não assinado pela AC emissora do Certificado | Certificado de Transmissão - Erro Cadeira de Certificação |
| E1206 | LCR do Certificado de Transmissor - Falta o endereço da LCR (CRL DistributionPoint) - LCR indisponível - LCR inválida | Certificado de Transmissão - Erro de acesso a LCR |
| E1207 | Certificado do Transmissor revogado | Certificado de Transmissão revogado |
| E1208 | Certificado Raiz difere da "ICP-Brasil" | Certificado de Transmissão difere da ICP - Brasil |
| E1209 | Falta a extensão de CNPJ no Certificado (OtherName - OID=2.16.76.1.3.3) | Certificado de Transmissão sem CNPJ |
| E1262 | CNPJ do certificado de transmissão do lote de DF-e não está autorizado a realizar a transmissão de DF-e pelo municipio conveniado. | CNPJ não autorizado a compartilhar DF-e pelo município conveniado ao Sistema Nacional NFS-e. |
| E1245 | Certificado da assinatura do lote sem CNPJ. | Certificado da assinatura do lote sem CNPJ. |
| E1246 | Certificado da assinatura do lote - Erro na cadeia de certificação. | Certificado da assinatura do lote - Erro na cadeia de certificação. |
Validação Inicial da Mensagem na API
| Código | O que é verificado | Mensagem oficial |
|---|---|---|
| E1217 | Verifica se o servidor de processamento está paralisado para manutenção | Serviço paralisado para manutenção |
| E1219 | Número de documentos do lote maior do que o <<limite>. | Número de documentos maior do que o limite definido para a aplicação.⚠ valor não publicado |
Validação da Área de Dados
| Código | O que é verificado | Mensagem oficial |
|---|---|---|
| E1225 | Falha na descompactado da base 64. | Falha na decodificação da base 64 da área de dados |
| E1226 | Estrutura descompactada mal formada. | Estrutura descompactada mal formada. |
Validação dos Tipos de Documentos
| Código | O que é verificado | Mensagem oficial |
|---|---|---|
| E1242 | Validar os tipos de DF-e tratados pelo Sistema Nacional NFS-e. | Tipo DF-e não tratado pelo Sistema Nacional NFS-e. |
| E1228 | Uso de prefixo de namespace não permitido na área de dados descompactada. | Uso de prefixo de namespace não permitido na área de dados descompactada. |
| E1229 | XML não está utilizando codificação UTF8. | XML não está utilizando codificação UTF8. |
| E1235 | Falha no esquema XML do DF-e. | Falha no esquema XML do DF-e. |
| E1250 | Assinatura difere do calculado | Assinatura difere do calculado |
Distribuição por NSU: 16 regras em 6 seções
Do outro lado do ADN estão o município e o contribuinte, que puxam o que lhes cabe pelo NSU — o número sequencial único de cada documento distribuído. Há três formas de pedir, e cada uma tem o erro dela: a partir de um NSU, por NSU específico e por chave de acesso.
Validação da Distribuição para NSU Geral
| Código | O que é verificado | Mensagem oficial |
|---|---|---|
| E2301 | CNPJ do transmissor deve estar cadastrado para um Órgão no convênio do sistema nacional. | CNPJ não cadastrado. |
Distriuição a partir de um NSU
| Código | O que é verificado | Mensagem oficial |
|---|---|---|
| E2305 | Verificar se existem DF-e a partir do NSU informado pelo o Órgão solicitante. | Nenhum documento localizado – não existem documentos fiscais a partir do NSU informado. |
| E2020 | Verificar se existem DF-e a partir do NSU informado pelo o município solicitante. | Nenhum documento localizado – não existem documentos fiscais para o Município a partir do NSU informado. |
| E2215 | Verificar se existem DF-e a partir do NSU informado pelo o contribuinte solicitante. | Nenhum documento localizado – não existem documentos fiscais para o Contribuinte a partir do NSU informado. |
Consulta por NSU
| Código | O que é verificado | Mensagem oficial |
|---|---|---|
| E2306 | Verificar se existe DF-e para o NSU informado pelo Órgão solicitante. | Nenhum documento localizado – não existe documento fiscal para o NSU informado. |
| E2040 | Verificar se existe DF-e para o NSU informado pelo municipio solicitante. | Nenhum documento localizado – não existe documento fiscal para o Município com o NSU informado. |
| E2230 | Verificar se existe DF-e para o NSU informado pelo contribuinte solicitante. | Nenhum documento localizado – não existe documento fiscal para o Contribuinte com o NSU informado. |
Validação da Distribuição para NSU do Municipio
| Código | O que é verificado | Mensagem oficial |
|---|---|---|
| E2000 | Validações do Certificado da Transmissão. | Erro no Certificado de transmissão. |
| E2001 | CNPJ do transmissor deve estar cadastrado para um Município no convênio municipal do sistema nacional. | CNPJ não cadastrado para nenhum Município conveniado. |
| E2003 | O código do Município informado deve existir e estar com a situação CADASTRADO no cadastro de convênio municipal. | O código do município informado existe, mas está suspenso no convênio municipal. |
| E2004 | O código do Município informado deve existir e estar inativo a menos de <<prazo para a inativação>> dias no cadastro de convênio municipal. | O código do município informado existe, mas não está ativo há mais de <<prazo para a inativação>> dias no cadastro de convênio municipal.⚠ valor não publicado |
Consulta por Chave de Acesso
| Código | O que é verificado | Mensagem oficial |
|---|---|---|
| E2060 | Chave de acesso não localizada. | Nenhum documento localizado – não existe documentos fiscal para a chave de acesso informada. |
| E2061 | Chave de acesso não referencia o Município solicitante. | Chave de acesso da NFS-e não referencia o Município solicitante e por isso não pode ser compartilhado. |
| E2240 | Chave de acesso não localizada. | Nenhum documento localizado – não existe documentos fiscal para a chave de acesso informada. |
| E2241 | Chave de acesso não referencia o Contribuinte solicitante. | Chave de acesso da NFS-e não referencia o Contribuinte solicitante e por isso não pode ser compartilhado. |
Recuperação de Backup - Município Emissor
| Código | O que é verificado | Mensagem oficial |
|---|---|---|
| E2070 | NSU (NSU de recepção) não localizado para o Município solicitante. | Nenhum documento localizado – não existem documentos fiscais recebidos para o Município a partir do NSU de recepção informado. |
2 números que a fonte oficial não publicou
O Anexo IV declara a regra, o efeito e o código de erro — e deixa o valor como marcador não preenchido no próprio documento. É o caso de E1219 e E2004. O limite existe e é cobrado na recepção; o número ainda não é público. Esta página publica a dimensão em vez de completar o que a fonte não diz.
- →
E1219Número de documentos do lote maior do que o <<limite>. - →
E2004O código do Município informado deve existir e estar inativo a menos de <<prazo para a inativação>> dias no cadastro de convênio municipal.
Os 25 documentos que o ADN distribui
Cada linha é um DF-e do Sistema Nacional, com quantos destinos recebem NSU dele e quantos não recebem. ⚠ O cruzamento completo ator × condição não sai desta página: a matriz da fonte tem seis níveis de cabeçalho, e publicá-la pela metade diria o que ela não diz.
| Documento | Recebem NSU | Não recebem |
|---|---|---|
| NFS-e | 9 | 5 |
| Cancelamento de NFS-e | 9 | 5 |
| Cancelamento de NFS-e por Substituição | 9 | 5 |
| Solicitação de Análise Fiscal para Cancelamento de NFS-e | 9 | 5 |
| Cancelamento de NFS-e Deferido por Análise Fiscal | 9 | 5 |
| Cancelamento de NFS-e Indeferido por Análise Fiscal | 9 | 5 |
| Manifestação de NFS-e · Confirmação do Prestador | 9 | 5 |
| Manifestação de NFS-e · Confirmação do Tomador | 9 | 5 |
| Manifestação de NFS-e · Confirmação do Intermediário | 9 | 5 |
| Manifestação de NFS-e · Confirmação Tácita | 9 | 5 |
| Manifestação de NFS-e · Rejeição do Prestador | 9 | 5 |
| Manifestação de NFS-e · Rejeição do Tomador | 9 | 5 |
| Manifestação de NFS-e · Rejeição do Intermediário | 9 | 5 |
| Manifestação de NFS-e · Anulação da Rejeição | 9 | 5 |
| Cancelamento de NFS-e por Ofício | 9 | 5 |
| Bloqueio de NFS-e por Ofício · Cancelamento de NFS-e | 8 | 6 |
| Bloqueio de NFS-e por Ofício · Cancelamento de NFS-e por Substituição | 8 | 6 |
| Bloqueio de NFS-e por Ofício · Cancelamento de NFS-e Deferido por Análise Fiscal | 8 | 6 |
| Bloqueio de NFS-e por Ofício · Cancelamento de NFS-e Indeferido por Análise Fiscal | 8 | 6 |
| Bloqueio de NFS-e por Ofício · Cancelamento de NFS-e por Ofício | 8 | 6 |
| Desbloqueio de NFS-e por Ofício · Cancelamento de NFS-e | 8 | 6 |
| Desbloqueio de NFS-e por Ofício · Cancelamento de NFS-e por Substituição | 8 | 6 |
| Desbloqueio de NFS-e por Ofício · Cancelamento de NFS-e Deferido por Análise Fiscal | 8 | 6 |
| Desbloqueio de NFS-e por Ofício · Cancelamento de NFS-e Indeferido por Análise Fiscal | 8 | 6 |
| Desbloqueio de NFS-e por Ofício · Cancelamento de NFS-e por Ofício | 8 | 6 |
Perguntas frequentes
Como se transmite um lote de NFS-e ao Ambiente de Distribuição Nacional?
O lote é um XML compactado e codificado na área de dados da mensagem, transmitido com certificado digital ICP-Brasil. O ADN valida em quatro etapas, nesta ordem: Validação do Certificado de Transmissão; Validação Inicial da Mensagem na API; Validação da Área de Dados; Validação dos Tipos de Documentos. São 19 regras de negócio, e a primeira que falhar rejeita o lote inteiro com o código dela.
Qual a diferença entre o certificado de transmissão e o certificado da assinatura do lote?
São dois, e confundi-los é o erro que manda procurar defeito no lugar errado. O de TRANSMISSÃO abre o canal e é validado em 3 regras (E1200, E1206, E1262): validade, cadeia, LCR, revogação, raiz ICP-Brasil e a extensão de CNPJ. O da ASSINATURA DO LOTE assina o envelope e tem regras próprias (E1245, E1246). Um lote pode ter o canal aberto com certificado válido e ainda assim ser rejeitado porque o certificado que assinou não tem CNPJ.
Que erros o ADN devolve na recepção do lote?
19 códigos, agrupados pelas 4 etapas de validação: E1200 (Certificado de Transmissão Inválido); E1203 (Certificado de Transmissão expirado); E1205 (Certificado de Transmissão - Erro Cadeira de Certificação); E1206 (Certificado de Transmissão - Erro de acesso a LCR); E1207 (Certificado de Transmissão revogado); E1208 (Certificado de Transmissão difere da ICP - Brasil); E1209 (Certificado de Transmissão sem CNPJ); E1262 (CNPJ não autorizado a compartilhar DF-e pelo município conveniado ao Sistema Nacional NFS-e.) — e outros. Todos são de rejeição: o ADN não tem estado intermediário na recepção do lote.
O que é NSU na NFS-e?
É o número sequencial único que identifica cada documento distribuído pelo ADN, e é por ele que município e contribuinte puxam o que lhes cabe. Há três formas de pedir, cada uma com erro próprio: a partir de um NSU (traz o que veio depois dele), por NSU específico e por chave de acesso. A distribuição tem 16 regras de negócio em 6 seções, e o ADN distribui 25 tipos de documento.
Por que o ADN recusa o CNPJ de um município que existe?
Porque existir não é estar apto. O ADN separa três estados que nenhum outro DF-e separa: município não conveniado (o CNPJ não está cadastrado para nenhum município), município conveniado mas SUSPENSO e município conveniado mas inativo há mais tempo que o prazo. Os três devolvem códigos diferentes, e a diferença entre eles é administrativa, não técnica — a integração está certa e mesmo assim não recebe.
Qual é o limite de documentos por lote?
⚠ A fonte oficial NÃO publica o número. O Anexo IV declara a regra e o código de erro (E1219, E2004), e no lugar do valor traz um marcador não preenchido. O limite existe e é cobrado na recepção; o número ainda não é público, e o Buscador NCM publica a dimensão em vez de completar o que a fonte não diz.
Fonte: Anexo IV — ADN (Sefin Nacional/CGNFS-e), v1.00 de 16/12/2025. ⚠ Este documento trata do Sistema Nacional da NFS-e (ISS); a NFS-e Via, de exploração de vias, tem manual próprio e fica em /nfsvia.