105
edições
Mudanças
Created page with "==Consulta da relação de documentos fiscais eletrônicos destinados== A SEFAZ disponibilizou um serviço que nos permite consultar os DF-e emitidos q..."
==Consulta da relação de documentos fiscais eletrônicos destinados==
A SEFAZ disponibilizou um serviço que nos permite consultar os [[Manuais:UniNFe/DFe|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 [[Manuais:UniNFe/DFe|DF-e]], basta gerar o XML com o nome no seguinte formato:
CNPJ-con-dist-dfecte.xml ou CPF-con-dist-dfecte.xml
{| class="wikitable"
|-
||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"
|}
''<span style="font-size: 12px; line-height: 1.5em;">Exemplo: 99999999999999-con-dist-dfecte.xml</span>''
<span style="font-size: 12px; line-height: 1.5em;">O nome do arquivo de retorno é o mesmo do envio, mudando somente a extensão (final) do mesmo, conforme abaixo:</span>
99999999999999-dist-dfecte.xml (''se tudo ocorreu bem'')
ou
99999999999999-dist-dfecte.err (''se houve algum erro'')
===Como tratar a tag ultNSU e maxNSU===
# Ao efetuar a primeira consulta, o conteúdo da tag ultNSU deve ser igual a zero.
## Exemplo: 0
# 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.
# Reforçamos que a cada nova consulta o conteúdo da tag ultNSU deve ser sempre o obtido no retorno da consulta anterior.
# 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.
# 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 [[Manuais:UniNFe/DFe|DF-e]] de um CPF a partir do último NSU obtido:'''
<pre>
<?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>
</pre>
'''Consultar os [[Manuais:UniNFe/DFe|DF-e]] de um CNPJ a partir do último NSU obtido:'''
<pre>
<?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>
</pre>
'''Consultar os [[Manuais:UniNFe/DFe|DF-e]] de um CNPJ de um NSU específico:'''
<pre>
<?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>
</pre>
===Exemplo do XML de retorno===
<pre>
<?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>
</pre>
'''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.
A SEFAZ disponibilizou um serviço que nos permite consultar os [[Manuais:UniNFe/DFe|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 [[Manuais:UniNFe/DFe|DF-e]], basta gerar o XML com o nome no seguinte formato:
CNPJ-con-dist-dfecte.xml ou CPF-con-dist-dfecte.xml
{| class="wikitable"
|-
||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"
|}
''<span style="font-size: 12px; line-height: 1.5em;">Exemplo: 99999999999999-con-dist-dfecte.xml</span>''
<span style="font-size: 12px; line-height: 1.5em;">O nome do arquivo de retorno é o mesmo do envio, mudando somente a extensão (final) do mesmo, conforme abaixo:</span>
99999999999999-dist-dfecte.xml (''se tudo ocorreu bem'')
ou
99999999999999-dist-dfecte.err (''se houve algum erro'')
===Como tratar a tag ultNSU e maxNSU===
# Ao efetuar a primeira consulta, o conteúdo da tag ultNSU deve ser igual a zero.
## Exemplo: 0
# 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.
# Reforçamos que a cada nova consulta o conteúdo da tag ultNSU deve ser sempre o obtido no retorno da consulta anterior.
# 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.
# 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 [[Manuais:UniNFe/DFe|DF-e]] de um CPF a partir do último NSU obtido:'''
<pre>
<?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>
</pre>
'''Consultar os [[Manuais:UniNFe/DFe|DF-e]] de um CNPJ a partir do último NSU obtido:'''
<pre>
<?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>
</pre>
'''Consultar os [[Manuais:UniNFe/DFe|DF-e]] de um CNPJ de um NSU específico:'''
<pre>
<?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>
</pre>
===Exemplo do XML de retorno===
<pre>
<?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>
</pre>
'''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.
