Gostaria de consultar as Notas fiscais de produto e serviço emitidas contra o meu CNPJ.
Existe alguma API onde consiga realizar essa consulta?
Bom dia!
Para as notas fiscais de produto, você pode utilizar a Distribuição DFe para recuperar os arquivos emitidos contra o CNPJ.
Para isso você utilizaria o endpoint ConsultarDocumentoDistribuicaoNFe.
Já para as notas de serviço a resposta vai depender se o provedor implementa a consulta de notas por serviço prestado/tomado para os casos em que a nota for gerada no leiaute do provedor.
Para o padrão nacional existe consulta
EDIT:
A API do padrão nacional disponibiliza um serviço de consulta, no entanto, conforme indicado, o mesmo ainda não se encontra disponíveis nos endpoints da Nuvem Fiscal.
Eu consigo recuperar uma lista de NFs emitidas contra o meu CNPJ?
1 curtida
No momento isso não é possível para notas fiscais de serviço, apenas para notas fiscais de produto.
1 curtida
Há um limite para a busca de Notas Fiscais de produto. Por exemplo, é possível baixar até 5 mil notas por mês?
Além disso, consigo buscar uma lista de Notas Fiscais emitidas, incluindo aquelas que foram geradas fora da plataforma.
Nossos planos consistem em contratar um número mensal de “operações fiscais”.
Algumas atividades na API consome “operações fiscais”, entre elas a emissão de um documento fiscal e a baixa de uma nota fiscal de produto. O limite é estabelecido apenas nesse saldo de cotas que você contrato. As informações detalhadas de consumo estão neste link:
É possível baixar notas emitidas para um CNPJ usando nossa API de distribuição NFe.
Sobre os limites e custos, entendi as condições atuais. No entanto, há alguma outra forma de cobrança disponível? Preciso cadastrar vários CNPJs e coletar uma base de 1 milhão de Notas Fiscais por mês.
Boa tarde, @willian.mira.
Temos planos que atendem até 1 milhão de operações fiscais por mês.
Dê uma olhada neste tópico, pode ser útil para você:
Boa tarde,
Estou realizando testes no endpoint informado, para coletar as notas fiscais (NF) emitidas contra o CNPJ, mas o retorno da requisição está vindo vazio. Testei em outra plataforma e consegui recuperar dados de notas fiscais referentes aos últimos dois meses sem problemas.
Poderia analisar o cURL abaixo e verificar o que pode estar errado na minha requisição?
Request
curl --location ‘https://api.nuvemfiscal.com.br//distribuicao/nfe?%24top=10&%24skip=0&%24inlinecount=false&cpf_cnpj=**************&ambiente=producao’ \
–header ‘Accept: application/json’ \
–header ‘Authorization: Bearer eyJ0eXAiOiJKV1******’
response
{
“data”:
}
A mesma coisa acontece com o endpoint abaixo
https://api.nuvemfiscal.com.br/distribuicao/nfe/documentos?$top=10&$skip=0&$inlinecount=false&cpf_cnpj=**************&ambiente=producao&tipo_documento=nota&forma_distribuicao=completa&cons_nsu&dist_nsu.
Poderia informa onde estou errrando?
Boa tarde, @willian.mira.
Esses endpoints de listagem só retornarão os documentos que já foram baixados do ambiente nacional da SEFAZ para a Nuvem Fiscal. Para realizar essa “baixa” dos documentos, você deve utilizar o endpoint Distribuir documentos.
Alternativamente, pode ser habilitada a distribuição ou ciência automática dos documentos pelo endpoint Configuração de Distribuição de NF-e.
Arimateia, boa tarde.
Ao executar a atualização para realizar a baixa de forma automática, o resultado retornado é sempre “false”, conforme mostrado na imagem. Está correto assim?
De acordo com o print, os parâmetros estão sendo enviados via query url. Isso está incorreto.
Conforme a nossa documentação, eles devem ser enviados no body da requisição, em formato JSON:
1 curtida
Funcionou, obrigado! Irei testar a outra API.
Arimateia, peço desculpas pela quantidade de chamados, mas estou começando a entender a API agora.
Realizei o teste de POST e o retorno foi o que está no texto anexado. Quando executo com o parâmetro “dist_nsu” com um valor inferior a 3717, ocorre um outro erro. Nesse caso, nenhum documento é retornado.
curl --location 'https://api.nuvemfiscal. com.br//distribuicao/nfe' \--header 'Content-Type: application/json' \--header 'Accept: application/json' \--header 'Authorization: ••••••' \--data '{ "tipo_consulta": "dist-nsu", "ambiente": "producao", "cpf_cnpj": "******", "dist_nsu": 3700, "ignorar_tempo_espera": true}'```
response
{
“error”: {
“code”: “ValidationFailed”,
“message”: “O campo ‘dist_nsu’ deve ser igual a 3717.”
}
}```
Chamada 2
curl --location 'https://api.nuvemfiscal. com.br//distribuicao/nfe' \--header 'Content-Type: application/json' \--header 'Accept: application/json' \--header 'Authorization: ••••••' \--data '{ "tipo_consulta": "dist-nsu", "ambiente": "producao", "cpf_cnpj": "*********", "dist_nsu": 3717, "ignorar_tempo_espera": true}'```
Response
{
“id”: “3a19052b-7bf3-46e3-866c-ee84b95b6ac0”,
“created_at”: “2025-03-31T20:15:29.267Z”,
“status”: “concluido”,
“ambiente”: “producao”,
“tipo_consulta”: “dist-nsu”,
“dist_nsu”: 3717,
“codigo_status”: 137,
“motivo_status”: “Nenhum documento localizado”,
“data_hora_resposta”: “2025-03-31T20:15:29Z”,
“ultimo_nsu”: 3717,
“max_nsu”: 3717,
“documentos”:
}```
Reforçando, me parece que a busca está sendo realizado nas notas emitidas na última hora ou no dia corrente.
Dúvida, é possível coletar Notas passadas, ex mês passado?
Sem problemas quanto aos chamados, é natural surgir dúvidas no início mesmo.
O comportamento que você observou está correto: a API da Nuvem Fiscal identificou que o último NSU disponível na SEFAZ para esse CNPJ é o 3717. Por esse motivo, ela impede consultas com dist_nsu inferior, como forma de proteção contra consumo indevido, o que poderia levar ao bloqueio do contribuinte na SEFAZ.
Se quiser buscar um NSU específico, o ideal é utilizar o tipo de consulta cons-nsu, em vez de dist-nsu. Esse tipo é voltado justamente para busca direta por um número de NSU individual.
Depende. Caso o contribuinte nunca tenha utilizado a distribuição ou esteja há mais de 60 dias sem utilizá-lo, o serviço de distribuição estará desativado para o seu CNPJ e obter notas retroativas não será possível.
Para entender melhor como funciona o processo de distribuição, recomendamos a leitura dos materiais a seguir:
1 curtida
Olá, Arimateia, tudo bem? Tenho mais uma dúvida e gostaria da sua ajuda.
Eu consigo baixar notas fiscais emitidas pela minha empresa, mas que foram geradas fora da plataforma. Resumindo, preciso consultar tanto a lista de notas fiscais emitidas contra minha empresa quanto as notas fiscais emitidas por mim. Você pode me orientar sobre como fazer isso?
Agradeço desde já!
Bom dia, @willian.mira.
Sobre as notas fiscais emitidas pela sua empresa, não é possível baixá-las caso tenham sido emitidas fora da nossa API. Nem mesmo pelo serviço de distribuição DF-e isso é possível, pois o ambiente nacional da SEFAZ não gera NSU para o emitente da nota, apenas para os outros atores envolvidos, como o destinatário, transportador e terceiros autorizados.
Já as notas emitidas contra o seu CNPJ, ou seja, em que sua empresa é o destinatário, podem sim ser consultadas e baixadas via serviço de distribuição, desde que estejam disponíveis no ambiente nacional.