# Consultar item de estoque (MSI)

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

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXc58F9Lu-_KfT72FBNjPzM60tOyyLmGWTgLNfSUe3a3DcITp7GcJUTWlCxC2DCf2tGmVcdfxJIasyl3QafV5kLVWlwqKCNVfFw2pEGgEIlvNIo3S7a8ZHtys8ViTGKZLSZsZZ2W?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. |
| SKU do produto                             | Campo de texto | Código único do produto, já cadastrado no e-commerce, que terá suas fontes consultadas.                                                                                    |
| Código da fonte de estoque                 | Campo de texto | Refere-se ao código de uma das fontes de estoque do produto. O produto pode ter um ou vários estoques.                                                                     |
| 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 Item de Estoque (MSI) oferece uma interface para verificar o estoque de fontes de produtos no e-commerce por meio da API REST, realizando a consulta sobre o Multi Source Inventory (MSI). **O MSI está disponível para versões do Magento Open Source 2.3+ e Adobe Commerce (Magento Commerce) 2.3+.**

O conector utiliza o endpoint **GET** `rest/V1/inventory/source-items` com `searchCriteria`. O `searchCriteria` é amplamente utilizado na API REST do Magento para aplicação de filtros, paginação e ordenação de resultados. Para saber mais sobre esta ou outras APIs disponibilizadas para Adobe Commerce Magento, acesse o link [REST endpoints (ReDocly)](https://developer.adobe.com/commerce/webapi/rest/quick-reference/).

## Sucesso

Quando a requisição for bem-sucedida, a resposta conterá a carga de dados contendo as informações relacionadas à fonte de estoque do produto. Caso algum campo opcional não tenha sido preenchido, esse atributo permanecerá inalterado. Segue um exemplo do retorno da execução:

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXf6jnc1fVlPeBsV6lCqW1WqKgzjhzUQ3ZjbC8OaK6HnGmHHY831T03iNWJeLp3sx048eEME__-4kAJ_D-GhFqWCDlW8-RuYDwXs6-oCLLigtaUqthTQW31NXHFDn2imGlXRda89ww?key=Yp0qdx99PgGWwiHA4kq1q_wj" alt=""><figcaption><p>Sucesso na consulta de estoque</p></figcaption></figure>

## Erros

Casos comuns de erro na execução do conector são: Falha na autenticação com o e-commerce e erros na parametrização do conector (como SKU ou código de fonte inválida). No primeiro caso, irá retornar um erro com código de status 401 (não autorizado). Enquanto no último caso, será retornado um valor nulo por não ter encontrado um SKU ou fonte válida.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfHF7xmpM45Ft1D_ctnth2rfVxjF7gtL4TD4JZgGzin5LjzWxZQC5DNUbD1wduF6eGSob0E9gnyb0SNV0WHaoJ_fpzcBnZ6rQcjjN4prdaCqvnkE0PWYK-sEiuUknKPUyfWqEKw?key=Yp0qdx99PgGWwiHA4kq1q_wj" alt=""><figcaption><p>Erro de autenticação na consulta de estoque</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.