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

De unimake
Ir para: navegação, pesquisa
(Criou página com '__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 manifes...')
 
(Etiquetas: mobile edit, mobile web edit)
 
(18 revisões intermediárias pelo mesmo usuário não estão sendo mostradas)
Linha 1: Linha 1:
 
__NOTITLE__
 
__NOTITLE__
−
= Integração: consultar Status de Manifestações do Destinatário =
+
{{danfeview_header}}
  
−
O sistema ERP pode solicitar ao DANFE View o status de manifestação de documentos manifestados anteriormente.
+
=== 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:
 
Para tanto basta gerar um XML com as informações dos documentos, conforme esse modelo:
Linha 19: Linha 21:
 
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 29: Linha 31:
 
:::O XML de resposta será: C:\DANFEView\tmp\integracao\res\ret-consulta-20191020-13h00m00s.xml
 
:::O XML de resposta será: C:\DANFEView\tmp\integracao\res\ret-consulta-20191020-13h00m00s.xml
  
−
== TAGS do XML de envio  ==
+
 
 +
=== TAGS do XML de envio  ===
  
 
{| class="wikitable"
 
{| class="wikitable"
Linha 37: Linha 40:
  
 
|}
 
|}
−
Todas as TAGs são obrigatórias, exceto a TAG "xJust" quando "cSitConf" for diferente de "3".
+
 
 +
=== 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.
 +
 
 +
== Veja também ==
 +
* [[Manuais:DANFEView/IntegracaoERP|Integração com outros sistemas]]

Edição atual tal como às 17h30min de 11 de março de 2025


Logo-danfeview.png DANFE View - Gerenciador de Documentos Fiscais Eletrônicos

Home | Suporte | Download | Sobre

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.

Veja também

Disponível em "http://wiki.unimake.com.br/index.php?title=Manuais:DANFEView/IntegracaoERP/ConsultarManifestacao&oldid=6050"