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

De unimake
Ir para: navegação, pesquisa
 
(17 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-".
  
 +
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: ==
 +
 +
<pre>
 +
<resposta>
 +
  <erro>Descrição do erro ocorrido</erro>
 +
</resposta>
 +
</pre>
 +
 +
== Formato do XML de resposta no caso de sucesso: ==
 +
 +
<pre>
 +
<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>
 +
</pre>
 +
 +
== TAGS importantes ==
 +
 +
{| class="wikitable"
 +
|-
 +
|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 ==  
 
== 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