Documente Academic
Documente Profesional
Documente Cultură
Manifestao do Destinatrio
Manifestao do Destinatrio
Verso 1.02
Maro 2012
Nota Fiscal eletrnica
Manifestao do Destinatrio
Controle de Verses
Verso Data
0.00 10/11/2010 SP
0.00a 23/12/2010 Reviso RS
0.00b 26/04/2011 SP
0.00c 15/07/2011 Reviso RS/SP
0.00d 20/07/2011 Reviso RS/SP/SERPRO
0.00e 30/09/2011 Reviso RS/SP
0.00f 24/11/2011 Reviso RS
1.01 24/02/2012 Reviso reunio Empresas do Piloto
1.01a 19/03/2012 Alterao conforme deciso ENCAT
1.02 01/08/2012 Acertos da especificao
Este documento tem por objetivo a definio das especificaes tcnicas necessrias para a
implementao dos eventos da Manifestao do Destinatrio: Confirmao da Operao,
Desconhecimento da Operao e Operao no Realizada.
Faz parte deste documento tambm os novos servios vinculados ao registro destes eventos, com:
Web Service de Consulta da Relao de Documentos Destinados a uma determinada empresa
(NF-e, Cancelamento e Carta de Correo);
Web Service de Download da NF-e para uma determinada Chave de Acesso informada.
Aps a disponibilizao dos novos eventos e dos novos servios no ambiente de produo, o
documento passar a fazer parte do Manual de Integrao do Contribuinte.
Pg. 2 / 24
Nota Fiscal eletrnica
Manifestao do Destinatrio
Retorno
Este servio permite que o destinatrio da Nota Fiscal eletrnica confirme a sua participao na
operao acobertada pela Nota Fiscal eletrnica emitida para o seu CNPJ, atravs do envio da
mensagem de:
Confirmao da operao confirmando a ocorrncia da operao e o recebimento da
mercadoria (para as operaes com circulao de mercadoria);
Desconhecimento da operao declarando o Desconhecimento da Operao;
Operao no Realizada declarando que a Operao no foi Realizada (com Recusa do
Recebimento da mercadoria e outros) e a justificativa porque a operao no se realizou;
Cincia da operao declarando ter cincia da operao destinada ao CNPJ, mas ainda
no possui elementos suficientes para apresentar uma manifestao conclusiva, como as
acima citadas.
O autor do evento o destinatrio da NF-e. A mensagem XML do evento ser assinada com o
certificado digital que tenha o CNPJ-Base (8 primeiras posies do CNPJ) do Destinatrio da NF-
e.
A cincia da operao um evento opcional que pode ser utilizado pelo destinatrio para declarar
que tem cincia da existncia da operao, mas ainda no tem elementos suficientes para
apresentar uma manifestao conclusiva.
Processo: sncrono.
Mtodo: nfeRecepcaoEvento
Pg. 3 / 24
Nota Fiscal eletrnica
Manifestao do Destinatrio
Pg. 4 / 24
Nota Fiscal eletrnica
Manifestao do Destinatrio
Pg. 5 / 24
Nota Fiscal eletrnica
Manifestao do Destinatrio
O WS de Eventos acionado pelo destinatrio da NF-e que deve enviar uma mensagem para
declarar a sua participao na operao.
O processo de Registro de Eventos recebe eventos em uma estrutura de lotes, que pode conter de 1
a 20 eventos.
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 poder ocorrer 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. 6 / 24
Nota Fiscal eletrnica
Manifestao do Destinatrio
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.
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. Msg Efeito
D04 Verifica se o tpEvento vlido Obrig. 491 Rej.
Pg. 7 / 24
Nota Fiscal eletrnica
Manifestao do Destinatrio
Pg. 8 / 24
Nota Fiscal eletrnica
Manifestao do Destinatrio
Se ocorrer a devoluo total ou parcial das mercadorias, alm do procedimento atual de gerao
da Nota Fiscal de devoluo, tambm poder ser comandado o evento da Confirmao da
Operao.
O registro deste evento libera a possibilidade da empresa efetuar o download da NF-e, conforme
especificado no Servio de Download da NF-e Confirmada.
Pg. 9 / 24
Nota Fiscal eletrnica
Manifestao do Destinatrio
O registro deste evento libera tambm a possibilidade da empresa efetuar o download da NF-e,
conforme especificado no Servio de Download das NF-e Confirmadas.
O evento de Cincia da Operao um evento opcional e pode ser evitado, j que normalmente
o destinatrio da NF-e deve possuir o arquivo XML da NF-e enviado e/ou disponibilizado pelo
emitente.
Pg. 10 / 24
Nota Fiscal eletrnica
Manifestao do Destinatrio
Web Service :
NfeConsultaDest
Proc. Consulta NFe
Consulta NF-e Dest nfeConsultaNFDest Destinadas
Ret
Processo: sncrono.
Mtodo: nfeConsultaNFDest
Pg. 11 / 24
Nota Fiscal eletrnica
Manifestao do Destinatrio
Retorno: Estrutura XML com o resumo das NF-e encontradas (qtde mxima=50).
Schema XML: retConsNFeDest _v9.99.xsd
Pg. 12 / 24
Nota Fiscal eletrnica
Manifestao do Destinatrio
Este servio pode ser consumido por destinatrio de NF-e, Pessoa Jurdica, que possua um
certificado digital de PJ com o seu CNPJ base.
Caso o ultNSU seja informado com 0 (zero), o WS far a consulta a partir da primeira nota fiscal
recepcionada h menos de 15 dias ou outro prazo maior que a UF entender conveniente;
IMPORTANTE: O campo ultNSU representa a numerao nica da NF-e dentro do ambiente que
est sendo consultado. Se estiver sendo consultado o AN, este ser o valor do NSU_RFB. Se
tiver sendo consulta uma determinada SEFAZ, este ser o valor do NSU_SEFAZ_XX.
c) Indicador de NF-e
O campo indNFe serve para indicar as notas fiscais que deseja consultar:
0 = todas as Chaves de Acesso do perodo;
1 = somente as Chaves de Acesso sem manifestao final do destinatrio;
2 = somente as Chaves de Acesso sem manifestao final do destinatrio e sem Cincia da
Operao.
d) Indicador do Emissor
O campo indEmi serve para indicar as notas fiscais que deseja consultar:
0 = todos os emitentes;
1 = somente as NF-e emitidas por emissores que no tenham o mesmo CNPJ-Base do
destinatrio.
O WS da SEFAZ acionado pela aplicao cliente do destinatrio que deve enviar uma mensagem
que atenda os padres estabelecidos neste manual.
Pg. 13 / 24
Nota Fiscal eletrnica
Manifestao do Destinatrio
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 da consulta.
A mensagem ser descartada se o tamanho exceder o limite previsto (10 KB). A aplicao da
Secretaria de Fazenda no poder permitir a gerao de mensagem com tamanho superior a 10 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 poder ocorrer 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. 14 / 24
Nota Fiscal eletrnica
Manifestao do Destinatrio
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.
O WS deve gerar lotes com at 50 Resumos de NF-e ou CC-e destinadas ao CNPJ consultado que
tenham o nmero sequencial nico NSU superior ao NSU informado.
Caso o NSU informado seja menor que o primeiro NSU disponvel para consulta, a aplicao da
SEFAZ deve comear a fornecer a relao de Chaves de Acesso a partir do primeiro documento
disponvel para consulta.
O universo de Documentos objeto da consulta conjunto de todas NF-e emitidas no pas para o
CNPJ consultado, respectivos Cancelamentos e Carta de Correo. Assim a SEFAZ que oferecer
este Servio de Consulta dever manter uma base de dados com todas as Notas Fiscais,
Cancelamentos e Carta de Correo que tenham sido emitidas para destinatrios localizados em sua
UF.
Este banco de dados ser populado com as NF-e, Cancelamentos e Cartas de Correo emitidas
pelos emissores da prpria UF e de NF-e, Cancelamentos e Carta de Correo emitidas por
contribuintes localizados em outras UF, sendo necessrio manter o banco de dados sincronizado
com o Ambiente Nacional.
No existe necessidade de banco de dados estar sincronizado em tempo real com todas as notas
fiscais autorizadas. Como a tabela ser organizada por ordem de insero de documentos (NSU), o
destinatrio conseguir consultar todas as NF-e, Cancelamentos e Cartas de Correo que foram
emitidas para o seu CNPJ e foram recepcionadas pela sua SEFAZ.
conveniente manter um controle do primeiro NSU vlido para consulta, ressaltando que deve ser
considerada a data de recebimento no ambiente consultado, que pode ser diferente da data de
autorizao de uso da NF-e ou data de homologao do Cancelamento ou da data de registro da
Carta de Correo.
A empresa dever aguardar um tempo mnimo de 1 hora para efetuar uma nova solicitao de
distribuio, caso receba a indicao que no existem mais documentos a serem pesquisados na
base de dados da SEFAZ (indCont=0).
Pg. 16 / 24
Nota Fiscal eletrnica
Manifestao do Destinatrio
Importante:
Caso uma SEFAZ disponibilize este servio, dever retornar as Chaves de Acesso vinculadas ao CNPJ
solicitado, somente se a UF do Destinatrio da NF-e corresponder ao seu cdigo de UF da SEFAZ. Esta
observao no se aplica para o Ambiente Nacional.
A anlise do comportamento atual das aplicaes das empresas (aplicao cliente) permite
identificar algumas situaes de uso indevido do ambiente de autorizao de Nota Fiscal Eletrnica,
mantidos pelas SEFAZ.
Como exemplo maior do mau uso do ambiente de autorizao, ressalta-se a falta de controle de
algumas aplicaes que entram em loop, consumindo recursos de forma indevida, sobrecarregando
principalmente o canal de comunicao com a Internet.
Para este Web Service de Consulta as operaes destinadas, sero mantidos controles para
identificar as situaes de uso indevido de sucessivas tentativas de busca de registros j
disponibilizados anteriormente.
Recomendado que o banco de dados consultado seja distinto do banco de dados de NF-e
autorizadas para no comprometer o desempenho do Servio de Autorizao da NF-e. Sugerida a
criao de uma tabela com pelo menos as seguintes informaes:
NSU Nmero Sequencial nico, IDENTITY da tabela;
Tipo de documento - NF-e, Cancelamento, Evento de CC-e;
Data recebimento do Documento data de insero da NF-e, Cancelamento ou CC-e na
tabela, ser utilizado para limitar o escopo da consulta no prazo definido;
Identificao do Emitente: UF, CNPJ/CPF, IE; Nome/Razo Social;
Identificao do Destinatrio/Remetente: UF, CNPJ/CPF, IE; Nome/Razo Social;
chNFe Chave de Acesso da NF-e;
Dados da NF-e ou do Cancelamento
o dEmi: Data de emisso da NF-e ou do Cancelamento da NF-e;
o tpNF: Tipo do Documento Fiscal: 0=Entrada; 1=Sada;
o finNFe: Finalidade da NF-e: 1=NF-e Normal; 2=NF-e Complementar; 3=NF-e Ajuste.
o DigestValue: DigestValue da NF-e Autorizada;
o Situao: 1=Autorizada; 2=Cancelada; 3=Denegada;
o Confirmao Destinatrio: 0=no confirmada; 1=confirmada; 2=desconhecida;
3=Operao no Realizada;
o dhRecbto: Data e Hora de autorizao de uso da NF-e pela SEFAZ origem. Idem para a
data de autorizao do Cancelamento;
o vNF: Valor total da NF-e;
Dados da Carta de Correo
o dhEvento: Data de emisso da Carta de Correo;
o tpEvento: Cdigo do de evento = 110110;
o nSeqEvento: Sequencial do evento;
o descEvento: Carta de Correo ou Carta de Correcao;
o xCorrecao: Correo a ser considerada.
o dhRecbto: Data e Hora de autorizao de uso da Carta de Correo;
Pg. 17 / 24
Nota Fiscal eletrnica
Manifestao do Destinatrio
Web Service :
NfeDownloadNF
Proc. Download de NFe
Consulta NF-e Dest nfeDownloadNF Confirmadas
Ret
Funo: Servio de Download da NF-e para uma determinada Chave de Acesso informada, para as
NF-e confirmadas pelo destinatrio.
Processo: sncrono.
Mtodo: nfeDownloadNF
Pg. 18 / 24
Nota Fiscal eletrnica
Manifestao do Destinatrio
Este servio pode ser consumido por qualquer destinatrio Pessoa Jurdica, de NF-e que possua um
certificado digital de PJ com o seu CNPJ base.
O pedido deve informar o CNPJ do destinatrio e uma lista de at 10 chaves de acesso da NF-e.
O pedido de consulta ser enviado por Web Service, sendo necessrio o uso de um certificado digital
de PJ vlido.
O WS da SEFAZ acionado pela aplicao cliente do destinatrio que deve enviar uma mensagem
que atenda os padres estabelecidos neste manual.
Pg. 19 / 24
Nota Fiscal eletrnica
Manifestao do Destinatrio
- LCR indisponvel
- LCR invlida
A05 Certificado do Transmissor revogado 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 da consulta.
A mensagem ser descartada se o tamanho exceder o limite previsto (10 KB). A aplicao da
Secretaria de Fazenda no poder permitir a gerao de mensagem com tamanho superior a 10 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 poder ocorrer 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. 20 / 24
Nota Fiscal eletrnica
Manifestao do Destinatrio
mensagem
D01b Em caso de Falha de Schema, verificar se existe o atributo versao para a tag Facul. 517 Rej.
raiz da mensagem
D01c Em caso de Falha de Schema, verificar se o contedo do atributo versao difere Facul. 545 Rej.
do contedo da versaoDados informado no SOAPHeader
D01d Verifica a existncia de qualquer namespace diverso do namespace padro da Facul. 587 Rej.
NF-e (http://www.portalfiscal.inf.br/nfe)
D01e Verifica a existncia de caracteres de edio no incio ou fim da mensagem ou Facul. 588 Rej.
entre as tags
D02 Verifica o uso de prefixo no namespace Obrig. 404 Rej.
D03 XML utiliza codificao diferente de UTF-8 Obrig. 402 Rej.
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.
O download da NF-e s ser oferecido para pedido apresentado dentro do prazo de 30 dias da
autorizao de uso e que tenha sido objeto de Confirmao da Operao ou Cincia da Operao.
Pg. 21 / 24
Nota Fiscal eletrnica
Manifestao do Destinatrio
<tpAmb>2</tpAmb>
<verAplic>XX_v123</verAplic>
<cStat>631</cStat>
<xMotivo>Rejeio: CNPJ-Base do Destinatrio difere do CNPJ-Base do Certificado Digital</xMotivo>
<dhResp>2011-11-24T10:02:46</dhResp>
</retDownloadNFe >
A anlise do comportamento atual das aplicaes das empresas (aplicao cliente) permite
identificar algumas situaes de uso indevido do ambiente de autorizao de Nota Fiscal Eletrnica,
mantidos pelas SEFAZ.
Como exemplo maior do mau uso do ambiente de autorizao, ressalta-se a falta de controle de
algumas aplicaes que entram em loop, consumindo recursos de forma indevida, sobrecarregando
principalmente o canal de comunicao com a Internet.
Para este Web Service de Download do XML da NF-e, sero mantidos controles para identificar as
situaes de novas tentativas de download de uma NF-e j disponibilizada anteriormente.
Normalmente o destinatrio da NF-e deve possuir o arquivo XML da NF-e enviado e/ou
disponibilizado pelo emitente. Portanto no esperado o download da totalidade das NF-e
destinadas a um determinado CNPJ.
Pg. 22 / 24
Nota Fiscal eletrnica
Manifestao do Destinatrio
OBS.:
1. Recomendado a no utilizao de caracteres especiais ou acentuao nos textos das mensagens
de erro.
2. Recomendado 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. 23 / 24
Nota Fiscal eletrnica
Manifestao do Destinatrio
Os endereos dos Web Services esto publicados no Portal da NF-e, no ambiente nacional
(https://www.nfe.fazenda.gov.br, menu Servios, Relao de Servios Web).
Proposto que a aplicao da empresa que v consumir os novos servios seja projetada da
mesma forma, j que existe a tendncia destes novos servios serem atendidos por poucos
ambientes diferentes.
Em relao a massa de dados para que os testes possam ser efetuados, lembramos que podem
ser geradas NF-e no ambiente de homologao critrio da empresa (NF-e sem valor fiscal). As
NF-e no ambiente de homologao podem ser geradas por aplicativo da prpria empresa, ou
usando o Programa Emissor Pblico, com a mesma finalidade.
Os testes no ambiente de produo, quando liberado este ambiente, por falha da aplicao da
empresa, podem disparar os mecanismos de controle de uso indevido, impedindo, por exemplo,
uma nova Consulta a Relao de Documentos Destinados para documentos que j foram
consultados anteriormente.
Pg. 24 / 24