Manuais:DANFEView/IntegracaoERP/ConsultarManifestacao
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.