Come connettere Colissimo v2 a ShippyPro

Sommario:

Prima di iniziare
Configurazione del corriere
Funzionalità aggiuntive
Risoluzione dei problemi ed errori

1. Prima di iniziare

Colissimo v2 è il nuovo connettore La Poste – Colissimo. Copre la consegna a domicilio con o senza firma, i punti relay e gli uffici postali, il contrassegno, l'assicurazione, i documenti doganali (CN23), i resi, i ritiri con corriere e il bordereau giornaliero. Sostituisce il vecchio connettore Colissimo, il cui accesso tramite numero di contratto e password è stato dichiarato obsoleto da Colissimo.

Per configurare Colissimo v2, devi avere un account Colissimo attivo con accesso ai web services. Puoi connetterti in due modi:

API Key (consigliata da Colissimo): generala nel Colissimo Box, nel tuo profilo, in "Web Services connection key", cliccando su "Generate". Una nuova chiave è efficace immediatamente e la precedente smette di funzionare.
Contract Number e Password: ancora supportati, ma Colissimo ha indicato questo metodo di accesso come obsoleto.

Assicurati inoltre che Colissimo abbia abilitato sul tuo contratto i servizi che intendi utilizzare (ad esempio tracciamento, contrassegno, merci pericolose o ritiro con corriere).

2. Configurazione del corriere

Segui questi passaggi per connettere Colissimo v2 al tuo account ShippyPro:

Accedi al tuo account ShippyPro
Vai su Connessioni > Corrieri
Scorri verso il basso e clicca sul logo Colissimo v2
Apparirà una finestra di connessione. Compila i campi richiesti:
- Label: Un nome libero per questa configurazione, mostrato nel tuo elenco corrieri
- API Key: Inserisci la chiave web services generata nel Colissimo Box (opzionale se compili Contract Number e Password)
- Contract Number: Inserisci il tuo numero di contratto Colissimo. Viene utilizzato anche per identificare il tuo contratto nei ritiri con corriere e nelle ricerche dei punti di ritiro
- Password: Inserisci la tua password del Colissimo Box (opzionale se utilizzi una API Key)
- Label Type: Seleziona PDF A4, PDF 10x15 (A6), ZPL 203 DPI, ZPL 300 DPI, DPL 203 DPI, A4 horizontal, oppure A4 horizontal with packing slip
Clicca su Salva per stabilire la connessione

ShippyPro validerà automaticamente le tue credenziali senza creare alcuna etichetta. Se l'operazione ha successo, Colissimo v2 apparirà come corriere attivo nel tuo account. Devi compilare o la API Key, oppure il Contract Number insieme alla Password.

Configurazione opzionale:

Account Number: Compilalo solo se spedisci per conto di un altro account Colissimo (account delegato). Un numero di account errato o non delegato viene rifiutato con l'errore "identificativo o password non corretti" (30000)
Fixed Sender Address: Seleziona una voce della rubrica da usare come mittente al posto dell'indirizzo di origine dell'ordine
Print Return Label: Crea un'etichetta di reso nella scatola insieme all'etichetta di andata
Return Receiver Address: Seleziona una voce della rubrica per i tuoi resi. L'etichetta di reso nella scatola torna a questo indirizzo e gli ordini di reso vengono spediti da questo indirizzo. Se vuoto, viene utilizzata l'origine della spedizione
With Signature: Spedisce con firma (DOS) invece che senza firma (DOM). Per i territori d'oltremare viene utilizzato CDS invece di COM
QR Code Labelless Return: Gli ordini di reso ricevono un codice QR invece di un'etichetta stampata
Test Mode: Invia le richieste di etichetta (e il controllo delle credenziali al salvataggio) all'ambiente di test di Colissimo. I numeri di collo generati in modalità test sono fittizi e non viene creata nessuna spedizione reale. Tracciamento, punti di ritiro e ritiri con corriere utilizzano sempre l'ambiente reale, e la chiusura non è disponibile in modalità test

Congratulazioni, ora sei connesso! È ora di iniziare a spedire con Colissimo v2.

3. Funzionalità aggiuntive

Destinazioni

Nazionali: Francia e Monaco. Le spedizioni devono partire da Francia o Monaco

Internazionali: Europa e resto del mondo, inclusi i territori francesi d'oltremare (GP, MQ, GF, RE, YT, PM, BL, MF, FQ, WF, PF, NC). I resi possono partire dall'estero

Funzionalità

Tipo di etichetta: PDF (A4, 10x15), ZPL (203 DPI, 300 DPI), DPL (203 DPI)
Track & Trace: Disponibile (storico completo degli eventi)
Paperless: Non disponibile
PickUp/DropOff (PUDO): Disponibile (solo Francia e Monaco)
Contrassegno: Disponibile
Tariffe in tempo reale: Non disponibile
Etichette di reso: Disponibile
Etichette di reso (nella scatola): Disponibile
Prenota/Programma ritiro: Disponibile (con verifica della disponibilità e annullamento)
Verifica indirizzo: Non disponibile
Prova di consegna (POD): Non disponibile
Opzioni di mancata consegna: Non disponibile
Assicurazione: Disponibile (fino a 5.000 €)
Multicollo: Disponibile
Annulla spedizione (Void): Non disponibile
Chiusura: Disponibile
CN22: Disponibile
CN23: Disponibile
Validazione credenziali: Disponibile

Tipi di servizio

Colissimo v2 non prevede la selezione del servizio: il prodotto Colissimo viene scelto automaticamente per ogni spedizione, in base alla destinazione e alle opzioni utilizzate.

Caso	Prodotto
Predefinito	DOS con firma, DOM senza firma
Contrassegno, o assicurazione, con DOM	DOS
Assicurazione verso un paese diverso da FR, AD, CH, MC, IS, DE, IT, ES, PT, BE, LU	COLI
Verso GP, MQ, GF, RE, YT, PM, BL, MF, FQ, WF, PF, NC	CDS con firma o assicurazione, altrimenti COM
Fuori dall'UE e diverso da AD, CH, MC, GB, IS	COLI
Punto di ritiro	A2P (punto relay) o BPR (ufficio postale)
Reso da Francia/Monaco a Francia/Monaco	CORE
Altri resi	CORI (etichetta A4)

Spedizioni multicollo

Colissimo v2 supporta le spedizioni multicollo. Ogni collo riceve la propria etichetta e il proprio numero di collo: il primo è il codice di tracciamento principale, gli altri sono codici di tracciamento aggiuntivi. Per le spedizioni internazionali, ogni collo ha anche il proprio CN23.

PickUp/DropOff (PUDO)

Puoi consegnare presso punti relay e uffici postali in Francia e Monaco. Quando scegli un punto di ritiro sulla mappa, ShippyPro mostra i 20 punti più vicini, con i relativi orari di apertura. Se non viene selezionato alcun punto di ritiro, il collo viene consegnato all'indirizzo di casa del destinatario.

Contrassegno (COD)

Colissimo v2 supporta il Contrassegno, che richiede l'abilitazione del tuo contratto da parte di Colissimo. Le spedizioni in contrassegno vengono sempre inviate con firma.

Assicurazione

Colissimo v2 supporta l'assicurazione. Il valore dichiarato viene arrotondato per eccesso allo scaglione Colissimo successivo (150, 300, 500, 1.000, 2.000 o 5.000 €). Le spedizioni assicurate vengono sempre inviate con firma.

Dogana (CN23)

Per ogni destinazione fuori dalla Francia, Colissimo restituisce la dichiarazione doganale CN23 insieme all'etichetta, costruita a partire da descrizione del contenuto, codice HS, paese di origine, quantità, peso e valore di ogni articolo. Tieni presente che:

Le spedizioni verso gli USA richiedono il numero EORI del mittente
Per le spedizioni multicollo, gli articoli e il costo di spedizione vengono suddivisi tra i colli, quindi l'ordine deve contenere almeno tante unità di articolo quanti sono i colli
Se il tuo incoterm è DDP su una spedizione internazionale, la spedizione viene inviata come dazi pagati

Etichette di reso

Colissimo v2 supporta diversi tipi di reso:

Ordini di reso: inviati come CORE (da Francia o Monaco a Francia o Monaco) o CORI (dall'estero, con etichetta A4). Vengono spediti dal tuo Return Receiver Address, se impostato
Etichetta di reso nella scatola: attiva Print Return Label per creare un'unica etichetta di reso per l'intero ordine, con il peso totale di tutti i colli, indirizzata al tuo Return Receiver Address (o all'origine della spedizione se non impostato)
QR Code Labelless Return: gli ordini di reso ricevono un codice QR invece di un'etichetta stampata

Prenota/Programma ritiro

Puoi prenotare un ritiro con corriere all'indirizzo registrato sul tuo contratto Colissimo, verificare la prima data disponibile e annullare un ritiro. Tieni presente che:

Il tuo contratto Colissimo deve includere il servizio di ritiro con corriere
L'annullamento si applica all'ultimo ritiro creato per il tuo contratto
Un ritiro nello stesso giorno non può essere annullato online

Chiusura

Colissimo v2 supporta il bordereau giornaliero (il manifesto PDF, in formato A4) per le tue spedizioni in uscita. Gli ordini di reso non sono inclusi nel bordereau.

Opzioni corriere

Colissimo v2 offre opzioni aggiuntive per personalizzare le tue spedizioni:

Opzione	Descrizione
Pickup Point	Punto relay o ufficio postale scelto sulla mappa. Senza di esso, il collo viene consegnato all'indirizzo di casa
Customer Barcode	Stampa il Customer Barcode Value come codice a barre aggiuntivo sull'etichetta. Non utilizzabile insieme a Tracking Barcode
Customer Barcode Value	Il valore stampato quando Customer Barcode è attivo
Tracking Barcode	Stampa il numero di tracciamento come codice a barre aggiuntivo sull'etichetta. Non utilizzabile insieme a Customer Barcode
Dangerous Goods Category	Categoria hazmat, una singola lettera da A a Z. Il tuo contratto deve essere autorizzato per le merci pericolose

Formati etichetta

Colissimo v2 supporta i seguenti formati di etichetta:

PDF A4
PDF 10x15 (A6)
ZPL 203 DPI e ZPL 300 DPI: Formati etichetta termica
DPL 203 DPI: Formato etichetta termica
A4 horizontal e A4 horizontal with packing slip: attualmente stampano l'etichetta 10x15, senza l'impaginazione A4

Assicurati che la tua stampante di etichette sia compatibile con il formato selezionato.

Tracciamento

Tutte le spedizioni Colissimo v2 possono essere tracciate utilizzando il numero di collo fornito dopo la creazione della spedizione. Il tracciamento mostra lo storico completo degli eventi ed è disponibile all'interno di ShippyPro. Il tuo contratto deve essere abilitato al tracciamento da Colissimo.

4. Risoluzione dei problemi ed errori

Problemi comuni:

❓ Dove trovo la mia API Key?

A: Nel Colissimo Box, apri il tuo profilo, vai su "Web Services connection key" e clicca su "Generate". Una nuova chiave è efficace immediatamente e la vecchia smette di funzionare, quindi ricordati di aggiornarla in ShippyPro.

❓ Perché la mia autenticazione sta fallendo?

A: Verifica di aver compilato o la API Key, oppure il Contract Number insieme alla Password. Se utilizzi un Account Number, assicurati che sia un account delegato del tuo contratto: in caso contrario Colissimo risponde con l'errore 30000 (identificativo o password non corretti). Se continui ad avere problemi, contatta il supporto Colissimo per la verifica del tuo accesso ai web services.

❓ Perché il tracciamento non funziona?

A: Il tuo contratto Colissimo deve essere abilitato al tracciamento da Colissimo.

❓ Posso annullare/cancellare una spedizione dopo averla creata?

A: No, Colissimo non supporta l'annullamento della spedizione. Le etichette che non sono state scansionate non vengono fatturate.

❓ Perché la mia spedizione di merci pericolose è stata rifiutata?

A: Il tuo contratto Colissimo deve essere autorizzato per le merci pericolose (altrimenti errore 32001). Contatta Colissimo per richiedere l'autorizzazione.

❓ Perché la mia spedizione verso gli USA è stata rifiutata?

A: Dal settembre 2025, le norme doganali statunitensi richiedono il numero EORI del mittente (errore 30561). Assicurati che l'EORI sia impostato sul mittente.

❓ Perché la mia spedizione in contrassegno o assicurata è stata inviata con firma?

A: Colissimo non consente il contrassegno né l'assicurazione senza firma, quindi queste spedizioni vengono sempre inviate come DOS (CDS per i territori d'oltremare). Il contrassegno richiede inoltre che il tuo contratto sia abilitato da Colissimo.

❓ Perché la mia spedizione fallisce con un errore su indirizzo o nome?

A: Colissimo suddivide gli indirizzi in righe da 35 caratteri e limita i nomi a 29 caratteri e i cognomi e i nomi aziendali a 35. Se un nome è più lungo, accorcialo.

❓ Perché non riesco a programmare un ritiro con corriere?

A: Il tuo contratto Colissimo deve includere il servizio di ritiro con corriere. Se ricevi un errore di "cliente sconosciuto", contatta Colissimo per farlo abilitare.

❓ Come correggo altri errori Colissimo?

A: Consulta la nostra guida sugli errori Colissimo più comuni.