# Atualiza um item de estoque (MSI)

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

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXd-lmugQBsTG3hD8fx7xpXCwqq9ZPgAG1GEjzDZ3DAKIQdiNe7v_lDhcls6GnGPSKqIrsNWnuCQTvacyGBRNK5d_75oatGPn84HO7T8r5LbkvMzPMIVBYqB1NOWxlmAFSDuCXyq2w?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 | Refere-se ao código identificador único do produto no e-commerce que terá seus dados de estoque atualizados pelo conector.                                                 |
| Código da fonte de estoque                 | Campo de texto | Refere-se ao código da fonte de estoque do produto no e-commerce que será usado para atualização. O produto pode ter uma ou mais fontes.                                   |
| Quantidade                                 | Campo de texto | Indica a quantidade disponível do produto em estoque para determinada fonte.                                                                                               |
| Disponibilidade do estoque (status)        | Seletor        | Permite definir, para uma determinada fonte, se o item estará disponível em estoque ou será listado como fora de estoque.                                                  |
| 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" %}

### Payload

O conector Atualiza lote de itens de estoque (MSI) oferece uma forma intuitiva para atualização de itens de estoque de fontes em produtos do e-commerce, realizando alterações via 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 **POST** `rest/V1/inventory/source-items`. 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/).

## Endereços

Para adicionar uma lista de itens para atualização de estoque, o JSON deve seguir um formato específico. Abaixo está um exemplo de estrutura para atualizar o estoque de múltiplas fontes de um único produto.

```json
{
   "items":[
      {
         "sku":"24-MB01",
         "source_code":"default",
         "quantity":777,
         "status":0
      },
      {
         "sku":"24-MB01",
         "source_code":"loja_bh",
         "quantity":777,
         "status":1
      },
      {
         "sku":"24-MB01",
         "source_code":"loja_centro",
         "quantity":777,
         "status":1
      },
      {
         "sku":"24-MB01",
         "source_code":"loja_pr",
         "quantity":777,
         "status":1
      },
      {
         "sku":"24-MB01",
         "source_code":"loja_rio",
         "quantity":777,
         "status":1
      }
   ]
}
```

No exemplo, o JSON está localizado no caminho `msg.stock.items`. Portanto, na configuração **Entrada da lista de itens**, deve-se indicar o caminho msg.stock.items.

Nos campos de configuração **Path** seguintes, será necessário definir o caminho relativo dentro de `msg.stock.items`. Por exemplo, ao configurar o **Path JSON do SKU** como "sku", o conector acessará `msg.stock.items[i].sku`, onde `[i]` representa cada item dentro da lista. Logo, é recomendado manter o valor padrão presente nas configurações Path do conector.

## Sucesso

Quando a requisição for bem-sucedida, a resposta conterá uma lista vazia, o código de status 200 indica que a atualização em lote foi realizada com sucesso.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeB33-qV6Pej3Fq2k3Ca_WTwWnYTB7x9tJeYmmztp3eRvJqyugFaX6JgFcU_CF6GEOHiXxz-wlfzxBsaAMXF2vxYOorszFo9piKKUL9qIXxlhw-ipLR7OGfdXyScNKRl7nlqKKQ7Q?key=Yp0qdx99PgGWwiHA4kq1q_wj" alt=""><figcaption><p>Sucesso na atualização de estoque</p></figcaption></figure>

## Erros

Casos comuns de erros podem ser devido a parametrização incorreta do campo **Entrada da lista de itens** ao informar um conteúdo que não é uma lista válida, ou quando os campos para atualização de estoque contém valores incorretos. O exemplo abaixo demonstra como os erros genéricos são exibidos na saída do conector, neste caso, um código de fonte incorreto.&#x20;

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfjHt7qBoWzfvEtaeD642-flEFUTZlYNSojzGUjkXB3RX9AhJ4b7LS8bfr7ZSiHnvQg6Qq3_fuVPzG1JeYKx2Rb_C-uL8WdAL6d1XC6BnS9CnQcc6iz7LiYoaKI4uxk4wU-imc1Dw?key=Yp0qdx99PgGWwiHA4kq1q_wj" alt=""><figcaption><p>Erro na atualização 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.


---

# 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/estoque/atualiza-um-item-de-estoque-msi.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.
