Come funziona
L'importatore di ordini Shopify legge un CSV standard di ordini Shopify, abbina il cliente di ogni ordine tramite email, abbina ogni voce dell'ordine a un file o pacchetto mappato prima tramite SKU e poi tramite titolo prodotto, e crea record degli ordini in Alva per ogni corrispondenza valida. Non invia email, non mette in coda controlli antifrode e non assegna chiavi di licenza — questi effetti collaterali sono riservati agli ordini live che arrivano tramite il normale flusso di pagamento 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.
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.
Effetti collaterali dell'importatore di ordini Shopify rispetto a un ordine pagato live che arriva in tempo reale.
| Side-effect | Ordine live (webhook) | Ordine importato |
|---|---|---|
| Record degli ordini creati | 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 |
Ogni ordine importato viene creato con il controllo antifrode disabilitato e l'accesso al download abilitato immediatamente — nessuna revisione antifrode viene messa in coda. Questo è ciò che fa sì che la pagina dell'account cliente mostri il file subito 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. Gli ordini importati non hanno alcun conteggio storico dei download. Se in precedenza hai applicato un limite di download per ordine, i clienti riacquistano una quota nuova dopo l'importazione.
- 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 gli ordini freschi in cui i dati di Shopify Risk sono aggiornati. Gli ordini importati saltano i controlli antifrode e danno al cliente accesso immediato al download — nessuna revisione viene attivata.
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