Mudanças entre as edições de "Manuais:DANFEView/IntegracaoERP/ConsultarManifestacao"
(4 revisões intermediárias pelo mesmo usuário não estão sendo mostradas) | |||
Linha 19: | Linha 19: | ||
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. | 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, bem como confusão entre requisições simultâneas nas diversas estações da rede | + | Aconselha-se que cada arquivo de requisição tenha sempre um nome exclusivo para evitar confusões entre requisições e respostas, bem como confusão entre requisições simultâneas nas diversas estações da rede. |
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 47: | Linha 47: | ||
<xObs>OK</xObs> | <xObs>OK</xObs> | ||
<ret chaveAcesso="12345678901234567890123456789012345678901234"> | <ret chaveAcesso="12345678901234567890123456789012345678901234"> | ||
− | < | + | <cSitConf>2</cSitConf> |
− | < | + | <xObsDoc>Alguma observação aqui</xObsDoc> |
</ret> | </ret> | ||
... | ... | ||
− | |||
− | |||
− | |||
− | |||
</retStatusManifest> | </retStatusManifest> | ||
</pre> | </pre> | ||
Linha 68: | Linha 64: | ||
Caso sucesso=1, a resposta conterá um grupo de TAGS <ret> para cada documento do XML de envio, com as TAGs: | Caso sucesso=1, a resposta conterá um grupo de TAGS <ret> para cada documento do XML de envio, com as TAGs: | ||
− | < | + | <cSitConf> - Status da manifestação desse documento, podendo ser: |
* "0" - Sem manifestação | * "0" - Sem manifestação | ||
* "1" - Confirmada | * "1" - Confirmada | ||
Linha 74: | Linha 70: | ||
* "3" - Operação não realizada | * "3" - Operação não realizada | ||
* "4" - Ciência da operação | * "4" - Ciência da operação | ||
+ | * vazio - No caso de algum erro ter ocorrido ao localizar a chave de acesso na base de dados. | ||
<xObsDoc> - Eventualmente poderá sem preenchida com: | <xObsDoc> - Eventualmente poderá sem preenchida com: |
Edição atual tal como às 09h55min de 10 de dezembro de 2021
Integração: consultar Status de Manifestações do Destinatário
O sistema ERP pode solicitar ao DANFE View o status de manifestação de documentos manifestados anteriormente, mesmo que a manifestação não tenha sido enviada pelo ERP.
Para tanto basta gerar um XML com as informações dos documentos, conforme esse modelo:
<?xml version="1.0" encoding="utf-8"?> <statusManifest> <chaveAcesso>12345678901234567890123456789012345678901234</chaveAcesso> <chaveAcesso>23456789012345678901234567890123456789012345</chaveAcesso> ... <chaveAcesso>34567890123456789012345678901234567890123456</chaveAcesso> </statusManifest>
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, bem como confusão entre requisições simultâneas nas diversas estações da rede.
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:
TAGS do XML de envio
chaveAcesso | Chave de acesso do documento. Esse documento deve existir na tela "Manifestação do Destinatário" ou já ter sido memorizado antes pelo DANFE View. |
XML de resposta
<?xml version="1.0" encoding="utf-8"?> <retStatusManifest> <sucesso>1</sucesso> <xObs>OK</xObs> <ret chaveAcesso="12345678901234567890123456789012345678901234"> <cSitConf>2</cSitConf> <xObsDoc>Alguma observação aqui</xObsDoc> </ret> ... </retStatusManifest>
A TAG <sucesso> pode conter:
- "0" - em caso de erro geral no processamento. Nesse caso, nenhum documento contido no XML de envio foi processado. Ex: XML de envio não foi reconhecido pelo DANFE View
- "1" - o lote foi processado.
A TAG <xObs> será preenchida com:
- "OK", se sucesso=1, ou
- Mensagem de erro gerada pelo DANFE View no processamento da requisição, se sucesso=0.
Caso sucesso=1, a resposta conterá um grupo de TAGS <ret> para cada documento do XML de envio, com as TAGs:
<cSitConf> - Status da manifestação desse documento, podendo ser:
- "0" - Sem manifestação
- "1" - Confirmada
- "2" - Desconhecimento
- "3" - Operação não realizada
- "4" - Ciência da operação
- vazio - No caso de algum erro ter ocorrido ao localizar a chave de acesso na base de dados.
<xObsDoc> - Eventualmente poderá sem preenchida com:
- Texto da justificativa, quando status=3;
- Mensagem de erro recebida da SEFAZ ao tentar enviar a manifestação.
- Mensagem de erro gerada pelo DANFE View, por exemplo, ao não localizar a chave de acesso em sua base de dados.