Automatizzare le bozze d'ordine con Shopify Flow

Usa attività Kanbanify separate per spostare una Bozza d’ordine aperta, impostarne il contrassegno, assegnare un compagno già presente o leggerne i dettagli Kanbanify. Le attività per le bozze sono diverse da quelle per gli Ordini: Draft order stage changed fornisce un ID Bozza testuale, non il riferimento Ordine nativo di Shopify Flow.

Prima di iniziare

• Installa Shopify Flow e Kanbanify nello stesso negozio, abilita la bacheca Bozze e concedi a Kanbanify l’accesso richiesto alle Bozze d’ordine.
• Prepara due fasi definite dal commerciante sulla bacheca Bozze. Nel menu azioni della fase di destinazione usa Copy stage ID (disponibile anche nelle Impostazioni Kanbanify). Usa l’ID, non il nome della fase: Flow non dispone di un selettore di fasi Kanbanify.
• Per l’assegnazione scegli una persona già elencata in Impostazioni → Elenco team. Usa l’email dell’elenco, non il nome visualizzato né un identificatore dell’account staff Shopify. L’azione non aggiunge persone né invia inviti.
• Esegui i test con una Bozza aperta eliminabile prima di attivare un’automazione critica. La disponibilità dipende dalla versione Kanbanify distribuita nel negozio.

Collega il trigger a ogni azione

1. In Shopify Flow crea un flusso con il trigger Kanbanify Draft order stage changed. Si avvia al primo posizionamento nella bacheca Bozze o a un reale spostamento tra fasi Bozze, non a ogni modifica della Bozza.
2. Aggiungi condizioni che limitino il flusso alla bacheca Bozze e all’ID fase di destinazione del trigger. Per il primo test limita anche a un ID Bozza eliminabile.
3. Aggiungi una o più delle seguenti azioni Kanbanify. Nel campo Draft Order ID (draft_order_id) di ogni azione, inserisci la variabile trigger draftOrderId tramite il selettore variabili di Flow. Non digitare il nome della variabile come testo letterale.

È accettato un ID Bozza decimale positivo o gid://shopify/DraftOrder/<id>. Non lo sono un GID Ordine, un nome visualizzato come #D123, un URL admin, un input vuoto o l’ID di un’altra risorsa. La Bozza deve essere ancora aperta o con fattura inviata. Fasi rimosse, fasi di sistema, fasi di un’altra bacheca e contesto bacheca non valido vengono rifiutati prima delle modifiche. Solo un’associazione alla bacheca sicuramente assente può usare la bacheca Bozze configurata; metadati salvati incompleti o malformati non vengono sostituiti silenziosamente.

Leggi i dettagli correnti dopo un ritardo

Dopo un passaggio Wait, aggiungi Get draft order details, associa draftOrderId a draft_order_id, quindi aggiungi una condizione sui valori restituiti. L’azione legge lo stato salvato corrente quando viene eseguita, non lo stato del trigger precedente. Usa Get order details allo stesso modo in un flusso Ordine dopo un ritardo; usa il riferimento Ordine nativo di Flow.

Cosa restituiscono le azioni di dettaglio

Entrambe le azioni restituiscono id, name, tags e i valori Kanbanify salvati boardId, stageId, sortKey, cardColor e assignee. Restituiscono anche boardName e stageName leggibili. Get order details restituisce inoltre dueDate, riservato agli Ordini, e closedAt nativo Shopify: è null finché Shopify non chiude l’Ordine, altrimenti è il timestamp Shopify. Get draft order details restituisce completedAt nativo Shopify: è null finché la Bozza non viene convertita in Ordine, altrimenti è il timestamp Shopify.

Usa boardId e stageId per condizioni stabili e i nomi risolti per messaggi o condizioni leggibili. Dopo un ritardo seleziona completedAt o closedAt dai dati restituiti dall’azione quando la condizione dipende dal ciclo di vita nativo: i due campi hanno significati diversi e non sono intercambiabili. I valori Kanbanify salvati sono restituiti esattamente come memorizzati: l’azione non decodifica un contrassegno né risolve un assegnatario. Un ID bacheca o fase obsoleto o assente resta disponibile come valore grezzo mentre il nome corrispondente è null; Kanbanify non sostituisce un’altra bacheca o una fase di sistema.

Entrambe le azioni sono di sola lettura: non spostano né aggiornano Ordini o Bozze e non avviano un altro flusso Flow.

Un esempio senza ciclo

Per una Bozza di test, imposta la condizione su ID fase di destinazione = ID della fase di ingresso. Concatena:

1. Imposta la fase su un ID di fase di destinazione diversa.
2. Imposta il contrassegno su Teal / Diagonal stripe.
3. Assegna un compagno di test esistente tramite email.

Associa draftOrderId del trigger originale a tutte e tre le azioni. Il secondo evento fase indica la destinazione e deve quindi non soddisfare la condizione della fase di ingresso, evitando il ciclo. L’azione contrassegno viene dopo quella fase e sostituisce l’eventuale contrassegno predefinito della destinazione. Le azioni sono indipendenti, non una transazione: controlla l’esito di ciascuna.

Abilita il flusso di test, sposta la Bozza nella fase di ingresso, quindi controlla la cronologia di esecuzione Flow e ricarica Kanbanify per verificare fase destinazione, contrassegno e assegnatario sulla stessa Bozza. Controlla gli esiti delle azioni, non solo l’avvio del flusso. Disabilita o rimuovi il flusso di test prima di eliminare i dati eliminabili. Evita regole che spostano una Bozza avanti e indietro.

Cosa significano successo e tentativi

• Il successo dell’azione fase Bozza conferma solo il posizionamento salvato. Un contrassegno predefinito della fase destinazione viene salvato con la fase; senza predefinito si conserva quello esistente. Assegnatario e metadati non correlati restano invariati.
• La pulizia dell’ordinamento manuale, i tag automatici e l’invio del trigger successivo sono tentativi best-effort dopo il salvataggio. Gli errori non annullano la fase né trasformano l’azione in errore. Se l’aggiunta di un nuovo tag fallisce, non viene tentata la rimozione dei vecchi tag; se la rimozione fallisce possono restare entrambi. Controlla scheda e tag quando contano.
• Una richiesta valida per la fase già salvata riesce senza modifiche. Non ripara precedenti errori di ordinamento/tag né ripete un trigger, neppure dopo una risposta di salvataggio persa.
• Azioni contrassegno o assegnatario valide ripetute scrivono in sicurezza gli stessi valori. Non cambiano fase, tag o posizione manuale. Vale l’ultima scrittura riuscita.
• Un errore di convalida o ricerca fa fallire l’azione prima delle scritture. Un salvataggio primario rifiutato conserva lo stato precedente; una connessione persa dopo l’invio può nascondere una scrittura completata. Ricarica la Bozza prima di decidere. Non esistono rollback o compensazioni automatiche.
• Un trigger inviato non prova l’esecuzione di un flusso. Kanbanify non offre consegna garantita, esecuzione esattamente una volta, deduplicazione concorrente o ripetizione automatica.

Gli spostamenti in bacheca e le azioni fase Ordine esistenti hanno limiti d’errore diversi. Uno spostamento può salvare la fase e poi fallire nella pulizia ordinamento richiesta (senza trigger) o nei tag (dopo aver tentato il trigger della risorsa). L’azione fase Ordine esistente può fermarsi prima del trigger dopo una fase salvata se pulizia o richiesta tag generano errore. Un nuovo tentativo nella stessa fase non ripara né ripete tali invii. Non applicare la regola di successo del posizionamento Bozza a questi punti di ingresso.

Quando una Bozza diventa un Ordine

Completare una Bozza in Shopify non avvia mai il trigger Bozza. Normalmente Kanbanify copia contrassegno/assegnatario, mette l’Ordine risultante nella prima fase della bacheca Ordini, gestisce tag fase e pulizia Bozza, quindi tenta una volta il trigger Order di cambio fase.

Esiste un limite di tentativi trattenuto: se la fase Ordine si salva ma gestione tag conversione o pulizia fallisce prima dell’invio, un nuovo tentativo riuscito può vedere la fase salvata e inviare zero trigger Order. La conversione non garantisce recupero né ripetizione. Verifica Ordine risultante e cronologia Flow; non affidarti alla conversione per notifiche garantite una volta.

Mantieni separati i flussi Ordine e Bozza

I nomi delle attività Ordine esistenti e i binding Ordine nativi restano disponibili. Il trigger Ordine fornisce inoltre orderName e orderAdminUrl; i campi originali rimangono. Le richieste di bacheca Ordine nella stessa fase non avviano Flow. Mantieni un flusso Ordine esistente come controllo indipendente quando introduci automazione Bozze.

Il trigger Bozza offre ID/nome/URL admin Bozza, bacheca, fase origine/destinazione e contesto assegnatario acquisito. Il testo opzionale può essere vuoto e le posizioni non disponibili sono -1; il posizionamento iniziale non ha fase origine. Non espone un riferimento Bozza tipizzato, dati Bozza arbitrari, note o tag. I campi assegnatario acquisiti non vengono aggiornati da un’assegnazione successiva nel flusso.

Non esistono un’azione Bozza combinata, un’azione di trasferimento bacheca o azioni Bozza separate per ordinamento, tag, completamento, data di scadenza o note. Contrassegno, assegnatario, riordino/ordinamento, tag, note, completamento e conversione non avviano il trigger fase Bozza. Il completamento delle Bozze da Kanbanify o dalle sue azioni Flow non è supportato.