Web Service d`étiquetage

Transcription

Web Service d`étiquetage
WEB SERVICE
D’ETIQUETAGE
La Poste - ColiPoste
2 – EXPEDITION / ETIQUETAGE
Solution FLEXIBILITE - Spécifications techniques
Version 3.0 - avril 2013
62 RUE CAMILLE DESMOULINS – 92441 ISSY LES MOULINEAUX CEDEX 15 – www.colissimo.fr/entreprises
RCS PARIS B 356 000 000 - Siret 356 000 000 00048 - NAF 5310 Z
I.
Introduction ............................................................................................................. 4
I.1
Objet du document ................................................................................................ 4
I.2
Format des données .............................................................................................. 4
I.3
Terminologie ........................................................................................................ 4
I.4
Introduction à SOAP .............................................................................................. 5
I.5
SOAP Côté Client................................................................................................... 6
I.6
Le Service SOAP édition des étiquettes .................................................................... 7
II.
Guide de référence de l’API SOAP ................................................................................ 8
II.1
Fonctionnalités ...................................................................................................... 8
II.2
Indisponibilité et continuité du processus d’invocation du Web Service ......................... 8
II.3
Service Web : WSColiPosteLetterService .................................................................. 9
II.4
Opération : GetLetterColissimo ............................................................................. 10
II.4.1
Requête : GetLetterColissimoRequest ................................................................ 10
II.4.2
Réponse : GetLetterReponse............................................................................. 24
III.
Codes erreurs ......................................................................................................... 25
III.1
IV.
Codes erreurs ................................................................................................. 25
Règles de gestion .................................................................................................... 29
IV.1
Couverture géographique ................................................................................. 29
IV.2
Gestion des Options ......................................................................................... 30
IV.3
Code Postal .................................................................................................... 31
IV.4
Pays .............................................................................................................. 32
IV.5
Contrôles ....................................................................................................... 32
V.
Contact .................................................................................................................. 33
VI.
Annexe 1 : WSDL .................................................................................................... 34
VII.
Annexe 2 : Etiquettes à destination de la France ..................................................... 47
VII.1
Livraison à Domicile avec Signature : « Mon domicile » avec signature .................. 47
VII.2
Livraison à Domicile sans Signature : « Mon domicile » sans signature .................. 48
VII.3
Livraison à Domicile sur RDV : « Mon rendez-vous »............................................ 49
VII.4
Livraison en Espace cityssimo : « Mon cityssimo » ............................................... 50
VII.5
Livraison en Bureau de Poste : « Mon bureau de poste » ...................................... 51
Web Service d’étiquetage
Version 3.0 – avril 2013
2
VII.6
VIII.
Livraison en Relais Commerçant : « Mon commerçant » ....................................... 52
Annexe 3 : Etiquettes à destination de la Belgique .................................................. 54
VIII.1
Livraison à Domicile sans Signature ................................................................... 54
VIII.2
Livraison à Domicile avec Signature ................................................................... 55
VIII.3
Livraison en Bureau de Poste ............................................................................ 56
VIII.4
Livraison en Relais Commerçant ........................................................................ 57
IX.
Annexe 4 : Preuve de dépôt ..................................................................................... 58
X.
Annexe 5 : Déclaration en douane CN23 .................................................................... 60
XI.
Annexe 6 : Web Service indisponible ......................................................................... 63
Web Service d’étiquetage
Version 3.0 – avril 2013
3
I.
Introduction
I.1 Objet du document
ColiPoste met un Web Service à la disposition de ses clients.
Ce Web Service permet de générer des étiquettes avec ou sans preuve de dépôt en fonction
des profils définis lors de la contractualisation de cette solution d'étiquetage.
Pour les expéditions vers l’Andorre, une déclaration CN23 sera aussi générée.
Ce document décrit les généralités du protocole SOAP utilisé ainsi que les modalités d’accès à
ce Web Service.
Abréviation
Description
JRE
Java TM Runtime Environment
XML
eXtensible Markup Language
XSL
eXtensible Stylesheet Language
XSLT
XSL Transformations
soapUI
Open source de test de Web Service
I.2 Format des données
Code
A
B
N
H
D
T
Description
Caractères alphabétiques (sans espace ni symbole de ponctuation)
Espaces
Caractères numériques décimaux de 0 à 9
Caractères numériques hexadécimaux de 0 à 9 et de A à F
Date
Heure
I.3 Terminologie
Terme
Description
Chargeur
E-marchand client de La Poste ColiPoste et invoquant le Web Service
Expéditeur
Personne physique ou morale qui appose l’étiquette de transport sur le
colis
Web Service d’étiquetage
Version 3.0 – avril 2013
4
I.4 Introduction à SOAP
Un Web Service est un programme informatique permettant la communication et l'échange
de données entre applications et systèmes hétérogènes dans des environnements distribués,
sans intervention humaine et en temps réel.
Les Web Services exposent ces fonctionnalités sous la forme de services exécutables ou
procédures distantes (Remote Procedure Call). Leurs spécifications reposent sur un protocole
d’échanges standard : SOAP (Simple Object Access Protocol).
SOAP s'appuie sur un protocole de transport (HTTP, SMTP ou POP) et un langage structurant
les données échangées sous forme de messages : XML.
Exemple de requête et réponse HTTP, contenant des messages SOAP sous la forme de code
XML "enveloppé"
Source : W3C http://www.w3.org/TR/soap/
Exemple 1 : une requête HTTP contenant du code SOAP
POST /StockQuote HTTP/1.1
Host: www.stockquoteserver.com
Content-Type: text/xml; charset="utf-8"
Content-Length: nnnn
SOAPAction: "Some-URI"
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Body>
<m:GetLastTradePrice xmlns:m="Some-URI">
<symbol>DIS</symbol>
</m:GetLastTradePrice>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Web Service d’étiquetage
Version 3.0 – avril 2013
5
Exemple 2: la réponse HTTP correspondante
HTTP/1.1 200 OK
Content-Type: text/xml; charset="utf-8"
Content-Length: nnnn
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"/>
<SOAP-ENV:Body>
<m:GetLastTradePriceResponse xmlns:m="Some-URI">
<Price>34.5</Price>
</m:GetLastTradePriceResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
I.5 SOAP Côté Client
Il est préférable de disposer d’une « implémentation client » pour accéder à un Web Service
SOAP.
En voici une liste non exhaustive et qui concerne les langages les plus courants :
Implémentation Client
Langage
Java
.Net (C#, VB.Net,
ASP.Net)
Perl
C++
PHP
Python
Web Service d’étiquetage
Version 3.0 – avril 2013
Implémentation client SOAP
Apache Axis : http://ws.apache.org/axis/index.html
Microsoft SOAP Toolkit : http://msdn.microsoft.com/webservices/
SOAP::Lite : http://www.soaplite.com/
Apache Axis C++ : http://ws.apache.org/axis/cpp
gSOAP C++ : http://www.cs.fsu.edu/~engelen/soap.html
SOAP C++ SQLData :
http://www.sqldata.com/soapclient/soapclient30.htm
PHP-SOAP : http://phpsoaptoolkit.sourceforge.net/phpsoap/
PEAR SOAP Client/Server for PHP :
http://pear.php.net/package/SOAP
Python Web Services : http://pywebsvcs.sourceforge.net/
6
I.6 Le Service SOAP édition des étiquettes
Implémentation Client
ColiPoste propose un service SOAP, permettant d'éditer l’étiquette d’un colis.
Ce service est accessible à l’adresse :
https://ws.colissimo.fr/soap.shippingclpV2/services/WSColiPosteLetterService
Utilisation du service
Ce service nécessite l’utilisation de votre numéro de contrat ColiPoste et de votre mot de
passe, disponibles auprès de votre interlocuteur commercial La Poste ColiPoste usuel.
Ces informations vous permettent également d’accéder à votre espace client sous
http://www.colissimo.fr/entreprises.
Cet espace vous permet via le Back Office de la solution d’expédition « Flexibilité » :
• d’accéder aux mises à jour des guides d’intégration et d’utilisation
• de configurer votre preuve de dépôt (voir détail en annexe 4)
ou
• d’éditer vos bordereaux de transport suivant l’option que vous avez contractualisée
Pour plus d’informations, voir le Guide d’utilisation de la solution d’expédition « Flexibilité ».
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é.
Web Service d’étiquetage
Version 3.0 – avril 2013
7
II. Guide de référence de l’API SOAP
II.1 Fonctionnalités
Le document généré et imprimé est composé d'une partie étiquette apposée sur le colis
(comportant un ou plusieurs codes barres) et, suivant le profil contractualisé, d'une partie
preuve de dépôt conservée par le client.
La composition de l'étiquette varie en fonction du mode de livraison des colis et du pays de
destination, à savoir :
• Livraison à domicile avec signature : « mon domicile » (avec signature)
• Livraison à domicile sans signature : « mon domicile » (sans signature)
• Livraison à domicile sur RDV : « mon rendez-vous »
• Livraison en Cityssimo : « mon espace cityssimo »
• Livraison en bureau de poste : « mon bureau de poste »
• Livraison en relais commerçant : « mon commerçant »
Le modèle des étiquettes est présenté en Annexe 2 et 3 de ce document.
II.2 Indisponibilité et continuité du processus d’invocation
du Web Service
En sus des mécanismes de supervision des infrastructures applicatives et matérielles qui ne
garantissent pas par eux-mêmes la disponibilité de l’ensemble de la chaine de traitement, la
Poste ColiPoste recommande aux chargeurs la mise en œuvre :
• d’un contrôle préalable à l’invocation du Web Service
et/ou
• de l’activation d’un mode dit « dégradé » en cas de non réponse, basé par exemple
sur la proposition d’une relance de l’invocation du Web Service.
Pour ce faire, La Poste ColiPoste met à disposition des chargeurs, une URL de supervision
permettant de vérifier si le Web Service est disponible.
L’url
de
supervision
fournie
par
La
Poste
ColiPoste
http://ws.colissimo.fr/supervisionWSShipping/supervision.jsp
est
la
suivante:
Cette page affiche [OK] si le service est opérationnel.
Elle affiche [KO] dans le cas contraire.
La vérification de disponibilité du service consiste en l’appel de la page de supervision par le
chargeur suivi de la recherche de la chaîne de caractère [OK] dans cette page.
Web Service d’étiquetage
Version 3.0 – avril 2013
8
II.3 Service Web : WSColiPosteLetterService
L’invocation du Web Service par le client s’effectue via une requête HTTP encapsulant une
demande d'édition d’étiquette de transport au format PDF pour impression par le client.
Ce Web Service n’est pas à présenter à votre client, mais il permet l’intégration simplifiée du
service So Colissimo dans votre système d’informations.
La création de l’étiquette de transport s’accompagne d’un service d’attribution d’identifiant de
colis. Cet identifiant de colis sera présenté dans le champ parcelNumber de la réponse.
L’étiquette fournie par le Web Service se présente sous la forme d’un PDF accessible via l’url
transmise dans les données retournées par le Web Service.
Nom :
Namespace :
WSColiPosteLetterService
http://ws.retour.coliposte.telintrans.fr
Port
Port :
Url :
WSColiPosteLetterService
Production : https://ws.colissimo.fr/soap.shippingclpV2/services/WS
ColiPosteLetterService
WSDL :
Production : https://ws.colissimo.fr/soap.shippingclpV2/services/WS
ColiPosteLetterService?wsdl
Protocole
Style :
Transport :
SOAP
document
SOAP over HTTP
Opération
Elle définit l'action supportée par le Web Service :
Opération
Description
getLetterColissimo
Permet l'édition d'une étiquette.
Echanges
Ils définissent le format des requêtes/réponses associées à l'opération décrite ci-dessus :
Requêtes
Réponses
getLetterColissimoRequest
getLetterResponse
Lorsqu'un appel est effectué via l'API SOAP, un message de requête est envoyé à la
plateforme de Web Service et un message de retour est alors renvoyé.
Web Service d’étiquetage
Version 3.0 – avril 2013
9
II.4 Opération : GetLetterColissimo
Cette fonction retourne le contenu d'un fichier PDF, représentant la lettre de transport à coller
sur votre colis.
II.4.1 Requête : GetLetterColissimoRequest
Diagramme
Figure 1 - Paramètres en entrée 1
Web Service d’étiquetage
Version 3.0 – avril 2013
10
Figure 2 - Paramètres en entrée 2
Web Service d’étiquetage
Version 3.0 – avril 2013
11
Figure 3 - Paramètres en entrée 3
Web Service d’étiquetage
Version 3.0 – avril 2013
12
Figure 4 - Paramètres en entrée 4
Figure 5 - Paramètres en entrée 5
Web Service d’étiquetage
Version 3.0 – avril 2013
13
Figure 6 - Paramètres en entrée 6
Web Service d’étiquetage
Version 3.0 – avril 2013
14
Les paragraphes ci-dessous décrivent les données à renseigner pour chacune des classes du
diagramme.
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
« Error » de la réponse.
Letter : Identification du chargeur
Elément XML
ContractNumber
Password
Type XSD
xsd:int
Format XSD
[0-9]{6}
xsd:string
Obliga
toire
x
x
Description
Identifiant du client
Il s'agit du n° de client
fourni par La Poste
ColiPoste sur 6 caractères.
Numéro du client
remettant les colis, ce
numéro vous a été
communiqué à l'ouverture
de votre compte client
Mot de passe
Le mot de passe doit être
identique à celui de votre
espace client
Service Call ContextV2 : Contexte de l’appel de service
Elément XML
DateDeposite
DateValidation
ReturnType
Web Service d’étiquetage
Version 3.0 – avril 2013
Type XSD
Format XSD
xsd:dateTime
YYYY-MMDDTHH:MM:S
S.SSSZ
YYYY-MMDDTHH:MM:S
S.SSSZ
xsd:dateTime
RequestTypeV
O
voir
RequestTypeV
O
Obliga
toire
x
x
Description
Date
dépôt
prévisionnelle
de
Date de validité du colis
Pour l’offre SO, la date de
validité doit correspondre
à la date du jour + 7 jours
calendaires.
En cas de dépôt postérieur
aux 7 jours calendaires, le
colis sera refusé.
Type de retour de réponse
Pour l'offre SO, il faut
utiliser CreatePDFFile.
Le PDF sera accessible
pendant
7
jours
calendaires à compter de
la génération de l’étiquette
via l’url transmise dans les
données retournées par le
Web Service.
15
ServiceType
Crbt
VATCode
VATPercentage
VATAmount
TransportationAmo
unt
TotalAmount
PortPaye
commandNumber
MotiveBack
Logo-co-brande
CommercialName
languageConsignor
Web Service d’étiquetage
Version 3.0 – avril 2013
xsd:string
[a-zA-Z09]{1,20}
x
xsd:boolean
[0|1]
x
xsd:int
[0|1|2]
xsd:int
[0-9]*
xsd:int
[0-9]*
xsd:int
[0-9]*
xsd:int
[0-9]*
xsd:boolean
[0|1]
xsd:string
[a-zA-Z09]{0,30}
xsd:string
[a-zA-Z09]{0,35}
(1)
Type de service
Egal à « SO » pour les
produits So Colissimo
Contre remboursement
Non proposé, forcer à
« false »
Code TVA.
Valeurs possibles 0, 1 ou 2
Pourcentage de TVA.
Ex :1960 pour 19,6%
Montant de la TVA en
centième d’euro.
Ex : 196 pour 1,96 EURO
Prix
du
transport
en
centième d’euro.
Ex :1450 pour 14,5 EURO
Prix TTC de l’envoi en
centième d’euro.
Ex :1450 pour 14,5 EURO
(1) Dans le cas d’un
envoi vers l’Andorre, les
frais de transport sont
obligatoires pour éditer
la déclaration CN23
Ne pas utiliser, forcer à
« false »
Numéro de commande
Affiché sur la preuve de
dépôt si l’option a été
contractualisée
Ne pas utiliser
xsd:hexBinary
Ne pas utiliser
xsd:string
[a-zA-Z09]{0,38}
xsd:string
[a-zA-Z]{2]
x
Nom commercial du client
Cette valeur peut être
distincte de l’information
« Raison sociale »
enregistrée dans les
systèmes de La Poste
ColiPoste. Le nom
commercial sert à
personnaliser les emails et
SMS envoyés au
destinataire du colis par La
Poste ColiPoste
Obligatoire pour les
produits So Colissimo.
Forcer à « FR »
Langue expéditeur
16
languageConsigne
e
partnerNetworkCo
de
xsd:string
[a-zA-Z]{2]
xsd:string
[a-zA-Z09]{0,3}
Forcer à « FR »
Langue destinataire
(1) Forcer à « R12 » en So
Colissimo International
Hors Domicile.
Code réseau partenaire.
(1)
RequestTypeVO : Type de requête
Elément XML
Type XSD
Format XSD
RequestTypeVO
xsd:string
<xsd:restriction
base="xsd:string">
<xsd:enumeration
value="CreatePDFFile" />
</xsd:restriction>
Obliga
toire
x
Description
Type de requête,
forcer à
CreatePDFFile.
ParcelVO : Informations liées au colis
Elément XML
Type XSD
Format XSD
Obliga
toire
Description
xsd: string
[0-9]{0|2}
Ne pas utiliser, forcer à
« 00 »
xsd:int
[0-9]*
Ne pas utiliser
xsd:int
[0-9]*
xsd:string
[a-zA-Z0-9]+
Montant de l’assurance Ad
Valorem
Tranche de la valeur
assurée de l'objet :
Ex : 25000 pour 250 EURO
Ne pas utiliser pour la
destination Belgique.
InsuranceRange
InsuranceAmount
InsuranceValue
RecommendationL
evel
xsd:int
RecommendationA
mount
Web Service d’étiquetage
Version 3.0 – avril 2013
[0-9]*
Niveau de recommandation
Si le champ
« Recommendation » est à
« true », les trois niveaux
(R1, R2, R3) sont
disponibles
Ne pas utiliser pour la
destination Belgique.
Montant de l’option
recommandation en
centième d’EURO.
Ex : 250 pour 2,50 EURO
17
xsd:float
Indéfini
x
xsd:boolean
[0|1]
x
xsd:int
[0-9]*
DeliveryMod
eVO
Voir
DeliveryModeV
O
ReturnReceipt
xsd:boolean
[0|1]
Ne pas utiliser, forcer à «
false »
Recommendation
xsd:boolean
[0|1]
Recommandation,
forcer à « false »
Instructions
xsd:string
[a-zA-Z09]{0,70}
[0-9]{0,6}
Weight
HorsGabarit
HorsGabaritAmoun
t
DeliveryMode
RegateCode
xsd:int
x
(1)
Poids du colis exprimé en
Kg.
De 0. 01Kg à 30 Kg
Renseigner les
décimales uniquement
si elles sont différentes
de 0
Non mécanisable
0 si le colis est
mécanisable
1 si le colis est non
mécanisable
Valeur 0 par défaut
Montant de l’option non
mécanisable en centième
d’EURO.
Ex :380 pour 3,80 EURO
Mode de livraison.
Ne prend que les valeurs
suivantes : DOM, RDV,
BPR, ACP, CDI, A2P, MRL,
CIT, DOS, CMT, BDP
Instructions de livraison.
Identifiant du point de
retrait
(1) Dans le cas d’une
livraison hors domicile,
(DeliveryModeVO =
A2P, MRL, CIT, BPR,
ACP, CDI, CMT, BDP)
alors l’identifiant du
point de retrait est
obligatoire.
Dans le cas d’une
livraison à domicile
(DeliveryModeVO =
DOM, DOS ou RDV),
alors l’identifiant du
point de retrait doit être
vide.
Web Service d’étiquetage
Version 3.0 – avril 2013
18
Contents
ContentsVO
Voir
ContentsVO
(1)
Déclaration du contenu
pour la CN23 des colis à
destination d’Andorre
(1) Dans le cas d’un
envoi vers l’Andorre,
produits 6A (mode de
livraison : DOM) et 6C
(mode de livraison :
DOS), la description du
contenu est obligatoire
pour éditer la
déclaration CN23
ContentsVO : Contenu du colis
Elément XML
Type XSD
Format XSD
article
ArticleVO
Voir ArticleVO
categorie
CategorieVO
Voir CategorieVO
Obliga
toire
X
X
Description
Description des articles
de 1 à 10 articles
Nature de l’envoi
ArticleVO : Description des articles du colis
Elément XML
Type XSD
Format XSD
description
ArticleVO
[ a-zA-Z09]{1,64}
quantite
xsd:int
[0-9]*
X
Nombre d’articles de ce
type
poids
xsd:float
Indéfini
X
valeur
xsd:float
Indéfini
X
Poids net unitaire des
articles de ce type exprimé
en kg
De 0. 01Kg à 30 Kg
Renseigner les
décimales uniquement
si elles sont différentes
de 0
Valeur unitaire des articles
de ce type en EURO
Renseigner les
décimales uniquement
si elles sont différentes
de 0
Web Service d’étiquetage
Version 3.0 – avril 2013
Obliga
toire
X
Description
Type d’article
19
numTarifaire
xsd:string
[0-9]{0|6}
(1)
paysOrigine
xsd:string
[ A-Z]{2}
(1)
Numéro tarifaire de ce
type d’article
(1) Dans le cas d’un
envoi commercial, le
numéro tarifaire est
obligatoire
Code ISO du pays d’origine
des articles de ce type
(1) Dans le cas d’un
envoi commercial, le
pays d’origine est
obligatoire
CategorieVO : Nature de l’envoi du colis
Elément XML
Type XSD
Format XSD
categorieVO
xsd:int
[1-6]{1}
Obliga
toire
X
Description
Nature de l’envoi
Valeurs possibles :
1 : Cadeau
2 : Echantillon
3 : Envoi commercial
4 : Document
5 : Autre
6 : Retour de marchandise
DeliveryModeVO : Mode de livraison du colis
Elément XML
Type XSD
Format XSD
DeliveryModeVO
xsd:string
<xsd:restriction
base="xsd:string">
<xsd:enumeration
value="DOM" />
<xsd:enumeration
value="RDV" />
<xsd:enumeration
value="BPR"/>
<xsd:enumeration
value="ACP"/>
<xsd:enumeration
value="CDI"/>
<xsd:enumeration
value="A2P"/>
<xsd:enumeration
value="CIT"/>
<xsd:enumeration
value="DOS"/>
<xsd:enumeration
value="CMT"/>
<xsd:enumeration
value="BDP"/>
</xsd:restriction>
Web Service d’étiquetage
Version 3.0 – avril 2013
Obliga
toire
X
Description
Mode de livraison.
Ne prend que les
valeurs suivantes :
DOM, RDV, BPR, ACP,
CDI, A2P, CIT, DOS,
CMT, BDP
20
DestEnvVO : Informations liées au destinataire
Elément XML
Type XSD
Format XSD
Obliga
toire
x
Description
Alert
AlertTypeVO
Ref
xsd:string
<xsd:restriction base
= "xsd:string">
<xsd:enumeration
value = "none"/>
</xsd:restriction>
[a-zA-Z0-9]{0,15}
AddressVO
AddressVO
CodeBarForRefer
ence
xsd:boolean
Voir
AddressVO
Adresse
destinataire
[0|1]
DeliveryError
xsd:boolean
[0|1]
DeliveryInfoLine
1
DeliveryInfoLine
2
ServiceInfo
PromotionCode
xsd:string
[a-zA-Z0-9](0,40)
Ne pas utiliser, forcer
à « false »
Ne pas utiliser
xsd:string
[a-zA-Z0-9](0,40)
Ne pas utiliser
xsd:string
xsd:string
[a-zA-Z0-9](0,35)
[a-zA-Z0-9](0,15)
Ne pas utiliser
Code avoir/promotion
Ne pas utiliser
Type alerte
Ne pas utiliser, forcer
à « none »
Référence
destinataire
Ne pas utiliser
Adresse de
destination
du
Ne pas utiliser, forcer
à « false »
ExpEnvVO : Informations liées à l’expéditeur
Elément XML
Type XSD
Format XSD
Alert
AlertTypeVO
Ref
xsd:string
<xsd:restriction base
= "xsd:string">
<xsd:enumeration
value = "none"/>
</xsd:restriction>
[a-zA-Z0-9]{0,15}
AddressVO
AddressVO
Voir
AddressVO
Adresse
l’expéditeur
Obliga
toire
x
Description
Type alerte
Ne pas utiliser, forcer
à « none »
Référence chargeur
Ne pas utiliser
Adresse d'expédition.
de
AddressVO – Adresse de l’expéditeur
Elément XML
Type XSD
Format XSD
CompanyName
xsd:string
[a-zA-Z0-9]{0,35}
Web Service d’étiquetage
Version 3.0 – avril 2013
Obliga
toire
Description
Raison sociale
21
Civility
xsd:string
[a-zA-Z0-9]{0,4}
Name
Surname
xsd:string
xsd:string
[a-zA-Z0-9]{0,35}
[a-zA-Z0-9]{0,29}
Line0
xsd:string
[a-zA-Z0-9]{0,35}
Line1
xsd:string
[a-zA-Z0-9]{0,35}
Line2
xsd:string
[a-zA-Z0-9]{1,35}
Line3
xsd:string
[a-zA-Z0-9]{0,35}
CountryCode
xsd:string
[A-Z]{2}
City
PostalCode
xsd:string
xsd:string
[a-zA-Z0-9]{1,35}
[a-zA-Z0-9]{5}
PhoneNumber
xsd:string
[0-9]{0,15}
MobileNumber
xsd:string
[0-9]{0,10}
DoorCode1
xsd:string
[a-zA-Z0-9]{0,8}
DoorCode2
xsd:string
[a-zA-Z0-9]{0,8}
Interphone
xsd:string
[a-zA-Z0-9]{0,30}
Mail
xsd:string
[a-zA-Z0-9]{0,80}
x
x
x
x
Civilité
M / Mlle / Mme
Nom
Prénom
Etage, couloir,
escalier, n°
d’appartement
Entrée, bâtiment,
immeuble, résidence
Numéro et libellé de
voie
Lieu dit ou autre
mention spéciale
Code pays
« FR » pour France
« MC » pour Monaco
Commune
Code postal
Numéro de téléphone
fixe
Numéro de téléphone
portable
Code porte 1
Code de la porte
d’accès à l’immeuble
Code porte 2
Code du bâtiment
Interphone
Identifiant apposé sur
l’interphone
Adresse courriel (email)
Format :
<Texte>@<Texte>.<
Texte>
AddressVO – Adresse du destinataire
Elément XML
Type XSD
Format XSD
CompanyName
xsd:string
[a-zA-Z0-9]{0,35}
Civility
Web Service d’étiquetage
Version 3.0 – avril 2013
xsd:string
[a-zA-Z0-9]{0,4}
Obliga
toire
Description
Raison sociale
Civilité
M / Mlle / Mme
Ce champ sera utilisé
dans les courriels et
sms envoyés au
destinataire
22
x
Name
xsd:string
[a-zA-Z0-9]{1,35}
x
Surname
xsd:string
[a-zA-Z0-9]{1,29}
Line0
xsd:string
[a-zA-Z0-9]{0,35}
Line1
xsd:string
[a-zA-Z0-9]{0,35}
Line2
xsd:string
[a-zA-Z0-9]{1,35}
Line3
xsd:string
[a-zA-Z0-9]{0,35}
x
x
CountryCode
xsd:string
[A-Z]{2}
City
PostalCode
PhoneNumber
xsd:string
xsd:string
xsd:string
[a-zA-Z0-9]{1,35}
[a-zA-Z0-9]{5}
[0-9]{0,15}
x
x
(1)
MobileNumber
xsd:string
[0-9]{1,10}
DoorCode1
xsd:string
[a-zA-Z0-9]{0,8}
DoorCode2
xsd:string
[a-zA-Z0-9]{0,8}
Interphone
xsd:string
[a-zA-Z0-9]{0,30}
x
Mail
Web Service d’étiquetage
Version 3.0 – avril 2013
xsd:string
[a-zA-Z0-9]{1,80}
Nom
Ce champ sera utilisé
dans les courriels et
sms envoyés au
destinataire
Prénom
Ce champ sera utilisé
dans les courriels et
sms envoyés au
destinataire
Etage, couloir,
escalier, n°
d’appartement
Entrée, bâtiment,
immeuble, résidence
Numéro et libellé de
voie
Lieu dit ou autre
mention spéciale
Code pays
« FR » pour France
« MC » pour Monaco
« AD » pour Andorre
« BE » pour Belgique
Commune
Code postal
Numéro de téléphone
Numéro de téléphone
portable
(1) Obligatoire
uniquement à
destination de la
France (modes de
livraison RDV, CIT,
A2P, BPR)
Code porte 1
Code de la porte
d’accès à l’immeuble
Code porte 2
Code du bâtiment
Interphone
Identifiant apposé sur
l’interphone
Adresse courriel (email)
Format :
<Texte>@<Texte>.<
Texte>
23
II.4.2 Réponse : GetLetterReponse
Diagramme
Contenu
Elément XML
Type XSD
File
xsd:base64Binary
ParcelNumber
xsd:string
PdfUrl
xsd:string
Format
XSD
Description
Non utilisé dans le cadre des produits So.
[a-zAZ0-9]*
Numéro du colis
Indéfini
Lien permettant de télécharger l'étiquette
Appartient à la plage de numéros attribuée
par La Poste ColiPoste pour le code produit
correspondant
Format :
https://ws.colissimo.fr/soap.shippingclpV2/se
rvices/GetEtiquette?
parcelNumber=XXXX&date=XXXX&signature=
XXXXXXX
ErrorId
xsd:int
Indéfini
0 si aucune, sinon voir paragraphe III Codes
erreurs
Error
xsd:string
Indéfini
Description de l’erreur
Web Service d’étiquetage
Version 3.0 – avril 2013
24
III. Codes erreurs
III.1 Codes erreurs
Il s’agit des valeurs possibles de l’élément <ErrorId> présent dans la définition du type
<ReturnLetterVO>. La cause de l’erreur est décrite dans l’élément <error> associé.
0
1
100
14040
30000
30001
30002
30003
30004
30005
30006
30007
30008
30010
30011
30012
30014
30015
30017
30018
30020
30021
30023
30024
30100
30102
30103
30104
30106
30107
30108
30200
30202
30204
30206
Web Service d’étiquetage
Version 3.0 – avril 2013
La requête a été traitée avec succès
La requête a échouée
Erreur système (erreur technique)
Les options assurance et recommandation ne sont pas compatibles.
Veuillez sélectionner une
ou l'autre de ces options.
Identifiant ou mot de passe incorrect
Le numéro de compte n'a pas été transmis
Le numéro de compte est incorrect
Le mot de passe n'a pas été transmis
Le mot de passe est incorrect
Le profil de l’utilisateur n'a pas été transmis
Le profil de l’utilisateur est incorrect
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.
La date n'a pas été transmise
Le format de la date est incorrect
Le type de retour n'a pas été transmis
Le type de service n'a pas été transmis
Le type de service 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
Le montant total des frais de transport est incorrect
La langue du destinataire est incorrect
Le code réseau est incorrect
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 au pays
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
25
30207
30208
30210
30211
30212
30220
30221
30222
30223
30300
30301
30302
30303
30304
30305
30306
30308
30309
30310
30311
30312
30313
30317
30318
30319
30320
30321
30322
30323
30324
30400
30401
30500
30503
30504
30505
30506
30507
30510
30511
30512
30513
30514
30515
30516
30517
30518
Web Service d’étiquetage
Version 3.0 – avril 2013
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 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 n’a pas été transmise
La valeur du champ hors gabarit est incorrecte
Le mode de livraison n'a pas été transmis
Le mode de livraison est incorrect
L’option recommandation est incorrecte
L’option valeur assurée n'a pas été transmise
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
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 type gamme n'a pas été transmis
Le type gamme est incorrect
Le numéro de colis est incorrect
Le pays et le code produit indiqués ne sont pas compatibles
Le type de choix retour n'a pas été transmis
Le type de choix retour est incorrect
Le code point de retrait n'a pas été transmis
Le code point de retrait est incorrect
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 à 10
Le poids total des articles ne correspond pas au poids du colis
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
26
30519
30520
30521
30600
30700
30701
30702
30703
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
Le champ {0} contient un caractère {1} non valide. Veuillez saisir à
nouveau ce champ.
{0} : Nom du champ
{1} : caractères interdis (« | », « ¤ », « ; », « Æ », « æ » et
caractères ASCII 10 et 13 et du 127 au 190)
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.
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
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<soapenv:Body>
<soapenv:Fault>
<faultcode>soapenv:Server.userException</faultcode>
<faultstring>java.lang.NumberFormatException: Invalid date</faultstring>
<detail>
<ns1:hostname
xmlns:ns1="http://xml.apache.org/axis/">PBI01339</ns1:hostname>
</detail>
</soapenv:Fault>
</soapenv:Body>
</soapenv:Envelope>
Cas 2 : Boolean invalide
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<soapenv:Body>
<soapenv:Fault>
<faultcode>soapenv:Server.userException</faultcode>
<faultstring>java.lang.NumberFormatException: Invalid boolean</faultstring>
<detail>
<ns1:hostname
xmlns:ns1="http://xml.apache.org/axis/">PBI01339</ns1:hostname>
</detail>
</soapenv:Fault>
</soapenv:Body>
</soapenv:Envelope>
Web Service d’étiquetage
Version 3.0 – avril 2013
27
Cas 3 : Donnée obligatoire non renseignée :
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<soapenv:Body>
<soapenv:Fault>
<faultcode>soapenv:Server.userException</faultcode>
<faultstring>java.lang.NullPointerException</faultstring>
<detail>
<ns1:hostname
xmlns:ns1="http://xml.apache.org/axis/">PBI01339</ns1:hostname>
</detail>
</soapenv:Fault>
</soapenv:Body>
</soapenv:Envelope>
Cas 4 : DeliveryMode ou ReturnType incorrect :
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<soapenv:Body>
<soapenv:Fault>
<faultcode>soapenv:Server.userException</faultcode>
<faultstring>java.lang.IllegalArgumentException</faultstring>
<detail>
<ns1:hostname
xmlns:ns1="http://xml.apache.org/axis/">PBI01339</ns1:hostname>
</detail>
</soapenv:Fault>
</soapenv:Body>
</soapenv:Envelope>
Web Service d’étiquetage
Version 3.0 – avril 2013
28
IV. Règles de gestion
IV.1 Couverture géographique
Code
Libellé court
produit
6H
6J
6K
6C
6A
6M
CA
CB
CI
CM
So Colissimo
Mon Bureau de Poste
So Colissimo Ma
consigne Cityssimo
So Colissimo Mon
Domicile sur RDV
So Colissimo Mon
Domicile avec
signature
So Colissimo Mon
Domicile sans
signature
So Colissimo Mon
Commerçant
So Colissimo INTER
Mon Domicile sans
signature
So Colissimo INTER
Mon Domicile avec
signature
So Colissimo INTER
Mon Bureau de
Poste
So Colissimo INTER
Mon Commerçant
Web Service d’étiquetage
Version 3.0 – avril 2013
France
Cors
métropolit e
aine (hors
Corse)
OM
Andorr
e
Monaco Internation
al
Oui
Oui
Non
Non
Oui
Non
Oui
Non
Non
Non
Non
Non
Uniquement Non
Paris
Oui
Oui
Non
Non
Non
Non
Non
Oui
Oui
Non
Oui
Oui
Non
Oui
Oui
Non
Oui
Oui
Non
Non
Non
Non
Non
Non
Non
Non
Non
Oui
Non
Non
Non
Non
Non
Oui
Non
Non
Non
Non
Non
Oui
Non
Non
Non
Non
Non
Oui
(Belgique)
29
IV.2 Gestion des Options
Libellé
produit
du Avec
Sans
CRBT Valeur Poids
Hors
Recomm
signature signature
assurée maximum gabarit andation
So Colissimo
Mon Bureau de
Poste
So Colissimo
Ma consigne
Cityssimo
So Colissimo
Mon Domicile sur
RDV
So Colissimo
Mon Domicile
avec signature
So Colissimo
Mon Domicile
sans signature
So Colissimo
Mon commerçant
So
Colissimo INTER
Mon Domicile
sans signature
So
Colissimo INTER
Mon Domicile
avec signature
So
Colissimo INTER
Mon Bureau de
Poste
So
Colissimo INTER
Mon
Commerçant
Oui
Non
1500€
max
X
1
Non
Oui
Oui
Non
1500€
max
X
1
Non
Oui
Oui
Non
1500€
max
30 kg
Oui
Oui
Oui
Non
1500€
max
30 kg
Oui
Oui
Non
Non
30 kg
Oui
Non
Non
1500€
max
X
Non
Oui
Non
Non
30 kg
Oui
Non
Oui
Non
1500€
max
30 kg
Oui
Non
Oui
Non
1500€
max
X
1
Non
Non
Oui
Non
1500€
max
X
1
Non
Non
Oui
Oui
Oui
1
(1) Le poids max autorisé dépend du point de retrait.
Web Service d’étiquetage
Version 3.0 – avril 2013
30
IV.3 Code Postal
Expéditeur
Code postal
France Métropolitaine
Monaco
Code postal compris entre 01000 et 95999, ou
980XX*
*X étant des numériques
Code postal compris entre 98000 et 98099
Destinataire
Code postal
Monaco
Code postal compris entre 98000 et 98099
Corse
Code postal compris entre 20000 et 20999
Andorre
Code postal compris entre AD100 et AD700
France Métropolitaine
Code postal compris entre 01000 et 95999
Belgique
Code postal respectant le masque NNNN
L’offre SO n’est pas accessible aux codes postaux « armées » ci-dessous. Le web service
d’étiquetage retournera un message d’erreur :
Code postal
13128
13998
29240
30998
31998
33998
35998
45998
50115
56998
57998
59998
69998
83800
83998
87998
Web Service d’étiquetage
Version 3.0 – avril 2013
Commune
ISTRES ARMEES
MARSEILLE ARMEES
BREST ARMEES
NIMES ARMEES
TOULOUSE ARMEES
BORDEAUX ARMEES
RENNES ARMEES
ORLEANS ARMEES
CHERBOURG OCTEVILLE Cedex
LORIENT Cedex
METZ ARMEES
LILLE ARMEES
LYON ARMEES
TOULON ARMEES
CANJUERS Cedex
LIMOGES Cedex
31
IV.4 Pays
Expéditeur
Pays
Code ISO
France Métropolitaine
France
FR
Monaco
Monaco
MC
Destinataire
Pays
Code ISO
Monaco
France
FR
Corse
France
FR
Andorre
Andorre
AD
France Métropolitaine
France
FR
Belgique
Belgique
BE
IV.5 Contrôles
Courriel du destinataire (Code erreur 30223), le format suivant doit être respecté :
^[_A-Za-z0-9-]+(\\.[_A-Za-z0-9-]+)*@[A-Za-z0-9]+(\\.[A-Za-z0-9]+)*(\\.[A-Za-z]{2,})$
Pour un numéro de portable français :
Si le numéro commence par +33X, 0033X, +330X ou 00330X il est nécessaire de convertir le
début en 0X (où X = 6 ou 7)
Numéro de portable (Code erreur 30221), les contrôles suivants sont effectués :
-
Erreur si les deux premiers caractères sont différents de 06 ou 07.
-
Erreur s’il contient une série de 8 chiffres identiques en dernier ou se terminant par la
suite de 8 chiffres suivante : 12345678
Pour un numéro de portable belge :
Numéro de portable (Code erreur 30221), les contrôles suivants sont effectués :
-
Erreur si le numéro de téléphone portable n’est pas au format 12 caractères
numériques commençant par +324
-
Erreur s’il contient une série de 8 chiffres identiques en dernier ou se terminant par la
suite de 8 chiffres suivante : 12345678
Web Service d’étiquetage
Version 3.0 – avril 2013
32
V.
Contact
La Poste - Coliposte 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 –
Coliposte
• 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,
du lundi au vendredi, de 9h à 18h.
En cas de panne, d’anomalie ou d’incident :
• Le Centre de Service,
au 0825.086.005,
du lundi au vendredi, de 8h à 18h.
Prononcer « Incident »,
puis « Solutions Web », à 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.
Web Service d’étiquetage
Version 3.0 – avril 2013
33
VI. Annexe 1 : WSDL
<wsdl:definitions targetNamespace="http://ws.retour.coliposte.telintrans.fr"
xmlns:apachesoap="http://xml.apache.org/xml-soap"
xmlns:impl="http://ws.retour.coliposte.telintrans.fr"
xmlns:intf="http://ws.retour.coliposte.telintrans.fr"
xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
xmlns:wsdlsoap="http://schemas.xmlsoap.org/wsdl/soap/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<!--WSDL created by Apache Axis version: 1.3
Built on Oct 05, 2005 (05:23:37 EDT)-->
<wsdl:types>
<schema elementFormDefault="qualified"
targetNamespace="http://ws.retour.coliposte.telintrans.fr"
xmlns="http://www.w3.org/2001/XMLSchema">
<element name="getLetter">
<complexType>
<sequence>
<element name="letter" type="impl:LetterVO"/>
</sequence>
</complexType>
</element>
<simpleType name="RequestTypeVO">
<restriction base="xsd:string">
<enumeration value="CreatePDFFile"/>
<enumeration value="ReturnPDFInResponse"/>
<enumeration value="ReturnNoPDFInResponse"/>
<enumeration value="SendPDFByMail"/>
<enumeration value="SendPDFLinkByMail"/>
</restriction>
</simpleType>
<complexType name="ServiceCallContextVO">
<sequence>
<element maxOccurs="1" minOccurs="0" name="dateDeposite"
nillable="true" type="xsd:dateTime"/>
<element maxOccurs="1" minOccurs="0" name="dateValidation"
type="xsd:dateTime"/>
<element name="returnType" nillable="true"
type="impl:RequestTypeVO"/>
<element maxOccurs="1" minOccurs="0" name="serviceType"
type="xsd:string"/>
<element name="crbt" type="xsd:boolean"/>
<element maxOccurs="1" minOccurs="0" name="crbtAmount"
type="xsd:int"/>
<element maxOccurs="1" minOccurs="0" name="VATCode"
type="xsd:int"/>
<element maxOccurs="1" minOccurs="0" name="VATPercentage"
type="xsd:int"/>
<element maxOccurs="1" minOccurs="0" name="VATAmount"
type="xsd:int"/>
<element maxOccurs="1" minOccurs="0" name="transportationAmount"
type="xsd:int"/>
<element maxOccurs="1" minOccurs="0" name="totalAmount"
type="xsd:int"/>
<element maxOccurs="1" minOccurs="0" name="portPaye"
Web Service d’étiquetage
Version 3.0 – avril 2013
34
type="xsd:boolean"/>
<element maxOccurs="1" minOccurs="0" name="FTD"
type="xsd:boolean"/>
<element maxOccurs="1" minOccurs="0" name="FTDAmount"
type="xsd:int"/>
<element maxOccurs="1" minOccurs="0" name="returnOption"
type="xsd:boolean"/>
<element maxOccurs="1" minOccurs="0" name="returnOptionAmmount"
type="xsd:int"/>
</sequence>
</complexType>
<complexType name="ServiceCallContextV2">
<complexContent>
<extension base="impl:ServiceCallContextVO">
<sequence>
<element maxOccurs="1" minOccurs="0" name="commandNumber"
type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="motiveBack"
type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="logo-co-brande"
nillable="true" type="xsd:hexBinary"/>
<element maxOccurs="1" minOccurs="0" name="commercialName"
type="xsd:string"/>
<element maxOccurs="1" minOccurs="0"
name="partnerNetworkCode" nillable="true" type="xsd:string"/>
<element maxOccurs="1" minOccurs="0"
name="languageConsignor" nillable="true" type="xsd:string"/>
<element maxOccurs="1" minOccurs="0"
name="languageConsignee" nillable="true" type="xsd:string"/>
</sequence>
</extension>
</complexContent>
</complexType>
<simpleType name="DeliveryModeVO">
<restriction base="xsd:string">
<enumeration value="DOM"/>
<enumeration value="RDV"/>
<enumeration value="BPR"/>
<enumeration value="ACP"/>
<enumeration value="CDI"/>
<enumeration value="A2P"/>
<enumeration value="MRL"/>
<enumeration value="CIT"/>
<enumeration value="DOS"/>
<enumeration value="BDP"/>
<enumeration value="CMT"/>
</restriction>
</simpleType>
<complexType name="ArticleVO">
<sequence>
<element name="description" type="xsd:string"/>
<element name="quantite" type="xsd:int"/>
<element name="poids" type="xsd:float"/>
<element name="valeur" type="xsd:float"/>
<element maxOccurs="1" minOccurs="0" name="numTarifaire"
type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="paysOrigine"
Web Service d’étiquetage
Version 3.0 – avril 2013
35
type="xsd:string"/>
</sequence>
</complexType>
<simpleType name="CategorieVO">
<restriction base="xsd:int">
<enumeration value="1"/>
<enumeration value="2"/>
<enumeration value="3"/>
<enumeration value="4"/>
<enumeration value="5"/>
<enumeration value="6"/>
</restriction>
</simpleType>
<complexType name="ContentsVO">
<sequence>
<element maxOccurs="unbounded" name="article"
type="impl:ArticleVO"/>
<element name="categorie" type="impl:CategorieVO"/>
</sequence>
</complexType>
<complexType name="ParcelVO">
<sequence>
<element maxOccurs="1" minOccurs="0" name="insuranceRange"
type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="typeGamme"
type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="parcelNumber"
type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="returnTypeChoice"
type="xsd:int"/>
<element maxOccurs="1" minOccurs="0" name="insuranceAmount"
type="xsd:int"/>
<element maxOccurs="1" minOccurs="0" name="insuranceValue"
type="xsd:int"/>
<element maxOccurs="1" minOccurs="0" name="recommendationLevel"
type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="RecommendationAmount"
nillable="true" type="xsd:int"/>
<element maxOccurs="1" minOccurs="0" name="weight"
type="xsd:float"/>
<element name="horsGabarit" type="xsd:boolean"/>
<element maxOccurs="1" minOccurs="0" name="HorsGabaritAmount"
nillable="true" type="xsd:int"/>
<element maxOccurs="1" minOccurs="0" name="DeliveryMode"
nillable="true" type="impl:DeliveryModeVO"/>
<element maxOccurs="1" minOccurs="0" name="ReturnReceipt"
nillable="true" type="xsd:boolean"/>
<element maxOccurs="1" minOccurs="0" name="Recommendation"
nillable="true" type="xsd:boolean"/>
<element maxOccurs="1" minOccurs="0" name="Instructions"
nillable="true" type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="RegateCode"
nillable="true" type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="contents"
type="impl:ContentsVO"/>
</sequence>
</complexType>
Web Service d’étiquetage
Version 3.0 – avril 2013
36
<simpleType name="AlertTypeVO">
<restriction base="xsd:string">
<enumeration value="none"/>
<enumeration value="SMS"/>
<enumeration value="Mail"/>
<enumeration value="all"/>
</restriction>
</simpleType>
<complexType name="AddressVO">
<sequence>
<element maxOccurs="1" minOccurs="0" name="companyName"
type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="Civility"
nillable="true" type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="Name" nillable="true"
type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="Surname"
nillable="true" type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="line0"
nillable="true" type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="line1"
nillable="true" type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="line2"
nillable="true" type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="line3"
nillable="true" type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="phone"
nillable="true" type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="MobileNumber"
nillable="true" type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="DoorCode1"
nillable="true" type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="DoorCode2"
nillable="true" type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="Interphone"
nillable="true" type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="country"
type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="countryCode"
nillable="true" type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="city" nillable="true"
type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="email"
nillable="true" type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="postalCode"
nillable="true" type="xsd:string"/>
</sequence>
</complexType>
<complexType name="DestEnvVO">
<sequence>
<element maxOccurs="1" minOccurs="0" name="ref" nillable="true"
type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="alert"
nillable="true" type="impl:AlertTypeVO"/>
<element name="addressVO" type="impl:AddressVO"/>
<element name="codeBarForreference" type="xsd:boolean"/>
<element maxOccurs="1" minOccurs="0" name="deliveryError"
Web Service d’étiquetage
Version 3.0 – avril 2013
37
type="xsd:boolean"/>
<element maxOccurs="1" minOccurs="0" name="deliveryInfoLine1"
type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="deliveryInfoLine2"
type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="serviceInfo"
type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="promotionCode"
type="xsd:string"/>
</sequence>
</complexType>
<complexType name="ExpEnvVO">
<sequence>
<element maxOccurs="1" minOccurs="0" name="ref" nillable="true"
type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="alert"
nillable="true" type="impl:AlertTypeVO"/>
<element name="addressVO" type="impl:AddressVO"/>
</sequence>
</complexType>
<complexType name="LetterVO">
<sequence>
<element name="password" type="xsd:string"/>
<element name="contractNumber" type="xsd:int"/>
<element maxOccurs="1" minOccurs="0" name="profil"
type="xsd:string"/>
<element name="service" type="impl:ServiceCallContextVO"/>
<element name="parcel" type="impl:ParcelVO"/>
<element name="dest" type="impl:DestEnvVO"/>
<element name="exp" type="impl:ExpEnvVO"/>
</sequence>
</complexType>
<element name="getLetterResponse">
<complexType>
<sequence>
<element name="getLetterReturn" type="impl:ReturnLetterVO"/>
</sequence>
</complexType>
</element>
<complexType name="ReturnLetterVO">
<sequence>
<element maxOccurs="1" minOccurs="0" name="file" nillable="true"
type="xsd:base64Binary"/>
<element maxOccurs="1" minOccurs="0" name="parcelNumber"
type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="parcelNumberPartner"
nillable="true" type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="PdfUrl"
nillable="true" type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="errorID"
type="xsd:int"/>
<element maxOccurs="1" minOccurs="0" name="error"
type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="signature"
type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="dateCreation"
type="xsd:dateTime"/>
Web Service d’étiquetage
Version 3.0 – avril 2013
38
</sequence>
</complexType>
<element name="getLetterOROS">
<complexType>
<sequence>
<element name="letter" type="impl:LetterOROS"/>
</sequence>
</complexType>
</element>
<complexType name="LetterOROS">
<sequence>
<element name="password" type="xsd:string"/>
<element name="contractNumber" type="xsd:int"/>
<element name="service" type="impl:ServiceCallContextV2"/>
<element name="parcel" type="impl:ParcelVO"/>
<element name="dest" type="impl:DestEnvVO"/>
<element name="exp" type="impl:ExpEnvVO"/>
</sequence>
</complexType>
<element name="getLetterOROSResponse">
<complexType>
<sequence>
<element name="getLetterReturn" type="impl:ReturnLetterVO"/>
</sequence>
</complexType>
</element>
<element name="getLetterColissimo">
<complexType>
<sequence>
<element name="letter" type="impl:Letter"/>
</sequence>
</complexType>
</element>
<complexType name="Letter">
<sequence>
<element name="password" type="xsd:string"/>
<element name="contractNumber" type="xsd:int"/>
<element maxOccurs="1" minOccurs="0" name="profil"
type="xsd:string"/>
<element name="service" type="impl:ServiceCallContextV2"/>
<element name="parcel" type="impl:ParcelVO"/>
<element name="dest" type="impl:DestEnvVO"/>
<element name="exp" type="impl:ExpEnvVO"/>
</sequence>
</complexType>
<element name="getLetterColissimoResponse">
<complexType>
<sequence>
<element name="getLetterColissimoReturn"
type="impl:ReturnLetterVO"/>
</sequence>
</complexType>
</element>
<element name="getLetterColissimoFile">
<complexType>
<sequence>
<element name="getLetterReturn" type="impl:ReturnLetterVO"/>
Web Service d’étiquetage
Version 3.0 – avril 2013
39
</sequence>
</complexType>
</element>
<element name="getLetterColissimoFileResponse">
<complexType>
<sequence>
<element name="getLetterColissimoFileReturn"
type="impl:ReturnLetterVO"/>
</sequence>
</complexType>
</element>
<element name="getProduitsByGammeOptionsDestination">
<complexType>
<sequence>
<element name="letter" type="impl:Letter"/>
</sequence>
</complexType>
</element>
<element name="getProduitsByGammeOptionsDestinationResponse">
<complexType>
<sequence>
<element name="produitResponse" type="impl:ProduitResponse"/>
</sequence>
</complexType>
</element>
<complexType name="Message">
<sequence>
<element maxOccurs="1" minOccurs="0" name="id"
type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="type"
type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="libelle"
type="xsd:string"/>
</sequence>
</complexType>
<complexType name="ProduitResponse">
<sequence>
<element maxOccurs="1" minOccurs="0" name="partnerType"
type="xsd:string"/>
<element maxOccurs="unbounded" minOccurs="0" name="produits"
type="xsd:string"/>
<element maxOccurs="unbounded" minOccurs="0" name="message"
type="impl:Message"/>
</sequence>
</complexType>
<element name="genererEtiquetteBIC3">
<complexType>
<sequence>
<element name="letter" type="impl:Letter"/>
</sequence>
</complexType>
</element>
<element name="genererEtiquetteBIC3Response">
<complexType>
<sequence>
<element name="genererEtiquetteBic3Response"
type="impl:GenererEtiquetteBic3Response"/>
Web Service d’étiquetage
Version 3.0 – avril 2013
40
</sequence>
</complexType>
</element>
<complexType name="Site">
<sequence>
<element maxOccurs="1" minOccurs="0" name="codeRegate"
nillable="true" type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="rDepot"
nillable="true" type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="libelle"
nillable="true" type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="adresse"
nillable="true" type="impl:AddressVO"/>
</sequence>
</complexType>
<complexType name="Routing">
<sequence>
<element maxOccurs="1" minOccurs="0" name="destinationCountry"
nillable="true" type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="serviceName"
nillable="true" type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="depotDest"
nillable="true" type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="serviceMark"
nillable="true" type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="sortOrigin"
nillable="true" type="xsd:string"/>
<element maxOccurs="1" minOccurs="0"
name="groupingPriorityLabel" nillable="true" type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="sortDest"
nillable="true" type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="barcodeId"
nillable="true" type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="routingVersion"
nillable="true" type="xsd:string"/>
<element maxOccurs="1" minOccurs="0"
name="destinationCountryText" nillable="true" type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="partnerType"
nillable="true" type="xsd:string"/>
</sequence>
</complexType>
<complexType name="ZoneInfosRoutage">
<sequence>
<element maxOccurs="1" minOccurs="0" name="rDepot"
nillable="true" type="xsd:string"/>
<element maxOccurs="1" minOccurs="0"
name="numeroSuiviCABRoutage" nillable="true" type="xsd:string"/>
<element maxOccurs="1" minOccurs="0"
name="cleControleNumeroSuivi" nillable="true" type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="typeServiceLivraison"
nillable="true" type="xsd:string"/>
<element maxOccurs="1" minOccurs="0"
name="identificationDestination1" nillable="true" type="xsd:string"/>
<element maxOccurs="1" minOccurs="0"
name="identificationDestination2" nillable="true" type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="triExport"
nillable="true" type="xsd:string"/>
Web Service d’étiquetage
Version 3.0 – avril 2013
41
<element maxOccurs="1" minOccurs="0" name="triImport"
nillable="true" type="xsd:string"/>
<element maxOccurs="1" minOccurs="0"
name="identificationDimension" nillable="true" type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="dateImpression"
nillable="true" type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="heureImpression"
nillable="true" type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="routingVersion"
nillable="true" type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="numeroVersionWS"
nillable="true" type="xsd:string"/>
</sequence>
</complexType>
<complexType name="ZoneCABRoutage">
<sequence>
<element maxOccurs="1" minOccurs="0" name="codeBarreRoutage"
nillable="true" type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="numeroColisRoutage"
nillable="true" type="xsd:string"/>
</sequence>
</complexType>
<complexType name="ZoneRoutage">
<sequence>
<element maxOccurs="1" minOccurs="0" name="zoneInfosRoutage"
type="impl:ZoneInfosRoutage"/>
<element maxOccurs="1" minOccurs="0" name="zoneCABRoutage"
type="impl:ZoneCABRoutage"/>
</sequence>
</complexType>
<complexType name="CodeVas">
<sequence>
<element maxOccurs="1" minOccurs="0" name="mention"
nillable="true" type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="livraison"
nillable="true" type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="reserve"
nillable="true" type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="signature"
nillable="true" type="xsd:string"/>
</sequence>
</complexType>
<complexType name="AdresseRetourBelgique">
<sequence>
<element maxOccurs="1" minOccurs="0" name="mention"
nillable="true" type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="adresse1"
nillable="true" type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="adresse2"
nillable="true" type="xsd:string"/>
</sequence>
</complexType>
<complexType name="EtiquetteBelgique">
<sequence>
<element maxOccurs="1" minOccurs="0" name="numeroColisBelge"
nillable="true" type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="identification"
Web Service d’étiquetage
Version 3.0 – avril 2013
42
nillable="true" type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="codeBarre"
nillable="true" type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="codeVAS"
nillable="true" type="impl:CodeVas"/>
<element maxOccurs="1" minOccurs="0"
name="adresseRetourBelgique" nillable="true"
type="impl:AdresseRetourBelgique"/>
</sequence>
</complexType>
<complexType name="XMLResponse">
<sequence>
<element name="contractNumber" type="xsd:int"/>
<element maxOccurs="1" minOccurs="0" name="sitePCH"
nillable="true" type="impl:Site"/>
<element maxOccurs="1" minOccurs="0" name="pointRetrait"
nillable="true" type="impl:Site"/>
<element maxOccurs="1" minOccurs="0" name="expediteur"
nillable="true" type="impl:ExpEnvVO"/>
<element maxOccurs="1" minOccurs="0" name="destinataire"
nillable="true" type="impl:DestEnvVO"/>
<element maxOccurs="1" minOccurs="0" name="parcelNumber"
nillable="true" type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="routing"
nillable="true" type="impl:Routing"/>
<element maxOccurs="1" minOccurs="0" name="zoneRoutage"
nillable="true" type="impl:ZoneRoutage"/>
<element maxOccurs="1" minOccurs="0" name="etiquetteBelgique"
nillable="true" type="impl:EtiquetteBelgique"/>
</sequence>
</complexType>
<complexType name="Response">
<sequence>
<element maxOccurs="1" minOccurs="0" name="file" nillable="true"
type="xsd:base64Binary"/>
<element maxOccurs="unbounded" minOccurs="0" name="message"
nillable="true" type="impl:Message"/>
<element maxOccurs="1" minOccurs="0" name="xmlResponse"
nillable="true" type="impl:XMLResponse"/>
</sequence>
</complexType>
<complexType name="GenererEtiquetteBic3Response">
<complexContent>
<extension base="impl:Response">
<sequence>
<element maxOccurs="1" minOccurs="0" name="parcelNumber"
type="xsd:string"/>
<element maxOccurs="1" minOccurs="0"
name="parcelNumberPartenaire" type="xsd:string"/>
</sequence>
</extension>
</complexContent>
</complexType>
</schema>
</wsdl:types>
<wsdl:message name="getProduitsByGammeOptionsDestinationRequest">
<wsdl:part element="impl:getProduitsByGammeOptionsDestination"
Web Service d’étiquetage
Version 3.0 – avril 2013
43
name="parameters"/>
</wsdl:message>
<wsdl:message name="getLetterOROSRequest">
<wsdl:part element="impl:getLetterOROS" name="parameters"/>
</wsdl:message>
<wsdl:message name="getProduitsByGammeOptionsDestinationResponse">
<wsdl:part element="impl:getProduitsByGammeOptionsDestinationResponse"
name="parameters"/>
</wsdl:message>
<wsdl:message name="getLetterColissimoFileResponse">
<wsdl:part element="impl:getLetterColissimoFileResponse"
name="parameters"/>
</wsdl:message>
<wsdl:message name="genererEtiquetteBIC3Response">
<wsdl:part element="impl:genererEtiquetteBIC3Response"
name="parameters"/>
</wsdl:message>
<wsdl:message name="getLetterOROSResponse">
<wsdl:part element="impl:getLetterOROSResponse" name="parameters"/>
</wsdl:message>
<wsdl:message name="getLetterResponse">
<wsdl:part element="impl:getLetterResponse" name="parameters"/>
</wsdl:message>
<wsdl:message name="getLetterColissimoFileRequest">
<wsdl:part element="impl:getLetterColissimoFile" name="parameters"/>
</wsdl:message>
<wsdl:message name="genererEtiquetteBIC3Request">
<wsdl:part element="impl:genererEtiquetteBIC3" name="parameters"/>
</wsdl:message>
<wsdl:message name="getLetterColissimoResponse">
<wsdl:part element="impl:getLetterColissimoResponse" name="parameters"/>
</wsdl:message>
<wsdl:message name="getLetterColissimoRequest">
<wsdl:part element="impl:getLetterColissimo" name="parameters"/>
</wsdl:message>
<wsdl:message name="getLetterRequest">
<wsdl:part element="impl:getLetter" name="parameters"/>
</wsdl:message>
<wsdl:portType name="WSColiPosteLetterService">
<wsdl:operation name="getLetter">
<wsdl:input message="impl:getLetterRequest" name="getLetterRequest"/>
<wsdl:output message="impl:getLetterResponse"
name="getLetterResponse"/>
</wsdl:operation>
<wsdl:operation name="getLetterOROS">
<wsdl:input message="impl:getLetterOROSRequest"
name="getLetterOROSRequest"/>
<wsdl:output message="impl:getLetterOROSResponse"
name="getLetterOROSResponse"/>
</wsdl:operation>
<wsdl:operation name="getLetterColissimo">
<wsdl:input message="impl:getLetterColissimoRequest"
name="getLetterColissimoRequest"/>
<wsdl:output message="impl:getLetterColissimoResponse"
name="getLetterColissimoResponse"/>
</wsdl:operation>
<wsdl:operation name="getLetterColissimoFile">
Web Service d’étiquetage
Version 3.0 – avril 2013
44
<wsdl:input message="impl:getLetterColissimoFileRequest"
name="getLetterColissimoFileRequest"/>
<wsdl:output message="impl:getLetterColissimoFileResponse"
name="getLetterColissimoFileResponse"/>
</wsdl:operation>
<wsdl:operation name="getProduitsByGammeOptionsDestination">
<wsdl:input message="impl:getProduitsByGammeOptionsDestinationRequest"
name="getProduitsByGammeOptionsDestinationRequest"/>
<wsdl:output
message="impl:getProduitsByGammeOptionsDestinationResponse"
name="getProduitsByGammeOptionsDestinationResponse"/>
</wsdl:operation>
<wsdl:operation name="genererEtiquetteBIC3">
<wsdl:input message="impl:genererEtiquetteBIC3Request"
name="genererEtiquetteBIC3Request"/>
<wsdl:output message="impl:genererEtiquetteBIC3Response"
name="genererEtiquetteBIC3Response"/>
</wsdl:operation>
</wsdl:portType>
<wsdl:binding name="WSColiPosteLetterServiceSoapBinding"
type="impl:WSColiPosteLetterService">
<wsdlsoap:binding style="document"
transport="http://schemas.xmlsoap.org/soap/http"/>
<wsdl:operation name="getLetter">
<wsdlsoap:operation soapAction="getLetter"/>
<wsdl:input name="getLetterRequest">
<wsdlsoap:body use="literal"/>
</wsdl:input>
<wsdl:output name="getLetterResponse">
<wsdlsoap:body use="literal"/>
</wsdl:output>
</wsdl:operation>
<wsdl:operation name="getLetterOROS">
<wsdlsoap:operation
soapAction="http://ws.retour.coliposte.telintrans.fr/getLetterOROS"/>
<wsdl:input name="getLetterOROSRequest">
<wsdlsoap:body use="literal"/>
</wsdl:input>
<wsdl:output name="getLetterOROSResponse">
<wsdlsoap:body use="literal"/>
</wsdl:output>
</wsdl:operation>
<wsdl:operation name="getLetterColissimo">
<wsdlsoap:operation
soapAction="http://ws.retour.coliposte.telintrans.fr/getLetterColissimo"/>
<wsdl:input name="getLetterColissimoRequest">
<wsdlsoap:body use="literal"/>
</wsdl:input>
<wsdl:output name="getLetterColissimoResponse">
<wsdlsoap:body use="literal"/>
</wsdl:output>
</wsdl:operation>
<wsdl:operation name="getLetterColissimoFile">
<wsdlsoap:operation
soapAction="http://ws.retour.coliposte.telintrans.fr/getLetterColissimoFile"/>
<wsdl:input name="getLetterColissimoFileRequest">
<wsdlsoap:body use="literal"/>
Web Service d’étiquetage
Version 3.0 – avril 2013
45
</wsdl:input>
<wsdl:output name="getLetterColissimoFileResponse">
<wsdlsoap:body use="literal"/>
</wsdl:output>
</wsdl:operation>
<wsdl:operation name="getProduitsByGammeOptionsDestination">
<wsdlsoap:operation
soapAction="http://ws.retour.coliposte.telintrans.fr/getProduitsByGammeOptionsD
estination"/>
<wsdl:input name="getProduitsByGammeOptionsDestinationRequest">
<wsdlsoap:body use="literal"/>
</wsdl:input>
<wsdl:output name="getProduitsByGammeOptionsDestinationResponse">
<wsdlsoap:body use="literal"/>
</wsdl:output>
</wsdl:operation>
<wsdl:operation name="genererEtiquetteBIC3">
<wsdlsoap:operation
soapAction="http://ws.retour.coliposte.telintrans.fr/genererEtiquetteBIC3"/>
<wsdl:input name="genererEtiquetteBIC3Request">
<wsdlsoap:body use="literal"/>
</wsdl:input>
<wsdl:output name="genererEtiquetteBIC3Response">
<wsdlsoap:body use="literal"/>
</wsdl:output>
</wsdl:operation>
</wsdl:binding>
<wsdl:service name="WSColiPosteLetterService">
<wsdl:port binding="impl:WSColiPosteLetterServiceSoapBinding"
name="WSColiPosteLetterService">
<wsdlsoap:address
location="http://10.36.211.129/soap.shippingclpV2/services/WSColiPosteLetterSer
vice"/>
</wsdl:port>
</wsdl:service>
</wsdl:definitions>
Web Service d’étiquetage
Version 3.0 – avril 2013
46
VII.
Annexe 2 : Etiquettes à destination de la
France
Cette annexe fournit un modèle d’étiquette par mode de livraison.
VII.1 Livraison à Domicile avec Signature : « Mon
domicile » avec signature
réf client:01235678901234567890123
EXPEDITEUR
CLIENT 1
13/17 RUE SALNEUVE
COMPLEMENT ADRESSE 1
COMPLEMENT ADRESSE 1
75017 PARIS
COMPTE CLIENT: 964744
SITE DE PRISE EN CHARGE :
GENNEVILLIERS PFC
N° Colis : 6C 41392 07826 0
Poids : 1,50 Kg
Edité le: 25/02/2009
N°de colis: 6C 41392 07826 0
M. OLIVIER DUPONT
APPART/ETAGE/COULOIR/ESCALIER
ENTREE/BATIMENT/IMMEUBLE/RESIDENCE
NUMERO ET LIBELLE DE VOIE
LIEU DIT/SCE PARTICULIER DISTRIBUTION
XXXXX
COMMUNE
SPECIFIQUE
INSTRUCTIONS DE LIVRAISON XXXXXXXXXXXXXXXX
INSTRUCTIONS DE LIVRAISON XXXXXXXXXXXXXXXX
Code porte 1,
Code porte 2
Identifiant Interphone
Numéro de téléphone 1
Numéro de téléphone 2
DESTINATAIRE
N°de PCH: 6C1 75015 964744 0150 231066
Web Service d’étiquetage
Version 3.0 – avril 2013
47
VII.2 Livraison à Domicile sans Signature : « Mon
domicile » sans signature
réf client:01235678901234567890123
EXPEDITEUR
CLIENT 1
13/17 RUE SALNEUVE
COMPLEMENT ADRESSE 1
COMPLEMENT ADRESSE 1
75017 PARIS
COMPTE CLIENT: 964744
SITE DE PRISE EN CHARGE :
GENNEVILLIERS PFC
N° Colis : 6A 41392 07826 0
Poids : 1,50 Kg
Edité le: 25/02/2009
N°de colis: 6A 41392 07826 0
NOM DE LA SOCIETE
M. OLIVIER DUPONT / SERVICE
ENTREE/BATIMENT/IMMEUBLE/ZI
NUMERO ET LIBELLE DE VOIE
MENTION SPECIALE/COMMUNE GEOGRAPHIQUE
XXXXX
COMMUNE
SPECIFIQUE
INSTRUCTIONS DE LIVRAISON XXXXXXXXXXXXXXXX
INSTRUCTIONS DE LIVRAISON XXXXXXXXXXXXXXXX
Code porte 1,
Code porte 2
Identifiant Interphone
Numéro de téléphone 1
Numéro de téléphone 2
DESTINATAIRE
N°de PCH: 6A1 75015 964744 0150 001065
Web Service d’étiquetage
Version 3.0 – avril 2013
48
VII.3 Livraison à Domicile sur RDV : « Mon rendez-vous »
EXPEDITEUR
CLIENT 1
13/17 RUE SALNEUVE
COMPLEMENT ADRESSE 1
COMPLEMENT ADRESSE 1
75017 PARIS
COMPTE CLIENT: 964744
SITE DE PRISE EN CHARGE :
GENNEVILLIERS PFC
N° Colis : 6K 41392 07826 0
Poids : 1,50 Kg
Edité le: 25/02/2009
N°de colis: 6K 41392 07826 0
M. OLIVIER DUPONT
APPART/ETAGE/COULOIR/ESCALIER
ENTREE/BATIMENT/IMMEUBLE/RESIDENCE
NUMERO ET LIBELLE DE VOIE
LIEU DIT/SCE PARTICULIER DISTRIBUTION
XXXXX
COMMUNE
SPECIFIQUE
INSTRUCTIONS DE LIVRAISON XXXXXXXXXXXXXXXX
INSTRUCTIONS DE LIVRAISON XXXXXXXXXXXXXXXX
Code porte 1,
Code porte 2
Identifiant Interphone
Numéro de téléphone 1
Numéro de téléphone 2
DESTINATAIRE
N°de PCH: 6K1 75015 964744 0150 231066
Web Service d’étiquetage
Version 3.0 – avril 2013
49
VII.4 Livraison en Espace cityssimo : « Mon cityssimo »
réf client:01235678901234567890123
CLIENT 1
13/17 RUE SALNEUVE
COMPLEMENT ADRESSE 1
COMPLEMENT ADRESSE 1
75017 PARIS
COMPTE CLIENT: 964744
SITE DE PRISE EN CHARGE :
GENNEVILLIERS PFC
N° Colis : 6J 41392 07826 0
Poids : 1,50 Kg
Edité le: 25/02/2009
445619832
EXPEDITEUR
DESTINATAIRE
NOM DU CITYSSIMO
M. OLIVIER DUPONT
ENTREE/BATIMENT/IMMEUBLE/RESIDENCE
NUMERO ET LIBELLE DE VOIE
LIEU DIT/SCE PARTICULIER DISTRIBUTION
PARIS
SPECIFIQUE
75015
ADRESSE 1: XXXXXXXXXXXXXXXX
ADRESSE 2: XXXXXXXXXXXXXXXX
ADRESSE 3: XXXXXXXXXXXXXXXX
ADRESSE 4: XXXXXXXXXXXXXXXX
CCCCC COMMUNE
Tel : 06 02 03 04 05
N°de colis: 6J 41392 07826 0
N°de PCH: 6J1 75015 964744 0150 231066
Web Service d’étiquetage
Version 3.0 – avril 2013
50
VII.5 Livraison en Bureau de Poste : « Mon bureau de
poste »
Web Service d’étiquetage
Version 3.0 – avril 2013
51
VII.6 Livraison en Relais Commerçant : « Mon
commerçant »
Pour ce mode de livraison, il existe 2 types d'étiquettes selon les informations du point de
retrait.
TYPE A :
réf client:01235678901234567890123
COMPTE CLIENT: 964744
SITE DE PRISE EN CHARGE :
GENNEVILLIERS PFC
N° Colis : 6M 41392 07826 0
Poids : 1,50 Kg
Edité le: 25/02/2009
N°de colis: 6M 41392 07826 0
DESTINATAIRE
NOM DU RELAIS COMMERCANT
M. OLIVIER DUPONT
ENTREE/BATIMENT/IMMEUBLE/RESIDENCE
NUMERO ET LIBELLE DE VOIE
37500 COMMUNE
91500
HUB RELAIS
SPECIFIQUE
Tel : 06 02 03 04 05
0037 5006 M413 9207 8260 0849 250E
CLIENT 1
13/17 RUE SALNEUVE
COMPLEMENT ADRESSE 1
COMPLEMENT ADRESSE 1
75017 PARIS
TUF SA13 REL 37S01
EXPEDITEUR
N°de PCH: 6M1 91500 964744 0150 231066
Web Service d’étiquetage
Version 3.0 – avril 2013
52
TYPE B :
Web Service d’étiquetage
Version 3.0 – avril 2013
53
VIII.
Annexe 3 : Etiquettes à destination de la
Belgique
Cette annexe fournit un modèle d’étiquette par mode de livraison.
VIII.1 Livraison à Domicile sans Signature
Web Service d’étiquetage
Version 3.0 – avril 2013
54
VIII.2 Livraison à Domicile avec Signature
Web Service d’étiquetage
Version 3.0 – avril 2013
55
VIII.3 Livraison en Bureau de Poste
Web Service d’étiquetage
Version 3.0 – avril 2013
56
VIII.4 Livraison en Relais Commerçant
Web Service d’étiquetage
Version 3.0 – avril 2013
57
IX. Annexe 4 : Preuve de dépôt
La preuve de dépôt est imprimée avec l'étiquette sur la moitié droite de la page, sur la même
feuille A4. Elle permet de prouver le dépôt effectif du colis.
Si vous avez contractualisé cette option, vous pouvez la personnalisée depuis votre espace
client, via le Back Office de la solution d’expédition « Flexibilité ».
Pour plus d’informations, voir le Guide d’utilisation du Back Office de la solution d’expédition
« Flexibilité ».
La valeur du « N° de commande » est alimentée par le champ commandNumber via les
paramètres d’appel.
Web Service d’étiquetage
Version 3.0 – avril 2013
58
Donnée
Logo
Texte fixe
Numéro de commande
Date
Adresse de l’expéditeur
Adresse de livraison
Description
Personnalisable via le Back Office de la
d’expédition « Flexibilité »
Personnalisable via le Back Office de la
d’expédition « Flexibilité »
Zone dynamique
Affiché s'il est renseigné dans la requête
Date d'édition du document
Adresse de l’expéditeur indiquée sur l'étiquette
Adresse de livraison indiquée sur l'étiquette
solution
solution
En mode de livraison hors domicile : précision du
Nom/prénom du destinataire + adresse du point de
retrait
Option(s)
Libellé prévu pour la souscription aux options, par
exemple : "Taux de recommandation R1"
Date de validité
Date d'édition + 7 jours calendaires = validité prévue de
l’étiquette
Web Service d’étiquetage
Version 3.0 – avril 2013
59
X.
Annexe 5 : Déclaration en douane CN23
Cette déclaration est nécessaire pour dédouaner les colis expédiés vers l’Andorre. Elle doit
être imprimée en 4 exemplaires qui seront joints à l’envoi.
Le document est créé à partir des informations transmises au Web Service sur le contenu du
colis. 4 exemplaires sont ajoutés à la suite de l’étiquette sous la forme de 4 pages
supplémentaires dans le fichier retourné.
Web Service d’étiquetage
Version 3.0 – avril 2013
60
La CN23 est divisée en plusieurs zones. Certaines sont renseignées à partir des informations
transmises au web service, d’autres sont à remplir par l’expéditeur (ex. : signature) ou par
les personnes qui vont réaliser le dédouanement.
Zones renseignées par le web service :
Zone expéditeur
Donnée
Nom
Prénom
Raison sociale
Description
Le nom de l’expéditeur
Le prénom de l’expéditeur
La raison sociale si l’expéditeur est une entreprise
4 lignes d’adresse
Au moins une ligne d’adresse.
Le Code Postal
Le nom de la ville
Le nom du pays (récupéré à partir du code pays)
Le numéro de téléphone
Adresse
Code postal
Ville
Pays
Téléphone
Zone destinataire
Donnée
Nom
Prénom
Raison sociale
Description
Le nom du destinataire
Le prénom du destinataire
La raison sociale si le destinataire est une entreprise
4 lignes d’adresse
Au moins une ligne d’adresse.
Le Code Postal
Le nom de la ville
Le nom du pays (récupéré à partir du code pays)
Le numéro de téléphone
Adresse
Code postal
Ville
Pays
Téléphone
Zone CAB
Donnée
CAB
numéro de colis
Description
Edition graphique au format code 128 du numéro de colis
Le numéro de colis en texte.
Zone table des articles
La table des objets contenus dans le colis comprend :
Web Service d’étiquetage
Version 3.0 – avril 2013
•
Une ligne d’en-têtes
•
Plusieurs lignes d’articles
•
Une ligne totale
61
Donnée
Description
Quantité
Poids
Valeur
Numéro tarifaire
Pays d’origine
Description
Une description détaillée de chaque objet contenu dans l’envoi (p.
ex. «chemise homme en coton»).
Les indications génériques telles que «pièces de rechange»,
«échantillons», «produits alimentaires», etc., ne sont pas
admises par les douanes
Le nombre d’objets correspondants à la description
Le poids net unitaire de chaque objet en kg
La valeur de l’ensemble des objets en EUR
Le numéro tarifaire, basé sur le Système Harmonisé de
désignation et de codification des marchandises élaboré par
l’Organisation Mondiale des Douanes.
Le pays de provenance des marchandises (p. ex. le pays de
production, de fabrication ou d’assemblage). Le code ISO du pays
pourra remplacer le nom (*).
(*) Le web service tentera de récupérer le nom du pays à partir du code ISO du pays
transmis en paramètre. Si le nom du pays n’est pas récupéré, le code ISO remplacera le nom.
Ligne total
Donnée
Total poids
Total valeur
Frais
Description
La somme des produits : poids x quantité
Le poids total ne doit pas être supérieur au poids du colis
La somme des valeurs
Ce n’est pas un total, mais le montant total TTC de l’envoi (*).
(*) Les frais correspondent au champ ToatlAmount passé en paramètre au web service pour
réaliser l’étiquette.
Zone catégorie de l’envoi
Donnée
Catégorie
Web Service d’étiquetage
Version 3.0 – avril 2013
Description
La case cochée indique la catégorie de l’envoi
62
XI. Annexe 6 : Web Service indisponible
Si le Web Service est indisponible, la page d’erreur suivante est transmise en html dans le
flux de réponse :
Web Service d’étiquetage
Version 3.0 – avril 2013
63