Colissimo Retour France Et International

Solution Simplicité – Expédition
Offre Entreprises
Page Colissimo Retour Online
Colissimo Retour France et International
Document technique – Version novembre 2015

Guide d’intégration Page Retour Online
1
Simplicité - Page Retour Online - Novembre 2015
SOMMAIRE
1. INTRODUCTION................................................................................................................................ 4
1.1. Objectif de la solution Simplicité Retour Online .................................................... 4
1.2. Objectif du document ........................................................................................................... 4
1.3. Glossaire ...................................................................................................................................... 4
2. PARAMETRAGE DES FONCTIONNALITES DU RETOUR ONLINE ............................... 5
2.1. Généralités ................................................................................................................................. 5
2.2. Configuration des adresses de retour ......................................................................... 7
2.3. Configuration des options de retour ............................................................................ 8
2.3.1. Cobranding des pages et des e-mails ..................................................................... 8
2.3.2. Cobranding des bordereaux de transport (pour le Colissimo
Retour France)........................................................................................................................................ 8
2.3.3. Sélection d’un niveau d’assurance optionnelle par défaut........................... 9
2.3.4. Motifs de retour ................................................................................................................. 10
2.3.5. Informations Service clients ....................................................................................... 10
2.3.6. Notification par e-mail à l’expéditeur de la livraison de son
colis 10
2.3.7. Validation du paramétrage .......................................................................................... 11
2.4. Paramétrage de la page front office .......................................................................... 11
3. APPEL DES PAGES WEB COLISSIMO RETOUR .............................................................. 12
3.1. Généralités relatives aux échanges sur Internet................................................ 12
3.2. Préconisation de La Poste pour l’utilisation de ce service ............................. 13
3.3. Responsabilité liée aux échanges informatiques ................................................ 13
3.4. Paramètres à transmettre ............................................................................................... 14
3.4.1. Votre identifiant Retour Online ................................................................................. 17
3.4.2. Numéro de demande ...................................................................................................... 17
3.4.3. ParamPlus ............................................................................................................................. 17
3.4.4. Remarques relatives aux autres champs ............................................................ 17
3.4.5. Calcul de la signature ..................................................................................................... 18
3.4.6. Exemple de transmission des paramètres obligatoires ............................... 20
3.4.7. Exemple de transmission de l’ensemble des paramètres .......................... 21
3.5. GESTION DES ERREURS................................................................................................... 24
3.6. RETOUR SUR VOTRE SITE WEB ................................................................................... 26
3.6.1. Schéma récapitulatif ....................................................................................................... 28
4. CONTACT .......................................................................................................................................... 29
5. ANNEXES .......................................................................................................................................... 30
5.1. Annexe N° 1 ............................................................................................................................ 30
5.2. Annexe N° 2 ............................................................................................................................ 31
5.3. Annexe N° 3 ............................................................................................................................ 32
5.4. Annexe N° 4 ............................................................................................................................ 33
5.5. Annexe N°5.............................................................................................................................. 37
2
5.6. Annexe N° 6 ............................................................................................................................ 38
5.7. Annexe N° 8 ............................................................................................................................ 40
5.8. Annexe N° 9 ............................................................................................................................ 41
5.9. Annexe N° 10 ......................................................................................................................... 42
5.10. Annexe N° 11 ...................................................................................................................... 43
5.10.1. Bordereaux départ France ....................................................................................... 43
5.10.2. Bordereaux départ International .......................................................................... 46
5.11. Annexe N° 12 ...................................................................................................................... 47
3
1. INTRODUCTION
1.1. Objectif de la solution Simplicité Retour Online
Directement accessible depuis votre site web, cette solution permet à vos
clients et partenaires d’imprimer eux-mêmes leur bordereau de transport
Colissimo Retour France et/ou Colissimo Retour International.
1.2. Objectif du document
Ce document décrit les différentes opérations à réalisé pour accéder aux

fonctionnalités de cette solution.
La solution comprend 2 modules :
• Le Back Office (BO) : appelé́ « Configurez vos solutions d’affranchissement
– Colissimo Retour »,
il est accessible sur http://www.laposte.fr/colissimo-entreprise.
Il vous permet d’administrer les fonctionnalités de l’offre Colissimo Retour
Online.
• Le Front office (FO) : appelé́ « pages web Retour Online », il s’agit des
pages web La Poste sur lesquelles vous redirigez votre client pour qu’il génère
lui-même le bordereau de transport.
1.3. Glossaire
DEFINITION
Adresse L’adresse Destinataire est l’adresse de livraison à laquelle
Destinataire vous souhaitez que vos clients/partenaires vous retournent
les marchandises.
Expéditeur L’expéditeur est le client/partenaire qui vous adresse des
colis « retours »
Bordereau de Le bordereau de transport est composé de 2 volets :
transport -Le volet de gauche, qui contient les codes à barres (CAB),
devra être collé sur le colis,
-le volet de droite constitue la preuve de dépôt et devra
être conservée par l’expéditeur.
Caractère Le terme caractère alphanumérique désigne dans ce
alphanumériqu document : • les caractères numériques et alphabétiques :
e • les caractères alphabétiques (minuscules et majuscules),
• les caractères accentués minuscules et ‘ç’
ainsi que les caractères espace, ‘-’,’_’ sauf autre mention
explicite
SHA1 Fonction de hachage cryptographique. Permet la
sécurisation de l’appel des pages web Colissimo Retour
Online
CAB Code à barres
Identifiant Il s’agit de l’identifiant qui est affiché dans la rubrique «
Retour Online Paramétrage de la page Front office » de votre Espace
4
Client Colissimo Retour
Demande Prise de rendez-vous avec La Poste pour la récupération du
d’emport
colis par le facteur depuis la boîte aux lettres.
2. PARAMETRAGE DES FONCTIONNALITES DU

RETOUR ONLINE
2.1. Généralités
Le paramétrage des fonctionnalités de la solution Retour Online s’effectue au

niveau de votre Espace Client Colissimo Retour, accessible sur
colissimo.fr/entreprises.
Préalable : Seuls les clients qui ont souscrit à la solution Simplicité Retour
Online peuvent accéder à ces fonctionnalités.
Pour permettre, ou personnaliser l’utilisation de Colissimo Retour
Online, vous devez réaliser les opérations suivantes :
OPÉRATIONS À
RÉALISER DANS LE
BACK-OFFICE «
OBLIGATOIRE ECRAN CORRESPONDANT
ESPACE CLIENT
COLISSIMO
RETOUR»
1/ Saisir au moins Oui, une adresse minimum. Configuration des adresses de
une adresse retour retour
2/ Choisir un logo Non. Configuration des options de
pour les pages Web retour
Colissimo Retour
Online
3/ Choisir une image Non. Configuration des options de
pour les bordereaux retour
de transport
4/ Sélectionner le Facultatif (peut également Configuration des options de
niveau d’assurance être transmis dans l’URL – retour
voir règles).
5/ Définir les motifs Liste facultative Configuration des options de
de retour Possibilité d’activer retour
également une saisie libre
Peut également être
transmis dans l’url.
6/ Saisir les Facultatif (sinon affichage Configuration des options de
informations en bas de page). retour
relatives à votre
Service Clients
5
7/ Activer la Facultatif. Configuration des options de
notification par e- retour
mail à votre
expéditeur de la
réception de son
colis
8/ Définir la clé SHA Oui, 5 à 12 caractères. Paramétrage de la page Front
Office
9/ Définir les urls de Oui, les 2 adresses peuvent Paramétrage de la page Front
retour sur votre site être identiques. Office
web
9/ Définir les urls de Oui, les 2 adresses peuvent Paramétrage de la page Front
retour sur votre site être identiques. Office
web
NOUVEAU : A partir de mai 2015, les colis Colissimo Retour France peuvent
être déposés en Bureau de Poste ou Relais Pickup, mais également depuis la
boite aux lettres personnelle du ré-expéditeur, si l’adresse du client expéditeur
est éligible au service.
Le ré-expéditeur peut faire sa demande d’emport en boite aux lettres depuis le

site de La Poste www.colissimo.fr, à l'aide du numéro de colis indiqué sur
l'étiquette Colissimo Retour. La date et heure de dépôt du colis lui sera
indiquée sur le site, ainsi que les conditions d’utilisation du service (boîte aux
lettres accessible et pouvant contenir le colis, éligibilité de l’adresse etc…).
Pour plus d’informations, aller sur https://www.colissimo.fr/retourbal, rubrique
« En savoir plus sur le Colissimo Retour».
Le facteur récupère le colis dans la boîte aux lettres à la date convenue. Il y

laisse un avis de prise en charge. Ce document confirme que le Colissimo
Retour a bien été récupéré ou, le cas échéant, précise la raison pour laquelle le
colis n'a pas pu être emporté.
6
2.2. Configuration des adresses de retour
Il s’agit de la liste des adresses de destination possibles pour le colis. Ces

données doivent être renseignées dans la rubrique « Vos adresses Retour » de
votre Espace Client Colissimo Retour. La saisie d’au moins une adresse de
retour est indispensable et le nombre maximum d’adresses possibles est de
100.
Chaque adresse est identifiée par un nom d’adresse. Cette information devra
être transmise aux pages web du Retour Online lors d’une demande de
bordereau.
Chaque adresse est constituée des champs suivants :

NOM TYPE OBLIGATOIRE
Nom de 15 caractères alphanumériques Oui
l’adresse : sert Les caractères espaces sont interdits
d’identifiant lors (séparer les mots par ‘-‘ ou ‘_’)
de la sélection
d’une adresse
Raison sociale 35 caractères alphanumériques Oui
Service 35 caractères alphanumériques Non
Civilité Liste déroulante Mr/Mme/Mlle. Non
Nom 20 caractères alphanumériques Non
Prénom 15 caractères alphanumériques Non

Adresse : 4 ligne 35 caractères alphanumériques 1ère ligne obligatoire
au total
Code Postal 5 caractères alphanumériques Oui
Ville Liste déroulante non modifiable reprenant Oui
l’ensemble des communes correspondant
au CP saisi
Pays 35 caractères – Liste déroulante : valeur Oui
par défaut « France »
Téléphone 15 caractères numériques Non
7
2.3. Configuration des options de retour
Le paramétrage décrit dans ce chapitre correspond à la

rubrique  «Configuration des options de retour» de votre Espace Client
Colissimo Retour. Cette étape n’est pas indispensable au fonctionnement des
pages web Retour Online.
2.3.1.Cobranding des pages et des e-mails
Vous pouvez, dans ce module, sélectionner le logo que vous souhaitez

afficher en cobranding avec celui du groupe La Poste sur :
Les pages web Colissimo Retour Online
les e-mails de confirmation envoyés par La Poste à vos expéditeurs.
Précision concernant les e-mails :
2 e-mails sont envoyés à vos clients/partenaires :
- un e-mail leur permettant d’accéder, en ligne, à leur bordereau de transport
« retour », qui peut donc être cobrandé avec votre logo.
- un e-mail de confirmation de livraison de leur colis (si l’option correspondante
est activée) (voir section 2.3.6 « Notification par e-mail »), qui peut être
cobrandé avec votre logo uniquement dans le cas du Colissimo Retour
France.
Les contraintes sur ce logo sont les suivantes :

format gif ou jpeg
une taille de 40 ko maximum
une résolution maximale de 200 pour la largeur et 60 pour la hauteur (cette
contrainte est contrôlée lors du chargement du logo dans la rubrique
«Configuration des options de retour»).
Il n’est pas nécessaire de conserver le même ratio largeur/hauteur et il n’y a

pas de contraintes sur le nombre de couleurs. Le logo sera centré sur la
partie droite de la bande orange supérieure.
Des vérifications seront effectuées concernant la taille du fichier et la

résolution de l’image lors de son chargement et seuls les fichiers respectant
les règles définies seront acceptés. Après sélection d’un nouveau logo, les
boutons de prévisualisation permettent d’afficher les pages web et e-mail
incluant ce nouveau logo.
2.3.2.Cobranding des bordereaux de transport (pour le Colissimo

Retour France)
8
Vous pouvez sélectionner l’image que vous souhaitez intégrer sur la partie
preuve de dépôt du bordereau de transport généré. Les contraintes sont alors
les suivantes :
format gif ou jpeg
une taille de 100 ko maximum
une résolution maximale de 700 pour la largeur et 360 pour la hauteur :
attention, cette résolution sera réduite d’un facteur 2 lors de la génération du
PDF (la contrainte concernant la résolution 700 par 360 est contrôlée lors du
chargement du logo dans la rubrique «Configuration des options de retour»).
Il n’est pas nécessaire de conserver le même ratio largeur/hauteur et il n’y a
pas de contraintes sur le nombre de couleurs.
Le logo sera centré sur la zone réservée dans la partie haute de la preuve de
dépôt. Après sélection d’une nouvelle image, le bouton de prévisualisation
permet d’afficher un bordereau spécimen.
2.3.3.Sélection d’un niveau d’assurance optionnelle par défaut
La rubrique «Configuration des options de retour» permet également de définir

un niveau d’assurance optionnelle par défaut.
Toutefois, vous pourrez transmettre un niveau d’assurance spécifique pour
chacun des envois lors de l’appel aux pages Web Retour OnLine.
Les règles suivantes s’appliquent alors :
UN NIVEAU UN NIVEAU
D’ASSURANCE A ETE D’ASSURANCE A ETE
DEFINI DANS LA TRANSMIS DANS
RUBRIQUE L’URL LORS DE REGLES
« Configuration des L’APPEL DES PAGES
options de retour» DE WEB COLISSIMO
VOTRE ESPACE CLIENT RETOUR
COLISSIMO RETOUR
Le niveau d’assurance
Oui transmis dans l’url
s’applique.
Oui
défini dans la rubrique
Non « Configuration des
options de retour»
s’applique.
Oui transmis dans l’url
Non s’applique.
Pas de niveau
Non
d’assurance optionnelle
9
2.3.4.Motifs de retour
La rubrique «Configuration des options de retour» permet de définir une liste

de 5 motifs de retour maximum. Cette liste apparaîtra dans les pages web
Colissimo Retour sous la forme d’une liste déroulante et votre client pourra
alors sélectionner le motif adapté à son envoi.
Il est également possible dans la rubrique «Configuration des options de
retour» d’autoriser la saisie libre d’un motif.
Le motif peut également être transmis en paramètre lors de l’appel des pages
web Retour Online. Un motif est constitué d’un maximum de 35 caractères
alphanumériques.(voir section 3.4 « Paramètres à transmettre »).
A noter :
Pour transmettre dans l’url un motif différent de ceux définis dans la rubrique
«Configuration des options de retour», il faut que le champ « Autre motif » soit
sélectionné (case « Oui » cochée).
2.3.5.Informations Service clients
Il est également possible de saisir des informations concernant votre Service

clients. Ces informations seront affichées au bas des pages web Retour Online.
Il s’agit de :
DEFINITION TYPE
Raison sociale ou nom 35 caractères alphanumériques maximum
de service du Service
client
Téléphone 15 caractères alphanumériques
Commentaire sur le 200 caractères alphanumériques maximum
coût : de l’appel au
Service clients –
exemple : 30
cts/minute
Ces informations apparaîtront sous cette forme:

Raison sociale 0123456789 (30 cts/min)
2.3.6.Notification par e-mail à l’expéditeur de la livraison de son

colis
Par défaut, l’expéditeur ne reçoit pas de notification lors de la livraison de son

colis. Cette notification peut être activée par l’option correspondante présente
au bas de la rubrique «Configuration des options de retour ».
La notification correspondant à un Colissimo Retour France est en français.
10
La notification correspondant à un Colissimo Retour International peut être en
français mais également possibles dans plusieurs autres langues (voir section
3.4 « Paramètres à transmettre »).
2.3.7.Validation du paramétrage
La modification éventuelle du paramétrage défini dans la rubrique  «

Configuration des options de retour » sera prise en compte dès la
validation de cette page.
Les demandes de bordereaux faites après modification de ce
paramétrage utiliseront aussitôt ce nouveau paramétrage.
Dans le cas particulier du logo des pages web Retour Online, celui-ci
étant géré par un mécanisme de cache, la prise en compte d’un
nouveau logo peut demander jusqu’à une heure.
Lors de la modification éventuelle des logos il faudra donc faire toutes
les vérifications nécessaires à l’aide des fonctionnalités de
prévisualisation intégrées à la rubrique «Configuration des options de
retour » avant de valider celle-ci.
2.4. Paramétrage de la page front office
Les différents champs de la rubrique «Paramétrage de la page Front

office » de votre Espace Client Colissimo Retour doivent être renseignés
pour permettre le fonctionnement des pages web Retour Online. Il s’agit
de :
DEFINITION TYPE OBLIGATOIR COMMENTAIRE

E
Clé SHA 5 à 12 OUI Clé utilisée pour le calcul
caractères de la signature SHA
alphanumériques
URL de retour 256 caractères OUI
sur votre site respectant le
web après format URL
génération
du bordereau
de transport
URL de retour 256 caractères OUI
sur votre site respectant le
web après format URL
échec de la
génération
du bordereau
de transport
11
Ces 2 URL peuvent cependant être identiques.
D’autre part dans la rubrique « Paramétrage de la page Front office » est
affiché votre identifiant client qui devra être transmis lors de l’appel des pages
web Colissimo Retour Online. Cet identifiant ne peut être modifié.
3. APPEL DES PAGES WEB COLISSIMO RETOUR
Les pages web Retour Online sont les pages web La Poste sur lesquelles vous
redirigez votre client pour qu’il génère lui-même le bordereau de transport.
Votre site web doit transmettre des données du type :
identifiant Retour Online
nom de l’adresse de destination du colis
éventuellement des données propres à l’envoi (assurance, colis
volumineux etc)
éventuellement des données qui pré-initialiseront les données à remplir
par l’expéditeur du colis
Les pages contrôlent l’identifiant et les données transmises.
Si ceux-ci sont corrects, l’expéditeur peut alors saisir et valider les données
concernant son envoi et peut générer son bordereau de transport. A la suite
de ces opérations, et selon la réussite ou l’échec de la création de bordereau,
le client peut être redirigé sur une page spécifique (2 URL possibles) de votre
site web. Par ailleurs en cas d’échec, un code d’erreur est retourné à votre site
web.
3.1. Généralités relatives aux échanges sur Internet
HTTP, pour HyperText Transfer Protocol, est un protocole de communication

client-serveur développé pour le World Wide Web.
Lorsqu’elles sont transmises par le protocole HTTP, les données circulent sur
internet, en clair (sans être chiffrées). Références complémentaires :
http://fr.wikipedia.org/wiki/Hypertext_Transfer_Protocol
HTTPS, pour HyperText Transfer Protocol Secure — littéralement « protocole

de transfert hypertexte sécurisé » — , est la combinaison du protocole HTTP
avec une couche de chiffrement comme SSL ou TLS.
Il garantit théoriquement la confidentialité et l'intégrité des données envoyées
par l'utilisateur et reçues du serveur.
Références complémentaires :
http://fr.wikipedia.org/wiki/HyperText_Transfer_Protocol_Secure
Le protocole utilisé est HTTPS et les méthodes POST et GET peuvent être
utilisées.
L’utilisation de POST est tout de même fortement conseillée.
12
3.2. Préconisation de La Poste pour l’utilisation de ce service
L’accès aux pages web Retour Online étant protégé par un identifiant, un mot
de passe ou une signature données à caractère sensible, La Poste préconise
d’utiliser le protocole HTTPS pour le transport de ces données.
Ne pas utiliser ce protocole expose le Client à l’interception par un tiers
malveillant, de ses identifiants, ce qui permettrait à ce dernier d’usurper
l’identité du Client, et ainsi :
- d’accéder à son espace entreprise (facture online, suivi des colis).
- de commander des produits, qui seront ensuite facturés au compte client
usurpé.
- d’accéder aux autres solutions mises à disposition par La Poste.
3.3. Responsabilité liée aux échanges informatiques
Le Client s'engage à prendre toutes mesures propres à assurer la sécurité et la

confidentialité de son identifiant et de son mot de passe.
Tout accès et transmission de données effectuées et plus largement toute

opération effectuée en utilisant l’identifiant et le mot de passe du Client sont
réputées effectués par ce dernier.
13
3.4. Paramètres à transmettre
Les paramètres suivants peuvent ou doivent être transmis aux pages web
Colissimo Retour Online.
MODIFIA
BLE
CHAMP A OBLI NOM DU DANS
TRANSMETTRE POUR GATO PARAMETR LES VALEUR
L’APPEL DE PAGES IRE E PAGES POSSIBLE
WEB RETOUR ONLINE WEB
RETOUR
ONLINE
Identifiant Retour OUI orosld N’apparaît Jusqu’à 35
OnLine pas Carac
majuscules
alphabétiques
ou chiffres
Adresse Professional NON crFlagProfess OUI True/false
Expédite ional
ur Raison NON crCompanyN OUI 50 Carac
Sociale ame alphanumériqu
es
Siret NON crSiret OUI 14 Carac
alphanumériq
ues
Civilité NON crCivility OUI mr/mme/mle
Nom NON crName OUI 35 Carac
alphanumériq
ues
Prénom NON cfFirstName OUI 35 Carac
alphanumériq
ues
Adresse NON crAdress1 OUI 50 Carac
ligne 1 alphanumériq
ues
Adresse NON cfAdress2 OUI 35 Carac
ues
ues
ues
CountryCode NON crCountryCo OUI 2 Carac
ISO de alphabétiques
14
- Pour le
Colissimo
Retour France,
countryCode
est
obligatoirement
à « FR ».
- Pour le
Colissimo
Retour
International,
countryCode
est différent de
FR.
Actuellement
DE, GB, LU, NL,
BE, IE, SK, SI,
FI.
Langue NON codelangue OUI 2 caractères
d’affichage alphabétiques
Par défaut, FR.
Les langues
possibles pour
un Colissimo
Retour
International
sont : EN
(anglais), DE
(allemand), NL
(néerlandais),
ES (espagnol)
et IT (italien).
City NON crTown OUI 35 Carac
alphanumériq
ues
PostalCode NON crZipCode OUI 5 Carac
alphanumériqu
es pour la
France et
jusqu’à 9 pour
l’international
PhoneNumb NON crTel OUI 15 Carac
er alphanumériq
ues
Mail NON crEmail OUI 200 Carac
conformes
email
Adresse Nom OUI destinationN N’apparaît 15 Carac
15
Destinat adresse ame pas alphanumériq
aire ues
Colis Niveau NON insuranceRa N’apparaît Entier de 0 à
d’assurance nge pas 10
Hors Gabarit NON flagBulky Non true/false
éditable si
transmis
dans l’url
Motif du NON returnMotive Non 35 Carac
retour éditable si alphanumériq
transmis ues
dans l’url
Données N° client NON trClientNumb Non 30 Carac
Spécifiq er éditable si alphanumériq
ues transmis ues
Client dans l’url
Ref produit NON trProductRef Non 30 Carac
éditable si alphanumériq
transmis ues
dans l’url
N° NON trOrderNumb Non 30 Carac
commande er éditable si alphanumériq
transmis ues
dans l’url
Référence NON trReturnRef Non 15 Carac
de Retour éditable si alphanumériq
transmis ues
dans l’url
Paramètre à NON trParamPlus Non 256 Carac
retourner à éditable si alphanumériq
votre site transmis ues
web dans l’url
Contrôle Numéro de OUI orderld N’apparaît 25 Carac
Demand demande pas alphanumériq
e ues
Signature OUI signature N’apparaît 40 caractères
SHA pas hexadecimal
Déterminée par
calcul
Convention concernant le nom de certains paramètres :

le préfixe cr désigne les données expéditeur (consignor)
le préfixe tr désigne vos données spécifiques (trader).
Si la longueur d’un paramètre est supérieure à la longueur autorisée définie

dans le tableau ci-dessus, la fin de la chaîne de caractères sera tronquée de
façon à respecter cette condition.
16
En ce qui concerne les paramètres booléen, toute autre valeur que «true» ou «
TRUE » est considérée comme équivalente à FALSE.
3.4.1.Votre identifiant Retour Online
Il s’agit de l’identifiant qui est affiché dans la rubrique «Paramétrage de la

page Front office » de votre Espace Client Colissimo Retour.
(voir section 2.4 «Paramétrage de la page Front Office »)
3.4.2.Numéro de demande
Chaque demande de bordereau doit être accompagnée d’un numéro de

demande qui lui est propre (pour un e-marchand donné).
Lors de l’appel des pages web Retour Online, votre site web doit donc générer
un nouveau numéro de demande.
Il a toute liberté pour générer ce numéro de façon incrémentale ou autre (par

exemple à partir de la date et l’heure courante en milliseconde avec des
précautions d’usage garantissant l’unicité).
Les demandes de bordereaux qui contiennent un numéro de demande déjà

utilisé et ayant, à cette occasion, abouti à la génération d’un bordereau seront
rejetées (et cela même si l’expéditeur n’a pas utilisé ce bordereau).
3.4.3.ParamPlus
Ce paramètre permet à votre site web de transmettre aux pages web Retour
Online des données spécifiques à la demande de bordereau et que La Poste
n’interprétera pas.
Ces données seront retournées à votre site web, en fin de traitement de la
demande, lors du retour sur votre site web.
Ils doivent être de la forme : trParamplus=XXX

Avec XXX : chaîne alphanumérique de 256 caractères maximum
Ce paramètre sera retourné sous la même forme (voir section 3.6 «

Retour sur votre site web »).
3.4.4.Remarques relatives aux autres champs
1.1.1.1 Correspondance Code postal/Ville :

La correspondance entre le code postal et la ville sera vérifiée, pour la France
uniquement, mais ne génère pas d’erreur. Si cette vérification échoue, la ville
17
ne sera pas présélectionnée dans la liste déroulante correspondante de la 1ère
page web Colissimo Retour Online.
1.1.1.2 Niveau d’assurance optionnelle :

Le champ niveau d’assurance doit obligatoirement être un entier compris entre
0 et 10 soit :
INSURANCE RANGE NIVEAU D’ASSURANCE

OPTIONNELLE JUSQU'A (EN €)
00 0
01 150
02 300
03 450
04 600
05 750
06 900
07 1050
08 1200
09 1350
10 1500
1.1.1.3 Référence de retour :

Ce champ est une donnée qui vous est propre et n’est pas interprété par les
pages web Colissimo Retour.
Si votre site web le transmet lors de l’appel des pages web Retour Online, il
est affiché sans traitement sur le bordereau de transport sous forme texte et
également sous forme de code à barres vertical.
3.4.5.Calcul de la signature
Le but de la signature est de garantir que les données que vous transmettez
aux pages web Colissimo Retour ne subiront pas de modifications ultérieures.
En particulier, elle rend inutilisable la mémorisation de l’url d’appel dans un
navigateur. En effet, celle-ci serait inutilisable en l’état et la signature SHA
empêcherait sa modification.
D’autre part la signature, basée sur une clé SHA qui vous est propre
(voir section 2.4 «Paramétrage de la page Front office ») permet un contrôle
de l’accès aux pages web Retour Online.
Il s’agit d’appliquer l’algorithme SHA sur la concaténation des champs suivants
:
18
CHAMPS PRIS EN COMPTE POUR
NOM DU CHAMP
LA SIGNATURE
Identifiant Retour Online orosld
Adresse destinationName
Nom adresse
Destinataire
Niveau insuranceRange (si
d’assurance transmis)
Colis
flagBulky (si
Hors Gabarit
transmis)
trClientNumber (si
N° client
Données transmis)
Spécifiques Client Référence de trReturnRef (si
Retour transmis)
Numéro de trOrderNumber
Contrôle Demande
demande
La clé SHA doit être également concaténée à la fin de la chaîne :

Chaîne_à_convertir = orosId + destinationName + InsuranceRange +
flagBulky + trClientNumber + trReturnRef + trOrderNumber + clé SHA
Signature = SHA1 (Chaîne_à_convertir)
Certains des champs ci-dessus ne sont pas obligatoires. S’ils ne sont pas
transmis par votre site web, ils ne doivent pas être pris en compte dans le
calcul de la signature.
L’algorithme SHA-1 (Secure Hash Algorithm) est une fonction de hachage
cryptographique. Il produit une signature de 160 bits (40 caractères).
Il existe des implémentations dans les différents environnements. Vous  devez
donc faire appel à une librairie adaptée à la technologie que vous  utilisez. 
Une implémentation java est fournie en annexe.
19
3.4.6.Exemple de transmission des paramètres obligatoires
Ce code html statique permet, lorsqu’on a renseigné les champs spécifiés,

l’appel des pages web Retour Online avec les paramètres obligatoires
exclusivement.
<html>
<head>
<title>Appel de Retour Online Front Office</title>
</head>
<body>
<br/><br/><br/>
    En attente du site retour Online
<form name="formretouronlinecall"
action="http://www.colissimo.fr/retouronline/storeCall.do" method="post">
<input type="hidden" name="orosId" value="123456">

<input type="hidden" name="destinationName" value="SITE_VELIZY">
<input type="hidden" name="orderId" value="1000001">
<input type="hidden" name="signature"
value="5066041628908bed27ff54881de9210ec20aff1c">
</form>
<script>document.formretouronlinecall.submit();</script>
</body>
</html>
La signature a été calculée, conformément à la procédure ci-dessus avec le

contenu des champs orosId+ destinationName+orderID+cléSHA (dans cet
exemple la cléSHA utilisée est LAPOSTE), c’est-à-dire
«123456SITE_VELIZY1000001LAPOSTE»
20
Premier test à partir du navigateur Internet :
Après avoir remplacé les paramètres « hidden » par des paramètres valides, il
suffit d’ouvrir cette page html avec un navigateur Internet pour être
automatiquement redirigé vers les pages web Colissimo Retour avec
transmission de ces paramètres.
La 1ère page web Colissimo Retour qui permet la saisie des informations du
bordereau doit alors apparaître.
Remarque :
il existe de nombreux sites web qui offrent la possibilité de faire des calculs
cryptographique SHA-1 en ligne (recherche possible grâce aux mots clés :
sha-1 on line par exemple), ils peuvent être utiles dans le cadre de ce
premier test pour calculer la signature.
Les informations suivantes doivent avoir été préalablement définies dans

Votre Espace Client Colissimo Retour:
o adresse de retour « destinationName » (dans cet exemple, SITE_VELIZY),
o la clé SHA.
Le paramètre orosId doit obligatoirement avoir pour valeur le contenu du
champ Identifiant Retour Online affiché dans la rubrique «Paramétrage de la
page Front office » de votre Espace Client Colissimo Retour.
3.4.7.Exemple de transmission de l’ensemble des paramètres
Ce code html permet, lorsqu’on a renseigné les champs spécifiés, l’appel

des pages web Retour Online avec l’ensemble des paramètres autorisés,
pour un Colissimo Retour France.
La signature sera calculée, comme décrit ci-dessus à partir de la
concaténation des paramètres suivants:
orosId
destinationName
insuranceRange
flagBulky
trClientNumber
trReturnRef
orderId
C’est à dire dans l’exemple ci-dessous :
123456SITE_VELIZY2falseCL45678RET89545CMD78954
Pour ne pas passer un paramètre dans l’url, il faut supprimer entièrement la
ligne (ne pas transmettre ce paramètre avec une valeur vide).
Exemple du cas de non transmission du niveau d’assurance : Il faut
supprimer toute la ligne :
<input type="hidden" name="insuranceRange" value="2">
21
<html >
<head>
<title> Appel de Retour Online Front Office </title> </head>
<body><br/><br/><br/>
action=" https://www.colissimo.fr/retouronline/storeCall.do" method="post">
<input type="hidden" name="crName" value="Dubreuil">
<input type="hidden" name="crForename" value="Henri">
<input type="hidden" name="crFlagProfessional" value="true">
<input type="hidden" name="crCompanyName" value="AGFR International">
<input type="hidden" name="crSiret" value="38396013500739 ">
<input type="hidden" name="crCivility" value="Mr">
<input type="hidden" name="crAdress1" value="Escalier B">
<input type="hidden" name="crAdress2" value="Porte C">
<input type="hidden" name="crAdress3" value="5, rue des tilleuls">
<input type="hidden" name="crAdress4" value="hameau de Villeneuve"> <input
type="hidden" name="crCountryCode" value="fr">
<input type="hidden" name="crTown" value="Maurepas">
<input type="hidden" name="crZipCode" value="78310">
<input type="hidden" name="crTel" value="0132323232">
<input type="hidden" name="crEmail" value="hdubreuil@free.fr">
<input type="hidden" name="destinationName" value="SITE_VELIZY"> <input
type="hidden" name="insuranceRange" value="2">
<input type="hidden" name="flagBulky" value="false">
<input type="hidden" name="returnMotive" value="Erreurs livraison"> <input
type="hidden" name="trClientNumber" value="CL45678">
<input type="hidden" name="trProductRef" value="NIKON FTP78">
<input type="hidden" name="trOrderId" value="CMD78954">
<input type="hidden" name="trReturnRef" value="RET89545">
<input type="hidden" name="trAddParameter" value="ABC123456DE789'">
value="c64b9e00f3f7bf212983b6c5a463724af049190f">
</form>
</body>
</html>
22
Exemple dans le cas d’un Colissimo Retour International :
<html >
<head>
<title> Appel de Retour Online Front Office </title> </head>
<body><br/><br/><br/>
action=" https://www.colissimo.fr/retouronline/storeCall.do" method="post">
<input type="hidden" name="crName" value="GRUBER">
<input type="hidden" name="crForename" value="Friedrich">
<input type="hidden" name="crFlagProfessional" value="true">
<input type="hidden" name="crCompanyName" value="AGFR International">
<input type="hidden" name="crSiret" value="38396013500739 ">
<input type="hidden" name="crCivility" value="Mr">
<input type="hidden" name="crAdress1" value="Esc B">
<input type="hidden" name="crAdress2" value="C">
<input type="hidden" name="crAdress3" value="5, Strasse tilleuls">
<input type="hidden" name="crAdress4" value="hameau">
<input type="hidden" name="crCountryCode" value="DE">
<input type="hidden" name="codeLangue" value="DE">
<input type="hidden" name="crTown" value="BERLIN">
<input type="hidden" name="crZipCode" value="10871">
<input type="hidden" name="crTel" value="0132323232">
<input type="hidden" name="crEmail" value="friedrich.gruber@freenet.de">
<input type="hidden" name="destinationName" value="SITE_VELIZY"> <input
type="hidden" name="insuranceRange" value="2">
<input type="hidden" name="flagBulky" value="false">
<input type="hidden" name="returnMotive" value="Erreurs livraison"> <input
type="hidden" name="trClientNumber" value="CL45678">
<input type="hidden" name="trProductRef" value="NIKON FTP78">
<input type="hidden" name="trOrderId" value="CMD78954">
<input type="hidden" name="trReturnRef" value="RET89545">
<input type="hidden" name="trAddParameter" value="ABC123456DE789'">
value="c64b9e00f3f7bf212983b6c5a463724af049190f">
</form>
</body>
</html>
23
3.5. GESTION DES ERREURS
Les erreurs susceptibles d’être déclenchées lors de l’appel des pages web
Colissimo Retour sont référencées par un code.
Un message reprenant ce code sera affiché sur les pages web Retour Online.
Le tableau ci-dessous liste l’ensemble des cas possibles :
CODE
D’ERREU SIGNIFICATION VERIFICATIONS / ACTION
R
L’identifiant client Le paramètre orosId est obligatoire et
10 « orosld » n’a pas été doit donc être transmis aux pages web
transmis (*) Retour Online
Vérifier que l’identifiant orosId
L’identifiant client « orosId transmis est celui qui apparaît dans la
» transmis n’existe pas rubrique «Paramétrage de la page
11
dans la base de données Front office » de votre Espace Client
(*) Colissimo Retour. Si c’est le cas,
contactez La Poste- Pôle Colis.
Il s’agit dans ce cas d’un problème
Impossible d’accéder aux
d’accès à la base de données. Attendre
12 données correspondant à
quelques instants puis renouveler
ce code client (*)
l’appel ou contactez Colissimo
Dans ce cas, l’Espace Colissimo Retour
Vous n’avez pas (ou n’avez
est également inaccessible dans
plus) les droits d’accès aux
13 l’espace client. Pour réactiver les
fonctionnalités Colissimo
fonctionnalités Colissimo Retour,
Retour.
contactez La Poste- Pôle Colis
Le nom de l’adresse Le paramètre destinationName est
14 destinataire n’a pas été obligatoire et doit donc être transmis
transmis aux pages web Colissimo Retour
Le paramètre destinationName doit
Le nom de l’adresse
correspondre à un nom d’adresse
destinataire transmis
15 renseigné dans la rubrique « Vos
n’existe pas dans la base
adresses Retour » de votre Espace
de données
Client Colissimo Retour.
Le numéro de demande Le paramètre orderId est obligatoire et
16 (orderId) n’a pas été doit donc être transmis aux pages web
transmis Colissimo Retour Online
La transmission d’un orderId qui a déjà
été utilisé pour la génération d’un
L’étiquette correspondant
précédent bordereau est interdite.
à ce numéro de demande
17 S’assurer que l’algorithme de
(orderId) a déjà été
génération de l’orderID ne peut créer
générée pour ce client
le même identifiant pour des appels
distincts puis transmettre un nouveau
24
orderId.
Le paramètre signature est obligatoire
La signature SHA n’a pas
18 et doit donc être transmis aux pages
été transmise.
web Retour Online
Dans la rubrique «Paramétrage de la
La clé SHA n’a pas été
page Front office » de votre Espace
renseignée dans la
Client Colissimo Retour, saisir le champ
rubrique «Paramétrage de
19 « clé SHA » et valider la page.
la page Front  office » de
L’appel des pages web Retour Online
votre Espace Client
peut être maintenant réalisé avec une
Colissimo Retour.
signature calculée via cette clé.
Vérifiez que la signature est bien
La signature SHA est calculée selon la règle définie au
20
incorrecte paragraphe « Calcul de signature »
(section 3.4.5)
Le niveau d’assurance Assurez-vous que le paramètre
21 transmis n’a pas pu être insuranceRange est bien un entier
interprété compris entre 0 et 10.
Il s’agit d’un problème technique,
Echec lors de la génération attendre quelques instants puis
30
du bordereau renouveler l’opération sinon contacter
la hotline La Poste- Pôle Colis
(*) Le code d’erreur ne pourra vous être retourné du fait de la non identification
25
3.6. RETOUR SUR VOTRE SITE WEB
Le schéma ci-après représente les différentes séquences possibles.

La génération du bordereau de transport s’effectue en 3 étapes :
Etape 1 : l’expéditeur complète les données transmises
Etape 2 : l’expéditeur confirme l’ensemble des données
Etape 3 : Affichage de la page « Votre demande a réussi » 
o Le bordereau est prêt à être imprimé,
o un mail faisant référence à ce bordereau a été envoyé à l’expéditeur,
o un bouton permet de revenir sur votre site web.  
Le retour sur votre site web se fait sur l’une des 2 adresses précisées dans la
rubrique «Paramétrage de la page Front office » de votre Espace Client
Colissimo Retour en fonction du succès ou de l’échec de la génération du
bordereau de transport.  
L’url de retour est constituée par la concaténation des différents champs
suivants :  
Si la génération du bordereau de transport a été réalisée avec succès :
CONTENU DE L’URL DE EXEMPLE

RETOUR
url succès renseignée http://www.emarchand.fr/OROSReturn1
dans  la rubrique
«Paramétrage de la page
Front office » de votre
Espace Client Colissimo
Retour
Numéro du colis ? parcelNumber=XXX
Le contenu de ParamPlus s’il &trParamPlus =ABC123456DEF789
a été transmis par votre site
web
Dans cet exemple l’url de retour sera :
http://www.emarchand.fr/OROSReturn1?parcelNumber=XXX&trParamPlus=ABC
12345DEF789
Si la génération du bordereau de transport a échoué :
CONTENU DE L’URL DE EXEMPLE

RETOUR
url échec renseignée http://www.emarchand.fr/OROSReturn2
dans  la rubrique
«Paramétrage de la page
Front office » de votre
Espace Client Colissimo
26
Retour
Code erreur OROS ? ErrorCoderOROS=XXX
Le contenu de ParamPlus s’il &trParamPlus =ABC123456DEF789
a été transmis par votre site
web
Dans cet exemple l’url de retour sera :
http://www.emarchand.fr/OROSReturn2?ErrorCoderOROS=XXX&trParamPlus=A
BC12345DEF789
27
3.6.1.Schéma récapitulatif
28
4. CONTACT
La Poste - Colissimo met à votre disposition un support, que nous vous

invitons à contacter dans les cas suivants :
Pour toute question technique relative à la

solution décrite dans ce document :
• Le Support Solutions Client,
au 0241.742.088 (appel non surtaxé),
Etude préalable
du lundi au vendredi, de 9h à 18h, hors
&
jours fériés.
Déploiement de la solution
Pour confirmer la solution retenue :
• Votre interlocuteur commercial La Poste –
Colissimo
En cas de panne, d’anomalie ou d’incident :

• Le Centre de Service,
au 0825.086.005 (0,15 €/min),
du lundi au vendredi, de 8h à 18h, hors
Phase opérationnelle, jours fériés.
Prononcer « Incident »,
après déploiement de la puis « Retour online »,
solution à l’énoncé des choix disponibles.
La disponibilité et le bon fonctionnement de nos

systèmes sont supervisés, même en dehors de
ces heures.
29
5. ANNEXES
5.1. Annexe N° 1
Accueil Espace client Colissimo Retour :
30
5.2. Annexe N° 2
Espace client Colissimo Retour : suivi des colis en retour
31
5.3. Annexe N° 3
Espace client Colissimo Retour

Configuration des adresses de retour
32
5.4. Annexe N° 4

Configuration des options de retour:
33
34
35
36
5.5. Annexe N°5

Configuration des options de retour
Exemple de la première page web Colissimo Retour :
37
5.6. Annexe N° 6

Exemples d’e-mail d’accès au bordereau de transport :
Version anglaise :
38
Exemples d’e-mail de confirmation de livraison :
Version anglaise :
39
5.7. Annexe N° 8

Sélection d’un niveau d’assurance optionnelle :
40
5.8. Annexe N° 9

Configuration des pages Front Office :
41
5.9. Annexe N° 10
Calcul de signature SHA en java :
import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;
import org.apache.commons.codec.binary.Hex;
/* Chiffre en SHA une chaine fournie en parametre puis effectue une
conversion en hexadécimal.
* Retourne <code>null</code> en cas d'exception.
* @param stringToDigestAndConvert La chaine a traiter
* @param algorithm L'algorithme a utiliser
* @return La chaine chiffree et convertie en hexa.
*/
private String digestAndConvertToHexString(String stringToDigestAndConvert)
{
String ALGORITHM = "SHA-1";
// Encodage
try {
MessageDigest md = MessageDigest.getInstance(ALGORITHM);
md.update(stringToDigestAndConvert.getBytes());
// Conversion en hexa avec Apache Commons Codec
return String.valueOf(Hex.encodeHex(md.digest()));
} catch (NoSuchAlgorithmException nsae) {
return null;
}
}
• Le calcul de la signature SHA est réalisé par une classe interne au jdk
<(version >=1.4.2)
• la librairie qui réalise la conversion en hexadécimal est :
commons-codec 1.3 (http://commons.apache.org/codec/)
42
5.10. Annexe N° 11
Exemples de bordereaux de transport
5.10.1.Bordereaux départ France
Exemple de bordereaux de transport avec et sans image
Modèle 1- Si l’adresse de l’expéditeur ne lui permet pas d’expédier le colis

depuis sa boite aux lettres personnelle :
43
Modèle 2- Si l’adresse de l’expéditeur lui permet d’expédier le colis depuis sa
boite aux lettres personnelle :
44
45
5.10.2.Bordereaux départ International
Exemple d’e-mail de bordereaux de transport avec et sans image – départ

International :
46
5.11. Annexe N° 12
Exemple : Message d’erreur
47

Colissimo Retour France Et International

Transféré par

Informations du document

Copyright

Formats disponibles

Partager ce document

Partager ou intégrer le document

Options de partage

Avez-vous trouvé ce document utile ?

Ce contenu est-il inapproprié ?

Droits d'auteur :

Formats disponibles

Colissimo Retour France Et International

Transféré par

Droits d'auteur :

Formats disponibles

Solution Simplicité – Expédition

Page Colissimo Retour Online

Colissimo Retour France et International

Document technique – Version novembre 2015

1.2. Objectif du document

Ce document décrit les différentes opérations à réalisé pour accéder aux

2. PARAMETRAGE DES FONCTIONNALITES DU

Le paramétrage des fonctionnalités de la solution Retour Online s’effectue au

Le ré-expéditeur peut faire sa demande d’emport en boite aux lettres depuis le

Le facteur récupère le colis dans la boîte aux lettres à la date convenue. Il y

Il s’agit de la liste des adresses de destination possibles pour le colis. Ces

Chaque adresse est constituée des champs suivants :

Prénom 15 caractères alphanumériques Non

Le paramétrage décrit dans ce chapitre correspond à la

2.3.1.Cobranding des pages et des e-mails

Vous pouvez, dans ce module, sélectionner le logo que vous souhaitez

Les contraintes sur ce logo sont les suivantes :

Il n’est pas nécessaire de conserver le même ratio largeur/hauteur et il n’y a

Des vérifications seront effectuées concernant la taille du fichier et la

2.3.2.Cobranding des bordereaux de transport (pour le Colissimo

2.3.3.Sélection d’un niveau d’assurance optionnelle par défaut

La rubrique «Configuration des options de retour» permet également de définir

Les règles suivantes s’appliquent alors :

La rubrique «Configuration des options de retour» permet de définir une liste

2.3.5.Informations Service clients

Il est également possible de saisir des informations concernant votre Service

Ces informations apparaîtront sous cette forme:

2.3.6.Notification par e-mail à l’expéditeur de la livraison de son

Par défaut, l’expéditeur ne reçoit pas de notification lors de la livraison de son

La modification éventuelle du paramétrage défini dans la rubrique «

2.4. Paramétrage de la page front office

Les différents champs de la rubrique «Paramétrage de la page Front

DEFINITION TYPE OBLIGATOIR COMMENTAIRE

3. APPEL DES PAGES WEB COLISSIMO RETOUR

Les pages contrôlent l’identifiant et les données transmises.

3.1. Généralités relatives aux échanges sur Internet

HTTP, pour HyperText Transfer Protocol, est un protocole de communication

HTTPS, pour HyperText Transfer Protocol Secure — littéralement « protocole

Le Client s'engage à prendre toutes mesures propres à assurer la sécurité et la

Tout accès et transmission de données effectuées et plus largement toute

Convention concernant le nom de certains paramètres :

Si la longueur d’un paramètre est supérieure à la longueur autorisée définie

3.4.1.Votre identifiant Retour Online

Il s’agit de l’identifiant qui est affiché dans la rubrique «Paramétrage de la

Chaque demande de bordereau doit être accompagnée d’un numéro de

Il a toute liberté pour générer ce numéro de façon incrémentale ou autre (par

Les demandes de bordereaux qui contiennent un numéro de demande déjà

Ils doivent être de la forme : trParamplus=XXX

Ce paramètre sera retourné sous la même forme (voir section 3.6 «

3.4.4.Remarques relatives aux autres champs

1.1.1.1 Correspondance Code postal/Ville :

1.1.1.2 Niveau d’assurance optionnelle :

INSURANCE RANGE NIVEAU D’ASSURANCE

1.1.1.3 Référence de retour :

La clé SHA doit être également concaténée à la fin de la chaîne :

Ce code html statique permet, lorsqu’on a renseigné les champs spécifiés,

<input type="hidden" name="orosId" value="123456">

La signature a été calculée, conformément à la procédure ci-dessus avec le

Les informations suivantes doivent avoir été préalablement définies dans

3.4.7.Exemple de transmission de l’ensemble des paramètres

Ce code html permet, lorsqu’on a renseigné les champs spécifiés, l’appel

Le schéma ci-après représente les différentes séquences possibles.

CONTENU DE L’URL DE EXEMPLE

Si la génération du bordereau de transport a échoué :

La modification éventuelle du paramétrage défini dans la rubrique  «