Professional Documents
Culture Documents
Nota Tcnica 2011/006 Cancelamento da NF-e como Evento da Nota Fiscal Eletrnica
Controle de Verses
Verso 0.00 1.00 Data 14/09/2011 SP 07/10/2011 Reviso RS/SP
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 de 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.
Pg. 2 / 9
WS da Fazenda
Web Service :
RecepcaoEvento
Proc. nfeRecepcaoEvento
Ret
Cliente SRE
Retorno
Funo: Servio destinado recepo de mensagem de Evento da NF-e O Cancelamento um evento para cancelar a 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. Processo: sncrono. Mtodo: nfeRecepcaoEvento
HP08 cOrgao HP09 HP10 HP11 HP12 HP13 tpAmb CNPJ CPF chNFe dhEvento
Pg. 3 / 9
Campo
Ele E G A E E E G
Tipo Ocor. Tam. N 1-1 1-1 1-1 1-1 1-1 1-1 1-1 2,2
HP16 verEvento HP17 detEvento HP18 versao HP19 descEvento HP20 nProt HP21 xJust HP22 Signature
N C N C
Descrio/Observao deve numerar de forma seqencial. 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
HP04 XML
HR04 tpAmb HR05 verAplic HR06 cOrgao HR07 HR08 HR09 HR10 HR11 HR12 cStat xMotivo retEvento versao infEvento Id
HR15 cOrgao HR16 HR17 HR18 HR19 HR20 HR21 cStat xMotivo chNFe tpEvento xEvento nSeqEvento
HR26 nProt
Pg. 4 / 9
HR27 Signature
HR09 XML
0-1
Assinatura Digital do documento XML, a assinatura dever ser aplicada no elemento infEvento. A deciso de assinar a mensagem fica a critrio da UF.
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
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.
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 Pg. 6 / 9
Regra de Validao Verifica se o tpEvento vlido Verifica se o verEvento vlido Verifica se o detEvento atende o respectivo schema XML
Aplic. Msg Efeito Obrig. 491 Rej. Obrig. 492 Rej. Obrig. 493 Rej.
Obrig. Obrig.
297 213
Rej. Rej.
Validao do Registro de Eventos Regras de Negcios parte Geral Regra de Validao Aplic. Msg Efeito chave de acesso da NF-e Se evento do destinatrio verificar se CNPJ do Autor diferente do CNPJ base Obrig. 575 Rej. do destinatrio da NF-e Se evento do Fisco/RFB/Outros rgos, verificar se CNPJ do Autor consta da Obrig. 576 Rej. tabela de rgos autorizados a gerar evento Data do evento no pode ser menor que a data de emisso da NF-e, se Obrig. 577 Rej. existir Data do evento no pode ser maior que a data de processamento Obrig. 578 Rej. Data do evento no pode ser menor que a data de autorizao para NF-e no Obrig. 579 Rej. emitida em contingncia se a NF-e existir.
128
135 136
Cdigo
489 490 491 492 493 494 501 572 573 574 575 576 577 578 579 580 594 614 615 616 617 618 619 642
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: Pedido de Cancelamento intempestivo (NF-e autorizada a mais de 7 dias) 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: O nmero de seqencia do evento informado maior que o permitido Rejeio: Chave de Acesso invlida (Cdigo UF invlido) Rejeio: Chave de Acesso invlida (Ano menor que 05 ou Ano maior que Ano corrente) Rejeio: Chave de Acesso invlida (Ms menor que 1 ou Ms maior que 12) Rejeio: Chave de Acesso invlida (CNPJ zerado ou dgito invlido) Rejeio: Chave de Acesso invlida (modelo diferente de 55) Rejeio: Chave de Acesso invlida (nmero NF = 0) Rejeio: Falha na Consulta do Registro de Passagem, tente novamente aps 5 minutos
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