Obter dados do item de estoque

Em fluxos de trabalho que exigem dados do item de estoque, é possível usar a ação Obter dados do item de estoque para recuperar informações do item de estoque da loja. Os itens de estoque representam as unidades de estoque reais rastreadas para as variantes do produto.

Nesta página

Configuração

Campos

A ação Obter dados do item de estoque contém os seguintes campos:

Campos usados nas ações Obter dados.
Campo	Descrição
Classificar dados por	Obrigatório. Os parâmetros pelos quais os dados retornados pela consulta de pesquisa são classificados.
Número máximo de resultados	Obrigatório. A quantidade máxima de resultados que a consulta de pesquisa selecionada pode retornar. É possível retornar até 100 por vez.
Consulta	Obrigatório. Escolha entre as consultas comuns ou selecione Avançado para criar a sua.

String de consulta

Este é um exemplo de consulta para obter itens de estoque que são rastreados:

tracked:true

A variável tracked é um filtro disponível na consulta de itens de estoque e pode ser usada várias vezes ou combinada a outras variáveis.

Ao consultar dados, é útil saber:

Lista de filtros de item de estoque disponíveis
As consultas precisam seguir uma sintaxe específica
Os valores dos campos de consulta nem sempre estão documentados. Em alguns casos, é possível encontrar os valores na documentação da API. Outra opção costuma ser procurar esses valores nos URLs do admin quando você aplica filtros. Por exemplo, para encontrar alguns valores de consulta de pedidos, filtre a página Pedidos no admin e verifique o URL.
É possível executar ou testar uma consulta na loja usando o app Shopify GraphiQL.
Tenha cuidado com o que acontece se a consulta falhar. Muitas vezes, a API retorna todos os resultados (em vez de nenhum).

Dados retornados

Todas as ações de Obter dados retornam uma lista com algo entre 0 e 100 recursos. Dependendo do caso de uso, convém utilizar esses dados de várias maneiras:

Se for necessário processar cada item da lista individualmente, como para adicionar uma tag a cada um, use a ação Para cada.
Se for necessário agregar dados, como contar quantos resultados foram retornados, use as ações de Contagem ou de Soma.
Se for preciso gerar uma lista (por exemplo, para enviar um e-mail com todos os itens), será possível usar os dados retornados de modo direto em ações subsequentes.

Para acessar os dados retornados nas etapas após essa ação, use a variável chamada Obter dados do item de estoque, que é uma lista de itens de estoque. É possível usar essa variável tanto em condições quanto em ações. Por exemplo, você pode enviar a lista de itens de estoque em uma ação Enviar e-mail interno semelhante a esta:

{% for single_inventory_item in getInventoryItemData %}
  * SKU: {{ single_inventory_item.sku }} - Cost: {{ single_inventory_item.unitCost.amount }}
{% endfor %}

Acionadores

Use essa ação em qualquer fluxo de trabalho, inclusive no acionador Horário agendado. Em fluxos de trabalho que o utilizam, a execução é iniciada no horário que você especificar, e não como resultado de um evento. Como não há um evento específico na loja ou em um app para iniciar o fluxo de trabalho, os dados não são incluídos de forma automática.

Referência da API

Para saber mais sobre a API usada nessa ação, consulte a consulta de itens de estoque.