Manuais:DANFEView/IntegracaoERP/ConsultarDocumentosAguardandoManifestacao

Integração: consultar a lista de documentos aguardando manifestação do destinatário

O sistema ERP pode solicitar ao DANFE View a lista de todos os documentos que aguardam por manifestação do destinatário.

Para tanto basta gerar um XML conforme esse modelo:

<?xml version="1.0" encoding="utf-8"?>
<docsManifest>
   <dest>12.123.123/0001-12</dest>
</docsManifest>

O XML de requisição pode ter qualquer nome e deve ser gerado na pasta tmp\integracao.

Aconselha-se que cada arquivo de requisição tenha sempre um nome exclusivo para evitar confusões entre requisições e respostas, bem como confusão entre requisições simultâneas nas diversas estações da rede.

Após ser lido, o arquivo XML da requisição é automaticamente removido pelo DANFE View, e um arquivo de resposta gerado na pasta tmp\integracao\res, com o mesmo nome do XML de requisição, apenas acrescentando o prefixo "ret-" ao seu nome.

Exemplo:

Se o XML de requisição for: C:\DANFEView\tmp\integracao\docsPendentes_12123123000112_20210601_13h00m00s.xml

O XML de resposta será: C:\DANFEView\tmp\integracao\res\ret-docsPendentes_12123123000112_20210601_13h00m00s.xml

TAGS do XML de envio

dest	CNPJ ou CPF do destinatário dos documentos para o qual deseja a lista daqueles que aguardam por manifestação.

XML de resposta

<?xml version="1.0" encoding="utf-8"?>
<retDocsManifest>
   <sucesso>1</sucesso>
   <xObs>OK</xObs>
   <ret nItem="1">
      <emit>   
         <cnpj>01.123.123/0001/12</cnpj>
         <cpf>123.123.123-12</cpf>
         <IE>001234512345</IE>
         <nome>Nome do emitente</nome>
         <UF>SP</UF>
      </emit>   
      <chaveAcesso>12345678901234567890123456789012345678901234</chaveAcesso>
      <dEmi>AAAA-MM-DD</dEmi>
      <numero>123456789</numero>
      <tpNF>1</tpNF>
      <valor>100.00</valor>
      <cSitConfSEFAZ>0</cSitConfSEFAZ>
      <cSitConf>0</cSitConf>
      <xJust>Justificativa, quando cSitConf=Não realizada</xJust>
      <erro>Erro na tentativa de envio da manifestação para a SEFAZ</erro>
      <memorizado>0</memorizado>
      <dhInclusao>AAAA-MM-DD HH:MM:SS</dhInclusao>
   </ret>
   ...
   <ret chaveAcesso="23456789012345678901234567890123456789011234">
	  ...
   </ret>
</retDocsManifest>

A TAG <sucesso> pode conter:

• "0" - em caso de erro geral no processamento. Nesse caso, nenhum documento contido no XML de envio foi processado. Ex: XML de envio não foi reconhecido pelo DANFE View
• "1" - o lote foi processado.

A TAG <xObs> será preenchida com:

• "OK", se sucesso=1, ou
• Mensagem de erro gerada pelo DANFE View no processamento da requisição, se sucesso=0.

Caso sucesso=1, a resposta conterá um grupo de TAGS <ret> para cada documento encontrado na base de dados que aguardam por manifestação do destinatário definido no XML de envio, com as TAGs:

<emit> - Dados do emitente do documento

<dEmi> - Data de emissão

<numero> - Número do documento

<tpNF> - tipo da Nota Fiscal

<valor> - Valor total do documento

<cSitConfSEFAZ> - Status da manifestação desse documento na SEFAZ, podendo ser:

• "0" - Sem manifestação
• "1" - Confirmada
• "2" - Desconhecimento
• "3" - Operação não realizada
• "4" - Ciência da operação
• vazio - No caso de algum erro ter ocorrido ao localizar a chave de acesso na base de dados.

<cSitConf> - Status da manifestação desse documento na DANFE View, podendo ser:

• "0" - Sem manifestação
• "1" - Confirmada
• "2" - Desconhecimento
• "3" - Operação não realizada
• "4" - Ciência da operação

NOTA: cSitConf é igual à cSitConfSEFAZ quando a manifestação do destinatário já foi enviada com sucesso à SEFAZ, ou é diferente quando uma manifestação já foi inserida no sistema mas ainda não foi enviada à SEFAZ, ou houve falha na tentativa de envio.

<xObsDoc> - Eventualmente poderá sem preenchida com:

• Texto da justificativa, quando status=3;
• Mensagem de erro recebida da SEFAZ ao tentar enviar a manifestação.
• Mensagem de erro gerada pelo DANFE View, por exemplo, ao não localizar a chave de acesso em sua base de dados.