A Consulta DF-e pode auxiliar muitos clientes a terem o controle do material recebido, facilitando a entrada de forma automatizada no sistema, a SEFAZ Ambiente Nacional disponibiliza o serviço para consulta DF-e onde o cliente pode obter notas e eventos que foram destinadas ao seu CNPJ com até 90 dias após a emissão.

Utilizando o método ConsultarDistribuicaoDFe poderemos realizar a consulta da lista de notas disponíveis. Nesta consulta existe um identificador chamado NSU (Número Sequencial Único) que remete a cada nota ou evento listado. A consulta pode ser feita em um NSU específico ou então passando o mínimo e o máximo (limite de 50 por consulta).

Caso seja a primeira consulta, ou não tenha o NSU atual, utilizaremos o "000000000000000" no parâmetro aNSU e "nkUltimo" em aTipoNSU. (Acesse o link acima para obter maiores detalhes.)

Segue exemplo de XML de retorno da consulta de notas destinadas:

Considerando o XML de exemplo, quando o cStat retornar 138, significa que existem documentos disponíveis para a consulta.

Neste retorno também existem as tags ultNSU, referente ao ultimo NSU listado nesta consulta, e o maxNSU, que é o ultimo NSU disponível para consulta na SEFAZ. Neste cenário, o desenvolvedor deve implementar uma estrutura de consulta que incremente de 50 em 50, refazendo a consulta alterando o NSU passado como parâmetro até que ultNSU e maxNSU sejam iguais (Final da consulta).

Dentro do nó loteDistDFeInt teremos as tags docZip, que contém as informações compactadas, diferenciaremos o conteúdo das informações pelo atributo schema em cada uma delas, dentre as opções:

• resNFe: Nota Fiscal Eletrônica resumida (Nota que ainda não foi manifestada).
• resEvento:  Evento de uma Nota Fiscal Eletrônica resumido (De uma nota que ainda não foi manifestada)
• procNFe: Nota Fiscal Eletrônica completa (Nota que já está manifestada)
• procEventoNFe: Evento de uma Nota Fiscal Eletrônica completa ( De uma nota que já está manifestada).

Para obter o conteúdo das notas, deve ser utilizado o método DescompactarXMLZip, informando o conteúdo de cada tag docZip, segue um exemplo de XML descompactado de uma NF-e resumida (ainda não manisfestada):

Já temos algumas informações sobre a nota em questão,como a situação, na tag cSitNFe onde:

• 1: Uso autorizado no momento da consulta.
• 2: Uso denegado.
• 3: NF-e cancelada.

Assim como a chave, viabilizando a manifestação da mesma, para obter a nota completa. Utilizando o método EnviarManifestacaoDestinatario informando a chave da nota em questão e enviando um evento como "Ciência da Operação", por exemplo.

Após a manifestação, você deve utilizar o método ConsultarDistribuicaoDFeChave, informando a chave da nota, o retorno será o XML Zipado, utilizando o método DescompactarXMLZip obterá o XML completo.

Caso você utilize integração via API (Manager SaaS) veja o processo nesse link.