Manuais:UniNFe/ConsInf

Consultando informações gerais do UniNFe

O UniNFe pode retornar ao sistema ERP várias informações do equipamento que ele está executando para facilitar alguns controles, tais como: dados do certificado digital, versão do aplicativo, etc.

Enviando o arquivo no formato XML

Para utilizar esta opção, basta gerar um XML de envio ou pasta geral com o seguinte nome e estrutura:

Nome do arquivo XML: uninfe-cons-inf.xml

<?xml version="1.0" encoding="utf-8"?>
<ConsInf>
   <xServ>CONS-INF</xServ>
</ConsInf>

O UniNFe ao detectar a existência do arquivo, gera um XML na pasta de retorno para o ERP com as informações. Segue o nome e estrutura do XML:

Nome do arquivo XML de retorno: uninfe-ret-cons-inf.xml

<?xml version="1.0" encoding="utf-8"?>
<retConsInf>
  <cStat>1</cStat>
  <xMotivo>Consulta efetuada com sucesso</xMotivo>
  <DadosCertificado>
    <sSubject>CN=EMPRESA TESTE LTD:12123123000129, OU=SRF e-CNPJ, OU=Secretaria da Receita Federal-SRF, O=ICP-Brasil, L=PARANAVAI, S=PR, C=BR</sSubject>
    <dValIni>22/06/2008 21:00:00</dValIni>
    <dValFin>23/06/2009 20:59:59</dValFin>
  </DadosCertificado>
  <DadosUniNfe> 
    <versao>1.2.3316.21929</versao>
    <dUltModif>29/01/2009 02:10:59</dUltModif>
    <PastaExecutavel>c:\testenfe\executavel</PastaExecutavel>
    <NomeComputador>UNIMAKE_UNINFE</NomeComputador>
  </DadosUniNfe>
  <nfe_configuracoes>
    <PastaBackup>C:\Usr\NFe\uninfe\backup</PastaBackup>
    <PastaXmlEmLote></PastaXmlEmLote>
    <PastaXmlAssinado>\Assinado</PastaXmlAssinado>
    <PastaXmlValidar>C:\Usr\NFe\uninfe\validados</PastaXmlValidar>
    <PastaXmlEnviado>C:\Usr\NFe\uninfe\enviados</PastaXmlEnviado>
    <PastaXmlEnvio>C:\Usr\NFe\uninfe\envio</PastaXmlEnvio>
    <PastaXmlErro>C:\Usr\NFe\uninfe\tempErro</PastaXmlErro>
    <PastaXmlRetorno>C:\Usr\NFe\uninfe\retorno</PastaXmlRetorno>
    <DiasParaLimpeza>0</DiasParaLimpeza>
    <DiretorioSalvarComo>AM</DiretorioSalvarComo>
    <GravarRetornoTXTNFe>False</GravarRetornoTXTNFe>
    <tpAmb>2</tpAmb>
    <tpEmis>1</tpEmis>
    <UnidadeFederativaCodigo>35</UnidadeFederativaCodigo>
  </nfe_configuracoes>
</retConsInf>

Enviando o arquivo no formato TXT

Assim como no formato XML o ERP deve gerar o arquivo de consulta mas com extensão .txt, conforme nome e estrutura abaixo:

Nome do arquivo TXT: uninfe-cons-inf.txt

xServ|CONS-INF

Nome do arquivo TXT de retorno: uninfe-ret-cons-inf.txt

Segue a estrutura do TXT retornado:

cStat|1
xMotivo|Consulta efetuada com sucesso
sSubject| CN=EMPRESA TESTE LTD:12123123000129, OU=SRF e-CNPJ, OU=Secretaria da Receita Federal-SRF, O=ICP-Brasil, L=PARANAVAI, S=PR, C=BR
dValIni|22/05/2009 12:00:00
dValFin|22/05/2010 12:00:00
versao|2.2.3543.10217
dUltModif|13/09/2009 07:40:36
PastaExecutavel|c:\testenfe\executavel
NomeComputador|UNIMAKE_UNINFE
PastaBackup|C:\Usr\NFe\uninfe\backup
PastaXmlEmLote|
PastaXmlAssinado|\Assinado
PastaXmlValidar|C:\Usr\NFe\uninfe\validados
PastaXmlEnviado|C:\Usr\NFe\uninfe\enviados
PastaXmlEnvio|C:\Usr\NFe\uninfe\envio
PastaXmlErro|C:\Usr\NFe\uninfe\tempErro
PastaXmlRetorno|C:\Usr\NFe\uninfe\retorno
DiasParaLimpeza|0
DiretorioSalvarComo|AM
GravarRetornoTXTNFe|False
tpAmb|2
tpEmis|1
UnidadeFederativaCodigo|35

Importante

• Pode-se obter como resultado (cStat) os seguintes códigos:
  • 1) Consulta efetuada com sucesso;
  • 2) Certificado digital não foi localizado.
  • No caso do retorno 2 na tag “cStat”, o XML ou TXT é gravado normalmente mas sem as informações gerais.
• Se ocorrer algum erro na hora de gravar o XML ou TXT de retorno com as informações, o UniNFe vai gerar um arquivo com a extensão .ERR com o mesmo nome para que o ERP tenha condições interceptar o erro ocorrido.
• É de fundamental importância o ERP regularmente pegar a data de validade do certificado e se o mesmo estiver para vencer, informar o usuário para que já adquira um novo e evite parada inesperada do serviços.