Come collegare Rutilli a ShippyPro

Vediamo come puoi integrare Rutilli con ShippyPro in pochi passaggi, e come usare il Dynamic Multiparcel per aggiungere colli alla stessa spedizione nel tempo.

Sommario

Prima di iniziare
Come collegare Rutilli
Servizi supportati
Dynamic Multiparcel
Risoluzione dei problemi ed errori
FAQ

1. Prima di iniziare

Prima di collegare Rutilli a ShippyPro, assicurati di avere:

Un contratto Rutilli attivo. Il tuo referente commerciale Rutilli ti fornisce Username e Password SP\ONE, il tuo Customer Code, e il Transport Type e il Department Code concordati per il tuo account.
Accesso alle API di ShippyPro. Rutilli funziona solo con il Dynamic Multiparcel, che si attiva per singola spedizione nella richiesta Ship.
Spedizioni nazionali o UE. Rutilli è un corriere groupage su strada. Le spedizioni in Italia sono supportate; le destinazioni UE dipendono dalle tratte incluse nel tuo contratto Rutilli.

Nota: Rutilli non riceve nulla quando crei un'etichetta. Le tue spedizioni arrivano a Rutilli solo quando esegui la closeout (vedi sezione 4.2).

2. Come collegare Rutilli

Vai alla pagina Carriers e clicca sul logo Rutilli. Compila i campi qui sotto e clicca su Save. Al salvataggio ShippyPro verifica le tue credenziali con Rutilli.

Campo	Obbligatorio	Descrizione
Username	Sì	Il tuo login SP\ONE, fornito da Rutilli
Password	Sì	La tua password SP\ONE, fornita da Rutilli
Customer Code	Sì	Il tuo codice cliente Rutilli. Se è vuoto, le spedizioni vengono rifiutate
Service	Sì	Servizio predefinito. Oggi l'unico valore è DISTRI – Distribuzione (vedi sezione 3)
Transport Type	No	Predefinito G (groupage). Modificalo solo se concordato con Rutilli
Department Code	No	Predefinito STD. Modificalo solo se concordato con Rutilli
Label format	Sì	PDF A6 oppure ZPL 100x150 203dpi
Test	No	Non ha effetto per questo corriere.
Custom label	No	Un nome per riconoscere questo account Rutilli in ShippyPro

Una volta salvato, Rutilli è disponibile tra i tuoi corrieri e puoi iniziare a creare spedizioni.

3. Servizi supportati

Codice servizio	Nome servizio
DISTRI	Distribuzione

Destinazioni: Italia e paesi UE inclusi nel tuo contratto Rutilli.
Tipo di spedizione: ogni spedizione viene inviata a Rutilli come groupage su strada.
Etichette: generate da ShippyPro, una per collo, in PDF A6 o ZPL 100x150.
Tracking: disponibile per ogni collo tramite il tracking di ShippyPro.

4. Dynamic Multiparcel

Con Rutilli il Dynamic Multiparcel è obbligatorio. Crei un collo per ogni chiamata Ship e ShippyPro raggruppa i colli in un'unica spedizione, che viene inviata a Rutilli alla closeout.

Ogni collo → propria etichetta e proprio codice di tracking. ShippyPro assegna a ogni collo un codice SSCC a 18 cifre. È stampato come barcode sull'etichetta ed è anche il codice di tracking.
Colli per lo stesso destinatario → una sola spedizione. I colli diretti allo stesso indirizzo di destinazione vengono raggruppati sotto la stessa spedizione master.
Closeout → invio a Rutilli. Ogni gruppo viene inviato come un'unica spedizione consolidata con N colli; il peso totale è la somma dei pesi di tutti i colli.

4.1 Creare una spedizione Dynamic Multiparcel

Passaggio 1 – Crea il primo collo

Invia una richiesta Ship con IsDynamicMultiparcel: true e un solo collo. ShippyPro apre la spedizione master e restituisce l'etichetta e il codice di tracking SSCC di quel collo.

Passaggio 2 – Aggiungi i colli successivi

Invia una nuova richiesta Ship con IsDynamicMultiparcel: true per ogni collo aggiuntivo. Ogni collo entra nella spedizione master aperta e riceve una propria etichetta e un proprio SSCC.

Per le regole su quali colli possono entrare nella stessa spedizione master, consulta la documentazione API di ShippyPro – Ship.

Passaggio 3 – Esegui la closeout

Quando hai creato tutti i colli, esegui la closeout (CloseShipments). Solo allora Rutilli riceve la spedizione. Vedi sezione 4.2.

4.2 Closeout

La closeout è obbligatoria per ogni spedizione Rutilli: è l'unico modo in cui le tue spedizioni arrivano a Rutilli.

Ogni gruppo di colli viene inviato come un'unica spedizione, con tutti i suoi colli e il peso totale.
I gruppi sono indipendenti: se un gruppo fallisce, gli altri vengono comunque inviati. Solo gli ordini del gruppo fallito mostrano un errore.

Suggerimento: crea tutti i colli di un gruppo prima di eseguire la closeout.

Importante: le spedizioni Rutilli non possono essere cancellate con l'API Void, né prima né dopo la closeout. Controlla bene i colli prima di eseguire la closeout.

5. Risoluzione dei problemi ed errori

Errore	Causa	Soluzione
Rutilli can only be used through the Dynamic Multiparcel flow: set isDynamicMultiparcel on the shipment request.	La richiesta Ship è stata inviata senza Dynamic Multiparcel.	Invia di nuovo la richiesta con `IsDynamicMultiparcel: true`.
(000) CustomerId field is required	Il Customer Code è vuoto nella configurazione del corriere.	Inserisci il tuo Customer Code nella pagina Carriers ed esegui di nuovo la closeout.
(000) Json non valido	Rutilli ha rifiutato i dati della spedizione, spesso per un indirizzo non valido.	Controlla gli indirizzi di mittente e destinatario, poi esegui di nuovo la closeout. Se il problema persiste, contatta il Supporto ShippyPro.
Errore di credenziali al salvataggio della configurazione	ShippyPro non è riuscito ad accedere a Rutilli.	Verifica Username e Password con il tuo referente Rutilli.
Spedizione non ricevuta da Rutilli	La closeout non è stata eseguita oppure è fallita.	Esegui la closeout e verifica che si completi senza errori.
Nessun evento di tracking	Rutilli non ha ancora scansionato il collo.	Non è un errore. Gli eventi compaiono dopo la prima scansione.
Internal Server Error	Problema temporaneo lato corriere o lato ShippyPro.	Attendi qualche minuto e riprova. Se il problema persiste, contatta il Supporto ShippyPro.

6. FAQ

Quando Rutilli riceve la mia spedizione? Solo dopo la closeout. Fino ad allora Rutilli non ha alcun dato sui tuoi colli.

Posso creare una spedizione Rutilli senza Dynamic Multiparcel? No. Ogni spedizione Rutilli deve essere creata con IsDynamicMultiparcel: true, anche se ha un solo collo.

Posso cancellare o modificare un collo dopo averlo creato? No. Rutilli non supporta né Void né la modifica. Controlla i colli prima di eseguire la closeout.

Posso testare l'integrazione senza spedizioni reali? No. Rutilli non ha una sandbox e l'opzione Test non ha effetto.

Posso spedire all'estero con Rutilli? Sì, verso i paesi UE inclusi nel tuo contratto Rutilli. Verifica le tratte disponibili con il tuo referente Rutilli.

Posso tracciare i colli? Sì. Ogni collo ha un proprio codice di tracking SSCC, che puoi seguire tramite il tracking di ShippyPro.