# Atualiza lote de itens de estoque (MSI)

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

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcjSz5fKCEyjLpA4mRBW42TKPhTDgYsnnINF_34jWBbN2ZHMIRrVX0c1oAig2icSYd6NmMSGcYcjYQTI7EsNJoIYGtmeQC6MAOpyDRKpWi2H34z3Y42v1P3P2rn-Lno9Qc1nsmGAQ?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. |
| Entrada da lista de itens                  | Campo de texto | Permite informar um caminho, dentro do objeto msg, para uma lista JSON contendo todas as informações da atualização de itens de estoque.                                   |
| Path JSON do SKU                           | Campo de texto | Informa o caminho, dentro da lista parametrizada em Entrada da lista de itens, onde o atributo de SKU está localizado.                                                     |
| Path JSON do código da fonte de estoque    | Campo de texto | Informa o caminho, dentro da lista parametrizada em Entrada da lista de itens, onde o código da fonte no e-commerce está localizado.                                       |
| Path JSON do status (disponibilidade)      | Campo de texto | Informa o caminho, dentro da lista parametrizada em Entrada da lista de itens, onde o status do estoque está localizado. Usar 1 para Em Estoque ou 0 para 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" %}

## Detalhes

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+.**<br>

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/).

## Lista de itens de estoque

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-lote-de-itens-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.
