Caricamento massivo di ordini

Scarica il modello CSV direttamente dalla pagina di caricamento in Dashboard. Il modello include tutte le colonne obbligatorie e facoltative: le colonne obbligatorie sono contrassegnate da un asterisco (*) nella riga di intestazione.

Una riga per articolo 

Ogni riga rappresenta un articolo, non un ordine. Le righe che condividono lo stesso Order ID vengono raggruppate in un unico ordine multi-articolo, quindi un ordine di tre articoli corrisponde a tre righe. I valori a livello di ordine — destinatario, indirizzo, livello di servizio, importo di spedizione, valuta, duty paid by e carton — vengono letti dalla prima riga di ciascun gruppo.

Colonne obbligatorie 

Le informazioni obbligatorie per ogni riga rientrano in tre categorie:

Recipient — Il nome, il numero di telefono e l’indirizzo di spedizione del destinatario, incluso il paese di destinazione. L’email è facoltativa, ma viene convalidata nel formato quando ne fornisci una. Il CAP e lo stato/provincia sono obbligatori solo per i paesi il cui formato di indirizzo li prevede — per un paese senza CAP (ad es. Hong Kong o Tanzania), lascia semplicemente la cella vuota. Per i paesi con un elenco di stati/province, usa un nome o codice di regione riconosciuto (ad es. "Dubayy" o "DU" per Dubai) così i corrieri possono tariffare la destinazione.

Items — Come minimo, il nome dell’articolo e il prezzo. La quantità è facoltativa e il valore predefinito è 1. Fornire un codice HS e il paese di origine migliora l’accuratezza della classificazione e può ridurre i tempi di elaborazione nella schermata di conferma.

Shipping — Un codice di livello di servizio che corrisponde a un corriere configurato sul tuo account (ad es. fedex.international_priority, ups_worldwide_expedited). La colonna Shipping Amount è facoltativa: inserisci un importo (è consentito 0) per usarlo come costo di spedizione dell’ordine, oppure lasciala vuota e verrà calcolata una stima della tariffa del corriere per il tuo livello di servizio. Le righe calcolate richiedono alcuni secondi in più ciascuna nella schermata di conferma, e il costo finale del corriere alla creazione dell’etichetta può differire dalla stima. Alcune destinazioni non possono essere tariffate automaticamente (errore "service not available for destination country"): inserisci un importo di spedizione solo su quelle righe; righe vuote e compilate possono mescolarsi liberamente in un unico file.

Colonne facoltative 

Recipient tax ID — Usa le colonne Tax ID Type e Tax ID Number per includere un identificativo fiscale del destinatario sull’ordine. Il tipo deve essere uno dei codici seguenti (senza distinzione tra maiuscole e minuscole). Fornisci entrambe le colonne insieme; un tipo senza numero (o viceversa) viene segnalato come errore nella schermata di conferma. L’identificativo fiscale viene salvato sul destinatario dell’ordine e passato al corriere quando viene creata un’etichetta. Per ordini con più articoli, viene usato l’identificativo fiscale della prima riga dell’ordine.

Usa il codice specifico del paese dove esiste; per qualsiasi paese non elencato, usa TIN.

Codici aggiuntivi per scopi speciali (FED, FTZ, DUN e i conti di deferimento dazi e imposte DAN/TAN/DTF) sono accettati quando il tuo rappresentante Zonos ti indica di usarne uno.

Duty Paid By — DDP o DDU facoltativo per ordine. Lascia vuoto per il comportamento predefinito: DDP ovunque la destinazione lo supporti, con fallback automatico a DDU dove non lo supporta. Un DDP esplicito è rigoroso: le righe generano errore invece di fare fallback, e DDU rende il destinatario responsabile di dazi e imposte alla consegna. La schermata di conferma e il download dei risultati mostrano quale opzione ha effettivamente usato ogni ordine, con un badge arancione sulle righe DDU. Per ordini con più articoli prevale il primo valore specificato e i valori in conflitto sono un errore.

Carton quantity — Se un ordine viene spedito in più scatole identiche, imposta Carton Quantity insieme alle colonne Carton Length/Width/Height/Weight. Le colonne carton descrivono una scatola (il peso è il peso di una singola scatola imballata) e la quantità la moltiplica: ad esempio, 360 unità imballate 30 per scatola userebbero le dimensioni della scatola, il peso di una scatola piena e una quantità carton di 12. Vuoto significa 1. Gli ordini con scatole di dimensioni miste non possono essere descritti nel CSV: lascia vuote le colonne carton su quegli ordini e Zonos le imballerà automaticamente in base ai pesi degli articoli.

Suggerimenti 

• Usa i codici di livello di servizio esatti mostrati nelle tue impostazioni corriere. Le righe con codici di livello di servizio non riconosciuti mostreranno un avviso nella schermata di conferma.
• I territori USA differiscono: le Isole Vergini americane usano il proprio codice paese (VI) e spediscono come internazionali, mentre Porto Rico usa US e spedisce come domestico.
• I corrieri (UPS in particolare) rifiutano gli indirizzi di casella postale (P.O. Box): le righe con "P.O. Box" in una riga di indirizzo possono fallire la tariffazione con un errore generico di disponibilità del servizio. Usa un indirizzo stradale dove possibile.
• La punteggiatura tipografica da Word o Excel (virgolette curve, trattini en/em) viene corretta automaticamente. I punti interrogativi al posto di lettere accentate indicano che il file ha perso la codifica: quelle righe vengono segnalate così puoi reinserire il testo.
• Per i paesi di destinazione che richiedono un codice di stato o provincia (ad es. Brasile, USA, Canada), assicurati che il campo stato sia compilato con il codice ISO corretto.
• L’Order ID è obbligatorio e deve essere univoco nel tuo account, inclusi i caricamenti precedenti: un ID già usato in passato (anche in un file di una stagione precedente o in un ordine annullato) viene rifiutato alla creazione dell’ordine. Riutilizzi un file? Aggiungi un suffisso agli ID (ad esempio ACALB-33 per il volume 33). L’ID compare nella schermata di conferma e viene trasferito all’ordine creato come riferimento del merchant.
• I nomi dei destinatari, gli indirizzi, la città, lo stato/provincia, il nome dell’azienda e i nomi degli articoli devono usare caratteri latini. Script non latini come il giapponese o l’arabo vengono rifiutati.
• Le righe completamente vuote vengono ignorate, quindi le righe vuote finali nel file sono innocue.

Ogni colonna del modello standard, nell’ordine del modello. Conditional significa che la colonna è obbligatoria solo in determinati casi — consulta Colonne obbligatorie sopra per i dettagli.

Japan Post utilizza il proprio modello CSV, scaricabile dalla pagina di caricamento nello stesso modo. Non ha nessuna colonna per il livello di servizio — il caricamento assegna il primo livello di servizio del corriere e ne selezioni uno nel flusso di creazione dell’etichetta — e nessuna colonna per la quantità di carton, poiché questi caricamenti vengono sempre spediti come un unico carton.

Colonne facoltative nel modello standard ma obbligatorie per Japan Post:

• HS code
• Country of origin
• Item weight — l’unità di peso resta facoltativa qui e per impostazione predefinita è in grammi
• Postal code
• State/province
• Shipping amount — a differenza del modello standard, questo non può essere lasciato vuoto

Il modello aggiunge anche i campi di spedizione Japan Post che vengono salvati sull’ordine e applicati alla spedizione quando viene creata un’etichetta: Contents Type, Licence Number, Certificate Number, Invoice, Tax Code/VAT Number, Pay Condition, Remarks, Sender's Reference Number e Non-commercial. Sono tutti facoltativi. I campi di testo accettano fino a 25 caratteri, e Non-commercial accetta solo true o false.

Dopo il caricamento, una schermata di conferma mostra il dettaglio del landed cost calcolato per ogni ordine prima che venga creato qualcosa. La schermata mostra:

Le righe possono mostrare $0 di dazi, imposte e commissioni quando la destinazione non addebita costi di importazione al valore dichiarato della spedizione (è sotto la soglia de minimis del paese): il landed cost è davvero zero, non mancante, e la spedizione è l’unico costo per quegli ordini.

Il pulsante Create orders mostra il conteggio degli ordini che verranno inviati (ad es. Create 17 orders). Sono incluse solo le righe con stato Ready o Warning: le righe con errori sono escluse.

Usa Download results CSV per esportare il dettaglio completo del preventivo (tariffa selezionata, totale articoli, spedizione, dazi, imposte, commissioni e totali per ordine), utile per quotare i clienti prima che vengano creati gli ordini. Fai clic su Start over per scartare il caricamento e ricominciare con un file revisionato.

Quando lasci Shipping Amount vuoto, la colonna del livello di servizio mostra la tariffa corrispondente al livello di servizio del tuo CSV. Se il livello di servizio richiesto non è disponibile per una destinazione, viene selezionata la tariffa disponibile più vicina e contrassegnata con un badge Different service level, oppure, quando esistono diverse alternative, un menu a discesa Select a rate ti consente di scegliere prima che l’ordine possa essere creato.

I problemi vengono segnalati in linea nella schermata di conferma.

Errori 

Le righe con errori vengono escluse quando fai clic su Create orders. Correggi il problema nel CSV e ricarica per includere quelle righe. Errori comuni includono:

• Low-value orders not allowed — Il valore dell’ordine è sotto la soglia minima del tuo negozio.
• Invalid state code — Il codice di stato o provincia non è valido per il paese di destinazione. Obbligatorio per paesi come Brasile, USA e Canada.
• Missing required field — Una colonna obbligatoria è vuota o non può essere analizzata.
• Order ID already exists — Ogni ID ordine deve essere univoco nel tuo account, inclusi gli ordini da caricamenti precedenti. Le righe con ID già usati falliscono alla creazione mentre il resto del file ha successo: ricarica solo le righe fallite con ID nuovi (un suffisso come -33 funziona bene).

Avvisi 

Le righe con avvisi sono incluse nell’invio. Rivedile prima di fare clic su Create orders. Avvisi comuni includono:

• Service level not configured — Il codice del livello di servizio nel tuo CSV non è collegato al tuo account. L’ordine verrà creato ma potrebbe non essere tariffato correttamente. Verifica le tue impostazioni corriere o aggiorna il codice del livello di servizio nel CSV.

Il limite attuale di caricamento è di 200 ordini per CSV. Gli ordini vengono inviati in lotti fino a 50 per chiamata API: se il caricamento contiene più di 50 ordini pronti, vengono elaborati automaticamente in più lotti.

Prossimamente: Un aggiornamento futuro rimuoverà il limite di 200 ordini e aggiungerà l’elaborazione in background per caricamenti più grandi.