cce nt2011.003[1]

Upload: mazzetto

Post on 06-Jul-2015

949 views

Category:

Documents


0 download

TRANSCRIPT

Nota Fiscal eletrnicaNT 2011/003

Projeto Nota Fiscal Eletrnica

Nota Tcnica 2011/003 Registro de Eventos da Nota Fiscal Eletrnica Carta de Correo

Verso 1.01 Maio 2011Pg. 1 / 18

Nota Fiscal eletrnicaNT 2011/003

ResumoEsta edio substitui o contedo da NT 2010/008 e divulga os seguintes aperfeioamentos realizados nas especificaes tcnicas da Carta de Correo:

a) Acrscimo da tag xCondUso na mensagem da Carta de Correo

HP19 descEvento HP20 xCorrecao HP20a xCondUso

E E E

HP17 HP17 HP17

C C C

1-1 1-1 1-1

5-60 151000 -

Carta de Correo ou Carta de Correcao Correo a ser considerada, texto livre. A correo mais recente substitui as anteriores. Condies de uso da Carta de Correo, informar a literal : A Carta de Correo disciplinada pelo 1-A do art. 7 do Convnio S/N, de 15 de dezembro de 1970 e pode ser utilizada 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. (texto com acentuao) ou A Carta de Correcao e disciplinada pelo paragrafo 1o-A do art. 7o do Convenio S/N, de 15 de dezembro de 1970 e pode ser utilizada para regularizacao de erro ocorrido na emissao de documento fiscal, desde que o erro nao esteja relacionado com: I - as variaveis que determinam o valor do imposto tais como: base de calculo, aliquota, diferenca de preco, quantidade, valor da operacao ou da prestacao; II - a correcao de dados cadastrais que implique mudanca do remetente ou do destinatario; III - a data de emissao ou de saida. (texto sem acentuao) Assinatura Digital do documento XML, a assinatura dever ser aplicada no elemento infEvento

HP21 Signature

G

HP04 XML

1-1

b) Acrscimo da regra GA03 de validao do seqencial do evento da CC-e:

4.8.8 Regras de validao especfica do evento Carta de CorreoValidao do Registro de Eventos Regras de Negcios especfica # Regra de Validao Aplic. Msg 580 501 594 Efeito Rej. Rej. Rej. GA01 Verificar se a NF-e est autorizada (no pode estar cancelada e nem Obrig. denegada) GA02 Verificar NF-e autorizada h mais de 30 dias (720) horas Obrig. GA03 Verificar o sequencial do evento (HP15 - nSeqEvento) valor vlido (1- Obrig. 20)

Acrscimo da Mensagem 594:

Pg. 2 / 18

Nota Fiscal eletrnicaNT 2011/003

CDIGO

MOTIVOS DE NO ATENDIMENTO DA SOLICITAO

594

Rejeio: O nmero de seqencia do evento informado maior que o permitido

c) Alterao do cdigo do cStat da mensagem de lote processado para 128.

4.8.9 Final do Processamento do LoteO 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=128), a validao de cada evento do lote poder resultar em: Alterao do cdigo da Mensagem:

CDIGO

RESULTADO DO PROCESSAMENTO DA SOLICITAO

128

Lote de Evento Processado

d) Correo da lista enumerada dos atributos versao do schemas da carta de correo e eventos. A lista de valores vlidos dos atributos versao dos schema XML da CC-e, ConSitNFe ePL_SRE estavam incorretos e foram corrigidos.

e) Correo da expresso regular dhEvento/dhRegEvento. A expresso regular de validao do dhEvento/dhRegEvento foi corrigida para permitir a informao da hora UTC -4:00.

Pg. 3 / 18

Nota Fiscal eletrnicaManual de Integrao - Contribuinte

Controle de VersesVerso 0.00 1.00 1.01 Data 17/06/2010 SP 20/08/2010 RS/SC/SP 11/05/2011 - 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.

Nota Fiscal eletrnicaManual de Integrao - Contribuinte

4.5

Service NfeConsulta2 Protocolo

Consulta situao atual da NF-eContribuinte Secretaria de Fazenda EstadualWeb Service: NfeConsulta Consulta NF-e Client NFe Retorno nfeConsultaNF

Proc. Ret 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 Ele Raiz A E E E Pai EP01 EP01 EP01 EP01 Tipo Ocor. Tam. Dec. N N C N 1-1 1-1 1-1 1-1 1-4 1 9 44 2 TAG raiz Verso do leiaute Identificao do Ambiente: 1 Produo / 2 - Homologao Servio solicitado CONSULTAR Chave de Acesso da NF-e. Descrio/Observao

EP01 conSitNFe EP02 versao EP03 tpAmb EP04 xServ EP05 chNFe

4.5.2

Leiaute Mensagem de Retorno

Retorno: Estrutura XML contendo a mensagem do resultado da consulta de protocolo: Schema XML: retConsSitNFe_v2.01.xsd# Campo Ele Raiz A E E ER01 ER01 ER01 Pai Tipo Ocor. Tam. Dec. N N C 1-1 1-1 1-1 1-4 1 1-20 2 Descrio/Observao TAG raiz da Resposta 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,

ER01 retConsSitNFe ER02 versao ER03 tpAmb ER04 verAplic

Pg. 5 / 18

Nota Fiscal eletrnicaManual de Integrao - Contribuinte

SVAN ou SVRS nos demais casos. ER05 cStat ER06 xMotivo ER07 cUF EP07a chNFe ER08 protNFe E E E E G ER01 ER01 ER01 ER01 ER01 N C N N xml 1-1 1-1 1-1 1-1 0-1 3 1-255 2 44 Cdigo do status da resposta. Descrio literal do status da resposta. Cdigo da UF que atendeu a solicitao. Chave de Acesso da NF-e consultada. 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). Protocolo de homologao de cancelamento de NF-e (vide item 4.3.2). Informar se localizado uma NF-e com cStat = 101 (cancelado). Informao do evento e respectivo Protocolo de registro de Evento

ER09 retCancNFe

G

ER01

xml

0-1

-

ER10 procEventoNFe

G

ER01

xml

0-N

-

4.5.3

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 TransmissoValidao do Certificado Digital do Transmissor (protocolo SSL)

#

Regra de Validao

Crtica

Msg 280

Efeito Rej.

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. 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 A04 LCR do Certificado de Transmissor - Falta o endereo da LCR (CRL DistributionPoint) - LCR indisponvel - LCR invlida A05 Certificado do Transmissor revogado A06 Certificado Raiz difere da "ICP-Brasil" A07 Falta a extenso de CNPJ no Certificado (OtherName OID=2.16.76.1.3.3) Obrig.

281 283

Rej. Rej.

Obrig.

286

Rej.

Obrig. Obrig. Obrig.

284 285 282

Rej. Rej. 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 sePg. 6 / 18

Nota Fiscal eletrnicaManual 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 ServiceValidao Inicial da Mensagem no Web Service

#

Regra de Validao

Aplic. Obrig. Facult. Obrig. Obrig.

Msg 214 243 108 109

Efeito Rej. Rej. Rej. Rej.

B01 Tamanho do XML de Dados superior a 500 Kbytes B02 XML de Dados Mal Formado B03 Verifica se o Servio est Paralisado Momentaneamente B04 Verifica se o Servio est Paralisado sem Previso

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 ServiceValidao das informaes de controle da chamada ao Web Service

#

Regra de Validao

Aplic. Facult. Obrig. Obrig.

Msg 242 409 410 411 238 239

Efeito Rej. Rej. Rej. Rej. Rej. Rej.

C01 Elemento nfeCabecMsg inexistente no SOAP Header C02 Campo cUF inexistente no elemento nfeCabecMsg do SOAP Header C03 Verificar se a UF informada no campo cUF atendida pelo Web Service

C04 Campo versaoDados inexistente no elemento nfeCabecMsg do SOAP Obrig. Header C05 Verso dos Dados informada superior verso vigente Facult. C06 Verso dos Dados no suportada 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 DadosValidao da Mensagem do Pedido de Consulta de situao de NF-e. # Regra de Validao Aplic. Obrig. Msg Efeito 215 516 Rej. Rej. D01 Verifica Schema XML da rea de Dados

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

Nota Fiscal eletrnicaManual 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. Facul. 517 545 Rej. Rej.

Facul. Facul. Obrig. Obrig.

587 588 404 402

Rej. Rej. Rej. 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 # Regra de Validao Aplic. Obrig. Obrig. Msg 252 226 217 Efeito Rej. Rej. Rej. Rej. J01 Tipo do ambiente da NF-e difere do ambiente do Web Service J02 UF da Chave de Acesso difere da UF do Web Service

J03 Acesso BD NFE (Chave: Ano, CNPJ Emit, Modelo, Srie, Nro): Obrig. - Verificar se NF-e no existe J04 - Verificar se campo Cdigo Numrico informado na Chave de Obrig. Acesso diferente do existente no BD

562 561

J05 - Verificar se campo MM (ms) informado na Chave de Acesso Obrig. diferente do existente no BD

Rej.

4.5.8

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. 8 / 18

Nota Fiscal eletrnicaManual de Integrao - Contribuinte

4.8

Web Service RecepcaoEvento Carta de Correo

Sistema de Registro de EventosEmissor NF-e

WS da FazendaWeb Service :RecepcaoEvento

Envio de Evento da NF-e

Proc. nfeRecepcaoEventoRet

Recepo Aplicao SRE

Cliente SRERetorno

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

Ele Raiz A

Pai HP01

Tipo Ocor. Tam. Dec. N 1-1 1-4 2 TAG raiz

Descrio/Observao Verso do leiaute

HP01 envEvento HP02 versao

Pg. 9 / 18

Nota Fiscal eletrnicaManual de Integrao - Contribuinte

#

Campo

Ele E

Pai HP01

Tipo Ocor. Tam. Dec. N 1-1 1-15

Descrio/Observao 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

HP03 idLote

HP04 evento HP05 versao HP06 infEvento HP07 Id

G A G

HP01 HP04 HP04

xml N C

1-20 1-1 1-1 1-1

1-4 54 2

Verso do leiaute do evento Grupo de informaes do registro do Evento Identificador da TAG a ser assinada, a regra de formao do Id : ID + tpEvento + chave da NF-e + nSeqEvento Cdigo do rgo de recepo do Evento. Utilizar a Tabela do IBGE, utilizar 90 para identificar o Ambiente Nacional. Identificao do Ambiente: 1 - Produo 2 Homologao Informar o CNPJ ou o CPF do autor 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.

ID HP06

HP08 cOrgao HP09 tpAmb

E E

HP06 HP06

N N

1-1 1-1

2 1

HP10 CNPJ HP11 CPF HP12 chNFe HP13 dhEvento

CE HP06 CE HP06 E E HP06 HP06

N N N D

1-1 1-1 1-1 1-1

14 11 44

HP14 tpEvento HP15 nSeqEvento

E E

HP06 HP06

N N

1-1 1-1

6 1-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

HP16 verEvento HP17 detEvento HP18 versao HP19 descEvento HP20 xCorrecao HP20a xCondUso

E G A E E E

HP06 HP06 HP17 HP17 HP17 HP17

N

1-1 1-1 1-1

1-4

C C C

1-1 1-1 1-1

5-60 151000 -

Carta de Correo ou Carta de Correcao Correo a ser considerada, texto livre. A correo mais recente substitui as anteriores. Condies de uso da Carta de Correo, informar a literal : A Carta de Correo disciplinada pelo 1-A do art. 7 do Convnio S/N, de 15 de dezembro de 1970 e pode ser utilizada 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. (texto com acentuao) ou A Carta de Correcao e disciplinada pelo paragrafo 1o-A do art. 7o do Convenio S/N, de 15 de dezembro de 1970 e pode ser utilizada para regularizacao de erro ocorrido na emissao de documento fiscal, desde que o erro nao esteja relacionado com: I - as variaveis que determinam o valor do imposto tais como: base de calculo, aliquota, diferenca de preco, quantidade, valor da operacao ou da prestacao; II - a correcao de dados cadastrais que implique mudanca do remetente ou do destinatario; III - a data de emissao ou de saida. (texto sem acentuao) Assinatura Digital do documento XML, a assinatura dever ser aplicada no elemento infEvento

HP21 Signature

G

HP04 XML

1-1

Pg. 10 / 18

Nota Fiscal eletrnicaManual de Integrao - Contribuinte

#

Campo

Ele G

Pai

Tipo Ocor. Tam. Dec. 1-1

Descrio/Observao Assinatura Digital do documento XML, a assinatura dever ser aplicada no elemento infEvento

HP21 Signature

HP04 XML

4.8.2

Leiaute Mensagem de Retorno

Retorno: Estrutura XML com a mensagem do resultado da transmisso. Schema XML: retEnvCCe_v9.99.xsd# Campo Ele Raiz A E Pai HR01 HR01 Tipo Ocor. Tam. Dec. N N 1-1 1-1 1-4 1-15 2 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 Ambiente Nacional. Cdigo do status da resposta Descrio do status da resposta TAG de grupo do resultado do processamento do Evento 2 Verso do leiaute Grupo de informaes do registro do Evento 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 Identificao do Ambiente: 1 Produo / 2 Homologao Verso da aplicao que registrou o Evento, utilizar literal que permita a identificao do rgo, como a sigla da UF ou do rgo. Cdigo da UF que registrou o Evento. Utilizar 90 para o Ambiente Nacional. Cdigo do status da resposta. Descrio do status da resposta. Chave de Acesso da NF-e vinculada ao evento. Cdigo do Tipo do Evento. Descrio do Evento Carta de Correo registrada 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. Informar o CNPJ ou o CPF do destinatrio da NF-e. 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), 2Pg. 11 / 18

Descrio/Observao TAG raiz do Resultado do Envio do Evento

HR01 retEnvEvento HR02 versao HR03 idLote

HR04 tpAmb HR05 verAplic HR06 cOrgao HR07 cStat HR08 xMotivo HR09 retEvento HR10 versao HR11 infEvento HR12 Id

E E E E E G A G

HR01 HR01 HR01 HR01 HR01 HR01 HR09 HR09

N C N N C N C

1-1 1-1 1-1 1-1 1-1 0-20 1-1 1-1 0-1

1 1-20 2 3 255 1-4

ID HR11

HR13 tpAmb HR14 verAplic

E E

HR11 HR11

N C

1-1 1-1

1 1-20

HR15 cOrgao HR16 cStat HR17 xMotivo HR18 chNFe HR19 tpEvento HR20 xEvento HR21 nSeqEvento

E E E E E E E

HR11 HR11 HR11 HR11 HR11 HR11 HR11

N N C N N C N

1-1 1-1 1-1 0-1 0-1 0-1 0-1

2 3 255 44 6 5-60 1-2

HR22 CNPJDest HR23 CPFDest HR24 emailDest HR25 dhRegEvento

CE HR11 CE HR11 E E HR11 HR11

N N C D

0-1 0-1 0-1 1-1

14 11 1-60

HR26 nProt

E

HR11

N

0-1

Nota Fiscal eletrnicaManual de Integrao - Contribuinte

posies para o cdigo da UF, 2 posies para o ano e 10 posies para o seqencial no ano. HR27 Signature G 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.

4.8.3

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 TransmissoValidao do Certificado Digital do Transmissor (protocolo SSL)

#

Regra de Validao

Crtica Obrig.

Msg 280

Efeito Rej.

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) 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 A04 LCR do Certificado de Transmissor - Falta o endereo da LCR (CRL DistributionPoint) - LCR indisponvel - LCR invlida A05 Certificado do Transmissor revogado A06 Certificado Raiz difere da "ICP-Brasil" A07 Falta a extenso de CNPJ no Certificado (OtherName - OID=2.16.76.1.3.3)

Obrig. Obrig.

281 283

Rej. Rej.

Obrig.

286

Rej.

Obrig. Obrig. Obrig.

284 285 282

Rej. Rej. 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 ServiceValidao Inicial da Mensagem no Web Service

#

Regra de Validao

Aplic. Obrig. Obrig. Obrig.

Msg 214 108 109

Efeito Rej. Rej. Rej.

B01 Tamanho do XML de Dados superior a 500 KB B02 Verifica se o Servidor de Processamento est Paralisado Momentaneamente B03 Verifica se o Servidor de Processamento est Paralisado sem Previso

Pg. 12 / 18

Nota Fiscal eletrnicaManual de Integrao - Contribuinte

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 ServiceValidao das informaes de controle da chamada ao Web Service

#

Regra de Validao

Aplic. Msg Efeito Obrig.Obrig. Obrig.

C01 Elemento nfeCabecMsg inexistente no SOAP HeaderC02 Campo cUF inexistente no elemento nfeCabecMsg do SOAP Header C03 Verificar se a UF informada no campo cUF atendida pelo Web Service

242409 410

Rej.Rej. Rej.

C04 Campo versaoDados inexistente no elemento nfeCabecMsg do SOAP Header C05 Verso dos Dados informada superior verso vigente C06 Verso dos Dados no suportada

Obrig. Facult. Obrig.

411 238 239

Rej. 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 # Regra de Validao Aplic. Obrig. Facul. Facul. Facul. Facul. Facul. Obrig. Obrig. Msg 225 516 517 545 587 588 404 402 Efeito Rej. Rej. Rej. Rej. Rej. Rej. Rej. Rej. D01 Verifica Schema XML da rea de Dados 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 D03 XML utiliza codificao diferente de UTF-8

Pg. 13 / 18

Nota Fiscal eletrnicaManual de Integrao - Contribuinte

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 Aplic. Obrig. Obrig. Obrig. Msg 491 492 493 Efeito Rej. Rej. Rej. D04 Verifica se o tpEvento vlido D05 Verifica se o verEvento vlido D06 Verifica se o detEvento atende o respectivo schema XML

c) Validao do Certificado Digital de Assinatura

Validao do Certificado Digital utilizado na Assinatura Digital do DF-e # Regra de Validao Aplic. Obrig. Msg 290 Efeito Rej. 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) 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 E05 LCR do Certificado de Assinatura: - Falta o endereo da LCR (CRLDistributionPoint) - Erro no acesso a LCR ou LCR inexistente E06 Certificado de Assinatura revogado E07 Certificado Raiz difere da ICP-Brasil

Obrig. Obrig. Obrig.

291 292 293

Rej. Rej. Rej.

Obrig.

296

Rej.

Obrig. Obrig.

294 295

Rej. Rej.

d) Validao da Assinatura Digital

Pg. 14 / 18

Nota Fiscal eletrnicaManual de Integrao - Contribuinte

Validao da Assinatura Digital do DF-e # Regra de Validao Aplic. Obrig. Msg 298 Efeito Rej. 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

Obrig.

297 213

Rej. Rej.

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

e) Validao de regras de negcios do Registro de Evento- parte GeralValidao do Registro de Eventos Regras de Negcios parte Geral # Regra de Validao Aplic. Obrig. Obrig. Obrig. Obrig. Obrig. Obrig. Obrig. Obrig. Obrig. Obrig. Obrig. Obrig. Obrig. Msg 252 250 489 490 572 494 573 574 575 576 577 578 579 Efeito Rej. Rej. Rej. Rej. Rej. Rej. Rej. Rej. Rej. Rej. Rej. Rej. Rej. G01 Tipo do ambiente difere do ambiente do Web Service G02 Cdigo do rgo de recepo do Evento da UF diverge da solicitada G03 CNPJ do autor do evento informado invlido (DV ou zeros) G04 CPF do autor do evento informado invlido (DV ou zeros) 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.

4.8.8

Regras de validao especfica do evento Carta de CorreoValidao do Registro de Eventos Regras de Negcios especfica

#

Regra de Validao

Aplic. Obrig. Obrig. Obrig.

Msg 580 501 594

Efeito Rej. Rej. Rej.

GA01 Verificar se a NF-e est autorizada (no pode estar cancelada nem denegada) GA02 Verificar NF-e autorizada h mais de 30 dias (720) horas GA03 Verificar o sequencial do evento (HP15 - nSeqEvento) valor vlido (1-20)

4.8.9

Final do Processamento do Lote

O processamento do lote pode resultar em: Rejeio do Lote por algum problema que comprometa o processamento do lote;

Pg. 15 / 18

Nota Fiscal eletrnicaManual de Integrao - Contribuinte

Processamento do Lote o lote foi processado (cStat=128), 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.

Pg. 16 / 18

Nota Fiscal eletrnicaManual de Integrao - Contribuinte

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# ZR01 ZR02 ZR03 YR04 YR05 YR06 Campo procEventoNFe versao evento (dados) retEvento (dados) 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) Ele Pai

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. 17 / 18

Nota Fiscal eletrnicaManual de Integrao - Contribuinte

5. Tabela de cdigos de erros e descries de mensagens de errosCDIGO RESULTADO DO PROCESSAMENTO DA SOLICITAO

128 135 136CDIGO

Lote de Evento Processado Evento registrado e vinculado a NF-e Evento registrado, mas no vinculado a NF-eMOTIVOS DE NO ATENDIMENTO DA SOLICITAO

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

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 Rejeio: O nmero de seqencia do evento informado maior que o permitido

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. 18 / 18