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