Artigos sobre: Recursos

Guia de Localização de Notas Fiscais no Bling V3

Com a recente migração para a versão 3 da API do Bling, a forma de localizar Notas Fiscais foi modificada. Antes, era possível buscar as notas diretamente pelo seu número. Entretanto, essa funcionalidade foi removida, exigindo que a pesquisa seja feita de outras maneiras.

O que mudou?

Versão 2 da API: Permitia a busca das Notas Fiscais pelo número da nota.

Versão 3 da API: A pesquisa pelo número da nota fiscal foi descontinuada. Agora, é necessário utilizar:

ID da Nota Fiscal, que pode ser encontrado no dashboard do Bling;

Atributo numeroPedidoLoja, correspondente ao número do pedido na plataforma do cliente.

Como localizar o ID da Nota Fiscal no Bling V3?

Acessando diretamente no painel do Bling:

O ID da NF está disponível no dashboard da plataforma.

Buscando na URL da Nota Fiscal:

Ao abrir a NF no Bling, observe a URL no navegador.

O ID da NF pode ser encontrado após o parâmetro idNota=.

Exemplo: https://www.bling.com.br/relatorios/danfe.php?idNota= 22388903691

Outra opção: Buscar pelo número do pedido da plataforma

O atributo numeroPedidoLoja também pode ser utilizado para localizar a NF.

Número do pedido do ecommerce

No entanto, em alguns casos, esse atributo está sendo retornado vazio, impossibilitando a busca. Caso isso ocorra, recomendamos:

Entrar em contato com o suporte do Bling para verificar a possibilidade de restaurar essa funcionalidade;

Ativar a configuração de envio do número do pedido da loja virtual, seguindo as instruções do artigo do Bling clicando aqui.

observação: Após realizar essa configuração, os próximos pedidos importados terão a informação preenchida nas informações complementares da nota fiscal.

Recomendação

Devido à remoção do filtro por número da NF, o processo de geração e localização de notas pode ser impactado. Recomendamos que os clientes:

Abram um chamado no Bling solicitando a reinserção do filtro por número da NF na API V3;

Utilizem o ID da NF ou a URL da nota para localizá-la temporariamente;

Para qualquer dúvida adicional, entre em contato com nossa equipe.

Actualizado em: 26/03/2025

Esse artigo foi útil?

Obrigado!