Questo articolo è una guida completa su come importare gli ordini in modo efficiente usando un file CSV. Semplifica la gestione degli ordini importandoli in blocco, così non dovrai più inserirli uno a uno a mano.
Come preparare il tuo file CSV per l'importazione
Prima di iniziare l’importazione, assicurati che il tuo file CSV sia strutturato correttamente. Scarica il modello CSV per garantire il formato giusto dei dati. Ogni riga del file CSV deve rappresentare una singola voce, così gli ordini possono occupare più righe. Usa la colonna "orderReferenceId" per collegare le voci alle relative ordinazioni.
Nota: se quando apri un file CSV in Excel le intestazioni delle colonne compaiono tutte in un'unica colonna, prova queste soluzioni:
Usa Google Sheets: apre i file CSV nel modo giusto, con le colonne già separate.
Regola manualmente in Excel: converti il file nel formato corretto mettendo ogni intestazione in una colonna diversa.
Per ogni riga, inserisci i dettagli essenziali dell'ordine:
ID di riferimento ordine
Dettagli di spedizione
Dettagli prodotto
URL per ogni area di stampa
Per una spiegazione dettagliata dei campi richiesti nel file CSV, consulta la pagina "Invia ordine" nella nostra documentazione API.
Importare ordini: guida pratica passo dopo passo
Segui questi passaggi per importare i tuoi ordini senza intoppi:
Accedi a Gelato Connect
Aggiungi un negozio manualmente.
Accedi alla pagina degli ordini in GelatoConnect Storefronts e clicca sul pulsante "Importa".
Scegli il negozio assegnato per i tuoi ordini importati. Questi ordini risulteranno come effettuati dal negozio selezionato. Hai anche la possibilità di importarli come ordini manuali.
Carica il file CSV con gli ordini che vuoi importare. Puoi anche scaricare un nuovo modello CSV da questa pagina.
Controlla due volte di aver selezionato il negozio di destinazione giusto e il file da importare. Quando è tutto a posto, clicca su "Importa" per iniziare il processo di importazione.
Riceverai una notifica che conferma l'inizio del processo di importazione.
Quando il processo di importazione sarà completato, ti invieremo una notifica via email. In questa email troverai un riepilogo dell’importazione, che include:
Il numero totale di ordini presenti nel file di importazione.
Il numero di ordini importati con successo.
Il numero di ordini che non sono stati importati.
Inoltre, l'email includerà un file CSV con i risultati dettagliati dell'importazione. Questo file avrà tre colonne:
orderReferenceId
risultato (indica se ogni ordine è andato a buon fine o meno)
errori (con motivi specifici per eventuali problemi di importazione)
Capire quali parametri servono per importare un file CSV
Qui sotto trovi una spiegazione dettagliata dei parametri necessari e i riferimenti alla documentazione, così puoi compilare il foglio di calcolo in modo preciso.
Questo metodo è usato soprattutto da chi vuole provare la piattaforma prima di integrarla con le nostre API o inviare ordini su misura.
Informazioni generali sull'ordine
orderReferenceId – Mostra il numero dell’ordine nella Dashboard di Gelato. Esempio:
G-250202201217.customerReferenceId – ID cliente interno di riferimento.
orderType – Può essere impostato su
draft, ma per impostazione predefinita èorder.shipmentMethodUid – Specifica il metodo di spedizione:
normal,standardoexpress.valuta – Valuta utilizzata per il pagamento.
retailShippingPriceInclVat, retailCurrency, item.retailPriceInclVat – Utilizzati nelle analisi e in diverse aree della piattaforma, incluse le dichiarazioni doganali.
Dettagli dell'indirizzo di spedizione
Questi parametri corrispondono ai campi standard dell'indirizzo:
shippingAddress.firstName
shippingAddress.cognome
shippingAddress.addressLine1
indirizzo di spedizione. indirizzo (riga 2)
Città dell'indirizzo di spedizione
shippingAddress.postCode
shippingAddress.stato
shippingAddress.paese
email dell'indirizzo di spedizione
Telefono dell'indirizzo di spedizione
shippingAddress.companyName
Informazioni sul prodotto
item.itemReferenceId – Corrisponde a
Item Reference IDnell’ordine. Per gli ordini su piattaforme E-commerce, viene assegnato automaticamente. Per gli ordini manuali, deve essere definito.item.productUid
item.storeProductVariantId
item.quantity – Indica quante unità sono state ordinate.
item.pageCount – Necessario per i prodotti con più pagine, come le Brochure.
Parametri specifici per il ricamo
Per i design di ricamo servono parametri aggiuntivi.
item.modificaUidProdottoInBaseAiTipiDiFile
item.file1.id, item.file1.type, item.file1.url, item.file1.threadColors, item.file1.fitMethod, item.file1.fillMethod
item.file2.id, item.file2.type, item.file2.url, item.file2.threadColors, item.file2.fitMethod, item.file2.fillMethod
Poiché l'invio degli ordini tramite file CSV richiede una gestione costante dei fogli di calcolo e la preparazione di file pronti per la stampa, ti consigliamo di scegliere opzioni di realizzazione più semplici tramite integrazione API. In questo modo ottimizzi l'efficienza e riduci il lavoro manuale.