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

De unimake
Ir para: navegação, pesquisa
 
(13 revisões intermediárias pelo mesmo usuário não estão sendo mostradas)
Linha 2: Linha 2:
 
= O XML de resposta =
 
= O XML de resposta =
  
O arquivo XML com a resposta à requisição será gravado na pasta tmp\integracao\res, dentro da pasta onde a base de dados do DANFE View está instalada, e terá o mesmo nome do XML da requisição, acrescido do prefixo "ret".
+
O arquivo XML com a resposta à requisição será gravado na pasta tmp\integracao\res, dentro da pasta onde a base de dados do DANFE View está instalada, e terá o mesmo nome do XML da requisição, acrescido do prefixo "ret-".
  
 
Exemplo:  
 
Exemplo:  
::Requisição: c:\danfeview\tmp\integracao\req-001.xml
+
::Requisição: c:\danfeview\tmp\integracao\req001.xml
::Resposta: c:\danfeview\tmp\integracao\res\ret-req-001.xml
+
::Resposta: c:\danfeview\tmp\integracao\res\ret-req001.xml
  
 
O processamento da requisição é assíncrono, de modo que pode demorar alguns segundos (ou minutos, dependendo da quantidade de documentos e opções de extração de XML e PDF) até que o XML de resposta apareça na pasta tmp\integracao\res.
 
O processamento da requisição é assíncrono, de modo que pode demorar alguns segundos (ou minutos, dependendo da quantidade de documentos e opções de extração de XML e PDF) até que o XML de resposta apareça na pasta tmp\integracao\res.
  
Formato do XML de resposta no caso de erro durante o processamento:
+
== Formato do XML de resposta no caso de erro durante o processamento: ==
  
 
<pre>
 
<pre>
 
<resposta>
 
<resposta>
  <nDocs>0</nDocs>
 
 
   <erro>Descrição do erro ocorrido</erro>
 
   <erro>Descrição do erro ocorrido</erro>
 
</resposta>
 
</resposta>
 
</pre>
 
</pre>
  
Formato do XML de resposta no caso de sucesso:
+
== Formato do XML de resposta no caso de sucesso: ==
  
 
<pre>
 
<pre>
 
<resposta>
 
<resposta>
 +
  <sucesso>1</sucesso>
 +
  <xObs>OK</xObs>
 +
  <PastaResposta>tmp\integracao\res\ret-req001</PastaResposta>
 
   <nDocs>99</nDocs>
 
   <nDocs>99</nDocs>
  <PastaResposta>tmp\share-2019-10-21_17-58-30_853962531</PastaResposta>
 
 
   <doc nSeq="1">
 
   <doc nSeq="1">
 
       <ChaveAcesso>411910061174730001505500100005887613344556600</ChaveAcesso>
 
       <ChaveAcesso>411910061174730001505500100005887613344556600</ChaveAcesso>
Linha 59: Linha 60:
 
</resposta>
 
</resposta>
 
</pre>
 
</pre>
 +
 +
== TAGS importantes ==
  
 
{| class="wikitable"
 
{| class="wikitable"
Linha 66: Linha 69:
 
|-
 
|-
 
|PastaResposta
 
|PastaResposta
|Pasta onde os arquivos XML e PDF foram salvos, caso tenham sido definidos na seção <parametros>.
+
|Pasta onde os arquivos XML e PDF foram salvos, caso tenham sido solicitados na seção <parametros>.
 
|-
 
|-
 
|doc
 
|doc
Linha 72: Linha 75:
 
|-
 
|-
 
|ArquivoXML
 
|ArquivoXML
|Nome do arquivo XML, caso tenha sido solicitado, salvo na pasta de resposta.
+
|Nome do arquivo XML, caso tenha sido solicitado, salvo na pasta de resposta. O nome completo dele será:
 +
 
 +
<Pasta da base de dados do DANFE View> \ tmp \ <Pasta de Resposta> \ <ArquivoXML>
 +
 
 +
Ex: C:\DANFEVIEW\tmp\share-2019-10-21_17-58-30_853962531\411910061174730001505500100005887613344556600-procNFe.xml
 
|-
 
|-
 
|ArquivoPDF
 
|ArquivoPDF
|Nome do arquivo PDF, caso tenha sido solicitado, salvo na pasta de resposta.
+
|Nome do arquivo PDF, caso tenha sido solicitado, salvo na pasta de resposta. O nome completo dele será:
 +
 
 +
<Pasta da base de dados do DANFE View> \ tmp \ <Pasta de Resposta> \ <ArquivoPDF>
 +
 
 +
Ex: C:\DANFEVIEW\tmp\share-2019-10-21_17-58-30_853962531\411910061174730001505500100005887613344556600-danfe.pdf
 
|}
 
|}
  
Após utilizar o XML de resposta o sistema ERP deve removê-lo, bem como a pasta de resposta (se houver) e seu conteúdo. Caso não o faça os mesmos serão excluídos pelo DANFE View quando o mesmo executar seu processo de limpeza de pastas temporárias.
+
Após utilizar o XML de resposta o sistema ERP deve removê-lo, bem como a pasta de resposta (se houver) e seu conteúdo. Caso não o faça os mesmos serão excluídos pelo DANFE View quando ele executar seu processo periódico de limpeza de arquivos e pastas temporárias.
  
Caso queira manter esse arquivo e os XML´s e PDF´s por mais tempo, o sistema ERP deverá movê-lo para outras pastas para evitar a exclusão automática realizada pelo DANFE View.
+
Caso queira manter o arquivo de resposta e os XML´s e PDF´s por mais tempo, o sistema ERP deverá movê-los para outras pastas para evitar a exclusão automática realizada pelo DANFE View.
  
 
== Veja também ==  
 
== Veja também ==  
 
* [[Manuais:DANFEView/IntegracaoERP/XMLRequisicao|O XML de requisição]]
 
* [[Manuais:DANFEView/IntegracaoERP/XMLRequisicao|O XML de requisição]]
 +
* [[Manuais:DANFEView/IntegracaoERP/XMLStatus|O XML de status da consulta]]

Edição atual tal como às 13h43min de 25 de março de 2022

O XML de resposta

O arquivo XML com a resposta à requisição será gravado na pasta tmp\integracao\res, dentro da pasta onde a base de dados do DANFE View está instalada, e terá o mesmo nome do XML da requisição, acrescido do prefixo "ret-".

Exemplo:

Requisição: c:\danfeview\tmp\integracao\req001.xml
Resposta: c:\danfeview\tmp\integracao\res\ret-req001.xml

O processamento da requisição é assíncrono, de modo que pode demorar alguns segundos (ou minutos, dependendo da quantidade de documentos e opções de extração de XML e PDF) até que o XML de resposta apareça na pasta tmp\integracao\res.

Formato do XML de resposta no caso de erro durante o processamento:

<resposta>
   <erro>Descrição do erro ocorrido</erro>
</resposta>

Formato do XML de resposta no caso de sucesso:

<resposta>
   <sucesso>1</sucesso>
   <xObs>OK</xObs>
   <PastaResposta>tmp\integracao\res\ret-req001</PastaResposta>
   <nDocs>99</nDocs>
   <doc nSeq="1">
      <ChaveAcesso>411910061174730001505500100005887613344556600</ChaveAcesso>
      <Tipo>NF-e</Tipo>
      <Emissao>2019-09-02</Emissao>
      <Numero>58876</Numero>
      <Serie>1</Serie>
      <ValorTotal>94.90</ValorTotal>
      <NaturezaOperacao>VENDA PRODUC.DO ESTABELEC</NaturezaOperacao>
      <Situacao>Nao consultado</Situacao>
      <Memorizacao>2019-10-18</Memorizacao>
      <Emit>
         <CNPJ>06.117.473/0001-50</CNPJ>
         <Nome>UNIMAKE SOLUCOES CORPORATIVAS LTDA</Nome>
         <Municipio>PARANAVAI</Municipio>
         <UF>PR</UF>
      </Emit>
      <Dest>
         <CNPJ>00.000.000/0001-00</CNPJ>
         <Nome>NOME DO DESTINATÁRIO LTDA</Nome>
         <Municipio>MUNICIPIO</Municipio>
         <UF>PR</UF>
      </Dest>
      <ArquivoXML>411910061174730001505500100005887613344556600-procNFe.xml</ArquivoXML>
      <ArquivoPDF>411910061174730001505500100005887613344556600-danfe.pdf</Arquivopdf>
   </doc>
   <doc nSeq="2">
      ...
   </doc>
   ...
   <doc nSeq="99">
      ...
   </doc>
</resposta>

TAGS importantes

nDocs Número de documentos listados no XML.
PastaResposta Pasta onde os arquivos XML e PDF foram salvos, caso tenham sido solicitados na seção <parametros>.
doc Grupo de TAGS do documento. Será criado um grupo para cada documento listado no XML, cada qual com o atributo "nSeq" correspondente.
ArquivoXML Nome do arquivo XML, caso tenha sido solicitado, salvo na pasta de resposta. O nome completo dele será:

<Pasta da base de dados do DANFE View> \ tmp \ <Pasta de Resposta> \ <ArquivoXML>

Ex: C:\DANFEVIEW\tmp\share-2019-10-21_17-58-30_853962531\411910061174730001505500100005887613344556600-procNFe.xml

ArquivoPDF Nome do arquivo PDF, caso tenha sido solicitado, salvo na pasta de resposta. O nome completo dele será:

<Pasta da base de dados do DANFE View> \ tmp \ <Pasta de Resposta> \ <ArquivoPDF>

Ex: C:\DANFEVIEW\tmp\share-2019-10-21_17-58-30_853962531\411910061174730001505500100005887613344556600-danfe.pdf

Após utilizar o XML de resposta o sistema ERP deve removê-lo, bem como a pasta de resposta (se houver) e seu conteúdo. Caso não o faça os mesmos serão excluídos pelo DANFE View quando ele executar seu processo periódico de limpeza de arquivos e pastas temporárias.

Caso queira manter o arquivo de resposta e os XML´s e PDF´s por mais tempo, o sistema ERP deverá movê-los para outras pastas para evitar a exclusão automática realizada pelo DANFE View.

Veja também