Here is the Expedipro API reference documentation providing detailed schema and request examples for various usages.
\n\n\nPour les lecteurs français : seule cette introduction API request est en anglais.
\n
Before digging into individual request schema, let's talk about their commun parts : their HTTPS headers, HTTPS status code, etc.
BTW if you like markdown, give a try to https://stackedit.io/app
Most requests are associated with json schema that should be read carefully to use the correct data type for each json properties expected by the API.
\n\n\nEach request provides at least 2 exemples of response : one successful and one error. Please read both to build a robust client.
\n
The commonly used HTTPS request headers are:
\nThe API calls return HTTPS status codes with return JSON response bodies that include information about the resources targeted by the request.
\nIn the responses for failed requests, the returns HTTPS status codes are > 4XX.
For all errors, the API returns an error response body that includes additional error details in this format (see https://jsonapi.org/format/#errors for more informations) :
{ \n \"errors\": [ { \"status\": `4XX`, \"code\": \"category of the error\", \"detail\": \"description\" } ]} \n\nThis doc is organized per folder following the lifespan of an order/parcel delivery.
\nCommande: manage the insertion/synchronization/follow-up of orders (customers purchases) from external sources, that are expected to be shipped.
\nMode de livraison: select the type of shipment. This is optionnal and is not required to be done before each shipment.
\nDouane: manage customs requirements (may differs from carriers)
\nExpedition: create a shipment label (and eventually customs declarations), related or not to an order.
\nCollecte - 1er km: manage the first kilometer (pickup by the carrier) of your parcels
\nAcheminement: following the progress of your parcels' delivery
\nRéclamation - sav: manage deliveries issues with the carriers
\nDestinataire: allow the improvement of customer/recipient address and getting the history of purchases. This is optionnal, recipient address are commonly created while creating an order (see 1).
\nGetting a shipping label :
\nshort : call expedition/createforward with an expedition object providing the basic data required to ship a parcel, i.e. mostly recipient address. Read the doc from the folder Expédition
better : before doing the short way, call commande/create with an commande object providing the recipient address, cart detail, and delivery option choosen by the purchaser into your CMS. Read the doc from the folder Commande. After sucessuful answer, then call the expedition/createforward with only the commandeId you received
Getting a reverse shipping label :
\nshort : call expedition/createreverse with an expedition object providing the basic data required to ship a parcel : address. Read the doc from the folder Expédition
better : reuse one of the ids from the original forward label and just provided it to expedition/createreverse . Doing so, link both labels and increase the traceability and the quality of our services
Ask for the pickup of your parcels :
\ncollecte/create with some criteria to fill the list of parcels that should be picked up (when allowed by the carrier). Read the doc from the folder Collecte - 1er kmTrace delivery progress :
\nshort : call expedition/trace with one of the id of the parcel. Read the doc from the folder Acheminement
better : do the short way with also providing an url to receive our call back as soon as we are notified of an evolution in the delivery
\n... contact us to get more use cases described !
\n","_postman_id":"d457d609-5cdd-475c-a1f6-2843d392a4d5","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","name":"expedipro:{api:v2}","type":"collection"}}},{"name":"Votre premier appel","item":[],"id":"0a0eef54-bfe6-4d15-9215-8231b1143f6e","description":"Suite à l'introduction, il est temps de commencer ! En deux appels, nous allons obtenir les tarifs d'expéditons pour un colis de 2kg à destination de Toulouse.
\ncurl -X POST https://www.expdipro.com/identity/gettoken \\\n -H 'Content-Type: application/json' -H 'Accept: application/vnd.api+json' \\ \n -H 'Custom-Version: 2' \\\n -d '{\n \"identity\": {\n \"login\":\"<login>\",\n \"password\":\"<password>\"\n }\n}'\n{\n \"data\": {\n \"type\": \"access\",\n \"id\": \"<jwtToken>\"\n \"attributes\": {\n \"expire\" : 1520514359\n }\n },\n \"links\": {\n \"next\": \"/expedition/index\"\n }\n}\nLe <jwtToken> est la valeur de la propriété data.id qui n'a pas besoin d'être demandé avant chaque requête car sa validité est d'au moins 30 minutes ( propriété data.attributes.expire ). Insérez ce <jwtToken> dans les HTTPS headers comme précisé plus haut : Authorization: Bearer <jwtToken>\n3. Demandez les tarifs avec ce JSON object {\"expedition\": {\"codePostal\":31000,\"paysId\":\"FRA\",poids\":2}}
curl -X POST https://www.expedipro.com/expedition/advise \\\n -H 'Accept: application/json' -H 'Content-Type: application/json' \\\n -H 'Authorization: Bearer <jwtToken>' -H 'Custom-Version: 2' \\\n -d '{\n \"expedition\": {\n \"paysId\":\"FRA\",\n \"codePostal\":\"31000\",\n \"poids\":2,\n \"advise\":true\n }\n}'\n{\n \"expedition\": {\n \"poids\": 2.12,\n \"produitId\": \"LFE\",\n \"constraint\": [],\n \"definition\": {}\n \"comparison\": {},\n \"insurance\": false,\n \"cost\": {\n \"net\": {\n \"principal\": 8.19,\n \"service\": 0,\n \"totalHt\": 8.19,\n },\n },\n }\n}\nLe layout de cette page vous permet :
\nHTTP 2** et un exemple de réponse en échec HTTP 4**.\n\nAu début de cette page, une liste déroulante vous permet de choisir le format des exemples de requêtes : cUrl, PHP, etc.
\n
\n\nPour chaque requête, une liste déroulante vous permet de choisir un exemple parmi d'autres
\n
\n\n","event":[{"listen":"prerequest","script":{"type":"text/javascript","exec":[""],"id":"ffffe500-9436-43b9-b324-206c347fc59d"}},{"listen":"test","script":{"type":"text/javascript","exec":[""],"id":"207da023-9055-453a-80c5-a199ae667572"}}],"_postman_id":"aaeb2a17-5952-4f4e-98cc-df06c55955b7","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","name":"expedipro:{api:v2}","type":"collection"}}},{"name":"Connexion","item":[{"name":"Obtenir un jeton","event":[{"listen":"test","script":{"exec":["const jsonData = pm.response.json();","pm.expect( jsonData.data.type ).to.eql( \"access\");","pm.collectionVariables.set(\"jwtToken\", jsonData.data.id );","console.log( pm.collectionVariables.get(\"jwtToken\") );"],"type":"text/javascript","packages":{},"id":"5404c21a-9b69-43b7-afb8-404511bcfa9f"}}],"id":"96efa920-5354-4334-a5cc-886c21e58ed2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"identity\": {\n \"login\": \"{{login}}\",\n \"password\": \"{{password}}\"\n }\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/identity/gettoken","description":"N'oubliez pas d'insérer dans chaque requête les
\nHTTPS headersdéfinis précédement dans le chapitre du même nom avec un<jwtToken>valide.
Obtenez un jeton avec votre login et password.
\n\n\nIl s'agit du seul appel API qui ne requière pas le HTTP header
\nAuthorization: Bearer
En réponse HTTP 200, vous obtenez un objet JSON.\nLe <jwtToken> est la valeur de la propriété data.id \nLa durée de vie du token est fournie par la propriété data.attributes.expire.
Insérez ce <jwtToken> dans les HTTP headers comme précisé plus haut : Authorization: Bearer <jwtToken>
Un <jwtToken> reste utilisable par n'importe qui durant sa période de validité data.attributes.expire. Il faut mieux donc l'invalider après usage.
\n\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","name":"expedipro:{api:v2}","type":"collection"}},"urlObject":{"path":["identity","revoketoken"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"7ee35d58-b7cb-4979-af44-ea7a48bdefa8","name":"200 ok : token revoked","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"","disabled":true},{"key":"Content-Type","value":"application/json","disabled":true}],"body":{"mode":"raw","raw":""},"url":"https://www.expedipro.com/identity/revoketoken"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\"data\":{\"type\":\"access\",\"id\":null}}"}],"_postman_id":"28b5ad27-cc3a-4c46-b5ff-ce494f78e52d"}],"id":"f5dbbd96-7637-4ddf-ab66-9914d0fc8463","description":"Seul le token courant fourni dans
\nAuthorization: Bearer <jwtToken>peut être invalidé. Cet appel n'accepte aucun paramêtre.
L’identification des appels à l’API se fait avec un JSON Web Token.
\nIl n'est pas nécessaire d'installer une librairie pour gérer les JWT : Le premier appel API demandera un token que tous les appels suivants utiliseront le champs header Authorization: Bearer.
Lisez le chapitre \"Votre premier appel\" afin d'avoir un exemple d'utilisation.
\n\n\nNous recommandons de réutiliser un même jeton autant que possible, surtout si vous imprimez une série d’étiquette durant cette période. La durée de vie d’un jeton est d’au moins 30 minutes.
\n
Plus d'info sur les JSON Web Token : jwt.io jwt-jws-jwe
\n","event":[{"listen":"prerequest","script":{"type":"text/javascript","exec":[""],"id":"fda7eefb-fd82-4a19-8f54-2db86d5e48c6"}},{"listen":"test","script":{"type":"text/javascript","exec":[""],"id":"b0fdd07a-b5c3-49b8-9a2c-9fc12d8858ac"}}],"_postman_id":"f5dbbd96-7637-4ddf-ab66-9914d0fc8463","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","name":"expedipro:{api:v2}","type":"collection"}}},{"name":"Commande","item":[{"name":"Créer une commande client","id":"085302eb-e2d9-4e69-ac24-4d3c8041c653","protocolProfileBehavior":{"disabledSystemHeaders":{"connection":true,"user-agent":true},"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n\t\"commande\":\n\t{\n\t\t\"entreprise\":false,\n\t\t\"prenom\":\"\",\n\t\t\"nom\":\"Marc Diamant\",\n\t\t\"telephoneM\":\"0211573969\",\n\t\t\"email\":\"8@marketplace.amazon.fr\",\n\t\t\"reference\":\"prépa#226_12:60_25927990\",\n\t\t\"date\":\"2025-10-02\",\n\t\t\"adresse1\":\"CHEMIN DU PRE-GABET 48\",\n\t\t\"codePostal\":\"1288 \",\n\t\t\"ville\":\"genè8ve\",\n\t\t\"pays\":\"CH\",\n\t\t\"panier\":\n\t\t[\n\t\t\t{\n\t\t\t\t\"desc\":\"BATTERIES\",\n\t\t\t\t\"qte\":1,\n\t\t\t\t\"val\":98.7,\n\t\t\t\t\"poids\":0.1,\n\t\t\t\t\"cat\":\"490199\",\n\t\t\t\t\"pays\":\"France\"\n\t\t\t}\n\t\t],\n \"compteId\" : null\n\t},\n \"strict\": true\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/commande/create","description":"Une commande (i.e. an order) décrit le contenu et le lieu de livraison d'une future expédition. La requête doit fournir un objet commande conforme au schema commande.
\n\nLes données d'adressage peuvent indifféremment être fournies à la racine de l'objet commande (e.g.:
\ncommande.nom) ou dans un sous objet commande.destinataire, similaire à un appel /destinataire/create (e.g.:commande.destinataire.email)
Quelques propriétés particulières :
\n(array) commande.panier est une collection d'objets item définis dans le schema item. Bien qu'optionelle, cette propriété permet d'optimiser les réponses de l'api :proposition optimisée d'expédition selon le poids (en kg) / valeur (en €) du colis,
\napplication de règles d'assurances selon le poids (en kg) / valeur (en €) du colis,
\npré-remplissage des documents douaniers,
\nnavigation et recherches facilités dans Expedipro,
\ngénération de document de picking et de bon de livraison.
\n(string) commande.reference est requise et doit être unique pour le compteId associé, c'est le numéro unique de votre commande sur votre CMS.(int) compteId (optionnelle) : il s'agit du canal de ventes pre-défini (aka source de données) dans Expedipro qui permet d'appliquer des règles d'expéditions différentes ou de déclencher des actions lors de l'évolution des statuts d'acheminement et de livraison.
(string) commande.transport (optionnelle) précise le code fournisseur, e.g. MDR, POS, DPD (voir \"Livraison -> Lister les fournisseurs), ou le code produit (voir \"Livraison -> Lister les produits).
(objet) commande.siteLivraison (optionnelle), afin de préciser l'identifiant du point de livraison.
\n\nLa propriété
\ntransportdevient alors requise afin de connaître le transporteur associé à ce point de livraisonsiteLivraisonpeut ne pas être fourni avec l'objetcommandemais avec l'objetexpeditionlors de l'appel ultérieur dePOST Obtenir une étiquette aller
\n\nMieux vous renseignez l'objet commande, lors cet appel, moins vous avez besoin de fournir de détails lors de l'appel /expedition/create. Par exemple, si transport, siteLivraison sont renseignés ici, ne le faites pas dans l'objet expedition. De même, un panier complet vous dispense de renseigner le poids ou la valeur dans l'objet expedition
\n
(bool) strict (optionnelle, defaut: true). Lorsque elle vaut false, le serveur acceptera que :
commande.reference soit vide et sera remplacé par un timestamp
commande.reference existe déjà, elle sera considérée comme une nouvelle itération de la commande pré-existante (duplication de la commande pour un traitement en 2 étapes succésives)
commande.pays soit vide et sera remplacé par \"FRA\"
commande.ville ne corresponde pas à commande.codePostal selon nos bases de geodata, pour les pays autres que la France.
commande.telephoneM (le même qui peut être fournir par l'objet destinataire) soit incorrect selon libphonenumber
La réponse est de la forme commande:{\"id\":(int)} ou idest à réutiliser lors d’un prochain appel à POST Obtenir une étiquette aller
\n\nSi la réponse n'est pas HTTP 201, un objet
\nerrors:[{},{}]fournira les raisons empêchant la création de cette commande. Quand c'est possible, la propriétéproposalproposera des solutions pour réussir la prochaine tentative d'importation.
NB: Il est possible de créer une commande directement lors de l'appel expedition/create, en fournissant cet object commande au coté de l'objet expedition; un exemple est fourni pour cet appel dans 201 ok : one step only. Néanmoins, utiliser commande/create présente l'avantage d'obtenir des messages d'erreurs plus détaillés.
Cet appel doit être partiellement conforme au schema commande. La commande doit être identifié soit par :
\n(int) id : id interne Expedipro reçu en réponse du POST Importer une commande
(string) reference : id externe éventuellement fourni dans l'appel POST Importer une commande
Les principales propriétés modifiables sont :
\n(string) date : création de la commande de votre coté
(string) contenu : résumé du panier (pas le panier lui même) pour faciliter les recherches et/ou hashtag
(string) transport : identifiant du transporteur parmi MDR/DPD/DHL/POS ou un produitId si vous souhaitez être plus précis sur le mode de livraison.
(object) siteLivraison : {\"id\":identifiant du point de livraisons hors domicile }, assurez-vous de renseigner aussi transport dans ce cas.
(string) consigne : consigne visible uniquement dans la fiche détaillée Expedipro
(bool) sendable : considère la commande à traiter (ou pending) ou non
Deux clés sont possibles dans la requête :
\n(int) commandeId (ou sous la forme commande.id) : l'id interne Expedipro reçu en réponse du POST Importer une commande
(string) commandeRef (ou sous la forme commande.reference) : l'id externe éventuellement fourni dans l'appel POST Importer une commande
\n\nCette requête peut aussi être appelée en
\nPOSTavec un objet JSON {\"commande\":{\"id\":(int)}}
La réponse HTTP 200 fournie l'intégralité de l'objet commande préalablement crée dans Expedipro.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","name":"expedipro:{api:v2}","type":"collection"}},"urlObject":{"path":["commande","get"],"host":["{{url}}"],"query":[{"disabled":true,"key":"id","value":"738314"}],"variable":[]}},"response":[{"id":"3c842fef-2aac-4dd1-96e1-b6bb0d6376f1","name":"200 ok","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"Bearer ","disabled":true},{"key":"Content-Type","value":"application/json","type":"text"},{"key":"Accept","value":"application/json;","disabled":true}],"body":{"mode":"raw","raw":"{\n\t\"commandeId\": 649464\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/commande/get"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n \"commande\": {\n \"id\": 649464,\n \"compteId\": 1,\n \"reference\": \"235080\",\n \"iteration\": \"0\",\n \"consigne\": \"\",\n \"sendable\": true,\n \"groupedIn\": null,\n \"sibling\": null,\n \"grouping\": null,\n \"duplicatedFrom\": null,\n \"date\": \"5 May 2017\",\n \"long\": null,\n \"larg\": null,\n \"haut\": null,\n \"contenu\": \"Montre Vibrante .., Montre Vibrante ..\",\n \"panier\": [\n {\n \"id\": null,\n \"desc\": \"Montre Vibrante Vibralite 12\",\n \"qte\": 1,\n \"poids\": 0.65,\n \"val\": 49.17,\n \"cat\": null,\n \"pays\": \"FRA\"\n },\n {\n \"id\": null,\n \"desc\": \"Montre Vibrante Mini Fleur\",\n \"qte\": 2,\n \"poids\": 0.98,\n \"val\": 15.17,\n \"cat\": null,\n \"pays\": \"FRA\"\n }\n ],\n \"destinataireId\": 687546,\n \"adresseId\": 680582,\n \"nom\": \"Scotton\",\n \"prenom\": \"Christiane\",\n \"entreprise\": false,\n \"adresse1\": \"19 rue du fer à cheval\",\n \"adresse2\": \"Seynod\",\n \"adresse3\": \"\",\n \"codePostal\": \"64000\",\n \"ville\": \"PAU\",\n \"paysId\": \"FRA\",\n \"pays\": \"France\",\n \"instruction\": \"\",\n \"telephoneF\": \"\",\n \"telephoneM\": \"0606060606\",\n \"email\": \"christianescotton@woo.fr\",\n \"envoiId\": null\n }\n}"},{"id":"dba45737-ff8b-4abb-9820-e0d6e21f4013","name":"404 not found","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"Bearer ","disabled":true},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"commandeId\": 571233\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/commande/get"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","name":"Content-Type","description":""}],"cookie":[],"responseTime":null,"body":"{\n \"errors\": [\n {\n \"status\": 404,\n \"code\": \"not found\",\n \"detail\": \"commande introuvable\"\n }\n ]\n}"}],"_postman_id":"b9267256-86cc-48be-b9c3-302668eee274"},{"name":"Itérations et expéditions","id":"5dc88d1c-6981-477a-a0f0-c94c99a412ec","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"{\n \"commandeId\": null,\n \"commandeRef\": null,\n \"expeditionId\": null,\n \"commande\": {\n \"id\": null,\n \"reference\": null,\n \"expeditionId\": null\n }\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/commande/getiteration","description":"Grace à l'appel /commande/duplicate , il peut exister une relation n..n entre expedition et commande : une commande peut avoit 2 itérations successives d'expédition, ou une expédition peut concerner 2 commandes.
\nA partir de l'id d'une expedition ou d'une commande ou d'une référence, il est possible de tracer ces liens.
\nLa réponse HTTP 200 fournie un array avec la/les commande(s) insérée(s) dans une expédition
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","name":"expedipro:{api:v2}","type":"collection"}},"urlObject":{"path":["commande","getiteration"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"6e41bd87-8940-4402-96f7-34e57a92cc45","name":"200 ok : liste des itérations","originalRequest":{"method":"GET","header":[],"url":"{{url}}/commande/getiteration"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"commande\": [\n {\n \"commandeId\": 2442259,\n \"reference\": \"408-8929148-5987512\",\n \"iteration\": 0,\n \"canal\": null,\n \"date\": \"2025-04-08 22:00:00\",\n \"expeditionId\": 2722998,\n \"contenu\": null,\n \"cabTransport\": \"6A02036410051\",\n \"forward\": true,\n \"dateEtiquette\": \"2025-04-08\",\n \"produitId\": \"LFA\",\n \"consigne\": null,\n \"groupedIn\": null,\n \"duplicatedFrom\": null\n },\n {\n \"commandeId\": 2442470,\n \"reference\": \"408-8929148-5987512\",\n \"iteration\": 2,\n \"canal\": null,\n \"date\": \"2025-04-08 22:00:00\",\n \"expeditionId\": null,\n \"contenu\": null,\n \"cabTransport\": null,\n \"forward\": null,\n \"dateEtiquette\": null,\n \"produitId\": null,\n \"consigne\": null,\n \"groupedIn\": null,\n \"duplicatedFrom\": 2442259\n }\n ]\n}"},{"id":"cb586b53-da53-4afe-9a59-7b09e7a1c8ca","name":"404 Not Found : no order asssociated","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"Bearer ","disabled":true},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"commandeId\": null,\n \"commandeRef\": null,\n \"expeditionId\": 2442259\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/commande/getiteration"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","name":"Content-Type","description":""}],"cookie":[],"responseTime":null,"body":"{\n \"errors\": [\n {\n \"status\": 404,\n \"code\": \"commande\",\n \"detail\": \"aucune association avec une commande\"\n }\n ]\n}"}],"_postman_id":"5dc88d1c-6981-477a-a0f0-c94c99a412ec"},{"name":"Commandes en attente","id":"0a7dfa28-7053-47bd-b23d-14c5c7432c82","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{url}}/commande/getpending","description":"Obtient la/les commande(s) non associées à un envoi.
\nLes commandes associées à un envoi ou qui ont été déclaré non envoyables sendable:false ne sont pas listées.
Les commandes en attente de point relais ne sont pas listées ici. Elles le redeviennent APRES que la demande de choix de point de livraison soit devenue caduque, pour 2 raisons : choix effectué ou pas de choix dans les délais.
\nLa propriété demand montre ce statut: null(aucune demande effectuée), true(demande en cours), false(choix fait ou délai dépassé)
\n\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","name":"expedipro:{api:v2}","type":"collection"}},"urlObject":{"path":["commande","getpending"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"84c1e8da-bbd5-4c4b-9600-c37937369628","name":"200 ok","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"Bearer ","disabled":true},{"key":"Content-Type","value":"application/json;","disabled":true},{"key":"Accept","value":"application/json;","disabled":true}],"body":{"mode":"raw","raw":"{}"},"url":"{{url}}/commande/getpending"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n \"commande\": {\n \"588380\": {\n \"id\": 588380,\n \"compteId\": 1,\n \"reference\": \"order980191BB8-pack480\",\n \"iteration\": 0,\n \"consigne\": \"\",\n \"date\": \"5 May 2017\",\n \"groupedIn\": null,\n \"duplicatedFrom\": null,\n \"sibling\": [\n 588381\n ],\n \"contenu\": \"#amazonMontre Vibrante .., Montre Vibrante ..\",\n \"panier\": [\n {\n \"id\": null,\n \"desc\": \"Montre Vibrante Vibralite 12\",\n \"qte\": 1,\n \"poids\": 0.65,\n \"val\": 49.17,\n \"cat\": null,\n \"pays\": \"FRA\"\n },\n {\n \"id\": null,\n \"desc\": \"Montre Vibrante Mini Fleur\",\n \"qte\": 2,\n \"poids\": 0.98,\n \"val\": 15.17,\n \"cat\": null,\n \"pays\": \"FRA\"\n }\n ],\n \"long\": null,\n \"larg\": null,\n \"haut\": null,\n \"destinataireId\": 574290,\n \"adresseId\": 586694,\n \"paysId\": \"FRA\",\n \"nom\": \"Scotton\",\n \"prenom\": \"Christiane\",\n \"demand\":false,\n \"siteLIvraison\":{\"id\":\"015874\",\"type\":null},\n \"transport\":\"MDR\"\n },\n \"588381\": {\n \"id\": 588381,\n \"compteId\": 1,\n \"reference\": \"order9801BB8-pack481\",\n \"iteration\": 0,\n \"consigne\": \"\",\n \"date\": \"5 May 2017\",\n \"groupedIn\": null,\n \"duplicatedFrom\": null,\n \"sibling\": [\n 588380\n ],\n \"contenu\": \"#amazonMontre Vibrante .., Montre Vibrante ..\",\n \"panier\": [\n {\n \"id\": null,\n \"desc\": \"Montre Vibrante Vibralite 12\",\n \"qte\": 1,\n \"poids\": 0.65,\n \"val\": 49.17,\n \"cat\": null,\n \"pays\": \"FRA\"\n },\n {\n \"id\": null,\n \"desc\": \"Montre Vibrante Mini Fleur\",\n \"qte\": 2,\n \"poids\": 0.98,\n \"val\": 15.17,\n \"cat\": null,\n \"pays\": \"FRA\"\n }\n ],\n \"long\": null,\n \"larg\": null,\n \"haut\": null,\n \"destinataireId\": 574290,\n \"adresseId\": 586694,\n \"paysId\": \"FRA\",\n \"nom\": \"Scotton\",\n \"prenom\": \"Christiane\",\n \"demand\":null,\n \"siteLIvraison\":null,\n \"transport\":null\n }\n },\n \"compte\": {\n \"1\": {\n \"desc\": \"demo import api\",\n \"poidsEmballage\": 0\n }\n }\n}"}],"_postman_id":"0a7dfa28-7053-47bd-b23d-14c5c7432c82"},{"name":"Dupliquer une commande","id":"1db90a56-a364-4142-ad7d-a745b8bdab67","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n\t\"commande\":{\n\t\t\"id\":648809\n\t}\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/commande/duplicate","description":"Si l'envoi associé à une commande est supprimé, la commande est de nouveau considérée en attente
\n
Duplique une commande (même référence, panier, destinataire, etc ) en incrémentant un numéro d'itération.
\nUsage :
\nscinder l'expédition d'une commande en deux colis, par ex. contrainte de réassort ou de poids.
\nprévoir plusieurs expéditions pour une commande récurrente ou un abonnement.
\n\n\nSeule la commande initiale peut-être dupliquée N fois, les clones ne peuvent pas l'être.
\n
La réponse fourni (int) id interne de la nouvelle commande.
Il est ensuite possible d'utiliser l'appel commande/getiteration afin de retrouver toutes les itérations d'une commande, partageant soit l'id, la référence ou une expedition.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","name":"expedipro:{api:v2}","type":"collection"}},"urlObject":{"path":["commande","duplicate"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"99a7be0a-853e-4b0b-9efd-c03603293a8e","name":"201 ok : clone crée","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"Bearer ","disabled":true},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n\t\"commande\":{\n\t\t\"id\":2442259\n\t}\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/commande/duplicate"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n \"commande\":{\n \t\"id\": 2442470\n }\n}"},{"id":"6ed0cb91-b87d-4532-b51e-9778e0baadd4","name":"404 Not Found : not found or not duplicable","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"Bearer ","disabled":true},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"commande\": {\n \"id\": 648809\n }\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/commande/duplicate"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","name":"Content-Type","description":""}],"cookie":[],"responseTime":null,"body":"{\n \"errors\": [\n {\n \"status\": 404,\n \"code\": \"commande\",\n \"detail\": \"La commande ne peut pas être dupliquée, est-ce la commande initiale ?\"\n }\n ]\n}"}],"_postman_id":"1db90a56-a364-4142-ad7d-a745b8bdab67"},{"name":"Grouper 2 commandes","id":"7e4106c7-9c4a-446b-94d3-7e28454e149b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"commandeId\": 2442470,\n \"commandeRef\": null,\n \"into\": 2442471,\n\t\"commande\":{\n\t\t\"id\":2442470,\n \"reference\": null,\n \"into\": 2442471\n\t}\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/commande/group","description":"Grouper 2 commandes permet de tracer qu'une expédition contient 2 commandes pour le destinataire.
\nLors de l'appel /expedition/createforward il est préférable d'utiliser l'id de la commande ìnto.
Supprime un commande dans Expedipro, en conservant néanmoins les coordonnées du destinataire. A l'inverse de la suspension ( cf. POST Modifier une commande avec sendable:false), cette action n'est pas réversible.
La référence d'une commande supprimée redevient utilisable et n'est plus considérée comme un doublon en cas de réimportation de la même commande.
\n\n\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","name":"expedipro:{api:v2}","type":"collection"}},"urlObject":{"path":["commande","delete"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"44ef4ebe-59f6-4651-90cc-589d8263eb61","name":"200 Deleted","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{ \n \"commande\": {\n \"id\":2442470\n }\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/commande/delete"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"true"},{"id":"a60c85c9-080f-43c4-b374-3e3635288aee","name":"404 not found","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{ \n \"commande\": {\n \"id\":648809\n }\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/commande/delete"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"errors\": [\n {\n \"status\": \"not found\",\n \"code\": \"commande\",\n \"detail\": \"Aucune commande n'a été supprimée\"\n }\n ]\n}"}],"_postman_id":"068d76c0-873c-4e67-9f91-1cad2941b358"}],"id":"0644b242-5cc9-4753-a23d-1023666432c7","description":"Une commande déjà marquée comme expédiée (associée à un envoi non supprimé) ne peut pas être supprimée.
\n
Si un clône de commande existe, la commande originale ne peut pas être supprimée
Une commande est le reflet d'une commande client provenant de votre CMS ou d'un autre canal de vente. Elle fournie à Expedipro les informations essentielles pour une prochaine expédition : adresse du destinataire, contenu, caractéristiques physiques (poids, volume, etc.).
\n","event":[{"listen":"prerequest","script":{"type":"text/javascript","exec":[""],"id":"da62c048-71db-42c8-89c2-158a7e2fa529"}},{"listen":"test","script":{"type":"text/javascript","exec":[""],"id":"13e491bb-3042-489b-a3ff-c2625a7df9b5"}}],"_postman_id":"0644b242-5cc9-4753-a23d-1023666432c7","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","name":"expedipro:{api:v2}","type":"collection"}}},{"name":"Mode de livraison","item":[{"name":"Choisir le meilleur produit","id":"2fd210d8-2f76-470c-a4a5-38b4610172e5","protocolProfileBehavior":{"disabledSystemHeaders":{},"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n\t\"expedition\": {\n\t\t\"paysId\":\"FRA\",\n\t\t\"codePostal\":\"97500\",\n\t\t\"poids\":2.12,\n\t\t\"long\":30,\n\t\t\"larg\":40,\n\t\t\"haut\":30,\n\t\t\"val\":112.99\n\t}\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/expedition/advise","description":"Cet appel fourni la liste des produitId et les coûts associés avant toute expédition. Deux options pour votre requête :
renseigner la propriété expedipro.commandeId retournée lors de l'appel de la requête commande/create.
renseigner à minima quelques propriétés du schema expédition afin d'obtenir des informations pour une destination
\n\n\nLorsque
\nsiteLivraisonest renseigné, le choix des produits sera limité aux livraisons en point relais, par défaut, seules les livraisons à domicile sont choisies
Cet appel est optionnel et peut être minimal, puisqueexpedition:{codePostal:31000}}est valide.
\n\nLorsque
\nfournisseurIdest renseigné, les produits de ce fournisseurs seront sélectionnés en priorité (sous réserve de disponibilité).
Dans la réponse, qui suit le schema expédition, la propriété expedipro.produitId désigne le meilleur produit pour une destination : paysId | codePostal | poids | valeur. A noter, l'objet expedipro.comparison:{:{statut:\"best\"}} fourni aussi les autres solutions, évaluées comme moins intéressante.
Les tarifs sont par défaut HT, ils peuvent être configurés dans les préférences, via le client JS (navigateur).
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","name":"expedipro:{api:v2}","type":"collection"}},"urlObject":{"path":["expedition","advise"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"70442b0a-6805-40b0-8ea5-132891f2ecb7","name":"200 ok : comparaison produit pour ce pays et ce poids","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"expedition\": {\n \"paysId\":\"FRA\",\n \"codePostal\":\"97500\",\n \"poids\":6.12,\n \"long\":30,\n \"larg\":40,\n \"haut\":30,\n \"val\":112.99\n }\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/expedition/advise"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n \"expedition\": {\n \"id\": null,\n \"dateEtiquette\": 1744927200,\n \"poids\": 6.12,\n \"poidsVolume\": 7.2,\n \"produitId\": \"LOE\",\n \"contenu\": null,\n \"val\": 112.99,\n \"assurance\": null,\n \"livraison\": null,\n \"cabTransport\": null,\n \"cabRelation\": null,\n \"cabBrother\": null,\n \"piece\": [],\n \"constraint\": null,\n \"definition\": {\n \"volume\": true,\n \"contratId\": 256,\n \"domicile\": true,\n \"forward\": true\n },\n \"criteria\": false,\n \"comparison\": {\n \"HIG\": {\n \"status\": true,\n \"port\": 0.1,\n \"totalHt\": 0.1,\n \"spread\": -0.01,\n \"mismatch\": true\n },\n \"LOA\": {\n \"status\": true,\n \"port\": 0.1,\n \"totalHt\": 0.1,\n \"spread\": -0.01,\n \"mismatch\": true\n },\n \"LOE\": {\n \"status\": \"best\",\n \"port\": 0.1,\n \"totalHt\": 0.1,\n \"spread\": null,\n \"mismatch\": false\n },\n \"informatif\": {\n \"status\": true,\n \"port\": 0,\n \"totalHt\": 44.05,\n \"spread\": -0.36,\n \"mismatch\": false\n }\n },\n \"supplement\": {\n \"divers\": [\n {\n \"rq\": \"décarbonation\",\n \"montant\": 0.03\n }\n ],\n \"formalite\": [\n {\n \"rq\": \"douane\",\n \"montant\": 3.5\n }\n ]\n },\n \"cost\": {\n \"gross\": {\n \"port\": 0.1,\n \"suppl\": 3.53,\n \"totalHt\": 3.54,\n \"totalTtc\": null\n },\n \"net\": {\n \"port\": 0.1,\n \"suppl\": 3.53,\n \"totalHt\": 3.54,\n \"totalTtc\": null\n }\n },\n \"distribution\": null,\n \"siteLivraison\": null,\n \"stage\": null,\n \"commandeId\": null,\n \"commandeRef\": null,\n \"destinataireId\": null,\n \"adresseId\": null\n }\n}"},{"id":"ebc32d59-54f9-4411-b2e7-c34f6115e849","name":"417 Expectation Failed","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{}","options":{"raw":{"language":"json"}}},"url":"{{url}}/expedition/advise"},"status":"Expectation Failed","code":417,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\"errors\":[{\"status\":417,\"code\":\"consistency\",\"detail\":\"Vérifiez vos données\"}]}"}],"_postman_id":"2fd210d8-2f76-470c-a4a5-38b4610172e5"},{"name":"Comparer les tarifs","id":"0ac1981c-1fd9-40a5-bc57-51859ca041b9","protocolProfileBehavior":{"disabledSystemHeaders":{"content-type":true},"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"pays\": [\n \"GLP\",\n \"FRA\"\n ],\n \"date\":\"current\",\n \"forward\":false,\n \"poids\": [\n 500, 1000\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/expedition/comparisoncost","description":"Cette requête permet d'extraite les données tarifaires des frais de port pour chaque pays et poids. Il s'agit de la vesrion json du document pdf disponible dans le client web.
\nL'objet de requête peut être null ou contenir ces propriétés (conseillé) :
\npoids: null ou [(int) gramme] afin d'obtenir les tarifs pour ces poids, par exemple : [500, 1000] Lorsque rien n'est précisé c'est par défaut [250,500,750,1000,2000 ...]
pays: null ou [(string) paysiso3 ] afin d'obtenir les tarifs pour ces pays, par exemple : [\"FRA\",\"BEL\"] Lorsque rien n'est précisé c'est l'ensemble des pays. NB: les spécificités tarifaires de certaines régions de pays, par exemple les Canaries en Espagne sont ignorées.
En complément de ces deux principaux critères, il est aussi possible de préciser :
\nforward: est facultatif, par défaut true désigne les expéditions aller, lorsque false ce seront les tarifs des expéditions suite à rétractation client (ou reverse) qui seront calculées
date: null | \"current\" | (string) Y-m-d
produit: null ou [(string) produitId] afin de filtrer les produits retournés. Par exemple [\"MEH\"] ne retournera que les combinaisons de pays et de poids où ce produit est proposé; la liste des produits est fournie par l'appel Lister les produits
Important : cette requête peut dépasser le temps maximum autorisé. En cas de timeout, essayer un nombre plus restreint de pays ou de poids.
\nLa réponse est un objet d'objets dont les propriétés de niveau 1 sont les codes pays, puis chaque code produit est la clé d'un dernier objet associant poids et frais de port
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","name":"expedipro:{api:v2}","type":"collection"}},"urlObject":{"path":["expedition","comparisoncost"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"5b688f09-9289-4d3b-92bc-2e6991622607","name":"200 ok : tarifs des produits disponibles pour ce pays","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"pays\": [\n \"GLP\",\n \"FRA\"\n ],\n \"poids\": [\n 500, 1000\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/expedition/comparisoncost"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"GLP\": {\n \"HIG\": {\n \"500\": 0.1,\n \"1000\": 0.1\n },\n \"LOA\": {\n \"500\": 0.1,\n \"1000\": 0.1\n },\n \"LOE\": {\n \"500\": 0.1,\n \"1000\": 0.1\n }\n },\n \"FRA\": {\n \"HFG\": {\n \"500\": 0.1,\n \"1000\": 0.1\n },\n \"LFA\": {\n \"500\": 0.1,\n \"1000\": 0.1\n },\n \"LFE\": {\n \"500\": 0.1,\n \"1000\": 0.1\n },\n \"LFP\": {\n \"500\": 0.1,\n \"1000\": 0.1\n },\n \"MFH\": {\n \"500\": 0.1,\n \"1000\": 0.1\n },\n \"MFL\": {\n \"500\": 0.1,\n \"1000\": 0.1\n }\n }\n}"}],"_postman_id":"0ac1981c-1fd9-40a5-bc57-51859ca041b9"},{"name":"Trouver des points de livraison à proximité","id":"19273155-4b4a-4944-8a3f-8d6daeed7899","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{"user-agent":true,"connection":true}},"request":{"method":"GET","header":[{"key":"Custom-Version","value":"2"}],"body":{"mode":"raw","raw":"{\n \"adresse\":{\n \"adresse1\": \"35 rue de la grande fontaine\",\n \"codePostal\": 78100,\n \"paysId\": \"FRA\"\n },\n \"transport\": \"DPD\"\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/demand/listsite","description":"Obtenir la liste détaillée des points de livraison hors domicile (commerces ou consignes) les plus proches d'une adresse telle que définie dans le schema adresse.
Seules 3 principales propriétés sont requises.
En plus de cette adresse, précisez transport avec au choix un identifiant de fournisseur, de produit Expedipro (ou même d'alias de produit fournisseur). Cette propriété transport est identique à celle de l'objet commande .
NB: il est aussi possible d'ajouter les propriétés
\ndayForward afin de gérer la disponibilité du point relais (sur approx. 2 semaines) le colis n'est pas déposé le jour même.
type filtre les points de livraison aux seules consignes \"auto\" ou aux seuls commerces \"shop\"
limit précise le nombre max de résultats fournis (7 par défaut)
En l'absence d'identifiant du point de livraison (commerce ou consigne), vous pouvez demander au destinataire de choisir sur une page dédiée utilisant la widget du transporteur.
\nCette action est asynchrone, la propriété commande.siteLivraison sera mise à jour avec le choix du destinataire.
Il est possible de définir une url de callback afin de notifier votre système lorsque le choix a été effectué par le destinataire.
Précisez aussitransport avec au choix un identifiant de fournisseur, de produit Expedipro (ou même d'alias de produit fournisseur). Cette propriété transport est identique à celle de l'objet commande ; il est donc inutile de la préciser si la commande fournie déjà cette information.
\n\nun second appel avec la même propriété
\ncommandeIdprolongera le délai de choix du point relais ( par défaut 23 heures, vérifiable avec l'appel /demand/getlifespan
La réponse fournie l'url de la page de choix du point relais, spécifique à cette commandeId.
Dans le cas où vous souhaitez annuler la demande de choix de point de livraison, utiliser cet appel en précisant commandeId
Si le destinataire avait déjà reçu son email de choix, les liens de choix seront désactivés.
\nNb: la commande re-devient immédiatement expédiable dans Expedipro (comme à l'issue de la durée de vie normale de la demande de choix).
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","name":"expedipro:{api:v2}","type":"collection"}},"urlObject":{"path":["demand","delete"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"81ed0493-5172-45b1-ba3b-b2e8eb128964","name":"200 deleted","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"commandeId\": 2030954\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/demand/delete"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"true"}],"_postman_id":"68618212-571c-435d-8d95-9795b37a2402"},{"name":"Etat du choix du point de livraison","id":"3eaaf734-aab9-4b22-bcc2-93551eb0e073","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"{\n \"commandeId\": 1217477\n}"},"url":"{{url}}/demand/get","description":"Il est possible d'obtenir le détail, l'url et surtout le statut d'une demande de choix de point de livraison associée à une commandeId.
La réponse fournie un objet demand défini dans le schema webhook
\n\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","name":"expedipro:{api:v2}","type":"collection"}},"urlObject":{"path":["demand","get"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"15c455d6-957e-414b-a868-47920a679fa3","name":"200 ok : détail de la demande","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer ","type":"text","disabled":true},{"key":"Content-Type","value":"application/json","type":"text","disabled":true}],"url":"{{url}}/demand/getc"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"demand\": {\n \"action\": \"distributionChoix\",\n \"objetType\": \"commandeId\",\n \"objetId\": 1217477,\n \"token\": \"oAiuiOnE8h7bo2PgfNurv\",\n \"fournisseurId\": \"MDR\",\n \"status\": true,\n \"host\": \"{{url}}/support/delivery?id=oAiuiOnE8h7bo2PgfNurv\"\n }\n}"}],"_postman_id":"3eaaf734-aab9-4b22-bcc2-93551eb0e073"},{"name":"Lister les suppléments carburant","id":"0e9c7725-86d7-4339-9d40-0c4be80041a2","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{"content-type":true}},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":""},"url":"{{url}}/expedition/listsuppliertax","description":"\n
statusvaut true lorsque la demande est en-cours (l'url est accessible et le choix reste à faire). Lorsque le statut vaut false, cela signifie que soit le délai de choix a expiré, soit que le point de livraison a été choisi et quecommande.siteLivraisona été mis à jour : la commande est prête à être expédiée.
Cette requête permet d'extraite les données tarifaires des frais de port pour chaque pays et poids.
\nL'objet de requête peut être null ou contenir ces propriétés (conseillé) :
\npoids: null ou [(int) gramme] afin d'obtenir les tarifs pour ces poids, par exemple : [500, 1000] Lorsque rien n'est précisé c'est par défaut [250,500,750,1000,2000 ...]pays: null ou [(string) paysiso3 ] afin d'obtenir les tarifs pour ces pays, par exemple : [\"FRA\",\"BEL\"] Lorsque rien n'est précisé c'est l'ensemble des pays. NB: les spécificités tarifaires de certaines régions de pays, par exemple les Canaries en Espagne sont ignorées.En complément de ces deux principaux critères, il est aussi possible de préciser :
\nforward: est facultatif, par défaut true désigne les expéditions aller, lorsque false ce seront les tarifs des expéditions suite à rétractation client (ou reverse) qui seront calculéesdate: null | \"current\" | (string) Y-m-dproduit: null ou [(string) produitId] afin de filtrer les produits retournés. Par exemple [\"MEH\"] ne retournera que les combinaisons de pays et de poids où ce produit est proposé; la liste des produits est fournie par l'appel Lister les produitsImportant : cette requête peut dépasser le temps maximum autorisé. En cas de timeout, essayer un nombre plus restreint de pays ou de poids.
\nLa réponse est un objet d'objets dont les propriétés de niveau 1 sont les codes pays, puis chaque code produit est la clé d'un dernier objet associant poids et frais de port
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","name":"expedipro:{api:v2}","type":"collection"}},"urlObject":{"path":["expedition","listsuppliertax"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"e97f4fa7-fe3e-4cf1-b94e-7e716a9a03d2","name":"200 ok : Lister les suppléments carburant","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":""},"url":"{{url}}/expedition/listsuppliertax"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"DHL\": {\n \"carburant\": 0.19\n },\n \"DPD\": {\n \"carburant\": 0.11,\n \"aerien\": 0.18\n },\n \"MDR\": {\n \"carburant\": 0.08\n },\n \"POS\": {\n \"carburant\": 0.13,\n \"aerien\": 0.15\n }\n}"}],"_postman_id":"0e9c7725-86d7-4339-9d40-0c4be80041a2"},{"name":"Lister les pays","id":"eda8d387-ea4a-4513-b7f1-07f4f93b30d5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":""},"url":"{{url}}/expedition/listcountry","description":"La réponse fournie en clé les paysId (iso sur 3 chiffres) des destinations autorisées, avec en valeur le libellé du pays et son code iso sur 2 chiffres
La réponse fournie en clé les paysId (iso) des destinations autorisées, avec en valeur les produitId à priori utilisables (hors contraintes de poids, de valeur etc.)
Fourni la description de tous les produits d'expéditions disponibles pour votre compte. Les clés de l'objet reçu en réponse sont les produitId à utiliser lors des appels de choix des produits ou de création de documents.
Important : la réponse fournie la liste des pays ou ce produit est à priori utilisable, avec propriété pays dans la réponse. \nCependant les contraintes de poids et de volume ne sont pas prisent en compte et pourraient conduire à un échec lors de la création des documents d'expéditions. \nAfin de connaître les produits disponible pour une destination et des contraintes précises, il faut mieux utiliser POST Choisir le meilleur produit ci-dessus.
Fourni la description de tous les transporteurs et de leurs produits d'expéditions disponibles pour votre compte.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","name":"expedipro:{api:v2}","type":"collection"}},"urlObject":{"path":["expedition","listsupplier"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"17a2477a-cca6-40b2-af6e-c8eabb496446","name":"200 ok : liste des fournisseurs","originalRequest":{"method":"GET","header":[],"url":"{{url}}/expedition/listsupplier/"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"DPD\": {\n \"description\": \"DPD\",\n \"produit\": [\n \"DEB\",\n \"DEC\",\n \"DFB\",\n \"DFC\",\n \"DFP\",\n \"DFR\",\n \"DIB\"\n ],\n \"pays\": [\n \"AND\",\n \"AUT\",\n \"BEL\",\n \"BGR\",\n \"BIH\",\n \"CHE\",\n \"CZE\",\n \"DEU\",\n \"DNK\",\n \"ESP\",\n \"EST\",\n \"FIN\",\n \"GBR\",\n \"GRC\",\n \"HRV\",\n \"HUN\",\n \"IRL\",\n \"ITA\",\n \"LIE\",\n \"LTU\",\n \"LUX\",\n \"LVA\",\n \"NLD\",\n \"NOR\",\n \"POL\",\n \"PRT\",\n \"ROU\",\n \"SRB\",\n \"SVK\",\n \"SVN\",\n \"SWE\",\n \"UKR\",\n \"FRA\",\n \"MCO\",\n \"ABW\",\n \"AFG\",\n \"AGO\",\n \"AIA\",\n \"ALB\",\n \"ARE\",\n \"ARG\",\n \"ARM\",\n \"ASM\",\n \"ATG\",\n \"AUS\",\n \"AZE\",\n \"BDI\",\n \"BEN\",\n \"BES\",\n \"BFA\",\n \"BGD\",\n \"BHR\",\n \"BHS\",\n \"BLM\",\n \"BLR\",\n \"BLZ\",\n \"BMU\",\n \"BOL\",\n \"BRA\",\n \"BRB\",\n \"BRN\",\n \"BTN\",\n \"BWA\",\n \"CAF\",\n \"CAN\",\n \"CCK\",\n \"CHL\",\n \"CHN\",\n \"CIV\",\n \"CMR\",\n \"COD\",\n \"COG\",\n \"COK\",\n \"COL\",\n \"COM\",\n \"CPV\",\n \"CRI\",\n \"CUW\",\n \"CXR\",\n \"CYM\",\n \"CYP\",\n \"DJI\",\n \"DMA\",\n \"DOM\",\n \"DZA\",\n \"ECU\",\n \"EGY\",\n \"ERI\",\n \"ETH\",\n \"FJI\",\n \"FRO\",\n \"FSM\",\n \"GAB\",\n \"GEO\",\n \"GHA\",\n \"GIB\",\n \"GIN\",\n \"GLP\",\n \"GMB\",\n \"GNB\",\n \"GNQ\",\n \"GRD\",\n \"GRL\",\n \"GTM\",\n \"GUF\",\n \"GUM\",\n \"GUY\",\n \"HKG\",\n \"HND\",\n \"HTI\",\n \"ICA\",\n \"IDN\",\n \"IND\",\n \"IRQ\",\n \"ISL\",\n \"ISR\",\n \"JAM\",\n \"JOR\",\n \"JPN\",\n \"KAZ\",\n \"KEN\",\n \"KGZ\",\n \"KHM\",\n \"KIR\",\n \"KNA\",\n \"KOR\",\n \"KWT\",\n \"LAO\",\n \"LBN\",\n \"LBR\",\n \"LBY\",\n \"LCA\",\n \"LKA\",\n \"LSO\",\n \"MAC\",\n \"MAF\",\n \"MAR\",\n \"MDA\",\n \"MDG\",\n \"MDV\",\n \"MEX\",\n \"MHL\",\n \"MKD\",\n \"MLI\",\n \"MLT\",\n \"MMR\",\n \"MNE\",\n \"MNP\",\n \"MOZ\",\n \"MRT\",\n \"MSR\",\n \"MTQ\",\n \"MUS\",\n \"MWI\",\n \"MYS\",\n \"MYT\",\n \"NAM\",\n \"NCL\",\n \"NER\",\n \"NFK\",\n \"NGA\",\n \"NIC\",\n \"NPL\",\n \"NRU\",\n \"NZL\",\n \"OMN\",\n \"PAK\",\n \"PAN\",\n \"PER\",\n \"PHL\",\n \"PLW\",\n \"PNG\",\n \"PRI\",\n \"PRY\",\n \"PSE\",\n \"PYF\",\n \"QAT\",\n \"REU\",\n \"RUS\",\n \"RWA\",\n \"SAU\",\n \"SEN\",\n \"SGP\",\n \"SLB\",\n \"SLV\",\n \"SMR\",\n \"SOM\",\n \"SPM\",\n \"STP\",\n \"SUR\",\n \"SWZ\",\n \"SXM\",\n \"SYC\",\n \"TCA\",\n \"TCD\",\n \"TGO\",\n \"THA\",\n \"TON\",\n \"TTO\",\n \"TUN\",\n \"TUR\",\n \"TUV\",\n \"TWN\",\n \"TZA\",\n \"UGA\",\n \"URY\",\n \"USA\",\n \"UZB\",\n \"VAT\",\n \"VCT\",\n \"VEN\",\n \"VGB\",\n \"VIR\",\n \"VNM\",\n \"VUT\",\n \"WLF\",\n \"WSM\",\n \"ZAF\",\n \"ZMB\",\n \"ZWE\"\n ]\n },\n \"DHL\": {\n \"description\": \"DHL\",\n \"produit\": [\n \"HEG\",\n \"HER\",\n \"HFG\",\n \"HFR\",\n \"HIG\",\n \"HIR\"\n ],\n \"pays\": [\n \"AUT\",\n \"BEL\",\n \"BGR\",\n \"CYP\",\n \"CZE\",\n \"DEU\",\n \"DNK\",\n \"ESP\",\n \"EST\",\n \"FIN\",\n \"GRC\",\n \"HRV\",\n \"HUN\",\n \"IRL\",\n \"ITA\",\n \"LTU\",\n \"LUX\",\n \"LVA\",\n \"MLT\",\n \"NLD\",\n \"POL\",\n \"PRT\",\n \"ROU\",\n \"SVK\",\n \"SVN\",\n \"SWE\",\n \"FRA\",\n \"MCO\",\n \"ABW\",\n \"AFG\",\n \"AGO\",\n \"AIA\",\n \"ALB\",\n \"AND\",\n \"ARE\",\n \"ARG\",\n \"ARM\",\n \"ASM\",\n \"ATG\",\n \"AUS\",\n \"AZE\",\n \"BDI\",\n \"BEN\",\n \"BES\",\n \"BFA\",\n \"BGD\",\n \"BHR\",\n \"BHS\",\n \"BIH\",\n \"BLM\",\n \"BLR\",\n \"BLZ\",\n \"BMU\",\n \"BOL\",\n \"BRA\",\n \"BRB\",\n \"BRN\",\n \"BTN\",\n \"BWA\",\n \"CAF\",\n \"CAN\",\n \"CHE\",\n \"CHL\",\n \"CHN\",\n \"CIV\",\n \"CMR\",\n \"COD\",\n \"COG\",\n \"COK\",\n \"COL\",\n \"COM\",\n \"CPV\",\n \"CRI\",\n \"CUB\",\n \"CUW\",\n \"CYM\",\n \"DJI\",\n \"DMA\",\n \"DOM\",\n \"DZA\",\n \"ECU\",\n \"EGY\",\n \"ERI\",\n \"ETH\",\n \"FJI\",\n \"FLK\",\n \"FRO\",\n \"FSM\",\n \"GAB\",\n \"GBR\",\n \"GEO\",\n \"GGY\",\n \"GHA\",\n \"GIB\",\n \"GIN\",\n \"GLP\",\n \"GMB\",\n \"GNB\",\n \"GNQ\",\n \"GRD\",\n \"GRL\",\n \"GTM\",\n \"GUF\",\n \"GUM\",\n \"GUY\",\n \"HKG\",\n \"HND\",\n \"HTI\",\n \"ICA\",\n \"IDN\",\n \"IND\",\n \"IRN\",\n \"IRQ\",\n \"ISL\",\n \"ISR\",\n \"JAM\",\n \"JEY\",\n \"JOR\",\n \"JPN\",\n \"KAZ\",\n \"KEN\",\n \"KGZ\",\n \"KHM\",\n \"KIR\",\n \"KNA\",\n \"KOR\",\n \"KWT\",\n \"LAO\",\n \"LBN\",\n \"LBR\",\n \"LBY\",\n \"LCA\",\n \"LIE\",\n \"LKA\",\n \"LSO\",\n \"MAC\",\n \"MAF\",\n \"MAR\",\n \"MDA\",\n \"MDG\",\n \"MDV\",\n \"MEX\",\n \"MHL\",\n \"MKD\",\n \"MLI\",\n \"MMR\",\n \"MNE\",\n \"MNG\",\n \"MNP\",\n \"MOZ\",\n \"MRT\",\n \"MSR\",\n \"MTQ\",\n \"MUS\",\n \"MWI\",\n \"MYS\",\n \"MYT\",\n \"NAM\",\n \"NCL\",\n \"NER\",\n \"NGA\",\n \"NIC\",\n \"NIU\",\n \"NOR\",\n \"NPL\",\n \"NRU\",\n \"NZL\",\n \"OMN\",\n \"PAK\",\n \"PAN\",\n \"PER\",\n \"PHL\",\n \"PLW\",\n \"PNG\",\n \"PRI\",\n \"PRK\",\n \"PRY\",\n \"PYF\",\n \"QAT\",\n \"REU\",\n \"RUS\",\n \"RWA\",\n \"SAU\",\n \"SDN\",\n \"SEN\",\n \"SGP\",\n \"SHN\",\n \"SLB\",\n \"SLE\",\n \"SLV\",\n \"SMR\",\n \"SOM\",\n \"SPM\",\n \"SRB\",\n \"SSD\",\n \"STP\",\n \"SUR\",\n \"SWZ\",\n \"SXM\",\n \"SYC\",\n \"SYR\",\n \"TCA\",\n \"TCD\",\n \"TGO\",\n \"THA\",\n \"TJK\",\n \"TKM\",\n \"TLS\",\n \"TON\",\n \"TTO\",\n \"TUN\",\n \"TUR\",\n \"TUV\",\n \"TWN\",\n \"TZA\",\n \"UGA\",\n \"UKR\",\n \"UNK\",\n \"URY\",\n \"USA\",\n \"UZB\",\n \"VAT\",\n \"VCT\",\n \"VEN\",\n \"VGB\",\n \"VIR\",\n \"VNM\",\n \"VUT\",\n \"WLF\",\n \"WSM\",\n \"YEM\",\n \"ZAF\",\n \"ZMB\",\n \"ZWE\"\n ]\n },\n \"POS\": {\n \"description\": \"Colissimo\",\n \"produit\": [\n \"LFA\",\n \"LFE\",\n \"LFP\",\n \"LFR\",\n \"LIA\",\n \"LIE\",\n \"LIR\",\n \"LOA\",\n \"LOE\",\n \"LOR\"\n ],\n \"pays\": [\n \"FRA\",\n \"MCO\",\n \"AND\",\n \"BEL\",\n \"CHE\",\n \"ABW\",\n \"AFG\",\n \"AGO\",\n \"AIA\",\n \"ALA\",\n \"ALB\",\n \"ARE\",\n \"ARG\",\n \"ARM\",\n \"ASC\",\n \"ASM\",\n \"ATA\",\n \"ATG\",\n \"AUS\",\n \"AUT\",\n \"AZE\",\n \"BDI\",\n \"BEN\",\n \"BES\",\n \"BFA\",\n \"BGD\",\n \"BGR\",\n \"BHR\",\n \"BHS\",\n \"BIH\",\n \"BLR\",\n \"BLZ\",\n \"BMU\",\n \"BOL\",\n \"BRA\",\n \"BRB\",\n \"BRN\",\n \"BTN\",\n \"BVT\",\n \"BWA\",\n \"CAF\",\n \"CAN\",\n \"CCK\",\n \"CHL\",\n \"CHN\",\n \"CIV\",\n \"CMR\",\n \"COD\",\n \"COG\",\n \"COK\",\n \"COL\",\n \"COM\",\n \"CPV\",\n \"CRI\",\n \"CUB\",\n \"CUW\",\n \"CXR\",\n \"CYM\",\n \"CYP\",\n \"CZE\",\n \"DEU\",\n \"DJI\",\n \"DMA\",\n \"DNK\",\n \"DOM\",\n \"DZA\",\n \"ECU\",\n \"EGY\",\n \"ERI\",\n \"ESH\",\n \"ESP\",\n \"EST\",\n \"ETH\",\n \"FIN\",\n \"FJI\",\n \"FLK\",\n \"FRO\",\n \"FRS\",\n \"FSM\",\n \"GAB\",\n \"GBR\",\n \"GEO\",\n \"GGY\",\n \"GHA\",\n \"GIB\",\n \"GIN\",\n \"GMB\",\n \"GNB\",\n \"GNQ\",\n \"GRC\",\n \"GRD\",\n \"GRL\",\n \"GTM\",\n \"GUM\",\n \"GUY\",\n \"HKG\",\n \"HND\",\n \"HRV\",\n \"HTI\",\n \"HUN\",\n \"ICA\",\n \"IDN\",\n \"IMN\",\n \"IND\",\n \"IRL\",\n \"IRN\",\n \"IRQ\",\n \"ISL\",\n \"ISR\",\n \"ITA\",\n \"JAM\",\n \"JEY\",\n \"JOR\",\n \"JPN\",\n \"KAZ\",\n \"KEN\",\n \"KGZ\",\n \"KHM\",\n \"KIR\",\n \"KNA\",\n \"KOR\",\n \"KWT\",\n \"LAO\",\n \"LBN\",\n \"LBR\",\n \"LBY\",\n \"LCA\",\n \"LIE\",\n \"LKA\",\n \"LSO\",\n \"LTU\",\n \"LUX\",\n \"LVA\",\n \"MAC\",\n \"MAR\",\n \"MDA\",\n \"MDG\",\n \"MDV\",\n \"MEX\",\n \"MHL\",\n \"MKD\",\n \"MLI\",\n \"MLT\",\n \"MMR\",\n \"MNE\",\n \"MNG\",\n \"MNP\",\n \"MOZ\",\n \"MRT\",\n \"MSR\",\n \"MUS\",\n \"MWI\",\n \"MYS\",\n \"NAM\",\n \"NER\",\n \"NFK\",\n \"NGA\",\n \"NIC\",\n \"NIU\",\n \"NLD\",\n \"NOR\",\n \"NPL\",\n \"NRU\",\n \"NZL\",\n \"OMN\",\n \"PAK\",\n \"PAN\",\n \"PCN\",\n \"PER\",\n \"PHL\",\n \"PLW\",\n \"PNG\",\n \"POL\",\n \"PRI\",\n \"PRK\",\n \"PRT\",\n \"PRY\",\n \"PSE\",\n \"QAT\",\n \"ROU\",\n \"RUS\",\n \"RWA\",\n \"SAU\",\n \"SDN\",\n \"SEN\",\n \"SGP\",\n \"SGS\",\n \"SHN\",\n \"SJM\",\n \"SLB\",\n \"SLE\",\n \"SLV\",\n \"SMR\",\n \"SOM\",\n \"SRB\",\n \"SSD\",\n \"STP\",\n \"SUR\",\n \"SVK\",\n \"SVN\",\n \"SWE\",\n \"SWZ\",\n \"SXM\",\n \"SYC\",\n \"SYR\",\n \"TCA\",\n \"TCD\",\n \"TGO\",\n \"THA\",\n \"TJK\",\n \"TKL\",\n \"TKM\",\n \"TLS\",\n \"TON\",\n \"TTO\",\n \"TUN\",\n \"TUR\",\n \"TUV\",\n \"TWN\",\n \"TZA\",\n \"UGA\",\n \"UKR\",\n \"UMI\",\n \"UNK\",\n \"URY\",\n \"USA\",\n \"UZB\",\n \"VAT\",\n \"VCT\",\n \"VEN\",\n \"VGB\",\n \"VIR\",\n \"VNM\",\n \"VUT\",\n \"WSM\",\n \"YEM\",\n \"ZAF\",\n \"ZMB\",\n \"ZWE\",\n \"ATF\",\n \"BLM\",\n \"GLP\",\n \"GUF\",\n \"MAF\",\n \"MTQ\",\n \"MYT\",\n \"NCL\",\n \"PYF\",\n \"REU\",\n \"SPM\",\n \"WLF\"\n ]\n },\n \"MDR\": {\n \"description\": \"Mondial Relay\",\n \"produit\": [\n \"MEH\",\n \"MEL\",\n \"MER\",\n \"MFC\",\n \"MFL\",\n \"MFR\"\n ],\n \"pays\": [\n \"AUT\",\n \"BEL\",\n \"DEU\",\n \"ESP\",\n \"ITA\",\n \"LUX\",\n \"NLD\",\n \"PRT\",\n \"FRA\",\n \"MCO\"\n ]\n }\n}"}],"_postman_id":"1a36c2ef-74e6-44bc-b220-bdc2996adc85"}],"id":"d82be397-8c44-45f1-9876-ef538e77ad74","description":"Expedipro vous aide à optimiser votre expédition selon vos préférences : coût ou service. Les critères pris en compte sont principalement :
\nle pays de destination
\nla tranche de poids
\nun seuil de valeur de la marchandise
\nun point relais de livraison
\nune dimension ou un volume
\nAfin de profiter au mieux d'Expedipro, nous recommandons de :
\ncréer une règle spécifique : contactez-nous afin par exemple de privilégier une livraison sans signature systématique en deçà d’une certaine valeur.
\nutiliser les requêtes API /www.expedipro.com/expedition/\\* sans préciser la propriété produitId.
Pour une livraison hors domicile - en point relais -, trois possibilités sont offertes selon que vous connaissiez l'identifiant du point relais ou que vous souhaitiez laisser ce choix au destinataire :
\nvous renseignez l'identifiant du point relais que vous connaissez dans la propriété siteLivraison:{}de l'objet commande (ouexpedition ). La propriété transport (ou fournisseurId) doit aussi être renseignée. NB: siteLivraison accepte la valeur \"nearest\", afin de choisir automatiquement le point le plus proche de l'adresse du destinataire
vous souhaitez que le destinataire choisisse le point relais sur une page dédiée, en recevant l'url de choix par email.
\nvous souhaitez obtenir la liste textuelle des points relais proche de l'adresse du destinataire.
\nListe le(s) déclaration(s) douanière(s) pour ce pays. Le code postal permet de gérer les DOM-TOM
\n\n\nNous recommandons de vérifier si des formalités douanières sont nécessaires avant chaque demande d'étiquettes
\n
Le code pays est le code ISO 3166-1 alpha-3 https://fr.wikipedia.org/wiki/ISO_3166-1
\n\n\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","name":"expedipro:{api:v2}","type":"collection"}},"urlObject":{"path":["douane","advise"],"host":["{{url}}"],"query":[{"key":"paysId","value":"FRA"},{"key":"codePostal","value":"97200"},{"key":"val","value":"null"}],"variable":[]}},"response":[{"id":"ae855a58-b93c-42a3-8af7-9fc485e99cb1","name":"200 ok : statut douane","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{url}}/douane/advise?paysId=FRA&codePostal=97200&val=null","host":["{{url}}"],"path":["douane","advise"],"query":[{"key":"paysId","value":"FRA"},{"key":"codePostal","value":"97200"},{"key":"val","value":"null"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"douane\": {\n \"document\": [\n \"CN23\"\n ],\n \"paysId\": \"MTQ\"\n }\n}"}],"_postman_id":"1d22676b-37fe-404b-8436-1b146819832e"},{"name":"Détail d'une déclaration","id":"9e055cbe-b545-400b-bc33-c91832cfb59f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"{\n \t\"expeditionId\": 272310,\n \"douaneId\": null\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/douane/get","description":"cette requête peut aussi être appelée en
\nPOSTavec un objet JSON {\"douane\":{\"paysId\":(string),\"codePostal\":(string)}}
Obtenir le détail de la déclaration douanière d'une expédition déjà effectuée. Il n'est plus possible de modifier cette déclaration. L'id douane est aussi l'id de l'expédition.
\n\n\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","name":"expedipro:{api:v2}","type":"collection"}},"urlObject":{"path":["douane","get"],"host":["{{url}}"],"query":[{"disabled":true,"key":"id","value":"433272"}],"variable":[]}},"response":[{"id":"cc60fc94-9c1c-4ba8-967b-5ab50a2d8f34","name":"200 douane entity ","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer ","disabled":true},{"key":"Content-Type","value":"application/json","type":"text"}],"url":{"raw":"{{url}}/douane/get","host":["{{url}}"],"path":["douane","get"],"query":[{"key":"id","value":"272310","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/vnd.api+json","description":""}],"cookie":[],"responseTime":null,"body":"{\n \"douane\": {\n \"id\": 272310,\n \"nature\": \"envoi commercial\",\n \"tvaImport\": null,\n \"observation\": null,\n \"facture\": \"171-5431472-2276361\",\n \"certificat\": null,\n \"licence\": null,\n \"totalTransport\": null,\n \"totalTva\": null,\n \"totalHt\": 1,\n \"panier\": [\n {\n \"sku\": \"SW-18-185\", \n \"desc\": \"BOOKS\",\n \"qte\": 1,\n \"poids\": 0.4,\n \"val\": 18.45,\n \"cat\": 490199,\n \"pays\": \"FRA\"\n }\n ],\n \"attachment\": null\n }\n}"},{"id":"b0c33e7c-451a-4493-858f-5e1723be9b3a","name":"404 Not Found : douane inconnue","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer ","disabled":true},{"key":"Content-Type","value":"application/json","type":"text"}],"url":{"raw":"{{url}}/douane/get","host":["{{url}}"],"path":["douane","get"],"query":[{"key":"id","value":"{\n \t\"expeditionId\": 2698735\n}","disabled":true}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","name":"Content-Type","description":""}],"cookie":[],"responseTime":null,"body":"{\n \"errors\": [\n {\n \"status\": 404,\n \"code\": \"not found\",\n \"detail\": \"douane inconne\"\n }\n ]\n}"}],"_postman_id":"9e055cbe-b545-400b-bc33-c91832cfb59f"},{"name":"Pré-valider une déclaration ","id":"9ff43490-68f4-4b83-8815-b0d49f6bd904","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"douane\": {\n \"nature\": \"envoi commercial\",\n \"reference\": null,\n \"observation\": null,\n \"docLicence\": null,\n \"docCertificat\": null,\n \"docFacture\": null,\n \"panier\": [\n {\n \"desc\": \"Télémétrie 5Ag azul\",\n \"qte\": 1,\n \"val\": 151,\n \"poids\": 5.33,\n \"cat\": null,\n \"pays\": \"France\"\n }\n ]\n }\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/douane/check","description":"cette requête peut aussi être appelée en
\nPOSTavec un objet JSON {\"douane\":{\"id\":(int)}}
Les déclarations douanières sont enregistrées lors de l'appel /expedition/createforward . Il est néanmoins possible de pré-valider les informations douanières afin d'éviter un échec lors de la création des documents de transport.
\nImportant : par défaut la propriété douane.nature est \"envoi commercial\". Si vous souhaitez préciser \"cadeau\" ou \"echantillon\", vous devrez fournir un objet douane dans la propriété expedition.douane complet lors de l'appel /expedition/createforward
La propriété panier est une collection de schema item comme la propriété commande.panier,
Pour certaines destinations et transporteur, vous devez fournir les justificatifs douaniers. Par exemple, les Colissimos vers l'outre-mer (GUF|GLP|MTQ|MYT|REU) doivent être accompagnés de factures pdf.
Cela s'effectue en 3 étapes :
Faites un appel expedition/create afin de créer une expédition, en renseignant la propriété expedition.douane comme habituellement,
Faites un appel vers douane/attach avec un objet attachment contenant à minima les propriétés expeditionId (reçu lors du premier appel) et semantic avec une de ces valeur : \"facture\"|\"certificat\"|\"licence\".
Vous recevez en réponse, un objet attachment avec la propriété links.upload à usage unique et spécifique à votre expédition. Vous pouvez fournir le document nécessaire. Par exemple :
curl GET(or POST) --form 'file=\"@localFile or http://your.path\"' 'links.upload provided'
Le document douanier ( principalement cn23 ) est requis pour certaines destinations hors UE, mais aussi pour des territoires dans l'UE mais hors de l'union douanière ( Canaries par ex). \nUne entité douane est composée d'une collection de sous-entités item \nL'objet douane est défini dans le schema douane et l'objet item dans le schema item
\n\n","event":[{"listen":"prerequest","script":{"type":"text/javascript","exec":[""],"id":"b08bc6c6-4ef4-41cd-bc4b-4bc064aa40ed"}},{"listen":"test","script":{"type":"text/javascript","exec":[""],"id":"73935d25-e101-4ebd-a49b-03390788e10a"}}],"_postman_id":"d6091421-2723-4879-b3ec-e6e2df5e50fd","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","name":"expedipro:{api:v2}","type":"collection"}}},{"name":"Expédition","item":[{"name":"Obtenir une étiquette aller","id":"5f500975-b1c8-4a64-8fd8-1ccdedac8812","protocolProfileBehavior":{"disabledSystemHeaders":{},"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n\t\"expedition\":\n\t{\n\t\t\"produitId\":\"LIE\",\n\t\t\"douane\":\n\t\t{\n\t\t\t\"nature\":\"envoi commercial\",\n\t\t\t\"eori\":\"FR79264527400013\",\n\t\t\t\"tvaimport\":null,\n\t\t\t\"facture\":\"7533922\"\n\t\t}\n\t},\n \"commande\":\n\t{\n\t\t\"entreprise\":false,\n\t\t\"prenom\":\"\",\n\t\t\"nom\":\"Marc Diamant\",\n\t\t\"instruction\":\"\",\n\t\t\"telephoneM\":\"0211573969\",\n\t\t\"email\":\"8@marketplace.amazon.fr\",\n\t\t\"reference\":\"226_12:60_25927990\",\n\t\t\"date\":\"2025-10-02\",\n\t\t\"adresse1\":\"CHEMIN DU PRE-GABET 48\",\n\t\t\"adresse2\":null,\n\t\t\"codePostal\":\"1288 \",\n\t\t\"ville\":\"genè8ve\",\n\t\t\"pays\":\"CH\",\n \"transport\": \"DHL\",\n\t\t\"panier\":\n\t\t[\n\t\t\t{\n\t\t\t\t\"desc\":\"BATTERIES\",\n\t\t\t\t\"qte\":1,\n\t\t\t\t\"val\":98.7,\n\t\t\t\t\"poids\":0.1,\n\t\t\t\t\"cat\":\"490199\",\n\t\t\t\t\"pays\":\"France\"\n\t\t\t}\n\t\t],\n \"compteId\" : 2\n\t}\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/expedition/createforward","description":"la collection d'objet
\nitemest exactement celle fournie dans la propriétépanier\nassociée aux objetscommandeetexpedition.
Cet appel permet d'obtenir les documents d'expéditions (étiquettes et déclaration douane le cas échéants).
\nL'objet expedition peut avoir trois formes :
un objet expedition:{commandeId:} afin d'obtenir les documents d'expéditions pour cette commande,
une collection de expedition:[{commandeId:},{commandeRef:},...] afin d'obtenir les documents regroupant plusieurs commandes. Il y aura alors un document pour toutes les étiquettes et un autre pour toutes les cn23. Si une commande n'est pas expédiable (e.g. poids excessif) la collection entière sera rejetée
un objet expédition fournissant un schema expédition , comme dans l'appel /expedition/advise/
\nIl est possible de créer une commande directement lors de l'appel expedition/create, en fournissant un object commande au coté de l'objet expedition; un exemple est fourni pour cet appel dans 201 ok : one step only. Néanmoins, utiliser commande/create présente l'avantage d'obtenir des messages d'erreurs plus détaillés.
Pour désigner une commande, nous offrons deux identifiants :
\ncommandeId fait référence à la propriété commande.commandeId retournée lors de l'appel de la requête commande/create.
commandeRef fait référence à la propriété commande.reference fournie lors de l'appel à POST Importer une commande.
\n\nImportant: lorsque un id | ref d'une commande est précisé, ce sont, par défaut, les valeurs des propriétés de cette commande qui sont utilisées lors de l'expédition : poids, valeur du panier, transport, siteLivraison...
\n
Il reste possible de spécifier toutes les propriétés de l'objetexpedition, puisque la priorité deexpeditionest supérieure àcommande.
\n\nNous recommandons de bien renseigner l'objet
\ncommandeet de rendre l'objetexpeditionle plus léger possible, et d'éviter -sauf raison particulière- de fournir une valeur différente pour une même propriété entre les 2 objets, par ex. siteLivraison
\n\nLes déclarations douanières -si nécessaires- sont gérées automatiquement grâce à la propriété
\ncommande.panierfourni lors de l'appelPOST Créer une commande. A défaut, vous pouvez les fournir lors de l'appel avec la propriétéexpedition.douane.panierqui est une collection d'objetsitemdéfinis dans le schema item.
La réponse contient deux propriétés :
\nexpedition:{\"id\":(int),\"cab\":(string)} ou idest à réutiliser lors d'un éventuel appel à GET Détail d'un envoi et cab est le numéro de suivi du colis
document:[{\"semantic:\"label\",\"content\":(string)},{}] .
La propriété semantic peut valoir \"label\" pour l'étiquette d'expédition, \"reverse\" pour l'étiquette de retour, \"custom\" pour le document douanier.
La propriété content fournie par défault l'url ou trouver le pdf des 1 ou N pages associées à la sémantique. Contactez-nous si vous souhaitez que l'option labelStream soit activée, afin de recevoir le contenu binaire du pdf, encodé en base64.
\n\nSi la réponse n’est pas HTTP 201, un objet
\nerrors:[{},{}]fournira les raisons empêchant la création de cette expédition.
Pour information, l'appel /expedition/create existe aussi, dans ce cas ajoutez une propriété expedition.forward: true (ou false pour reverse).
La requête doit fournir un objet expedition défini dans le schema expédition. Comme POST Obtenir une étiquette \"aller\", elle peut prendre la forme d'un simple objet ou d'une collection d'objet expedition.
\n\nUne étiquette retour est préférablement liée à une étiquette aller. L'adresse de retour sera celle du site d'expédition \"aller\" et l'expéditeur sera le destinataire \"aller\".
\n
La relation avec l'expédition \"aller\" est fournie en requête par au moins une de ces propriétés : \"id\" (ou \"expeditionId\"), \"cabTransport\" (non recommandé), \"commandeId\", \"commandeRef\" , c'est à dire les identifiants fournis par la réponse de POST Obtenir une étiquette \"aller\". Il est préférable que le cabTransport ne soit pas plus ancien de 2 mois, ceci afin que le transporteur ne l'ai pas déjà réutilisé pour une autre expédition.
A défaut de relation avec une expédition \"aller\", les propriétés habituelles de l'objet expedition, poids, assurance ... doivent être fournies.
La réponse contient deux propriétés :
\nexpedition:{\"id\":(int),\"cab\":(string)} ou idest à réutiliser lors d'un éventuel appel à GET Détail d'un envoi et cab est le numéro de suivi du colis
document:[{\"semantic:\"label\",\"content\":(string)},{}] ou \"label\" désigne le document pour l'expédition.
\n\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","name":"expedipro:{api:v2}","type":"collection"}},"urlObject":{"path":["expedition","createreverse"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"d99ef5b7-5668-463f-b4d0-b38f934b9681","name":"201 ok : description étiquette crée","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"expedition\": {\n \"id\": \"236544\"\n }\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/expedition/createreverse"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"The mime type of this content"}],"cookie":[],"responseTime":null,"body":"{\n \"expedition\": {\n \"cab\": \"8R30078376000\",\n \"cabBrother\": null,\n \"cabRelation\": null,\n \"id\": 83681544,\n \"produitId\": \"LFR\",\n \"document\": [\n \"label\"\n ]\n },\n \"document\": [\n {\n \"semantic\": \"label\",\n \"format\": \"pdf\",\n \"dimension\": \"A4\",\n \"orientation\":\"P\",\n \"stream\": false,\n \"content\": \"/document/label_9551_1522968117.040379_8985.pdf\"\n }\n ]\n}"},{"id":"8fa5ce35-5387-493f-8c60-5666ac05776c","name":"417 consistency : identifiant aller manquant","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"expedition\": {\n \"id\": null,\n \"cab\": null,\n \"assType\": \"av\",\n \"val\" : \"100\"\n }\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/expedition/createreverse"},"status":"Expectation Failed","code":417,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/vnd.api+json","description":""}],"cookie":[],"responseTime":null,"body":"{\n \"errors\": [\n {\n \"status\": 417,\n \"code\": \"consistency\",\n \"detail\": \"Vérifiez vos données\"\n }\n ]\n}"}],"_postman_id":"2c1ed0e1-6be4-4ae6-8050-c7be32cbd91c"},{"name":"Détail d'une expédition","id":"12b8cc74-2039-40f2-9910-16babbb08661","protocolProfileBehavior":{"disabledSystemHeaders":{"connection":true,"accept-encoding":true,"accept":true,"user-agent":true},"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"{\n\t\"expeditionId\": 2698735,\n \"cabTransport\":null,\n \"expedition\": {\n \t\"id\": 2698735,\n \"cabTransport\":null\n }\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/expedition/get","description":"Selon les transporteurs, le destinataire pourra recevoir un email avec le pdf de l'étiquette à imprimer.
\n
Cette requête permet d'obtenir les détails d'une expédition déjà effectuée, en utilisant soit la propriété expeditionId (ou sous la forme expedition.id), soit cabTransport (ou sous la forme expedition.cabTransport)
La réponse est un schema expedition
avec des informations de poids, de coûts, etc.
La propriété expedition.distribution est un schema distribution. Ce même schema est aussi utiisé dans la réponse de l'appel /expedition/trace
Supprime une expédition, en conservant néanmoins la commande et les coordonnées du destinataire.
\nCette action est irréversible et l'étiquette papier ne doit plus être utilisée.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","name":"expedipro:{api:v2}","type":"collection"}},"urlObject":{"path":["expedition","delete"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"3395cb11-8c58-479c-b3bd-ddeb79cfa8e0","name":"200 ok : deleted","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{ \n \"expedition\": {\n \"id\":1216048\n }\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/expedition/delete"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"true"},{"id":"354a588a-a434-4cfe-a691-09c6d432a5a5","name":"409 conflict : expédition non supprimée","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{ \n \"expedition\": {\n \"id\":1648809\n }\n}"},"url":"{{url}}/expedition/delete"},"status":"Conflict","code":409,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"errors\": [\n {\n \"status\": 409,\n \"code\": \"expedition\",\n \"detail\": \"expédition non supprimée\"\n }\n ]\n}"}],"_postman_id":"6b6092ad-1d39-488d-8dd2-b532b7995f5e"}],"id":"9720c538-3995-4099-b911-91b8e57470c5","description":"Une expédition est l'association d'un destinataire avec les caractéristiques d'un colis, éventuellement reliées à une commande client préalablement importée.
\nLe processus se décompose en plusieurs étapes :
\n(optionnel) POST Créer une commande client, permet aussi de créer le destinataire ainsi que le panier de produits qui sera utilisé pour les éventuelles déclarations douanières.
(optionnel) POST Choisir un produit afin d’obtenir les tarifs et les contraintes d'un tuple pays | poids | valeur (en cas d’assurance)
(requis) POST Obtenir une étiquette en fournissant plus ou moins d'informations (selon les 2 étapes précédentes). Vous obtiendrez en réponse un document pdf prêt à être imprimé.
(requis) POST Annoncer mes colis pour déclencher, une fois par jour par exemple, les échanges d'informations avec les transporteurs et obtenir une preuve de dépôt. Vous obtiendrez en réponse un document pdf prêt à être imprimé.
| ID | ","Fournisseur | ","Envoi | ","Piece | ","Reference | ","Date | ","Refreshable | ","
|---|---|---|---|---|---|---|
| {{id}} | ","{{fournisseur.[0]}} | ","{{envoi.[0]}} | ","{{piece}} | ","{{reference}} | ","{{date}} | ","{{refreshable}} | ","
Les propriétés de l'objet collecte sont définies dans le schema collecte.
Un seul critère est accepté par appel :
\ncollecte:{fournisseur:[(string)\"POS\"]} afin de créer une collecte avec toutes les expéditions disponibles pour ce transporteur
collecte:{envoi:[(int),(int)]} afin de créer une collecte avec certaines expéditions
Les collectes étant mono-transporteurs le critère envoi peut dans certains cas créer plusieurs collectes, selon les transporteurs des exoéditions.
La réponse fournie un objet collecte contenant une collection de collectes (dans les cas ou plusieurs transporteurs sont impliqués) fournissant entre autres l'id Expedipro et éventuellement la reference transporteur.
L'id Expedipro fourni en réponse doit être utilisé afin d'obtenir le descriptif du contenu au format pdf avec un appel collecte/getdocument.
\nNB: la propriété refreshable vaut true lorsqu'il est possible d'utiliser un appel collecte/refresh (à la double condition que le transporteur l'autorise et d'un délai d'attente entre 2 demandes)
Lorsqu'un transporteur n'a pas effectué la collecte des colis tel que prévue, il est possible de rafraichir la demande de ramasse des colis pour le lendemain.
\nNB: la propriété collecte.refreshable doit valoir true
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","name":"expedipro:{api:v2}","type":"collection"}},"urlObject":{"path":["collecte","refresh"],"host":["{{url}}"],"query":[{"disabled":true,"description":{"content":"id expedipro de la collecte, retourné par collecte/create
\n","type":"text/plain"},"key":"id","value":""},{"disabled":true,"description":{"content":"id transporteur de la collecte, retourné par collecte/create
\n","type":"text/plain"},"key":"reference","value":""}],"variable":[]}},"response":[{"id":"41168b9e-627b-42ad-99bb-7224fe8a5ab3","name":"404 mauvais identifiant","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n\t\"collecte\": {\n\t\t\"id\": null,\n \"reference\" : \"PRG250303038049\"\n\t}\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"{{url}}/collecte/refresh","host":["{{url}}"],"path":["collecte","refresh"],"query":[{"key":"id","value":"","description":"id expedipro de la collecte, retourné par collecte/create","disabled":true},{"key":"reference","value":"","description":"id transporteur de la collecte, retourné par collecte/create","disabled":true}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"errors\": [\n {\n \"status\": \"not found\",\n \"code\": \"collecte\",\n \"detail\": \"Précisez un identifiant de collecte\"\n }\n ]\n}"}],"_postman_id":"9ece5d59-2e9b-491f-9e1e-6a524194982e"},{"name":"Obtenir un bordereau récapitulatif pdf","id":"4bab3cf6-541a-47b7-98db-67c89edd7841","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n\t\"collecte\": {\n\t\t\"id\": 312329\n\t}\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/collecte/getdocument","description":"Un document pdf décrivant les expéditions contenues dans la collecte, peut être obtenu afin de garder une trace papier des flux quotidiens de colis ou d'obtenir une preuve tamponnée des remises des expéditions aux chauffeurs.
\nLa réponse est un objet document:[] fournissant les caractéristiques du document ainsi que l'url de disponibilité.
Les propriétés de l'objet collecte sont définies dans le schema collecte.
Un seul critère est accepté par appel : l'id Expedipro ou la référence du transporteur.
\nLa réponse fournie un objet collecte contenant le détail d'une seule collecte.
L'id Expedipro fourni en réponse doit être utilisé afin d'obtenir le descriptif du contenu au format pdf avec un appel collecte/getdocument.
\nNB: la propriété refreshable vaut true lorsqu'il est possible d'utiliser un appel collecte/refresh (à la double condition que le transporteur l'autorise et d'un délai d'attente entre 2 demandes)
Une collecte désigne le regroupement logique de plusieurs envois avant d'être remis au transporteur (ou collecteur intermédiaire s'il y a lieu). Une collecte correspond à un flux physique d'envois (ou colis) remis dans le réseau du transporteur.
\nCe document est important puisqu'il permet :
\nde justifier du transfert de responsabilité avec le transporteur dès lors qu'il est tamponné par ce dernier
\ndemander une ramasse de vos colis en attente (pour certains transporteurs)
\nLe document pdf au format A4 peut soit être imprimé puis tamponné par le chauffeur soit ignoré (puisque la demande de ramasse est envoyée électroniquement).
\n\n\n","event":[{"listen":"prerequest","script":{"type":"text/javascript","exec":[""],"id":"15caeb3f-64ba-479a-8a99-ebfb74599867"}},{"listen":"test","script":{"type":"text/javascript","exec":[""],"id":"7318fe38-146c-4c26-a3b5-9a5af6198d74"}}],"_postman_id":"36ba5fe5-a87a-4db8-8195-1c6bed632f03","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","name":"expedipro:{api:v2}","type":"collection"}}},{"name":"Acheminement","item":[{"name":"Suivre l'acheminement d'une expédition","id":"4e854a1e-280c-46a0-88e7-e34391a72d67","protocolProfileBehavior":{"disabledSystemHeaders":{"connection":true,"user-agent":true},"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"{\n \"cabTransport\": null,\n \"expeditionId\":[2722808,2722606],\n \"depth\": 2\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/expedition/trace","description":"Un envoi peut-être inséré dans une collecte dès lors que sa date d'expédition n'est pas dans le futur, qu'il n'a pas été supprimé et qu'il n'est pas déjà inclu dans une autre collecte.
\n
Cet appel accepte soit le numéro de suivi du colis cabTransport, soit expeditionId. Ces 2 propriétés peuvent fournir les identifiants en string ou en array.
La réponse est un tableau d'objets json décrits par le schema distribution. Ce même schema est aussi utiisé dans la propriété expedition.distribution reçue dans l'appel /expedition/get
Les N (par défaut depth: 1) événements les plus récents sont fournis par ordre décroissant de date au format 2000-01-01 00:00:01.
\nNB: lorsque depth >1, seules les propriétés date, etape et code sont retournées.
etape est une classification Expedipro du codeévénement spécifique à chaque transporteur. Voici les 10 étapes possibles :
1 : dépôt / prepared, still in-house
10 : Chargé / first km
20 : Transport / in progress (close from the start)
30 : Douane / under customs review
40 : Problème / problem
50 : Transport / in progress (close to the end)
60 : Imminent / prepared for the last km
70 : Instance / waiting pickup by recipient
80 : Relivraison / second attemp of delivery
90 : Retour / return to sender
100: Livré / delivered
\n\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","name":"expedipro:{api:v2}","type":"collection"}},"urlObject":{"path":["expedition","trace"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"4103f8ff-a129-43ca-bc10-763448555423","name":"200 ok : dernier événement mono colis","originalRequest":{"method":"GET","header":[],"url":"https://www.expedipro.com/expedition/trace"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"2722801\": [\n {\n \"cabTransport\": \"6A02036890018\",\n \"date\": \"2025-04-09 17:55:02\",\n \"etape\": 60,\n \"code\": \"AARCFM\",\n \"etapeLibelle\": \"Imminent\",\n \"codeLibelle\": \"Votre colis est arrivé sur son site de distribution\",\n \"urlSuivi\": {\n \"6A02034790018\": \"https://www.laposte.fr/outils/suivre-vos-envois?code=6A02036890018\"\n },\n \"urlLivraison\": null\n }\n ]\n}"},{"id":"bccfe753-2a3f-4cb7-9634-4859a548b255","name":"200 ok : tous les événements, multi colis","originalRequest":{"method":"GET","header":[],"url":"{{url}}/expedition/trace"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"2722606\": [\n {\n \"cabTransport\": \"6A02032858687\",\n \"date\": \"2025-04-09 17:48:25\",\n \"etape\": 60,\n \"code\": \"AARCFM\"\n },\n {\n \"cabTransport\": \"6A02032858687\",\n \"date\": \"2025-04-09 10:42:05\",\n \"etape\": 1,\n \"code\": \"PCHMQT\"\n }\n ],\n \"2722808\": [\n {\n \"cabTransport\": \"02003598\",\n \"date\": \"2025-04-09 11:20:00\",\n \"etape\": 1,\n \"code\": \"DPCCFM\"\n }\n ]\n}"},{"id":"98abe248-cb18-4b1e-a8eb-8a1cd171cf50","name":"404 ko : expédition inconnue","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"cabTransport\":[\n 86412989\n ],\n \"expeditionId\":null,\n \"depth\": 1\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/expedition/trace"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"errors\": [\n {\n \"status\": \"not found\",\n \"code\": \"expedition\",\n \"detail\": \"pas d'expedition trouvée\"\n }\n ]\n}"}],"_postman_id":"4e854a1e-280c-46a0-88e7-e34391a72d67"},{"name":"Détail d'un point de livraison","id":"a8302878-840f-4b94-8f42-79ac1d291c3b","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{"user-agent":true,"content-length":true}},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"{\n \"expeditionId\":2604647,\n \"fournisseurId\": null,\n \"siteId\":null\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/demand/getsite?expeditionId=2604647&fournisseurId&siteId","description":"cette requête peut aussi être appelée en
\nPOSTavec un objet JSON {\"expedition\":{} }
Pour obtenir les détails d'un point de livraison (hors domicile), vous pouvez faire cet appel de 2 façons:
\nutiliser les propriétés fournisseurId, siteId (l'identifiant d'un site pour ce transporteur) et éventuellement paysId (defaut FRA).
expeditionId pour une expédition déjà crée. Ce cas est utile lorsque vous ne connaissez pas l'id du point de livraison, car le choix a été fait par email ou id: \"nearest\" a été utilisé.
Cet appel diffère de /demand/listsite qui fourni les mêmes détails des points de livraison, à partir d'une adresse.
\nNB: en complément, l'appel /expedition/get fourni le lien de suivi du colis dans la propriété distribution.urlSuivi ; la page du transporteur précise parfois le point de livraison.
Cet appel permet de suivre les étapes de traitement des dossiers ouverts auprès des services clients des transporteurs.
\nUn dossier est unique par expédition, la recherche peut donc être effectuée de la même manière que dans l'appel /expedition/get
\nLa réponse est un schema dossier.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","name":"expedipro:{api:v2}","type":"collection"}},"urlObject":{"path":["dossier","get"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"47431afa-03b1-4f5c-8ed4-5be6731cc6a5","name":"200 ok : contenu du dossier du dossier","originalRequest":{"method":"GET","header":[],"url":"{{url}}/dossier/get"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"dossier\": {\n \"id\": 10583,\n \"expeditionId\": 272122,\n \"cabTransport\": \"CB36157605FR\",\n \"refTransport\": null,\n \"noteContractant\": \"bonjour, mon client n'a pas reçu le colis\",\n \"noteExpedipro\": \"enquête ouverte\",\n \"motif\": \"perte\",\n \"montantHT\": null,\n \"ouverture\": \"2025-04-09\",\n \"miseajour\": null,\n \"cloture\": null\n }\n}"},{"id":"33803c45-7361-45a0-835a-860e52de392f","name":"404 Not Found : dossier non ouvert","originalRequest":{"method":"GET","header":[],"url":"{{url}}/dossier/get"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"errors\": [\n {\n \"status\": \"not found\",\n \"code\": \"dossier\",\n \"detail\": \"dossier introuvable\"\n }\n ]\n}"}],"_postman_id":"940349c8-4dac-44be-b550-8317c68f0275"},{"name":"Ouverture","id":"bd84e574-b948-4a10-bc1d-3c3820f77773","protocolProfileBehavior":{"disabledSystemHeaders":{"accept":true,"accept-encoding":true,"connection":true,"user-agent":true},"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"dossier\": { \n \"expeditionId\": 272122,\n \"cabTransport\": null,\n \"noteContractant\": \"bonjour, mon client n'a pas reçu le colis\",\n \"motif\": \"avarie\"\n }\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/dossier/set","description":"Cet appel permet d'ouvrir un dossier de réclamation auprès d'Expedipro qui sera ensuite transmis au transporteur.
\nLes données à fournir sont celles décrites dans schema dossier. L'identificant de l'exoédition peut être au choix expeditionId ou cabTransport.
\nNB: un dossier est unique par expédition
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","name":"expedipro:{api:v2}","type":"collection"}},"urlObject":{"path":["dossier","set"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"98f44dc0-3edc-4ad2-84d6-d30f0b8eaeff","name":"200 ok : dossier ouvert","originalRequest":{"method":"POST","header":[{"key":"Custom-Version","value":"2","type":"text","disabled":true}],"body":{"mode":"raw","raw":"{\n \"dossier\": {\n \"expeditionId\": null,\n \"cabTransport\": \"CB36157605FR\",\n \"noteContractant\": \"bonjour, mon client n'a pas reçu le colis\",\n \"motif\": \"avarie\"\n }\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/dossier/set"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"dossier\": {\n \"id\": 10585\n }\n}"},{"id":"aeac095b-4a8a-4026-9937-76fec55cd330","name":"417 consistency : donnée manquante","originalRequest":{"method":"POST","header":[{"key":"Custom-Version","value":"2","type":"text","disabled":true}],"body":{"mode":"raw","raw":"{\n \"dossier\": {\n \"expeditionId\": 272122,\n \"noteContractant\": \"bonjour, mon client n'a pas reçu le colis\",\n \"motif\": null\n }\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/dossier/set"},"status":"Expectation Failed","code":417,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"errors\": [\n {\n \"status\": \"consistency\",\n \"code\": \"dossier\",\n \"detail\": \"Le motif doit être renseigné(e)\"\n }\n ]\n}"}],"_postman_id":"bd84e574-b948-4a10-bc1d-3c3820f77773"}],"id":"1cac6b3c-8ceb-4512-9575-bc5432ccdde4","_postman_id":"1cac6b3c-8ceb-4512-9575-bc5432ccdde4","description":"","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","name":"expedipro:{api:v2}","type":"collection"}}},{"name":"Destinataire","item":[{"name":"Créer un destinataire","id":"6a0e6f70-8242-4fc4-9475-5f3ab914103b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{ \n \"destinataire\":{ \n \"id\":null,\n \"nom\":\"Jacques Martin\",\n \"email\":\"jacques@gmail.com\",\n \"telephoneM\":\"+33 865854587\",\n \"adresse\":{ \n \"adresse1\":\"12 rue de friedland\",\n \"adresse2\":\"fond de cours\",\n \"codePostal\":\"32100\",\n \"ville\":\"Colmar\",\n \"paysId\":\"FRA\",\n \"instruction\":\"Sonner chez moi\",\n \"telephoneF\":null\n }\n }\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/destinataire/create","description":"Créer au minimum une adresse d'un destinataire existant - si destinataire.id est fourni - ou un destinataire et son adresse si aucun id n'est fourni.
Conseil : il est préférable de créer une commande (ou une expédition) directement avec son destinataire. Dans ce cas le destinataire et son adresse seront automatiquement crées (ou réutilisés s'il existent déjà) et les liens avec les différents id seront aussi correctement effectué.... Pourquoi faire 2 ou 3 appels, lorsqu'un seul appel est disponible : /commande/create ou /expedition/createforward
\nLes échanges de données sont décrits dans les schema destinataire et schema adresse . NB: 1 destinataire peut avoir N adresses, 1 adresse n'apparatient qu'à un seul destinataire.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","name":"expedipro:{api:v2}","type":"collection"}},"urlObject":{"path":["destinataire","create"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"8fae2c94-1538-4729-bd37-ff42220d4732","name":"201 ok : destinataire created","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"Bearer ","type":"text","disabled":true},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{ \n \"destinataire\":{ \n \"id\":null,\n \"nom\":\"Jacques Martin\",\n \"email\":\"jacques@gmail.com\",\n \"telephoneM\":\"+33 865854587\",\n \"adresse\":{ \n \"adresse1\":\"12 rue de Friedland\",\n \"adresse2\":null,\n \"codePostal\":\"A5008\",\n \"ville\":\"Paris\",\n \"paysId\":\"FRA\",\n \"instruction\":\"Sonner chez moi\",\n \"telephoneF\":null\n }\n }\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/destinataire/create"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"destinataire\": {\n \"id\": 969846,\n \"adresse\": {\n \"id\": 913458\n }\n }\n}"},{"id":"1f5a0ca8-906e-4531-a6e4-bcecf584ead5","name":"417 consistency : code postal -incompatible","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{ \n \"destinataire\":{ \n \"id\":null,\n \"nom\":\"Jacques Martin\",\n \"email\":\"jacques@gmail.com\",\n \"telephoneM\":\"+33 865854587\",\n \"adresse\":{ \n \"adresse1\":\"1\",\n \"adresse2\":\"rue de friedland\",\n \"adresse3\":null,\n \"codePostal\":\"32100\",\n \"ville\":\"Colmar\",\n \"paysId\":\"FRA\",\n \"instruction\":\"Sonner chez moi\",\n \"telephoneF\":null\n }\n }\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/destinataire/create"},"status":"Expectation Failed","code":417,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"errors\": [\n {\n \"status\": \"consistency\",\n \"code\": \"ville\",\n \"detail\": \"Plusieurs villes possibles pour ce code postal\",\n \"proposal\": [\n {\n \"cp\": 4370,\n \"nom\": \"COLMARS\"\n },\n {\n \"cp\": 32100,\n \"nom\": \"BEAUMONT\"\n },\n {\n \"cp\": 32100,\n \"nom\": \"BERAUT\"\n },\n {\n \"cp\": 32100,\n \"nom\": \"BLAZIERT\"\n },\n {\n \"cp\": 32100,\n \"nom\": \"CASSAIGNE\"\n },\n {\n \"cp\": 32100,\n \"nom\": \"CASTELNAU SUR L AUVIGNON\"\n },\n {\n \"cp\": 32100,\n \"nom\": \"CAUSSENS\"\n },\n {\n \"cp\": 32100,\n \"nom\": \"CONDOM\"\n },\n {\n \"cp\": 32100,\n \"nom\": \"LARRESSINGLE\"\n },\n {\n \"cp\": 32100,\n \"nom\": \"LARROQUE SUR L OSSE\"\n },\n {\n \"cp\": 32100,\n \"nom\": \"ROQUEPINE\"\n },\n {\n \"cp\": 32100,\n \"nom\": \"ST ORENS POUY PETIT\"\n },\n {\n \"cp\": 68000,\n \"nom\": \"COLMAR\"\n }\n ]\n }\n ]\n}"}],"_postman_id":"6a0e6f70-8242-4fc4-9475-5f3ab914103b"},{"name":"Modifier un destinataire","id":"0575edcd-570a-4424-ada1-71f4a6136562","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{ \n \"destinataire\":{ \n \"id\": 969846,\n \"nom\":\"Jacques Martin\",\n \"email\":\"nouvelEmail@gmail.com\",\n \"telephoneM\":\"+33 865854587\",\n \"adresse\":{ \n \"id\": 913458,\n \"adresse1\":\"12 rue de Friedland\",\n \"codePostal\":\"75008\",\n \"ville\":\"Paris\",\n \"paysId\":\"FRA\",\n \"instruction\":\"Sonner chez moi\",\n \"telephoneF\":null\n }\n }\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/destinataire/update","description":"Permet de mettre à jour une entité destinataire et son adresse.
\n\n\nSi les modifications apportées sont trop significatives (par exemple, changement de ville) et que cette adresse est déjà associée à un envoi, alors l'adresse déjà utilisée sera dupliquée (et rendue obsolète) afin de garder une traçabilité sur cet envoi.
\n
La mise à jour d'une adresse est toujours un update de destinataire.adresse.id fourni. Le mécanisme de préservation des adresses des envois précédents créent des nouveaux ids, invisibles pour cette requête.
Permet de supprimer une adresse d'un destinataire. Lorsqu'il s'agit de la dernière adresse non obsolète, le destinataire est aussi supprimé.
\n\n\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","name":"expedipro:{api:v2}","type":"collection"}},"urlObject":{"path":["destinataire","deleteaddress"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"2335603a-21e9-4d4c-bc1e-175ad35eae97","name":"200 ok : address removed","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"Bearer ","type":"text","disabled":true},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{ \n \"destinataireId\":969846,\n \"adresseId\":913458\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/destinataire/deleteaddress"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"destinataire\": {\n \"id\": 969846,\n \"adresse\":{\n \"id\":913458\n }\n }\n}"}],"_postman_id":"2bf7e886-2c85-42e5-85c5-0fc6c8ecaf33"},{"name":"Obtenir un destinataire et son adresse","id":"70c88610-92c7-45f1-b5ce-50af6eef3a45","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"{\n \"destinataireId\":969846,\n \"adresseId\":913458\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/destinataire/get","description":"Lorsqu'un envoi est associé à une adresse, cette dernière n'est pas supprimée, mais déclarée obsolète.
\n
La requête fournie un objet destinataire tel que défini dans le schema destinataire et dans le schema adresse
Liste un aperçu des expéditions associées à ce destinataire.
\nNB: la liste peut être restreinte selon le délai de conservation des données d'expéditions (dans vos options) ou la visibilité que le login utilisé pour cet appel possède sur les expéditions des autres sites d'expéditions.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","name":"expedipro:{api:v2}","type":"collection"}},"urlObject":{"path":["expedition","sendto"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"d54b314b-066a-4275-9499-da43d55d955a","name":"200 ok : aperçu des expéditions","originalRequest":{"method":"GET","header":[],"url":"{{url}}/expedition/sendto"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"expedition\": [\n {\n \"expeditionId\": 2721915,\n \"cabTransport\": \"6A01033709728\",\n \"dateEtiquette\": \"2025-04-07\",\n \"contenu\": \"BOOKS\",\n \"piece\": 1\n }\n ]\n}"}],"_postman_id":"d4011e92-eacb-4b14-b72e-1fd651f4c1c2"},{"name":"Trouver la ville associée au code postal","id":"2e95c6a8-2fc1-4922-afc1-4352a82923d2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"{\n \"codePostal\": 220,\n \"paysId\": \"BEL\"\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/destinataire/findcity","description":"Très utile car permet de vérifier ou suggérer l'association d'un code postal avec une ville pour plusieurs pays. Seuls les 3 premiers caractères du code postal ainsi que le code pays iso sur 3 caractères sont requis.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","name":"expedipro:{api:v2}","type":"collection"}},"urlObject":{"path":["destinataire","findcity"],"host":["{{url}}"],"query":[{"disabled":true,"key":"codePostal","value":"220"},{"disabled":true,"key":"paysId","value":"BEL"}],"variable":[]}},"response":[{"id":"c0baa0f7-61ce-42ca-a561-e364f03d188f","name":"200 ok : suggestion of postal code with associated city names","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer ","type":"text","disabled":true},{"key":"Content-Type","value":"application/json","type":"text"}],"url":{"raw":"{{url}}/destinataire/findcity","host":["{{url}}"],"path":["destinataire","findcity"],"query":[{"key":"","value":null,"disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"cp\": \"2200\",\n \"nom\": \"Herentals\"\n },\n {\n \"cp\": \"2200\",\n \"nom\": \"Herentals Morkhoven\"\n },\n {\n \"cp\": \"2200\",\n \"nom\": \"Herentals Noorderwijk\"\n }\n]"}],"_postman_id":"2e95c6a8-2fc1-4922-afc1-4352a82923d2"}],"id":"47ba21fa-8d36-48cb-82fa-f3c1fa340275","description":"Un destinataire est le client qui effectue une commande et qui souhaite être livré par une expédition. Ce destinataire peut avoir un carnet d'adresse d'expéditions (par ex. résidence principale et secondaire).\nLa structure de l'entité destinataire est composée d'une sous-entités adresse comme ceci : {destinataire:{nom:\"\",adresse:{ville:\"\"} } }\nL'objet destinataire est défini dans le schema destinataire et l'objet adresse dans le schema adresse
\n\nIl est possible de fournir un objet JSON {destinataire:{nom:\"\",ville:\"\"}} cependant la réponse du serveur sera toujours de la forme {destinataire:{adresse:{} } }
\n
La création d'une commande crée automatiquement un destinataire et son adresse. Ce chapitre n'est donc pas essentiel pour l'impression d'une étiquette d'expédition et vous n'aurez probablement pas à l'utiliser.
\nL'adresse d'un destinataire peut être déclarée obsolète, dans ce cas elle reste associée à tous les envois effectués mais elle ne peut plus ni être modifiée ni être utilisée.
\n","event":[{"listen":"prerequest","script":{"type":"text/javascript","exec":[""],"id":"b32f66c5-9026-4db3-be1b-51381adfd668"}},{"listen":"test","script":{"type":"text/javascript","exec":[""],"id":"43fc66e7-37b8-4859-aba8-8beffc6bcfb4"}}],"_postman_id":"47ba21fa-8d36-48cb-82fa-f3c1fa340275","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","name":"expedipro:{api:v2}","type":"collection"}}},{"name":"Options","item":[{"name":"Lister les options de configuration","id":"e89fa3c8-1557-41a5-ae8a-eebf9c8b8671","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{"user-agent":true}},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Les options permettent de modifier les réponses de nos API pour un login ou pour tous les logins appartement au même site d'expédition.
\n\n\n","urlObject":{"path":["option","get"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"ba60aa1a-5953-4dbc-9c13-f0c359cfa082","name":"200 ok : lister les options de configuration","originalRequest":{"method":"GET","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"{{url}}/option/get"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Vary","value":"Accept-Encoding"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"option\": {\n \"purgeEnvoi\": 1095,\n \"factureGroupe\": \"produit\",\n \"facturePeriode\": 1,\n \"etiquetteExterne\": null,\n \"etiquettePartenaire\": null,\n \"prixHt\": true,\n \"collecteSelf\": true,\n \"colisHeure\": 19,\n \"colisPoids\": 2.67,\n \"colisChoix\": \"service\",\n \"colisFournisseur\": \"POS\",\n \"colisAltAssurance\": [\n \"DHL\",\n \"DPD\",\n \"POS\",\n \"MDR\"\n ],\n \"onbehalfSiteId\": null,\n \"retourMode\": \"manuel\",\n \"retourSiteId\": null,\n \"retourFournisseur\": [\n \"POS\"\n ],\n \"retourSiteLivraison\": null,\n \"retourFranchise\": null,\n \"panierCat\": 491199,\n \"panierIncoterm\": \"DAP\",\n \"panierValeur\": \"ttc\",\n \"panierTva\": 0.2,\n \"picking\": false,\n \"pickingMsg\": \"Merci pour votre commande. Consultez nos CGV disponibles sur notre site.\",\n \"pickingCab\": \"code128\",\n \"demandImport\": false,\n \"demandDelai\": 23,\n \"distributionTel\": false,\n \"distributionCopy\": false,\n \"distributionStepDemand\": true,\n \"distributionStep00\": true,\n \"distributionStep10\": true,\n \"distributionStep30\": true,\n \"distributionStep60\": true,\n \"distributionStep70\": false,\n \"distributionStep80\": true,\n \"distributionStep90\": true,\n \"collecte\": {\n \"DHL\": {\n \"rq\": null,\n \"jour\": [\n 1,\n 2,\n 3,\n 4,\n 5\n ],\n \"email\": null,\n \"heure\": {\n \"deb\": \"10:00\",\n \"fin\": \"17:00\"\n }\n }\n },\n \"filterBySiteId\": [\n 2\n ],\n \"listRetourEnvoi\": false,\n \"listSortEnvoi\": \"dateDesc\",\n \"listOnlyPending\": false,\n \"listSortPending\": \"refAsc\",\n \"labelDimension\": \"A4\",\n \"customDimension\": \"4P\",\n \"labelLot\": 20,\n \"labelMerge\": true,\n \"labelX\": 0,\n \"labelY\": 0\n }\n}"}],"_postman_id":"e89fa3c8-1557-41a5-ae8a-eebf9c8b8671"},{"name":"Modifier des options","id":"ce5543a6-fbcf-4352-8317-4b111f52a942","protocolProfileBehavior":{"disabledSystemHeaders":{},"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"labelStream\" : true,\n \"panierCat\": \"490101\",\n \"panierTva\": 0.055\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/option/setexpedition","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","name":"expedipro:{api:v2}","type":"collection"}},"urlObject":{"path":["option","setexpedition"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"517703c5-08fb-4292-8359-8a87008ee94e","name":"200 ok : modifier des options","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"labelStream\" : true,\n \"panierCat\": \"490101\",\n \"panierTva\": 0.055\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}/option/set"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Vary","value":"Accept-Encoding"},{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"true"}],"_postman_id":"ce5543a6-fbcf-4352-8317-4b111f52a942"}],"id":"85dd4c2c-2319-43d9-af6a-b001408f05f4","_postman_id":"85dd4c2c-2319-43d9-af6a-b001408f05f4","description":"","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","id":"42e21648-a6b4-4f66-b584-7cb182ec3b20","name":"expedipro:{api:v2}","type":"collection"}}}],"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]}},"event":[{"listen":"prerequest","script":{"type":"text/javascript","exec":[],"id":"8e069e73-0e09-46cb-9e21-0c7ef351ea02"}},{"listen":"test","script":{"type":"text/javascript","exec":[""],"id":"bb5bc010-e7c6-4061-8bcf-43b4b8e7115a"}}],"variable":[{"key":"jwtToken","value":"","type":"string"}]}Plutôt que développer des appels API, peu fréquent, nous recommandons d'utiliser l'espace Expedipro html afin de modifier ces options
\n