Manifesto Eletrnico de Documentos Fiscais

NT 2015/002

Projeto Manifesto Eletrnico de Documentos Fiscais

Web Service de Distribuio de DF-e de

Interesse dos Atores do MDF-e (PF ou PJ)

Verso 1.00b
Maro 2016 *
* Alterao conforme determinao do ENCAT Retirada das chaves de acesso de NF-e, CT-e e
MDF-e do XML retornado pelo servio
 Manifesto Eletrnico de Documentos Fiscais
NT 2015/002

ndice
1. Resumo ................................................................................................................................. 3
2. Arquitetura de Comunicao com Contribuinte........................................................................... 4
1.1.1. Padro de documento XML ..................................................................................................4
1.1.2. Padro de Comunicao ........................................................................................................5
1.1.3. Padro de Certificado Digital ................................................................................................6
1.1.4. Padro de compactao .........................................................................................................6
1.1.5. Padro de mensagens dos Web Services...............................................................................6
1.1.6. Informaes de controle e rea de dados das mensagens .....................................................7
1.1.7. Validao da estrutura XML das Mensagens dos Web Services ..........................................7
Resumo dos Padres Tcnicos ..........................................................................................................7
1.1.8. Resumo dos Padres Tcnicos ..............................................................................................8
3. Web Service MDFeDistribuicaoDFe ....................................................................................... 9
3.1. Leiaute Mensagem de Entrada ................................................................................................ 10
3.2. Leiaute Mensagem de Retorno................................................................................................ 10
3.3. Mensagem de Retorno Compactada......................................................................................... 12
3.4. Descrio do Processo de Distribuio de DF-e de Interesse....................................................... 12
3.5. Processamento da Requisio de Distribuio de Conjunto de DF-e a Partir do NSU Informado
(distNSU) ........................................................................................................................................... 13
3.6. Processamento da Requisio de Distribuio de DF-e Vinculado ao NSU Informado (consNSU) .. 14
3.7. Validao do Certificado de Transmisso................................................................................. 14
3.8. Validao Inicial da Mensagem no Web Service ....................................................................... 14
3.9. Validao das informaes de controle da chamada ao Web Service ........................................... 15
3.10. Validao da rea de Dados................................................................................................... 15
3.11. Recomendaes Para Evitar o Uso Indevido ............................................................................. 16
3.12. Endereo do Web Service ....................................................................................................... 16
4. Tabela de cdigos de erros e descries de mensagens de erros .................................................. 17

Pg. 2 / 17
 Manifesto Eletrnico de Documentos Fiscais
NT 2015/002

1. Resumo

Um dos grandes desafios dos projetos de Documentos Fiscais Eletrnicos prover para os atores
envolvidos nos processos informaes de seu interesse de forma eficiente e confivel.

Esta nota tcnica tem como objetivo a apresentao de um novo Web Service denominado
MDFeDistribuicaoDFe que disponibilizar para os atores do MDF-e informaes e documentos
fiscais eletrnicos de seu interesse. A distribuio ser realizada terceiros informados no contedo
do MDF-e no grupo de pessoas autorizadas a acessar o XML (tag:autXML) e para os proprietrios de
veculo quando o RNTRC do proprietrio for diferente do RNTRC do emitente do MDF-e.

Visando a preservao do sigilo fiscal dos documentos fiscais eletrnicos relacionados no MDF-e no
grupo de documentos originrios (infDoc), este webservice dever manipular o XML retornado
alterando as chaves de acesso de CT-e, NF-e e MDF-e pelo literal
99999999999999999999999999999999999999999999 conforme deciso do ENCAT.

Prazos para entrada em vigncia da Nota Tcnica:

Ambiente de Homologao (ambiente de testes das empresas): 01/04/2016;
Ambiente de Produo: 01/04/2016;

Pg. 3 / 17
 Manifesto Eletrnico de Documentos Fiscais
NT 2015/002

2. Arquitetura de Comunicao com Contribuinte

O Webservice de Distribuio DF-e seguir o padro sncrono de processamento da solicitao,

iniciado pelo aplicativo do contribuinte atravs do envio de uma mensagem com os parmetros
desejados para a pesquisa.

O Web Service sempre devolve uma mensagem de resposta confirmando o recebimento da

solicitao de servio ao aplicativo do contribuinte na mesma conexo.

1.1. Padres Tcnicos

1.1.1. Padro de documento XML

a) Padro de Codificao

A especificao do documento XML adotada a recomendao W3C para XML 1.0, disponvel em
www.w3.org/TR/REC-xml e a codificao dos caracteres ser em UTF-8, assim todos os documentos
XML sero iniciados com a seguinte declarao:

<?xml version="1.0" encoding="UTF-8"?>

OBS1: Lembrando que cada arquivo XML somente poder ter uma nica declarao <?xml
version="1.0" encoding="UTF-8"?>.

b) Declarao namespace

O documento XML dever ter uma nica declarao de namespace no elemento raiz do documento
com o seguinte padro:

<distDFeInt xmlns=http://www.portalfiscal.inf.br/mdfe >

O uso de declarao namespace diferente do padro estabelecido para o Projeto vedado.

c) Prefixo de namespace

No permitida a utilizao de prefixos de namespace. Essa restrio visa otimizar o tamanho do

arquivo XML.

Assim, ao invs da declarao:

<mdfe:distDFeInt xmlns:mdfe=http://www.portalfiscal.inf.br/mdfe dever ser adotada a declarao:

<distDFeInt xmlns =http://www.portalfiscal.inf.br/mdfe >

d) Validao de Schema

Para garantir minimamente a integridade das informaes prestadas e a correta formao dos
arquivos XML, o contribuinte dever submeter a mensagem XML para validao pelo Schema (XSD
XML Schema Definition), disponibilizado pelo Ambiente Autorizador, antes de seu envio.

Pg. 4 / 17
 Manifesto Eletrnico de Documentos Fiscais
NT 2015/002

1.1.2. Padro de Comunicao

O meio fsico de comunicao utilizado ser a Internet, com o uso do protocolo SSL verso 3.0, com
autenticao mtua, que alm de garantir um duto de comunicao seguro na Internet, permite a
identificao do servidor e do cliente atravs de certificados digitais, eliminando a necessidade de
identificao do usurio atravs de nome ou cdigo de usurio e senha.

O modelo de comunicao segue o padro de Web Services definido pelo WS-I Basic Profile.

A troca de mensagens entre os Web Services do Ambiente Autorizador e o aplicativo do contribuinte

ser realizada no padro SOAP verso 1.2, com troca de mensagens XML no padro
Style/Enconding: Document/Literal.

A chamada do Web Service distDFeInt realizada com o envio de uma mensagem XML atravs do
campo mdfeDadosMsg.

A verso do leiaute da mensagem XML contida no campo mdfeDadosMsg e o cdigo da UF

requisitada sero informados nos campos versaoDados e cUF, ambos do tipo string localizados no
elemento mdfeCabecMsg do SOAP header.

Exemplo de uma mensagem requisio padro SOAP:

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Header>
<mdfeCabecMsg xmlns="http://www.portalfiscal.inf.br/mdfe/wsdl/ MDFeDistribuicaoDFe ">
<cUF>string</cUF>
<versaoDados>string</versaoDados>
</mdfeCabecMsg>
</soap12:Header>
<soap12:Body>
<mdfeDadosMsg xmlns="http://www.portalfiscal.inf.br/mdfe/wsdl/ MDFeDistribuicaoDFe ">xml</mdfeDadosMsg>
</soap12:Body>
</soap12:Envelope>

Exemplo de uma mensagem de retorno padro SOAP:

<?xml version="1.0" encoding="utf-8"?>

<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Header>
<mdfeCabecMsg xmlns="http://www.portalfiscal.inf.br/mdfe/wsdl/ MDFeDistribuicaoDFe ">
<cUF>string</cUF>
<versaoDados>string</versaoDados>
</mdfeCabecMsg>
</soap12:Header>
<soap12:Body>
<mdfeDistribuicaoDFeResult
xmlns="http://www.portalfiscal.inf.br/mdfe/wsdl/MdfeRecepcao">xml</mdfeDistribuicaoDFeResult>
</soap12:Body>
</soap12:Envelope>

Pg. 5 / 17
 Manifesto Eletrnico de Documentos Fiscais
NT 2015/002

1.1.3. Padro de Certificado Digital

O certificado digital utilizado no Projeto do MDF-e ser emitido por Autoridade Certificadora
credenciada pela Infraestrutura de Chaves Pblicas Brasileira ICP-Brasil, tipo A1 ou A3, devendo
conter o CNPJ da pessoa jurdica titular do certificado digital no campo otherName OID
=2.16.76.1.3.3.

O certificado digital ser exigido durante a transmisso das mensagens entre o servidor do
contribuinte e o Ambiente Autorizador e dever conter o CNPJ ou CPF do responsvel pela
transmisso das mensagens, devendo ter a extenso Extended Key Usage com permisso de
"Autenticao Cliente".

1.1.4. Padro de compactao

O padro de compactao adotado para o projeto ser o Gzip (GNU zip) que implementado nas
plataformas Java e .NET framework 2.0 (classe System.IO.Compression.GZipStream).

1.1.5. Padro de mensagens dos Web Services

As chamadas dos Web Services disponibilizados pelo Ambiente Autorizador e os respectivos

resultados do processamento so realizadas atravs das mensagens com o seguinte padro:

Padro de Mensagem de chamada/retorno de Web Service

cUF versaoDados Estrutura XML definida na documentao do Web Service

Elemento mdfeCabecMsg (SOAP Header) rea de dados (SOAP Body)

cUF cdigo da UF de origem da mensagem.

versaoDados - verso do leiaute da estrutura XML informado na rea de dados.
rea de Dados estrutura XML varivel definida na documentao do Web Service
acessado.

Codificao do cUF adotada:

Regio Norte Regio Nordeste Regio Sudeste Regio Sul Regio Centro-
Oeste
11-Rondnia 21-Maranho 31-Minas Gerais 41-Paran 50-Mato Grosso do
12-Acre 22-Piau 32-Esprito Santo 42-Santa Catarina Sul
13-Amazonas 23-Cear 33-Rio de Janeiro 43-Rio Grande do Sul 51-Mato Grosso
14-Roraima 24-Rio Grande do Norte 35-So Paulo 52-Gois
15-Par 25-Paraba 53-Distrito Federal
16-Amap 26-Pernambuco
17-Tocantins 27-Alagoas
28-Sergipe
29-Bahia

Pg. 6 / 17
 Manifesto Eletrnico de Documentos Fiscais
NT 2015/002

1.1.6. Informaes de controle e rea de dados das mensagens

As informaes de controle das chamadas dos Web Services so armazenadas no elemento

mdfeCabecMsg do SOAP Header e servem para identificar a UF de origem do emissor e a verso do
leiaute da estrutura XML armazenada na rea de dados da mensagem:

<soap12:Header>
<mdfeCabecMsg xmlns="http://www.portalfiscal.inf.br/mdfe/wsdl/MdfeRecepcao">
<cUF>string</cUF>
<versaoDados>string</versaoDados>
</mdfeCabecMsg>
</soap12:Header>

A informao armazenada na rea de dados um documento XML que deve atender o leiaute
definido na documentao do Web Service acessado:

<soap12:Body>
<mdfeDadosMsg
xmlns="http://www.portalfiscal.inf.br/mdfe/wsdl/MDFeDistribuicaoDFe">xml</mdfeDadosMsg>
</soap12:Body>

1.1.7. Validao da estrutura XML das Mensagens dos Web Services

As informaes so enviadas ou recebidas do Web Service atravs de mensagens no padro XML

definido na documentao descrita nessa Nota Tcnica.

As alteraes de leiaute e da estrutura de dados XML realizadas nas mensagens so controladas

atravs da atribuio de um nmero de verso para a mensagem.

Um Schema XML uma linguagem que define o contedo do documento XML, descrevendo os seus
elementos e a sua organizao, alm de estabelecer regras de preenchimento de contedo e de
obrigatoriedade de cada elemento ou grupo de informao.

A validao da estrutura XML da mensagem realizada por um analisador sinttico (parser) que
verifica se a mensagem atende as definies e regras de seu Schema XML.

Qualquer divergncia da estrutura XML da mensagem em relao ao seu Schema XML provoca um
erro de validao do Schema XML.

A primeira condio para que a mensagem seja validada com sucesso que ela seja submetida ao
Schema XML correto.

Assim, o aplicativo do contribuinte deve estar preparado para gerar as mensagens no leiaute em
vigor, devendo ainda informar a verso do leiaute da estrutura XML da mensagem no campo
versaoDados do elemento mdfeCabecMsg do SOAP Header.

<soap12:Header>
<mdfeCabecMsg xmlns="http://www.portalfiscal.inf.br/mdfe/wsdl/mdfeDistribuicaoDFe">
<cUF>35</cUF>
<versaoDados>1.00</versaoDados>
</mdfeCabecMsg>
</soap12:Header>

Resumo dos Padres Tcnicos

Pg. 7 / 17
 Manifesto Eletrnico de Documentos Fiscais
NT 2015/002

1.1.8. Resumo dos Padres Tcnicos

A tabela a seguir resume os principais padres de tecnologia utilizados:

Caracterstica
Web Services
Meio lgico de comunicao
Meio fsico de comunicao
Protocolo Internet
Padro de troca de mensagens
Padro da mensagem
Padro de certificado digital
Padro de compactao
Descrio
Padro definido pelo WS-I Basic Profile 1.1 (http://www.ws-
i.org/Profiles/BasicProfile-1.1-2004-08-24.html).
Web Services, disponibilizados pelo Portal do Ambiente Autorizador.
Internet
SSL verso 3.0, com autenticao mtua atravs de certificados digitais.
SOAP verso 1.2.
XML no padro Style/Encoding: Document/Literal.
X.509 verso 3, emitido por Autoridade Certificadora credenciada pela
Infra-estrutura de Chaves Pblicas Brasileira ICP-Brasil, do tipo A1 ou
A3, devendo conter o CNPJ ou CPF do proprietrio do certificado digital.
Gzip (GNU zip)

Pg. 8 / 17
 Manifesto Eletrnico de Documentos Fiscais
NT 2015/002

3. Web Service MDFeDistribuicaoDFe

Distribui documentos e informaes de interesse do ator do MDF-e

Ator do MDF-e WS do Ambiente Nacional do MDF-e

Web Service
MDFeDistribuicaoDFe
Consulta DF-e de interesse Req. Distribui
mdfeDistDFeInteresse
documentos
Ret.
Cliente
Aplicao MDF-e

Retorno

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

interesse de um ator, seja este pessoa fsica ou jurdica.

Processo: sncrono

Mtodo: mdfeDistDFeInteresse

Este servio permite que um ator do MDF-e tenha acesso aos documentos fiscais eletrnicos (DF-e)
que no tenham sido gerados por ele e que sejam de seu interesse. Pode ser consumido por
qualquer ator de MDF-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 estaro disponveis para distribuio por at 3 meses aps sua
recepo pelo Ambiente Nacional do MDF-e. Os documentos que sero disponibilizados para
terceiros (informado na tag autXML) seguem a tabela abaixo:

Documento

MDF-e
Evento de Cancelamento
Evento de Encerramento
Evento de Incluso de Condutor

Visando a preservao do sigilo fiscal dos documentos fiscais eletrnicos relacionados no MDF-e no
grupo de documentos originrios (infDoc), este webservice dever manipular o XML retornado
alterando as chaves de acesso de CT-e, NF-e e MDF-e pelo literal
99999999999999999999999999999999999999999999 conforme deciso do ENCAT.

Pg. 9 / 17
 Manifesto Eletrnico de Documentos Fiscais
NT 2015/002

3.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

# Campo Ele Pai Tipo Ocor. Tam. Descrio/Observao

A01 distDFeInt Raiz - - - - TAG raiz
A02 versao A A01 N 1-1 2v2 Verso do leiaute
A03 tpAmb E A01 N 1-1 1 Identificao do Ambiente: 1=Produo /2=Homologao
A04 CNPJ CE A01 N 1-1 14 CNPJ do interessado no DF-e
A05 CPF CE A01 N 1-1 11 CPF do interessado no DF-e
A06 distNSU CG A01 - 1-1 - Grupo para distribuir DF-e de interesse
A07 ultNSU E A06 N 1-1 1-15 ltimo NSU recebido pelo ator.
Caso seja informado com zero, ou com um NSU muito antigo, a
consulta retornar unicamente as informaes de documentos
fiscais eletrnicos que tenham sido recepcionados pelo Ambiente
Nacional nos ltimos 3 meses.
A08 consNSU CG A1 - 1-1 - Grupo para consultar um DF-e a partir de um NSU especfico
A09 NSU E A08 N 1-1 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.

3.2. Leiaute Mensagem de Retorno

Retorno: Estrutura XML com os documentos de interesse do ator (qtde mxima=50).

Schema XML: retDistDFeInt _v9.99.xsd

# Campo Ele Pai Tipo Ocor. Tam. Descrio/Observao

B01 retDistDFeInt Raiz - - - - TAG raiz da Resposta
B02 versao A B01 N 1-1 2v2 Verso do leiaute
B03 tpAmb E B01 N 1-1 1 Identificao do Ambiente: 1=Produo /2=Homologao
B04 verAplic E B01 C 1-1 1-20 Verso do aplicativo que processou a consulta
B05 cStat E B01 N 1-1 3 Cdigo do status da resposta (vide item 5)
B06 xMotivo E B01 C 1-1 1-255 Descrio literal do status da resposta
B07 dhResp E B01 D 1-1 Data e hora da mensagem de Resposta
B08 ultNSU E B01 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.
B09 maxNSU E B01 N 0-1 1-15 Maior NSU existente no Ambiente Nacional para o CNPJ/CPF
informado
B10 loteDistDFeInt G B01 B64 0-1 Conjunto de informaes de documentos fiscais eletrnicos de
interesse da pessoa ou empresa.
B11 docZip G B10 1-50 Informao do documento fiscal eletrnico de interesse da
pessoa ou empresa. O contedo desta tag estar compactado
no padro gZip. O tipo do campo base64Binary.
B12 NSU A B11 N 1-1 1-15 NSU do documento fiscal
B13 schema A B11 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:
- procMDFe_v1.00.xsd
- procEventoMDFe_v1.00.xsd

Pg. 10 / 17
Manifesto Eletrnico de Documentos Fiscais
NT 2015/002

Pg. 11 / 17
 Manifesto Eletrnico de Documentos Fiscais
NT 2015/002

3.3. Mensagem de Retorno Compactada

O tamanho mdio do MDF-e de aproximadamente 10 KB, 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.

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

Este servio pode ser consumido por atores relacionados como autorizados ao XML e por
proprietrios de veculos utilizados em MDF-e quando o RNTRC do proprietrio for diferente do
RNTRC do emitente do manifesto, 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. 12 / 17
 Manifesto Eletrnico de Documentos Fiscais
NT 2015/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.

3.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 dos
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.

O processo de recepo e sincronizao ser realizado em ordem cronolgica de emisso ou

autorizao de uso, uma vez que a gerao do NSU dos documentos ser organizada por ordem
autorizao no 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 realizada atravs de um processo
assncrono na aplicao da SVRS, a empresa ou pessoa conseguir recuperar todos os documentos
de seu interesse to logo estes sejam processados para distribuio pelo Ambiente Nacional do
MDF-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 de
distribuio caso receba a indicao que no existem mais documentos a serem pesquisados na
base de dados do Ambiente Nacional. Se o NSU informado (tag:ultNSU) for igual ao maior NSU do
Ambiente Nacional (tag:maxNSU), ento no existem mais documentos a serem pesquisados no
momento.

Pg. 13 / 17
 Manifesto Eletrnico de Documentos Fiscais
NT 2015/002

3.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 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 mdfeDistDFeInteresse do Web Service MDFeDistribuicaoDFe
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=138-
Documento localizado.

3.7. Validao do Certificado de Transmisso

Validao do Certificado Digital do Transmissor (protocolo SSL)

# Regra de Validao Crtica Msg Efeito
A01 Certificado de Transmissor Invlido: Obrig. 280 Rej.
- 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. 281 Rej.
A03 Verifica a Cadeia de Certificao: Obrig. 283 Rej.
- 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. 286 Rej.
- Falta o endereo da LCR (CRL DistributionPoint)
- 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 (OtherName - OID=2.16.76.1.3.3) ou a extenso Obrig. 287 Rej.
de CPF (OtherName - OID=2.16.76.1.3.1) no Certificado

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.

3.8. Validao Inicial da Mensagem no Web Service

Validao Inicial da Mensagem no Web Service

# Regra de Validao Aplic. Msg Efeito
B01 Tamanho do XML de Dados superior a 10 KB Obrig. 214 Rej.
B02 XML de Dados Mal Formado Obrig. 243 Rej.
B03 Verifica se o Servidor de Processamento est Paralisado Momentaneamente Obrig. 108 Rej.
B04 Verifica se o Servidor de Processamento est Paralisado sem Previso Obrig. 109 Rej.

Pg. 14 / 17
 Manifesto Eletrnico de Documentos Fiscais
NT 2015/002

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

3.9. Validao das informaes de controle da chamada ao Web Service

Validao das informaes de controle da chamada ao Web Service

# Regra de Validao Aplic. Msg Efeito
C01 Elemento mdfeCabecMsg inexistente no SOAP Header Obrig. 242 Rej.
C02 Campo cUF inexistente no elemento mdfeCabecMsg do SOAP Header Obrig. 409 Rej.
C03 Verificar se a UF informada no campo cUF vlida Obrig. 410 Rej.
C04 Campo versaoDados inexistente no elemento mdfeCabecMsg do SOAP Obrig. 411 Rej.
Header
C05 Verso dos Dados informada superior verso vigente Facult. 238 Rej.
C06 Verso dos Dados no suportada Obrig. 239 Rej.

A informao da verso do leiaute do lote e a UF de origem so informados no elemento

mdfeCabecMsg do SOAP Header.

A aplicao dever validar a UF solicitante (cUF) e verso da mensagem (versaoDados), rejeitando

a solicitao recebida em caso de informaes inexistentes ou invlidas.

3.10. Validao da rea de Dados

a) Validao de forma da rea de dados

Validao da rea de dados da mensagem

# Regra de Validao Aplic. Msg Efeito
D01 Verifica Schema XML da rea de Dados Obrig. 215 Rej.
D02 Verifica a existncia de qualquer namespace diverso do namespace padro do Facult. 598 Rej.
MDF-e (http://www.portalfiscal.inf.br/mdfe)
D03 Verifica a existncia de caracteres de edio no incio ou fim da mensagem ou Facult. 599 Rej.
entre as tags
D04 Verifica o uso de prefixo no namespace Obrig. 404 Rej.
D05 XML utiliza codificao diferente de UTF-8 Obrig. 402 Rej.

b) Validao de regras de negcio

Validao das Regras de Negcio

# Regra de Validao Aplic. Msg Efeito
H01 Tipo do ambiente do MDF-e difere do ambiente do Web Service Obrig. 252 Rej.
H02 CNPJ do interessado na distribuio invlido (DV ou zeros) Obrig. 489 Rej.
H03 CPF do interessado na distribuio invlido (DV ou zeros) Obrig. 490 Rej.
CNPJ do Certificado Digital utilizado na transmisso no tem o mesmo CNPJ Obrig. 491 Rej.
H04
base do CNPJ consultado
H05 CPF do Certificado Digital utilizado na transmisso diferente do CPF consultado Obrig. 492 Rej.
H06 Nmero do NSU informado superior ao maior NSU disponvel para consulta Obrig. 493 Rej.

Pg. 15 / 17
 Manifesto Eletrnico de Documentos Fiscais
NT 2015/002

3.11. 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 678Rejeio: Consumo Indevido.

3.12. Endereo do Web Service

O endereo do Web Service de Distribuio do Ambiente Nacional est publicado no Portal do MDF-
e (http://mdfe-portal.sefaz.rs.gov.br), no link Servios / Relao de Servios Web.

Produo:
https://mdfe.svrs.rs.gov.br/WS/MDFeDistribuicaoDFe/MDFeDistribuicaoDFe.asmx

Homologao:
https://mdfe-homologacao.svrs.rs.gov.br/WS/MDFeDistribuicaoDFe/MDFeDistribuicaoDFe.asmx

Pg. 16 / 17
 Manifesto Eletrnico de Documentos Fiscais
NT 2015/002

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

Cdigo RESULTADO DO PROCESSAMENTO DA SOLICITAO

108 Servio Paralisado Momentaneamente (curto prazo)
109 Servio Paralisado sem Previso
137 Nenhum documento localizado
138 Documento localizado
Cdigo MOTIVOS DE NO ATENDIMENTO DA SOLICITAO
214 Rejeio: Tamanho da mensagem excedeu o limite estabelecido
215 Rejeio: Falha no schema XML
238 Rejeio: Cabealho - Verso do arquivo XML superior a Verso vigente
239 Rejeio: Cabealho - Verso do arquivo XML no suportada
242 Rejeio: Cabealho - Falha no Schema XML
252 Rejeio: Ambiente informado diverge do Ambiente de recebimento
280 Rejeio: Certificado Transmissor invlido
281 Rejeio: Certificado Transmissor Data Validade
283 Rejeio: Certificado Transmissor - erro Cadeia de Certificao
284 Rejeio: Certificado Transmissor revogado
285 Rejeio: Certificado Transmissor difere ICP-Brasil
286 Rejeio: Certificado Transmissor erro no acesso a LCR
287 Rejeio: Certificado Transmissor sem CNPJ ou CPF
402 Rejeio: XML da rea de dados com codificao diferente de UTF-8
404 Rejeio: Uso de prefixo de namespace no permitido
409 Rejeio: Campo cUF inexistente no elemento mdfeCabecMsg do SOAP Header
410 Rejeio: UF informada no campo cUF no atendida pelo Web Service
411 Rejeio: Campo versaoDados inexistente no elemento mdfeCabecMsg do SOAP Header
489 Rejeio: CNPJ informado invlido (DV ou zeros)
490 Rejeio: CPF informado invlido (DV ou zeros)
491 Rejeio: CNPJ-Base consultado difere do CNPJ-Base do Certificado Digital
492 Rejeio: CPF consultado difere do CPF do Certificado Digital
493 Rejeio: Nmero do NSU informado superior ao maior NSU da base de dados do Ambiente
Nacional
678 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. 17 / 17