How to connect iMile to ShippyPro

Let's see how you can integrate iMile with ShippyPro in just a few steps.

Summary

Before you start
How to connect iMile
Supported services and destinations
Additional options
Troubleshooting & errors
FAQ

1. Before you start

To connect iMile you need an active contract with iMile. Ask your iMile account manager for:

Customer ID: your iMile customer code
Secret Key: the key iMile provides to sign your requests
Logistics Product Code: the product code iMile assigns to each service you want to use (Delivery and/or Express)

If you want to use both Delivery and Express, make sure iMile gives you a separate Logistics Product Code for each one.

2. How to connect iMile

Go to the Carriers page and click on the iMile logo.
Fill in the connection modal:

Field	Required	Description
Customer ID	Yes	Your iMile customer code
Secret Key	Yes	Signing key provided by iMile
Service	Yes	Delivery or Express
Logistics Product Code	Yes	iMile product code for the selected service
Label Type	Yes	PDF 4x6" (the only available format)
Test	No	Connects to the iMile test environment

Click Save. ShippyPro checks your credentials immediately: if the Customer ID or Secret Key is wrong, you will see an error message (see section 5).

Using both services? Create one iMile connection for Delivery and a second one for Express, each with its own Logistics Product Code.

3. Supported services and destinations

Delivery: standard home delivery.
Express: faster home delivery.

Destinations

Domestic: shipments from Italy to Italy. Islands and some postcodes are not served by iMile.
International: supported, with customs data (HS code, country of origin, IOSS number) sent automatically from your order. Available destinations depend on the product enabled on your iMile account.

Features available with iMile

PDF labels 4x6" (100x150 mm), one page per parcel
Multi-parcel shipments
Tracking updates
Live rates
Return labels
Pickup booking (working days, 09:00–18:00, with a time window of at least 2 hours) and pickup cancellation
Proof of Delivery (POD)
Shipment deletion before the parcel is shipped

4. Additional options

Test Mode: select Test in the modal to connect to the iMile test environment. ⚠️ Labels created in Test Mode are not valid for real shipments: remember to deselect Test before you start shipping.

5. Troubleshooting & errors

Error	Cause	Solution
sign is invalid	Wrong Secret Key	Check the Secret Key with iMile and update the connection
User does not exist or is disabled	Wrong or inactive Customer ID	Check the Customer ID with iMile
zipcode city is disabled	The sender or recipient postcode is not served by your iMile product (e.g. islands)	Ask iMile to extend coverage, or use another carrier for that postcode
Product Service no open	The selected service is not enabled for your Logistics Product Code	Make sure Service and Logistics Product Code match what iMile assigned to you
Internal Server Error / system error	Temporary issue on the carrier side	Wait a few minutes and try again; if it persists, contact ShippyPro Support

6. FAQ

What do I need to connect iMile? An active iMile contract with your Customer ID, Secret Key and a Logistics Product Code for each service you want to use.

Can I use Delivery and Express at the same time? Yes. Create two iMile connections, one per service, each with its own Logistics Product Code.

Does iMile deliver to the Italian islands? No. Islands and some postcodes are not served; you will receive the zipcode city is disabled error.

Can I ship with Cash on Delivery? No, Cash on Delivery is not available with the iMile integration.

I deleted a shipment, but tracking still shows it as active. Why? iMile processes cancellations asynchronously: the status updates after a few seconds.

Can I create return labels? Yes. Return labels are supported: the customer drops the parcel off at iMile.

Are there extra costs to use iMile on ShippyPro? Shipping rates depend on your contract with iMile. For your ShippyPro plan, contact your ShippyPro sales representative.