You are on page 1of 13

Nota Fiscal Eletrnica

Nota Tcnica 2014/002

Projeto Nota Fiscal Eletrnica

Nota Tcnica 2014/002

Web Service de Distribuio de DF-e de


Interesse dos Atores da NF-e (PF ou PJ)

Verso 1.01
Agosto 2014

Nota Fiscal Eletrnica

Nota Tcnica 2014/002

ndice
1.
Resumo
2.
Web Service NFeDistribuicaoDFe
2.1.
Leiaute Mensagem de Entrada
2.2.
Leiaute Mensagem de Retorno
2.3.
Mensagem de Retorno Compactada
2.4.
Descrio do Processo de Distribuio de DF-e de Interesse
2.5.
Processamento da Requisio de Distribuio de Conjunto de DF-e a Partir do NSU Informado (distNSU)
2.6.
Processamento da Requisio de Distribuio de DF-e Vinculado ao NSU Informado (consNSU)
2.7.
Validao do Certificado de Transmisso
2.8.
Validao Inicial da Mensagem no Web Service
2.9.
Validao da rea de Dados
2.10.
Leiautes Resumidos
2.10.1.
Leiaute Resumo da NF-e
2.10.2.
Leiaute Resumo do Evento de NF-e
2.11.
Viso Geral do Modelo de Distribuio
2.12.
Recomendaes Para Evitar o Uso Indevido
2.13.
Endereo do Web Service
3.
Tabela de cdigos de erros e descries de mensagens de erros

Pg. 2 / 13

3
4
5
5
6
6
7
7
8
8
9
9
9
10
10
12
12
13

Nota Fiscal Eletrnica

Nota Tcnica 2014/002

1. Resumo
Um dos grandes desafios do projeto Nota Fiscal Eletrnica prover para os atores envolvidos nos
processos da NF-e informaes de seu interesse de forma eficiente e confivel.
O Web Service de Consulta da Relao de Documentos Destinados (NfeConsultaDest) prov
informaes necessrias para a manifestao do destinatrio da NF-e. Alm de prover informaes
para possibilitar a manifestao do destinatrio, surgem novas necessidades de interesse de outros
atores para as quais ainda no existe um servio disponvel.
Esta nota tcnica tem como objetivo a apresentao de um novo Web Service denominado
NFeDistribuicaoDFe que disponibilizar para os atores da NF-e informaes e documentos
fiscais eletrnicos de seu interesse. A distribuio ser realizada para emitentes, destinatrios,
transportadores e terceiros informados no contedo da NF-e respectivamente no grupo do
Emitente (tag:emit, id:C01), no grupo do Destinatrio (tag:dest, id:E01), no grupo do Transportador
(tag:transporta, id:X03) e no grupo de pessoas autorizadas a acessar o XML (tag:autXML, id:GA01).
Este Web Service possibilitar a descontinuidade, no futuro, do Web Service de Consulta da Relao
de Documentos Destinados (NfeConsultaDest).
Prazos para entrada em vigncia da Nota Tcnica:
Ambiente de Homologao (ambiente de testes das empresas): 15/09/2014;
Ambiente de Produo: 06/10/2014;
Desativao do Web Service NfeConsultaDest: 02/02/15.

Pg. 3 / 13

Nota Fiscal Eletrnica

Nota Tcnica 2014/002

2. Web Service NFeDistribuicaoDFe

Funo: Servio destinado distribuio de informaes resumidas e documentos fiscais eletrnicos


de interesse de um ator, seja este pessoa fsica ou jurdica.
Processo: sncrono
Mtodo: nfeDistDFeInteresse
Este servio permite que um ator da NF-e tenha acesso aos documentos fiscais eletrnicos (DF-e) e
informaes resumidas que no tenham sido gerados por ele e que sejam de seu interesse. Pode ser
consumido por qualquer ator de NF-e, Pessoa Jurdica ou Pessoa Fsica, que possua um certificado
digital de PJ ou PF. No caso de Pessoa Jurdica, a empresa ser autenticada pelo CNPJ base e
poder realizar a consulta com qualquer CNPJ da empresa desde que o CNPJ base consultado seja
o mesmo do certificado digital.
Os documentos fiscais eletrnicos e informaes resumidas estaro disponveis para distribuio
por at 3 meses aps sua recepo pelo Ambiente Nacional da NF-e. A distribuio ocorrer para os
atores que desempenham papis de emitente, destinatrio, transportador e terceiros (informado na
tag autXML) conforme tabela abaixo:
Emitente

Destinatrio1

Transportador2

Terceiros3

NF-e

No

Sim

Sim

Sim

Evento de Cancelamento

No

Sim

Sim

Sim

Evento de Carta de Correo

No

Sim

Sim

Sim

Eventos de Manifestao do Destinatrio

Sim

No

No

Sim

Eventos da Suframa (Vistoria/Internalizao)

Sim

Sim

No

Sim

EPEC

No

Sim

Sim

No

Resumo de NF-e

No

Sim

No

No

Resumo de Eventos CT-e Autorizado/Cancelado

Sim

Sim

Sim

Sim

Resumo de Eventos MDF-e Autorizado/Cancelado

Sim

Sim

Sim

Sim

Documento

Os documentos fiscais e resumos de eventos estaro disponveis somente se o destinatrio se manifestar dando
"Cincia da Operao", Operao no Realizada ou "Confirmao de Operao" para a NF-e. Antes da manifestao do
destinatrio fica disponvel unicamente a estrutura XML de Resumo de NF-e.
2 A NF-e estar disponvel somente para o transportador identificado no grupo X03.
3 A NF-e estar disponvel para terceiros somente cujo CNPJ ou CPF estiver informado na tag autXML.

Pg. 4 / 13

Nota Fiscal Eletrnica

Nota Tcnica 2014/002

2.1. Leiaute Mensagem de Entrada


Entrada: Estrutura XML com o pedido de distribuio de DF-e de interesse do ator
Schema XML: distDFeInt_v9.99.xsd
#
A01
A02
A03
A04
A05
A06
A07
A08

Campo
distDFeInt
versao
tpAmb
cUFAutor
CNPJ
CPF
distNSU
ultNSU

A09 consNSU
A10 NSU

Ele
A
E
E
CE
CE
CG
E

Pai
A01
A01
A01
A01
A01
A01
A07

CG
E

A1
A09

Raiz

Tipo Ocor. Tam.


N
1-1
2v2
N
1-1
1
N
1-1
2
N
1-1
14
N
1-1
11
1-1
N
1-1 1-15

1-1
1-1

Descrio/Observao
TAG raiz
Verso do leiaute
Identificao do Ambiente: 1=Produo /2=Homologao
Cdigo da UF do Autor
CNPJ do interessado no DF-e
CPF do interessado no DF-e
Grupo para distribuir DF-e de interesse
ltimo NSU recebido pelo ator.
Caso seja informado com zero, ou com um NSU muito antigo,
a consulta retornar unicamente as informaes resumidas e
documentos fiscais eletrnicos que tenham sido recepcionados
pelo Ambiente Nacional nos ltimos 3 meses.
Grupo para consultar um DF-e a partir de um NSU especfico
1-15 Nmero Sequencial nico. Geralmente esta consulta ser
utilizada quando identificado pelo interessado um NSU faltante.
O Web Service retornar o documento ou informar que o NSU
no existe no Ambiente Nacional. Assim, esta consulta fechar a
lacuna do NSU identificado como faltante.

2.2. Leiaute Mensagem de Retorno


Retorno: Estrutura XML com os documentos de interesse do ator (qtde mxima=50).
Schema XML: retDistDFeInt _v9.99.xsd
#
B01
B02
B03
B04
B05
B06
B07
B08

Campo
retDistDFeInt
versao
tpAmb
verAplic
cStat
xMotivo
dhResp
ultNSU

Ele
A
E
E
E
E
E
E

Pai
B01
B01
B01
B01
B01
B01
B01

B09 maxNSU

B01

B10 loteDistDFeInt

B01

B11 docZip

B10

B12 NSU
B13 schema

A
A

B11
B11

Raiz

Tipo Ocor. Tam.


Descrio/Observao
TAG raiz da Resposta
N
1-1
2v2 Verso do leiaute
N
1-1
1 Identificao do Ambiente: 1=Produo /2=Homologao
C
1-1 1-20 Verso do aplicativo que processou a consulta
N
1-1
3 Cdigo do status da resposta (vide item 5)
C
1-1 1-255 Descrio literal do status da resposta
D
1-1
Data e hora da mensagem de Resposta
N
0-1 1-15 ltimo NSU pesquisado no Ambiente Nacional. Se for o caso,
o solicitante pode continuar a consulta a partir deste NSU para
obter novos resultados.
N
0-1 1-15 Maior NSU existente no Ambiente Nacional para o CNPJ/CPF
informado
B64 0-1
Conjunto de informaes resumidas e documentos fiscais
eletrnicos de interesse da pessoa ou empresa.
1-50
Informao resumida ou documento fiscal eletrnico de
interesse da pessoa ou empresa. O contedo desta tag estar
compactado no padro gZip. O tipo do campo base64Binary.
N
1-1 1-15 NSU do documento fiscal
C
1-1
Identificao do Schema XML que ser utilizado para validar o
XML existente no campo seguinte.
Vai identificar o tipo do documento e sua verso.
Exemplos:
- resNFe_v1.00.xsd
- procNFe_v3.10.xsd
- resEvento_1.00.xsd
- procEventoNFe_v1.00.xsd

Pg. 5 / 13

Nota Fiscal Eletrnica

Nota Tcnica 2014/002

2.3. Mensagem de Retorno Compactada


O tamanho mdio da NF-e de aproximadamente 10 KB (dependendo da quantidade de itens),
necessitando de um dimensionamento correto da rede interna e do canal de Internet das empresas e
do Ambiente Nacional.
Para minimizar necessidades de infraestrutura de rede cada documento contido na mensagem
de retorno da solicitao ser compactado (tag:docZip). Estima-se que a compactao reduzir o
tamanho da mensagem de retorno em aproximadamente 60%.
A aplicao do Ambiente Nacional ir compactar individualmente cada documento da mensagem de
retorno e a aplicao cliente dever descompact-lo e seguir o procedimento normal do tratamento
do documento descompactado.
O padro de compactao adotado para o projeto ser o Gzip (GNU zip) que implementado nas
plataformas Java e .NET.

2.4. Descrio do Processo de Distribuio de DF-e de Interesse


Este servio pode ser consumido por atores que desempenham papel na NF-e de emitente,
destinatrio, transportador ou terceiro, Pessoa Fsica ou Jurdica, que possua um certificado digital
de PF com seu CPF ou PJ com seu CNPJ.
O Ambiente Nacional gera um nmero sequencial nico (NSU) para cada interessado nos
documentos fiscais. Os documentos recuperados devero conter uma sequncia de numerao sem
intervalos em sua base de dados.
a) Gerao do pedido de distribuio
O XML do pedido de distribuio suporta dois tipos de consultas que so definidas de acordo com a
tag informada no XML. As tags so distNSU e consNSU.
a.1) distNSU Distribuio de Conjunto de DF-e a Partir do NSU Informado
A aplicao cliente do WS deve informar o ltimo nmero sequencial nico (ultNSU) que possui.
Caso o NSU informado seja menor que o primeiro NSU disponvel para distribuio, a aplicao do
Ambiente Nacional dever fornecer os documentos a partir do primeiro disponvel para consulta.
a.2) consNSU Distribuio de DF-e Vinculado ao NSU Informado
Este processo de consulta DF-e a partir de um NSU permite que o interessado nos documentos
fiscais consulte de maneira pontual um NSU que foi identificado como faltante em sua base de
dados.
A aplicao cliente do WS deve informar o nmero sequencial nico (NSU) identificado como faltante
em sua base de dados.
b) CNPJ ou CPF do interessado no DF-e
Informar o CPF da pessoa ou CNPJ da empresa para recuperao de DF-e de seu interesse.
Este campo possibilita que uma empresa consiga recuperar os DF-e de qualquer um de seus
estabelecimentos utilizando somente um certificado digital PJ.

Pg. 6 / 13

Nota Fiscal Eletrnica

Nota Tcnica 2014/002

c) Envio das informaes


O pedido de distribuio ser enviado por Web Service, sendo necessrio o uso de um certificado
digital de PJ ou PF vlido.
O WS do Ambiente Nacional acionado pela aplicao cliente do interessado que deve enviar uma
mensagem que atenda os padres estabelecidos neste manual.

2.5. Processamento da Requisio de Distribuio de Conjunto de DF-e a Partir do


NSU Informado (distNSU)
O Web Service dever gerar lotes com at 50 documentos ao interessado com informaes
resumidas ou documentos fiscais eletrnicos que tenham o nmero sequencial nico (NSU) superior
ao NSU informado.
Caso o NSU informado seja menor que o primeiro NSU disponvel para distribuio, a aplicao do
Ambiente Nacional dever fornecer os documentos a partir do primeiro disponvel para consulta.
A criao do lote de documentos dever observar as seguintes regras:
Ordem crescente de NSU
O lote poder conter qualquer tipo de documento vlido e seu respectivo NSU
Quantidade mxima de documentos no lote: 50 documentos
Documentos emitidos pela prpria empresa no estaro disponveis para consulta.
Importante ressaltar que o processo de recepo e sincronizao no ser realizado em ordem
cronolgica de emisso ou autorizao de uso, uma vez que a gerao do NSU dos documentos
ser organizada por ordem cronolgica de recepo pelo Ambiente Nacional.
No existe necessidade de o Ambiente Nacional estar sincronizado em tempo real com todos os
documentos fiscais autorizados. Como a gerao do NSU ser organizada por ordem de insero de
documentos, a empresa ou pessoa conseguir recuperar todos os documentos de seu interesse to
logo estes sejam recebidos pelo Ambiente Nacional da NF-e.
conveniente manter um controle do primeiro NSU vlido para consulta.
A resposta do WS do Ambiente Nacional poder ser:
Rejeio - com a devoluo da mensagem com o motivo da falha informado no cStat;
Nenhum documento localizado no existe documentos fiscais para o CNPJ/CPF
informado cStat=137-Nenhum documento localizado;
Documento localizado com a devoluo dos documentos fiscais encontrados
cStat=138-Documento localizado.
A empresa dever aguardar um tempo mnimo de uma hora para efetuar uma nova solicitao
distribuio caso receba a indicao que no existem mais documentos a serem pesquisados
base de dados do Ambiente Nacional. Se o NSU informado (tag:ultNSU) for igual ao maior NSU
Ambiente Nacional (tag:maxNSU), ento no existem mais documentos a serem pesquisados
momento.

de
na
do
no

2.6. Processamento da Requisio de Distribuio de DF-e Vinculado ao NSU


Informado (consNSU)
Considerando que o Ambiente Nacional gera NSU sem lacunas, o processo de distribuio de
conjunto de DF-e a partir do NSU informado (tag:distNSU) disponibiliza para o interessado
Pg. 7 / 13

Nota Fiscal Eletrnica

Nota Tcnica 2014/002

uma sequncia de numerao ordenada de forma ascendente. A identificao de alguma lacuna


na base de dados do interessado indica que houve alguma falha no processo de distribuio dos
documentos.
Neste caso, o interessado deve consultar pontualmente os NSU identificados como faltantes em
sua base de dados atravs do mtodo nfeDistDFeInteresse do Web Service NFeDistribuicaoDFe
informando o NSU desejado no contedo da tag consNSU no XML de requisio.
A resposta do WS poder ser:
Rejeio - com a devoluo da mensagem com o motivo da falha informado no cStat;
Nenhum documento localizado indicando que o Ambiente Nacional no gerou o NSU e o
interessado deve desconsider-lo cStat=137-Nenhum documento localizado;
Documento localizado com a devoluo do documento fiscal encontrado cStat=138Documento localizado.

2.7. Validao do Certificado de Transmisso


Validao do Certificado Digital do Transmissor (protocolo SSL)
# Regra de Validao
Crtica
A01 Certificado de Transmissor Invlido:
Obrig.
- 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.
A03 Verifica a Cadeia de Certificao:
Obrig.
- Certificado da AC emissora no cadastrado no Ambiente Nacional
- Certificado de AC revogado
- Certificado no assinado pela AC emissora do Certificado
A04 LCR do Certificado de Transmissor
Obrig.
- Falta o endereo da LCR (CRL DistributionPoint)
- LCR indisponvel
- LCR invlida
A05 Certificado do Transmissor revogado
Obrig.
A06 Certificado Raiz difere da "ICP-Brasil"
Obrig.
A07 Falta a extenso de CNPJ (OtherName - OID=2.16.76.1.3.3) ou a extenso Obrig.
de CPF (OtherName - OID=2.16.76.1.3.1) no Certificado

Msg
280

Efeito
Rej.

281
283

Rej.
Rej.

286

Rej.

284
285
473

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 da consulta.

2.8. Validao Inicial da Mensagem no Web Service

#
B01
B02
B03

Validao Inicial da Mensagem no Web Service


Regra de Validao
Tamanho do XML de Dados superior a 10 KB
Verifica se o Servidor de Processamento est Paralisado Momentaneamente
Verifica se o Servidor de Processamento est Paralisado sem Previso

Aplic.
Obrig.
Obrig.
Obrig.

Msg
214
108
109

Efeito
Rej.
Rej.
Rej.

A mensagem ser descartada se o tamanho exceder o limite previsto (10 KB). A aplicao do
Ambiente Nacional no poder permitir a recepo 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
Pg. 8 / 13

Nota Fiscal Eletrnica

Nota Tcnica 2014/002

devoluo da mensagem de erro 214.


Caso o Web Service fique disponvel em ocasio que o servio estiver paralisado, devero ser
implementadas as verificaes 108 e 109. Estas validaes podero ser dispensadas se o Web
Service no ficar disponvel quando o servio estiver paralisado.

2.9. Validao da rea de Dados


a) Validao de forma da rea de dados
#
D01
D02
D03
D04
D05

Validao da rea de dados da mensagem


Regra de Validao
Verifica Schema XML da rea de Dados
Verifica o uso de prefixo no namespace
XML utiliza codificao diferente de UTF-8
Verso dos Dados informada superior verso vigente
Verso dos Dados no suportada

Aplic.
Obrig.
Obrig.
Obrig.
Facult.
Obrig.

Msg Efeito
215
Rej.
404
Rej.
402
Rej.
238
Rej.
239
Rej.

b) Validao de regras de negcio


Validao das Regras de Negcio
Regra de Validao
Tipo do ambiente da NF-e difere do ambiente do Web Service
CNPJ do interessado na distribuio invlido (DV ou zeros)
CPF do interessado na distribuio invlido (DV ou zeros)
CNPJ do Certificado Digital utilizado na transmisso no tem o mesmo CNPJ
H04
base do CNPJ consultado
H05 CPF do Certificado Digital utilizado na transmisso diferente do CPF consultado
H06 Nmero do NSU informado superior ao maior NSU disponvel para consulta
#
H01
H02
H03

Aplic. Msg Efeito


Obrig. 252 Rej.
Obrig. 489 Rej.
Obrig. 490 Rej.
Obrig. 593 Rej.
Obrig.
Obrig.

472
589

Rej.
Rej.

2.10. Leiautes Resumidos


Para possibilitar o compartilhamento de informaes relevantes para o ator de forma a manter o
sigilo da informao, foram criados dois novos leiautes contendo informaes resumidas das NF-e e
informaes resumidas dos eventos.

2.10.1. Leiaute Resumo da NF-e


Descrio: Estrutura XML gerada pelo Ambiente Nacional com o conjunto de informaes resumidas
da NF-e. Este documento ser distribudo para os destinatrios possibilitando sua manifestao na
operao acobertada pela Nota Fiscal eletrnica emitida para o seu CNPJ.
Schema XML: resNFe_v9.99.xsd
C01 resNFe

A
E
CE
CE
E
E

C01
C01
C01
C01
C01
C01

N
N
N
N
C
C

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

2v2
44
14
11
3-60
0 ou
2-14

C08 dhEmi

C01

1-1

C09 tpNF
C10 vNF
C11 digVal

E
E
E

C01
C01
C01

N
N
C

1-1
1-1
1-1

C02
C03
C04
C05
C06
C07

versao
chNFe
CNPJ
CPF
xNome
IE

1
13,2
28

TAG raz com o conjunto de informaes resumidas da NF-e.


Este conjunto de informao ser gerado quando a NF-e for
autorizada ou denegada.
Verso do leiaute
Chave de acesso da NF-e
CNPJ do Emitente
CPF do Emitente
Razo Social ou Nome do Emitente
IE do Emitente. Valores vlidos: vazio (no contribuinte do
ICMS), ISENTO (contribuinte do ICMS ISENTO de Inscrio no
Cadastro de Contribuintes) ou IE (Contribuinte do ICMS)
Data de Emisso da NF-e no formato UTC (Universal
Coordinated Time): AAAA-MM-DDThh:mm:ssTZD.
Tipo de Operao da NF-e: 0=Entrada; 1=Sada
Valor Total da NF-e
Digest Value da NF-e na base de dados do Ambiente Nacional

Pg. 9 / 13

Nota Fiscal Eletrnica


C12 dhRecbto
C12 nProt
C13 cSitNFe

E
E
E

C01
C01
C01

Nota Tcnica 2014/002

D
N
N

1-1
1-1
1-1

15
1

Data de autorizao da NF-e


Nmero de protocolo da NF-e
Situao da NF-e: 1=Uso autorizado; 2=Uso denegado.

2.10.2. Leiaute Resumo do Evento de NF-e


Descrio: Estrutura XML gerada pelo Ambiente Nacional com o conjunto de informaes resumidas
de um evento de NF-e.
Schema XML: resEvento_v9.99.xsd
#
Campo
D01 resEvento
D02 versao
D03 cOrgao
D04
D05
D06
D07

CNPJ
CPF
chNFe
dhEvento

D08
D09
D10
D11
D12

tpEvento
nSeqEvento
xEvento
dhRecbto
nProt

Ele
Raiz
A
E

Pai
D01
D01

CE
CE
E
E

C01
C01
D01
D01

E
E
E
E
E

D01
D01
D01
D01
D01

Tipo Ocor. Tam.


Descrio/Observao
TAG raiz
N
1-1
2v2 Verso do leiaute
N
1-1
2 Cdigo do rgo de recepo do Evento.
Utilizar 91 para identificar o Ambiente Nacional.
N
1-1
14 CNPJ do Emitente
N
1-1
11 CPF do Emitente
N
1-1
44 Chave de acesso da NF-e
D
1-1
Data e hora do evento no formato AAAA-MM-DDThh:mm:ssTZD
(UTC - Universal Coordinated Time)
N
1-1
6 Cdigo do evento
N
1-1
1-2 Nmero sequencial do evento
C
1-1 5-60 Descrio do evento
D
1-1
Data de autorizao do evento
N
1-1
15 Nmero de protocolo do evento

2.11. Viso Geral do Modelo de Distribuio


O modelo de distribuio de documentos baseado na gerao de um nmero sequencial nico
(NSU) para cada CNPJ ou CPF. O fluxo abaixo exemplifica a gerao do NSU para o emitente e
destinatrio da NF-e:

Pg. 10 / 13

Nota Fiscal Eletrnica

Nota Tcnica 2014/002

A consulta no Web Service NFeDistribuicaoDFe poder ser realizada a qualquer instante pela
empresa ou pessoa. O Ambiente Nacional disponibilizar para consulta os documentos de interesse
de cada ator. Seguem os passos do fluxo exemplificado:
1. O emitente gera e transmite uma NF-e que ser autorizada pela Sefaz e compartilhada com o
Ambiente Nacional;
2. O Ambiente Nacional gera um NSU para o destinatrio do resumo da NF-e e o disponibiliza
para consulta;
3. O destinatrio consulta o WS NFeDistribuicaoDFe a partir do ltimo NSU recebido e recupera
o resumo da NF-e;
4. O destinatrio, de posse do resumo da NF-e, gera um evento de NF-e (Ex. evento de
manifestao do destinatrio);
5. O Ambiente Nacional gera um NSU do evento gerado pelo destinatrio para o emitente e o
disponibiliza para consulta;
6. Caso seja um evento de manifestao do destinatrio diferente do tipo desconhecimento da
operao, o Ambiente Nacional gera um NSU para o destinatrio com a NF-e (liberao do
download);
7. O emitente consulta o WS NFeDistribuicaoDFe a partir do ltimo NSU recebido e recupera o
evento gerado pelo destinatrio;
8. O destinatrio consulta o WS NFeDistribuicaoDFe a partir do ltimo NSU recebido e recupera
a NF-e;
9. O emitente gera um evento de sua NF-e (ex.: evento de cancelamento de NF-e, caso no
exista outro evento que impea este cancelamento) que ser compartilhado pela Sefaz com o
Ambiente Nacional;
10. O Ambiente Nacional gera um NSU para o destinatrio do evento gerado pelo emitente e o
disponibiliza para consulta;
11. O destinatrio consulta o WS NFeDistribuicaoDFe a partir do ltimo NSU recebido e recupera
o evento gerado pelo emitente;
12. O Ambiente Nacional recebe um evento gerado pelo fisco e gera um NSU para o emitente e
outro NSU para o destinatrio, disponibilizando-os para consulta;
13. Tanto o emitente quanto o destinatrio consultam o WS NFeDistribuicaoDFe a partir do ltimo
NSU recebido e recuperam o evento gerado pelo fisco;
O fluxo exemplificado resulta nos seguintes NSU para emitente e destinatrio:
NSU Emitente

Documento

Evento do Destinatrio

Evento do Fisco

NSU Destinatrio

Documento

Resumo da NF-e

NF-e

Evento do Emitente

Evento do Fisco

Este novo modelo permitir ao emitente a consulta dos eventos manifestados pelos destinatrios de
suas NF-e. Tambm ser disponibilizado para o destinatrio da NF-e qualquer evento gerado pelo
emitente. Alm disso, os eventos gerados pelo fisco sero disponibilizados tanto para o emitente
quanto para o destinatrio da NF-e.
O modelo simplifica o processo de download da NF-e uma vez que a partir da manifestao do
destinatrio o Ambiente Nacional gera automaticamente um NSU referenciando a NF-e e permitindo
sua recuperao a partir do WS NFeDistribuicaoDFe.

Pg. 11 / 13

Nota Fiscal Eletrnica

Nota Tcnica 2014/002

2.12. Recomendaes Para Evitar o Uso Indevido


A anlise do comportamento atual das aplicaes das empresas (aplicao cliente) permite
identificar algumas situaes de uso indevido nos ambientes autorizadores.
Como exemplo maior do mau uso do ambiente, 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 sero mantidos controles para identificar as situaes de uso indevido de
sucessivas tentativas de busca de registros j disponibilizados anteriormente.
As novas tentativas sero rejeitadas com o erro 656Rejeio: Consumo Indevido.

2.13. Endereo do Web Service


O endereo do Web Service de Distribuio do Ambiente Nacional est publicado no Portal da NF-e
(http://www.nfe.fazenda.gov.br/portal), no link Servios / Relao de Servios Web.
Idem para o ambiente de homologao, no Portal de Homologao (http://hom.nfe.fazenda.gov.br/
portal)

Pg. 12 / 13

Nota Fiscal Eletrnica

Nota Tcnica 2014/002

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


Cdigo
108
109
137
138
Cdigo
214
215
238
239
242
252
280
281
283
284
285
286
402
404
409
410
411
472
473
489
490
589
593
656

RESULTADO DO PROCESSAMENTO DA SOLICITAO


Servio Paralisado Momentaneamente (curto prazo)
Servio Paralisado sem Previso
Nenhum documento localizado
Documento localizado
MOTIVOS DE NO ATENDIMENTO DA SOLICITAO
Rejeio: Tamanho da mensagem excedeu o limite estabelecido
Rejeio: Falha no schema XML
Rejeio: Cabealho - Verso do arquivo XML superior a Verso vigente
Rejeio: Cabealho - Verso do arquivo XML no suportada
Rejeio: Cabealho - Falha no Schema XML
Rejeio: Ambiente informado diverge do Ambiente de recebimento
Rejeio: Certificado Transmissor invlido
Rejeio: Certificado Transmissor Data Validade
Rejeio: Certificado Transmissor - erro Cadeia de Certificao
Rejeio: Certificado Transmissor revogado
Rejeio: Certificado Transmissor difere ICP-Brasil
Rejeio: Certificado Transmissor erro no acesso a LCR
Rejeio: XML da rea de dados com codificao diferente de UTF-8
Rejeio: Uso de prefixo de namespace no permitido
Rejeio: Campo cUF inexistente no elemento nfeCabecMsg do SOAP Header
Rejeio: UF informada no campo cUF no atendida pelo Web Service
Rejeio: Campo versaoDados inexistente no elemento nfeCabecMsg do SOAP Header
Rejeio: CPF consultado difere do CPF do Certificado Digital
Rejeio: Certificado Transmissor sem CNPJ ou CPF
Rejeio: CNPJ informado invlido (DV ou zeros)
Rejeio: CPF informado invlido (DV ou zeros)
Rejeio: Nmero do NSU informado superior ao maior NSU da base de dados do Ambiente
Nacional
Rejeio: CNPJ-Base consultado difere do CNPJ-Base do Certificado Digital
Rejeio: Consumo Indevido

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