Ottieni dati della voce di inventario

Nei flussi di lavoro che richiedono dati delle voci di inventario, puoi utilizzare l'azione Ottieni dati della voce di inventario per recuperare le informazioni sulle voci di inventario dal tuo negozio. Le voci di inventario rappresentano le unità di scorte effettive tracciate per le varianti di prodotto.

In questa pagina

Configurazione

Campi

L'azione Ottieni dati della voce di inventario contiene i campi seguenti:

Campi utilizzati nelle azioni Ottieni dati.
Campo	Descrizione
Ordina dati per	Obbligatorio. I parametri in base ai quali vengono ordinati i dati restituiti dalla query di ricerca.
Numero massimo di risultati	Obbligatorio. Il numero massimo di risultati che possono essere restituiti dalla query di ricerca selezionata. Puoi restituire fino a 100 risultati alla volta.
Query	Obbligatorio. Scegli tra le query comuni o seleziona Avanzata per crearne una tua.

Stringa di query

Questo è un esempio di query per ottenere le voci di inventario tracciate:

tracked:true

La variabile tracked è un filtro disponibile in Query delle voci di inventario e può essere utilizzata più volte o in combinazione con altre variabili.

Quando esegui query sui dati, è utile sapere che:

Elenco dei filtri per le voci di inventario disponibili
Le query devono seguire una sintassi specifica
I valori del campo della query non sono sempre documentati. In alcuni casi, i valori si possono trovare consultando la documentazione API. In alternativa, spesso puoi trovare i valori dei campi negli URL del pannello di controllo quando applichi i filtri. Ad esempio, per trovare alcuni valori della query dell'ordine, filtra la pagina Ordini nel pannello di controllo, quindi controlla l'URL.
Puoi eseguire o testare una query nel tuo negozio usando l'app Shopify GraphiQL.
Fai attenzione a cosa succede se la tua query non va a buon fine. Spesso le API restituiscono tutti i risultati (invece di nessuno).

Dati restituiti

Tutte le azioni Ottieni dati restituiscono un elenco compreso tra 0 e 100 risorse. A seconda del caso d'uso, potresti voler utilizzare questi dati in vari modi:

Se devi gestire ciascun elemento dell'elenco singolarmente, ad esempio per aggiungere un tag per ognuno di essi, puoi utilizzare l'azione Per ciascuno.
Se devi aggregare i dati, ad esempio per contare quanti risultati sono stati restituiti, puoi utilizzare le azioni Conteggio o Somma.
Se devi restituire in output l'elenco, ad esempio per inviare un'email con tutti gli articoli, puoi utilizzare i dati restituiti direttamente nelle azioni successive.

Per accedere ai dati restituiti nei passaggi successivi a questa azione, usa la variabile denominata Ottieni dati voce di inventario, che corrisponde a un elenco di voci di inventario. Puoi usare questa variabile sia nelle condizioni sia nelle azioni. Ad esempio, puoi inviare l'elenco delle voci di inventario in un'azione Invia email interna simile a questa:

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

Trigger

Puoi utilizzare questa azione in qualsiasi flusso di lavoro, compreso il trigger Orario programmato. In un flusso di lavoro che utilizza il trigger Orario programmato, il flusso di lavoro viene avviato in un orario specificato, invece che come risultato di un evento. Poiché non esiste un evento specifico nel negozio o da un'app che avvia il flusso di lavoro, non ci sono dati inclusi automaticamente.

Riferimento API

Per maggiori informazioni sull'API utilizzata in questa azione, consulta la query sulle voci di inventario.