Mudanças entre as edições de "Manuais:DANFEView/IntegracaoERP/XMLResposta"
(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
Índice
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.