Atualiza lote de itens de estoque (MSI)

Atualize lote de itens do estoque de produtos na plataforma Adobe Commerce

Parâmetros

Parâmetros de configuração

Campo	Tipo	Descrição
Descrição	Campo de texto	Descrição visual do conector na construção do fluxo.
	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

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

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

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.

{
   "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.

Sucesso na atualização de estoque

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.

Erro na atualização de estoque