Beruflich Dokumente
Kultur Dokumente
Verso 1.00c
Maro 2012
Controle de Verses
Verso
0.00
1.00
1.00b
1.00c
Data
14/09/2011 SP
07/10/2011 Reviso RS/SP
28/02/2012 Reviso RS/Serpro/
08/10/2012 - Acertos
Este documento tem por objetivo a definio das especificaes tcnicas necessrias para a
implementao do Cancelamento da NF-e como um evento da NF-e 2G.
O cancelamento da NF-e como evento da NF-e atende a reivindicao das empresas em ter o e-mail
do destinatrio na resposta do cancelamento que facilita a sua distribuio para o destinatrio,
tambm vai facilitar as UF que desejarem recepcionar o pedido de cancelamento extemporneo por
desvincular o cancelamento da NF-e nos casos em que o cancelamento armazenado com a NF-e.
A adoo do cancelamento da NF-e como evento da NF-e ser gradual, a SEFAZ deve disponibilizar
o Cancelamento como evento at 01/07/2012.
O Web Service de Cancelamento existente ser eliminado em 01/12/2012, permanecendo
unicamente a possibilidade de cancelamento da NF-e atravs do Web Service de Registro de
Eventos.
O documento ser tratado como um documento independente durante a fase de desenvolvimento do
Web Service para facilitar a sua manuteno e aperfeioamento.
Alteraes da Verso 1.00a
O Web Service do Evento de Cancelamento est em desenvolvimento pelas SEFAZ e pelas
empresas e foi reportada a necessidade de alguns ajustes, conforme segue:
A. Adequao da Regra de Validao para o prazo do cancelamento (1 dia, conforme legislao);
B. Informar a Chave de Acesso existente na SEFAZ, no caso do Pedido de Cancelamento para
uma Chave de Acesso divergente (mesmo CNPJ, Srie e Nmero, mas outra Chave de
Acesso);
C. Alterao de Schema com: Uso da verso correta do arquivo Schema tiposBasico; Nome da
tag TRetEvento; Identificao da RFB como cOrgao=91;
Pg. 2 / 9
WS da Fazenda
Web Service :
RecepcaoEvento
Proc.
nfeRecepcaoEvento
Ret
Cliente
SRE
Recepo
Aplicao SRE
Retorno
HP04
HP05
HP06
HP07
evento
versao
infEvento
Id
HP08 cOrgao
HP09
HP10
HP11
HP12
HP13
tpAmb
CNPJ
CPF
chNFe
dhEvento
HP14 tpEvento
HP15 nSeqEvento
Ele
Pai Tipo Ocor. Tam.
Descrio/Observao
Raiz
TAG raiz
A HP01 N
1-1
2v2 Verso do leiaute
E HP01 N
1-1 1-15 Identificador de controle do Lote de envio do Evento.
Nmero sequencial 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.
G HP01 xml 1-20
Evento, um lote pode conter at 20 eventos
A HP04 N
1-1
2v2 Verso do leiaute do evento
G HP04
1-1
Grupo de informaes do registro do Evento
ID HP06 C
1-1
54 Identificador da TAG a ser assinada, a regra de formao do Id :
ID + tpEvento + chave da NF-e + nSeqEvento
E HP06 N
1-1
2 Cdigo do rgo de recepo do Evento. Utilizar a Tabela do
IBGE, utilizar 91 para identificar o Ambiente Nacional.
E HP06 N
1-1
1 Identificao do Ambiente: 1=Produo /2=Homologao
CE HP06 N
1-1
14 Informar o CNPJ ou o CPF do autor do Evento
CE HP06 N
1-1
11
E HP06 N
1-1
44 Chave de Acesso da NF-e vinculada ao Evento
E HP06 D
1-1
Data e hora do evento no formato AAAA-MM-DDThh: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-0819T13:00:15-03:00.
E HP06 N
1-1
6 Cdigo do evento = 110111
E HP06 N
1-1
1-2 Sequencial do evento para o mesmo tipo de evento. Para maioria
dos eventos nSeqEvento=1, nos casos em que possa existir mais
Pg. 3 / 9
Campo
Ele
Pai
HP16 verEvento
HP06
1-1
2v2
HP17 detEvento
HP18 versao
G
A
HP06
HP17
1-1
1-1
2v2
HP19 descEvento
HP20 nProt
E
E
HP17
HP17
C
N
1-1
1-1
5-60
15
HP21 xJust
HP17
1-1
15255
HP22 Signature
HP04 XML
1-1
Descrio/Observao
de um evento, como o caso da Carta de Correo, o autor do
evento deve numerar de forma sequencial.
Verso do detalhe do evento (grupo detEvento HP17),
informao utilizada para a SEFAZ validar o grupo detEvento.
Informaes do Pedido de Cancelamento
Verso do Pedido de Cancelamento, deve ser informado com a
mesma informao da tag verEvento (HP16)
Cancelamento
Informar o nmero do Protocolo de Autorizao da NF-e a ser
Cancelada. (vide item 5.6).
Informar a justificativa do cancelamento
Assinatura Digital do documento XML, a assinatura dever ser
aplicada no elemento infEvento
cStat
xMotivo
retEvento
versao
infEvento
Id
HR13 tpAmb
HR14 verAplic
HR15 cOrgao
HR16
HR17
HR18
HR19
HR20
HR21
cStat
xMotivo
chNFe
tpEvento
xEvento
nSeqEvento
HR22
HR23
HR24
HR25
CNPJDest
CPFDest
emailDest
dhRegEvento
HR26 nProt
HR27 Signature
Pg. 4 / 9
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.
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.
Pg. 5 / 9
Regra de Validao
Elemento nfeCabecMsg inexistente no SOAP Header
Campo cUF inexistente no elemento nfeCabecMsg do SOAP Header
Verificar se a UF informada no campo cUF atendida pelo Web Service
Campo versaoDados inexistente no elemento nfeCabecMsg do SOAP Header
Verso dos Dados informada superior verso vigente
Verso dos Dados no suportada
517
Rej.
Facul.
545
Rej.
Facul.
587
Rej.
Facul.
588
Rej.
Obrig.
Obrig.
404
402
Rej.
Rej.
Regra de Validao
Obrig.
Obrig.
Obrig.
491
492
493
Rej.
Rej.
Rej.
Obrig.
Obrig.
297
213
Rej.
Rej.
G07
G08
G11
G12
G13
Pg. 8 / 9
Campo
procEventoNFe
versao
evento
(dados)
retEvento
(dados)
Ele
Pai Tipo Ocor. Tam. Dec. Descrio/Observao
Raiz
- TAG raiz
A
ZR01 N
1-1
1-4
2
G
ZR01
1-1
- Dados do Evento (mensagem de entrada)
G
ZR01
1-1
- Dados do registro do Evento (mensagem de
sada)
128
135
136
Cdigo
249
489
490
491
492
493
494
501
503
572
573
574
575
576
577
578
579
580
594
614
615
616
617
618
619
642
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. 9 / 9