Mudanças entre as edições de "Manuais:DANFEView/IntegracaoERP/ConsultarManifestacao"

De unimake
Ir para: navegação, pesquisa
 
(12 revisões intermediárias pelo mesmo usuário não estão sendo mostradas)
Linha 2: Linha 2:
 
= Integração: consultar Status de Manifestações do Destinatário =
 
= 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.
+
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:
 
Para tanto basta gerar um XML com as informações dos documentos, conforme esse modelo:
Linha 19: Linha 19:
 
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.
 
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 nome sugerido é no formato "manif-12345678901234567890123456789012345678901234.xml", ou seja, o prefixo "manif-" acrescido da chave de acesso do documento.
+
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.
 
O desenvolvedor tem toda a liberdade para criar os nomes de acordo com os recursos disponíveis em sua linguagem de programação.
Linha 44: Linha 44:
 
<?xml version="1.0" encoding="utf-8"?>
 
<?xml version="1.0" encoding="utf-8"?>
 
<retStatusManifest>
 
<retStatusManifest>
−
   <ret>
+
   <sucesso>1</sucesso>
−
      <chaveAcesso>12345678901234567890123456789012345678901234</chaveAcesso>
+
  <xObs>OK</xObs>
−
       <status>2</status>
+
  <ret chaveAcesso="12345678901234567890123456789012345678901234">
−
       <xObs>Alguma obseervação aqui<xObs>
+
       <cSitConf>2</cSitConf>
 +
       <xObsDoc>Alguma observação aqui</xObsDoc>
 
   </ret>
 
   </ret>
 
   ...
 
   ...
−
  <ret>
 
−
      <chaveAcesso>23456789012345678901234567890123456789012345</chaveAcesso>
 
−
      <status>0</status>
 
−
      <xObs>Mensagem de erro ocorrido na tentativa de envio da manifestação<xObs>
 
−
  </ret>
 
 
</retStatusManifest>
 
</retStatusManifest>
 
</pre>
 
</pre>
  
−
O  conteúdo da TAG <status> poderá ser:
+
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
 
* "0" - Sem manifestação
 
* "1" - Confirmada
 
* "1" - Confirmada
Linha 64: Linha 70:
 
* "3" - Operação não realizada
 
* "3" - Operação não realizada
 
* "4" - Ciência da operação
 
* "4" - Ciência da operação
 +
* vazio - No caso de algum erro ter ocorrido ao localizar a chave de acesso na base de dados.
  
−
Eventualmente a TAG <xObs> poderá sem preenchida com:
+
<xObsDoc> - Eventualmente poderá sem preenchida com:
−
* Justificativa, quando status=3;
+
* Texto da justificativa, quando status=3;
 
* Mensagem de erro recebida da SEFAZ ao tentar enviar a manifestação.
 
* 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.

Edição atual tal como às 09h55min de 10 de dezembro de 2021

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.
Disponível em "http://wiki.unimake.com.br/index.php?title=Manuais:DANFEView/IntegracaoERP/ConsultarManifestacao&oldid=3256"