Projeto Nota Fiscal Eletrônica
Manual de Orientação ao Contribuinte
Atualizado até a NT 2014.001 v.1.41 publicada em 04/08/2026
Projeto Nota Fiscal Eletrônica
Manual de Orientação ao Contribuinte
Atualizado até a NT 2014.001 v.1.41 publicada em 04/08/2026
O Web Service de Registro de Evento possui uma interface genérica, complementada por uma área específica para cada tipo de evento. Segue abaixo o leiaute da parte geral da mensagem de entrada para os eventos.
| # | Campo | Ele | Pai | Tipo | Ocor. | Tam. | Descrição/Observação |
|---|---|---|---|---|---|---|---|
| P01 | envEvento | Raiz | - | - | - | - | TAG raiz |
| P02 | versao | A | P01 | N | 1-1 | 2v2 | Versão do leiaute |
| P03 | idLote | E | P01 | N | 1-1 | 1-15 | Identificador de controle do Lote de envio do Evento. Número sequencial único para identificação do Lote, de uso exclusivo do autor do evento. O Web Service não faz qualquer uso deste identificador. |
| P04 | evento | G | P01 | xml | 1-20 | - | Evento, um lote pode conter até 20 eventos |
| P05 | versao | A | P04 | N | 1-1 | 2v2 | Versão do leiaute do evento |
| P06 | infEvento | G | P04 | - | 1-1 | - | Grupo de informações do registro do Evento |
| P07 | Id | ID | P06 | C | 1-1 | 54 | Identificador da TAG a ser assinada, formado por “ID” + tpEvento + Chave da NF-e + nSeqEvento |
| P08 | cOrgao | E | P06 | N | 1-1 | 2 | Código do órgão de recepção do Evento, conforme Tabela do IBGE ou: 91=Ambiente Nacional
Informar o código da UF para este evento. |
| P09 | tpAmb | E | P06 | N | 1-1 | 1 | Identificação do Ambiente: 1- Produção; 2- Homologação; |
| P10 | CNPJ | CE | P06 | C | 1-1 | 14 | CNPJ do autor do evento |
| P11 | CPF | CE | P06 | N | 1-1 | 11 | CPF do autor do evento |
| P12 | chNFe | E | P06 | C | 1-1 | 44 | Chave de Acesso da NF-e à qual o evento será vinculado |
| P13 | dhEvento | E | P06 | D | 1-1 | - | Data e hora do evento no formato AAAA-MM-DD-Thh:mm:ssTZD (UTC – Universal Coordinated Time) |
| P14 | tpEvento | E | P06 | N | 1-1 | 6 | Código do evento (de acordo com tabelas do item 3.1) |
| P15 | nSeqEvento | E | P06 | N | 1-1 | 1-2 | Sequencial do evento para o mesmo tipo de evento. Informar o valor “1” para este evento. |
| P16 | verEvento | E | P06 | N | 1-1 | 2v2 | Versão do grupo de detalhe do evento. |
| P17 | detEvento | G | P06 | 1-1 | Detalhes do evento. Inserir neste local o XML específico do tipo de evento (ex: cancelamento, carta correção, registro de passagem). | ||
| P80 | infPAA | G | P06 | 0-1 | Uso exclusivo para Evento gerado por Provedor de Assinatura e Autorização - PAA conforme legislação vigente. | ||
| P81 | CNPJPAA | E | P80 | C | 1-1 | 14 | CNPJ do Provedor de Assinatura e Autorização |
| P82 | PAASignature | G | P80 | 1-1 | Estrutura simplificada do padrão XMLDSig para a PAA. Assinatura RSA do Emitente para DF-e gerados por PAA. |
||
| P83 | SignatureValue | E | P82 | C | 1-1 | Gerar o hash do valor do atributo Id com algoritmo SHA1 e assinar com a chave privada RSA, gerando um valor no formato base64 | |
| P84 | RSAKeyValue | G | P82 | 1-1 | Chave Pública no padrão XML RSA Key | ||
| P85 | Modulus | E | P84 | C | 1-1 | ||
| P86 | Exponent | E | P84 | C | 1-1 | Informar “AQAB” | |
| P91 | Signature | G | P04 | xml | 1-1 | Assinatura Digital do documento XML, a assinatura deverá ser aplicada no elemento infEvento |
| # | Campo | Ele | Pai | Tipo | Ocor. | Tam. | Descrição/Observação |
|---|---|---|---|---|---|---|---|
| R01 | retEnvEvento | Raiz | - | - | - | - | TAG raiz da mensagem de retorno |
| R02 | versao | A | R01 | N | 1-1 | 2v2 | Versão do leiaute |
| R03 | idLote | E | R01 | N | 1-1 | 1-15 | Idem a mensagem de entrada. |
| R04 | tpAmb | E | R01 | N | 1-1 | 1 | Idem a mensagem de entrada. |
| R05 | verAplic | E | R01 | C | 1-1 | 1-20 | Versão da aplicação que processou o evento. |
| R06 | cOrgao | E | R01 | N | 1-1 | 2 | Órgão de recepção do Evento, idem a mensagem de entrada. |
| R07 | cStat | E | R01 | N | 1-1 | 3-4 | Código do status da resposta (conforme item 4.1 do Anexo Regras de Validação). |
| R08 | xMotivo | E | R01 | C | 1-1 | 1-255 | Descrição do status da resposta. |
| R09 | retEvento | G | R01 | - | 0-20 | - | Grupo do resultado do processamento do Evento |
| R10 | versao | A | R09 | N | 1-1 | 2v2 | Versão do leiaute |
| R11 | infEvento | G | R09 | 1-1 | - | Grupo de informações do registro do Evento | |
| R12 | Id | ID | R11 | C | 0-1 | 17-19 | Identificador da TAG a ser assinada, somente deve ser informado se o órgão de registro assinar a resposta. No caso de assinatura, preencher com o número do protocolo, precedido pela literal “ID” |
| R13 | tpAmb | E | R11 | N | 1-1 | 1 | Idem a mensagem de entrada. |
| R14 | verAplic | E | R11 | C | 1-1 | 1-20 | Versão da aplicação que registrou o Evento, utilizar literal que permita a identificação do órgão, como a sigla da UF ou do órgão. |
| R15 | cOrgao | E | R11 | N | 1-1 | 2 | Idem a mensagem de entrada. |
| R16 | cStat | E | R11 | N | 1-1 | 3-4 | Código do status da resposta (conforme item 4.1 do Anexo Regras de Validação). |
| R17 | xMotivo | E | R11 | C | 1-1 | 1-255 | Descrição do status da resposta. |
| R18 | chNFe | E | R11 | C | 0-1 | 44 | Idem a mensagem de entrada |
| R19 | tpEvento | E | R11 | N | 0-1 | 6 | Código do evento (de acordo com tabelas do item 3.1) |
| R20 | xEvento | E | R11 | C | 0-1 | 5-60 | Descrição do resultado do processamento do evento |
| R21 | nSeqEvento | E | R11 | N | 0-1 | 1-2 | Idem a mensagem de entrada. |
| R22 | cOrgaoAutor | E | R11 | N | 0-1 | 2 | Idem a mensagem de entrada, para os casos de eventos em que é informado na mensagem de entrada.
Específico para eventos: - 110112 – Cancelamento por substituição (NT 2018.005) - 110140 – EPEC Obs: Esta tag não é preenchida no evento de manifestação |
| R23 | CNPJDest | CE | R11 | C | 0-1 | 14 | Informar o CNPJ do destinatário da NF-e. Específico para evento 110111 – Cancelamento |
| R23 | CPFDest | CE | R11 | N | 0-1 | 11 | Informar o CPF do destinatário da NF-e. Específico para evento 110111 – Cancelamento |
| R24 | emailDest | E | R11 | C | 0-1 | 1-60 | E-mail do destinatário informado na NF-e. Específico para evento 110111 – Cancelamento Obs: Esta tag não é preenchida no evento de manifestação |
| R27 | chNFePend | E | R11 | C | 0-50 | 44 | Relação de Chaves de Acesso de EPEC pendentes de conciliação, existentes no AN. Específico para evento: 110140 – EPEC Obs: Esta tag não é preenchida no evento de manifestação |
| R50 | dhRegEvento | E | R11 | D | 1-1 | - | Data e hora do registro do evento no formato AAAAMMDDThh:mm:ssTZD (UTC – Universal Coordinated Time).Se o evento for rejeitado informar a data e hora de recebimento do evento. |
| R51 | nProt | E | R11 | N | 0-1 | 15-17 | Número do Protocolo do Evento, conforme item 4.3.5 |
| P91 | Signature | G | R09 | XML | 1-1 | 1 | Assinatura Digital do documento XML, a assinatura deverá ser aplicada no elemento infEvento. |
O WS de Eventos é acionado pelo interessado emissor da NF-e que deve enviar mensagem de registro de evento.
O processo de Registro de Eventos recebe eventos em uma estrutura de lotes, que podem conter de 1 a 20 eventos.
Serão aplicadas as regras de validação genéricas conforme os grupos citados na tabela abaixo, detalhados na Seção 1 do Anexo de Regras de Validação da NF-e e da NFC-e.
| Grupo | Descrição |
|---|---|
| A | Validação do Certificado de Transmissão (protocolo TLS) |
| B | Validação Inicial da Mensagem no Web Service |
| D | Validação da Área de Dados |
| E | Validação do Certificado Digital de Assinatura |
| F | Validação da Assinatura Digital |
A validação do Schema XML é realizada em toda mensagem de entrada, mas como existe uma parte da mensagem que é variável pode ocorrer erro de falha de Schema XML da parte específica da mensagem que será identificado posteriormente.
As regras de validação da parte geral deste WS podem ser vistas na tabela abaixo; as regras de validação específicas para cada evento estão tratadas nas seções relativas a cada um deles
| Campo | Modelo | Regra de Validação | Aplic. | Msg | Efeito | Descrição Erro | |||
|---|---|---|---|---|---|---|---|---|---|
| P07-10 | 55/65 | Atributo “Id” não corresponde à concatenação dos campos do evento (“ID” + tpEvento + chNFe + nSeqEvento) (*1) | Obrig. | 572 | Rej. | Rejeição: Erro Atributo ID do evento não corresponde a concatenação dos campos (“ID” + tpEvento + chNFe + nSeqEvento) | |||
| P08-10 | 55/65 | Código do órgão de recepção do Evento diverge do definido para este evento (*1) | Obrig. | 250 | Rej. | Rejeição: UF diverge da UF autorizadora | |||
| P09-10 | 55/65 | Tipo do ambiente difere do ambiente do Web Service (*1) | Obrig. | 252 | Rej. | Rejeição: Ambiente informado diverge do Ambiente de recebimento | |||
| P10-10 | 55/65 | Se informado CNPJ do Autor do Evento: • CNPJ inválido (zeros, nulo ou DV inválido) (*1) |
Obrig. | 489 | Rej. | Rejeição: CNPJ informado inválido (DV ou zeros) | |||
| P11-10 | 55/65 | Se informado o CPF do Autor do evento: • CPF inválido (zeros, nulo ou DV inválido) (*1) |
Obrig. | 490 | Rej. | Rejeição: CPF informado inválido (DV ou zeros) | |||
| P11-20 | 55/65 | Se informado o CPF do Autor do evento e Modelo da Chave de Acesso = 65: • Evento não disponível para Autor tipo pessoa física (*1) |
Obrig. | 408 | Rej. | Rejeição: Evento não disponível para Autor pessoa física | |||
| P12-10 | 55/65 | Validação da Chave de Acesso (tag:chNFe): • Dígito verificador inválido (*1) |
Obrig. | 236 | Rej. | Rejeição: Chave de Acesso com dígito verificador inválido | |||
| P12-14 | 55/65 | • Código UF inválido (*1) | Obrig. | 614 | Rej. | Rejeição: Chave de Acesso inválida (Código UF inválido) | |||
| P12-18 | 55/65 | • Ano < 06 ou Ano maior que Ano corrente (*1) | Obrig. | 615 | Rej. | Rejeição: Chave de Acesso inválida (Ano < 06 ou Ano maior que Ano corrente) | |||
| P12-22 | 55/65 | • Mês = 0 ou Mês > 12 (*1) | Obrig. | 616 | Rej. | Rejeição: Chave de Acesso inválida (Mês < 1 ou Mês> 12) | |||
| P12-26 | 55/65 | Validação da Chave de Acesso (tag:chNFe): - CNPJ/CPF zerado ou dígito inválido (*1) Nota 01: Considerar a Série para determinar se CNPJ/CPF na Chave de Acesso. - CNPJ: Série=[0-909, 980-989], CPF: Série<>[0-909, 980-989] Nota 02: Caso tpEmis = 3-NFF, considerar o 5º dígito do número da nota (nNF) para determinar se CNPJ/CPF na Chave de Acesso: - CNPJ: 5º dígito do nNF = “1” - CPF: 5º dígito do nNF = “2” (NT 2021.002). Observação: Implementação em todos os ambientes autorizadores de NF-e / NFC-e. |
Obrig. | 617 | Rej. | Rejeição: Chave de Acesso inválida (CNPJ/CPF zerado ou dígito inválido) | |||
| P12-30 | 55/65 | • Modelo diferente de 55 ou 65 (*1) | Obrig. | 619 | Rej. | Rejeição: Chave de Acesso inválida (modelo diferente de 55/65) | |||
| P12-30A | 55/65 | - Eventos somente da NF-e: - Modelo diferente de 55 | Obrig. | 450 | Rej. | Rejeição: Modelo da NF-e diferente de 55 | |||
| P12-32 | 65 | Validação da Chave de Acesso (tag:chNFe): - Se modelo = 65 e série do PAA (nSerie=[970-989]): - Modelo não permitido para o PAA Observação: Implementação em todos os ambientes autorizadores de NF-e / NFC-e. |
Obrig. | 450 | Rej. | Rejeição: Modelo da NF-e diferente de 55 | |||
| P12-34 | 55/65 | • Número NF = 0 (*1) | Obrig. | 619 | Rej. | Rejeição: Chave de Acesso inválida (número NF = 0) | |||
| P12-40 | 55/65 | • UF da Chave de Acesso diverge da UF Autorizadora Exceção: Na SVRS, a regra acima não se aplica, para contribuintes exclusivos do IBS/CBS (não informada a tag “emit/IE” da NF-e da chave de acesso) Observação: Regra de validação para todas as SEFAZ Autorizadoras. |
Obrig. | 249 | Rej. | Rejeição: UF da Chave de Acesso diverge da UF autorizadora | |||
| P12-44 | 55/65 | Validação da Chave de Acesso (tag:chNFe): - CNPJ/CPF do Autor diverge do CNPJ/CPF da Chave de Acesso Nota 01: Considerar a Série para determinar se CNPJ/CPF na Chave de Acesso. - CNPJ: Série=[0-909, 980-989], CPF: Série<>[0-909, 980-989] Nota 02: Caso tpEmis = 3-NFF, considerar o 5º dígito do número da nota (nNF) para determinar se CNPJ/CPF na Chave de Acesso: - CNPJ: 5º dígito do nNF = “1” - CPF: 5º dígito do nNF = “2” (NT 2021.002). Observação: Implementação em todos os ambientes autorizadores de NF-e / NFC-e. |
Obrig. | 574 | Rej. | Rejeição: Autor do evento diverge do emissor da NF-e | |||
| P13-10 | 55/65 | Data do evento maior que a data de processamento (aceitar tolerância de até 5 minutos) (*1) | Obrig. | 578 | Rej. | Rejeição: A data do evento não pode ser maior que a data do processamento | |||
| ***Grupo de Informações conforme o Evento: Evento de Cancelamento por Substituição | |||||||||
| P31-26 | 55/65 | Se tpEvento=110112, validar a Chave de Acesso Substituta (tag:chNFeRef): - CNPJ/CPF zerado ou dígito inválido Nota 01: Considerar a Série para determinar se CNPJ/CPF na Chave de Acesso. - CNPJ: Série=[0-909, 980-989], CPF: Série<>[0-909, 980-989] Nota 02: Caso tpEmis = 3-NFF, considerar o 5º dígito do número da nota (nNF) para determinar se CNPJ/CPF na Chave de Acesso: - CNPJ: 5º dígito do nNF = “1” - CPF: 5º dígito do nNF = “2” (NT 2021.002). |
Obrig. | 910 | Rej. | Rejeição: Chave de Acesso NF-e Substituta inválida (CNPJ/CPF) | |||
| P31-46 | 55/65 | Se tpEvento=110112, validar a Chave de Acesso Substituta (tag:chNFeRef): - CNPJ/CPF zerado ou dígito inválido Nota 01: Considerar a Série para determinar se CNPJ/CPF na Chave de Acesso. - CNPJ: Série=[0-909, 980-989], CPF: Série<>[0-909, 980-989] Nota 02: Caso tpEmis = 3-NFF, considerar o 5º dígito do número da nota (nNF) para determinar se CNPJ/CPF na Chave de Acesso: - CNPJ: 5º dígito do nNF = “1” - CPF: 5º dígito do nNF = “2” (NT 2021.002). |
Obrig. | 911 | Rej. | Rejeição: Chave de Acesso NF-e Substituta incorreta (CNPJ/CPF) | |||
| ***Grupo de Informação do PAA | |||||||||
| P80-10 | 55 | Se Série diferente da série do PAA (nSerie<>[970-989]): - Grupo infPAA informado indevidamente Observação: Implementação em todos os ambientes autorizadores de NF-e / NFC-e. |
Obrig. | 893 | Rej. | Rejeição: Grupo de informações do Provedor de Assinatura e Autorização informado indevidamente | |||
| P80-20 | 55 | Se Série do PAA (nSerie=[970-989]): - Se não for Evento do Emitente (tpEvento difere de 110111-Cancelamento, 110112-Cancelamento por Substituição, 110110-Carta de Correção): - Grupo infPAA informado indevidamente Observação: Implementação em todos os ambientes autorizadores de NF-e / NFC-e. |
Obrig. | 893 | Rej. | Rejeição: Grupo de informações do Provedor de Assinatura e Autorização informado indevidamente | |||
| P80-30 | 55 | Se Série do PAA (nSerie=[970-989]): - Se Evento do Emitente (tpEvento igual a 110111-Cancelamento, 110112-Cancelamento por Substituição, 110110-Carta de Correção): - Grupo infPAA não informado Observação: Regra de Validação implementada somente na SVRS. |
Obrig. | 867 | Rej. | Rejeição: Grupo de informações do Provedor de Assinatura e Autorização não informado | |||
| P80-40 | 55 | Se informado grupo infPAA: - Evento não é do Emitente (tpEvento difere de 110111-Cancelamento, 110112-Cancelamento Observação: Regra de Validação implementada somente na SVRS. |
Obrig. | 491 | Rej. | Rejeição: Tipo de Evento inválido para o ambiente de autorização | |||
| P81-10 | 55 | Se informado grupo infPAA: - CNPJ do PAA inválido deve ser válido (zeros, DV) Observação: Regra de Validação implementada somente na SVRS. |
Obrig. | 670 | Rej. | Rejeição: CNPJ do PAA inválido | |||
| P81-20 | 55 | Se informado grupo infPAA: - Acessar Cadastro de PAA (Chave: CNPJPAA) - CNPJ do PAA (tag: CNPJPAA) não existe ou situação inválida Observação: Regra de Validação implementada somente na SVRS. |
Obrig. | 671 | Rej. | Rejeição: CNPJ do PAA inválido | |||
| P81-30 | 55 | Se informado grupo infPAA: - Acessar Cadastro de Vínculos do PAA com o Emitente (Chave: CNPJPAA, CNPJ do Emitente) - Emitente (tag: emit/CNPJ) não possui vínculo ativo com o PAA Observação: Regra de Validação implementada somente na SVRS. |
Obrig. | 672 | Rej. | Rejeição: Emitente não associado ao PAA | |||
| P81-40 | 55 | Se informado grupo infPAA: - Acessar Cadastro de Chaves do PAA com o Emitente (Chave: CNPJPAA, CNPJ do Emitente) - Chave pública difere da estipulada para este emitente no PAA Observação: Regra de Validação implementada somente na SVRS. |
Obrig. | 895 | Rej. | Rejeição: Chave do Emitente para o PAA inválida | |||
| P81-50 | 55 | Se informado grupo infPAA: - CNPJ-8 do certificado de assinatura difere do CNPJ-8 do PAA (tag: CNPJPAA) Observação: Regra de Validação implementada somente na SVRS |
Obrig. | 776 | Rej. | Rejeição: Emissão por PAA deve ser assinada pelo CNPJ do Provedor de Assinatura | |||
| P83-10 | 55 | Se informado grupo infPAA: - Validar assinatura RSA (tag:SignatureValue) com a chave pública do emitente (grupo: RSAKeyValue) Observação: Regra de Validação implementada somente na SVRS |
Obrig. | 856 | Rej. | Rejeição: Emissão por PAA com Assinatura RSA inválida | |||
| ***Banco de Dados:Emitente | |||||||||
| 1P10-10 | 55/65 | Acesso ao Cadastro de Contribuintes (Chave: CNPJ do Autor):
• Verificar se Emitente não autorizado a emitir NF-e Exceção: Não se aplica para NFF (tpEmis = 3-NFF) (NT 2021.002)
|
Obrig. | 203 | Rej. | Rejeição: Emissor não habilitado para emissão de NF-e | |||
| 1P10-20 | 55/65 | • Verificar situação fiscal do emitente
Exceção: Não se aplica para NFF (tpEmis = 3-NFF) (NT 2021.002)
|
Obrig. | 240 | Rej. | Rejeição: Irregularidade fiscal do emitente | |||
| ***Banco de Dados: NF-e | |||||||||
| 2P81-10 | 55 | Se Evento para NF-e emitida por PAA (Série=[970-989]): - Se Evento do Emitente (tpEvento igual a 110111-Cancelamento, 110112-Cancelamento por Substituição, 110110-Carta de Correção): - CNPJ-8 do Certificado de Assinatura do Evento difere do CNPJ-8 do PAA que emitiu a NF-e e difere do CNPJ-8 do Emitente da NF-e Observação: Regra de Validação implementada somente na SVRS. |
Obrig. | 889 | Rej. | Rejeição: Emissão por PAA deve ser assinada pelo CNPJ do Provedor de Assinatura | |||
| ***Banco de Dados:Evento | |||||||||
| 3P15-10 | Acesso BD de Eventos (Chave: Chave de Acesso, tpEvento, nSeqEvento):
• Duplicidade do evento (tpEvento + chNFe + nSeqEvento) (*1) |
Obrig. | 573 | Rej. | Rejeição: Duplicidade de Evento | ||||
(*1) Essa regra somente deve ser aplicada se tpAutor=1
(*2)Validações genéricas do Registro de Evento.
O processamento do lote pode resultar em:
A UF que recepcionar o Evento deve enviá-lo para o Sistema de Compartilhamento do AN – Ambiente Nacional – para que o Evento seja distribuído para todos os interessados.
A resposta da SEFAZ pode ser assinada e neste caso deve ser preenchido o atributo "Id' (HR12). Este atributo é opcional e não deve ser informado pela SEFAZ caso a mensagem de resposta não seja assinada. Esta orientação é válida para todos os tipos de evento.
O arquivo digital do Evento, com a respectiva informação do Registro de Evento da SEFAZ, deve ser mantido pelo emissor e disponibilizado para o destinatário, na forma da abaixo.
| # | Campo | Ele | Pai | Tipo | Ocor. | Tam. | Descrição/Observação |
|---|---|---|---|---|---|---|---|
| ZR01 | procEventoNFe | Raiz | - | - | - | - | TAG raiz |
| ZR02 | versao | A | ZR01 | N | 1-1 | 2v2 | TAG raiz |
| ZR03 | evento | G | ZR01 | - | 1-1 | - | |
| ZR04 | (dados) | - | - | - | - | - | Dados do Evento (mensagem de entrada) |
| ZR05 | retEvento | G | ZR01 | - | 1-1 | - | |
| ZR06 | (dados) | - | - | - | - | - | Dados do registro do Evento (mensagem de saída) |
