Comment connecter Colissimo v2 à ShippyPro

Résumé :

1. Avant de commencer
2. Configuration du transporteur
3. Fonctionnalités supplémentaires
4. Dépannage et erreurs

---

1. Avant de commencer

Colissimo v2 est le nouveau connecteur La Poste – Colissimo. Il couvre la livraison à domicile avec ou sans signature, les points relais et les bureaux de poste, le contre-remboursement, l'assurance, les documents douaniers (CN23), les retours, les enlèvements par coursier et le bordereau quotidien. Il remplace l'ancien connecteur Colissimo, dont la connexion par numéro de contrat et mot de passe a été déclarée obsolète par Colissimo.

Pour configurer Colissimo v2, vous devez disposer d'un compte Colissimo actif avec accès aux web services. Vous pouvez vous connecter de deux manières :

• API Key (recommandée par Colissimo) : générez-la dans le Colissimo Box, dans votre profil, sous « Web Services connection key », en cliquant sur « Generate ». Une nouvelle clé est effective immédiatement et la précédente cesse de fonctionner.
• Contract Number et Password : toujours pris en charge, mais Colissimo a indiqué que cette méthode de connexion est obsolète.

Assurez-vous également que Colissimo a activé sur votre contrat les services que vous prévoyez d'utiliser (par exemple le suivi, le contre-remboursement, les marchandises dangereuses ou l'enlèvement par coursier).

---

2. Configuration du transporteur

Suivez ces étapes pour connecter Colissimo v2 à votre compte ShippyPro :

1. Connectez-vous à votre compte ShippyPro
2. Accédez à Connexions > Transporteurs
3. Faites défiler vers le bas et cliquez sur le logo Colissimo v2
4. Une fenêtre de connexion apparaîtra. Remplissez les champs requis :
   • Label : Un nom libre pour cette configuration, affiché dans votre liste de transporteurs
   • API Key : Saisissez la clé web services générée dans le Colissimo Box (facultatif si vous renseignez Contract Number et Password)
   • Contract Number : Saisissez votre numéro de contrat Colissimo. Il sert également à identifier votre contrat pour les enlèvements par coursier et les recherches de points de retrait
   • Password : Saisissez votre mot de passe du Colissimo Box (facultatif si vous utilisez une API Key)
   • Label Type : Sélectionnez PDF A4, PDF 10x15 (A6), ZPL 203 DPI, ZPL 300 DPI, DPL 203 DPI, A4 horizontal, ou A4 horizontal with packing slip
5. Cliquez sur Enregistrer pour établir la connexion

ShippyPro validera automatiquement vos identifiants sans créer d'étiquette. En cas de succès, Colissimo v2 apparaîtra comme transporteur actif dans votre compte. Vous devez renseigner soit l'API Key, soit le Contract Number avec le Password.

Configuration optionnelle :

• Account Number : Renseignez-le uniquement si vous expédiez pour le compte d'un autre compte Colissimo (compte délégué). Un numéro de compte incorrect ou non délégué est rejeté avec l'erreur « identifiant ou mot de passe incorrect » (30000)
• Fixed Sender Address : Sélectionnez une entrée du carnet d'adresses à utiliser comme expéditeur à la place de l'adresse d'origine de la commande
• Print Return Label : Crée une étiquette de retour dans le colis en même temps que l'étiquette aller
• Return Receiver Address : Sélectionnez une entrée du carnet d'adresses pour vos retours. L'étiquette de retour dans le colis est renvoyée à cette adresse et les commandes de retour sont expédiées depuis cette adresse. Si ce champ est vide, l'origine de l'envoi est utilisée
• With Signature : Expédie avec signature (DOS) au lieu de sans signature (DOM). Pour les territoires d'outre-mer, CDS est utilisé à la place de COM
• QR Code Labelless Return : Les commandes de retour reçoivent un QR code au lieu d'une étiquette imprimée
• Test Mode : Envoie les demandes d'étiquette (et la vérification des identifiants à l'enregistrement) à l'environnement de test de Colissimo. Les numéros de colis générés en mode test sont fictifs et aucun envoi réel n'est créé. Le suivi, les points de retrait et les enlèvements par coursier utilisent toujours l'environnement réel, et la clôture n'est pas disponible en mode test

Félicitations, vous êtes maintenant connecté ! Il est temps de commencer à expédier avec Colissimo v2.

---

3. Fonctionnalités supplémentaires

Destinations

Nationales : France et Monaco. Les envois doivent partir de France ou de Monaco

Internationales : Europe et reste du monde, y compris les territoires français d'outre-mer (GP, MQ, GF, RE, YT, PM, BL, MF, FQ, WF, PF, NC). Les retours peuvent partir de l'étranger

Fonctionnalités

• Type d'étiquette : PDF (A4, 10x15), ZPL (203 DPI, 300 DPI), DPL (203 DPI)
• Track & Trace : Disponible (historique complet des événements)
• Paperless : Non disponible
• PickUp/DropOff (PUDO) : Disponible (France et Monaco uniquement)
• Contre-remboursement : Disponible
• Tarifs en temps réel : Non disponible
• Étiquettes de retour : Disponible
• Étiquettes de retour (dans le colis) : Disponible
• Réserver/Planifier un enlèvement : Disponible (avec vérification des disponibilités et annulation)
• Vérification d'adresse : Non disponible
• Preuve de livraison (POD) : Non disponible
• Options de non-livraison : Non disponible
• Assurance : Disponible (jusqu'à 5 000 €)
• Multi-colis : Disponible
• Annuler l'envoi (Void) : Non disponible
• Clôture : Disponible
• CN22 : Disponible
• CN23 : Disponible
• Validation des identifiants : Disponible

Types de service

Colissimo v2 ne propose pas de sélection de service : le produit Colissimo est choisi automatiquement pour chaque envoi, en fonction de la destination et des options utilisées.

Cas	Produit
Par défaut	DOS avec signature, DOM sans signature
Contre-remboursement, ou assurance, avec DOM	DOS
Assurance vers un pays autre que FR, AD, CH, MC, IS, DE, IT, ES, PT, BE, LU	COLI
Vers GP, MQ, GF, RE, YT, PM, BL, MF, FQ, WF, PF, NC	CDS avec signature ou assurance, sinon COM
Hors UE et autre que AD, CH, MC, GB, IS	COLI
Point de retrait	A2P (point relais) ou BPR (bureau de poste)
Retour de France/Monaco vers France/Monaco	CORE
Autres retours	CORI (étiquette A4)

Envois multi-colis

Colissimo v2 prend en charge les envois multi-colis. Chaque colis reçoit sa propre étiquette et son propre numéro de colis : le premier est le code de suivi principal, les autres sont des codes de suivi additionnels. Pour les envois internationaux, chaque colis possède également son propre CN23.

PickUp/DropOff (PUDO)

Vous pouvez livrer dans des points relais et des bureaux de poste en France et à Monaco. Lorsque vous choisissez un point de retrait sur la carte, ShippyPro affiche les 20 points les plus proches, avec leurs horaires d'ouverture. Si aucun point de retrait n'est sélectionné, le colis est livré à l'adresse du domicile du destinataire.

Contre-remboursement (COD)

Colissimo v2 prend en charge le Contre-remboursement, qui nécessite que votre contrat soit activé pour ce service par Colissimo. Les envois en contre-remboursement sont toujours expédiés avec signature.

Assurance

Colissimo v2 prend en charge l'assurance. La valeur déclarée est arrondie au palier Colissimo supérieur (150, 300, 500, 1 000, 2 000 ou 5 000 €). Les envois assurés sont toujours expédiés avec signature.

Douane (CN23)

Pour chaque destination hors de France, Colissimo renvoie la déclaration en douane CN23 avec l'étiquette, construite à partir de la description du contenu, du code HS, du pays d'origine, de la quantité, du poids et de la valeur de chaque article. Gardez à l'esprit que :

• Les envois vers les États-Unis nécessitent le numéro EORI de l'expéditeur
• Pour les envois multi-colis, les articles et les frais d'expédition sont répartis entre les colis ; la commande doit donc contenir au moins autant d'unités d'articles que de colis
• Si votre incoterm est DDP sur un envoi international, l'envoi est expédié en droits acquittés

Étiquettes de retour

Colissimo v2 prend en charge plusieurs types de retours :

• Commandes de retour : envoyées en CORE (de France ou Monaco vers France ou Monaco) ou en CORI (depuis l'étranger, avec une étiquette A4). Elles sont expédiées depuis votre Return Receiver Address lorsqu'elle est définie
• Étiquette de retour dans le colis : activez Print Return Label pour créer une étiquette de retour unique pour toute la commande, avec le poids total de tous les colis, adressée à votre Return Receiver Address (ou à l'origine de l'envoi si aucune n'est définie)
• QR Code Labelless Return : les commandes de retour reçoivent un QR code au lieu d'une étiquette imprimée

Réserver/Planifier un enlèvement

Vous pouvez réserver un enlèvement par coursier à l'adresse enregistrée sur votre contrat Colissimo, vérifier la prochaine date disponible et annuler un enlèvement. Veuillez noter que :

• Votre contrat Colissimo doit inclure le service d'enlèvement par coursier
• L'annulation s'applique au dernier enlèvement créé pour votre contrat
• Un enlèvement le jour même ne peut pas être annulé en ligne

Clôture

Colissimo v2 prend en charge le bordereau quotidien (le manifeste PDF, au format A4) pour vos envois sortants. Les commandes de retour ne sont pas incluses dans le bordereau.

Options du transporteur

Colissimo v2 propose des options supplémentaires pour personnaliser vos envois :

Option	Description
Pickup Point	Point relais ou bureau de poste choisi sur la carte. Sans cette option, le colis est livré à l'adresse du domicile
Customer Barcode	Imprime le Customer Barcode Value comme code-barres supplémentaire sur l'étiquette. Ne peut pas être utilisé avec Tracking Barcode
Customer Barcode Value	La valeur imprimée lorsque Customer Barcode est activé
Tracking Barcode	Imprime le numéro de suivi comme code-barres supplémentaire sur l'étiquette. Ne peut pas être utilisé avec Customer Barcode
Dangerous Goods Category	Catégorie hazmat, une seule lettre de A à Z. Votre contrat doit être autorisé pour les marchandises dangereuses

Formats d'étiquette

Colissimo v2 prend en charge les formats d'étiquette suivants :

• PDF A4
• PDF 10x15 (A6)
• ZPL 203 DPI et ZPL 300 DPI : Formats d'étiquette thermique
• DPL 203 DPI : Format d'étiquette thermique
• A4 horizontal et A4 horizontal with packing slip : impriment actuellement l'étiquette 10x15, sans la mise en page A4

Assurez-vous que votre imprimante d'étiquettes est compatible avec le format sélectionné.

Suivi

Tous les envois Colissimo v2 peuvent être suivis à l'aide du numéro de colis fourni après la création de l'envoi. Le suivi affiche l'historique complet des événements et est disponible dans ShippyPro. Votre contrat doit être activé pour le suivi par Colissimo.

---

4. Dépannage et erreurs

Problèmes courants :

❓ Où trouver mon API Key ?

R : Dans le Colissimo Box, ouvrez votre profil, rendez-vous sous « Web Services connection key » et cliquez sur « Generate ». Une nouvelle clé est effective immédiatement et l'ancienne cesse de fonctionner ; pensez donc à la mettre à jour dans ShippyPro.

❓ Pourquoi mon authentification échoue-t-elle ?

R : Vérifiez que vous avez renseigné soit l'API Key, soit le Contract Number avec le Password. Si vous utilisez un Account Number, assurez-vous qu'il s'agit d'un compte délégué de votre contrat : dans le cas contraire, Colissimo répond avec l'erreur 30000 (identifiant ou mot de passe incorrect). Si vous continuez à rencontrer des problèmes, contactez le support Colissimo pour la vérification de votre accès aux web services.

❓ Pourquoi le suivi ne fonctionne-t-il pas ?

R : Votre contrat Colissimo doit être activé pour le suivi par Colissimo.

❓ Puis-je annuler un envoi après l'avoir créé ?

R : Non, Colissimo ne prend pas en charge l'annulation d'envois. Les étiquettes qui n'ont pas été scannées ne sont pas facturées.

❓ Pourquoi mon envoi de marchandises dangereuses a-t-il été refusé ?

R : Votre contrat Colissimo doit être autorisé pour les marchandises dangereuses (sinon erreur 32001). Contactez Colissimo pour demander l'autorisation.

❓ Pourquoi mon envoi vers les États-Unis a-t-il été refusé ?

R : Depuis septembre 2025, les règles douanières américaines exigent le numéro EORI de l'expéditeur (erreur 30561). Assurez-vous que l'EORI est renseigné sur l'expéditeur.

❓ Pourquoi mon envoi en contre-remboursement ou assuré a-t-il été expédié avec signature ?

R : Colissimo n'autorise ni le contre-remboursement ni l'assurance sans signature ; ces envois sont donc toujours expédiés en DOS (CDS pour les territoires d'outre-mer). Le contre-remboursement nécessite également que votre contrat soit activé pour ce service par Colissimo.

❓ Pourquoi mon envoi échoue-t-il avec une erreur d'adresse ou de nom ?

R : Colissimo découpe les adresses en lignes de 35 caractères et limite les prénoms à 29 caractères, et les noms et noms de société à 35. Si un nom est plus long, veuillez le raccourcir.

❓ Pourquoi ne puis-je pas planifier un enlèvement par coursier ?

R : Votre contrat Colissimo doit inclure le service d'enlèvement par coursier. Si vous recevez une erreur « client inconnu », contactez Colissimo pour le faire activer.

❓ Comment corriger les autres erreurs Colissimo ?

R : Consultez notre guide sur les erreurs Colissimo les plus courantes.