# Consultar cliente

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

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeGlWsQ1iEy3J_vYVrBy318FejayLaFQkE7AB6I2OYdcsz2I_4LMbkLaXL2CECWEN8Q80MZiCW1IGT_TJDPKIG0lXk8K7lsHIKLOC4kM9UYTMA9vQSvuVPz17Npgy9D6EdRWELe?key=Yp0qdx99PgGWwiHA4kq1q_wj" 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 na construção do fluxo.                                                                                                                       |
| [Conta de serviço](#user-content-fn-1)[^1] | Seletor        | Permite selecionar uma conta de serviço do tipo Bearer Token, cadastrada no Workspace Floui, para realizar a conexão e autenticação com o ambiente Adobe Commerce Magento. |
| ID do cliente (customer\_id)               | Campo de texto | Permite definir o identificador único do cliente cadastrado que será consultado.                                                                                           |
| Output Path                                | Campo de texto | Refere-se ao caminho do resultado da requisição na saída do conector no contexto de execução do fluxo                                                                      |
| {% endtab %}                               |                |                                                                                                                                                                            |

{% tab title="Payload" %}

## Detalhes

O conector Consultar Cliente possibilita a recuperação e consulta de registros de clientes no e-commerce por meio da API REST.&#x20;

O endpoint utilizado é **GET** `/rest/V1/customers/{id}`, onde `{id}` corresponde ao identificador único do cliente. Para mais informações sobre essa e outras APIs disponíveis no Adobe Commerce Magento, consulte a documentação oficial [REST endpoints (ReDocly)](https://developer.adobe.com/commerce/webapi/rest/quick-reference/).

## Sucesso

Em casos de sucesso, o retorno de execução do conector conterá os dados cadastrais do usuários.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdQofQFWksDBGEEcbi0wj_aU9EWNZ2AB94LVkqFhA-P74Kvc-t8InBIiR8t-fKNHY3EW64wsdLooP6mXTERdszVmQhvVep2TV8kOsZh94Rj2IcUwVJxn_oWJPuCkK0wCgPSklK1?key=Yp0qdx99PgGWwiHA4kq1q_wj" alt=""><figcaption><p>Sucesso ao consultar cliente</p></figcaption></figure>

## Erros

Em cenários de erro, como erro ao encontrar identificador de registro do cliente, será retornada uma mensagem de erro conforme o exemplo abaixo.&#x20;

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeUEvzXD6S8fpj4j-2B2P1V7SSB4lvQylz3Cu8fyI9ADP_UoP-LPD7JC6R8_Bajvv-DKJri3Uir1Szu0RfSlZhpA3eHi3QphPh-xPWzNPiaXdVxOBqsZqmUABYwHNkIoOj6bU4-3w?key=Yp0qdx99PgGWwiHA4kq1q_wj" alt=""><figcaption><p>Erro ao consultar cliente</p></figcaption></figure>
{% endtab %}
{% endtabs %}

[^1]: A conta de serviço precisa ser adicionada no painel de configuração do Floui antes de ser selecionada dentro do componente.


---

# Agent Instructions: 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:

```
GET https://docs.floui.io/guia/conectores/categorias/servicos-externos/adobe-commerce/cliente/consultar-cliente.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
