Exibir código-fonte para Manuais:DANFEView/IntegracaoERP/ConsultarManifestacao

__NOTITLE__
= Integração: consultar Status de Manifestações do Destinatário =

O sistema ERP pode solicitar ao DANFE View o status de manifestação de documentos manifestados anteriormente, mesmo que a manifestação não tenha sido enviada pelo ERP.

Para tanto basta gerar um XML com as informações dos documentos, conforme esse modelo:

<pre>
<?xml version="1.0" encoding="utf-8"?>
<statusManifest>
   <chaveAcesso>12345678901234567890123456789012345678901234</chaveAcesso>
   <chaveAcesso>23456789012345678901234567890123456789012345</chaveAcesso>
   ...
   <chaveAcesso>34567890123456789012345678901234567890123456</chaveAcesso>
</statusManifest>
</pre>


O envio de requisição de informações ao DANFE View se dá através de um arquivo XML que 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. 

O desenvolvedor tem toda a liberdade para criar os nomes de acordo com os recursos disponíveis em sua linguagem de programação.

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\consulta-20191020-13h00m00s.xml
:::O XML de resposta será: C:\DANFEView\tmp\integracao\res\ret-consulta-20191020-13h00m00s.xml

== TAGS do XML de envio  ==

{| class="wikitable"
|-
|chaveAcesso
|Chave de acesso do documento. Esse documento deve existir na tela "Manifestação do Destinatário" ou já ter sido memorizado antes pelo DANFE View.

|}


== XML de resposta ==

<pre>
<?xml version="1.0" encoding="utf-8"?>
<retStatusManifest>
   <sucesso>1</sucesso>
   <xObs>OK</xObs>
   <ret chaveAcesso="12345678901234567890123456789012345678901234">
      <cSitConf>2</cSitConf>
      <xObsDoc>Alguma observação aqui</xObsDoc>
   </ret>
   ...
</retStatusManifest>
</pre>

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 do XML de envio, com as TAGs:

<cSitConf> - Status da manifestação desse documento, 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.

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