Mudanças entre as edições de "Manuais:DANFEView/IntegracaoERP/ConsultarManifestacao"
| (9 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 44: | Linha 44: | ||
<?xml version="1.0" encoding="utf-8"?> | <?xml version="1.0" encoding="utf-8"?> | ||
<retStatusManifest> | <retStatusManifest> | ||
| − | < | + | <sucesso>1</sucesso> |
| − | + | <xObs>OK</xObs> | |
| − | < | + | <ret chaveAcesso="12345678901234567890123456789012345678901234"> |
| − | < | + | <cSitConf>2</cSitConf> |
| + | <xObsDoc>Alguma observação aqui</xObsDoc> | ||
</ret> | </ret> | ||
... | ... | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
</retStatusManifest> | </retStatusManifest> | ||
</pre> | </pre> | ||
| − | A | + | 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. | |
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.
