ONTIME API 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.asx.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	*	TYRE	une liste de toutes les adresses possibles pour le .
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
1	RSnr		123456	Si vous souhaitez obtenir l'adresse d'une entreprise spécifique, utilisez ce numéro RS. Si ce champ est laissé vide, toutes les adresses seront proposées.

Exemple JSON

Exemple XML

<?xml version="1.0" encoding="utf-8"?>
<WebOrder> 
    <verwerking>TYRE</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 werden 2 adressen gevonden	Commentaires informatifs
1	adressen
	2	adres
		3	bedrijf		Firma X	nom de l'entreprise
		3	groep		TSE	Regroupement
		3	contact		Jan Janssens	Personne de contact au sein de l'entreprise
		3	adres		Statiestraat	Rue (numéro de maison possible)
		3	huisnr		20	Numéro de maison + numéro de bus
		3	adres2			Possibilité d'une deuxième ligne d'adresse
		3	postcode		2000	code postal
		3	gemeente		Antwerpen	municipalité
		3	email		info@test.be	adresse électronique (si plusieurs, séparées par ; )
		3	RSnr		123456	Numéro RS
		3	tel		3212345678	Numéro de téléphone SANS caractères
		3	uren
			4	maandag	09:00-12:00-13:00-17:00	Heures d'ouverture de cette adresse le LUNDIS: Du matin - au matin - de l'après-midi - à l'après-midi Format : hh:mm-hh:mm-hh:mm-hh:mm
			4	dinsdag	09:00-12:00-13:00-17:00	MARDI
			4	woensdag	09:00-12:00-13:00-17:00	MERCREDI
			4	donderdag	09:00-12:00-13:00-17:00	JEUDI
			4	vrijdag	09:00-12:00-13:00-17:00	VENDREDI
			4	zaterdag	09:00-12:00-13:00-17:00	SAMEDI
		3	uniekNr		123456	uniek adresnummer

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 2 adressen gevonden</remark>
    </remarks>
    <adressen>
        <adres>
            <bedrijf>Firma X</bedrijf>
            <groep>TSE</groep>
            <contact>Jan Janssens</contact>
            <adres>Statiestraat</adres>
            <huisnr>20</huisnr>
            <adres2></adres2>
            <postcode>2000</postcode>
            <gemeente>Antwerpen</gemeente>
            <email>info@test.be</email>
            <RSnr>123456</RSnr>
            <tel>123456</tel>
            <uren>
                <maandag>09:00-12:00-13:00-17:00</maandag>
                <dinsdag>09:00-12:00-13:00-17:00</dinsdag>
                <woensdag>09:00-12:00-00:00-00:00</woensdag>
                <donderdag>09:00-12:00-13:00-17:00</donderdag>
                <vrijdag>09:00-12:00-13:00-17:00</vrijdag>
                <zaterdag>00:00-00:00-00:00-00:00</zaterdag>
            </uren>
        </adres>
        <adres>
            <bedrijf>Firma X</bedrijf>
            <groep></groep>
            <contact>Jan Janssens</contact>
            <adres>Statiestraat</adres>
            <huisnr>20</huisnr>
            <adres2></adres2>
            <postcode>2000</postcode>
            <gemeente>Antwerpen</gemeente>
            <email>info@test.be</email>
            <RSnr>123456</RSnr>
            <tel>123456</tel>
            <uren>
                <maandag>09:00-12:00-13:00-17:00</maandag>
                <dinsdag>09:00-12:00-13:00-17:00</dinsdag>
                <woensdag>09:00-12:00-00:00-00:00</woensdag>
                <donderdag>09:00-12:00-13:00-17:00</donderdag>
                <vrijdag>09:00-12:00-13:00-17:00</vrijdag>
                <zaterdag>00:00-00:00-00:00-00:00</zaterdag>
            </uren>
        </adres>
    </adressen>
</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 :

Récupérer les adresses d'échange de type