Nota Fiscal eletrnica

Nota Tcnica 2010/008

Projeto Nota Fiscal Eletrnica

Nota Tcnica 2010/008

2010/00
Registro de Eventos
da Nota Fiscal Eletrnica
Carta de Correo

Verso 1.00
Setembro 2010

Nota Fiscal eletrnica

Manual de Integrao - Contribuinte

Controle de Verses
Verso
0.00
1.00

Data
17/06/2010 SP
20/08/2010 RS/SC/SP

Este documento tem por objetivo a definio das especificaes tcnicas necessrias para a
implementao da Carta de Correo eletrnica CC-e e adequao da Consulta Situao da NF-e
para permitir a consulta dos eventos da NF-e 2G.
O documento ser tratado como um documento independente durante a fase de desenvolvimento do
Web Service para facilitar a sua manuteno e aperfeioamento.
Aps a disponibilizao do Web Service de Registro do Evento Carta de Correo em ambiente de
produo, o documento passar a fazer parte do Manual de Integrao do Contribuinte verso
4.01.

Pg. 2 / 15

Nota Fiscal eletrnica

Manual de Integrao - Contribuinte

4.5

Service NfeConsulta2 Protocolo

Consulta situao atual da NF-e

Contribuinte

Secretaria de Fazenda Estadual

Web Service:
NfeConsulta

Client NFe

Proc.

nfeConsultaNF

Consulta NF-e

Ret

Retorno

Consulta NF-e
Aplicao NF-e

Funo: servio destinado ao atendimento de solicitaes de consulta da situao atual da NF-e na

Base de Dados do Portal da Secretaria de Fazenda Estadual.
Processo: sncrono.
Mtodo: nfeConsultaNF2
4.5.1

Leiaute Mensagem de Entrada

Entrada: Estrutura XML contendo a chave de acesso da NF-e.

Schema XML: consSitNFe_v2.01.xsd
#

Campo

EP01 conSitNFe

Ele

Pai

Tipo Ocor. Tam. Dec.

Descrio/Observao

Raiz

EP02 versao

EP01

1-1

1-4

EP03 tpAmb

EP01

1-1

Identificao do Ambiente:
1 Produo / 2 - Homologao

EP04 xServ

EP01

1-1

Servio solicitado
CONSULTAR

EP05 chNFe

EP01

1-1

44

Chave de Acesso da NF-e.

4.5.2

TAG raiz
2

Verso do leiaute

Leiaute Mensagem de Retorno

Retorno: Estrutura XML contendo a mensagem do resultado da consulta de protocolo:

Schema XML: retConsSitNFe_v2.01.xsd
#

Campo

ER01 retConsSitNFe

Ele

Pai

Raiz -

Descrio/Observao

Tipo Ocor. Tam. Dec.

-

TAG raiz da Resposta

ER02 versao

ER01

1-1

1-4

ER03 tpAmb

ER01

1-1

ER04 verAplic

ER01

1-1

1-20

Verso do leiaute
Identificao do Ambiente:
1 Produo / 2 Homologao
Verso do Aplicativo que processou a consulta.
A verso deve ser iniciada com a sigla da UF
nos casos de WS prprio ou a sigla SCAN,

Pg. 3 / 15

Nota Fiscal eletrnica

Manual de Integrao - Contribuinte

SVAN ou SVRS nos demais casos.

ER05 cStat

ER01

1-1

ER06 xMotivo

ER01

1-1

1-255

ER07 cUF

ER01

1-1

Cdigo da UF que atendeu a solicitao.

EP07a chNFe

ER01

1-1

44

Chave de Acesso da NF-e consultada.

ER08 protNFe

ER01

xml

0-1

Protocolo de autorizao ou denegao de uso

da NF-e (vide item 4.2.2).
Informar se localizado uma NF-e com cStat =
100 (uso autorizado) ou 110 (uso denegado).

ER09 retCancNFe

ER01

xml

0-1

Protocolo de homologao de cancelamento

de NF-e (vide item 4.3.2).
Informar se localizado uma NF-e com cStat =
101 (cancelado).

ER10 procEventoNFe

ER01

xml

0-N

Informao do evento e respectivo Protocolo

de registro de Evento

4.5.3

Cdigo do status da resposta.

Descrio literal do status da resposta.

Descrio do Processo de Web Service

Este mtodo ser responsvel por receber as solicitaes referentes consulta de situao de notas
fiscais eletrnicas enviadas para as Secretarias de Fazendas Estaduais. Seu acesso permitido
apenas pela chave nica de identificao da nota fiscal.
O aplicativo do contribuinte envia a solicitao para o Web Service da Secretaria de Fazenda
Estadual. Ao receber a solicitao a aplicao do Portal da Secretaria de Fazenda Estadual
processar a solicitao de consulta, validando a Chave de Acesso da NF-e, e retornar mensagem
contendo a situao atual da NF-e na Base de Dados e todos os protocolos dos eventos existentes
para a NF-e consultada.
Devero ser realizadas as validaes e procedimentos que seguem.
4.5.4

Validao do Certificado de Transmisso

Validao do Certificado Digital do Transmissor (protocolo SSL)
Crtica

Msg

Efeito

A01 Certificado de Transmissor Invlido:

Obrig.
- Certificado de Transmissor inexistente na mensagem
- Verso difere "3"
- Se informado, Basic Constraint de ser true (no pode ser Certificado
de AC)
- KeyUsage no define "Autenticao Cliente"
A02 Validade do Certificado (data incio e data fim)
Obrig.

280

Rej.

281

Rej.

Regra de Validao

A03 Verifica a Cadeia de Certificao:

- Certificado da AC emissora no cadastrado na SEFAZ
- Certificado de AC revogado
- Certificado no assinado pela AC emissora do Certificado

Obrig.

283

Rej.

A04 LCR do Certificado de Transmissor

- Falta o endereo da LCR (CRL DistributionPoint)
- LCR indisponvel
- LCR invlida
A05 Certificado do Transmissor revogado

Obrig.

286

Rej.

Obrig.

284

Rej.

A06 Certificado Raiz difere da "ICP-Brasil"

Obrig.

285

Rej.

A07 Falta a extenso de CNPJ no Certificado (OtherName OID=2.16.76.1.3.3)

Obrig.

282

Rej.

As validaes de A01, A02, A03, A04 e A05 so realizadas pelo protocolo SSL e no precisam ser
implementadas. A validao A06 tambm pode ser realizada pelo protocolo SSL, mas pode falhar se
Pg. 4 / 15

Nota Fiscal eletrnica

Manual de Integrao - Contribuinte

existirem outros certificados digitais de Autoridade Certificadora Raiz que no sejam ICP-Brasil no
repositrio de certificados digitais do servidor de Web Service da SEFAZ.
4.5.5

Validao Inicial da Mensagem no Web Service

Validao Inicial da Mensagem no Web Service
Aplic.

Msg

Efeito

B01 Tamanho do XML de Dados superior a 500 Kbytes

Obrig.

214

Rej.

B02 XML de Dados Mal Formado

Facult.

243

Rej.

B03 Verifica se o Servio est Paralisado Momentaneamente

Obrig.

108

Rej.

B04 Verifica se o Servio est Paralisado sem Previso

Obrig.

109

Rej.

Regra de Validao

A mensagem ser descartada se o tamanho exceder o limite previsto (500 KB) A aplicao do
contribuinte no poder permitir a gerao de mensagem com tamanho superior a 500 KB. Caso isto
ocorra, a conexo poder ser interrompida sem mensagem de erro se o controle do tamanho da
mensagem for implementado por configuraes do ambiente de rede da SEFAZ (ex.: controle no
firewall). No caso do controle de tamanho ser implementado por aplicativo teremos a devoluo da
mensagem de erro 214.
As unidades federadas que mantm o Web Service disponvel, mesmo quando o servio estiver
paralisado, devero implementar as verificaes 108 e 109. Estas validaes podero ser
dispensadas se o Web Service no ficar disponvel quando o servio estiver paralisado.
4.5.6

Validao das informaes de controle da chamada ao Web Service

Validao das informaes de controle da chamada ao Web Service

Regra de Validao

Aplic.

Msg

Efeito

C01 Elemento nfeCabecMsg inexistente no SOAP Header

Facult.

242

Rej.

C02 Campo cUF inexistente no elemento nfeCabecMsg do SOAP Header

Obrig.

409

Rej.

C03 Verificar se a UF informada no campo cUF atendida pelo Web Service

Obrig.

410

Rej.

C04 Campo versaoDados inexistente no elemento nfeCabecMsg do SOAP Obrig.

Header
C05 Verso dos Dados informada superior verso vigente
Facult.

411

Rej.

238

Rej.

C06 Verso dos Dados no suportada

239

Rej.

Obrig.

A informao da verso do leiaute da mensagem e a UF de origem do emissor da NF-e constam no

elemento nfeCabecMsg do SOAP Header (para maiores detalhes vide item 3.4.1).
A aplicao dever validar os campos cUF e versaoDados, rejeitando a mensagem recebida em caso de
informaes inexistentes ou invlidas.

O campo versaoDados contm a verso do Schema XML da mensagem contida na rea de dados
que ser utilizado pelo Web Service.
4.5.7

Validao da rea de Dados

a) Validao da Forma da rea de Dados

Validao da Mensagem do Pedido de Consulta de situao de NF-e.
Aplic.

Msg Efeito

Obrig.

215

Rej.

D01a Em caso de Falha de Schema, verificar se existe a tag raiz esperada Facul.

516

Rej.

Regra de Validao

D01 Verifica Schema XML da rea de Dados

Pg. 5 / 15

Nota Fiscal eletrnica

Manual de Integrao - Contribuinte

para mensagem
D01b Em caso de Falha de Schema, verificar se existe o atributo versao
para a tag raiz da mensagem
D01c Em caso de Falha de Schema, verificar se o contedo do atributo
versao difere do contedo da versaoDados informado no
SOAPHeader
D01d Verifica a existncia de qualquer namespace diverso do namespace
padro da NF-e (http://www.portalfiscal.inf.br/nfe)
D01e Verifica a existncia de caracteres de edio no incio ou fim da
mensagem ou entre as tags
D02 Verifica o uso de prefixo no namespace
D03 XML utiliza codificao diferente de UTF-8

Facul.

517

Rej.

Facul.

545

Rej.

Facul.

587

Rej.

Facul.

588

Rej.

Obrig.

404

Rej.

Obrig.

402

Rej.

As validaes D01a, D01b e D01c so de aplicao facultativa e podem ser aplicadas

sucessivamente quando ocorrer falha na validao D01 e a SEFAZ entender oportuno informar a
divergncia entre a verso informada no SOAP Header e a verso da mensagem XML.
b) Validao das Regras de Negcios da Consulta a NF-e
A seguir so realizadas as seguintes validaes:
Validao do Pedido de Consulta de situao de NF-e Regras de Negcios
Aplic.

Msg

Efeito

J01 Tipo do ambiente da NF-e difere do ambiente do Web Service

Obrig.

252

Rej.

J02 UF da Chave de Acesso difere da UF do Web Service

Obrig.

226

Rej.

J03 Acesso BD NFE (Chave: Ano, CNPJ Emit, Modelo, Srie, Nro): Obrig.
- Verificar se NF-e no existe

217

Rej.

J04 - Verificar se campo Cdigo Numrico informado na Chave de Obrig.

Acesso diferente do existente no BD

562

Rej.

J05 - Verificar se campo MM (ms) informado na Chave de Acesso Obrig.

diferente do existente no BD

561

Rej.

4.5.8

Regra de Validao

Final do Processamento

O processamento do pedido de consulta de status de NF-e pode resultar em uma mensagem de erro
ou retornar a situao atual da NF-e consultada.
No caso de localizao da NF-e retornar o cStat com os valores 100-Autorizado o Uso, 101Cancelamento de NF-e Homologado ou 110-Uso Denegado

Pg. 6 / 15

Nota Fiscal eletrnica

Manual de Integrao - Contribuinte

4.8

Web Service RecepcaoEvento Carta de Correo

Sistema de Registro de Eventos

Emissor NF-e

WS da Fazenda
Web Service :
RecepcaoEvento

Proc.

Envio de Evento da NF-e

nfeRecepcaoEvento
Ret

Cliente

Recepo
Aplicao SRE

Retorno

Funo: servio destinado recepo de mensagem de Evento da NF-e

A Carta de Correo um evento para corrigir as informaes da NF-e.
O autor do evento o emissor da NF-e. A mensagem XML do evento ser assinada com o
certificado digital que tenha o CNPJ base do Emissor da NF-e.
O evento ser utilizado pelo contribuinte e o alcance das alteraes permitidas definido no 1 do
art. 7 do Ajuste SINIEF S/N, que transcrevemos a seguir:
Art. 7 Os documentos fiscais referidos nos incisos I a V do artigo anterior devero ser extrados
por decalque a carbono ou em papel carbonado, devendo ser preenchidos a mquina ou manuscritos a tinta ou a
lpis-tinta, devendo ainda os seus dizeres e indicaes estar bem legveis, em todas as vias.
(...)
1-A Fica permitida a utilizao de carta de correo, para regularizao de erro ocorrido na
emisso de documento fiscal, desde que o erro no esteja relacionado com:
I - as variveis que determinam o valor do imposto tais como: base de clculo, alquota, diferena de
preo, quantidade, valor da operao ou da prestao;
II - a correo de dados cadastrais que implique mudana do remetente ou do destinatrio;
III - a data de emisso ou de sada.

O registro de uma nova Carta de Correo substitui a Carta de Correo anterior, assim a nova Carta
de Correo deve conter todas as correes a serem consideradas.
Processo: sncrono.
Mtodo: nfeRecepcaoEvento
4.8.1

Leiaute Mensagem de Entrada

Entrada: Estrutura XML com o Evento

Schema XML: envCCe_v9.99.xsd

Campo

HP01 envEvento
HP02 versao

Ele

Pai

Tipo Ocor. Tam. Dec.

Raiz

HP01

1-1

1-4

Descrio/Observao
TAG raiz

Verso do leiaute

Pg. 7 / 15

Nota Fiscal eletrnica

Manual de Integrao - Contribuinte

Campo

Ele

Pai

Tipo Ocor. Tam. Dec.

HP03 idLote

HP01

1-1

HP04 evento

HP01

xml

1-20

HP05 versao

HP04

1-1

1-4

HP06 infEvento

HP04

HP07 Id

ID HP06

1-1

54

Identificador da TAG a ser assinada, a regra de formao

do Id :
ID + tpEvento + chave da NF-e + nSeqEvento

HP08 cOrgao

HP06

1-1

Cdigo do rgo de recepo do Evento. Utilizar a Tabela

do IBGE, utilizar 90 para identificar o Ambiente Nacional.

HP09 tpAmb

HP06

1-1

Identificao do Ambiente:
1 - Produo
2 Homologao

HP10 CNPJ

CE HP06

1-1

14

Informar o CNPJ ou o CPF do autor do Evento

HP11 CPF

CE HP06

1-1

11
44

1-15

Identificador de controle do Lote de envio do Evento.

Nmero seqencial autoincremental nico para
identificao do Lote. A responsabilidade de gerar e
controlar exclusiva do autor do evento. O Web Service
no faz qualquer uso deste identificador.
Evento, um lote pode conter at 20 eventos
2

1-1

HP12 chNFe

HP06

1-1

HP13 dhEvento

HP06

1-1

Descrio/Observao

Verso do leiaute do evento

Grupo de informaes do registro do Evento

Chave de Acesso da NF-e vinculada ao Evento

Data e hora do evento no formato AAAA-MMDDThh:mm:ssTZD (UTC - Universal Coordinated Time,
onde TZD pode ser -02:00 (Fernando de Noronha), -03:00
(Braslia) ou -04:00 (Manaus), no horrio de vero sero 01:00, -02:00 e -03:00. Ex.: 2010-08-19T13:00:15-03:00.

HP14 tpEvento

HP06

1-1

HP15 nSeqEvento

HP06

1-1

1-2

HP16 verEvento

HP06

1-1

1-4

HP17 detEvento

HP06

1-1

HP18 versao

HP17

1-1

HP19 descEvento

HP17

1-1

5-60

Carta de Correo

HP20 xCorrecao

HP17

1-1

151000

Correo a ser considerada, texto livre. A correo mais

recente substitui as anteriores.

HP21 Signature

HP04 XML

4.8.2

Cdigo do de evento = 110110

Seqencial do evento para o mesmo tipo de evento. Para
maioria dos eventos ser 1, nos casos em que possa
existir mais de um evento, como o caso da carta de
correo, o autor do evento deve numerar de forma
seqencial.
2

Verso do evento
Informaes da carta de correo
Verso da carta de correo

1-1

Assinatura Digital do documento XML, a assinatura dever

ser aplicada no elemento infEvento

Leiaute Mensagem de Retorno

Retorno: Estrutura XML com a mensagem do resultado da transmisso.

Schema XML: retEnvCCe_v9.99.xsd
#

Campo

HR01 retEnvEvento

Ele

Pai

Raiz

Tipo Ocor. Tam. Dec.

-

Descrio/Observao
TAG raiz do Resultado do Envio do Evento

HR02 versao

HR01

1-1

1-4

HR03 idLote

HR01

1-1

1-15

HR04 tpAmb

HR01

1-1

HR05 verAplic

HR01

1-1

1-20

HR06 cOrgao

HR01

1-1

Verso do leiaute
Identificador de controle do Lote de envio do Evento.
Nmero seqencial autoincremental nico para identificao
do Lote.
Identificao do Ambiente:
1 Produo / 2 - Homologao
Verso da aplicao que processou o evento.
Cdigo da UF que registrou o Evento. Utilizar 90 para o

Pg. 8 / 15

Nota Fiscal eletrnica

Manual de Integrao - Contribuinte

Ambiente Nacional.
HR07 cStat

HR01

1-1

HR08 xMotivo

HR01

1-1

255

HR09 retEvento

HR01

0-20

HR10 versao

HR09

1-1

1-4

HR11 infEvento

HR09

HR12 Id

ID HR11

0-1

17

Identificador da TAG a ser assinada, somente deve ser

informado se o rgo de registro assinar a resposta.
Em caso de assinatura da resposta pelo rgo de registro,
preencher com o nmero do protocolo, precedido pela literal
ID

HR13 tpAmb

HR11

1-1

Identificao do Ambiente:
1 Produo / 2 Homologao

HR14 verAplic

HR11

1-1

1-20

HR15 cOrgao

HR11

1-1

Cdigo da UF que registrou o Evento. Utilizar 90 para o

Ambiente Nacional.

HR16 cStat

HR11

1-1

Cdigo do status da resposta.

HR17 xMotivo

HR11

1-1

255

Descrio do status da resposta.

HR18 chNFe

HR11

0-1

44

Chave de Acesso da NF-e vinculada ao evento.

HR19 tpEvento

HR11

0-1

Cdigo do Tipo do Evento.

HR20 xEvento

HR11

0-1

5-60

Descrio do Evento Carta de Correo registrada

HR21 nSeqEvento

HR11

0-1

1-2

Seqencial do evento para o mesmo tipo de evento. Para

maioria dos eventos ser 1, nos casos em que possa existir
mais de um evento, como o caso da carta de correo, o
autor do evento deve numerar de forma seqencial.

HR22 CNPJDest

CE HR11

0-1

14

Informar o CNPJ ou o CPF do destinatrio da NF-e.

HR23 CPFDest

CE HR11

0-1

11
1-60

Descrio do status da resposta

TAG de grupo do resultado do processamento do Evento
2

1-1

HR24 emailDest

HR11

0-1

HR25 dhRegEvento

HR11

1-1

HR26 nProt

HR11

0-1

HR27 Signature

HR09 XML

4.8.3

Cdigo do status da resposta

0-1

Verso do leiaute
Grupo de informaes do registro do Evento

Verso da aplicao que registrou o Evento, utilizar literal

que permita a identificao do rgo, como a sigla da UF ou
do rgo.

email do destinatrio informado na NF-e.

Data e hora de registro do evento no formato AAAA-MMDDTHH:MM:SSTZD (formato UTC, onde TZD +HH:MM ou
HH:MM), se o evento for rejeitado informar a data e hora
de recebimento do evento.

15

Nmero do Protocolo da NF-e

1 posio (1-Secretaria da Fazenda Estadual, 2-RFB), 2
posies para o cdigo da UF, 2 posies para o ano e 10
posies para o seqencial no ano.
Assinatura Digital do documento XML, a assinatura dever
ser aplicada no elemento infEvento. A deciso de assinar a
mensagem fica a critrio da UF.

Descrio do Processo de Recepo de Evento

O WS de Eventos acionado pelo interessado emissor da NF-e que deve enviar mensagem de
registro de evento da Carta de Correo.
O processo de Registro de Eventos recebe eventos em uma estrutura de lotes, que pode conter de 1
a 20 eventos.

4.8.4

Validao do Certificado de Transmisso

Validao do Certificado Digital do Transmissor (protocolo SSL)

Regra de Validao

Crtica
Pg. 9 / 15

Msg

Efeito

Nota Fiscal eletrnica

Manual de Integrao - Contribuinte

A01 Certificado de Transmissor Invlido:

- Certificado de Transmissor inexistente na mensagem
- Verso difere "3"
- Se informado o Basic Constraint deve ser true (no pode ser Certificado
de AC)
- KeyUsage no define "Autenticao Cliente"
A02 Validade do Certificado (data incio e data fim)

Obrig.

280

Rej.

Obrig.

281

Rej.

A03 Verifica a Cadeia de Certificao:

- Certificado da AC emissora no cadastrado na SEFAZ
- Certificado de AC revogado
- Certificado no assinado pela AC emissora do Certificado

Obrig.

283

Rej.

A04 LCR do Certificado de Transmissor

- Falta o endereo da LCR (CRL DistributionPoint)
- LCR indisponvel
- LCR invlida
A05 Certificado do Transmissor revogado

Obrig.

286

Rej.

Obrig.

284

Rej.

A06 Certificado Raiz difere da "ICP-Brasil"

Obrig.

285

Rej.

A07 Falta a extenso de CNPJ no Certificado (OtherName - OID=2.16.76.1.3.3)

Obrig.

282

Rej.

As validaes de A01, A02, A03, A04 e A05 so realizadas pelo protocolo SSL e no precisam ser
implementadas. A validao A06 tambm pode ser realizada pelo protocolo SSL, mas pode falhar se
existirem outros certificados digitais de Autoridade Certificadora Raiz que no sejam ICP-Brasil no
repositrio de certificados digitais do servidor de Web Service do rgo de registro.
4.8.5

Validao Inicial da Mensagem no Web Service

Validao Inicial da Mensagem no Web Service
Aplic.

Msg

Efeito

B01 Tamanho do XML de Dados superior a 500 KB

Obrig.

214

Rej.

B02 Verifica se o Servidor de Processamento est Paralisado Momentaneamente

Obrig.

108

Rej.

B03 Verifica se o Servidor de Processamento est Paralisado sem Previso

Obrig.

109

Rej.

Regra de Validao

A mensagem ser descartada se o tamanho exceder o limite previsto (500 KB). A aplicao do
contribuinte no poder permitir a gerao de mensagem com tamanho superior a 500 KB. Caso isto
ocorra, a conexo poder ser interrompida sem retorno da mensagem de erro se o controle do
tamanho da mensagem for implementado por configuraes do ambiente de rede (ex.: controle no
firewall). No caso do controle de tamanho ser implementado por aplicativo teremos a devoluo da
mensagem de erro 214.
Caso o Web Service fique disponvel, mesmo quando o servio estiver paralisado, devero
implementar as verificaes 108 e 109. Estas validaes podero ser dispensadas se o Web Service
no ficar disponvel quando o servio estiver paralisado.
4.8.6

Validao das informaes de controle da chamada ao Web Service

Validao das informaes de controle da chamada ao Web Service

Regra de Validao

Aplic. Msg Efeito

C01 Elemento nfeCabecMsg inexistente no SOAP Header

Obrig.

242

Rej.

C02 Campo cUF inexistente no elemento nfeCabecMsg do SOAP Header

Obrig.

409

Rej.

C03 Verificar se a UF informada no campo cUF atendida pelo Web Service

Obrig.

410

Rej.

C04 Campo versaoDados inexistente no elemento nfeCabecMsg do SOAP Header

Obrig.

411

Rej.

Pg. 10 / 15

Nota Fiscal eletrnica

Manual de Integrao - Contribuinte

C05 Verso dos Dados informada superior verso vigente

C06 Verso dos Dados no suportada

Facult.
Obrig.

238
239

Rej.
Rej.

A informao da verso do leiaute do registro de evento informada no elemento nfeCabecMsg do

SOAP Header (para maiores detalhes vide item 3.4).
A aplicao dever validar o campo de verso da mensagem (versaoDados), rejeitando a solicitao
recebida em caso de informaes inexistentes ou invlidas.

4.8.7

Validao da rea de Dados

a) Validao de forma da rea de dados

A validao de forma da rea de dados da mensagem realizada com a aplicao da seguinte regra:
Validao da rea de dados da mensagem
Aplic.

Msg

Efeito

D01 Verifica Schema XML da rea de Dados

Obrig.

225

Rej.

D01a Em caso de Falha de Schema, verificar se existe a tag raiz esperada para o
lote
D01b Em caso de Falha de Schema, verificar se existe o atributo versao para a
tag raiz da mensagem
D01c Em caso de Falha de Schema, verificar se o contedo do atributo versao
difere do contedo da versaoDados informado no SOAPHeader
D01d Verifica a existncia de qualquer namespace diverso do namespace padro
da NF-e (http://www.portalfiscal.inf.br/nfe)
D01e Verifica a existncia de caracteres de edio no incio ou fim da mensagem
ou entre as tags
D02 Verifica o uso de prefixo no namespace

Facul.

516

Rej.

Facul.

517

Rej.

Facul.

545

Rej.

Facul.

587

Rej.

Facul.

588

Rej.

Obrig.

404

Rej.

D03 XML utiliza codificao diferente de UTF-8

Obrig.

402

Rej.

Regra de Validao

As validaes D01d, D01e e D01f so de aplicao facultativa e podem ser aplicadas

sucessivamente quando ocorrer falha na validao D01 e a SEFAZ entender oportuno informar a
divergncia entre a verso informada no SOAP Header e a verso da mensagem XML.
A validao do Schema XML realizada em toda mensagem de entrada, mas como existe uma parte
da mensagem que varivel pode ocorrer erro de falha de Schema XML da parte especfica da
mensagem que ser identificado posteriormente.
b) Extrao dos eventos do lote e validao do Schema XML do evento
A aplicao deve extrair os eventos do lote para tratar individualmente os eventos, a princpio no
existe necessidade de que todos os eventos sejam do mesmo tipo.
A escolha do Schema XML aplicvel para o evento realizado com base no tipo do evento tpEvento
combinado com a verEvento, assim, a aplicao deve manter um controle dos tpEvento vlidos e as
verEvento em vigncia e o respectivo Schema XML.
Validao do evento
#

Regra de Validao

D04 Verifica se o tpEvento vlido

Pg. 11 / 15

Aplic.

Msg

Efeito

Obrig.

491

Rej.

Nota Fiscal eletrnica

Manual de Integrao - Contribuinte

D05 Verifica se o verEvento vlido

Obrig.

492

Rej.

D06 Verifica se o detEvento atende o respectivo schema XML

Obrig.

493

Rej.

c) Validao do Certificado Digital de Assinatura

Validao do Certificado Digital utilizado na Assinatura Digital do DF-e

Aplic.

Msg

Efeito

Obrig.

290

Rej.

Obrig.

291

Rej.

E03 Falta a extenso de CNPJ no Certificado (OtherName OID=2.16.76.1.3.3)

E04 Verifica Cadeia de Certificao:
- Certificado da AC emissora no cadastrado na SEFAZ
- Certificado de AC revogado
- Certificado no assinado pela AC emissora do Certificado

Obrig.

292

Rej.

Obrig.

293

Rej.

E05 LCR do Certificado de Assinatura:

- Falta o endereo da LCR (CRLDistributionPoint)
- Erro no acesso a LCR ou LCR inexistente

Obrig.

296

Rej.

E06 Certificado de Assinatura revogado

Obrig.

294

Rej.

E07 Certificado Raiz difere da ICP-Brasil

Obrig.

295

Rej.

Regra de Validao

E01 Certificado de Assinatura invlido:

- Certificado de Assinatura inexistente na mensagem (*validado
tambm pelo Schema)
- Verso difere "3"
- Se informado o Basic Constraint deve ser true (no pode ser
Certificado de AC)
- KeyUsage no define "Assinatura Digital" e No Recusa
E02 Validade do Certificado (data incio e data fim)

d) Validao da Assinatura Digital

Validao da Assinatura Digital do DF-e

Aplic.

Msg

Efeito

Obrig.

298

Rej.

Obrig.

297

Rej.

F03 CNPJ-Base do Autor da mensagem difere do CNPJ-Base do Certificado Digital Obrig.

213

Rej.

Aplic.

Msg

Efeito

G01 Tipo do ambiente difere do ambiente do Web Service

Obrig.

252

Rej.

G02 Cdigo do rgo de recepo do Evento da UF diverge da solicitada

Obrig.

250

Rej.

G03 CNPJ do autor do evento informado invlido (DV ou zeros)

Obrig.

489

Rej.

Regra de Validao

F01 Assinatura difere do padro do Projeto:

- No assinado o atributo "ID" (falta "Reference URI" na assinatura) (*validado
tambm pelo Schema)
- Faltam os "Transform Algorithm" previstos na assinatura ("C14N" e
"Enveloped")
Estas validaes so implementadas pelo Schema XML da Signature
F02 Valor da assinatura (SignatureValue) difere do valor calculado

e) Validao de regras de negcios do Registro de Evento- parte Geral

Validao do Registro de Eventos Regras de Negcios parte Geral
#

Regra de Validao

Pg. 12 / 15

Nota Fiscal eletrnica

Manual de Integrao - Contribuinte

Validao do Registro de Eventos Regras de Negcios parte Geral

Regra de Validao

Aplic.

Msg

Efeito

G04 CPF do autor do evento informado invlido (DV ou zeros)

Obrig.

490

Rej.

G05 Validar se atributo Id corresponde concatenao dos campos evento (ID +

tpEvento + chNFe + nSeqEvento)
G06 Chave de Acesso inexistente para o tpEvento que exige a existncia da NF-e
G07 Verificar duplicidade do evento (tpEvento + chNFe + nSeqEvento)
G08 Se evento do emissor verificar se CNPJ do Autor diferente do CNPJ base da
chave de acesso da NF-e
G09 Se evento do destinatrio verificar se CNPJ do Autor diferente do CNPJ base
do destinatrio da NF-e
G10 Se evento do Fisco/RFB/Outros rgos, verificar se CNPJ do Autor consta da
tabela de rgos autorizados a gerar evento
G11 Data do evento no pode ser menor que a data de emisso da NF-e, se existir
G12 Data do evento no pode ser maior que a data de processamento
G13 Data do evento no pode ser menor que a data de autorizao para NF-e no
emitida em contingncia se a NF-e existir.

Obrig.

572

Rej.

Obrig.
Obrig.
Obrig.

494
573
574

Rej.
Rej.
Rej.

Obrig.

575

Rej.

Obrig.

576

Rej.

Obrig.
Obrig.
Obrig.

577
578
579

Rej.
Rej.
Rej.

Aplic.

Msg

Efeito

GA01 Verificar se a NF-e est autorizada (no pode estar cancelada nem denegada)

Obrig.

580

Rej.

GA02 Verificar NF-e autorizada h mais de 30 dias (720) horas

Obrig.

501

Rej.

4.8.8

Regras de validao especfica do evento Carta de Correo

Validao do Registro de Eventos Regras de Negcios especfica

4.8.9

Regra de Validao

Final do Processamento do Lote

O processamento do lote pode resultar em:

Rejeio do Lote por algum problema que comprometa o processamento do lote;

Processamento do Lote o lote foi processado (cStat=129), a validao de cada evento do
lote poder resultar em:
o Rejeio o Evento ser descartado, com retorno do cdigo do status do motivo da
rejeio;
o Recebido pelo Sistema de Registro de Eventos, com vinculao do evento na
NF-e, o Evento ser armazenado no repositrio do Sistema de Registro de Eventos
com a vinculao do Evento respectiva NF-e (cStat=135);
o Recebido pelo Sistema de Registro de Eventos vinculao do evento
respectiva NF-e prejudicada o Evento ser armazenado no repositrio do Sistema
de Registro de Eventos, a vinculao do evento respectiva NF-e fica prejudicada
face a inexistncia da NF-e no momento do recebimento do Evento (cStat=136);

A UF que recepcionar o Evento deve envi-lo para o Sistema de compartilhamento do AN

Ambiente Nacional para que o Evento seja distribudo para todos os interessados.

4.9

Armazenamento e Disponibilizao da Carta de Correo

O emissor deve manter o arquivo digital da Carta de Correo com a informao de Registro do
Evento da SEFAZ na forma que segue:
Schema XML: procCCeNFe_v99.99.xsd
Pg. 13 / 15

Nota Fiscal eletrnica

Manual de Integrao - Contribuinte

#
ZR01
ZR02
ZR03
YR04
YR05
YR06

Campo
procEventoNFe
versao
evento
(dados)
retEvento
(dados)

Ele

Pai

Tip Ocor. Tam. Dec. Descrio/Observao

o
Raiz
- TAG raiz
A
ZR01 N
1-1
1-4
2
G
ZR01 1-1
- Dados da Carta de Correo (item 4.8.1)
G
ZR01 1-1
- Dados da registro da Carta de Correo (item
4.8.2)

Diagrama simplificado do procCCeNFe

O arquivo digital da Carta de Correo com a respectiva informao de Registro do Evento da

SEFAZ faz parte integrante da NF-e e deve ser disponibilizado para o destinatrio e para a
transportadora tambm.

Pg. 14 / 15

Nota Fiscal eletrnica

Manual de Integrao - Contribuinte

5. Tabela de cdigos de erros e descries de mensagens de erros

CDIGO

129
135
136
CDIGO

489
490
491
492
493
494
501
572
573
574
575
576
577
578
579
580
587
588

RESULTADO DO PROCESSAMENTO DA SOLICITAO

Lote de Evento Processado

Evento registrado e vinculado a NF-e
Evento registrado, mas no vinculado a NF-e
MOTIVOS DE NO ATENDIMENTO DA SOLICITAO

Rejeio: CNPJ informado invlido (DV ou zeros)

Rejeio: CPF informado invlido (DV ou zeros)
Rejeio: O tpEvento informado invlido
Rejeio: O verEvento informado invlido
Rejeio: Evento no atende o Schema XML especfico
Rejeio: Chave de Acesso inexistente
Rejeio: NF-e autorizada h mais de 30 dias (720 horas)
Rejeio: Erro Atributo ID do evento no corresponde a concatenao dos campos (ID
+ tpEvento + chNFe + nSeqEvento)
Rejeio: Duplicidade de Evento
Rejeio: O autor do evento diverge do emissor da NF-e
Rejeio: O autor do evento diverge do destinatrio da NF-e
Rejeio: O autor do evento no um rgo autorizado a gerar o evento
Rejeio: A data do evento no pode ser menor que a data de emisso da NF-e
Rejeio: A data do evento no pode ser maior que a data do processamento
Rejeio: A data do evento no pode ser menor que a data de autorizao para NF-e
no emitida em contingncia
Rejeio: O evento exige uma NF-e autorizada
Rejeio: Usar somente o namespace padro da NF-e
Rejeio: No permitida a presena de caracteres de edio no incio/fim da
mensagem ou entre as tags da mensagem

OBS.:
1. Recomendamos a no utilizao de caracteres especiais ou acentuao nos textos das
mensagens de erro.
2. Recomendamos que o campo xMotivo da mensagem de erro para o cdigo 999 seja informado
com a mensagem de erro do aplicativo ou do sistema que gerou a exceo no prevista.

Pg. 15 / 15