Manuais:DANFEView/IntegracaoERP/ConsultarManifestacao

De unimake
Revisão de 09h55min de 10 de dezembro de 2021 por Sergio (discussão | contribs)
(dif) ← Edição anterior | Revisão atual (dif) | Versão posterior → (dif)
Ir para: navegação, pesquisa

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:

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


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

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

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

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.