> For the complete documentation index, see [llms.txt](https://docs.floui.io/guia/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.floui.io/guia/conectores/categorias/servicos-externos/bling-erp-bling-api-v3/notas-fiscais/consulta-nota-fiscal.md).

# Consulta Nota Fiscal

{% tabs %}
{% tab title="Parâmetros" %}

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeGRRKGw0ITLUY6uLzP7UR1Cj7cGN5WZpJeJ1z3cLyf1LSo4Opk8iIGH4gFa_CUyijNRpUPjE6eTOejAWf-EeF5gLwyrTNfWO8ffU7eKKq3NxkHadd7MsX31HHq_xs7Pw7VSco7?key=yLogrgEbXy0K_a4zmB9ApgKO" alt=""><figcaption><p>Parâmetros de configuração</p></figcaption></figure>

| Campo                  | Tipo           | Descrição                                                                                                                                                                                                                                                   |
| ---------------------- | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Descrição              | Campo de texto | Descrição visual do conector no editor de fluxo                                                                                                                                                                                                             |
| Conta de serviço       | Seletor        | Permite selecionar a conta de serviço para conexão com ERP Bling. A conta de serviço deverá ser do tipo de autenticação OAuth2 e tipo de serviço Bling                                                                                                      |
| ID da conta de serviço | Campo de texto | <p>Configuração disponível quando selecionada a opção de conta de serviço personalizada.  </p><p></p><p>Permite inserir o identificador da conta de serviço Bling. Pode ser usado para aplicar valores dinâmicos utilizando a notação Mustache {{msg}} </p> |
| ID da nota fiscal      | Campo de texto | Identificador da nota fiscal cadastrada no ERP Bling.                                                                                                                                                                                                       |
| Output Path            | Campo de texto | Refere-se ao caminho do resultado da execução na saída do conector no contexto de execução do fluxo                                                                                                                                                         |
| {% endtab %}           |                |                                                                                                                                                                                                                                                             |

{% tab title="Configuração" %}

## Sucesso

A requisição deste conector é feita para a API V3 na rota **GET** `/nfe/{idNfe}`, permitindo obter as informações de uma nota fiscal registrado na plataforma Bling. A documentação oficial pode ser consultada através do link [Bling Developer](https://developer.bling.com.br/referencia#/Pedidos%20-%20Vendas/get_pedidos_vendas__idPedidoVenda_)&#x20;

Quando a execução é bem-sucedida, os dados da nota fiscal ficam disponíveis na carga de dados do conector. Além disso, a resposta inclui informações adicionais da consulta nas chaves `request` e `response`.

## Erro

Em caso de erro, como quando a nota fiscal não é encontrada, a API retornará uma mensagem de erro detalhando o problema. Além disso, as chaves `request` e `response` serão incluídas na resposta, contendo os dados da requisição para facilitar a análise.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdGA9su-xfFhaR-Mud0CHfXxK67vPus-aKM-V9FPHoWiT3qXMBJkeiOEF7pq9nybTZ3CR0NyFry0ElSckpgXcCeRwzOo0-Au7rgEwjehEmshzNj2aBRKesrVz0jhDiaK_xH3bUX?key=yLogrgEbXy0K_a4zmB9ApgKO" alt=""><figcaption><p>Erro na consulta de Nota Fiscal</p></figcaption></figure>
{% endtab %}
{% endtabs %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.floui.io/guia/conectores/categorias/servicos-externos/bling-erp-bling-api-v3/notas-fiscais/consulta-nota-fiscal.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.