Mudanças entre as edições de "Manuais:DANFEView/IntegracaoERP/ConsultarManifestacao"
Linha 60: | Linha 60: | ||
A resposta conterá um grupo de TAGS <ret> para cada chave de acesso do XML de envio, com as TAGs: | A resposta conterá um grupo de TAGS <ret> para cada chave de acesso do XML de envio, com as TAGs: | ||
− | + | <chaveAcesso> - Chave de acesso do documento; | |
− | + | <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 | |
− | + | <xObs> - 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 das 10h29min 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> <ret> <chaveAcesso>12345678901234567890123456789012345678901234</chaveAcesso> <status>2</status> <xObs>Alguma obseervação aqui<xObs> </ret> ... <ret> <chaveAcesso>23456789012345678901234567890123456789012345</chaveAcesso> <status>0</status> <xObs>Mensagem de erro ocorrido na tentativa de envio da manifestação<xObs> </ret> </retStatusManifest>
A resposta conterá um grupo de TAGS <ret> para cada chave de acesso do XML de envio, com as TAGs:
<chaveAcesso> - Chave de acesso do documento;
<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
<xObs> - 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.