Manuais:UniNFe/CTeDistribuicaoDFe

Consulta da relação de documentos fiscais eletrônicos destinados

A SEFAZ disponibilizou um serviço que nos permite consultar os DF-e emitidos que são destinados para o nosso CNPJ/CPF, fornecendo informações resumidas de nosso interesse.

Enviando o arquivo no formato XML

Para enviar o XML de consulta dos DF-e, basta gerar o XML com o nome no seguinte formato:

CNPJ-con-dist-dfecte.xml ou CPF-con-dist-dfecte.xml

CNPJ ou CPF	CNPJ ou CPF de quem está efetuando a consulta
-con-dist-dfecte.xml	Conteúdo fixo. Sempre será "-con-dist-dfecte.xml"

Exemplo: 99999999999999-con-dist-dfecte.xml

O nome do arquivo de retorno é o mesmo do envio, mudando somente a extensão (final) do mesmo, conforme abaixo:

99999999999999-dist-dfecte.xml (se tudo ocorreu bem)

ou

99999999999999-dist-dfecte.err (se houve algum erro)

Como tratar a tag ultNSU e maxNSU

1. Ao efetuar a primeira consulta, o conteúdo da tag ultNSU deve ser igual a zero.
   1. Exemplo: 0
2. Quando obter o retorno da primeira consulta (arquivo com nome -dist-dfecte.xml) o ERP deve ler o conteúdo da tag ultNSU e guarda-lo para ser utilizado na próxima consulta. Deve também analisar o conteúdo da tag maxNSU, se o conteúdo desta tag for diferente da ultNSU, o ERP deve gerar uma nova consulta, e assim sucessivamente até que o conteúdo dela seja igual ao da ultNSU.
3. Reforçamos que a cada nova consulta o conteúdo da tag ultNSU deve ser sempre o obtido no retorno da consulta anterior.
4. Não gere nova consulta se o conteúdo da ultNSU for igual ao maxNSU para evitar o consumo indevido dos serviços da SEFAZ. Aguarde pelo menos uma hora antes de enviar uma nova consulta.
5. Quando o conteúdo da tag maxNSU for igual a ultNSU, só efetue nova consulta após 1 hora.

Exemplo do XML de envio

Consultar os DF-e de um CPF a partir do último NSU obtido:

<?xml version="1.0" encoding="utf-8"?>
<distDFeInt versao="1.00" xmlns="http://www.portalfiscal.inf.br/cte">
  <tpAmb>2</tpAmb>
  <cUFAutor>35</cUFAutor>
  <CPF>99999999999</CPF>
  <distNSU>
    <ultNSU>123456789012345</ultNSU>
  </distNSU>
</distDFeInt>

Consultar os DF-e de um CNPJ a partir do último NSU obtido:

<?xml version="1.0" encoding="utf-8"?>
<distDFeInt versao="1.00" xmlns="http://www.portalfiscal.inf.br/cte">
  <tpAmb>1</tpAmb>
  <cUFAutor>35</cUFAutor>
  <CNPJ>99999999999999</CNPJ>
  <distNSU>
    <ultNSU>123456789012345</ultNSU>
  </distNSU>
</distDFeInt>

Consultar os DF-e de um CNPJ de um NSU específico:

<?xml version="1.0" encoding="utf-8"?>
<distDFeInt versao="1.00" xmlns="http://www.portalfiscal.inf.br/cte">
  <tpAmb>2</tpAmb>
  <cUFAutor>35</cUFAutor>
  <CNPJ>99999999999999</CNPJ>
  <consNSU>
    <NSU>123456789012345</NSU>
  </consNSU>
</distDFeInt>

Exemplo do XML de retorno

<?xml version="1.0" encoding="utf-8"?>
<retDistDFeInt versao="1.00" xmlns="http://www.portalfiscal.inf.br/cte">
  <tpAmb>2</tpAmb>
  <verAplic>1.0.0_1701300911</verAplic>
  <cStat>138</cStat>
  <xMotivo>documento localizado.</xMotivo>
  <dhResp>2017-01-30T09:11:21-02:00</dhResp>
  <ultNSU>000000000000005</ultNSU>
  <maxNSU>000000000000005</maxNSU>
  <loteDistDFeInt>
    <docZip NSU="000000000000151" schema="procEventoCTe_v3.00.xsd">H4sIAAA...</docZip>
    <docZip NSU="000000000000152" schema="procCTe_v2.00.xsd">H4sIAAAAAA...</docZip>
    <docZip NSU="000000000000153" schema="procEventoCTe_v3.00.xsd">H4sIAAA...</docZip>
    <docZip NSU="000000000000154" schema="procCTe_v2.00.xsd">H4sIAAAAAA...</docZip>
    ...
    ...
    ...
  </loteDistDFeInt>
</retDistDFeInt>

Observações sobre o arquivo de retorno:

Os conteúdos das tags docZip é descompactado pelo UniNFe e disponibilizado na subpasta DFe que fica dentro da pasta de retorno (pasta configurada no UniNfe). Nesta pasta são gravados os XMLs de eventos, de distribuição dos CTe´s entre outros.