Mudanças entre as edições de "Manuais:DANFEView/IntegracaoERP/ConsultarDocumentosAguardandoManifestacao"

De unimake
Ir para: navegação, pesquisa
 
(5 revisões intermediárias pelo mesmo usuário não estão sendo mostradas)
Linha 28: Linha 28:
 
|dest
 
|dest
 
|CNPJ ou CPF do destinatário dos documentos para o qual deseja a lista daqueles que aguardam por manifestação.
 
|CNPJ ou CPF do destinatário dos documentos para o qual deseja a lista daqueles que aguardam por manifestação.
 +
 
|}
 
|}
  
Linha 59: Linha 60:
 
   </ret>
 
   </ret>
 
   ...
 
   ...
−
   <ret chaveAcesso="23456789012345678901234567890123456789011234">
+
   <ret nItem="2">
 
  ...
 
  ...
 
   </ret>
 
   </ret>
Linha 71: Linha 72:
  
 
Pode conter:
 
Pode conter:
−
* "0" - em caso de erro geral no processamento. Nesse caso, nenhum documento contido no XML de envio foi processado. Ex: XML de envio não foi reconhecido pelo DANFE View
+
* "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.
 
* "1" - o lote foi processado.
  
 +
|-
 
|xObs
 
|xObs
 
|Preenchida com:
 
|Preenchida com:
Linha 84: Linha 86:
  
 
{| class="wikitable"
 
{| class="wikitable"
 +
 
|-
 
|-
 +
|emit
 +
|Dados do emitente do documento
  
−
<emit> - Dados do emitente do documento
+
|-
 +
|dEmi
 +
|Data de emissão
  
−
<dEmi> - Data de emissão
+
|-
 +
|numero
 +
|Número do documento
  
−
<numero> - Número do documento
+
|-
 +
|tpNF
 +
|Tipo da Nota Fiscal
  
−
<tpNF> - tipo da Nota Fiscal
+
|-
 +
|valor
 +
|Valor total do documento
  
−
<valor> - Valor total do documento
+
|-
−
 
+
|cSitConfSEFAZ
−
<cSitConfSEFAZ> - Status da manifestação desse documento na SEFAZ, podendo ser:
+
|Status da manifestação desse documento na SEFAZ, podendo ser:
 
* "0" - Sem manifestação
 
* "0" - Sem manifestação
 
* "1" - Confirmada
 
* "1" - Confirmada
Linha 103: Linha 116:
 
* "4" - Ciência da operação
 
* "4" - Ciência da operação
 
* vazio - No caso de algum erro ter ocorrido ao localizar a chave de acesso na base de dados.
 
* 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:
+
|-
 +
|cSitConf
 +
|Status da manifestação desse documento na DANFE View, podendo ser:
 
* "0" - Sem manifestação
 
* "0" - Sem manifestação
 
* "1" - Confirmada
 
* "1" - Confirmada
Linha 110: Linha 126:
 
* "3" - Operação não realizada
 
* "3" - Operação não realizada
 
* "4" - Ciência da operação
 
* "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.
 
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.
  
−
<xObsDoc> - Eventualmente poderá sem preenchida com:
+
Geralmente é a data/hora em que recebemos a resposta da consulta de documentos para manifestação do destinátio enviada à SEFAZ.
−
* 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.
 
  
 
|}
 
|}

Edição atual tal como às 09h52min de 10 de dezembro de 2021

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 nItem="2">
	  ...
   </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.

Disponível em "http://wiki.unimake.com.br/index.php?title=Manuais:DANFEView/IntegracaoERP/ConsultarDocumentosAguardandoManifestacao&oldid=3255"