ConsultarDistribuicaoDFe(aCodigoUF, aCNPJCPF, aNSU, aTipoNSU)
Função de "Consulta da Relação de Documentos a serem distribuídos para determinado CPF ou CNPJ de acordo com a NF-e" para quando for realizar a consulta das notas emitidas contra o seu CNPJ.
Método
ConsultarDistribuicaoDFe(aCodigoUF, aCNPJCPF : string; aNSU: string; aTipoNSU: TNSUKind): string;
Parâmetros
Argumento | Tipo | Detalhes |
aCodigoUF | String | Código da UF à qual será feita a consulta DF-e. Ex: 41 (PARANÁ) |
aCNPJCPF | String | CPF ou CNPJ que solicitou a Distribuição DF-e. Ex: "12345678912" ou "12345678911234" |
aNSU | String | Número NSU (Número Sequencial Unico) para consulta. Ex: "000000000000001" |
aTipoNSU | TNSUKind |
Tipo do NSU. É o tipo que será utilizado para requisição Especifico ou o Ultimo. Ex: nkEspecifico
|
Retorno
O método ConsultarDistribuicaoDFe retorna os XMLs Destinados pela busca do NSU.
Exemplos
Delphi
spdNFe.ConsultarDistribuicaoDFe('41','11111111111111','000000000000001',nkUltimo);
C#
spdNFe.ConsultarDistribuicaoDFe("41", "11111111111111", "000000000000001", TipoNSU.nkUltimo);
Visual Basic 6
spdNFe.ConsultarDistribuicaoDFe "41", "11111111111111", "000000000000001", nkUltimo
PHP
$spdNFe.ConsultarDistribuicaoDFe ("41", "11111111111111", "000000000000001", 0 = nkUltimo ou 2 =nkEspecifico)
Notas
-
A SEFAZ irá bloquear o CNPJ por um período de tempo caso sejam realizadas muitas consultas, em sequência, com o mesmo número do NSU.
-
Salve sempre o último número do NSU para evitar o bloqueio da SEFAZ.
-
A quantidade máxima de documentos retornados é 50 por NSU.
Atenção as novas regras sobre uso indevido
04/03/2022 - Atualização das Regras de Uso Indevido do Web Service NFeDistribuicaoDFe - NT 2014.002
Visando garantir a sustentabilidade dos serviços de download de NF-e, Web Service NFeDistribuicaoDFe, regulamentados pela NT 2014.002, estará vigente a partir de 10/03/22, concomitante com o retorno das consultas consChNFe e consNSU, as seguintes regras de uso indevido:
1 - O uso indevido relativo ao Web Service NFeDistribuicaoDFe na consulta com tag:distNSU:
1.1 - Não há mais documentos a distribuir e usuário continua consultando:
Se não existir mais documentos a serem retornados (cStat=137) o usuário deve aguardar uma hora para realizar nova consulta. A realização de novas consultas em 1h, após receber a mensagem cStat137, gerará o uso indevido, retornando cStat=656. Nesse caso, o CNPJ é bloqueado por 1 hora, sendo impedido de realizar novas consultas nesse intervalo. Decorrido o intervalo de tempo, o desbloqueio será automático.
O campo xMotivo traz a seguinte descrição para ajudar o usuário a entender o que está causando o uso indevido: "Rejeicao: Consumo Indevido. Deve ser aguardado 1 hora para efetuar nova solicitação caso não existam mais documentos a serem pesquisados. Tente apos 1 hora"
1.2 - Usuário não está consultando os NSU de forma sequencial:
O usuário deve sempre realizar a consulta baseada no ultNsu retornado na consulta anterior, ou seja, deve usar os valores do ultNSU retornados pelo serviço nas chamadas subsequentes. O valor do ultNSU corresponde ao ponto de onde a leitura dos blocos de documentos deve continuar. Quando ultNSU for igual ao valor do maxNSU retornado pelo serviço, quer dizer que não existem mais documentos para serem recuperados. Neste caso, para não haver bloqueio por uso indevido, deve-se aguardar 1 hora para realização de novas consultas.
Se consultar fora da sequência, será bloqueado. Decorrido o intervalo de tempo, o desbloqueio será automático.
O campo xMotivo traz a seguinte mensagem: "Rejeicao: Consumo Indevido. Deve ser utilizado o ultNSU nas solicitacoes subsequentes. Tente apos 1 hora"
Atenção: Se diversas aplicações do mesmo ator (emitente ou destinatário ou transportador na NF-e ou indicado no campo autxml) da NF-e efetuarem consultas por NSU para o mesmo CNPJ (14 dígitos - informado na requisição xml), essas devem seguir a mesma sequência de numeração ordenada e de forma ascendente. Caso contrário, enquadrar-se-ão na categoria de uso indevido.
2 - O uso indevido relativo ao Web Service NFeDistribuicaoDFe nas consultas com tag: consChNFe e tag: consNSU:
As consultas por chave de acesso e por NSU foram construídas para permitirem ao usuário buscar pontualmente alguma NF-e e de um período retroativo máximo de 90 (noventa) dias. Se o usuário necessitar buscar todas as NF-es de no máximo 90 dias de um CNPJ ator interessado, deve ser usada a consulta "distNSU".
2.1 Consultada uma quantidade de NF-e ou NSU superior ao limite permitido por hora:
Será permitido um número limitado de consultas por chave de acesso ou NSU em um período de 1hora. Se o usuário continuar consultando após atingir o limite de consultas por chave de acesso ou NSU em 1h, retornará a mensagem 656 - Consumo indevido - ultrapassou o limite de 20 consultas por hora. Nesse caso, o CNPJ é bloqueado por 1 hora, sendo impedido de realizar novas consultas nesse intervalo. Decorrido o intervalo de tempo, o desbloqueio será automático.
Observação: Em quaisquer dos três tipos de consulta, quando o usuário receber a mensagem 656 - consumo indevido, deve aguardar 1hora. Se retomar a consulta antes de completar 1 (uma) hora, o tempo é zerado e a contagem reiniciará até completar 1hora.
Comentários
0 comentário
Por favor, entre para comentar.