105
edições
Mudanças
Created page with "==Consulta status do serviço de DFe == === Documentos que podem ser consultados === * NF-e * NFC-e * ..."
==Consulta status do serviço de [[Manuais:UniNFe/DFe|DFe]] ==
=== Documentos que podem ser consultados ===
* [[Manuais:UniNFe/DFe|NF-e]]
* [[Manuais:UniNFe/DFe|NFC-e]]
* [[Manuais:UniNFe/DFe|CT-e]]
* [[Manuais:UniNFe/DFe|MDF-e]]
=== Enviando o arquivo no formato XML ===
Para enviar o XML de consulta status, basta gerar o arquivo com o nome no seguinte formato:
AAAAMMDDTHHMMSS-ped-sta.xml
{| class="wikitable"
|-
||AAAA
||Ano atual com 4 dígitos.
|-
||MM
||Mês atual com 2 dígitos.
|-
||DD
||Dia atual com 2 dígitos.
|-
||T
||Conteúdo fixo. Sempre será "T".
|-
||HH
||Hora atual com dois dígitos.
|-
||MM
||Minútos atual com dois dígitos.
|-
||SS
||Segundos atual com dois dígitos.
|-
||-ped-sta.xml
||Conteúdo fixo. Sempre será "-ped-sta.xml"
|}
Exemplo: 20161230T135822-ped-sta.xml
O nome do arquivo de retorno é o mesmo do envio, mudando somente a extensão (final) do mesmo, conforme abaixo:
20161230T135822-sta.xml (''se tudo ocorreu bem'')
ou
20161230T135822-sta.err (''se houve algum erro'')
Como o XML de consulta status do serviço não possui a tag <tpEmis>, não é possível do ERP efetuar consultas de ambientes diferentes, tipo: SVCAN, SVCRS e Normal. Para resolver este problema o ERP pode incluir a tag <tpEmis> no XML obedecendo a seguinte estrutura:
<pre>
<?xml version="1.0" encoding="UTF-8"?>
<consStatServ versao="3.10">
<tpAmb>2</tpAmb>
<cUF>35</cUF>
<tpEmis>1</tpEmis> (OPCIONAL)
<xServ>STATUS</xServ>
<mod>65</mod> (OPCIONAL)
</consStatServ>
</pre>
Se a tag <tpEmis> existir o UniNFe vai efetuar a consulta de acordo com a informação nela contida e vai remover a tag antes de enviar a SEFAZ para evitar erros de validação na sua estrutura do XML.
O mesmo ocorre com a tag <mod>, o ERP pode definir o modelo do [[Manuais:UniNFe/DFe|DFe]] que ele deseja consultar o status, útil para quando se utiliza uma mesma configuração para todos os tipos de modelos de [[Manuais:UniNFe/DFe|DFe]].
=== Enviando o arquivo no formato TXT ===
O ERP ao gerar o arquivo TXT o UniNFe irá converter para o formato XML e enviar a SEFAZ de acordo com o processo descrito no item “Enviando o arquivo no formato XML”, porém, além de gravar o retorno em XML, pode também, se configurado para isso, gravar o retorno no formato TXT.
O nome do arquivo deve ter o mesmo formato do XML, porém, com extensão TXT (.txt).
==== Layout do arquivo TXT ====
<pre>
tpEmis|1
tpAmb|2
cUF|31
versao|3.10
</pre>
=== Importante ===
* O XML de consulta da status não é enviado para o Estado informado na tela de configurações do UniNFe e sim para o Estado informado na tag correspondente do XML.
=== Documentos que podem ser consultados ===
* [[Manuais:UniNFe/DFe|NF-e]]
* [[Manuais:UniNFe/DFe|NFC-e]]
* [[Manuais:UniNFe/DFe|CT-e]]
* [[Manuais:UniNFe/DFe|MDF-e]]
=== Enviando o arquivo no formato XML ===
Para enviar o XML de consulta status, basta gerar o arquivo com o nome no seguinte formato:
AAAAMMDDTHHMMSS-ped-sta.xml
{| class="wikitable"
|-
||AAAA
||Ano atual com 4 dígitos.
|-
||MM
||Mês atual com 2 dígitos.
|-
||DD
||Dia atual com 2 dígitos.
|-
||T
||Conteúdo fixo. Sempre será "T".
|-
||HH
||Hora atual com dois dígitos.
|-
||MM
||Minútos atual com dois dígitos.
|-
||SS
||Segundos atual com dois dígitos.
|-
||-ped-sta.xml
||Conteúdo fixo. Sempre será "-ped-sta.xml"
|}
Exemplo: 20161230T135822-ped-sta.xml
O nome do arquivo de retorno é o mesmo do envio, mudando somente a extensão (final) do mesmo, conforme abaixo:
20161230T135822-sta.xml (''se tudo ocorreu bem'')
ou
20161230T135822-sta.err (''se houve algum erro'')
Como o XML de consulta status do serviço não possui a tag <tpEmis>, não é possível do ERP efetuar consultas de ambientes diferentes, tipo: SVCAN, SVCRS e Normal. Para resolver este problema o ERP pode incluir a tag <tpEmis> no XML obedecendo a seguinte estrutura:
<pre>
<?xml version="1.0" encoding="UTF-8"?>
<consStatServ versao="3.10">
<tpAmb>2</tpAmb>
<cUF>35</cUF>
<tpEmis>1</tpEmis> (OPCIONAL)
<xServ>STATUS</xServ>
<mod>65</mod> (OPCIONAL)
</consStatServ>
</pre>
Se a tag <tpEmis> existir o UniNFe vai efetuar a consulta de acordo com a informação nela contida e vai remover a tag antes de enviar a SEFAZ para evitar erros de validação na sua estrutura do XML.
O mesmo ocorre com a tag <mod>, o ERP pode definir o modelo do [[Manuais:UniNFe/DFe|DFe]] que ele deseja consultar o status, útil para quando se utiliza uma mesma configuração para todos os tipos de modelos de [[Manuais:UniNFe/DFe|DFe]].
=== Enviando o arquivo no formato TXT ===
O ERP ao gerar o arquivo TXT o UniNFe irá converter para o formato XML e enviar a SEFAZ de acordo com o processo descrito no item “Enviando o arquivo no formato XML”, porém, além de gravar o retorno em XML, pode também, se configurado para isso, gravar o retorno no formato TXT.
O nome do arquivo deve ter o mesmo formato do XML, porém, com extensão TXT (.txt).
==== Layout do arquivo TXT ====
<pre>
tpEmis|1
tpAmb|2
cUF|31
versao|3.10
</pre>
=== Importante ===
* O XML de consulta da status não é enviado para o Estado informado na tela de configurações do UniNFe e sim para o Estado informado na tag correspondente do XML.
