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.
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.
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
O atributo numeroPedidoLoja também pode ser utilizado para localizar a NF.
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.
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.
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.
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
Obrigado!