Manuais:DANFEView/IntegracaoERP/ConsultarDocumentosAguardandoManifestacao

De unimake
Revisão de 08h39min 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.
<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. <xObsDoc> - 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.