Mudanças entre as edições de "Manuais:DANFEView/IntegracaoERP/ConsultarManifestacao"
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"> | <ret chaveAcesso="12345678901234567890123456789012345678901234"> | ||
<status>2</status> | <status>2</status> | ||
Linha 51: | Linha 53: | ||
<ret chaveAcesso="23456789012345678901234567890123456789012345"> | <ret chaveAcesso="23456789012345678901234567890123456789012345"> | ||
<status>0</status> | <status>0</status> | ||
− | < | + | <xObsDoc>Mensagem de erro ocorrido na tentativa de envio da manifestação</xObsDoc> |
</ret> | </ret> | ||
</retStatusManifest> | </retStatusManifest> | ||
</pre> | </pre> | ||
− | A resposta conterá um grupo de TAGS <ret> para cada | + | 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 o lote foi processado, ou | ||
+ | * Mensagem de erro gerada pelo DANFE View no processamento da requisição. | ||
+ | |||
+ | Caso sucesso=1, a resposta conterá um grupo de TAGS <ret> para cada documento do XML de envio, com as TAGs: | ||
<status> - Status da manifestação desse documento, podendo ser: | <status> - Status da manifestação desse documento, podendo ser: | ||
Linha 65: | Linha 75: | ||
* "4" - Ciência da operação | * "4" - Ciência da operação | ||
− | < | + | <xObsDoc> - Eventualmente poderá sem preenchida com: |
* Texto da justificativa, quando status=3; | * Texto da justificativa, quando status=3; | ||
* Mensagem de erro recebida da SEFAZ ao tentar enviar a manifestação. | * 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. | * Mensagem de erro gerada pelo DANFE View, por exemplo, ao não localizar a chave de acesso em sua base de dados. |
Edição das 11h00min de 26 de novembro 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 nome sugerido é no formato "manif-12345678901234567890123456789012345678901234.xml", ou seja, o prefixo "manif-" acrescido da chave de acesso do documento.
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"> <status>2</status> <xObs>Alguma obseervação aqui<xObs> </ret> ... <ret chaveAcesso="23456789012345678901234567890123456789012345"> <status>0</status> <xObsDoc>Mensagem de erro ocorrido na tentativa de envio da manifestação</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 o lote foi processado, ou
- Mensagem de erro gerada pelo DANFE View no processamento da requisição.
Caso sucesso=1, a resposta conterá um grupo de TAGS <ret> para cada documento do XML de envio, com as TAGs:
<status> - 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
<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.