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.
Comentários
0 comentário
Por favor, entre para comentar.