Mudanças entre as edições de "Manuais:UniNFe/duv2"

De unimake
Ir para: navegação, pesquisa
(Ajustado cor e tamanho do título)
 
(5 revisões intermediárias pelo mesmo usuário não estão sendo mostradas)
Linha 1: Linha 1:
 
__NOTITLE__
 
__NOTITLE__
−
===<font color=#008000>'''1) DF-e foi autorizado e não gerou o arquivo de distribuição do DF-e, como faço para gerar?'''</font>===
+
==<font color="#008000">'''1) O DF-e foi autorizado, mas não gerou o arquivo de distribuição do DF-e. Como faço para gerá-lo?'''</font>==
  
−
Por vezes ocorre de perdermos o XML de distribuição do DFe. Diante desta situação foi criado no UniNFe uma rotina que permite reconstruir estes XML, veja abaixo como proceder neste caso:
+
Às vezes, pode acontecer de o XML de distribuição do DF-e ser perdido. Para solucionar isso, o '''UniNFe''' disponibiliza uma rotina para reconstrução dos XMLs de distribuição. Siga os passos abaixo:
  
−
Localize o XML do DFe que foi gerado pelo ERP e copie-o para a pasta "EmProcessamento" que fica dentro da pasta dos documentos "Enviados" (configurado no UniNFe).
+
* Localize o XML do DF-e gerado pelo ERP e copie-o para a pasta "EmProcessamento", localizada dentro da pasta de documentos "Enviados" (configurada no UniNFe).
−
O XML pode ser localizado nas seguintes pastas:
+
** O XML pode estar em uma das seguintes pastas:
−
Pasta de XML com erro. Basta mover para a pasta "EmProcessamento".
+
*** '''Pasta de XML com erro:''' basta movê-lo para a pasta "EmProcessamento".
−
Pasta de XML "EmProcessamento", neste caso não é necessário mover, pois ele já está na pasta correta.
+
*** '''Pasta "EmProcessamento":''' caso já esteja nessa pasta, nenhuma ação adicional é necessária.
−
Gere uma consulta situação do DFe (-ped-sit.xml) do documentos copiados para a pasta "EmProcessamento", com isso o UniNFe irá gerar os XML de distribuição.
+
* Gere um XML de consulta de situação do DF-e (<code>-ped-sit.xml</code>) para os documentos copiados para a pasta "EmProcessamento".
 +
** O '''UniNFe''' processará o XML e gerará os arquivos de distribuição correspondentes.
  
−
===<font color=#008000>'''2) Não localizei o XML do DFe gerado pelo ERP em nenhuma das pastas citadas anteriormente, o que faço?'''</font>===
+
==<font color="#008000">'''2) Não consigo localizar o XML do DF-e gerado pelo ERP em nenhuma das pastas mencionadas anteriormente. O que devo fazer?'''</font>==
  
−
O ERP deve gerar o XML novamente idêntico ao anterior, sem mudar nenhuma informação, caso contrário a assinatura não terá validade.
+
Caso o XML gerado pelo ERP não seja localizado, siga este procedimento:
  
−
Neste caso, ao invés de gerar o XML na pasta de "Envio", ele deve gerar na pasta para somente "Validação" (configurado no UniNFe).
+
* O ERP deve gerar novamente o XML, '''exatamente igual ao original''', sem qualquer alteração nas informações.
 +
** Alterações no conteúdo invalidarão a assinatura do XML.
 +
* Em vez de gerar o XML na pasta "Envio", ele deve ser gerado na pasta exclusiva de "Validação" (configurada no UniNFe).
 +
** O XML será validado e movido automaticamente para a subpasta "Validados", dentro da pasta "Validar".
 +
* Com o XML validado em mãos, mova-o para a pasta "EmProcessamento" e siga os passos descritos na pergunta 1.
  
−
O XML será validado e movido para a pasta "Validados", subpasta da pasta "Validar".
+
===IMPORTANTE===
  
−
Agora com o XML assinado em mãos, basta move-lo para a pasta "EmProcessamento" e executar o processo da pergunta 1.
+
Os desenvolvedores podem implementar uma rotina automatizada no ERP para evitar problemas recorrentes. Veja como:
  
−
 
+
* Após o ERP gerar o XML do DF-e na pasta de envio, se não receber o protocolo em cerca de 30 segundos, o sistema pode executar automaticamente o processo descrito nas perguntas 1 e 2, sem intervenção do usuário.
−
<font color=#008000>'''IMPORTANTE:'''</font>
+
* '''Evite gerar o mesmo XML do DF-e enquanto o UniNFe estiver processando:'''
−
 
+
** Permitir a geração do mesmo DF-e durante o processamento pode causar problemas no tratamento do XML.
−
O desenvolvedor pode automatizar esta rotina no ERP, fazendo o seguinte:
+
** O ERP deve impedir que o usuário gere um novo XML para o mesmo DF-e antes de obter o retorno do processamento do primeiro envio.
−
Depois que o ERP gerar o XML do DFe na pasta de envio, se não receber o protocolo em aproximadamente 30 segundos, ele pode executar o processo descrito na pergunta 1 e 2 automaticamente, sem intervenção do usuário, automatizando o processo.
+
** Assim, o ERP poderá tomar decisões sobre a possibilidade de gerar ou não um novo XML.
−
Um dos motivos que pode ocasionar este problema é o ERP permitir o usuário gerar o XML do DF-e na pasta envio, o UniNFe começar a processar e antes de terminar o usuário gerar o mesmo XML novamente, com isso ocorre um problema no processamento do XML. Não permita o usuário do ERP gerar o mesmo DF-e antes que tenha os retornos do primeiro XML enviado, com isso o ERP conseguirá tomar uma decisão se permite ou não gerar novamente.
+
* Certifique-se de que, nas configurações do '''UniNFe''', está marcada a opção para verificar se o valor da tag <code><digestValue></code> retornado na consulta coincide com o da assinatura do XML do DF-e. (Veja imagem abaixo)
 +
** Se houver divergência, o '''UniNFe''' retornará um erro na pasta "Retorno", prevenindo que um protocolo incorreto seja associado ao XML do DF-e errado.
 +
<br>
 +
<br>
 +
<br>
 +
[[Arquivo:ConfiguracaoDigestValue.png|800px|center]]

Edição atual tal como às 16h29min de 18 de dezembro de 2024

1) O DF-e foi autorizado, mas não gerou o arquivo de distribuição do DF-e. Como faço para gerá-lo?

Às vezes, pode acontecer de o XML de distribuição do DF-e ser perdido. Para solucionar isso, o UniNFe disponibiliza uma rotina para reconstrução dos XMLs de distribuição. Siga os passos abaixo:

  • Localize o XML do DF-e gerado pelo ERP e copie-o para a pasta "EmProcessamento", localizada dentro da pasta de documentos "Enviados" (configurada no UniNFe).
    • O XML pode estar em uma das seguintes pastas:
      • Pasta de XML com erro: basta movê-lo para a pasta "EmProcessamento".
      • Pasta "EmProcessamento": caso já esteja nessa pasta, nenhuma ação adicional é necessária.
  • Gere um XML de consulta de situação do DF-e (-ped-sit.xml) para os documentos copiados para a pasta "EmProcessamento".
    • O UniNFe processará o XML e gerará os arquivos de distribuição correspondentes.

2) Não consigo localizar o XML do DF-e gerado pelo ERP em nenhuma das pastas mencionadas anteriormente. O que devo fazer?

Caso o XML gerado pelo ERP não seja localizado, siga este procedimento:

  • O ERP deve gerar novamente o XML, exatamente igual ao original, sem qualquer alteração nas informações.
    • Alterações no conteúdo invalidarão a assinatura do XML.
  • Em vez de gerar o XML na pasta "Envio", ele deve ser gerado na pasta exclusiva de "Validação" (configurada no UniNFe).
    • O XML será validado e movido automaticamente para a subpasta "Validados", dentro da pasta "Validar".
  • Com o XML validado em mãos, mova-o para a pasta "EmProcessamento" e siga os passos descritos na pergunta 1.

IMPORTANTE

Os desenvolvedores podem implementar uma rotina automatizada no ERP para evitar problemas recorrentes. Veja como:

  • Após o ERP gerar o XML do DF-e na pasta de envio, se não receber o protocolo em cerca de 30 segundos, o sistema pode executar automaticamente o processo descrito nas perguntas 1 e 2, sem intervenção do usuário.
  • Evite gerar o mesmo XML do DF-e enquanto o UniNFe estiver processando:
    • Permitir a geração do mesmo DF-e durante o processamento pode causar problemas no tratamento do XML.
    • O ERP deve impedir que o usuário gere um novo XML para o mesmo DF-e antes de obter o retorno do processamento do primeiro envio.
    • Assim, o ERP poderá tomar decisões sobre a possibilidade de gerar ou não um novo XML.
  • Certifique-se de que, nas configurações do UniNFe, está marcada a opção para verificar se o valor da tag <digestValue> retornado na consulta coincide com o da assinatura do XML do DF-e. (Veja imagem abaixo)
    • Se houver divergência, o UniNFe retornará um erro na pasta "Retorno", prevenindo que um protocolo incorreto seja associado ao XML do DF-e errado.




ConfiguracaoDigestValue.png
Disponível em "http://wiki.unimake.com.br/index.php?title=Manuais:UniNFe/duv2&oldid=5603"