Come Importare Ordini tramite Excel, CSV o TXT (legacy)

Questa versione legacy sarà presto dismessa. Per attivare la nuova versione clicca il toggle in alto a sinistra:

image-20250303-110613

Se stai già utilizzando la nuova interfaccia, ti invitiamo a consultare questo articolo.

L'importazione di tutti i dati dei tuoi ordini tramite file può essere stressante. 

Ecco perché ShippyPro ti semplifica le cose. Puoi scaricare un modello predefinito o personalizzare le colonne in modo da non dover partire da zero!
​ 

Vediamo come!

 

1. Come e cosa puoi importare

 

Come già sai, puoi importare un Excel, un CSV o un TXT

Ma cosa succede se hai già un File con tutti i dati degli ordini?
Dovrai copiare e incollare tutte le informazioni nel modello scaricato? 

Ovviamente no! Ecco le nostre soluzioni:
​      

  • Importazione di un Excel o CSV già esistente

Puoi importare un CSV o Excel già esistenti adattando i nostri campi alle tue colonne.

Da Label Creator > Da Spedire, clicca su Importa Excel/CSV/ TXT > Personalizza le colonne.

Ad esempio: Se nel tuo file il campo Azienda viene prima e Nome nella seconda colonna, devi

solo cambiare l'ordine delle colonne predefinito in base al tuo, in questo modo:

https://help.shippypro.com/hubfs/Knowledge%20Base%20Import/ezgif_com-video-to-gif%2B(11)-1.gif

 

Ricorda: Tutti i campi contrassegnati con * sono obbligatori.

Per i file CSV il delimitatore supportato è il punto e virgola (;)
​      


  • Importazione di un TXT già esistente

Anche l'importazione di un TXT con i dati dei tuoi ordini richiede solo pochi click.

Clicca su Importa Excel/CSV/ TXT > Personalizza le colonne.

Devi solo specificare la Posizione Iniziale e la Posizione Finale di ciascun campo:

https://help.shippypro.com/hubfs/Knowledge%20Base%20Import/ezgif_com-video-to-gif%2B(12)-1.gif

 

 

Ricorda: Tutti i campi contrassegnati con * sono obbligatori

 

          

2. Come creare un nuovo Excel 

Creare un Excel con tutti i tuoi ordini è più facile di quanto pensi.

Ecco come fare passo dopo passo!

​  

  • Scarica il Template di Esempio

Da Label Creator > Da Spedire, clicca su Importa Excel/CSV/ TXT nell'angolo in alto a destra della pagina e scarica il file di esempio. 

Oppure clicca qui per scaricarlo direttamente da questa pagina di Help.

Segui attentamente questo procedimento. Eventuali Excel diversi non verranno importati nel nostro sistema.

https://help.shippypro.com/hubfs/Knowledge%20Base%20Import/ezgif_com-resize%2B(5)-1.gif
  • Riempi i Dati 

Vediamo quali sono i campi obbligatori e quali i facoltativi.

  • Name: Obbligatorio.

  • Company: Facoltativo. Puoi aggiungere l'eventuale azienda del cliente.

  • Street 1: Obbligatorio. Aggiungi l'indirizzo principale.

  • Street 2: Facoltativo. Puoi aggiungere delle informazioni aggiuntive.

  • City: Obbligatorio.

  • State: Facoltativo.

  • ZIP: Obbligatorio (NOTA: la colonna Zip deve essere formattata come testo).

  • Country: Facoltativo. Se non compilato, la nostra piattaforma aggiungerà automaticamente il Paese da cui proviene l'utente ShippyPro. Devi compilare il campo con il prefisso internazionale ISO ALPHA CODE 2.

  • Phone: Obbligatorio.

  • Email: Facoltativo. Aggiungi l'indirizzo e-mail del cliente se desideri inviare una Notifica di Tracking via e-mail.
  • Order Number: Obbligatorio. Il numero dell'ordine è unico. Ricorda di inserire un numero diverso per ciascun ordine, altrimenti la riga dell'ordine non verrà acquisita.

Attenzione: Bisogna avere l'accortezza di non immettere nessun carattere speciale nel campo transaction ID, altrimenti si creeranno errori nell'importazion dei dati del Destinatario.

  • Currency, Total, Items Count, Content Description sono obbligatori solo in caso di spedizioni internazionali che includono documenti doganali. 

Attenzione:

-La Valuta dev'essere riempita con codice di tre lettere (es: USD, EUR).
-​Le immagini non vengono importate.

-Amount paid for the shipment, Cash on Delivery, Parcels, Weight, Lenght, Width, Height e Note sono tutti facoltativi. 

 

  • Cash on delivery: è necessario aggiungere solo il valore. (es: 4,50)
  • Note è opzionale.
  • Parcels, Weight, Length, Width, Height se lasciati vuoti saranno rimpiazzati dal pacco predefinito selezionato in Miei Pacchi. Tuttavia se vuoi importare più di un collo, devi compilare tutti i campi e il peso sarà suddiviso equamente tra tutti i colli.


In caso di colli multipli, il peso (weight) NON deve contenere decimali.

Aggiungendo la quantità di pacchi inclusi nella spedizione, non sarà possibile gestire la dimensione di ciascuno di essi attraverso le righe di Excel, quindi tutti i pacchi avranno la stessa dimensione.

Per gestire le dimensioni dei pacchi o i dettagli degli articoli, mettiamo a tua disposizione le nostre API.

 

 

  • Is Return: Facoltativo. 

Attenzione: Ricorda di digitare true solo quando la spedizione è un reso. Aggiungi false se ci sono alcuni resi all'interno dell'Excel. Altrimenti puoi lasciare vuoto questo campo. 

  • Date: Facoltativo. 

Attenzione: Completa questo campo solo se vuoi impostare una data diversa da quella originale. 

  • Shipping Service: Facoltativo. 

Attenzione: Compila questo campo solo se desideri aggiungere una regola di spedizione a quelle che hai impostato su Regole Corrieri o Filtri di ShippyPro.

Non preoccuparti, potrai aggiungere tutte le righe ordine di cui hai bisogno!

 

  • Carica il File

Appena hai compilato il Template con tutti i dati richiesti, fai clic su Carica Excel, CSV, TXT > Seleziona.

 

Nel caso in cui si verifichi un messaggio di error 500 durante il tentativo di caricare il file, è necessario verificare se tra i dettagli dell'ordine siano presenti delle emoji e, in caso affermativo, eliminarli in quanto bloccano la corretta importazione dell'ordine.


Troverai gli ordini che hai importato con Excel/CSV/TXT direttamente nella sezione vicino ai tuoi Marketplaces: 

 

📌 Per attingere ad una reportistica più dettagliata e completa, è possibile abilitare la chiamata API GetShippedOrders.

In caso di interesse, non esitare a contattare il nostro team di supporto tramite chat o modulo di richiesta dal tuo Pannello di Assistenza facendo clic sul pulsante nero HELP nell'angolo in basso a destra del tuo account.

 

3. Errori & Risoluzioni

 

Stai cercando di importare il tuo file Excel ma riscontri dei problemi?
Continua a leggere per sapere come risolverli caso per caso!

Import excel: Country must be in 2 digit format.

Quando si verifica questo errore, compila il campo Paese con l'abbreviazione a 2 cifre del Paese di destinazione.
Es. Francia - FR

Import excel: Currency code must be in 3 digit format.

In questo caso è necessario sostituire il valore Valuta con un contenuto di 3 cifre.
Es. EUR

Import excel: Order number X has not been imported, it already exists.

Ricorda che il valore del numero d'ordine deve essere unico per ogni riga, infatti non è possibile importare due volte lo stesso numero d'ordine/ID.

 

Order empty - Line with Order number empty

Oltre a verificare di aver compilato correttamente la colonna Order Number (dato univoco e obbligatorio), verifica che il file rispetti una delle estensioni supportate (.csv, .xls, .xlsx) e presenti il delimitatore corretto (per i file CSV il delimitatore supportato è il punto e virgola).

Country X not found. Please enter a valid country code

Oltre a verificare di aver compilato la colonna Country correttamente (è necessario inserire la sigla del Paese ISO ALPHA CODE 2), controlla da “Personalizza le colonne” se l’ordine delle colonne indicato coincida con quello del file importato (nello specifico per il campo in errore in oggetto).