{"info":{"_postman_id":"4858b84f-6a41-49c7-a1c2-6356c354afa5","name":"Geolie API","description":"

Objet

Objectif

L’objectif de ce document est la spécification du WebService mise à disposition par le groupe LOGSYTECH. Il constitue un document de référence dans la mise en œuvre des interfaces.

Périmètre

Dans un premier temps, ce document ne couvre que la description des méthodes actuellement disponibles. Certains aspects et certaines méthodes pourront être modifiés ou ajoutés. Dans ce cas ce document fera l’objet d’une mise à jour ultérieure.

Echanges

Accès

L’accès au web service GetInBox se fait via l’implémentation d’un client SOAP en utilisant le protocole de transport HTTP et HTTPS. La version de SOAP utilisée est la version 1.1.
Toutefois, les services sont également accessibles en REST.

Les services sont accessibles à l’adresse :

Version 1 : http://api.preprod.geolie.net/wsGestInbox.asmx
\n
Version 2 : http://api.preprod.geolie.net/wsGestInbox_V2.asmx
\n

Les services sont également accessibles en SSL.
Pour vérifier le bon fonctionnement de votre code, vous pouvez tester l’appel au WS en utilisant la méthode « HelloWorld », qui ne nécessite pas de sécurité dans son appel.

Sécurité

Il est nécessaire pour chaque appel à une méthode du WS d’inclure dans l’entête de la requête la structure suivante :

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

	CredentialHeader
Clef	String	Identifiant du client
UserName	String	Login
Password	String	Mot de passe

Exemple (en C#) :

• SOAP :

var ws = new WebGestinbox.wsGestinbox()\n{\nCredentialHeaderValue= new WebGestinbox.CredentialHeader()\n{\nClef = \"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\", UserName = \"USER\",\nPassword = \"PASSWORD\"\n}\n};\n\n

• REST :

using (WebClient client = new WebClient())\n{\nclient.Headers.Add(\"Clef\", clef); client.Headers.Add(\"Password\", pw); client.Headers.Add(\"UserName\", user); client.Headers.Add(\"Accept\", \"application/json\"); byte[] response = client.UploadValues(url, data);\n}\n\n

PS : les méthodes peuvent être préfixées par 'j' pour obtenir la réponse directement en jSON.

Synchronicité

Le délai de mise à jour de l’information dans nos systèmes est en temps réel.

Description du service

Format du retour des méthodes

Toutes les méthodes retournent la même structure JSON, comme suit :

{ \"statut\": 1, \"statutText\": \"succès\", \"result\": }

« statut » vaut 1 en cas de succès d’appel. Une autre valeur implique une erreur lors de l’appel ou le traitement de la méthode dont le descriptif de l’erreur se trouve dans « report ».

Statuts des commandes

Liste des statuts des commandes client.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Statut	Libellé
-6	En attente chargement transporteur
-5	Annulée
-4	En attente de confirmation de mise en expédition
-3	Anomalie
0	En attente de validation
1	En saisie
2	En cours de préparation
3	Préparée
4	Expédiée
5	Incident en cours
6	En instance
7	Livré conforme
8	Livré non-conforme
9	Perdu
10	Retour
60	Litige en cours

Transporteurs

Service transport

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Transporteur	Service	Code
Geodis	Affretement	CFE_AFF
Geodis	Messagerie Plus	CFE_MESSPL
Geodis	Express France - InterExpress	CFE_CXI
Geodis	Messagerie Europe - Eurofirst	CFE_EURO1
Geodis	Express Europe - NetExpress	CFE_EEX
Chronopost	Chrono 10	CHR_B2B_10
Chronopost	Chrono 13	CHR_B2B_13
Chronopost	Chrono 13 sans instance	CHRB13SSIP
Chronopost	Chrono 18	CHR_B2B_18
Chronopost	Chrono 18 sans instance	CHRB18SSIP
Chronopost	Chrono Classique	CHR_B2B_CI
Chronopost	Chrono Express	CHR_B2B_EI
Chronopost	Chrono Fresh 13	CHR_FRESH
Chronopost	Chrono Relais	CHR_BB_REL
Colis Prive	Colis Privé	COLPRIV
Colis Prive	Colis Privé avec signature	COLPRIVAS
Colissimo	Colissimo Domicile - Sans signature	COL_9L
Colissimo	Colissimo Domicile - Avec signature	COL_9V
Colissimo	Colissimo Expert International	COL_CY
Colissimo	Colissimo Eco Outre-Mer	COL_9W
Colissimo	Colissimo International (Europe) Domicile - Avec signature	COL_CB
Colissimo	Colissimo International (Europe) Domicile - Sans signature	COL_CA
Colissimo	Colissimo International (Europe) - Point Retrait – En relais	COL_CM
Colissimo	Colissimo International (Europe) - Point Retrait – En bureau de poste	COL_CI
DHL	DHL Domestic Express	DHL_DOM
DHL	DHL Domestic Express 09 H - Non Doc	DHL_TDE
DHL	DHL Domestic Express 12 H - Non Doc	DHL_TDY
DHL	DHL Economy Select	DHL_ESU
DHL	DHL Express 09H - Doc	DHL_TDK
DHL	DHL Express 12H - Doc	DHL_TDT
DHL	DHL Express Worldwide Doc	DHL_DOX
DHL	DHL Express Worlwide Non Doc	DHL_WPX
DHL	DHL Express Worlwide UE Hors France	DHL_ECX
DHL	DHL Important Economy Select	DHL_ESI
DHL	DHL Packet	DHL_PKT
DPD	DPD - Prédict	DPD_PREDICT
Euro Express	Affretement	GEN003
Fedex	Home Express	FDX_HOME
Fedex	Optimum	FDX_OPTIMU
Fedex	AT@Home	FDX_THOME
Fedex	AT@Home Livraison a 2 personnes	FDX_THOME2
GLS	GLS - Flex Delivery Service	GLS_FDF
GLS	GLS Business	GLS_BP
GLS	GLS Express	GLS_EP
GLS	GLS Internationnal	GLS_EBP
La Poste	Lettre simple	LETT_LS
La Poste	Lettre suivie	LP_2P
Mondial Relay	Livraison en Point Relais	MR_24R
Mondial Relay	Livraison à domicile <30Kg	MR_HOM
Mondial Relay	Livraison à J+1	MR_OXH
Paack	Créneaux 2h	PCK_NT2
Paack	Créneaux 4h	PCK_NT4
SDV	Affretement	GEN001
UPS	Standard	UPS_STD
UPS	Access Point Economy	UPS_ACCPT
UPS	Express Saver	UPS_WWSVR

","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"Objet","slug":"objet"},{"content":"Echanges","slug":"echanges"},{"content":"Description du service","slug":"description-du-service"},{"content":"Statuts des commandes","slug":"statuts-des-commandes"},{"content":"Transporteurs","slug":"transporteurs"}],"owner":"9022498","collectionId":"4858b84f-6a41-49c7-a1c2-6356c354afa5","publishedId":"2s9YXfc4Br","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2024-01-11T12:32:21.000Z"},"item":[{"name":"HelloWorld","event":[{"listen":"test","script":{"id":"b4083731-c5f7-424b-bff5-9036f5d6a527","exec":[""],"type":"text/javascript"}},{"listen":"prerequest","script":{"id":"c660c6f9-39d8-4b60-bf3b-4848f267bf9b","exec":[""],"type":"text/javascript"}}],"id":"71265436-9a77-4eec-9d03-763be1976434","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"Data","value":"{TEST}","type":"text","disabled":true}]},"url":"{{URL PP v1}}/jHelloWorld?Nom=TEST","description":"

L’appel de cette méthode ne nécessite pas de renseigner l’entête de sécurité pour pouvoir avoir un retour sans échec de la fonction, ceci dans un but de tester la connexion au WebService.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Champ	Détail	Oblig.	Défaut	Exemple
Nom	Nom qui sera retourné	N		\"TEST\"

Cette méthode est identique à la précédente, sauf qu’il est nécessaire de renseigner l’entête de sécurité pour avoir un retour sans échec de la fonction.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Champ	Détail	Oblig.	Défaut	Exemple
Nom	Nom qui sera retourné	N		\"TEST\"

Cette méthode permet la gestion d’un catalogue article.
Les paramètres doivent avoir une structure de type jSon, et commencer par « Articles » qui contient le catalogue.

Champ	Détail	Obligatoire	Variable	Défaut	Nb caractère	Commentaires
Mode	Mode de traitement	N	{{Mode}}	NEW		NEW, ALTER , DELETE
ID	Identifiant de l’article	O	String		35	SKU
IDClient	Identifiant Client de l’article	N	String		50
IDFournisseur	Identifiant Fournisseur de l’article	N	String
Libelle	Descriptif de l’article	O	String		255
Stock	Nom du stock de l’article	N	String		50	Paramétrage client
Gamme	Nom de la gamme	N	String		50	Paramétrage client
Famille	Famille du produit	N	String	Divers	50
Longueur	Longueur en mm	N
Largeur	Largeur en mm	N
Hauteur	Hauteur en mm	N
Poids	Poids d’une unité en grammes	O
EAN	Code EAN du produit unitaire	N	String		30
Fournisseur	Nom du fournisseur	N	String
UrlPhoto	URL de la photo de l’article	N	String		255
IsDLV	Gestion des DLV	N	Bit	0 : Non
IsDLC	Gestion des DLC	N	Bit	0 : Non
IsDLUO	Gestion des DLUO	N	Bit	0 : Non
IsSerial	Gestion au numéro de série	N	Bit	0 : Non
Lot	Gestion du lot de fabrication	N	Bit	0 : Non
PA	Prix d’achat	N				Pour valoriser le stock
PV	Prix de vente	N				Pour valoriser le stock
IsActif	Etat de l’article	N	Bit	1 : Oui
RegexpSerial	Expression régulière validant le numéro de série	N	String
MaxCmde	Quantité max commandable	N	Int
Alerte	Alerte stock minimum	N	Int
Alerte_Nom	Nom personne à alerter	N	String
Alerte_Prenom	Prénom personne à alerter	N	String
Alerte_Email	Email personne à alerter	N	String
Conditionnement	Quantité conditionnement	N	Int	1
Distribution	Quantité distribution	N	Int	1
Documents	Liste de documents	N	Array			voir SetDocuments
Reapro	Délai de réapro	N	Int
Nomenclature *	Composition de l'article Kit	N	Array			Voir tableau ci-dessous
MAJ	Màj de la commande	N	Bit	0 : Non		Détailler la nomenclature sur la commande

Nomenclature :

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Champ	Détail	Oblig.	Défaut	Nb caractère	Commentaires
ID	Identifiant de l’article	O		35	SKU
Qté	Quantité retournée	N	1

Tout message d'erreur concernant la Nomenclature inhibe la mise à jour (annule et remplace) de celle-ci sur l'article défini (ID).

Exemple à mettre dans l'appel :

... ,\"Nomenclature\": [ {\"ID\":\"TEST1\", \"Qté\":1}, ... ], \"MAJ\": 1 ...

En cas d'absence de Nomenclature (vide ou absent), l'article est de type basique.

LA METHODE EST DESACTIVEE. Son tuilisation ne sera plus permise aprés le 01/09/2025. Veuillez utiliser le champ \"Nomenclature\" de la méthode SetArticles pour gérer la composition de vos articles composés.

Cette méthode permet la gestion des nomenclatures d’articles.
Les paramètres doivent avoir une structure de type jSon, et commencer par « Packs » qui contient les nomenclatures à créer ou mettre à jour.

SetPacks

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Champ	Détail	Oblig.	Défaut	Nb caractère	Commentaires
ID	Identifiant de l’article	O		35	SKU
Qté	Quantité retournée	N	1

Articles

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Champ	Détail	Oblig.	Défaut	Nb caractère	Commentaires
ID	Identifiant de l’article	O		35	SKU
Qté	Quantité retournée	N	1

Retour :

{ \"statut\": 1, \"statutText\": \"OK\", \"result\": { \"MAJ\": \"1 ligne mise à jour\" }}\n\n

La mise à jour d’une nomenclature ne sera pas rétroactive, c’est à dire que la composition des commandes en saisies ne sera pas affectée.

Cette méthode permet la gestion d’une liste de commandes fournisseur.\nLes paramètres doivent avoir une structure de type jSon, et commencer par « Commandes » qui contient la liste des commandes fournisseur.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Champ	Détail	Oblig.	Défaut	Commentaires
Mode	Mode de traitement	N	NEW	NEW, ALTER, DELETE
ID	Identifiant de la commande fournisseur	O		Votre numéro de commande fournisseur
Fournisseur	Nom du fournisseur	O
BL	Bon de livraison	N
Date	Date prévisionnelle de réception	N		Format jj/mm/yyyy
Articles	Liste des articles	O*		Voir tableau ci-aprés

Articles :

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Champ	Détail	Oblig.	Commentaires
ID	Identifiant de l’article	O	SKU
Quantite	Quantité à réceptionner	O
Stock	Nom du stock à réceptionner	N	Par défaut celui de l’article
IDLigne	Identifiant de la ligne de commande fournisseur	N	Pour la commande concernée

Cette méthode permet la gestion d’un portefeuille de commandes.
Les paramètres doivent avoir une structure de type jSon, et commencer par « Commandes » qui contient le portefeuille de commandes.

Champ	Détail	Oblig.	Défaut	Nb caractères	Commentaires
Mode	Mode de traitement	N	NEW		NEW, ALTER, CANCEL, DELETE, VALIDATE, UNVALIDATE, EXP_GO
Operation	Identifiant de l’opération	N		20	Obtenir à partir de Géolie ou à obtenir auprès de votre contact
ID	Identifiant de la commande	O		30	A renseigner pour pouvoir interroger ultérieurement son tatut, obligatoire avec DELETE
DestID	Identifiant du destinataire	N		50
Nom	Nom du destinataire	O*		35	Jean Dupont
Contact	Contact de livraison	N		35	Si non fourni, « Nom » sera repris.
Adresse1	Adresse 1 de livraison	O*		35
Adresse2	Adresse 2 de livraison	N		35
Adresse3	Adresse 3 de livraison	N		35
CodePostal	Code postal de livraison	O*		10
Ville	Ville de livraison	O*		35
CodePays	Code ISO du pays de livraison	N	FR	2	ISO 3166-1 alpha-2
Telephone	Téléphone du contact	N		20
Mobile	Mobile du contact	N		20
Fax	Fax du contact	N		20
Email	Email du contact	N		100
Transporteur	Code transporteur	N			Voir liste en annexe 4.3 (CODE_WS)
CodePR	Code du point relai	N		50
DIL	Date impérative de livraison	N			jj/mm/aaaa
Libelle1	Ligne 1 de commentaire	N		1000
Libelle2	Ligne 2 de commentaire	N		300
Libelle3	Ligne 3 de commentaire	N		300
Libelle4	Ligne 4 de commentaire	N		300
Libelle5	Ligne 5 de commentaire	N		300
Documents	Liste de documents	N			voir SetDocuments
Articles	Liste des articles	O*			Voir tableau ci-aprés

: dans le cas de DELETE, ces informations ne sont pas requises. Seul ID et/ou DestID est obligatoire.

Articles
Liste des articles

Champ	Détail	Oblig.	Nb caractère	Commentaires
ID	Identifiant de l’article	O	35	SKU
Quantite	Quantité à expédier	O
Stock	Nom du stock à prélever	N	50	Par défaut celui de l’article
Lot1	Lot n°1 à prélever	N	50
Lot2	Lot n°2 à prélever	N	50
Lot3	Lot n°3 à prélever	N	50
Lot4	Lot n°4 à prélever	N	50
IDunique	Identifiant de commande unique	N		Identifiant de la ligne de commande côté client.
Info1	Information 1	N	250	Info complémentaire
Info2	Information 2	N	250	Info complémentaire
Info3	Information 3	N	250	Info complémentaire
Info4	Information 4	N	250	Info complémentaire

Sans préciser « DestID », la requête créera une nouvelle commande. Préférez alors renseigner « DestID » à la place de « ID ». Si cette valeur est unique, cela vous permettra d’interroger la commande ultérieurement avec cette propriété.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Champ	Détail	Oblig.	Commentaires
Satut	Code retour	O	1 = succès
StatutText	Valeur texte du code retour	O	OK si succès
result	Etat du traitement	O	Tableau ci-dessous

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Champ	Détail	Oblig.	Commentaires
NB_INSERT	Nombre de cmdes créées	O
NB_UPDATE	Nombre de cmdes modifiées	O
NB_UNVALID	Nombre de cmdes dévalidées	O
NB_DELETE	Nombre de cmdes	O
NB_EXP	Nombre de cmdes expédiées	O
NB_DOCS	Nombre de documents	O
Errors	Liste des erreurs rencontrées	N	Exemple ci-dessous

 \"Errors\": [\n            {\n                \"ID\": \"ID\",\n                \"DestID\": \"DestID\",\n                \"Mode\": \"Mode\",\n                \"Errors\": \"Erreur(s) levée(s)\"\n            },\n         …\n         ]\n\n

Une erreur sur une commande n’empêchera pas l’intégration d’une autre.

[Liste des statuts des commandes](https://logsytech.postman.co/workspace/9a5810eb-6ae9-4e4a-8514-f742111369c1/request/9022498-e2f272ba-335d-4a07-b11e-c2a4b8c89d1e?action=share&source=copy-link&creator=30275221&ctx=documentation)

\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":""},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"4858b84f-6a41-49c7-a1c2-6356c354afa5","id":"4858b84f-6a41-49c7-a1c2-6356c354afa5","name":"Geolie API","type":"collection"}},"urlObject":{"path":["jSetCommandes"],"host":["{{URL PP v2}}"],"query":[],"variable":[]}},"response":[{"id":"c3525ac8-5f18-4618-b998-e3e450a2be70","name":"SetCommande NEW","originalRequest":{"method":"POST","header":[{"key":"Clef","value":"{{Clef}}"},{"key":"UserName","value":"{{UserName}}"},{"key":"Password","value":"{{Password}}"},{"key":"Content-Type","name":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"Data","value":"{\"Commandes\":[{\"Mode\":\"NEW\",\"ID\":\"TEST\",\"DestID\":\"123\",\"Nom\":\"Emile SPECIMEN\",\"Adresse1\":\"9 Rue du Testeur\",\"CodePostal\":\"75004\",\"Ville\":\"PARIS\",\"CodePays\":\"FR\",\"Articles\":[{\"ID\":\"ARTICLE.001\",\"Quantite\":1},{\"ID\":\"ARTICLE.002\",\"Quantite\":3}]}]}","type":"text"}]},"url":"{{URL PP v2}}/jSetCommandes"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"private, max-age=0"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Server","value":"Microsoft-IIS/10.0"},{"key":"X-AspNet-Version","value":"4.0.30319"},{"key":"X-Powered-By","value":"ASP.NET"},{"key":"Date","value":"Wed, 13 Dec 2023 11:58:30 GMT"},{"key":"Content-Length","value":"149"}],"cookie":[],"responseTime":null,"body":"{\n \"statut\": 1,\n \"statutText\": \"OK\",\n \"result\": {\n \"NB_INSERT\": \"1\",\n \"NB_UPDATE\": \"0\",\n \"NB_UNVALID\": \"0\",\n \"NB_DELETE\": \"0\",\n \"NB_EXP\": \"0\",\n \"NB_CANCEL\": \"0\",\n \"NB_DOCS\": \"0\"\n }\n}"},{"id":"3036e0b8-e6c0-4715-90a3-c3e654eb238f","name":"SetCommande NEW avec point relais","originalRequest":{"method":"POST","header":[{"key":"Clef","value":"{{Clef}}"},{"key":"UserName","value":"{{UserName}}"},{"key":"Password","value":"{{Password}}"},{"key":"Content-Type","name":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"Data","value":"{\"Commandes\":[{\"Mode\":\"NEW\",\"ID\":\"TEST\",\"DestID\":\"123\",\"Nom\":\"Emile SPECIMEN\",\"Contact\":\"Emile SPECIMEN\",\"Adresse1\":\"9 Rue du Testeur\",\"CodePostal\":\"75004\",\"Ville\":\"PARIS\",\"CodePays\":\"FR\",\"Transporteur\":\"MR_24R\",\"CodePR\":\"75154\",\"Articles\":[{\"ID\":\"ARTICLE.001\",\"Quantite\":1},{\"ID\":\"ARTICLE.002\",\"Quantite\":3}]}]}","type":"text"}]},"url":"{{URL PP v2}}/jSetCommandes"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"private, max-age=0"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Server","value":"Microsoft-IIS/10.0"},{"key":"X-AspNet-Version","value":"4.0.30319"},{"key":"X-Powered-By","value":"ASP.NET"},{"key":"Date","value":"Mon, 09 Oct 2023 15:39:19 GMT"},{"key":"Content-Length","value":"133"}],"cookie":[],"responseTime":null,"body":"{\n \"statut\": 1,\n \"statutText\": \"OK\",\n \"result\": {\n \"NB_INSERT\": \"1\",\n \"NB_UPDATE\": \"0\",\n \"NB_UNVALID\": \"0\",\n \"NB_DELETE\": \"0\",\n \"NB_EXP\": \"0\",\n \"NB_DOCS\": \"0\"\n }\n}"},{"id":"24d58c5e-e9be-45a0-b3b1-5720b3cb965c","name":"SetCommande NEW avec document","originalRequest":{"method":"POST","header":[{"key":"Clef","value":"{{Clef}}"},{"key":"UserName","value":"{{UserName}}"},{"key":"Password","value":"{{Password}}"},{"key":"Content-Type","name":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"Data","value":"{\"Commandes\":[{\"Mode\":\"NEW\",\"ID\":\"TEST\",\"DestID\":\"123\",\"Nom\":\"Emile SPECIMEN\",\"Adresse1\":\"9 Rue du Testeur\",\"CodePostal\":\"75004\",\"Ville\":\"PARIS\",\"CodePays\":\"FR\",\"Documents\":[{\"type\":\"FACTURE\",\"name\":\"invoice_501253859.pdf\",\"filename\":\"invoice_501253859.pdf\",\"file\":\"invoice/2606595\",\"path\":\"invoice/2606595\",\"md5\":\"4db8ae79f214e7843fa096aff1bc0d5a\"}],\"Articles\":[{\"ID\":\"ARTICLE.001\",\"Quantite\":1},{\"ID\":\"ARTICLE.002\",\"Quantite\":3}]}]}","type":"text"}]},"url":"{{URL PP v2}}/jSetCommandes"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"private, max-age=0"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Server","value":"Microsoft-IIS/10.0"},{"key":"X-AspNet-Version","value":"4.0.30319"},{"key":"X-Powered-By","value":"ASP.NET"},{"key":"Date","value":"Mon, 09 Oct 2023 15:48:56 GMT"},{"key":"Content-Length","value":"133"}],"cookie":[],"responseTime":null,"body":"{\n \"statut\": 1,\n \"statutText\": \"OK\",\n \"result\": {\n \"NB_INSERT\": \"1\",\n \"NB_UPDATE\": \"0\",\n \"NB_UNVALID\": \"0\",\n \"NB_DELETE\": \"0\",\n \"NB_EXP\": \"0\",\n \"NB_DOCS\": \"1\"\n }\n}"},{"id":"d97e07f8-01a1-4950-a1ac-d1532ab303a4","name":"SetCommande ALTER","originalRequest":{"method":"POST","header":[{"key":"Clef","value":"{{Clef}}"},{"key":"UserName","value":"{{UserName}}"},{"key":"Password","value":"{{Password}}"},{"key":"Content-Type","name":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"Data","value":"{\"Commandes\":[{\"Mode\":\"DELETE\",\"ID\":\"TEST\",\"DestID\":\"123\",\"Nom\":\"Emile SPECIMEN\",\"Contact\":\"Emile SPECIMEN\",\"Adresse1\":\"9 Rue du Testeur\",\"CodePostal\":\"75004\",\"Ville\":\"PARIS\",\"CodePays\":\"FR\",\"Transporteur\":\"MR_24R\",\"CodePR\":\"75154\",\"Articles\":[{\"ID\":\"ARTICLE.001\",\"Quantite\":2},{\"ID\":\"ARTICLE.002\",\"Quantite\":5}]}]}","type":"text"}]},"url":"{{URL PP v2}}/jSetCommandes"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"private, max-age=0"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Server","value":"Microsoft-IIS/10.0"},{"key":"X-AspNet-Version","value":"4.0.30319"},{"key":"X-Powered-By","value":"ASP.NET"},{"key":"Date","value":"Wed, 13 Dec 2023 12:01:22 GMT"},{"key":"Content-Length","value":"149"}],"cookie":[],"responseTime":null,"body":"{\n \"statut\": 1,\n \"statutText\": \"OK\",\n \"result\": {\n \"NB_INSERT\": \"0\",\n \"NB_UPDATE\": \"1\",\n \"NB_UNVALID\": \"0\",\n \"NB_DELETE\": \"0\",\n \"NB_EXP\": \"0\",\n \"NB_CANCEL\": \"0\",\n \"NB_DOCS\": \"0\"\n }\n}"},{"id":"5887753d-a32c-4b49-a798-ee6f3a549d11","name":"SetCommande DELETE","originalRequest":{"method":"POST","header":[{"key":"Clef","value":"{{Clef}}"},{"key":"UserName","value":"{{UserName}}"},{"key":"Password","value":"{{Password}}"},{"key":"Content-Type","name":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"Data","value":"{\"Commandes\":[{\"Mode\":\"DELETE\",\"ID\":\"TEST\",\"DestID\":\"123\",\"Nom\":\"Emile SPECIMEN\",\"Contact\":\"Emile SPECIMEN\",\"Adresse1\":\"9 Rue du Testeur\",\"CodePostal\":\"75004\",\"Ville\":\"PARIS\",\"CodePays\":\"FR\",\"Transporteur\":\"MR_24R\",\"CodePR\":\"75154\",\"Articles\":[{\"ID\":\"ARTICLE.001\",\"Quantite\":2},{\"ID\":\"ARTICLE.002\",\"Quantite\":5}]}]}","type":"text"}]},"url":"{{URL PP v2}}/jSetCommandes"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"private, max-age=0"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Server","value":"Microsoft-IIS/10.0"},{"key":"X-AspNet-Version","value":"4.0.30319"},{"key":"X-Powered-By","value":"ASP.NET"},{"key":"Date","value":"Wed, 13 Dec 2023 12:02:26 GMT"},{"key":"Content-Length","value":"149"}],"cookie":[],"responseTime":null,"body":"{\n \"statut\": 1,\n \"statutText\": \"OK\",\n \"result\": {\n \"NB_INSERT\": \"0\",\n \"NB_UPDATE\": \"0\",\n \"NB_UNVALID\": \"0\",\n \"NB_DELETE\": \"1\",\n \"NB_EXP\": \"0\",\n \"NB_CANCEL\": \"0\",\n \"NB_DOCS\": \"0\"\n }\n}"},{"id":"1f3d10eb-f3fc-4089-9002-620f5dea6dce","name":"SetCommande CANCEL","originalRequest":{"method":"POST","header":[{"key":"Clef","value":"{{Clef}}"},{"key":"UserName","value":"{{UserName}}"},{"key":"Password","value":"{{Password}}"},{"key":"Content-Type","name":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"Data","value":"{\"Commandes\":[{\"Mode\":\"CANCEL\",\"ID\":\"TEST\",\"DestID\":\"123\",\"Nom\":\"Emile SPECIMEN\",\"Contact\":\"Emile SPECIMEN\",\"Adresse1\":\"9 Rue du Testeur\",\"CodePostal\":\"75004\",\"Ville\":\"PARIS\",\"CodePays\":\"FR\",\"Transporteur\":\"MR_24R\",\"CodePR\":\"75154\",\"Articles\":[{\"ID\":\"ARTICLE.001\",\"Quantite\":1},{\"ID\":\"ARTICLE.002\",\"Quantite\":3}]}]}","type":"text"}]},"url":"{{URL PP v2}}/jSetCommandes"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"private, max-age=0"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Server","value":"Microsoft-IIS/10.0"},{"key":"X-AspNet-Version","value":"4.0.30319"},{"key":"X-Powered-By","value":"ASP.NET"},{"key":"Date","value":"Tue, 26 Dec 2023 17:26:14 GMT"},{"key":"Content-Length","value":"149"}],"cookie":[],"responseTime":null,"body":"{\n \"statut\": 1,\n \"statutText\": \"OK\",\n \"result\": {\n \"NB_INSERT\": \"0\",\n \"NB_UPDATE\": \"0\",\n \"NB_UNVALID\": \"0\",\n \"NB_DELETE\": \"0\",\n \"NB_EXP\": \"0\",\n \"NB_CANCEL\": \"1\",\n \"NB_DOCS\": \"0\"\n }\n}"}],"_postman_id":"3db4e5e3-617c-4e5f-9bd7-0a9c02832509"},{"name":"SetCommandeRMA","id":"43b80a53-6ce4-4aad-8971-d6b4ef7fb479","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Clef","value":"{{Clef}}","type":"text"},{"key":"UserName","value":"{{UserName}}","type":"text"},{"key":"Password","value":"{{Password}}","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"Data","value":"{\"ID\": \"TEST\",\"Bordereau\": \"BordereauRMA\",\"Articles\": [{\"ID\": \"Article.001\",\"Qte\":1}]}","type":"text"}]},"url":"{{URL PP v2}}/jSetCommandeRMA","description":"

Cette méthode permet d’enregistrer un RMA pour une commande donnée.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Champ	Détail	Oblig.	Nb caractère	Commentaires
ID	Identifiant de la commande	O	30
DestID	Identifiant du destinataire	N	50
Bordereau	Bordereau utilisé pour le retour	O	50
Articles	Liste des articles RMA	O		Liste de « Article »

Article :

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Champ	Détail	Oblig.	Défaut	Nb caractère	Commentaires
ID	Identifiant de l’article	O		50
Qté	Quantité retournée	N	1

Exemple de retour avec succès :

{\n\"statut\":1, \"statutText\":\"OK\", \"result\":{\n\"ID\":\"maCommande\", \"DestId\":\"monDestinataire\", \"Kit\": monKit\n}\n}\n\n

Valeur de \"Reference\" dans SetCommandeRMA

\n","type":"text","disabled":true}]},"url":"{{URL PP v2}}/jGetRMA","description":"

Cette méthode permet de récupérer le statut de retour d'une commande.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Champ	Détail	Oblig.
ID	Identifiant de la commande	O
DestID	Identifiant du destinataire dans la commande	N
Reference	Référence client de l'annonce de retour	N
Colis	Bordereau du colis aller	N
Retour	Bordereau du colis retour	N

Un des champs est requis pour identifier une commande et de retourner son statut.

Cette méthode permet de récupérer les stocks d’un ou de plusieurs articles

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Champ	Détail	Obligatoire	Défaut	Nb caractères	Commentaire
ID	Identifiant de l'article	O		35	Ou « Référence Client » (voir Géolie la liste des Articles), « * » permet de récupérer tout le stock.

Cette méthode permettra de lire l’ensemble de valeurs (idem SetArticles) de fiches Articles.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Champ	Détail	Obligatoire	Défaut	Nb caractère	Commentaire
ID	Identifiant de l'article	O		35

Cette méthode permet de récupérer le statut global d’une commande fournisseur.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Champ	Détail	Oblig.	Nb caractère	Commentaire
ID	Identifiant de la commande fournisseur	N	30	Référence client de l'annonce
BL	Numéro du bon de livraison	N	50	L'appel de la méthode via le numéro du BL est réservée au réception sans annonce au préalable (SetCommandeF)
REC	ID unique réception	N	30	Il s'agit de l'ID unique retouné par la notification de type REC

La liste des statuts est :

0 : En attente
\n
1 : En cours
\n
2 : Terminée
\n

Réponse type :

{\n    \"statut\": 1,    // si OK\n    \"statutText\": \"OK\", // Libellé statut\n    \"result\": [\n        {\n            \"ID\": \"Identifiant de la commande fournisseur\",        \n            \"BonLivraison\": \"Numéro du bon de livraison\",\n            \"Fournisseur\": NULL,\n            \"MVT_REF_CLIENT\": NULL,\n            \"Date\": \"2025-08-07\",\n            \"IdStatut\": \"2\",\n            \"Statut\": \"Terminé\",\n            \"Commentaire\": NULL,\n            \"ARTICLES\": [\n                {\n                    \"ID\": \"SKU ARTICLE\",\n                    \"STOCK\": \"Principal\",\n                    \"QTE_ANNONCEE\": NULL,\n                    \"NB_RECPT\": \"1\",\n                    \"QTE_RECUE\": \"10\",\n                    \"QTE_RESTE\": NULL,\n                    \"Serials\": [\n                        \"SN00001\",\n                        \"SN00002\",\n                        \"SN00003\",\n                        \"SN00004\",\n                        \"SN00005\",\n                        \"SN00006\",\n                        \"SN00007\",\n                        \"SN00008\",\n                        \"SN00009\",\n                        \"SN00010\"\n                    ]\n                }\n            ]\n        }\n    ]\n}\n\n

","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":""},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"4858b84f-6a41-49c7-a1c2-6356c354afa5","id":"4858b84f-6a41-49c7-a1c2-6356c354afa5","name":"Geolie API","type":"collection"}},"urlObject":{"path":["jGetStatutCommandeF"],"host":["{{URL PP v2}}"],"query":[],"variable":[]}},"response":[{"id":"f90f28cf-fcc1-4f7e-9709-7bb74da6fe19","name":"GetStatutCommandeF ID","originalRequest":{"method":"POST","header":[{"key":"Clef","value":"{{Clef}}","type":"text"},{"key":"UserName","value":"{{UserName}}","type":"text"},{"key":"Password","value":"{{Password}}","type":"text"},{"key":"Content-Type","name":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"Data","value":"[{\"ID\":\"1234\"}]","type":"text"}]},"url":"{{URL PP v2}}/jGetStatutCommandeF"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"private, max-age=0"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Server","value":"Microsoft-IIS/10.0"},{"key":"X-AspNet-Version","value":"4.0.30319"},{"key":"X-Powered-By","value":"ASP.NET"},{"key":"Date","value":"Wed, 13 Dec 2023 12:05:45 GMT"},{"key":"Content-Length","value":"331"}],"cookie":[],"responseTime":null,"body":"{\n \"statut\": 1,\n \"statutText\": \"OK\",\n \"result\": [\n {\n \"ID\": \"TEST\",\n \"BonLivraison\": \"SPECIMEN\",\n \"MVT_REF_CLIENT\": \"TEST\",\n \"FOURNISSEUR\": \"Nom_fournisseur\",\n \"Date\": \"2023-10-03\",\n \"IdStatut\": \"0\",\n \"Statut\": \"En attente\",\n \"ARTICLES\": [\n {\n \"ID\": \"ARTICLE.001\",\n \"STOCK\": \"Principal\",\n \"QTE_ANNONCEE\": \"500\"\n },\n {\n \"ID\": \"ARTICLE.002\",\n \"STOCK\": \"Principal\",\n \"QTE_ANNONCEE\": \"500\"\n }\n ]\n }\n ]\n}"},{"id":"2083ed59-e574-4c1d-95a6-c7e5cd9d5811","name":"GetStatutCommandeF BL","originalRequest":{"method":"POST","header":[{"key":"Clef","value":"{{Clef}}","type":"text","disabled":true},{"key":"UserName","value":"{{UserName}}","type":"text","disabled":true},{"key":"Password","value":"{{Password}}","type":"text","disabled":true},{"key":"Clef","value":"a77fe9806504467c944718a3ce1ed5cb","type":"text"},{"key":"UserName","value":"spk_api_pp","type":"text"},{"key":"Password","value":"084367ddf1144a13eaebaa8902a0fb99","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"Data","value":"[{\"BL\":\"SPK_LOGSYS_009\"}]","type":"text"}]},"url":"{{URL PP v2}}/jGetStatutCommandeF"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"private, max-age=0"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Server","value":"Microsoft-IIS/10.0"},{"key":"X-AspNet-Version","value":"4.0.30319"},{"key":"X-Powered-By","value":"ASP.NET"},{"key":"Date","value":"Fri, 15 Dec 2023 14:11:47 GMT"},{"key":"Content-Length","value":"322"}],"cookie":[],"responseTime":null,"body":"{\n \"statut\": 1,\n \"statutText\": \"OK\",\n \"result\": [\n {\n \"BonLivraison\": \"BL009\",\n \"FOURNISSEUR\": \"Nom_fournisseur\",\n \"Date\": \"2023-12-13\",\n \"IdStatut\": \"2\",\n \"Statut\": \"Terminé\",\n \"ARTICLES\": [\n {\n \"ID\": \"206408\",\n \"STOCK\": \"BLOQUEE\",\n \"NB_RECPT\": \"1\",\n \"QTE_RECUE\": \"1\"\n },\n {\n \"ID\": \"220685\",\n \"STOCK\": \"STANDARD\",\n \"NB_RECPT\": \"1\",\n \"QTE_RECUE\": \"1\"\n }\n ]\n }\n ]\n}"},{"id":"1fc6f42d-c8e0-41a0-b201-7ca7192ed934","name":"GetStatutCommandeF REC","originalRequest":{"method":"POST","header":[{"key":"Clef","value":"{{Clef}}","type":"text","disabled":true},{"key":"UserName","value":"{{UserName}}","type":"text","disabled":true},{"key":"Password","value":"{{Password}}","type":"text","disabled":true},{"key":"Clef","value":"a77fe9806504467c944718a3ce1ed5cb","type":"text"},{"key":"UserName","value":"spk_api_pp","type":"text"},{"key":"Password","value":"084367ddf1144a13eaebaa8902a0fb99","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"Data","value":"[{\"REC\":\"2566421\"}]","type":"text"}]},"url":"{{URL PP v2}}/jGetStatutCommandeF"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"private, max-age=0"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Server","value":"Microsoft-IIS/10.0"},{"key":"X-AspNet-Version","value":"4.0.30319"},{"key":"X-Powered-By","value":"ASP.NET"},{"key":"Date","value":"Fri, 15 Dec 2023 14:55:58 GMT"},{"key":"Content-Length","value":"322"}],"cookie":[],"responseTime":null,"body":"{\n \"statut\": 1,\n \"statutText\": \"OK\",\n \"result\": [\n {\n \"BonLivraison\": \"BL009\",\n \"FOURNISSEUR\": \"Nom_fournisseur\",\n \"Date\": \"2023-12-13\",\n \"IdStatut\": \"2\",\n \"Statut\": \"Terminé\",\n \"ARTICLES\": [\n {\n \"ID\": \"206408\",\n \"STOCK\": \"BLOQUEE\",\n \"NB_RECPT\": \"1\",\n \"QTE_RECUE\": \"1\"\n },\n {\n \"ID\": \"220685\",\n \"STOCK\": \"STANDARD\",\n \"NB_RECPT\": \"1\",\n \"QTE_RECUE\": \"1\"\n }\n ]\n }\n ]\n}"}],"_postman_id":"a4f2975d-2d6a-45c8-8ba5-380b482a786d"},{"name":"GetStatutCommande V1","id":"f5fa554e-c6ce-4efd-b4a1-43d013f6e4a8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Clef","value":"{{Clef}}","type":"text"},{"key":"UserName","value":"{{UserName}}","type":"text"},{"key":"Password","value":"{{Password}}","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"Data","value":"[{\"ID\":\"TEST\"}]","type":"text"}]},"url":"{{URL PP v1}}/jGetStatutCommande","description":"

Cette méthode permet de récupérer le statut global d’une commande.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Champ	Détail	Oblig.	Nb caractère	Commentaires
ID	Identifiant de la commande	O	30	Inutile si « serial » est renseigné
DestID	Identifiant du destinataire	N	50
serial	Numéro de série servi	N	50

[Liste des statuts des commandes](https://logsytech.postman.co/workspace/9a5810eb-6ae9-4e4a-8514-f742111369c1/request/9022498-e2f272ba-335d-4a07-b11e-c2a4b8c89d1e?action=share&source=copy-link&creator=30275221&ctx=documentation)

Cette méthode permet de récupérer le statut global d’une commande.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Champ	Détail	Oblig.	Nb caractère	Commentaires
ID	Identifiant de la commande	O	30	Inutile si « serial » est renseigné
DestID	Identifiant du destinataire	N	50
serial	Numéro de série servi	N	50

Liste des statuts des commandes

Voir chapitre Statuts des commandes.

Cette méthode permet de valider la conformité d’une adresse.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Champ	Détail	Oblig.	Défaut
Adresse	Adresse	F
CodePostal	Code postal	F
Localite	Ville	F
Pays	Pays	F	FR

Valeurs retournées dans « Status » :

Aucun : aucun résultat,
OK : l’adresse a été trouvée,
Plusieurs : adresses équivoques,
Equivalents : adresses équivalentes,
Modifiés : adresse

Création d’un nouveau bordereau retour.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Champ	Détail	Oblig.	Nb caractère	Commentaires
ID	Identifiant de la commande	O	30
DestID	Identifiant du destinataire	N	50
Type	Transporteur à appeler	O		ID Transporteur – ci-dessous

Les valeurs pour Type disponibles sont :
• 1 : Colissimo
• 2 : Chronopost

La méthode Call est la partie spéifique de l'API Optilog. Si en tant que client vous demander un développement spécifique, c'est une méthode Call qui sera développée.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Champ	Détail	Oblig.	Défaut	Commentaires
Method	Nom de la fonction demandée	O		20 caractères max
Params	Liste de « Param »	O		Cf ci-dessous

Param :

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Champ	Détail	Oblig.	Défaut	Commentaires
Nom	Nom du paramètre	O
Valeur	Valeur du paramètre	O

La valeur à passer dans « Methode » dépend du client.

Liste des méthodes disponible :

GET_TRACKING : permet de récupérer les informations de suivi de livraison d'une commande.
GET_MOUVEMENTS : permet de récupérer les derniers mouvements de stocks réalisés dans l'outil de gestion d'entrepôt.

\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":""},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"4858b84f-6a41-49c7-a1c2-6356c354afa5","id":"4858b84f-6a41-49c7-a1c2-6356c354afa5","name":"Geolie API","type":"collection"}},"urlObject":{"path":["jCall"],"host":["{{URL PP v1}}"],"query":[],"variable":[]}},"response":[{"id":"7a8f84ac-57ec-4d36-a2f9-402acee8c09d","name":"GET_TRACKING","originalRequest":{"method":"POST","header":[{"key":"Clef","value":"{{Clef}}","type":"text"},{"key":"UserName","value":"{{UserName}}","type":"text"},{"key":"Password","value":"{{Password}}","type":"text"},{"key":"Content-Type","name":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"Data","value":"{\"Methode\":\"GET_TRACKING\",\"Params\":[{\"Nom\":\"Id\",\"Valeur\":\"TEST\"}]}","type":"text"}]},"url":"{{URL PP v1}}/jCall"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"private, max-age=0"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Server","value":"Microsoft-IIS/10.0"},{"key":"X-AspNet-Version","value":"4.0.30319"},{"key":"X-Powered-By","value":"ASP.NET"},{"key":"Date","value":"Mon, 09 Oct 2023 09:03:30 GMT"},{"key":"Content-Length","value":"494"}],"cookie":[],"responseTime":null,"body":"{\n \"statut\": 1,\n \"statutText\": \"OK\",\n \"result\": [\n {\n \"TRAC_ID\": 27667243,\n \"TRAC_ID_BORDEREAU\": \"EXP_4582851\",\n \"TRAC_DATE\": \"03/10/2023\",\n \"TRAC_HEURE\": \"11:51\",\n \"TRAC_ID_STA\": 8,\n \"STATUTPERE\": \"Mis en livraison\",\n \"STATUTFILS\": \"Départ logisticien\",\n \"TRAC_DATE_IMPORT\": \"03/10/2023\",\n \"STATUT\": \"OK\"\n },\n {\n \"TRAC_ID\": 27667244,\n \"TRAC_ID_BORDEREAU\": \"EXP_4582851\",\n \"TRAC_DATE\": \"03/10/2023\",\n \"TRAC_HEURE\": \"11:51\",\n \"TRAC_ID_STA\": 43,\n \"STATUTPERE\": \"Livré conforme\",\n \"STATUTFILS\": \"Envoi livré\",\n \"TRAC_DATE_IMPORT\": \"03/10/2023\",\n \"STATUT\": \"OK\"\n }\n ]\n}"},{"id":"9cbb165f-4462-4d29-91fb-1bd4b78c8b35","name":"GET_MOUVEMENTS","originalRequest":{"method":"POST","header":[{"key":"Clef","value":"{{Clef}}","type":"text"},{"key":"UserName","value":"{{UserName}}","type":"text"},{"key":"Password","value":"{{Password}}","type":"text"},{"key":"Content-Type","name":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"Data","value":"{\"Methode\":\"GET_MOUVEMENTS\",\"Params\":[{\"Nom\":\"Id\",\"Valeur\":\"ARTICLE.001\"}]}","type":"text"}]},"url":"{{URL PP v1}}/jCall"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"private, max-age=0"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Server","value":"Microsoft-IIS/10.0"},{"key":"X-AspNet-Version","value":"4.0.30319"},{"key":"X-Powered-By","value":"ASP.NET"},{"key":"Date","value":"Mon, 09 Oct 2023 09:11:43 GMT"},{"key":"Content-Length","value":"2773"}],"cookie":[],"responseTime":null,"body":"{\n \"statut\": 1,\n \"statutText\": \"OK\",\n \"result\": [\n {\n \"mvt_keyu\": 5052974,\n \"mvt_crda\": \"23/06/2023\",\n \"mvt_crhe\": \"151407\",\n \"qua_code\": \"QSTD\",\n \"mvt_sens\": \"+\",\n \"mvt_qte\": 100,\n \"mvt_ref\": \"Entrée de régularisation\",\n \"mvt_mot\": \"test\",\n \"ope_rtie\": null,\n \"STATUT\": \"OK\"\n },\n {\n \"mvt_keyu\": 5053180,\n \"mvt_crda\": \"17/07/2023\",\n \"mvt_crhe\": \"110929\",\n \"qua_code\": \"QSTD\",\n \"mvt_sens\": \"+\",\n \"mvt_qte\": 10,\n \"mvt_ref\": \"Entrée de régularisation\",\n \"mvt_mot\": \"test\",\n \"ope_rtie\": null,\n \"STATUT\": \"OK\"\n },\n {\n \"mvt_keyu\": 5053181,\n \"mvt_crda\": \"17/07/2023\",\n \"mvt_crhe\": \"122043\",\n \"qua_code\": \"QSTD\",\n \"mvt_sens\": \"-\",\n \"mvt_qte\": 1,\n \"mvt_ref\": \"Sortie expédition\",\n \"mvt_mot\": \"Validation de la ligne 1 de la mission 627\",\n \"ope_rtie\": \"ZFPDKAEPA\",\n \"STATUT\": \"OK\"\n },\n {\n \"mvt_keyu\": 5053237,\n \"mvt_crda\": \"25/07/2023\",\n \"mvt_crhe\": \"114840\",\n \"qua_code\": \"QSTD\",\n \"mvt_sens\": \"-\",\n \"mvt_qte\": 1,\n \"mvt_ref\": \"Sortie expédition\",\n \"mvt_mot\": \"Validation de la ligne 1 de la mission 714\",\n \"ope_rtie\": \"DTTWWAGVI\",\n \"STATUT\": \"OK\"\n },\n {\n \"mvt_keyu\": 5053252,\n \"mvt_crda\": \"31/07/2023\",\n \"mvt_crhe\": \"101529\",\n \"qua_code\": \"QSTD\",\n \"mvt_sens\": \"+\",\n \"mvt_qte\": 100,\n \"mvt_ref\": \"Entrée de régularisation\",\n \"mvt_mot\": \"test\",\n \"ope_rtie\": null,\n \"STATUT\": \"OK\"\n },\n {\n \"mvt_keyu\": 5053253,\n \"mvt_crda\": \"31/07/2023\",\n \"mvt_crhe\": \"145419\",\n \"qua_code\": \"QSTD\",\n \"mvt_sens\": \"+\",\n \"mvt_qte\": 2,\n \"mvt_ref\": \"Entrée de régularisation\",\n \"mvt_mot\": \"test\",\n \"ope_rtie\": null,\n \"STATUT\": \"OK\"\n },\n {\n \"mvt_keyu\": 5053254,\n \"mvt_crda\": \"31/07/2023\",\n \"mvt_crhe\": \"150907\",\n \"qua_code\": \"QSTD\",\n \"mvt_sens\": \"+\",\n \"mvt_qte\": 10,\n \"mvt_ref\": \"Entrée de régularisation\",\n \"mvt_mot\": \"test\",\n \"ope_rtie\": null,\n \"STATUT\": \"OK\"\n },\n {\n \"mvt_keyu\": 5053255,\n \"mvt_crda\": \"31/07/2023\",\n \"mvt_crhe\": \"155853\",\n \"qua_code\": \"QSTD\",\n \"mvt_sens\": \"-\",\n \"mvt_qte\": 1,\n \"mvt_ref\": \"Sortie expédition\",\n \"mvt_mot\": \"Validation de la ligne 1 de la mission 786\",\n \"ope_rtie\": \"LOAANITMW\",\n \"STATUT\": \"OK\"\n },\n {\n \"mvt_keyu\": 5053256,\n \"mvt_crda\": \"31/07/2023\",\n \"mvt_crhe\": \"160636\",\n \"qua_code\": \"QSTD\",\n \"mvt_sens\": \"-\",\n \"mvt_qte\": 10,\n \"mvt_ref\": \"Sortie diverse\",\n \"mvt_mot\": \"Test\",\n \"ope_rtie\": null,\n \"STATUT\": \"OK\"\n },\n {\n \"mvt_keyu\": 5053260,\n \"mvt_crda\": \"02/08/2023\",\n \"mvt_crhe\": \"104525\",\n \"qua_code\": \"QSTD\",\n \"mvt_sens\": \"-\",\n \"mvt_qte\": 1,\n \"mvt_ref\": \"Sortie expédition\",\n \"mvt_mot\": \"Validation de la ligne 1 de la mission 789\",\n \"ope_rtie\": \"JKIRRIQZJ\",\n \"STATUT\": \"OK\"\n },\n {\n \"mvt_keyu\": 5053261,\n \"mvt_crda\": \"02/08/2023\",\n \"mvt_crhe\": \"181046\",\n \"qua_code\": \"QSTD\",\n \"mvt_sens\": \"-\",\n \"mvt_qte\": 1,\n \"mvt_ref\": \"Sortie expédition\",\n \"mvt_mot\": \"Validation de la ligne 1 de la mission 792\",\n \"ope_rtie\": \"JGJHLGWSA\",\n \"STATUT\": \"OK\"\n },\n {\n \"mvt_keyu\": 5053309,\n \"mvt_crda\": \"05/09/2023\",\n \"mvt_crhe\": \"133555\",\n \"qua_code\": \"QSTD\",\n \"mvt_sens\": \"+\",\n \"mvt_qte\": 1,\n \"mvt_ref\": \"Entrée diverse\",\n \"mvt_mot\": \"Test\",\n \"ope_rtie\": null,\n \"STATUT\": \"OK\"\n },\n {\n \"mvt_keyu\": 5053447,\n \"mvt_crda\": \"05/10/2023\",\n \"mvt_crhe\": \"093257\",\n \"qua_code\": \"QSTD\",\n \"mvt_sens\": \"+\",\n \"mvt_qte\": 1,\n \"mvt_ref\": \"Entrée diverse\",\n \"mvt_mot\": \"Test\",\n \"ope_rtie\": null,\n \"STATUT\": \"OK\"\n }\n ]\n}"}],"_postman_id":"503b27e6-de6e-456e-bd61-56340fa3af3c"},{"name":"Notification","id":"b905a17f-c26a-42a9-9afc-2260089f19f9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"key","value":"{{key}}","type":"text"},{"key":"url","value":"{{URL Notification OPTILOG}}","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"Event","value":"[{\"Type\":\"CMD\",\"Mode\":\"update\",\"ID\":\"TEST_003\",\"Value\":\"1\",\"DestID\":\"123\",\"DT\":\"2023-10-09 12:00:48\",\"Comment\":\"Commandes\"},{\"Type\":\"STK\",\"Mode\":\"update\",\"ID\":\"ARTICLE.001\",\"DT\":\"2023-10-09 12:08:28\",\"Comment\":\"Stock\"}]},{\"Type\":\"REC\",\"Mode\":\"update\",\"ID\":\"BL_001\",\"DT\":\"2023-10-09 12:08:28\",\"Comment\":\"Reception\"}]},{\"Type\":\"COMF\",\"Mode\":\"update\",\"ID\":\"TEST\",\"DT\":\"2023-10-09 12:08:28\",\"Comment\":\"Commande fournisseur\"}]","type":"text","uuid":"5103171c-92d0-45b2-9381-c16b25724ff1"}]},"url":"{{URL Notification}}","description":"

Une notification peut être envoyée vers une URL afin de signifier qu’un état a
changer concernant un objet donné.

Les données sont transmise dans une chaine jSon.

Les états suivants sont gérés :

Commande client (CMD)
\n
Retour client avec annonce (RMA)
\n
Stocks (STK)
\n
Commande fournisseur (COMF)
\n
Réception sans annonce (REC)
\n
Article (ART)
\n

Dès qu'un changement apparait sur l'un de ces items (ex : changement de statut d'une commande client), une notification sera poussée vers le endpoint communiqué.

Contenu d'une notification :

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Champ	Détail	Commentaires
Type	Type de notification	Liste des valeurs possibles : - CMD : Commande client - RMA : Retour commande client avec annonce - STK : Stock variation - COMF : Commande fournisseur - REC : Réception sans annonce - ART : Modification fiche article
Mode	Indication sur l'action réalisée	Liste des valeurs possibles : - create : exemple création d'une commande client - update : exemple stock variation
ID	ID de l'objet	ID a retourner dans la méthode qui suit la notification (ex : GetStatutCommande, etc...)
Value	Valeur variable en fonction du Type	Liste des valeurs possibles - Si Type = CMD -> statut de la commande (1, 3, etc...) - Si Type = RMA alors RMA réféence client - Si Type = STK alors NULL - Si Type = COMF alors 0 (create), 1 (in progress) ou 2 (closed) - Si Type = REC alors Numéro bon livraison - Si Type = ART alors DIM ( Dimension), PDS (Poids) ou PIC (Picture)
DT	Datetime	Datetime de la notification
Comment	Indication supplémentaire liée au Type	Liste des valeurs possibles : - Commandes - Stock - Stock après CMD - Commande fournisseur - Fiche article - Retour - Reception

Réponse attendu de la part de votre endpoint :

{ \"statut\" : \"1\", \"StatutText\" : \"Notified 15 Changes\" } (la valeur 15 étant le nombre de lignes de notification transmise)

La requête demande à ce que lui soit retourner le document mis en paramètre.

Les paramètres renvoyés sont ceux qui ont été poussés dans la balise \"Documents\" lors de l'appel à une méthode Set par le client.

Il vaut mieux privilégier cette façon de transmettre des documents, car le traitement dans le SI peut être assez long (>10s).

Les paramètres passés sont en fonction des données transmis dans Documents lors de l'appel Set... :

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Champ	Détail	Commentaires
TYPE	{type}	Type du document Permet d'orienter le traitement du fichier dans le SI.
CLT	ABC	Identifiant du client
KIT / ART	ABC1234	Identifiant ERP de l'objet
ID	{file}	Identifiant du document
NOM	{name}	Nom du document
FILE	{filename}	Nom de fichier
CRC	{md5}	ID de contrôle du fichier

L'appel attend une réponse contenant les données du fichier en question ainsi :

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Champ	Détail	Oblig.	Commentaires
statut	\"1\" si succès	O	Statut du traitement
statutText	\"OK\"	O	Texte libre
file	{}	O	Balises du fichier
logs	{}	F	Balises erreur

Champ \"file\" : Les balises d'un fichier sont

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Champ	Détail	Oblig.	Commentaires
name	{name}	F	Nom
filename	{filename}	O	Nom du fichier
size	123	F	Taille (Ko)
path	{path}	F
url	{url}	F
md5	{md5}	F	Permet le contrôle du ficher
raw	Base64	O	Données du fichier

Le fichier transmis (en Base64) sera enregistré en base et écrit sur nos serveurs si le process le requiert par la suite (le document devant être joint à la commande).

Champ \"logs\" : ...

Structure du champ [Documents]

(SetCommandes, SetArticles...)

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Champ	Détail	Oblig.	Commentaires
type	Type du document	O	FACTURE, BL, invoice
file	ID du fichier	N
name	Nom du document	N
filename	Nom du fichier	O	.pdf
path	ID du fichier	N	ID pour récupération via GetDocuments
md5	Version du fichier	N	Pour màj du fichier

Liste des statuts des commandes

-6 : En attente chargement transporteur
\n
-5 : Annulée
\n
-4 : En attente de confirmation de mise en expédition
\n
-3 : Anomalie
\n
0 : En attente de validation
\n
1 : En saisie
\n
2 : En cours de préparation
\n
3 : Préparée
\n
4 : Expédiée
\n
5 : Incident en cours
\n
6 : En instance
\n
7 : Livré conforme
\n
8 : Livré non-conforme
\n
9 : Perdu
\n
10 : Retour
\n
60 : Litige en cours
\n

La modification de commande est permise au statut 0 ou 1 uniquement.