Manuais:DANFEView/IntegracaoERP/ConsultarDocumentosAguardandoManifestacao
Integração: consultar a lista de documentos aguardando manifestação do destinatário
O sistema ERP pode solicitar ao DANFE View a lista de todos os documentos que aguardam por manifestação do destinatário.
Para tanto basta gerar um XML conforme esse modelo:
<?xml version="1.0" encoding="utf-8"?> <docsManifest> <dest>12.123.123/0001-12</dest> </docsManifest>
O XML de requisição pode ter qualquer nome e 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.
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\docsPendentes_12123123000112_20210601_13h00m00s.xml
- O XML de resposta será: C:\DANFEView\tmp\integracao\res\ret-docsPendentes_12123123000112_20210601_13h00m00s.xml
- Exemplo:
dest | CNPJ ou CPF do destinatário dos documentos para o qual deseja a lista daqueles que aguardam por manifestação. |
XML de resposta
<?xml version="1.0" encoding="utf-8"?> <retDocsManifest> <sucesso>1</sucesso> <xObs>OK</xObs> <ret nItem="1"> <emit> <cnpj>01.123.123/0001/12</cnpj> <cpf>123.123.123-12</cpf> <IE>001234512345</IE> <nome>Nome do emitente</nome> <UF>SP</UF> </emit> <chaveAcesso>12345678901234567890123456789012345678901234</chaveAcesso> <dEmi>AAAA-MM-DD</dEmi> <numero>123456789</numero> <tpNF>1</tpNF> <valor>100.00</valor> <cSitConfSEFAZ>0</cSitConfSEFAZ> <cSitConf>0</cSitConf> <xJust>Justificativa, quando cSitConf=Não realizada</xJust> <erro>Erro na tentativa de envio da manifestação para a SEFAZ</erro> <memorizado>0</memorizado> <dhInclusao>AAAA-MM-DD HH:MM:SS</dhInclusao> </ret> ... <ret chaveAcesso="23456789012345678901234567890123456789011234"> ... </ret> </retDocsManifest>
sucesso |
Pode conter:
|
xObs | Preenchida com:
|
Caso sucesso=1, a resposta conterá um grupo de TAGS <ret> para cada documento encontrado na base de dados que aguardam por manifestação do destinatário definido no XML de envio, com as TAGs:
emit | Dados do emitente do documento |
dEmi | Data de emissão |
numero | Número do documento |
tpNF | Tipo da Nota Fiscal |
valor | Valor total do documento |
cSitConfSEFAZ | Status da manifestação desse documento na SEFAZ, podendo ser:
NOTA: essa TAG apresenta o status da última manifestação do destinatário enviada pelo DANFE View à SEFAZ com sucesso. Caso outra manifestação tenha sido enviada por outro sistema, mesmo que seja o DANFE View em outra instalação, ela não aparecerá aqui. |
cSitConf | Status da manifestação desse documento na DANFE View, podendo ser:
NOTA: cSitConf é igual à cSitConfSEFAZ quando a manifestação do destinatário já foi enviada com sucesso à SEFAZ, ou é diferente quando uma manifestação já foi inserida no sistema mas ainda não foi enviada à SEFAZ, ou houve falha na tentativa de envio. |
xJust | Justificativa, quando cSitConf=3 |
erro | Erro recebido na última tentativa de envio da manifestação para a SEFAZ |
memorizado | O XML dsse documento já foi memorizado e está na base de dados?
|
dhInclusao | Data e hora da inclusão desse resumo do documento na base de dados.
Geralmente é a data/hora em que recebemos a resposta da consulta de documentos para manifestação do destinátio enviada à SEFAZ. |