Manuais:DANFEView/IntegracaoERP/ConsultarDocumentosAguardandoManifestacao

De unimake
Revisão de 08h48min de 10 de dezembro de 2021 por Sergio (discussão | contribs)
Ir para: navegação, pesquisa

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
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:

  • "0" - em caso de erro geral no processamento. Nesse caso nenhum documento será retornado. Ex: XML de envio não foi reconhecido pelo DANFE View
  • "1" - o lote foi processado.
xObs Preenchida com:
  • "OK", se sucesso=1, ou
  • Mensagem de erro gerada pelo DANFE View no processamento da requisição, se sucesso=0.

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:
  • "0" - Sem manifestação
  • "1" - Confirmada
  • "2" - Desconhecimento
  • "3" - Operação não realizada
  • "4" - Ciência da operação
  • vazio - No caso de algum erro ter ocorrido ao localizar a chave de acesso na base de dados.

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:
  • "0" - Sem manifestação
  • "1" - Confirmada
  • "2" - Desconhecimento
  • "3" - Operação não realizada
  • "4" - Ciência da operação

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?
  • 0 - Não
  • 1 - Sim
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.