Come connettere Spring Back a ShippyPro
Scopri come connettere Spring Back in pochi semplici passi
Spring Back (by Spring GDS) è un servizio dedicato esclusivamente alla gestione dei resi, che permette di creare spedizioni di ritorno e monitorarne il tracking attraverso un'unica integrazione API.
Supporta diversi corrieri di ultimo miglio (es. Poste Italiane, Royal Mail) tramite una singola connessione.
In questo articolo imparerai a collegare Spring Back a ShippyPro e a scoprire le funzioni disponibili. ✨
Sommario:
1. Prima di iniziare
Per procedere con la connessione è necessario disporre di una API Key fornita direttamente da Spring GDS.
Se non hai ancora ricevuto le tue credenziali, contatta il tuo referente Spring GDS per richiederle.
2. Configurazione corriere
Accedi alla sezione Corrieri e seleziona il logo di Spring Back. Puoi trovarlo rapidamente digitando "Spring Back" nella barra di ricerca. Una volta individuato, clicca per collegare il corriere e compila i campi richiesti:

API Key
La chiave API fornita da Spring GDS per l'autenticazione. Campo obbligatorio.
Service Type
Seleziona il servizio di consegna di ultimo miglio desiderato (es. Poste Italiane, Royal Mail 48). Consulta la tabella dei servizi disponibili nella sezione Opzioni aggiuntive.
Label Type
Unico formato disponibile: PDF A6.
Test Mode
Seleziona questa opzione per utilizzare l'ambiente sandbox durante la fase di test. Deselezionala per passare all'ambiente di produzione.
⚠️ Nota: L'ambiente sandbox applica una validazione più rigida dei campi quando le richieste provengono da determinati client HTTP. Assicurati di inviare sempre i campi indirizzo completi per evitare comportamenti incoerenti.
L'etichetta di reso deve essere generata dallo stesso account che ha creato la spedizione outbound.
3. Opzioni aggiuntive
Destinazioni
- National: Disponibile (es. IT con Poste Italiane, UK con Royal Mail)
- International: Disponibile (in base al servizio selezionato)
Opzioni
- Label PDF: Disponibile (formato A6 – 100x150mm, portrait)
- Label ZPL: NO
- Label EPL: NO
- Track & Trace: Disponibile
- Paperless: NO
- PickUp/DropOff (PUDO): NO
- Cash On Delivery: NO
- Live Rates: NO
- Return Labels: Disponibile (Spring Back è un corriere dedicato esclusivamente ai resi — tutte le spedizioni create sono spedizioni di ritorno)
- Return Labels (in the box): NO
- Book/Schedule Pickup: NO
- Address Check: NO
- Proof Of Delivery (POD): NO
- Insurance: NO
- Multiparcel: NO
- Delete Shipment (Void): NO
- CloseOut: NO
- CN22: NO
- CN23: NO
- Credentials Validation: NO
CN22 Info: è obbligatorio inserire i dettagli degli articoli inclusi nella spedizione di reso.
Servizi
| Service Name | Service Code |
|---|---|
| Poste Italiane | 332 |
| Royal Mail 48 | 296 |
Opzioni corriere
| Name | Slug | Type | Description |
|---|---|---|---|
| Outbound Order ID | outbound_order_id | text | Quando fornito, la spedizione viene creata facendo riferimento a un ordine outbound Spring Back esistente. Il corriere recupera i dati degli articoli dall'ordine originale. L'indirizzo del destinatario viene comunque inviato per intero. |
È obbligatorio indicare l'AWB della spedizione outbound in Opzioni Corrieri. Esempio:
`"CarrierOptions": [{ "name": "springbackexportAwb", "value": "YT983699097GB" }]`
4. Errori & Risoluzioni
Durante il tentativo di connessione a Spring Back o durante la creazione dei resi, potresti riscontrare alcuni errori. Per maggiori informazioni su come risolverli, consulta il Help Center di ShippyPro o contatta il supporto.