Manuais:UniNFe/duv3

Como faço para fazer download dos XML das NFe´s dos fornecedores, ou seja, NFe´s emitidos contra o meu CNPJ?

Siga os seguintes passos para fazer o download dos XML dos documentos fiscais eletrônicos emitidos pelos fornecedores, ou seja, contra o seu CNPJ:

1. Estude a nota técnica da SEFAZ que trata da consulta da relação de documentos fiscais eletrônicos destinados: Clique aqui.
2. Estude sobre o evento de manifestação do destinatário no manual de integração do contribuinte da SEFAZ: Clique aqui.

Para fazer a integração com o UniNFe siga os seguintes passos na sequencia:

1. Efetue a consulta da relação dos documentos fiscais eletrônicos destinados: Clique aqui.
   1. Neste momento você irá receber uma relação das chaves dos documentos destinados
2. Efetue a manifestação do destinatário: Clique aqui.
   1. Depois da manifestação você pode fazer uma nova consulta da relação dos documentos fiscais eletrônicos destinados para obter os XML dos documentos.

• É importante saber que a SEFAZ só libera o download do XML de alguns documentos depois da manifestação realizada. Analise estes detalhes nos manuais da SEFAZ sugeridos acima.

Passo a passo de como realizar a operação

A Consulta pelo ultNSU permite baixar todas as notas onde o CNPJ está autorizado (seja como destinatário, autorizado no grupo <autXML>, transportadora ou outro papel na NFe).

Para isso, basta utilizar o XML abaixo e seguir corretamente o fluxo de consultas:

XML para consulta pelo <ultNSU>

xml
<?xml version="1.0" encoding="utf-8"?>
<distDFeInt versao="1.01" xmlns="http://www.portalfiscal.inf.br/nfe">
   <tpAmb>1</tpAmb> <!-- Ambiente: 1 = Produção, 2 = Homologação -->
   <cUFAutor>35</cUFAutor> <!-- UF do contribuinte -->
   <CNPJ>06117723000112</CNPJ> <!-- CNPJ da transportadora -->
   <distNSU>
      <ultNSU>123456789012345</ultNSU> <!-- Último NSU processado -->
   </distNSU>
</distDFeInt>

Na tag <CNPJ>, você deve informar o CNPJ do interessado que deseja baixar os XML´s, pois a Receita Federal devolverá todas as NF-es onde este CNPJ estiver autorizado a visualizar o XML.

Cuidados e Considerações Importantes

A consulta utilizando ultNSU tem algumas particularidades que precisam ser seguidas corretamente para evitar problemas. Aqui estão os principais pontos que você deve observar:

O fluxo correto da consulta pelo ultNSU

• Sempre comece do NSU 000000000000000 (caso esteja consultando pela primeira vez).
• A cada consulta, pegue o valor retornado na tag <ultNSU> e salve no seu banco de dados.
• Continue consultando até que ultNSU seja igual a maxNSU, pois isso significa que não há mais documentos pendentes.
• Atingindo o maxNSU aguarde 1h10m para realizar a próxima consulta, evitando, assim, o consumo indevido.

Exemplo do Fluxo de Consulta

1. Consulta ultNSU = 0.
2. SEFAZ retorna um lote de até 50 NSUs.
3. Pegue o último NSU retornado e consulte novamente.
4. Repita o processo até ultNSU == maxNSU.

Possíveis Furos na Sequência do NSU

• A Receita Federal retorna os NSUs de forma sequencial, mas pode haver furos na sequência.
• Se um NSU foi "pulado", você deve consultá-lo individualmente usando <consNSU>, pois ele pode conter um XML importante.

Exemplo de um furo no NSU

• Você consulta e recebe os NSUs: `100, 101, 103, 104` (note que o 102 está faltando).
• Para garantir que não perdeu nenhuma nota, você deve fazer uma consulta específica para o NSU 102:

<distDFeInt versao="1.01" xmlns="http://www.portalfiscal.inf.br/nfe">
   <tpAmb>1</tpAmb>
   <cUFAutor>35</cUFAutor>
   <CNPJ>06117723000112</CNPJ>
   <consNSU>
      <NSU>102</NSU>
   </consNSU>
</distDFeInt>

Isso garante que nenhum documento seja perdido.

A Receita Federal só permite baixar notas dos últimos 180 dias

• Se a transportadora nunca utilizou esse serviço, somente poderá baixar NF-es a partir da data da primeira consulta.
• Se o CNPJ ficar sem consultar por mais de 60 dias, a Receita reseta o NSU e você só poderá baixar NF-es emitidas a partir da nova consulta.

Algumas notas podem não estar disponíveis imediatamente

• Notas muito recentes podem levar alguns minutos para estarem disponíveis no webservice da Receita.
• Notas de alguns estados podem demorar a serem sincronizadas com o ambiente nacional**, especialmente quando a NF-e é emitida via web services estaduais.

Manifestação do destinatário

• Quando o interessado é o destinatário da nota, para baixar o XML completo da NF-e (e não apenas o "resumo"), você precisa fazer a manifestação do destinatário.
• Se a interessado não fizer a manifestação, pode receber apenas um resumo do XML sem os detalhes da NF-e.

Como manifestar automaticamente?

• Utilize o evento de Ciência da Operação (tpEvento = 210210). Posteriormente o usuário pode manifestar se reconhece ou não a NFe.
• Depois de manifestada, a Receita libera o XML completo e será entregue nas futuras consultas do NSU.

Resumo Final

1. Use ultNSU para baixar todas as notas onde o CNPJ do interessado está autorizado.
2. Sempre consulte até ultNSU == maxNSU para garantir que todos os documentos foram baixados.
3. Atingindo o maxNSU aguarde 1h10m para realizar a próxima consulta, evitando, assim, o consumo indevido.
4. Verifique se há "furos" na sequência dos NSUs e consulte manualmente os que faltaram.
5. A Receita só libera notas dos últimos 180 dias. Se for a primeira consulta, apenas NF-es emitidas após esse momento estarão disponíveis.
6. Se o CNPJ ficar sem consultar por 60 dias, a Receita "reseta" a consulta e você perde acesso às notas antigas.
7. Considere manifestar as notas automaticamente para garantir que possa baixar o XML completo.