Mudanças entre as edições de "Manuais:DANFEView/IntegracaoERP/ManifestarDocumentos"
Linha 23: | Linha 23: | ||
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. | ||
− | Após ser lido, o arquivo XML da requisição é automaticamente removido pelo DANFE View, e | + | 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: | Exemplo: | ||
Linha 55: | Linha 55: | ||
|} | |} | ||
Todas as TAGs são obrigatórias, exceto a TAG "xJust" quando "cSitConf" for diferente de "3". | Todas as TAGs são obrigatórias, exceto a TAG "xJust" quando "cSitConf" for diferente de "3". | ||
+ | |||
+ | |||
+ | == XML de retorno == | ||
+ | |||
+ | <pre> | ||
+ | <?xml version="1.0" encoding="utf-8"?> | ||
+ | <retManifest> | ||
+ | <sucesso>0</sucesso> | ||
+ | <erro>Mensagem de erro aqui</erro> | ||
+ | </retManifest> | ||
+ | </pre> | ||
+ | |||
+ | A TAG <sucesso> pode conter: | ||
+ | * "0" - em caso de erro | ||
+ | * "1" - o lote foi processado, e os documentos serão processados pelo DANFE View logo mais. | ||
+ | |||
+ | A TAG <erro> será preenchida com a mensagem de erro gerada pelo DANFE View no processamento da requisição, como por exemplo "A manifestação do destinatário não está configurada nesse sistema". |
Edição das 10h37min de 26 de novembro 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 do documento e da manifestação, conforme esse modelo:
<?xml version="1.0" encoding="utf-8"?> <manifest> <chaveAcesso>12345678901234567890123456789012345678901234</chaveAcesso> <cSitConf>3</cSitConf> <xJust>JUSTIFICATIVA DE NÃO TER REALIZADO A OPERAÇÃO</xJust> <xUsuario>NOME DO USUARIO RESPOSNSÁVEL PELA MANIFESTAÇÃO</xUsuario> </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 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 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-12345678901234567890123456789012345678901234.xml O XML de resposta será: C:\DANFEView\tmp\integracao\res\ret-manif-12345678901234567890123456789012345678901234.xml
Observe que o fato de o DANFE View não gerar uma resposta ao ler o XML de envio não significa que a manifestação foi efetuada com sucesso, pois o processo é assíncrono. A manifestação será enviada à SEFAZ em outro momento, de acordo com a periodicidade configurada no DANFE View. Caso ocorra alguma rejeição da SEFAZ a informação poderá ser verificada pela interface do DANFE View.
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>0</sucesso> <erro>Mensagem de erro aqui</erro> </retManifest>
A TAG <sucesso> pode conter:
- "0" - em caso de erro
- "1" - o lote foi processado, e os documentos serão processados pelo DANFE View logo mais.
A TAG <erro> será preenchida com a mensagem de erro gerada pelo DANFE View no processamento da requisição, como por exemplo "A manifestação do destinatário não está configurada nesse sistema".