Mudanças entre as edições de "Manuais:DANFEView/IntegracaoERP/XMLResposta"
| (18 revisões intermediárias pelo mesmo usuário não estão sendo mostradas) | |||
| Linha 1: | Linha 1: | ||
__NOTITLE__ | __NOTITLE__ | ||
| − | = 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.