ONTIME DATA Documentatie

CALL

Cette API vous permet de toujours récupérer les produits actifs et possibles pour votre numéro d'entreprise/client.

URL	https://api.ontime.be/DISTRI/
METHOD	POST

REQUEST / INPUT

Vous trouverez ci-dessous la structure utilisée comme entrée, ainsi qu'un exemple illustratif et des informations complémentaires pour chaque champ.
Vous pouvez choisir de nous envoyer les données via JSON ou XML.

Niveau/champ		Obligatoire	Exemple	Description
1	verwerking	*	PRODUCT	une vue d'ensemble de tous les produits possibles pour votre numéro de client est récupérée.
1	gebruiker	*	info@ontime.be	Adresse électronique sur laquelle le compte API a été défini. 250 caractères maximum
1	klantnr	*	K01234	Il s'agit du numéro de client DISTRI chez ON TIME Logistics. Numérique, précédé d'un
1	apipswd	*	c40b0c360f3d4959b53b103b25759542	Mot de passe du compte API
1	omgeving	*	TEST	TEST = Environnement TEST LIVE = Environnement LIVE

Exemple JSON

Exemple XML

<?xml version="1.0" encoding="utf-8"?>
<WebOrder> 
    <verwerking>PRODUCT</verwerking>
    <gebruiker>info@ontime.be</gebruiker>
    <klantnr>K01234</klantnr>
    <apipswd>c40b0c360f3d4959b53b103b25759542</apipswd>
    <omgeving>TEST</omgeving>
</WebOrder>

RESPONSE / OUTPUT

Vous trouverez ci-dessous la structure utilisée en sortie, ainsi qu'un exemple illustratif et des informations complémentaires pour chaque champ.
Si vous envoyez avec JSON, vous recevrez JSON, idem avec XML.

Niveau/champ				Exemple	Description
1	status			SUCCESS
1	remarks
	2	remark		Er werd 1 productn gevonden	Commentaires informatifs
1	producten
	2	product
		3	verpakking	BLOKPAL
		3	Description	BLOKPALLET max 300kg - 1.2 - 0 - 300	Cette description est utilisée lors de la création d'ordres de distribution sous
		3	volume	1.2	par défaut = volume
		3	gewicht	300	par défaut = gewicht
		3	lengte	0	par défaut = lengte
		3	ItemID	ItemID-123456	OF (ipv de omschrijving) kan je ook dit id meegeven bij de creatie van een order in het veld 'goed » product'

Niveau/champ			Exemple	Description
1	status		ERROR
1	remarks
	2	remark	foutieve credentials	Liste des erreurs trouvées

Réponse JSON à SUCCESS

Réponse JSON à ERROR

Réponse XML à SUCCESS

<?xml version="1.0" encoding="utf-8"?>
<WebAnswer> 
    <status>SUCCESS</status>
    <remarks>
        <remark>er werden 3 producten gevonden</remark>
    </remarks>
    <producten>
        <product>
            <verpakking>BLOKPAL</verpakking>
            <omschrijving>BLOKPALLET max 300kg - 1.2 - 0 - 300</omschrijving>
            <volume>1.2</volume>
            <volume_aanpassen>1</volume_aanpassen>
            <gewicht>300</gewicht>
            <gewicht_aanpassen>1</gewicht_aanpassen>
            <lengte>0</lengte>
            <lengte_aanpassen>1</lengte_aanpassen>
        </product>
        <product>
            <verpakking>COLLI</verpakking>
            <omschrijving>COLLI 30-60kg - 0.4 - 0 - 60</omschrijving>
            <volume>0.4</volume>
            <volume_aanpassen>1</volume_aanpassen>
            <gewicht>60</gewicht>
            <gewicht_aanpassen>1</gewicht_aanpassen>
            <lengte>0</lengte>
            <lengte_aanpassen>1</lengte_aanpassen>
        </product>
        <product>
            <verpakking>COLLI</verpakking>
            <omschrijving>colli (50-60kg) - 0.4 - 0 - 60</omschrijving>
            <volume>0.4</volume>
            <volume_aanpassen>1</volume_aanpassen>
            <gewicht>60</gewicht>
            <gewicht_aanpassen>1</gewicht_aanpassen>
            <lengte>0</lengte>
            <lengte_aanpassen>1</lengte_aanpassen>
        </product>
    </producten>
</WebAnswer>

Réponse XML à ERROR

<?xml version="1.0" encoding="utf-8"?>
<WebAnswer> 
    <status>ERROR</status>
    <remarks>
        <remark>foutieve credentials</remark>
    </remarks>
</WebAnswer>

CONTRÔLE/TEST

Grâce à cette fonction, vous pouvez tester n'importe quelle entrée JSON ou XML.
ATTENTION : Cette fonction est TOUJOURS exécutée dans l'environnement TEST.

Votre chaîne INPUT

Le résultat/la réponse :

Collecte des produits DISTRI