Come funziona
L'importatore di ordini Shopify legge un CSV ordini Shopify standard, abbina il cliente di ogni ordine per email, abbina ogni riga d'ordine a un file o pack mappato prima per SKU e poi per titolo prodotto, e crea righe Customer e Purchase in Alva per ogni corrispondenza idonea. Non invia email, non mette in coda controlli antifrode e non assegna chiavi di licenza — questi side-effect sono riservati agli ordini live che arrivano tramite il normale webhook Shopify.
Prima di iniziare
Mappa ogni prodotto Shopify che ha mai venduto un file digitale a un file o pack in Alva prima di eseguire l'import. I prodotti non mappati vengono saltati riga per riga e mostrati in un riepilogo, ma l'approccio più pulito è mappare prima e importare una volta sola.
- File mappati ai prodotti. Apri File in Alva e verifica che ogni prodotto digitale abbia almeno un file o pack allegato. Funzionano anche le mappature a livello di variante.
- Decidi l'intervallo di date. Scelte comuni: gli ultimi 90 giorni per uno store attivo, oppure tutto il periodo per una migrazione da un'altra app di fulfillment.
- Tieni pronto un piccolo CSV di prova. Esporta prima una singola settimana recente per validare la mappatura, poi riesporta l'intervallo completo quando il dry run sembra a posto.
Esporta il CSV ordini dall'admin Shopify
Shopify espone l'export ordini in Ordini → Esporta. L'importatore si aspetta i nomi colonna standard del CSV — non rinominare le colonne né modificare il file a mano.
- Apri admin Shopify → Ordini. Usa i filtri per restringere all'intervallo di date che vuoi coprire con il backfill.
- Clicca Esporta. Scegli File CSV semplice (non Per Excel, Numbers o altri fogli di calcolo) e seleziona Ordini, transazioni e rimborsi.
- Scegli l'ambito giusto. "Pagina corrente", "Ordini selezionati", "Tutti gli ordini" o "Ordini che corrispondono alla tua ricerca" funzionano tutti. L'importatore agisce solo sulle righe il cui stato finanziario è
paid. - Scarica l'email che invia Shopify. Per export grandi, Shopify invia il link al CSV all'email del proprietario dello store. Salvalo localmente — non decomprimere e ricomprimere.
Esegui l'importatore
L'importatore si trova in Ordini → Importa ordini storici nella sidebar admin di Alva. Suddivide automaticamente i CSV grandi in chunk — non c'è un limite di righe di cui preoccuparti.
- Apri Ordini in Alva, poi clicca l'azione secondaria Importa ordini storici nell'intestazione della pagina.
- Trascina il CSV sulla zona di upload. Alva valida immediatamente le intestazioni di colonna e rifiuta il file se manca una colonna obbligatoria.
- Aspetta l'anteprima. Alva risolve i clienti per email, abbina i prodotti per SKU e poi per titolo, e mostra i conteggi: ordini totali, ordini idonei, saltati (cancellati / non pagati / senza email), clienti trovati vs mancanti, prodotti abbinati vs non mappati e ordini già importati in un'esecuzione precedente.
- Rivedi i prodotti non mappati. Se l'anteprima fa emergere titoli di prodotto non mappati, annulla l'import, mappali in File → Prodotti e ricarica lo stesso CSV. Gli ordini già importati verranno saltati automaticamente.
- Conferma e avvia. Clicca Avvia import. L'avanzamento viene trasmesso nell'interfaccia man mano che ogni chunk si completa. Chiudere il tab del browser non interrompe l'import — viene eseguito fino al completamento lato server e puoi riaprire la pagina per vedere il risultato.
Schermata di anteprima dell'importatore di ordini Shopify Alva con la card di riepilogo che mostra i conteggi idonei / saltati / non mappati e il pulsante Avvia import. Nessun dato cliente reale visibile.
Cosa fa (e cosa salta) l'importatore
L'importatore è volutamente minimale. Scrive il più piccolo set di righe necessario perché un cliente possa reinviarsi i propri link di download, e salta ogni side-effect che sorprenderebbe un cliente di ritorno.
Side-effect dell'importatore di ordini Shopify a confronto con un webhook ORDERS_PAID live.
| Side-effect | Ordine live (webhook) | Ordine importato |
|---|---|---|
| Righe Customer + Purchase create | Sì | Sì |
| Accesso ai download abilitato | Sì | Sì |
| Email di consegna inviata | Sì (se abilitata) | No — mai |
| Controllo antifrode in coda | Sì (se abilitato) | No — mai |
| Chiavi di licenza assegnate automaticamente | Sì (se mappate) | No — mai |
| Trigger POS / Flow attivati | Sì | No — mai |
Sotto il cofano ogni riga Purchase importata viene creata con fraudCheckEnabled: false, fraudCheckPassed: false e accessEnabled: true. È questo che fa sì che la pagina account cliente mostri subito il file senza mai attivare un'email di download o un'assegnazione di chiave di licenza.
Limitazioni oneste
- I clienti devono già esistere in Shopify. L'importatore abbina per email rispetto alla tua lista clienti Shopify. I checkout guest che non hanno mai creato un record cliente non possono essere abbinati e quelle righe vengono segnalate nel riepilogo dei saltati.
- I clienti che hanno cambiato email vengono saltati. Il CSV contiene l'email registrata sull'ordine originale. Se un cliente ha nel frattempo cambiato la sua email Shopify, la ricerca non trova nulla e l'ordine viene segnalato come non abbinato.
- I prodotti personalizzati non vengono importati. I file su ordinazione appartengono a una specifica Purchase tramite la tabella file per acquisto e devono essere caricati a mano. L'importatore ripristina solo l'accesso ai file mappati standard del prodotto.
- I conteggi dei download partono da zero. Le righe Purchase importate non hanno alcun conteggio storico di download. Se prima imponevi un limite di download per acquisto, dopo l'import i clienti riottengono una nuova quota.
- Nessuna notifica automatica. L'importatore non comunica mai ai clienti che il loro accesso è stato ripristinato. O lo annunci con una email di marketing fuori da Alva, oppure aspetti le singole richieste di reinvio.
Un import di ordini storici che inviasse email a ogni cliente passato, su uno store da 50.000 ordini, scaricherebbe 50.000 email di consegna nel momento in cui clicchi Avvia — un flag spam garantito dai provider di posta. Alva rilascia l'importatore con i side-effect di email, antifrode e chiavi di licenza disabilitati nel codice così la strada sicura è l'unica strada.
FAQ
L'importatore invierà email ai clienti passati quando lo eseguo?
No. L'importatore di ordini Shopify non invia mai email. I clienti passati ricevono nuovi link di download solo quando richiedono un reinvio o visitano la pagina account cliente Shopify.
L'importatore esegue un controllo antifrode sugli ordini importati?
No. I controlli antifrode hanno senso solo per ordini freschi dove i dati Shopify Risk sono attuali. Le righe Purchase importate vengono create con fraudCheckEnabled impostato a false e accessEnabled impostato a true.
L'importatore assegnerà chiavi di licenza agli ordini importati?
No. Le chiavi di licenza non vengono mai assegnate durante un import storico. Se un ordine passato necessita di una chiave dopo l'import, allegane una manualmente dalla pagina dettaglio ordine in Alva.
È sicuro eseguire l'import due volte?
Sì. L'importatore è idempotente — rieseguendolo con lo stesso CSV rileva gli ordini già importati e li salta. Il riepilogo riporta quanti ordini e righe d'ordine sono stati saltati al secondo passaggio.
Cosa succede agli ordini per prodotti che non ho ancora mappato?
L'importatore salta le righe d'ordine il cui prodotto Shopify non può essere abbinato a un file o pack in Alva. L'anteprima elenca ogni titolo non mappato con un conteggio degli ordini così puoi mapparli e rieseguire.
Cosa succede agli ordini cancellati o non pagati nel CSV?
Alva importa solo le righe in cui lo stato finanziario Shopify è paid e l'ordine non è cancellato. Gli ordini non pagati, cancellati e rimborsati vengono conteggiati nel riepilogo dei saltati e non vengono importati.
Vedi anche
È stato utile?
Ultimo aggiornamento 2026-05-08