Mudanças entre as edições de "Manuais:DANFEView/IntegracaoERP/ManifestarDocumentos"
| (5 revisões intermediárias pelo mesmo usuário não estão sendo mostradas) | |||
| Linha 15: | Linha 15: | ||
<xJust>JUSTIFICATIVA DE NÃO TER REALIZADO A OPERAÇÃO</xJust> | <xJust>JUSTIFICATIVA DE NÃO TER REALIZADO A OPERAÇÃO</xJust> | ||
</env> | </env> | ||
| − | ... | + | <env> |
| + | ... | ||
| + | </env> | ||
</manifest> | </manifest> | ||
</pre> | </pre> | ||
| Linha 77: | Linha 79: | ||
A TAG <sucesso> pode conter: | 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: a manifestação do destinatário não está configurada no DANFE View. | * "0" - em caso de erro geral no processamento. Nesse caso, nenhum documento contido no XML de envio foi processado. Ex: a manifestação do destinatário não está configurada no DANFE View. | ||
| − | * "1" - o lote foi processado, e as manifestações | + | * "1" - o lote foi processado, e as manifestações foram enviadas à SEFAZ pelo DANFE View. Nesse caso um grupo de TAGs <ret> é gerado para cada documento do XML de envio indicando se o mesmo foi enviado corretamente ou não. |
A TAG <xObs> será preenchida com: | A TAG <xObs> será preenchida com: | ||
| Linha 86: | Linha 88: | ||
<sucessoDoc> - podendo conter: | <sucessoDoc> - podendo conter: | ||
| − | * " | + | * "1" - o documento foi manifestado |
| − | * " | + | * "0" - o documento não foi manifestado, pois pode não ter passado pela validação do DANFE View ou ter sido rejeitado pela SEFAZ. |
<xObsDoc> - poderá conter: | <xObsDoc> - poderá conter: | ||
| − | * | + | * Informações sobre o erro, se sucessoDoc=0 |
| − | |||
Edição atual tal como às 18h22min de 1 de dezembro de 2021
Integração: enviar Manifestações do Destinatário para o DANFE View
O sistema ERP pode informar ao DANFE View como ele deve manifestar os documentos que estão aguardando a respectiva manifestação.
Para tanto basta gerar um XML com as informações dos documentosS e das manifestações, conforme esse modelo:
<?xml version="1.0" encoding="utf-8"?>
<manifest>
<xUsuario>NOME DO USUARIO RESPOSNSÁVEL PELA MANIFESTAÇÃO</xUsuario>
<env>
<chaveAcesso>12345678901234567890123456789012345678901234</chaveAcesso>
<cSitConf>3</cSitConf>
<xJust>JUSTIFICATIVA DE NÃO TER REALIZADO A OPERAÇÃO</xJust>
</env>
<env>
...
</env>
</manifest>
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 XML 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\manif-2021-11-10_09-27-54.xml O XML de resposta será: C:\DANFEView\tmp\integracao\res\ret-manif-2021-11-10_09-27-54.xml
O XML de retorno informará se o XML de envio foi aceito e, para cada chave de acesso contido nesse XML de envio, haverá um grupo de TAGs <ret> com a resposta específica da chave de acesso em questão. Veja "XML de retorno" abaixo para mais informações.
TAGS do XML de envio
| chaveAcesso | Chave de acesso do documento. Esse documento deve existir na tela "Manifestação do Destinatário", do DANFE View. |
| cSitConf | Situação da manifestação, podendo ser:
|
| xJust | Justificativa obrigatória quando a manifestação for tipo "3" (operação não realizada). |
| xUsuario | Nome para identificar o responsável pela manifestação no sistema DANFE View |
Todas as TAGs são obrigatórias, exceto a TAG "xJust" quando "cSitConf" for diferente de "3".
XML de retorno
<?xml version="1.0" encoding="utf-8"?>
<retManifest>
<sucesso>1</sucesso>
<xObs>OK</xObs>
<ret chaveAcesso="12345678901234567890123456789012345678901234">
<sucessoDoc>1</sucessoDoc>
<xObsDoc>OK</xObsDoc>
</ret>
...
</retManifest>
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: a manifestação do destinatário não está configurada no DANFE View.
- "1" - o lote foi processado, e as manifestações foram enviadas à SEFAZ pelo DANFE View. Nesse caso um grupo de TAGs <ret> é gerado para cada documento do XML de envio indicando se o mesmo foi enviado corretamente ou não.
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; Exemplo: "A manifestação do destinatário não está configurada no DANFE View".
Em caso de sucesso=1, um grupo de TAGs <ret> será gerado para cada documento do XML de envio, com as TAGs:
<sucessoDoc> - podendo conter:
- "1" - o documento foi manifestado
- "0" - o documento não foi manifestado, pois pode não ter passado pela validação do DANFE View ou ter sido rejeitado pela SEFAZ.
<xObsDoc> - poderá conter:
- Informações sobre o erro, se sucessoDoc=0
