Mudanças entre as edições de "Manuais:DANFEView/IntegracaoERP/XMLRequisicao"
| Linha 2: | Linha 2: | ||
= XML de requisição = | = XML de requisição = | ||
| − | + | 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 antigas, bem como confusão entre requisições simultâneas | + | Aconselha-se que cada arquivo de requisição tenha sempre um nome exclusivo para evitar confusões entre requisições e respostas antigas, bem como confusão entre requisições simultâneas nas diversas estações da rede. |
| − | Por exemplo, pode-se incluir a data | + | Por exemplo, pode-se incluir a data e a hora da requisição no nome do XML, ou algum número randômico. |
O desenvolvedor tem toda a liberdade para criar os nomes de acordo com os recursos disponíveis em sua linguagem de programação. | O desenvolvedor tem toda a liberdade para criar os nomes de acordo com os recursos disponíveis em sua linguagem de programação. | ||
| Linha 10: | Linha 10: | ||
::Exemplo: | ::Exemplo: | ||
| − | :::XML de requisição: C:\DANFEView\tmp\integracao\ | + | :::Se o XML de requisição for: C:\DANFEView\tmp\integracao\consulta-20191020-13h00m00s.xml |
| − | :::XML de resposta: C:\DANFEView\tmp\integracao\res\ret- | + | :::O XML de resposta será: C:\DANFEView\tmp\integracao\res\ret-consulta-20191020-13h00m00s.xml |
=== Formato do XML de requisição === | === Formato do XML de requisição === | ||
Edição das 14h34min de 21 de outubro de 2019
XML de requisição
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 antigas, bem como confusão entre requisições simultâneas nas diversas estações da rede. Por exemplo, pode-se incluir a data e a hora da requisição no nome do XML, ou algum número randômico. 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
- Exemplo:
Formato do XML de requisição
Há três grupos de TAGS no XML de requisição: "parametros", "filtros" e "filtros_avancados", onde cada qual deve conter as tags respectivas com os atributos "campo" e "valor".
<?xml version="1.0" encoding="ISO-8859-1" ?>
<requisicao>
<parametros>
<parametro campo="xxxxx" valor="yyyyyy" />
</parametros>
<filtros>
<filtro campo="xxxxx" valor="yyyyyy" />
</filtros>
<filtros_avancados>
<filtro campo="xxxxx" valor="yyyyyy" />
</filtros_avancados>
</requisicao>
- <parametros> - Parâmetros adicionais que informam ao DANFE View que informações ele deve extrair da base de dados.
- <filtros> - Filtros simples para a pesquisa dos documentos. Equivalem aos filtros presentes na tela de pesquisa do DANFE View.
- <filtros_avancados> - Filtros avançados para a pesquisa dos documentos. Equivalem aos filtros avançados na tela de pesquisa do DANFE View.
