NOTE INTERNE - Colissimo

Transcription

Solution Flexibilité - Expédition
Offre Entreprises
Web Service d’Affranchissement
Colissimo
Document Technique - Version Avril 2016
Spécifications du Web Service d’Affranchissement Colissimo
Flexibilité - Webservice d’Affranchissement - Avril 2016
I.
Introduction ......................................................................................................... 4
I.1
Objet du document ............................................................................................ 4
I.2
Pré-requis techniques......................................................................................... 4
I.3
Codification des formats ..................................................................................... 5
I.4
Codification des Conditions.................................................................................. 5
I.5
Gestion des caractères accentués ......................................................................... 5
II.
Le Web Service SLS ............................................................................................... 6
II.1
Url d’accès ....................................................................................................... 6
II.2
Sécurité : préconisation du protocole HTTPS .......................................................... 7
II.3 Format et traitement de la réponse du web service.................................................. 8
II.3.1
Evolutivité du Web Service......................................................................... 9
II.3.2
Particularité pour les étiquettes ZPL ............................................................. 9
II.4 Méthode generateLabel ...................................................................................... 9
II.4.1
Informations nécessaires selon le type de colis demandé ............................... 10
II.4.2
Paramètres d’entrée de generateLabel ....................................................... 11
II.4.2.1 Bloc OutputFormat ............................................................................. 11
II.4.2.2 Bloc Service (élément de Letter) ........................................................... 12
II.4.2.3 Bloc Parcel (élément de Letter) ............................................................. 13
II.4.2.4 Bloc customsDeclarations (élément de Letter) ......................................... 14
II.4.2.5 Bloc sender (élément de Letter) ............................................................ 14
II.4.2.6 Bloc addressee (élément de Letter) ....................................................... 15
II.4.2.7 Bloc field (élément de fields) ................................................................ 16
II.4.3
Réponse de generateLabel ....................................................................... 18
II.5 Méthode getProductInter .................................................................................. 18
II.5.1
Paramètres d’entrée de getProductInter ..................................................... 19
II.5.2
Réponse de getProductInter ..................................................................... 20
II.6 Méthode getListMailBoxPickingDates ................................................................... 20
II.6.1
Paramètres d’entrée de getListMailBoxPickingDates ...................................... 20
II.6.2
Réponse de getListMailBoxPickingDates ...................................................... 21
II.7 Méthode planPickup ......................................................................................... 21
II.7.1
Paramètres d’entrée de planPickup ............................................................ 22
II.7.2
Réponse de planPickup ............................................................................ 22
III.
Nomenclature ..................................................................................................... 23
III.1
Produits disponibles ..................................................................................... 23
III.2
Options d’envoi ........................................................................................... 24
III.3
Formats des étiquettes ................................................................................. 24
III.4
Envois internationaux ou vers l’Outre-Mer ........................................................ 25
III.4.1
Gestion des données douanières ............................................................... 26
III.4.2
Document de déclaration en douane « CN23 » ............................................ 27
III.5
Autres contrôles effectués ............................................................................. 29
Flexibilité - Webservice Affranchissement - Avril 2016
2
IV.
Contact ............................................................................................................. 29
V.
Annexe 1 : Codes Erreurs ..................................................................................... 29
VI.
Annexe 2 : éditions ............................................................................................. 37
VI.1
Affichage des données sur les étiquettes .......................................................... 37
VI.2
Partie droite de l’étiquette (format A4 seulement) ............................................. 37
VI.3
Modèle du bordereau de remise ..................................................................... 39
VI.4
Contenu du bordereau .................................................................................. 40
VII.
Annexe 3 : exemples d’enveloppes SOAP ............................................................. 41
VII.1
Méthode getProductInter............................................................................... 41
VII.2
Méthode generateLabel ................................................................................. 41
VII.3
Méthode getListMailBoxPickingDates ............................................................... 44
VII.4
Méthode planPickup ..................................................................................... 44
3
I.
Introduction
I.1 Objet du document
La Poste - Colissimo met le service SLS, Simple Label Solution, à la disposition de ses clients
pour réaliser leurs affranchissements.
Ce Web Service permet de générer les documents associés à un colis (étiquettes et
documents douaniers), ainsi que de transmettre son annonce informatique de façon
automatique vers La Poste - Colissimo.
Abréviation
Description
SLS
Simple Label Solution
JRE
Java TM Runtime Environment
XML
eXtensible Markup Language
XSL
eXtensible Stylesheet Language
XSLT
XSL Transformations
ZPL
Zebra Programming Language
soapUI
Open source de test de Web Service
DPL
Datamax Programming Language
XOP
XML Optimized Packaging
MTOM
Message Transmission Optimization Mechanism
MIME
Multipurpose Internet Mail Extensions
HTTPS
HyperText Transfer Protocol Secure : protocole de transfert sécurisé
Ce document décrit les modalités d’accès et d’utilisations particulières du Web Service.
I.2 Pré-requis techniques
Pour accéder à notre Web Service, il est nécessaire d’implémenter un client SOAP. Selon le
langage de programmation utilisé et de sa version, vous pourrez être amené à installer des
librairies supplémentaires.
Si vous utilisez une imprimante thermique, vous devrez également disposer de connaissances
système afin d’envoyer les flux reçus du web service vers le port USB ou réseau de votre
imprimante.
4
I.3 Codification des formats
Code
Description
A
Caractères alphabétiques (sans espace ni symbole de ponctuation)
AN
N
D
T
DT
SUB
L
B
Tout caractère imprimable
Caractères numériques décimaux de 0 à 9
Date
Heure
Date et heure
Bloc : liste de sous-champs
Choix parmi une liste de valeurs
Booléen (true/false ; 1/0)
Les nombres qui suivent ces codes dans les descriptions des données indiquent la longueur
du champ. Un seul nombre indique un champ de longueur fixe (ex : « N6 » pour numérique
sur 6 caractères) deux nombres séparés par deux caractères point indiquent la longueur
minimale et maximale attendue (ex : « AN0..35 » pour alphanumérique pouvant être vide et
de longueur maximale 35 caractères).
I.4 Codification des Conditions
Code
O
F
C
Description
Donnée obligatoire. L’information portée par cette donnée doit être systématiquement présente dans le
fichier
Donnée facultative. Cette information pourra être fournie si elle est présente dans le système d’information
émetteur du fichier.
Présence conditionnée par le contenu d’un autre champ du même enregistrement. Exemple : un colis pour
lequel est demandée une notification au destinataire devra indiquer les éléments permettant de transmettre
cette notification (numéro de téléphone et/ou adresse mail selon le cas).
I.5 Gestion des caractères accentués
Il est nécessaire que les caractères soient encodés en UTF-8.
Afin d’assurer un rendu correct sur les étiquettes et dans les notifications envoyées aux
destinataires, les caractères accentués renseignés en entrée du Web Service sont remplacés
par leurs équivalents sans accent (ex : « é » sera remplacé par « e »).
5
II. Le Web Service SLS
L’invocation du Web Service SLS par le client s’effectue via une requête HTTPS encapsulant
une demande d'édition d’étiquette de transport pour impression par le client.
L’étiquette retournée par le Web Service peut, selon le format demandé en entrée, se
présenter sous la forme (cf. III.3 Formats des étiquettes) :
 d’un document PDF
 d’une trame ZPL
 d’une trame DPL
Le Web Service SLS propose les méthodes suivantes :
Opération
Description
generateLabel
Génère une expédition : annonce informatique du colis +
documents associés (étiquette et déclarations douanières)
getProductInter
Utile uniquement dans le cas de certaines destinations
internationales
Retourne les options de retour compatibles avec la
destination/option de livraison demandée (en fonction des
zones tarifaires)
Utile uniquement pour le Retour Colissimo France
getListMailBoxPickingDates
Permet de savoir si une adresse est éligible à l’expédition
depuis une boîte aux lettres, et connaître la date et heure de
prochain emport de colis à cette adresse.
Utile uniquement pour le Retour Colissimo France
planPickup
Permet de faire une demande d’emport d’un colis retour
depuis la boîte aux lettres du ré-expéditeur.
Important : lors de l’appel à ces méthodes, les paramètres sont à renseigner dans l’ordre
défini dans le wsdl, sans quoi une erreur du type « unmarshalling error » sera retournée.
II.1 Url d’accès
Le Web Service d’affranchissement La Poste – Colissimo est accessible à l’adresse
https://ws.colissimo.fr/sls-ws/SlsServiceWS?wsdl
Ce service nécessite l’utilisation de votre numéro de contrat La Poste - Colissimo et de votre
mot de passe, que vous pouvez recevoir par mail à l’ouverture de votre contrat ou sur
demande auprès de votre interlocuteur commercial La Poste - Colissimo usuel.
Ces identifiants vous permettent
https://www.colissimo.fr/entreprise
également
d’accéder
à
votre
espace
client
sous
6
Attention :
Vous avez la possibilité via l’espace client de modifier votre mot de passe.
Si celui-ci est modifié, vous devez également le modifier dans l’invocation du
Web Service, sinon l’accès au Web Service sera refusé.
II.2 Sécurité : préconisation du protocole HTTPS
L’accès à ce web service étant protégé par un identifiant et un mot de passe, données à
caractère sensible, La Poste - Colissimo préconise d’utiliser le protocole HTTPS pour le
transport de ces données.
Ne pas utiliser ce protocole vous expose à l’interception par un tiers malveillant, de ses
identifiants, ce qui permettrait à ce dernier d’usurper l’identité du compte, et ainsi :
- d’accéder à votre espace entreprise (facture online, suivi des colis)
- de commander des produits, facturés au compte usurpé
- d’accéder aux autres solutions mises à disposition par La Poste - Colissimo
Les conditions d’utilisation de cette solution spécifient que 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.
7
II.3 Format et traitement de la réponse du web service
Remarques : Le web service SLS utilise la technologie MTOM (Message Transmission
Optimization Mechanism). Cela implique que l'étiquette est attachée au format MIME dans la
réponse du web service. Selon le langage de programmation utilisé, il sera nécessaire ou non
de décomposer (parser) la réponse SOAP/XML+XOP pour en extraire les pièces jointes.

Exemple de retour via SOAPUI de la méthode generateLabel avec étiquette
PDF :
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns2:generateLabelResponse xmlns:ns2="http://sls.ws.coliposte.fr">
<return>
<messages>
<id>0</id>
<messageContent>La requête a été traitée avec
succès</messageContent>
<type>INFOS</type>
</messages>
<labelResponse>
<label>
<xop:Include href="cid:[email protected]" xmlns:xop="http://www.w3.org/2004/08/xop/include"/>
</label>
<cn23>
<xop:Include href="cid:[email protected]" xmlns:xop="http://www.w3.org/2004/08/xop/include"/>
</cn23>
<parcelNumber>7Q05592274242</parcelNumber>
<pdfUrl>https://pfi.telintrans.fr/slsws/GetLabel?parcelNumber=7Q05592274242&signature=d0fe8cc2e3d35febd858b2f73b6a26cc4
edb8674820a7c4033982c08ad668374&includeCustomsDeclarations=true</pdfUrl>
</labelResponse>
</return>
</ns2:generateLabelResponse>
</soap:Body>
</soap:Envelope>
8
II.3.1 Evolutivité du Web Service
Le Web Service pouvant être sujet à de légères modifications (ex : augmentation d’un
nombre d’éléments retournés en sortie), La Poste - Colissimo préconise pour son intégration
d’utiliser des logiques de programmation souples et dynamiques.
II.3.2 Particularité pour les étiquettes ZPL
Pour les impressions thermiques, les étiquettes générées par le web service utilisent le mode
d’impression « transfert direct ». Vérifiez bien que votre imprimante ne soit pas configurée
sur le mode « transfert thermique ».
II.4 Méthode generateLabel
Cette méthode est à utiliser pour générer vos expéditions, quels que soient le produit ou la
destination demandés pour les offres suivantes :
 Offre France : Colissimo Domicile, Point Retrait, Retour
 Offre Internationale : Colissimo Expert, Domicile, Point Retrait, Retour
 Offre Outre-Mer : Colissimo Domicile et Colissimo Eco
Les produits concernés à ce jour sont listés dans le paragraphe III.1 Produits disponibles. La
Poste - Colissimo est susceptible de faire évoluer cette liste.
Remarque : il est préférable de ne pas envoyer du tout un champ facultatif plutôt que de
l’envoyer vide.
9
II.4.1 Informations nécessaires selon le type de colis demandé
Le schéma suivant indique les paramètres nécessaires à la création d’un colis selon le produit demandé.
Les informations obligatoires sont notées en gras avec un astérisque. Chaque champ est détaillé dans les paragraphes suivants.
Flexibilité - Webservice d’Affranchissement - Avril 2016
II.4.2 Paramètres d’entrée de generateLabel
Les paramètres d’entrée attendus par la méthode generateLabel sont listés ci-dessous tels
que définis dans le wsdl. Tout élément transmis qui ne figure pas dans ce tableau sera ignoré
par le Web Service.
Donnée
Format
contractNumber
N6
password
AN6…15
outputFormat
letter
Condition
Il s'agit du n° de client sur 6 caractères, fourni par La Poste Colissimo à l'ouverture de votre compte client
Mot de passe associé au n° de client saisi
O
O
O
Il doit être identique à celui de votre espace client
Bloc : contient les sous-champs liés au format des éditions
renvoyées par le Web Service
O
Cf. II.4.2.1 Bloc OutputFormat
Bloc : contient des sous-champs et blocs liés à l’expédition
(options, colis, expéditeur, destinataire, douanes)
SUB
Liste des sous-blocs (décrits plus bas) :
 Service : type de produit et tarifs
 Parcel : assurances et options
 Sender : expéditeur
 Addressee : destinataire
 CustomsDeclarations : douanes
SUB
Cf. II.4.2.2 à II.4.2.4
Uniquement pour Colissimo International Point Retrait dont
le réseau est X00
F
fields
Commentaire
Ce bloc sert à renseigner les informations liées à un point de
retrait pour les colis dont le code réseau est X00 (dans la
réponse du WS Choix de livraison)
SUB
Cf Bloc Field (élément de Fields)
II.4.2.1 Bloc OutputFormat
Donnée
Format
x
N-9999…9999
Condition Commentaire
Pour les sorties DPL, ZPL, PDF
Par défaut, renseigner « 0 » (zéro)
O
Permet d’ajuster le décalage horizontal de l’impression
sur l’étiquette (exprimé en points).
si x <0 : l'étiquette est décalée à droite
si x >0 : l'étiquette est décalée à gauche
Pour les sorties DPL, ZPL, PDF
y
11
N-120…120
O
Flexibilité - Webservice Affranchissement - Février 2016
Permet d’ajuster le décalage vertical de l’impression sur
l’étiquette (exprimé en points).
Donnée
Format
si y <0 : l'étiquette est décalée en haut
si y >0 : l'étiquette est décalée en bas
outputPrintingType
L
O
dematerialized
B
N/A
Format d'impression des étiquettes (cf. III.3 Formats des
étiquettes)
Non utilisé (utilisation interne à La Poste uniquement)
Utilisé pour le Colissimo Retour uniquement. Définit le
mode de transmission de l’étiquette
F
Valeurs possibles :
 SendPDFByMail : l’étiquette est également
envoyée par email, en tant que pièce jointe, sur
l’adresse renseignée dans le bloc « sender »
 SendPDFLinkByMail : l’étiquette est également
envoyée par email, sous forme de lien
hypertexte, sur l’adresse renseignée dans le
bloc « sender »
returnType
L
Par défaut, l’étiquette est envoyée uniquement dans la
réponse du Web Service
II.4.2.2 Bloc Service (élément de Letter)
Donnée
Format
productCode
L
depositDate
D
mailBoxPicking
B
mailBoxPickingDate
D
VatCode
vatPercentage
VatAmount
N
N
N
transportationAmount N
totalAmount
N
orderNumber
N0…30
Code désignant l’offre produit souhaitée
Ex : « CORE » pour Colissimo Retour
O
Cf. liste des codes : III.1 Produits disponibles
Date de dépôt prévisionnelle dans le réseau La Poste.
O
Ex : « 2015-12-23 »
Utilisé pour le code CORE
Doit valoir « true » pour que le colis puisse être déposé en
C
boîte aux lettres
Utilisé pour le code CORE
Date d’emport en boîte aux lettres demandée
Obligatoire (et pris en compte) seulement si
mailBoxPicking vaut "true"
C
Ex : « 2015-12-23 »
Pour connaître la prochaine date possible, appeler la
méthode getListMailBoxPickingDates
F
F
F
Prix du transport de base en centième d’euro. Ex : 4530
pour 45,30€
F
N’apparait dans le fichier CN23
Par défaut, passer 0
Prix du transport de base + les options de l’envoi en
centième d’euro. Ex : 4530 pour 45,30€
C
Obligatoire pour les colis nécessitant une déclaration CN23
(cf. III.4.1Gestion des données douanières)
Numéro de commande tel que renseigné dans votre SI
F
Peut être utile pour rechercher des colis selon ce champ sur
12
Donnée
Format
le suivi ColiView (apparaît dans le champ « ref. client »)
Obligatoire pour les produits DOM, DOS, BPR, A2P
commercialName
AN
C
returnTypeChoice
L
C
Nom commercial du chargeur qui sera affiché dans les
notifications par email aux destinataires des colis
Obligatoire pour certains colis à l’international, selon les
zones tarifaires applicables
Indique si le colis doit être retourné à l’expéditeur en cas de
non distribution du colis
cf. III.4 Envois internationaux ou vers l’Outre-Mer
II.4.2.3 Bloc Parcel (élément de Letter)
Donnée
parcelNumber
insuranceAmount
Format
AN13
N
insuranceValue
N
recommendationLevel
L
weight
N
nonMachinable
B
COD
B
CODAmount
N
returnReceipt
B
instructions
AN0…70
pickupLocationId
N6
C
F
Valeur assurée. Max= 1500€
Passer 1230 pour 12,30€
Cette valeur sera arrondie à l’entier le plus proche (Ex : 12
F
euros si 1232 est envoyé)
Niveau de recommandation (cf. III.2)
Peut valoir « R1 », ou « R2 », ou « R3 »
F
Cf. III.2 Options d’envoi
Poids du colis en kg (cf. III.5)
O
Ex : « 5.50 »
Passer à true pour indiquer que le format du colis est non
standard (non mécanisable)
F
Passer à true si la livraison doit se faire contre
remboursement
F
Montant attendu lors de la livraison contre remboursement.
F
Avis de réception (0=non ; 1=oui)
F
Indications complémentaires pour la livraison (ex : « à
F
gauche au portail intérieur »)
Identifiant du point de retrait (dans le cas d’une livraison
Colissimo hors domicile)
C
Si productCode vaut A2P, BPR, ACP, CDI, CMT, BDP, PCS =>
ce paramètre doit être renseigné
Si productCode vaut DOM, DOS, BOS, BOM => Ce
paramètre doit être vide
Si le code réseau est « X00 », il sera obligatoire de
13
Donnée
Format
ftd
B
renseigner le bloc « fields ».
Pour les envois vers l’Outre-Mer uniquement
Indique si le colis est franc de taxes et de droits
F
Cf. III.4 Envois internationaux ou vers l’Outre-Mer
II.4.2.4 Bloc customsDeclarations (élément de Letter)
Ces paramètres ne sont obligatoires que pour les destinations nécessitant une déclaration
douanière de type CN23.
Donnée
includeCustomsDeclarations
Format
B
Indique si la déclaration CN23 doit être retournée ou
non par generateLabel
F
Par défaut, vaut true (CN23 incluse)
contents
SUB
C
SUB
AN1…64
N
N
N
O
O
O
O
N
C
A2
SUB
C
O
N1
O
importersReference
AN35
F
importersContact
AN35
F
officeOrigin
AN35
F
article
description
quantity
weight
value
hsCode
originCountry
category
value
Bloc : nature de l’envoi et liste des articles
à déclarer
Obligatoire si envois éligibles à la CN23
Le bloc « article » peut être répété jusqu’à 100 fois.
Description détaillée de l’article.
Nombre d’articles de ce type
Poids net unitaire des articles en kg
Valeur unitaire des articles en EURO (cf. III.4.1)
Numéro tarifaire correspondant à l’article
Obligatoire si category=3 (envoi commercial)
Cf. III.4.1 Gestion des données douanières
Code ISO du pays d’origine de l’article
Nature de l'envoi (cf. III.4.1 Gestion des données
douanières)
Référence de l’importateur
N’apparait pas sur le fichier CN23
Contact (tel/email) de l’importateur
Bureau d’origine
II.4.2.5 Bloc sender (élément de Letter)
Donnée
senderParcelRef
Format
AN
Commentaire
Référence interne du colis pour l’expéditeur.
Bloc : coordonnées de l’expéditeur
address
companyName
lastName
firstName
line0
line1
line2
line3
countryCode
Condition
F
AN35
A35
A29
AN35
AN35
AN35
AN35
A2
F
F
F
F
F
O
F
O
Raison sociale
Nom
Prénom
Etage, couloir, escalier, appart.
Entrée, bâtiment, immeuble, résidence
Numéro et libellé de voie. Ex : « 5 rue du Bellay »
Lieu dit ou autre mention
Code ISO du pays sur 2 lettres.
14
Donnée
Format
Condition
city
zipCode
phoneNumber
mobileNumber
doorCode1
doorCode2
AN35
AN5
AN15
AN10
AN8
AN8
O
O
F
F
F
F
email
AN80
C
intercom
AN30
F
language
A2
F
Commentaire
Ex : « FR » pour la France (cf. III.4 Envois internationaux
ou vers l’Outre-Mer)
Ville
Code postal
Numéro téléphone
Numéro de portable
Code porte 1
Code porte 2
de la forme : <Texte>@<Texte>.<Texte>
utilisé pour les notifications de suivi par email
Interphone
Langue de l’expéditeur (utilisée pour les notifications de
suivi par email ou SMS)
Par défaut : FR
II.4.2.6 Bloc addressee (élément de Letter)
Donnée
adresseeParcelRef
codeBarForReference
Format
AN15
B
serviceInfo
AN
promotionCode
AN
Reference du colis pour le destinataire (pour les colis
F
retour). Non utilisé dans Coliview
Utilisé pour le Colissimo Retour uniquement (« CORE »)
Pour afficher la donnée addresseParcelRef sous forme de
F
code barre sur l’étiquette du colis, renseigner à true
Utilisé pour le Colissimo Retour uniquement (« CORE »)
F
Nom du service dans la société (ex : « Service des retours »)
N/A
Address
Bloc : coordonnées du destinataire
AN35
C
lastName
A35
O
firstName
A29
C
line0
line1
line2
AN35
AN35
AN35
F
F
O
line3
AN35
F
companyName
O
countryCode
A2
city
AN35
zipCode
AN5…
O
O
phoneNumber
AN15
F
mobileNumber
AN10
C
doorCode1
doorCode2
AN8
AN8
F
F
email
AN80
C
Obligatoire pour les Colissimo Retour (« CORE »)
Raison sociale
Nom
Prénom
Obligatoire pour So Colissimo
Lieu-dit ou autre mention
Attention : cette ligne n’est pas affichée sur les étiquettes à
destination de l’international
Code ISO du pays sur 2 lettres.
Ex : « FR » pour la France (cf. III.4 Envois internationaux
ou vers l’Outre-Mer)
Ville
Code postal (au moins 5 caractères attendus –en fonction
des pays)
Numéro téléphone
Numéro de portable. Utilisé pour les notifications de suivi
par SMS
Obligatoire pour les produits BPR, A2P
Code porte 1
Code porte 2
de la forme : <Texte>@<Texte>.<Texte>
Utilisé pour les notifications de suivi par email
15
Donnée
intercom
Format
AN30
language
A2
Interphone
F
Langue du destinataire (utilisée pour les notifications de
suivi par email ou SMS)
F
Par défaut : FR
II.4.2.7 Bloc field (élément de fields)
Ce bloc concerne les produits de l’offre Colissimo Point Retrait à l’international (si
productCode= CMT, BDP ou PCS)
Les informations à indiquer dans ce bloc sont issues des solutions de proposition de point de
de retraits Colissimo pour les points dont le code réseau vaut X00. Le code réseau est
renvoyé dans le paramètre « reseau », la réponse du Web service de Livraison est dans le
paramètre « CODERESEAU » de la réponse de la Page I-Frame Choix de livraison.
Paramètres
Type
fields
SUB
<fields>/<field>
SUB
<fields>/<field><key>
AN
Commentaires
A répéter pour chaque ensemble de paramètres Key/Value
Libellés de clés à renseigner :
PUDO_NETWORK_CODE : code réseau
PUDO _POINT_NAME : Nom du point de livraison
PUDO_POINT_ADDRESS_1 : Adresse du point de livraison ligne
1
2
3
4
PUDO_POINT_TOWN : Ville du point de livraison
PUDO_POINT_ZIP_CODE : Code postal du point de livraison
PUDO_POINT_COUNTRY_CODE : Code pays du point de
livraison
CUSTOMER_ACCOUNT_NUMBER : N° d’abonné aux points de
retrait internationaux le cas échéant.(En prévision de l’ouverture de
point de retrait nécessitant un numéro d’abonné)
<fields>/<field>/<value>
AN
Préciser la valeur pour la clé concernée.
Exemple :
<fields>
<field>
<key>PUDO_NETWORK_CODE</key>
<value>X00</value>
</field>
<field>
16
<key>PUDO_POINT_NAME</key>
<value>GERMANY BAR</value>
</field>
<field>
<key>PUDO_POINT_ADDRESS_1</key>
<value>Pariser Platz 5</value>
</field>
<field>
<value></value>
</field>
<field>
<value></value>
</field>
<field>
<value></value>
</field>
<field>
<key>PUDO_POINT_TOWN</key>
<value>Berlin</value>
</field>
<field>
<key>PUDO_POINT_ZIP_CODE</key>
<value>10117</value>
</field>
<field>
<key>PUDO_POINT_COUNTRY_CODE</key>
<value>DE</value>
</field>
<field>
<key>CUSTOMER_ACCOUNT_NUMBER</key>
<value>123456</value>
</field>
</fields>
17
II.4.3 Réponse de generateLabel
La méthode generateLabel vous retournera les données ci-dessous si en entrée du web
service vous avez renseigné le paramètre « outputPrintingType » avec l’une des valeurs
suivantes :
 ZPL_10x15_203dpi
 ZPL_10x15_300dpi
 DPL_10x15_203dpi
 DPL_10x15_300dpi
 PDF_10x15_300dpi
 PDF_A4_300dpi
Donnée
Format
Condition
label
O
cn23
C
parcelNumber
O
parcelNumberPartner
C
pdfUrl
C
Commentaire
Etiquette du colis
Binaire transmis en pièce jointe (XOP), quel que soit
la valeur de outputPrintingType
PDF de la CN23
Binaire transmis en pièce jointe (XOP) quand
nécessaire (cf. III.4.1 Gestion des données
douanières)
Numéro du colis généré
Appartient à la plage de numéros attribuée par La
Poste Colissimo pour le code produit correspondant
Numéro du colis pour le partenaire étranger
Retourné pour les colis internationaux uniquement
Uniquement si un format PDF est demandé : lien
permettant de télécharger l'étiquette pdf
Attention : non retourné pour les étiquettes Retour
International (productCode « CORI »)
messages
id
type
messageContent
O
O
O
identifiant du message
Type de message : ERROR, INFOS, WARNING
contenu du message
II.5 Méthode getProductInter
Cette fonction est à utiliser uniquement pour les envois à l’international si vous souhaitez
connaître les options de retour compatibles avec la destination demandée (ex : « retour
payant », « ne pas retourner », cf. exemple ci-dessous).
L’option de retour saisie est transmise à nos partenaires internationaux afin de leur indiquer
l’action à réaliser dans le cas où le colis ne pourrait être remis à son destinataire (cf. III.4
Envois internationaux ou vers l’Outre-Mer).
18
Return Type
choice
Do not return to the sender
Les éléments de l’étiquette peuvent évoluer.
II.5.1 Paramètres d’entrée de getProductInter
Les paramètres d’entrée attendus par la méthode getProductInter sont listés ci-dessous.
Tout élément transmis qui ne figure pas dans ce tableau sera ignoré par le Web Service.
Les paramètres sont à renseigner dans l’ordre défini dans le wsdl, sans quoi une erreur du
type « unmarshalling error » sera retournée.
Donnée
Format
Condition
contractNumber
N6
password
AN
productCode
A
O
insurance
B
F
nonMachinable
B
F
returnReceipt
B
F
countryCode
A2
C
zipCode
AN
C
O
O
Commentaire
Il s'agit du n° de client sur 6 caractères, fourni par La Poste
Colissimo à l'ouverture de votre compte client
cf. III.1 Produits disponibles
Valeur Assurée (0=non ;1=oui)
Par défaut, 0
Passer à true pour indiquer que le format du colis est non
standard (non mécanisable). Par défaut, false
Avis de réception (0=non ;1=oui)
Par défaut, 0
Code ISO du pays de destination. Ex : « DE » pour
Allemagne
Code postal de destination
19
II.5.2 Réponse de getProductInter
Donnée
Format
product
A
partnerType
N
Condition
SUB
returnTypeChoice
Commentaire
Code correspondant aux 2 premiers caractères de votre
numéro de colis.
Voir le paragraphe III.1 pour la liste complète des produits
possibles.
Non utilisé : usage interne
liste des options de retour possible pour la destination et
les options demandés en entrée
Cf. III.4 Envois internationaux ou vers l’Outre-Mer
messages
O
O
O
id
type
messageContent
identifiant du message
Type de message : ERROR, INFOS, WARNING
contenu du message
II.6 Méthode getListMailBoxPickingDates
La méthode getListMailBoxPickingDates() permet de savoir si une adresse est éligible à
un dépôt de colis retour en boîte aux lettres, et connaître la date et heure de prochain emport
de colis à cette adresse.
II.6.1 Paramètres d’entrée de getListMailBoxPickingDates
Donnée
Format
Condition
contractNumber
N6
password
AN
sender
line0
line1
line2
line3
SUB
AN35
AN35
AN35
AN35
O
F
F
O
F
countryCode
A2
O
zipCode
city
AN5
AN35
O
F
O
O
Commentaire
Code pays
Seule la valeur « FR » est autorisée
Code postal
Commune
20
II.6.2 Réponse de getListMailBoxPickingDates
Donnée
Format
Id
N6
Identifiant du message
messageContent
AN
Libellé de message
mailBoxPickingDateMaxHour
mailBoxPickingDates
T
SUB
validityTime
Heure limite d’emport en boîte aux lettres
Ex : « 09h00 »
Date d’emport en boîte aux lettres, sous la forme « 2015-0327T00:00:00+01:00 »
Heure limite de validité pour une demande d’emport
Ex : « 23h00 »
T
Toute demande d’emport pour le jour J+1 doit être faite le
jour J avant 23h (Heure limite pour faire la demande d’emport
BAL). Si la demande survient après 23h le jour J, le service
renvoie une erreur 30806
II.7 Méthode planPickup
La méthode planPickup () permet de faire une demande d’emport d’un colis retour déposé
par l’expéditeur dans sa boite aux lettres. Le colis doit avoir été préalablement annoncé
auprès de La Poste.
21
II.7.1 Paramètres d’entrée de planPickup
Donnée
Format
contractNumber
N6
password
AN
parcelNumber
AN13
mailBoxPickingDate
D
Condition
Commentaire
O
O
O
Numéro de colis
Date d’emport demandée
Ex : « 2015-12-23 »
O
SUB
AN35
O
F
Raison sociale
O
O
F
F
O
F
O
O
countryCode
AN35
AN29
AN35
AN35
AN35
AN35
AN5
AN35
A2
email
AN80
phoneNumber
AN15
Nom
Prénom
Code postal
Commune
Code pays
Seule la valeur « FR » est autorisée
Adresse courriel. Utilisé pour les notifications de suivi aux
destinataires
Téléphone
sender
companyName
lastName
firstName
line0
line1
line2
line3
zipCode
city
O
O
F
II.7.2 Réponse de planPickup
Donnée
Format Condition Commentaire
id
N6
O
Identifiant du message
messageContent
AN
O
Contenu du message
22
III. Nomenclature
Les données retournées par le Web Service varient en fonction de la destination du colis, et
des formats d’étiquette convenus avec nos partenaires internationaux.
III.1 Produits disponibles
Le tableau suivant liste les valeurs possibles pour le paramètre d’entrée productCode, et
donne pour chacune de ces valeurs l’offre qui lui est associée, ainsi que les code produits
susceptibles d’être retournés par le web service pour la création du numéro de colis.
La valeur du champ productCode désigne l'offre produit du colis à créer selon ses
caractéristiques de livraison (gamme, destination, mode de livraison).
Offre
Valeur à passer Codes produits
dans
retournés par le WS
<productCode> (2 premiers caractères du
Nom commercial
numéro de colis)
France
DOM
6A ou 6Q (profil)
COLD*
9L
DOS
6C
COL*
9V
6H ou 6R (profil)
France
Colissimo - Point Retrait – A La Poste
Colissimo - Point Retrait – en relais Pickup ou en
consigne Pickup Station
Colissimo Retour France
BPR**
CORE
8R
International
Colissimo Retour International
CORI
7R
Outre-Mer
Colissimo Domicile - sans signature
COM
8Q
Outre-Mer
Colissimo Domicile - avec signature
CDS
7Q
Outre-Mer
Colissimo Eco OM
ECO
9W
International
Colissimo Expert International
COLI
CP ou EY
International
(liste définie)
International
(liste définie)
International
(liste définie)
International
(liste définie)
Colissimo - Point Retrait – en relais ***
CMT
Colissimo Domicile - sans signature
France
Colissimo Domicile - avec signature
France
France
Colissimo Domicile - sans signature ***
Colissimo Domicile - avec signature ***
Colissimo Point Retrait – en bureau de poste ***
A2P
DOM
DOS
BDP
6M ou 6W (profil)
CM ou CT (profil)
CA ou CQ (profil)
CB
CI ou CU (profil)
(*)
Les codes COLD et COL sont réservés aux anciens comptes ayant du 9L et 9V. Pour tout compte signé
à partir de 2016, il faut utiliser les codes DOM et DOS qui génèreront des étiquettes 6A, 6C aux services
équivalents.
(**)
Le code « BPR » est à utiliser pour les sites de livraison de type « BPR », « ACP », ou « CDI ». Ces
trigrammes sont retournés par votre solution Colissimo Choix du mode de Livraison.
(***)
A la date de diffusion de ce document, l’offre Colissimo Domicile et Point Retrait à l’international est
disponible uniquement sur certains pays :
Pays éligibles
Belgique
Allemagne
Pays-Bas
Espagne
Grande-Bretagne
Luxembourg
Offres
Domicile, Bureau de Poste, relais
Domicile, relais
Domicile, relais
Domicile, relais
Domicile, relais
Domicile, relais
23
III.2 Options d’envoi
Tous les produits La Poste - Colissimo n’ont pas les mêmes options d’envoi disponibles.
A partir du productType renseigné en entrée, le Web Service ne tiendra compte que des
options associées à votre produit.
Les paragraphes ci-dessous décrivent certaines de ces options.

Niveau de recommandation : paramètre « recommendationLevel » :
3 niveaux d'assurance forfaitaire pour la recommandation (voir conditions tarifaires en
vigueur)
Valeurs possibles
Description
R1
jusqu'à 31€
R2
jusqu'à 153€
R3
jusqu'à 458€

Contre-remboursement : paramètres « COD » / « CODAmount »:
Si la livraison doit se faire contre un paiement du destinataire, passer « COD » à true
(ou « 1 »), et renseigner le montant en question dans « CODAmount », en centièmes
d’euros (ex : « 4340 » pour 43,40€)

Valeur assurée : paramètre « insuranceValue » :
L’assurance optionnelle peut aller jusqu'à un montant de 1 500 €, par tranche de 150€
pour l'offre informatisée. Saisir dans « insuranceValue » une valeur en centièmes
d’euros (ex : « 4300 » pour 43€). Cette valeur est arrondie à l’entier le plus proche
(ex : arrondie à 43€ si « 4345 » est saisi).

Envoi non standard : paramètre « nonMachinable » :
Pour signaler un envoi dit « volumineux » ou non stable. Pour plus de détails, se
reporter à la FAQ Expédition sur colissimo.fr

Avis de réception : paramètre « returnReceipt » :
Pour être informé par courrier de la réception et de la date de remise du colis au
destinataire, passer « returnReceipt » à true ou 1.

Franc de taxes et de droits : paramètre « ftd » :
Si vous souhaitez prendre à votre charge les droits de douanes en cas de taxation des
colis (pour les envois vers la zone OM1, hors Saint-Pierre-et-Miquelon et Mayotte),
passer « ftd » à true ou 1.
III.3 Formats des étiquettes
Le Web Service d’affranchissement La Poste - Colissimo vous laisse la possibilité de choisir le
format d’étiquettes que vous souhaitez obtenir en retour de chaque appel, via le paramètre
d’entrée
« outputPrintingType
»
qui
propose
différentes
combinaisons
de
format/dimension/résolution.
Ce paramètre peut prendre les valeurs suivantes :
24
Valeur
ZPL_10x15_203dpi
ZPL_10x15_300dpi
DPL_10x15_203dpi
DPL_10x15_300dpi
PDF_10x15_300dpi
PDF_A4_300dpi
Description
Types d’imprimantes compatibles
impression thermique en ZPL, de dimension 10cm
par 15cm, et de résolution 203dpi
impression thermique en ZPL, de dimension 10cm
impression thermique en DPL, de dimension 10cm
impression thermique en DPL, de dimension 10cm
impression bureautique en PDF, de dimension
10cm par 15cm, et de résolution 300dpi
impression bureautique en PDF, de dimension A4,
et de résolution 300dpi
Thermique Zebra 203 dpi
Thermique Zebra 300 dpi
Thermique Datamax 203 dpi
Thermique Datamax 300 dpi
Bureautique
Bureautique
Remarques :

Nous recommandons aux chargeurs ayant de forts volumes d’impression (à partir de
1000 colis par mois) de choisir des formats thermiques (ZPL ou DPL) afin de fluidifier
leur chaîne logistique.

Les masques d’étiquettes générées par nos sorties PDF, ZPL et DPL doivent être
imprimées sans redimensionnement pour ne pas altérer la qualité des codes-barres.

En cas de besoin d’afficher des éléments supplémentaires sur le support d’impression,
il est préconisé de le faire en dehors du masque 10x15 de l’étiquette généré par notre
Web Service, sans quoi La Poste - Colissimo ne pourrait être tenue responsable des
problèmes de lecture dans notre réseau.
III.4 Envois internationaux ou vers l’Outre-Mer

Paramètres « countryCode » :
Les codes pays transmis dans les paramètres countryCode doivent correspondre à
ceux de la table des pays transmis dans un document annexe.

Paramètres « zipCode » :
La validité du format du code postal est vérifiée pour le pays de destination (selon le
code pays transmis dans countryCode). Par exemple, on vérifiera qu’un code postal
transmis pour le Canada contient 6 caractères. Attention, pour les territoires spéciaux
rattachés à d’autres pays, le countryCode doit être celui du territoire spécial, et non
pas celui de son pays de rattachement (ex : « GL » pour le Groenland rattaché au
Danemark, et non pas « DK »).

Paramètre « returnTypeChoice » :
Clé désignant l'action à effectuer en cas de retour d'un colis (pour les offres Expert I,
ou Colissimo International)
Pour connaître les options autorisées pour un pays, appeler la méthode
getProductInter. Plus d’informations sur colissimo.fr
25
Option en cas de non livraison
Retour payant en prioritaire
(Hors Union Européenne
seulement)
Ne pas retourner
(Toutes les destinations)
Mention sur l’étiquette
Valeur de
<returnTypeChoice>
2
Return to the sender as priority parcel
Do not return to the sender
3
III.4.1 Gestion des données douanières
La Poste a pour obligation pour certains pays de transmettre la déclaration CN23 en version
dématérialisée à ses partenaires en charge du dédouanement des marchandises.
C’est pourquoi, pour les colis vers des destinations nécessitant une déclaration en douanes
sur formulaire CN23, les informations de la CN23 doivent être transmises à la Poste par le
Web Service.
Si les données CN23 ne sont pas transmises ou sont incomplètes, le web service retourne un
code ERROR et l’étiquette ne peut pas être imprimée.


Paramètre « category » :
Indique la nature de l'envoi (pour les envois internationaux ou vers l'outre-mer soumis
à CN23). Il ne peut prendre que les valeurs suivantes :
Valeurs possibles
Description
1
Cadeau
2
Echantillon commercial
3
Envoi commercial
4
Document
5
Autre
6
Retour de marchandise
Paramètre « value » :
 Valeur unitaire des articles en EURO
 Seulement 2 décimales différentes de 0 sont acceptées
Dans le cas où les données nécessaires à la création de la CN23 sont fournies à La Poste Colissimo, ce document vous est retourné dans la réponse de la méthode generateLabel
(élément <cn23>), en 4 exemplaires, sous forme d’un seul fichier PDF (quel que soit le
mode d’impression de l’étiquette colis demandé).

Paramètre « hsCode » :
Depuis 1988, la Communauté européenne a, après nombre d’États dans le monde,
adopté le Système Harmonisé (SH) de désignation des marchandises pour les envois
commerciaux. Ce “numéro tarifaire” (jusqu'à 11 chiffres) permet d’identifier de
manière unique et dans le monde entier tous les objets physiques. Il est un des trois
éléments permettant d’établir la taxation en douane, avec le montant des frais de port
et l’origine de la marchandise.
Pour permettre un traitement rapide des opérations douanières à l’arrivée dans le pays
de destination, il est ainsi recommandé aux entreprises d’indiquer le numéro tarifaire
de la marchandise envoyée.
Dans les échanges postaux, seule l’indication du numéro tarifaire à 6 chiffres constitue
une obligation pour les entreprises expéditrices.
26
Où se procurer le numéro tarifaire ?
o Se rapprocher des cellules de douane de sa région pour des envois réguliers
o Se
rendre
sur
le
site
de
la
douane
française :
https://pro.douane.gouv.fr/prodouane.asp (dans l’encyclopédie tarifaire RITA,
consulter la nomenclature)
III.4.2 Document de déclaration en douane « CN23 »
Il est nécessaire d’émettre cette déclaration, obligatoire pour dédouaner les colis expédiés
vers l’international. Elle doit être imprimée en 4 exemplaires qui seront joints à l’envoi.
Le document peut être édité via le Web Service ou par des moyens propres au client.
27
28
III.5 Autres contrôles effectués

Paramètre « weight » :
Poids du colis en kg.
Min : 0.01 kg
Max : 30.00 kg ou le poids max du point retrait
Seulement 2 décimales différentes de 0 sont acceptées

Le statut du compte client : un compte client résilié ne peut générer des étiquettes
IV. 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,
du lundi au vendredi, de 9h à 18h.
Etude préalable
Déploiement de la solution
Phase opérationnelle,
après déploiement de la solution
Pour confirmer la solution retenue :
 Votre interlocuteur commercial La Poste – Colissimo
 Un numéro de dossier vous sera communiqué par le
Support Solutions Client lorsque la demande sera
prise en compte
Pour tout échange concernant la demande de mise en
œuvre :
 Le Support Solutions Client,
au 0241.742.088,
En cas de panne, d’anomalie ou d’incident :
 Le Centre de Service,
au 0825.086.005,
La disponibilité et le bon fonctionnement de nos systèmes
sont supervisés, même en dehors de ces heures.
V.
Annexe 1 : Codes Erreurs
29
Il s’agit des valeurs possibles de l’élément <id> présent dans la définition du type
<message>. La cause de l’erreur est décrite dans l’élément <libelle> associé.
Les paramètres du type string dont la longueur dépasse la longueur autorisée seront tronqués
à droite. Un message d’avertissement et un code seront ajoutés dans le paramètre
« Message » de la réponse.
Code
0
1
30000
30002
30007
Type
INFOS
ERROR
ERROR
ERROR
ERROR
30008
ERROR
30009
ERROR
30045
ERROR
ERROR
30046
30047
ERROR
30010
30014
30015
30017
ERROR
ERROR
ERROR
ERROR
30018
30020
ERROR
ERROR
30022
30023
30025
30026
30065
30043
30045
30046
30047
30085
ERROR
ERROR
ERROR
ERROR
ERROR
ERROR
ERROR
ERROR
ERROR
ERROR
30089
ERROR
30090
ERROR
30100
ERROR
30102
30103
30104
30106
30107
30108
ERROR
ERROR
ERROR
ERROR
ERROR
ERROR
Commentaire
La requête a été traitée avec succès
La requête a échouée
Identifiant ou mot de passe incorrect
La date de dépôt est antérieure à la date courante
Client inactif. Veuillez prendre contact avec votre
interlocuteur commercial.
Service non autorisé pour cet identifiant. Veuillez
prendre
contact
avec
votre
interlocuteur
commercial afin de réinitialiser votre compte client
Service non autorisé pour ce produit. Veuillez
prendre
contact
avec
votre
interlocuteur
commercial
L'email de l'expéditeur n'a pas été transmis
L'email de l’expéditeur est incorrect.
Le courriel de l’expéditeur est mal formaté. Pour
être valide, il doit avoir le format : [email protected]
Le numéro de téléphone de l’expéditeur est
incorrect
La date n'a pas été transmise
Le code produit n'a pas été transmis
Le code produit est incorrect
La valeur du champ contre remboursement est
incorrecte
Le nom commercial n'a pas été transmis
Le montant total des frais de transport n'a pas été
transmis
La langue de l'expéditeur est incorrecte
La langue du destinataire est incorrecte
Le type d'impression n'a pas été transmis
Le type d'impression est incorrect
Le nom de l'expéditeur n'a pas été transmis
Le prénom de l'expéditeur n'a pas été transmis
L'email de l'expéditeur n'a pas été transmis
L'email de l'expéditeur est incorrect
Le téléphone de l'expéditeur est incorrect
Le numéro de téléphone fixe de l'expéditeur est
incorrect
La raison social du destinataire n'a pas été
transmise
La taille du paramètre AddresseeParcelRef est
nulle ou supérieure à 15
Le numéro / libellé de voie de l'expéditeur n'a pas
été transmis
Le code pays de l'expéditeur n'a pas été transmis
Le code pays de l'expéditeur est incorrect
La ville de l'expéditeur n'a pas été transmise
Le code postal de l'expéditeur n'a pas été transmis
Le code postal de l'expéditeur est incorrect
Le code postal de l'expéditeur ne correspond pas
30
Code
Type
30109
ERROR
30200
30202
30204
ERROR
ERROR
ERROR
30206
30207
30208
30210
30211
30212
ERROR
ERROR
ERROR
ERROR
ERROR
ERROR
30213
ERROR
30220
ERROR
30221
30222
30223
30300
30301
30303
30306
30309
30310
30311
30312
ERROR
ERROR
ERROR
ERROR
ERROR
ERROR
ERROR
ERROR
ERROR
ERROR
ERROR
30313
30316
ERROR
ERROR
30317
ERROR
30318
ERROR
30321
30323
30324
30325
30326
30327
30400
30401
30403
ERROR
ERROR
ERROR
ERROR
ERROR
ERROR
ERROR
ERROR
ERROR
30500
30503
30504
30505
30506
30507
ERROR
ERROR
ERROR
ERROR
ERROR
ERROR
Commentaire
au pays
Le code pays ou le code postal de l'expéditeur est
incorrect pour le code produit fourni
Le nom du destinataire n'a pas été transmis
Le prénom du destinataire n'a pas été transmis
Le numéro / libellé de voie du destinataire n'a pas
été transmis
Le code pays du destinataire n'a pas été transmis
Le code pays du destinataire est incorrect
La ville du destinataire n'a pas été transmise
Le code postal du destinataire n'a pas été transmis
Le code postal du destinataire est incorrect
Le code postal du destinataire ne correspond pas
au pays
Le code pays ou le code postal du destinataire est
incorrect pour le code produit fourni
Le numéro de portable du destinataire n'a pas été
transmis
Le numéro de portable du destinataire est incorrect
Le courriel du destinataire n'a pas été transmis
Le courriel du destinataire est incorrect
Le poids du colis n'a pas été transmis
Le poids du colis est incorrect
La valeur du champ hors gabarit est incorrecte
L'option recommandation est incorrecte
L'option valeur assurée est incorrecte
Le niveau de recommandation n'a pas été transmis
Le niveau de recommandation est incorrect
Les options ne permettent pas d’effectuer un
étiquetage
Le synonyme du code produit est vide
Le code pays ne permet pas d’effectuer un
étiquetage
Les options ne permettent pas d’effectuer un
étiquetage
Le partenaire XXX ne gère pas le code produit
YYY
XXX : partenaire retourné par le routing
YYY : le code produit passé en entrée du ws
Le numéro de colis est incorrect
Le type de choix retour n'a pas été transmis
Le type de choix retour est incorrect
L'option avis de réception est incorrecte
L'option Franc de Taxes et de Droits est incorrecte
Le numéro de colis n'a pas été transmis
Le code point de retrait n'a pas été transmis
Le code point de retrait est incorrect
Le code ou l’adresse point de retrait n'a pas été
transmis
Le contenu du colis n’a pas été transmis
La catégorie de l’envoi n’a pas été transmise
La catégorie de l’envoi est incorrecte
Les articles contenus n’ont pas été transmis
Le nombre d’articles est supérieur au maximum
Le poids total des articles est supérieur au poids
du colis
31
Code
30510
30511
30512
30513
30514
30515
30516
30517
30518
30519
30520
30521
30522
30523
30524
30528
30525
30529
Type
ERROR
ERROR
ERROR
ERROR
ERROR
ERROR
ERROR
ERROR
ERROR
ERROR
ERROR
ERROR
ERROR
ERROR
ERROR
ERROR
ERROR
ERROR
30530
ERROR
30533
30531
ERROR
ERROR
30532
30534
30535
30536
ERROR
ERROR
ERROR
ERROR
30537
ERROR
30538
ERROR
30539
30540
ERROR
ERROR
30541
30542
30543
30544
30546
ERROR
ERROR
ERROR
ERROR
ERROR
30547
ERROR
30548
30549
30550
ERROR
ERROR
ERROR
30551
ERROR
30552
30553
ERROR
ERROR
30554
ERROR
Commentaire
La description d'un article n'a pas été transmise
La description d'un article est incorrecte
La quantité d'un article n'a pas été transmise
La quantité d'un article est incorrecte
Le poids d'un article n'a pas été transmis
Le poids d'un article est incorrect
La valeur d'un article n'a pas été transmise
La valeur d'un article est incorrecte
Le numéro tarifaire d'un article n'a pas été transmis
Le numéro tarifaire d'un article est incorrect
Le pays d'origine d'un article n'a pas été transmis
Le pays d'origine d'un article est incorrect
La Référence de l'article n'a pas été transmise
Le nombre max d’articles est dépassé (10 max)
La devise n'a pas été transmise
Le numéro de colis d'origine n’a pas été transmis
Le numéro de colis d’origine est incorrect
Le numéro de facture d'origine n’a pas été
transmis
La date de la facture d'origine n’a pas été
transmise
La date de facture d’origine doit être antérieure à la date du jour
Le nombre max de colis d’origine est dépassé ( 5
max )
Le numéro de facture est incorrect
L’identifiant du document est incorrect
La référence importateur est incorrecte
valeur de marchandises supérieure au seuil
autorisé
La devise doit être identique pour l’ensemble des
articles du colis
Le code pays doit être identique pour l’ensemble
des articles du colis
Le commentaire est trop long
Le poids total des articles contenus dans votre
envoi ne peut être supérieur au poids initialement
déclaré pour le colis.
Un seul identifiant document doit être transmis
La catégorie de l'envoi est incorrecte
La Référence de l'article est incorrecte
La devise est incorrecte
Identifiant de facture et colis original n’a pas été
transmis
Identifiant de facture et colis original inconnu ou
incorrect
Article non rattaché à un colis et une facture
L’identifiant du colis et facture existe déjà
Il existe des doublons dans la liste des colis origine
déclarée
La référence importateur n’a pas été transmise
Commentaire n’a pas été transmis
La date de facturation doit être identique pour un même
numéro de facture. Veuillez saisir une nouvelle date.
Au moins une déclaration de colis origine doit être
32
Code
Type
Commentaire
transmise.
30600
ERROR
30700
ERROR
30701
30702
ERROR
ERROR
30703
ERROR
Le champ {0} contient un caractère {1} non valide.
Veuillez saisir à nouveau ce champ.
{0} : Nom du champ
{1} : caractères interdits
Le produit demandé n’existe pas dans le compte
client
La plage utilisée est incorrecte
Ce numéro de colis a déjà été attribué à un colis il
y a moins de 13 mois
La présence ou l’absence d’indication de plage
n’est pas conforme à la solution souscrite.
Le produit transmis ne permet pas d'effectuer un
service retour depuis l'international.
Le pays transmis n'est pas habilité à proposer le
service retour depuis l'international.
Veuillez activer le dépôt en boite à lettres dans
votre Back Office
Colis inexistant
Le colis n’a pas été annoncé auprès de La Poste
Ce colis a déjà été pris en charge
Le colis a déjà été pris en charge par La Poste
Vous avez déjà pris rendez-vous
Le colis a déjà fait l’objet d’une demande de
d’emport en boite à lettres
Le produit retour n’est pas déposable en boite à
lettre
Le service de dépôt en boite à Lettres n’est pas
disponible
Ce colis ne peut pas être déposé en boite à lettre
L’adresse ne permet pas de faire une demande
d’emport de colis déposé en boite à lettres
La date d’emport demandée est incorrecte
La date d’emport demandée ne fait pas partie des
prochaines date d’emport possibles à cette
adresse
30704
30705
30800
30801
30802
ERROR
ERROR
ERROR
ERROR
ERROR
ERROR
30803
ERROR
30804
ERROR
30805
ERROR
30806
30807
ERROR
30808
ERROR
30809
ERROR
30810
ERROR
30811
30812
ERROR
ERROR
30813
30814
30815
30816
ERROR
ERROR
ERROR
ERROR
Le colis n’est pas autorisé à un dépôt en boîte aux
lettres
Date emport invalide: vous n’avez pas activé le
dépôt en boîte aux lettres dans votre Back Office
Veuillez ne pas indiquer de date d’emport si vous
avez choisi l’option : étiquette non déposable en
boîte aux lettres
Demande d’emport boîte aux lettres invalide :
colis non déposable en boîte aux lettres
La date d’emport demandée est incorrecte
Aucune date d’emport trouvée pour cette adresse
L’adresse ne permet pas de faire une demande
d’emport de colis déposé en boite à lettres
La date d'emport n'a pas été transmise
Le nombre max de colis dépassé
Le nombre max de dates d'enlèvement dépassé
Impossible d'effectuer un dépôt en BAL avec les
33
Code
30900
30901
30902
30903
30904
40011
40012
40013
40014
40015
40016
40017
40018
14040
ROUTING_1
ROUTING_2
ROUTING_3
ROUTING_4
ROUTING_5
ROUTING_6
ROUTING_7
ROUTING_8
ROUTING_9
ROUTING_0
ROUTING_12
ROUTING_13
ROUTING_14
ROUTING_15
ROUTING_16
ROUTING_17
ROUTING_18
ROUTING_19
Type
Commentaire
informations transmises. Un dépôt en BP est forcé
ERROR
Le nom du point retrait n'a pas été transmis
ERROR
L’adresse du point retrait n'a pas été transmise
ERROR
Le code postal du point retrait n'a pas été
transmis
ERROR
La ville du point retrait n'a pas été transmise
ERROR
Le code pays du point retrait n'a pas été transmis
ERROR
Erreur: code pays de destination du colis incorrect
ERROR
Erreur: Pays non ouvert au service Retour
Colissimo International ou incorrect. Contacter
votre support client
ERROR
Erreur: Relation pays expéditeur et pays de
destination non ouverte ou incorrecte. Contacter
votre support client
ERROR
Erreur: Plage de numéros de colis épuisée.
Contacter votre support client
ERROR
Service momentanément indisponible
ERROR
Problème de paramétrage de seuil. Le pays d’origine
{0} n’existe pas
ERROR
Les
informations
transmises
semblent
incohérentes : impossible de réaliser un
affranchissement. Merci de contacter le support
client si le problème persiste.
ERROR
Service non disponible. Contacter votre support
client.
ERROR
Les options assurance et recommandation ne
sont pas compatibles. Veuillez sélectionner une
ou l'autre de ces options.
Erreurs d’acheminement international
ERROR
Le service n'est pas dans la base de données.
ERROR
Le pays n'est pas dans la base de données.
ERROR
Le dépôt n'est pas dans la base de données.
ERROR
Le format de la date d'envoi est invalide.
ERROR
Le format du code postal saisi ne correspond pas
au masque de code postal du pays.
ERROR
Le code postal saisi n'est pas compris entre les
limites inférieures / supérieures du pays.
ERROR
Les valeurs de limites de code postal pour la ville
et la région ne sont pas renseignées.
ERROR
Le code postal ne correspond pas aux données
d'entrée de la région / vile.
ERROR
Le code postal du pays n'existe pas.
ERROR
Le code postal de la zone et de la ville n'existe
pas.
ERROR
Le groupe associé à ce site n'existe pas.
ERROR
L'adresse associée au site n'existe pas.
ERROR
Il n'y a pas de pays associé au site.
ERROR
Le réacheminement douanes n'existe pas.
ERROR
Le code dépôt est obligatoire. Veuillez saisir une
valeur.
ERROR
Le code pays est obligatoire. Veuillez saisir une
valeur.
ERROR
Il n'y a pas d'acheminement pour ces données.
ERROR
Il existe plusieurs acheminements pour ces
34
Code
Type
ROUTING_20
ERROR
ROUTING_21
ROUTING_22
ROUTING_23
ROUTING_24
ERROR
ERROR
ERROR
ERROR
ROUTING_25
ERROR
ROUTING_26
ROUTING_27
ROUTING_200
ERROR
ERROR
ERROR
ROUTING_201
ROUTING_202
ROUTING_203
ROUTING_204
ROUTING_205
ROUTING_206
ERROR
ERROR
ERROR
ERROR
ERROR
ERROR
ROUTING_207
ROUTING_208
ERROR
ERROR
ROUTING_211
ERROR
ROUTING_212
ERROR
ROUTING_300
ROUTING_301
ERROR
ERROR
ROUTING_302
ERROR
ROUTING_305
ERROR
ROUTING_1005
ERROR
ROUTING_1006
ERROR
ROUTING_1007
ROUTING_1008
ERROR
ERROR
ROUTING_1100
ERROR
Commentaire
données.
Cette option n'est pas autorisée pour cet
acheminement.
Les données saisies n'autorisent pas cette option.
L'option est obligatoire. Veuillez saisir une valeur.
La requête a échoué.
La requête a échoué. La connexion est hors
service.
La requête a échoué. La connexion est hors
service
Le pays d'origine n'existe pas.
Le pays de destination n'existe pas.
L'acheminement Fedex pour ce pays est
suspendu.
Ce pays est sous embargo.
Ce code pays est obsolète.
Ce pays n'est pas géré par Fedex.
L'acheminement Fedex n'a pas été trouvé.
Le code barre Fedex n'a pas été trouvé.
La fonction déchargement Fedex n'a pas été
trouvée.
Le fichier Fedex n'a pas été trouvé.
Plus d'une combinaison Code Postal / Site sont
nécessaires pour l'acheminement manuel.
L'interface de programmation Fedex ne peut pas
être chargée.
L'interface de programmation a renvoyé une
erreur.
L'initialisation du composant TNT a échoué.
Il n'y a pas de produit TNT associés à ce produit
Geopost.
Il n'y a pas de site de destination associé à ce site
Geopost.
Il n'y a pas de site d'origine associé à ce site
Geopost.
Le fichier d'initialisation de l'acheminement n'a pas
pu être ouvert.
Le fichier d'initialisation de l'acheminement ne
contient pas le tag obligatoire.
Le DLL SQLite ne peut pas être chargé.
La connexion à la base de données n'a pas pu être
initialisée.
ATTENTION : La base de données a expiré, et il
n'y a pas de base de substitution valide disponible.
Dans le cas où la requête SOAP ne respecte pas le xsd défini dans le wsdl, le Framework axis
retourne une erreur dans la réponse :
Cas 1 : Date invalide
<soap:Body>
<soap:Fault>
<faultcode>soap:Client</faultcode>
<faultstring>Unmarshalling Error: 2x015-03/23</faultstring>
</soap:Fault>
</soap:Body>
35
</soap:Envelope>
Cas 2 : Boolean invalide
<soap:Body>
<soap:Fault>
<faultstring>Unmarshalling Error: cvc-datatype-valid.1.2.1: 'eeee' is not a valid value
for 'boolean'.</faultstring>
</soap:Fault>
</soap:Body>
</soap:Envelope>
Cas 3 : Donnée obligatoire non renseignée :
<soap:Body>
<soap:Fault>
<faultstring>Unmarshalling Error: cvc-complex-type.2.4.a: Invalid content was found
starting with element 'city'. One of '{zipCode}' is expected.</faultstring>
</soap:Fault>
</soap:Body>
</soap:Envelope>
36
VI. Annexe 2 : éditions
VI.1 Affichage des données sur les étiquettes
Les données transmises au Web Service ne sont pas toutes affichées sur l’étiquette générée.
Elles peuvent également être tronquées, pour des questions de place d’affichage sur
l’étiquette, mais une donnée tronquée reste transmise dans son intégralité au sein du
système d’information de La Poste Colissimo.
Les limites de troncage des données varient selon les formats d’impression (thermique ou
bureautique) ou selon nos produits.
VI.2 Partie droite de l’étiquette (format A4 seulement)
La partie droite du bordereau de transport sert d’espace de communication entre l’emarchand et son client. Elle se compose de 3 parties :
Les éléments de l’étiquette peuvent évoluer.
Description des zones :
1. Emplacement logo « Colissimo » : pour les offres Colissimo avec preuve de dépôt et
Retour Colissimo, ce logo peut être personnalisé à partir de l’Espace Entreprises.
2. Instructions d’utilisation de l’étiquette : pour l’offre Retour Colissimo, le contenu de ce
bloc varie selon les options de livraison (cf. plus bas)
3. Preuve de dépôt (disponible selon contrat): récapitulatif à faire aviser par La Poste lors
du dépôt du colis
37
Pour l’offre Retour Colissimo, le bloc #2 varie selon les options de livraison :

Modèle 1 - Pour un dépôt en Bureau de poste ou en commerce
Ce bordereau est délivré par La Poste si l’adresse de l’expéditeur ne lui permet pas d’accéder
au service d’expédition depuis sa boîte aux lettres personnelle.

Modèle 2 - Pour un dépôt en Bureau de poste ou en commerce ou en boîte
aux lettres (date d’emport non choisie)
Ce bordereau est délivré par La Poste si l’adresse de l’expéditeur lui permet d’accéder au
service d’expédition depuis sa boîte aux lettres personnelle.

Modèle 3 - Pour un dépôt demande d’emport en boîte aux lettres (date
choisie)
Ce bordereau est délivré par La Poste si l’adresse de l’expéditeur lui permet d’accéder au
service d’expédition depuis sa boîte aux lettres personnelle, et que l’e-marchand a intégré la
demande d’emport boîte aux lettres sur son site e-commerce.
La date d’emport du colis en boîte aux lettres est alors indiquée sur la partie droite du
bordereau
38
Chaque remise de colis doit être accompagnée d’un bordereau récapitulatif contenant les
informations listées dans les paragraphes suivants.
VI.3 Modèle du bordereau de remise
SITE DE PRISE EN CHARGE : XXXXXX
LIBELLE SITE DE PRISE EN CHARGE : XXXXXXXXXXXXXXX
N° CLIENT
:
BORDEREAU DE REMISE Offre Entreprises Colissimo
XXXXXX
EDITE LE JJ/MM/AAAA
LIBELLE CLIENT
:
NOM CLIENT
N° BORDEREAU
:
0000000001 DU JJ/MM/AAAA
Réf. exped
Nom et Adresse destinataire
N° colis
CPOST
CPAYS Poids
(KG)
NM
XXXXX
IT
0
COLISSIMO EXPERT INTER - compte de facturation : XXXXXX
xxxxxxxxxxxx
XXXXXXXXXXXXXXXXXXXX
XXXXXXXXXXXX
01.00
SIGNATURE DE L’AGENT (*)
NOMBRE DE COLIS DE LA PAGE
POIDS DES COLIS DE LA PAGE
: XX
: XX
NOMBRE TOTAL DE COLIS
POID TOTAL DE COLIS
: XX
: XX
DATE
* Cette signature ne vaut pas validation
des données indiquées par le client
Nombre de page : 1
Page n°1
39
VI.4 Contenu du bordereau
Titre du document
Site Prise en charge :
Libellé site de prise en
charge :
N° Bordereau :
Date :
N° Client :
Réf. expéditeur :
« Bordereau de remise Offre Entreprises Colissimo »
Code d’identification (REGATE) du site de prise en charge (6
caractères numériques)
 attribué au client
Libellé en clair du site de prise en charge (40 car. Alphabétiques),
donné par l’interlocuteur commercial.
Numéro séquentiel du bordereau de remise (ce numéro doit être
continu) (10 caractères numériques)
Date d’émission du bordereau : Date d'émission du bordereau
(JJ/MM/AAAA).
Cette date est considérée par La Poste - Colissimo comme la date
de remise physique des colis
Important : cette date doit correspondre à la date réelle de dépôt
physique des colis sur le site d’entrée du trafic.
Identifiant du client ; Il s’agit du N° de Client fourni par La Poste Colissimo sur 6 caractères
N° identifiant l’envoi de ce colis dans votre système propre (si
vous le souhaitez)
[35 caractères alphanumériques].
Nom et Adresse
destinataire :
Nom et Adresse du client destinataire (si souhaitée).
N° Colis :
Numéro de colis complet trié par ordre croissant.
CPOST
Code postal
CPAYS
Code pays
Poids :
Poids du colis en kg (< ou = 30 kg).
NM :
Zone à “ 1 “ si le colis n’est pas mécanisable, à “ 0 “ s’il est
mécanisable
Nombre de colis de la page Total du nombre de colis figurants sur la page
Poids des colis de la page
Nombre Total de colis
Poids total des colis
Nombre de pages
ZONE RESERVEE
Page :
Total des poids des colis figurants sur la page
Total du nombre de colis figurants sur le bordereau de remise et
remis à La Poste - Colissimo.
Total des poids des colis figurants sur le bordereau de remise et
remis à La Poste - Colissimo.
Total nombre de pages constituant le bordereau de remise
Réserver une zone pour la signature de l’agent de La Poste Colissimo et le Timbre A Date.
N° page en cours sur nombre total de pages, ou N° de page avec
mention “dernière page” sur la dernière page.
Remarque :
Le bordereau de remise est nécessaire pour les destinations avec CN23 uniquement.
Le client peut l’éditer via ses propres moyens ou via le Back-Office si l’option a été
demandée auprès de votre commercial (uniquement pour certains produits).
40
VII.
Annexe 3 : exemples d’enveloppes SOAP
VII.1 Méthode getProductInter

Requête XML en entrée de la méthode getProductInter
<sls:getProductInter>
<getProductInterRequest>
<contractNumber>800148</contractNumber>
<password>PWD991</password>
<productCode>COLI</productCode>
<insurance>0</insurance>
<nonMachinable>0</nonMachinable>
<returnReceipt>0</returnReceipt>
<countryCode>DZ</countryCode>
<zipCode>2000</zipCode>
</getProductInterRequest>
</sls:getProductInter>

Réponse XML en sortie de la méthode getProductInter
<return>
<messages>
<id>0</id>
<messageContent>La requête a été traitée avec succès</messageContent>
<type>INFOS</type>
</messages>
<product>CP</product>
<partnerType>1</partnerType>
<returnTypeChoice>2</returnTypeChoice>
</return>
VII.2 Méthode generateLabel

Requête XML en entrée :
<sls:generateLabel>
<generateLabelRequest>
<password>PWD991</password>
<outputFormat>
<x>0</x>
<y>0</y>
<outputPrintingType>PDF_A4_300dpi</outputPrintingType>
<returnType></returnType>
</outputFormat>
<letter>
41
<service>
<productCode>A2P</productCode>
<depositDate>2015-12-23</depositDate>
<mailBoxPicking>false</mailBoxPicking>
<transportationAmount>1040</transportationAmount>
<totalAmount>1222</totalAmount>
<orderNumber>123456</orderNumber>
<commercialName>MONSITE.COM</commercialName>
</service>
<parcel>
<weight>1</weight>
<nonMachinable>false</nonMachinable>
<instructions>REMETTRE AU GARDIEN</instructions>
<pickupLocationId>005737</pickupLocationId>
</parcel>
<customsDeclarations>
<includeCustomsDeclarations>1</includeCustomsDeclarations>
<contents>
<article>
<description>desc</description>
<quantity>1</quantity>
<weight>1</weight>
<value>12</value>
<hsCode>010203</hsCode>
<originCountry>FR</originCountry>
</article>
<category>
<value>2</value>
</category>
</contents>
</customsDeclarations>
<sender>
<senderParcelRef>refsenderXXX</senderParcelRef>
<address>
<companyName>sender company</companyName>
<lastName>dupont</lastName>
<firstName>fred</firstName>
<line0>etage</line0>
<line1>entrée</line1>
<line2>ligne principale</line2>
<line3>lieu dit</line3>
<countryCode>FR</countryCode>
<city>paris</city>
<phoneNumber>0123456789</phoneNumber>
<mobileNumber>0677777777</mobileNumber>
<doorCode1>12ZZ2</doorCode1>
<doorCode2>121FD</doorCode2>
<email>[email protected]</email>
<intercom>99009</intercom>
<language>FR</language>
</address>
42
</sender>
<addressee>
<addresseeParcelRef>12345</addresseeParcelRef>
<codeBarForReference>false</codeBarForReference>
<serviceInfo>service info</serviceInfo>
<promotionCode></promotionCode>
<address>
<companyName>comp dest</companyName>
<lastName>martin</lastName>
<firstName>alain</firstName>
<line0>etage</line0>
<line1>entree</line1>
<line2>adresse</line2>
<line3>lieu dit</line3>
<city>paris</city>
<phoneNumber>0133223345</phoneNumber>
<mobileNumber>0623456789</mobileNumber>
<doorCode1>3454</doorCode1>
<doorCode2>ZA22</doorCode2>
<intercom>324RR</intercom>
<language>FR</language>
</address>
</addressee>
</letter>
</generateLabelRequest>
</sls:generateLabel>

Réponse XML :
Un lien URL vers le PDF est retourné
<return>
<messages>
<id>0</id>
<type>INFOS</type>
</messages>
<labelResponse>
<label>MTQgMCBvYmoKPMTQgMCBvYmoKP..
<parcelNumber>6M00014522109</parcelNumber>
<pdfUrl>http://ws.colissimo.fr/xxx/shippingclpV3/GetLabel?parcelNumber=
6M00014522109&signature=099a6ac2f294a103db409fcd248fd8bb3b75e3d9c1f76d31996276b4d2
ce87d5&includeCustomsDeclarations=false</pdfUrl>
</labelResponse>
</return>
43
VII.3 Méthode getListMailBoxPickingDates

Requête XML en entrée de la méthode getListMailBoxPickingDates
<getListMailBoxPickingDatesRetourRequest>
<password>ABCDEF</password>
<sender>

<line0></line0>

<line1></line1>

<line2>12 rue des fleurs</line2>

<line3></line3>


<city>PARIS</city>
</sender>
</getListMailBoxPickingDatesRetourRequest>

Réponse XML en sortie de la méthode getListMailBoxPickingDates
<getListMailBoxPickingDatesRequest>
<messages>
<id>0</id>
<type>INFOS</type>
</messages>
<mailBoxPickingDateMaxHour>08h00</mailBoxPickingDateMaxHour>
<mailBoxPickingDates>2015-02-18T00:00:00+01:00</mailBoxPickingDates>
<mailBoxPickingDates>2015-02-19T00:00:00+01:00</mailBoxPickingDates>
<validityTime>23h00</validityTime>
</getListMailBoxPickingDatesRequest>
VII.4 Méthode planPickup

Requête XML en entrée de la méthode planPickup
<sls:pickMailBoxing>

<arg0>
<password>ABCDEF</password>
<parcelNumber>8R99999999999</parcelNumber>

<mailBoxPickingDate>2015-02-18</mailBoxPickingDate>
<sender>
44

<companyName></companyName>

<lastName>DUPONT</lastName>

<firstName>Albert</firstName>

<line0></line0>

<line1></line1>

<line2>12 rue des plantes</line2>

<line3></line3>

<city>Paris</city>



<phoneNumber></phoneNumber>
</sender>
</arg0>
</sls:pickMailBoxing>

Réponse XML en sortie de la méthode planPickup
<ns2:pickMailBoxingResponse xmlns:ns2="http://sls.ws.coliposte.fr">
<pickMailBoxingRequest>
<messages>
<id>0</id>
<messageContent>La requête a été traitée avec
succès</messageContent>
<type>INFOS</type>
</messages>
</pickMailBoxingRequest>
</ns2:pickMailBoxingResponse>
45

NOTE INTERNE - Colissimo

Transcription

Documents pareils

voir le condition de livraison

PDF TARIF MAI-FR-V21.indd

bon de commande

OFFRE Internationale

bon de retour

livraison gratuite

poêlee de pommes de terre sarladaise cuite, surgelee

Tarifs So Colissimo

LISTE DES URLs DE TRACKING - PRESTASHOP

Livraison par la poste