ONTIME API Documentatie

CALL

This API allows you to always retrieve the active, possible products for your company/customer number.

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

REQUEST / INPUT

Below is the structure used as input, including an illustrative example and more information for each field.
You may choose whether to send the data to us via JSON or XML

Level/Field		Mandatory	Example	Description
1	verwerking	*	TYRE	A list of all possible addresses for the 'TYRE-EXCHANGE' are retrieved.
1	gebruiker	*	info@ontime.be	Email address on which the API account was defined. Max 250 characters
1	klantnr	*	K01234	This is the DISTRI customer number at ON TIMELogistics. Numeric, preceding with a 'K'
1	apipswd	*	c40b0c360f3d4959b53b103b25759542	Password of the API account
1	omgeving	*	TEST	TEST = TEST environment LIVE = LIVE environment
1	RSnr		123456	If you wish to retrieve the address of 1 specific company, use this RS number. If left blank, 'all' addresses will be offered.

JSON example

XML example

<?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

Below is the structure used as output, including an illustrative example and more information for each field.
If you sent with JSON, you will receive JSON, idem with XML

Level/Field					Example	Description
1	status				SUCCESS
1	remarks
	2	remark			Er werden 2 adressen gevonden	Informative comments
1	adressen
	2	adres
		3	bedrijf		Firma X	Company name
		3	groep		TSE	Grouping
		3	contact		Jan Janssens	Contact person within the company
		3	adres		Statiestraat	Street (house number possible)
		3	huisnr		20	House number + bus number
		3	adres2			Possible second address line
		3	postcode		2000	postal code
		3	gemeente		Antwerpen	municipality
		3	email		info@test.be	email address (if several, separated by ; )
		3	RSnr		123456	RS number
		3	tel		3212345678	Telephone number WITHOUT characters
		3	uren
			4	maandag	09:00-12:00-13:00-17:00	Opening hours of this address on MONDAY: From morning - to morning - from afternoon - to afternoon Format : hh:mm-hh:mm-hh:mm-hh:mm
			4	dinsdag	09:00-12:00-13:00-17:00	TUESDAY
			4	woensdag	09:00-12:00-13:00-17:00	WEDNESDAY
			4	donderdag	09:00-12:00-13:00-17:00	THURSDAY
			4	vrijdag	09:00-12:00-13:00-17:00	FRIDAY
			4	zaterdag	09:00-12:00-13:00-17:00	SATURDAY
		3	uniekNr		123456	uniek adresnummer

Level/Field			Example	Description
1	status		ERROR
1	remarks
	2	remark	foutieve credentials	List of errors found

JSON response at SUCCESS

JSON response to ERROR

XML response at 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>

XML response to ERROR

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

CONTROL/TEST

Through this function, you can try out any JSON or XML input.
ATTENTION : This function is ALWAYS performed in the TEST environment

Your INPUT string

The result/response:

Retrieve 'Type Exchange' Addresses