Manuais:UniNFe/NFeDistribuicaoDFe - Histórico de revisão

Wandrey em 19h04min de 24 de março de 2022

2022-03-24T19:04:51Z

Wesley: Ajustando seção Veja Também

2022-03-17T18:03:37Z

Ajustando seção Veja Também

Wesley: Ajustado cor e tamanho do título e do "Veja também"

2022-03-17T14:49:24Z

Ajustado cor e tamanho do título e do "Veja também"

Wesley: Adicionado NOTITLE

2022-02-16T10:53:23Z

Adicionado __NOTITLE__

Wandrey em 19h17min de 30 de junho de 2020

2020-06-30T19:17:49Z

Jeffersonmello: 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..."

2017-08-23T18:26:49Z

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

Página nova

==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-dfe.xml ou CPF-con-dist-dfe.xml

{| class="wikitable"
|-
||CNPJ ou CPF
||CNPJ ou CPF de quem está efetuando a consulta
|-
||-con-dist-dfe.xml
||Conteúdo fixo. Sempre será "-con-dist-dfe.xml"
|}
''<span style="font-size: 12px; line-height: 1.5em;">Exemplo: 99999999999999-con-dist-dfe.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-dfe.xml (''se tudo ocorreu bem'')

ou

99999999999999-dist-dfe.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-dfe.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/nfe">
<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/nfe">
<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/nfe">
<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/nfe">
<tpAmb>1</tpAmb>
<verAplic>1.0.0</verAplic>
<cStat>138</cStat>
<xMotivo>Documento localizado</xMotivo>
<dhResp>2015-06-16T10:04:40</dhResp>
<ultNSU>000000000000676</ultNSU>
<maxNSU>000000000000752</maxNSU>
<loteDistDFeInt>
<docZip NSU="000000000000627" schema="procEventoNFe_v1.00.xsd">H4sIAAAAAAAEAOy...</docZip>
<docZip NSU="000000000000628" schema="procNFe_v1.00.xsd">H4sIAAAAAAAEA...</docZip>
<docZip NSU="000000000000629" schema="procEventoNFe_v1.00.xsd">H4sIAAAAAAAEAOy9B...</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 das NFe já manifestadas, etc. Nesta subpasta é gravado também o XML com final -nfe.xml, onde é disponibilizado o conteúdo mínimo de cada NFe retornada pela consulta. Este conteúdo pode ser lido pelo ERP para disponibilizar informações para o usuário.

Exemplo do conteúdo do arquivo retornado com final -nfe.xml:

<pre>
<?xml version="1.0" encoding="utf-8"?>
<resNFe versao="1.00" xmlns="http://www.portalfiscal.inf.br/nfe">
<chNFe>999999999999999...</chNFe>
<CNPJ>99999999999999</CNPJ>
<xNome>TESTE</xNome>
<IE>99999999</IE>
<dhEmi>2015-05-15T08:46:00-03:00</dhEmi>
<tpNF>1</tpNF>
<vNF>112.50</vNF>
<digVal>X8D8F8D8D8SSDSDSDS</digVal>
<dhRecbto>2015-05-15T08:56:38-03:00</dhRecbto>
<nProt>9239340239393</nProt>
<cSitNFe>1</cSitNFe>
</resNFe>
</pre>

===Enviando o arquivo no formato TXT===

O nome do arquivo de envio no formato TXT deve ser igual ao do XML mudando somente a extensão do arquivo para .txt.

Exemplo:

CNPJ-con-dist-dfe.txt ou CPF-con-dist-dfe.txt

<pre>
versao|1.00
tpAmb|2
cUFAutor|35
CNPJ|06117723000112
ou
CPF|22233366695
ultNSU|123456789012345
ou
NSU|123456789012345
</pre>

A partir do TXT o UniNFe vai criar o XML e efetuar as mesmas operações descritas nos itens anteriores.

O nome do arquivo retornado é igual no processo de envio por XML, mudando somente a extensão para .txt.

===Exemplo do TXT de retorno===

<pre>
1;1.0.0;138;Documento localizado;2015-06-16T10:26:35;000000000000481;000000000000752;
resNFe;000000000000432;41150315127839000162550010000467091000943213;
procEventoNFe;000000000000433;41141206117473000150550010000276541702751436;tpEvCienciaOperacao;01
procEventoNFe;000000000000434;41141206117473000150550010000276541702751436;tpEvConfirmacaoOperacao;01
resNFe;000000000000435;41150302163753000143550010000226611142647403;
etc...
</pre>

===Veja também===
* [[Manuais:UniNFe/RecepcaoEventoManifestacao|Manifestação do destinatário]]

@@ Linha 182: / Linha 182: @@
 </pre>
-===<font color=#008000>Veja também</font>===
+=<font color=#008000>Veja também</font>=
 * [[Manuais:UniNFe/RecepcaoEventoManifestacao|Manifestação do destinatário]]

← Edição anterior		Edição das 10h53min de 16 de fevereiro de 2022
Linha 1:		Linha 1:
		+	__NOTITLE__
	==Consulta da relação de documentos fiscais eletrônicos destinados==		==Consulta da relação de documentos fiscais eletrônicos destinados==

@@ Linha 45: / Linha 45: @@
    <CPF>99999999999</CPF>
    <distNSU>
-     <ultNSU>123456789012345</ultNSU>
+     <ultNSU>000000000000626</ultNSU>
    </distNSU>
 </distDFeInt>

@@ Linha 1: / Linha 1: @@
 __NOTITLE__
-==Consulta da relação de documentos fiscais eletrônicos destinados==
+==<big><font color=#008000>'''Consulta da relação de documentos fiscais eletrônicos destinados'''</font></big>==
 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===
+===<font color=#008000>Enviando o arquivo no formato XML</font>===
 Para enviar o XML de consulta dos [[Manuais:UniNFe/DFe|DF-e]], basta gerar o XML com o nome no seguinte formato:
@@ Linha 27: / Linha 27: @@
 99999999999999-dist-dfe.err (''se houve algum erro'')
-===Como tratar a tag ultNSU e maxNSU===
+===<font color=#008000>Como tratar a tag ultNSU e maxNSU</font>===
 # Ao efetuar a primeira consulta, o conteúdo da tag ultNSU deve ser igual a zero.
 ## Exemplo: 0
@@ Linha 35: / Linha 35: @@
 # Quando o conteúdo da tag maxNSU for igual a ultNSU, só efetue nova consulta após 1 hora.
-===Exemplo do XML de envio===
+===<font color=#008000>Exemplo do XML de envio</font>===
 '''Consultar os [[Manuais:UniNFe/DFe|DF-e]] de um CPF a partir do último NSU obtido:'''
@@ Linha 102: / Linha 102: @@
 </pre>
-===Exemplo do XML de retorno===
+===<font color=#008000>Exemplo do XML de retorno</font>===
 <pre>
 <?xml version="1.0" encoding="utf-8"?>
@@ Linha 147: / Linha 147: @@
 </pre>
-===Enviando o arquivo no formato TXT===
+===<font color=#008000>Enviando o arquivo no formato TXT</font>===
 O nome do arquivo de envio no formato TXT deve ser igual ao do XML mudando somente a extensão do arquivo para .txt.
@@ Linha 171: / Linha 171: @@
 O nome do arquivo retornado é igual no processo de envio por XML, mudando somente a extensão para .txt.
-===Exemplo do TXT de retorno===
+===<font color=#008000>Exemplo do TXT de retorno</font>===
 <pre>
@@ Linha 182: / Linha 182: @@
 </pre>
-===Veja também===
+===<font color=#008000>Veja também</font>===
 * [[Manuais:UniNFe/RecepcaoEventoManifestacao|Manifestação do destinatário]]

← Edição anterior		Edição das 19h17min de 30 de junho de 2020
Linha 75:		Linha 75:
	</pre>		</pre>

		+	'''Consultar os [[Manuais:UniNFe/DFe\|DF-e]] de um CPF de uma CHAVE específica:'''
		+	<pre>
		+	<?xml version="1.0" encoding="utf-8"?>
		+	<distDFeInt xmlns="http://www.portalfiscal.inf.br/nfe" versao="1.01">
		+	<tpAmb>2</tpAmb>
		+	<cUFAutor>35</cUFAutor>
		+	<CPF>99999999999</CPF>
		+	<consChNFe>
		+	<chNFe>9999999999999999999999999999999999999999999</chNFe>
		+	</consChNFe>
		+	</distDFeInt>
		+	</pre>

		+	'''Consultar os [[Manuais:UniNFe/DFe\|DF-e]] de um CNPJ de uma CHAVE específica:'''
		+	<pre>
		+	<?xml version="1.0" encoding="utf-8"?>
		+	<distDFeInt xmlns="http://www.portalfiscal.inf.br/nfe" versao="1.01">
		+	<tpAmb>2</tpAmb>
		+	<cUFAutor>35</cUFAutor>
		+	<CNPJ>99999999999</CNPJ>
		+	<consChNFe>
		+	<chNFe>9999999999999999999999999999999999999999999</chNFe>
		+	</consChNFe>
		+	</distDFeInt>
		+	</pre>

	===Exemplo do XML de retorno===		===Exemplo do XML de retorno===