Come collegare iMile a ShippyPro

Vediamo come integrare iMile con ShippyPro in pochi semplici passaggi.

Sommario

Prima di iniziare
Come collegare iMile
Servizi e destinazioni supportati
Opzioni aggiuntive
Risoluzione dei problemi ed errori
FAQ

1. Prima di iniziare

Per collegare iMile è necessario un contratto attivo con iMile. Chiedi al tuo account manager iMile:

Customer ID: il tuo codice cliente iMile (es. C2102079903)
Secret Key: la chiave fornita da iMile per firmare le richieste
Logistics Product Code: il codice prodotto assegnato da iMile a ciascun servizio che vuoi utilizzare (Delivery e/o Express)

Se vuoi usare sia Delivery sia Express, assicurati che iMile ti fornisca un Logistics Product Code distinto per ciascuno.

2. Come collegare iMile

Vai alla pagina Corrieri e clicca sul logo iMile.
Compila i campi del modale di connessione:

Campo	Obbligatorio	Descrizione
Customer ID	Sì	Il tuo codice cliente iMile
Secret Key	Sì	Chiave di firma fornita da iMile
Service	Sì	Delivery oppure Express
Logistics Product Code	Sì	Codice prodotto iMile per il servizio selezionato
Label Type	Sì	PDF 4x6" (unico formato disponibile)
Test	No	Collega l'ambiente di test di iMile

Clicca su Salva. ShippyPro verifica subito le credenziali: se Customer ID o Secret Key non sono corretti, vedrai un messaggio di errore (vedi sezione 5).

Usi entrambi i servizi? Crea una connessione iMile per Delivery e una seconda per Express, ciascuna con il proprio Logistics Product Code.

3. Servizi e destinazioni supportati

Delivery: consegna standard a domicilio.
Express: consegna a domicilio più rapida.

Destinazioni

Nazionali: spedizioni dall'Italia verso l'Italia. Le isole e alcuni CAP non sono serviti da iMile.
Internazionali: supportate, con i dati doganali (codice HS, paese di origine, numero IOSS) inviati automaticamente dall'ordine. Le destinazioni disponibili dipendono dal prodotto attivo sul tuo account iMile.

Funzionalità disponibili con iMile

Etichette PDF 4x6" (100x150 mm), una pagina per collo
Spedizioni multicollo
Aggiornamenti di tracking
Tariffe in tempo reale
Etichette di reso
Prenotazione del ritiro (giorni lavorativi, 09:00–18:00, con una fascia oraria di almeno 2 ore) e annullamento del ritiro
Prova di consegna (POD)
Cancellazione della spedizione prima che il collo venga spedito

Non disponibili: contrassegno, etichette ZPL, punti di ritiro / drop-off (PUDO), assicurazione, documenti paperless, verifica indirizzo.

4. Opzioni aggiuntive

Modalità Test: seleziona Test nel modale per collegare l'ambiente di test di iMile. ⚠️ Le etichette create in modalità Test non sono valide per spedizioni reali: ricordati di deselezionare Test prima di iniziare a spedire.

Formato etichetta: iMile fornisce solo etichette PDF in formato 4x6". Il riferimento dell'ordine viene stampato in grande sull'etichetta, per aiutarti a identificare i colli in magazzino.

Cancellare una spedizione: puoi cancellare una spedizione solo prima che iMile la ritiri. L'annullamento viene elaborato da iMile in pochi secondi, quindi lo stato di tracking potrebbe impiegare un momento ad aggiornarsi.

5. Risoluzione dei problemi ed errori

Errore	Causa	Soluzione
sign is invalid	Secret Key errata	Verifica la Secret Key con iMile e aggiorna la connessione
User does not exist or is disabled	Customer ID errato o non attivo	Verifica il Customer ID con iMile
zipcode city is disabled	Il CAP del mittente o del destinatario non è servito dal tuo prodotto iMile (es. isole)	Chiedi a iMile di estendere la copertura, oppure usa un altro corriere per quel CAP
Product Service no open	Il servizio selezionato non è attivo per il tuo Logistics Product Code	Verifica che Service e Logistics Product Code corrispondano a quanto assegnato da iMile
Internal Server Error / errore di sistema	Problema temporaneo lato corriere	Attendi qualche minuto e riprova; se persiste, contatta il Supporto ShippyPro

6. FAQ

Cosa mi serve per collegare iMile? Un contratto iMile attivo con Customer ID, Secret Key e un Logistics Product Code per ogni servizio che vuoi usare.

Posso usare Delivery ed Express contemporaneamente? Sì. Crea due connessioni iMile, una per servizio, ciascuna con il proprio Logistics Product Code.

iMile consegna nelle isole italiane? No. Le isole e alcuni CAP non sono serviti; riceverai l'errore zipcode city is disabled.

Posso spedire in contrassegno? No, il contrassegno non è disponibile con l'integrazione iMile.

Ho cancellato una spedizione, ma il tracking la mostra ancora attiva. Perché? iMile elabora gli annullamenti in modo asincrono: lo stato si aggiorna dopo qualche secondo.

Posso creare etichette di reso? Sì. Le etichette di reso sono supportate: il cliente consegna il pacco presso iMile.

Ci sono costi aggiuntivi per usare iMile su ShippyPro? Le tariffe di spedizione dipendono dal tuo contratto con iMile. Per il tuo piano ShippyPro, contatta il tuo referente commerciale ShippyPro.