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

De unimake
Ir para: navegação, pesquisa
Linha 44: Linha 44:
 
<?xml version="1.0" encoding="utf-8"?>
 
<?xml version="1.0" encoding="utf-8"?>
 
<retStatusManifest>
 
<retStatusManifest>
   <ret>
+
   <ret chaveAcesso="12345678901234567890123456789012345678901234">
      <chaveAcesso>12345678901234567890123456789012345678901234</chaveAcesso>
 
 
       <status>2</status>
 
       <status>2</status>
 
       <xObs>Alguma obseervação aqui<xObs>
 
       <xObs>Alguma obseervação aqui<xObs>
 
   </ret>
 
   </ret>
 
   ...
 
   ...
   <ret>
+
   <ret chaveAcesso="23456789012345678901234567890123456789012345">
      <chaveAcesso>23456789012345678901234567890123456789012345</chaveAcesso>
 
 
       <status>0</status>
 
       <status>0</status>
 
       <xObs>Mensagem de erro ocorrido na tentativa de envio da manifestação<xObs>
 
       <xObs>Mensagem de erro ocorrido na tentativa de envio da manifestação<xObs>
Linha 59: Linha 57:
  
 
A resposta conterá um grupo de TAGS <ret> para cada chave de acesso do XML de envio, com as TAGs:
 
A resposta conterá um grupo de TAGS <ret> para cada chave de acesso do XML de envio, com as TAGs:
 
<chaveAcesso> - Chave de acesso do documento;
 
  
 
<status> - Status da manifestação desse documento, podendo ser:
 
<status> - Status da manifestação desse documento, podendo ser:

Edição das 10h42min de 26 de novembro 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 nome sugerido é no formato "manif-12345678901234567890123456789012345678901234.xml", ou seja, o prefixo "manif-" acrescido da chave de acesso do documento.

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>
   <ret chaveAcesso="12345678901234567890123456789012345678901234">
      <status>2</status>
      <xObs>Alguma obseervação aqui<xObs>
   </ret>
   ...
   <ret chaveAcesso="23456789012345678901234567890123456789012345">
      <status>0</status>
      <xObs>Mensagem de erro ocorrido na tentativa de envio da manifestação<xObs>
   </ret>
</retStatusManifest>

A resposta conterá um grupo de TAGS <ret> para cada chave de acesso do XML de envio, com as TAGs:

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

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