How to Connect Rutilli to ShippyPro

Let's see how you can integrate Rutilli with ShippyPro in just a few steps, and how to use Dynamic Multiparcel to add parcels to the same shipment over time.

Summary

Before you start
How to connect Rutilli
Supported services
Dynamic Multiparcel
Troubleshooting & errors
FAQ

1. Before you start

Before connecting Rutilli to ShippyPro, make sure you have:

An active Rutilli contract. Your Rutilli sales contact provides your SP\ONE Username and Password, your Customer Code, and the Transport Type and Department Code agreed for your account.
Access to the ShippyPro API. Rutilli works only with Dynamic Multiparcel, which is enabled per shipment in the Ship request.
Domestic or EU shipments. Rutilli is a road groupage carrier. Shipments within Italy are supported; EU destinations depend on the lanes included in your Rutilli contract.

Note: Rutilli receives nothing when you create a label. Your shipments reach Rutilli only when you run the closeout (see section 4.2).

2. How to connect Rutilli

Go to the Carriers page and click on the Rutilli logo. Fill in the fields below and click Save. When you save, ShippyPro checks your credentials with Rutilli.

Field	Required	Description
Username	Yes	Your SP\ONE login, provided by Rutilli
Password	Yes	Your SP\ONE password, provided by Rutilli
Customer Code	Yes	Your Rutilli customer ID. Shipments are rejected if this is empty
Service	Yes	Default service. Today the only value is DISTRI – Distribuzione (see section 3)
Transport Type	No	Default G (groupage). Change it only if agreed with Rutilli
Department Code	No	Default STD. Change it only if agreed with Rutilli
Label format	Yes	PDF A6 or ZPL 100x150 203dpi
Test	No	Has no effect for this carrier. See section 5
Custom label	No	A name to recognise this Rutilli account in ShippyPro

Once saved, Rutilli is available among your carriers and you can start creating shipments.

3. Supported services

Service code	Service name
DISTRI	Distribuzione

Destinations: Italy, and EU countries included in your Rutilli contract.
Shipment type: every shipment is sent to Rutilli as road groupage.
Labels: generated by ShippyPro, one per parcel, in PDF A6 or ZPL 100x150.
Tracking: available for every parcel through ShippyPro tracking.

4. Dynamic Multiparcel

With Rutilli, Dynamic Multiparcel is mandatory. You create one parcel per Ship call, and ShippyPro groups the parcels into a single shipment, which is sent to Rutilli at closeout.

Each parcel → its own label and tracking code. ShippyPro assigns every parcel an 18-digit SSCC code. It is printed as the barcode on the label and is also the tracking code.
Parcels to the same recipient → one shipment. Parcels going to the same recipient address are grouped under the same master shipment.
Closeout → sent to Rutilli. Each group is sent as one consolidated shipment with N parcels, and the total weight is the sum of all parcels.

4.1 Create a Dynamic Multiparcel shipment

Step 1 – Create the first parcel

Send a Ship request with IsDynamicMultiparcel: true and a single parcel. ShippyPro opens the master shipment and returns the label and SSCC tracking code for that parcel.

Step 2 – Add the next parcels

Send a new Ship request with IsDynamicMultiparcel: true for each additional parcel. Each parcel joins the open master shipment and gets its own label and SSCC.

For the rules on which parcels can join the same master shipment, see the ShippyPro API documentation – Ship.

Step 3 – Run the closeout

When all parcels are created, run the closeout (CloseShipments). Only then does Rutilli receive the shipment. See section 4.2.

4.2 Closeout

The closeout is mandatory for every Rutilli shipment: it is the only way your shipments reach Rutilli.

Each group of parcels is sent as one shipment, with all its parcels and the total weight.
Groups are independent: if one group fails, the other groups are still sent. Only the orders of the failed group show an error.

Tip: create all the parcels of a group before running the closeout.

Important: Rutilli shipments cannot be cancelled with the Void API, either before or after the closeout. Check your parcels carefully before closing out.

5. Troubleshooting & errors

Error	Cause	Solution
Rutilli can only be used through the Dynamic Multiparcel flow: set isDynamicMultiparcel on the shipment request.	The Ship request was sent without Dynamic Multiparcel.	Send the request again with `IsDynamicMultiparcel: true`.
(000) CustomerId field is required	Customer Code is empty in the carrier configuration.	Add your Customer Code on the Carriers page and run the closeout again.
(000) Json non valido	Rutilli rejected the shipment data, often because of an invalid address.	Check the sender and recipient addresses, then run the closeout again. If it persists, contact ShippyPro Support.
Credentials error when saving the configuration	ShippyPro could not log in to Rutilli.	Check Username and Password with your Rutilli contact.
Shipment not received by Rutilli	The closeout was not run, or it failed.	Run the closeout and check that it completes without errors.
No tracking events	Rutilli has not scanned the parcel yet.	This is not an error. Events appear after the first scan.
Internal Server Error	A temporary issue on the carrier or ShippyPro side.	Wait a few minutes and try again. If it persists, contact ShippyPro Support.

6. FAQ

When does Rutilli receive my shipment? Only after the closeout. Until then, Rutilli has no data about your parcels.

Can I create a Rutilli shipment without Dynamic Multiparcel? No. Every Rutilli shipment must be created with IsDynamicMultiparcel: true, even if it has only one parcel.

Can I cancel or edit a parcel after creating it? No. Rutilli does not support Void or editing. Check your parcels before running the closeout.

Can I test the integration without real shipments? No. Rutilli has no sandbox, and the Test option has no effect.

Can I ship abroad with Rutilli? Yes, to EU countries included in your Rutilli contract. Check the available lanes with your Rutilli contact.

Can I track my parcels? Yes. Each parcel has its own SSCC tracking code, and you can follow it in ShippyPro tracking.