Un ordine WooCommerce può contenere diversi prodotti, ma molti flussi di lavoro richiedono tali prodotti separatamente. Forse desideri una riga di foglio di calcolo per articolo, un record CRM per prodotto o dati più puliti per i rapporti.
Invece di mappare elementi_riga[0], line_items[1], e così via manualmente, puoi scorrere l'intero voci_di_linea organizzare in un array ed elaborare automaticamente ogni prodotto. Questa guida spiega come farlo in Bit Flows utilizzando un iteratore.
Mappa WooCommerce voci_di_linea inserisci l'array nell'iteratore Bit Flows, quindi collega l'azione che desideri eseguire successivamente.
L'Iteratore elabora ciascuna voce separatamente, in modo che un ordine multi-prodotto possa creare righe separate di Google Fogli, record CRM, messaggi o altre azioni senza mappatura manuale.
Scorrere gli elementi di un ordine WooCommerce significa eseguire la stessa azione una volta per ogni riga di prodotto distinta in un ordine. Un ordine contenente due magliette e una tazza da caffè ha due voci d'ordine, quindi il ciclo viene eseguito due volte. La quantità della maglietta è 2, ma rimane una sola riga a meno che non si aggiunga intenzionalmente un altro ciclo basato sulla quantità.
| Voce | Quantità | L'iteratore è in esecuzione |
| Maglietta | 2 | 1 |
| Tazza da caffè | 1 | 1 |
| Totale | 3 unità | 2 esecuzioni di elementi di riga |
Questa distinzione è importante perché un ciclo sugli elementi della riga risponde alla domanda “Quante righe di prodotti differenti sono presenti nell'ordine?”. Non risponde a “Quante unità totali sono state acquistate?”. WooCommerce fornisce la quantità all'interno di ciascun elemento in modo che l'azione successiva possa comunque vedere che sono state ordinate due magliette.
Prepara questi elementi prima di creare il flusso di lavoro:
Il flusso di lavoro consigliato utilizza tre nodi: WooCommerce avvia il flusso, l'Iteratore scompone l'array line_items nei singoli elementi e Google Sheet aggiunge una riga per ciascun elemento. Non è necessario un Agente AI, un Router o un Parser JSON per una normale risposta strutturata di WooCommerce.
In Bit Flows, crea un nuovo flusso e aggiungi WooCommerce come trigger, quindi seleziona “All’apertura di un nuovo ordine”. In questo modo il flusso di lavoro verrà avviato ogni volta che WooCommerce crea un nuovo ordine.
Prima di andare oltre, decidi quando il flusso deve essere eseguito. "Alla creazione di un nuovo ordine" si attiva nel momento in cui viene creato un ordine, che per la maggior parte dei checkout avviene mentre l'ordine è ancora in attesa di pagamento.
Apri il trigger e clicca Ascolto Risposta. Bit Flows rimarrà in attesa del prossimo ordine per circa tre minuti.
Mentre è in ascolto, apri il tuo negozio in una scheda separata ed effettua un ordine di prova. Aggiungi almeno due prodotti diversi al carrello, quindi procedi con il checkout e completa l'ordine. L'utilizzo di più prodotti ti aiuterà a vedere come il ciclo gestisce ed elabora più di un articolo nello stesso ordine.
Quando arriva l'ordine, Bit Flows acquisisce la risposta. Potrai visualizzare i dati dell'ordine, compresi i ordine_id e un oggetto ordine che contiene i dettagli di fatturazione, i totali e il voci_di_linea vettore.
Fai clic sull'icona più dopo il trigger e aggiungi lo strumento Iterator. Nel campo Array, mappa l'ordine voci_di_linea dal trigger di WooCommerce. Mappa line_items, non line_items[0].
Dopo una corsa di prova, espandi l'output dell'Iterator e vedrai i campi per i prodotti: product_id, product_name, quantity, subtotal, total, product_sku, product_unit_price, e molto altro. Questi sono i campi che invierai al foglio di calcolo. Usa i nomi esatti dei campi mostrati nella tua stessa risposta acquisita, poiché possono variare in base alla configurazione del negozio.
In Google Fogli, crea un foglio di calcolo e aggiungi una riga di intestazione. Utilizza i campi che desideri tracciare qui, come i dettagli dell'ordine, le informazioni sul cliente, i dettagli del prodotto, le informazioni sul pagamento e lo stato dell'ordine.
Dopo l'Iterator, aggiungi Google Sheets e scegli Aggiungi riga.
Per collegare Google Sheets a Bit Flows, vai su Console Google Cloud, abilita le API di Google Drive e di Google Sheets, configura la schermata di consenso OAuth e crea un'applicazione web OAuth utilizzando l'origine JavaScript autorizzata e l'URI di reindirizzamento forniti da Bit Flows. Copia quindi l'ID cliente e il segreto cliente generati e incollali nei campi di connessione di Bit Flows. Per la configurazione completa, segui le istruzioni guida ufficiale all'integrazione di Google Fogli.
Seleziona la tua connessione Google, il foglio di lavoro e la scheda del foglio. Quindi mappa ciascuna colonna. Mantieni la divisione chiara. I campi a livello di ordine provengono dal trigger di WooCommerce, mentre i campi a livello di prodotto provengono dall'Iteratore:
Per Nome Cliente, usa Input Misto in modo da poter combinare due campi in un'unica colonna, come billing_first_name e billing_last_name. Mix di input ti consente di inserire del testo statico e più di un valore in un singolo campo di destinazione, mentre la normale mappatura passa un solo valore.
Mappa l'Ordine Totale al totale dell'ordine proveniente dal trigger, non al totale di una singola voce. Ogni riga dello stesso ordine mostra quindi il valore totale dell'ordine. Tale valore si ripete su ogni riga di prodotto per progettazione, quindi trattalo come un'etichetta, non come un numero da sommare. Se invece desideri il ricavo per singolo prodotto, aggiungi una colonna Totale Riga e mappala al totale dell'articolo corrente proveniente dall'Iteratore, che tiene già conto della quantità.
Esegui il flusso, quindi effettua un ordine di prova con diversi prodotti per dimostrare che il ciclo funziona.
L'Iteratore elabora ciascun prodotto in quell'ordine e Aggiungi riga scrive una riga per prodotto. Un ordine con tre prodotti produce tre righe, ciascuna con il proprio nome del prodotto, quantità e prezzo, mentre i campi a livello di ordine rimangono gli stessi in tutte queste righe.
Questo è l'intero senso del ciclo: un ordine con diversi prodotti si trasforma in singoli record di prodotto utilizzabili, senza mai selezionare manualmente line_items[0], line_items[1] e così via.
Mappatura di line_items[0] anziché line_items. Questo invia solo il primo prodotto al foglio. Mappa l'intero array line_items nell'Iterator in modo che ogni prodotto venga elaborato.
È prevista una sola riga per unità. Una quantità pari a 3 costituisce comunque un singolo articolo e una singola riga. Se hai realmente bisogno di una riga per unità, dovresti aggiungere un secondo ciclo basato sulla quantità, di cui la maggior parte dei negozi non ha bisogno.
Il totale dell'ordine mostra un numero errato. Se la colonna del totale dell'ordine mostra il prezzo del primo prodotto, o lo stesso piccolo valore su ogni riga di un ordine di grandi dimensioni, è stata mappata al totale di una singola voce anziché al totale complessivo dell'ordine. Mappala al totale complessivo dell'ordine proveniente dal trigger. Per il ricavo per singolo prodotto, aggiungi una colonna Totale riga mappata al totale dell'articolo corrente proveniente dall'Iteratore.
Utilizzando il trigger di creazione per un foglio di vendite a pagamento. "Alla creazione di un nuovo ordine" si attiva prima del pagamento, quindi il foglio può riempirsi di ordini in sospeso o abbandonati. Usa "Stato dell'ordine impostato su In elaborazione o Completato" quando desideri solo ordini pagati.
L'Iteratore è uno strumento che elabora un elenco un elemento alla volta. Gli si fornisce l'array delle voci d'ordine (line_items) ed esso esegue l'azione successiva una volta per ciascun prodotto in quell'array. Poiché passa il passaggio successivo un prodotto alla volta, è possibile mappare i campi di quel prodotto direttamente in una riga di un foglio di calcolo.
Una precisione che evita confusione in seguito: l'Iteratore viene eseguito una volta per riga di prodotto, non una volta per unità. Se un cliente compra tre dello stesso telefono, si tratta comunque di una singola voce e di una singola riga, con una quantità di 3. Non crea tre righe.
Una volta che l'iteratore è mappato su WooCommerce voci_di_linea array, il resto del flusso di lavoro diventa molto più semplice da gestire. Puoi inviare ciascun prodotto a Google Fogli o a qualsiasi altra azione connessa, mantenendo comunque associati i dettagli dell'ordine correlati.
Questo è particolarmente utile quando la tua automazione richiede dati strutturati a livello di prodotto anziché un ordine WooCommerce cumulativo.
Gli elementi della riga dell'ordine WooCommerce sono le singole righe di prodotto all'interno di un ordine, con campi quali ID prodotto, ID della variazione, quantità, subtotale, tasse e totale.
Usa Bit Flows: aggiungi un trigger WooCommerce, passa l'array delle voci d'ordine (line_items) a un iteratore, quindi aggiungi un'azione; il tutto verrà eseguito una volta per ogni prodotto senza bisogno di PHP.
Crea una riga per linea di prodotto, non per unità, quindi una quantità pari a tre costituisce comunque una singola voce con un valore di quantità pari a tre.
Usa On New Order Create per catturare ogni ordine al momento della creazione, oppure Order Status Set su Processing o Completed quando vuoi registrare solo gli ordini pagati.
Sì, dopo l'iteratore è possibile aggiungere qualsiasi azione Bit Flows, quindi lo stesso ciclo può creare record CRM, inviare e-mail o pubblicare messaggi, uno per ogni prodotto.
No, quando line_items arriva come array strutturato, ti serve solo l'Iterator, poiché il JSON Parser è per il testo JSON grezzo e un Agente IA non è necessario per la mappatura fissa.
Sì, il trigger WooCommerce, l’Iterator e l’azione Google Sheet sono tutti inclusi nel piano gratuito Bit Flows, quindi il flusso di lavoro funziona senza bisogno di un upgrade a pagamento.
IT 
EN 
DE 
ES 
NL 
PT 
JA