Introductie

Voordat je gebruik kunt maken van onze API heb je een Billink gebruikersnaam en een UID nodig. Als je deze nog niet hebt ontvangen adviseren we je contact op te nemen met onze klantenservice. Onze klantenservice is van maandag tot en met vrijdag geopend van 08:30 uur tot 17:00 uur en is te bereiken op [email protected] of 010 - 414 14 73.

Om het proces duidelijker te maken leggen wij graag uit hoe ons systeem werkt. Voor elke bestelling dient er een Check API te worden uitgevoerd om de kredietwaardigheid van een consument te controleren. Wanneer een consument kredietwaardig wordt gemarkeerd ontvang je van ons een CHECK-UIDD. Deze CHECK-UIDD is vereist om de order toe te voegen via de Order API.

API's

Check API

Op onze check controleren wij de kredietwaardigheid van de consument. Deze API call is in de basis verplicht om een order te kunnen plaatsen. Wanneer de consument kredietwaardig is geven wij als response een code 500 met CHECK-UUID. Met deze CHECK-UUID kunnen de ordergegevens worden ingeschoten via de Order API. Wanneer de consument wordt afgewezen geven wij code 501 terug.

Voor de Check API hebben we de volgende waardes nodig:
VERSION In alle gevallen is dit "BILLINK2.0".
CLIENTUSERNAME Jouw Billink gebruikersnaam.
CLIENTID Jouw unieke API-sleutel.
ACTION In alle gevallen is dit "Check".
TYPE "P" voor particulieren, "B" voor zakelijke orders.
WORKFLOWNUMBER "1" voor de standaard workflow.
FIRSTNAME De voornaam van de consument.
LASTNAME De achternaam van de consument inclusief tussenvoegsel.
INITIALS Initialen (dit veld is niet verplicht).
STREET Straatnaam van het factuuradres.
HOUSENUMBER Huisnummer van het factuuradres.
HOUSEEXTENSION Extentie van het factuuradres.
POSTALCODE Postcode van het factuuradres.
CITY Stad van het factuuradres.
COUNTRYCODE Landcode van het factuuradres (ISO3166-1 alpha-2).
PHONENUMBER Telefoonnummer van de consument.
BIRTHDATE Geboortedatum (alleen bij type P bestellingen).
COMPANYNAME Bedrijfsnaam (alleen bij type B bestellingen).
CHAMBEROFCOMMERCE Kamer van Koophandel nummer (alleen bij type B bestellingen).
EMAIL Emailadres
ORDERAMOUNT Totale orderbedrag inclusief BTW.
IP IP-adres van de consument.
DELIVERYSTEET Straat van het afleveradres.
DELIVERYHOUSENUMBER Huisnummer van het afleveradres.
DELIVERYHOUSEEXTENSION Extentie van het afleveradres.
DELIVERYPOSTALCODE Postcode van het afleveradres.
DELIVERYCITY Stad van het afleveradres.
DELIVERYCOUNTRYCODE Landcode van het afleveradres (ISO3166-1 alpha-2).
Voorbeeld Check API particuliere order:
POST: https://test.billink.nl/api/check of https://client.billink.nl/api/check
	<API>
		<VERSION>BILLINK2.0</VERSION>
		<CLIENTUSERNAME>usertest</CLIENTUSERNAME>
		<CLIENTID>d38a3439590889df026367bf01d621e687b8d278</CLIENTID>
		<ACTION>check</ACTION>
		<TYPE>p</TYPE>
		<WORKFLOWNUMBER>1</WORKFLOWNUMBER>
		<FIRSTNAME>Test</FIRSTNAME>
		<LASTNAME>Test</LASTNAME>
		<INITIALS>T</INITIALS>
		<STREET>Wilhelminakade</STREET>
		<HOUSENUMBER>159</HOUSENUMBER>
		<HOUSEEXTENSION>A</HOUSEEXTENSION>
		<POSTALCODE>3072AP</POSTALCODE>
		<CITY>Rotterdam</CITY>
		<COUNTRYCODE>NL</COUNTRYCODE>
		<PHONENUMBER>0104141473</PHONENUMBER>
		<BIRTHDATE>01-01-1985</BIRTHDATE>
		<EMAIL>[email protected]</EMAIL>
		<ORDERAMOUNT>100</ORDERAMOUNT>
		<IP>172.2.168.1</IP>
		<DELIVERYSTEET>Wilhelminakade</DELIVERYSTEET>
		<DELIVERYHOUSENUMBER>159</DELIVERYHOUSENUMBER>
		<DELIVERYHOUSEEXTENSION>B</DELIVERYHOUSEEXTENSION>
		<DELIVERYPOSTALCODE>3072AP</DELIVERYPOSTALCODE>
		<DELIVERYCITY>Rotterdam</DELIVERYCITY>
		<DELIVERYCOUNTRYCODE>NL</DELIVERYCOUNTRYCODE>
	</API>
	
Voorbeeld Check API zakelijke order:
POST: https://test.billink.nl/api/check of https://client.billink.nl/api/check
	<API>
		<VERSION>BILLINK2.0</VERSION>
		<CLIENTUSERNAME>usertest</CLIENTUSERNAME>
		<CLIENTID>d38a3439590889df026367bf01d621e687b8d278</CLIENTID>
		<ACTION>check</ACTION>
		<TYPE>b</TYPE>
		<WORKFLOWNUMBER>1</WORKFLOWNUMBER>
		<FIRSTNAME>Test</FIRSTNAME>
		<LASTNAME>Test</LASTNAME>
		<INITIALS>T</INITIALS>
		<STREET>Wilhelminakade</STREET>
		<HOUSENUMBER>159</HOUSENUMBER>
		<HOUSEEXTENSION>A</HOUSEEXTENSION>
		<POSTALCODE>3072AP</POSTALCODE>
		<CITY>Rotterdam</CITY>
		<COUNTRYCODE>NL</COUNTRYCODE>
		<PHONENUMBER>0104141473</PHONENUMBER>
		<COMPANYNAME>Billink B.V.</COMPANYNAME>
		<CHAMBEROFCOMMERCE>12345678</CHAMBEROFCOMMERCE>
		<EMAIL>[email protected]</EMAIL>
		<ORDERAMOUNT>100</ORDERAMOUNT>
		<IP>172.2.168.1</IP>
		<DELIVERYSTEET>Wilhelminakade</DELIVERYSTEET>
		<DELIVERYHOUSENUMBER>159</DELIVERYHOUSENUMBER>
		<DELIVERYHOUSEEXTENSION>B</DELIVERYHOUSEEXTENSION>
		<DELIVERYPOSTALCODE>3072AP</DELIVERYPOSTALCODE>
		<DELIVERYCITY>Rotterdam</DELIVERYCITY>
		<DELIVERYCOUNTRYCODE>NL</DELIVERYCOUNTRYCODE>
	</API>

Voorbeeld response goedkeuring:
	<API>
		<RESULT>MSG</RESULT>
		<MSG>
			<CODE>500</CODE>
			<DESCRIPTION>Advies=1</DESCRIPTION>
		</MSG>
		<UUID>XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX</UUID>
	</API>

Voorbeeld response afwijzing:
	<API>
		<RESULT>MSG</RESULT>
		<MSG>
			<CODE>501</CODE>
			<DESCRIPTION>Advies=0</DESCRIPTION>
		</MSG>
	</API>

Naast afwijzingen kan het ook voorkomen dat gegevens niet compleet zijn. Hiervoor zijn aparte foutcodes.
Deze kunnen hier gevonden worden.

Order API

Op de Order API kunnen orders worden ingeschoten. Om een order te kunnen toevoegen hebben we een CHECK-UUID nodig.

Voor de Order API hebben we de volgende waardes nodig. Velden gemarkeerd met een "*" zijn optioneel.
VERSION In alle gevallen is dit "BILLINK2.0"
CLIENTUSERNAME Jouw Billink gebruikersnaam
CLIENTID Jouw unieke API-sleutel
ACTION In alle gevallen is dit "Order"
TYPE "P" voor particulieren, "B" voor zakelijke orders
WORKFLOWNUMBER "1" voor de standaard workflow
ORDERNUMBER Het factuurnummer die de order moet krijgen
DATE De orderdatum die moet worden getoond op de factuur
FIRSTNAME De voornaam van de consument
LASTNAME De achternaam van de consument inclusief tussenvoegsel
SEX Het geslacht van de consument (alleen bij type P bestellingen (M, V of O)
INITIALS* Initialen
STREET Straatnaam van het factuuradres
HOUSENUMBER Huisnummer van het factuuradres
HOUSEEXTENSION* Extentie van het factuuradres
POSTALCODE Postcode van het factuuradres
CITY Stad van het factuuradres
COUNTRYCODE Landcode van het factuuradres (ISO3166-1 alpha-2)
PHONENUMBER Telefoonnummer van de consument
BIRTHDATE Geboortedatum (alleen bij type P bestellingen)
COMPANYNAME Bedrijfsnaam (alleen bij type B bestellingen)
CHAMBEROFCOMMERCE Kamer van Koophandel nummer (alleen bij type B bestellingen)
EMAIL Emailadres
EMAIL2* Tweede ontvanger Emailadres
IP IP-adres van de consument
DELIVERYSTEET* Straat van het afleveradres
DELIVERYHOUSENUMBER* Huisnummer van het afleveradres
DELIVERYHOUSEEXTENSION* Extentie van het afleveradres
DELIVERYPOSTALCODE* Postcode van het afleveradres
DELIVERYCITY* Stad van het afleveradres
DELIVERYCOUNTRYCODE* Landcode van het afleveradres (ISO3166-1 alpha-2)
ADITIONALTEXT* Toegevoegde tekst voor op de factuur
TRACKANDTRACE* Track and Trace code
VATNUMBER* BTW nummer van de consument
CHECKUUID De waarde gebruiken vanuit de Check API
CURRENCY* Alleen van toepassing bij orders buiten Europa (EUR, USD of GBP)
STATE* Alleen van toepassing bij orders buiten Europa
LOCALITY* Alleen van toepassing bij orders buiten Europa
CODE Artikelnummer van het product
DESCRIPTION Omschrijving van het product
ORDERQUANTITY De hoeveelheid producten
PRICEINCL Gebruiken bij type P bestellingen
PRICEEXCL Gebruiken bij type B bestellingen
BTW "0", "1.0", "6", "1.06", "7", "19", "1.19", "20", "1.20", "21", "1.21
Voorbeeld Order API particuliere order:
POST: https://test.billink.nl/api/order of https://client.billink.nl/api/order
	<API>
		<VERSION>BILLINK2.0</VERSION>
		<CLIENTUSERNAME>usertest</CLIENTUSERNAME>
		<CLIENTID>d38a3439590889df026367bf01d621e687b8d278</CLIENTID>
		<ACTION>order</ACTION>
		<TYPE>p</TYPE>
		<WORKFLOWNUMBER>1</WORKFLOWNUMBER>
		<ORDERNUMBER>1234567</ORDERNUMBER>
		<DATE>DD-MM-YYYY</DATE>
		<FIRSTNAME>Test</FIRSTNAME>
		<LASTNAME>Test</LASTNAME>
		<SEX>O</SEX>
		<INITIALS>T</INITIALS>
		<STREET>Wilhelminakade</STREET>
		<HOUSENUMBER>159</HOUSENUMBER>
		<HOUSEEXTENSION>A</HOUSEEXTENSION>
		<POSTALCODE>3072AP</POSTALCODE>
		<CITY>Rotterdam</CITY>
		<COUNTRYCODE>NL</COUNTRYCODE>
		<PHONENUMBER>0104141473</PHONENUMBER>
		<BIRTHDATE>01-01-1985</BIRTHDATE>
		<EMAIL>[email protected]</EMAIL>
		<EMAIL2>[email protected]</EMAIL2>
		<IP>172.2.168.1</IP>
		<DELIVERYSTEET>Wilhelminakade</DELIVERYSTEET>
		<DELIVERYHOUSENUMBER>159</DELIVERYHOUSENUMBER>
		<DELIVERYHOUSEEXTENSION>B</DELIVERYHOUSEEXTENSION>
		<DELIVERYPOSTALCODE>3072AP</DELIVERYPOSTALCODE>
		<DELIVERYCITY>Rotterdam</DELIVERYCITY>
		<DELIVERYCOUNTRYCODE>NL</DELIVERYCOUNTRYCODE>
		<ADITIONALTEXT>Toegevoegde tekst 1</ADITIONALTEXT>
		<TRACKANDTRACE>JVL1123457488</TRACKANDTRACE>
		<VATNUMBER>NL1234578B01</VATNUMBER>
		<CHECKUUID>XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX</CHECKUUID>
		<CURRENCY>EUR</CURRENCY>
		<ITEMS>
			<ITEM>
				<CODE>001</CODE>
				<DESCRIPTION>Test product 1</DESCRIPTION>
				<ORDERQUANTITY>1</ORDERQUANTITY>
				<PRICEINCL>9.95</PRICEINCL>
				<BTW>21</BTW>
			</ITEM>
			<ITEM>
				<CODE>002</CODE>
				<DESCRIPTION>Korting</DESCRIPTION>
				<ORDERQUANTITY>1</ORDERQUANTITY>
				<PRICEINCL>-0.95</PRICEINCL>
				<BTW>21</BTW>
			</ITEM>
		</ITEMS>
	</API>

Voorbeeld Order API zakelijke order:
POST: https://test.billink.nl/api/order of https://client.billink.nl/api/order
	<API>
		<VERSION>BILLINK2.0</VERSION>
		<CLIENTUSERNAME>usertest</CLIENTUSERNAME>
		<CLIENTID>d38a3439590889df026367bf01d621e687b8d278</CLIENTID>
		<ACTION>order</ACTION>
		<TYPE>b</TYPE>
		<WORKFLOWNUMBER>1</WORKFLOWNUMBER>
		<ORDERNUMBER>123456</ORDERNUMBER>
		<DATE>DD-MM-YYYY</DATE>
		<FIRSTNAME>Test</FIRSTNAME>
		<LASTNAME>Test</LASTNAME>
		<INITIALS>T</INITIALS>
		<STREET>Wilhelminakade</STREET>
		<HOUSENUMBER>159</HOUSENUMBER>
		<HOUSEEXTENSION>A</HOUSEEXTENSION>
		<POSTALCODE>3072AP</POSTALCODE>
		<CITY>Rotterdam</CITY>
		<COUNTRYCODE>NL</COUNTRYCODE>
		<PHONENUMBER>0104141473</PHONENUMBER>
		<COMPANYNAME>Billink B.V.</COMPANYNAME>
		<CHAMBEROFCOMMERCE>12345678</CHAMBEROFCOMMERCE>
		<EMAIL>[email protected]</EMAIL>
		<EMAIL2>[email protected]</EMAIL2>
		<IP>172.2.168.1</IP>
		<DELIVERYSTEET>Wilhelminakade</DELIVERYSTEET>
		<DELIVERYHOUSENUMBER>159</DELIVERYHOUSENUMBER>
		<DELIVERYHOUSEEXTENSION>B</DELIVERYHOUSEEXTENSION>
		<DELIVERYPOSTALCODE>3072AP</DELIVERYPOSTALCODE>
		<DELIVERYCITY>Rotterdam</DELIVERYCITY>
		<DELIVERYCOUNTRYCODE>NL</DELIVERYCOUNTRYCODE>
		<ADITIONALTEXT>Toegevoegde tekst 1</ADITIONALTEXT>
		<TRACKANDTRACE>JVL1123457488</TRACKANDTRACE>
		<VATNUMBER>NL1234578B01</VATNUMBER>
		<CHECKUUID>XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX</CHECKUUID>
		<CURRENCY>EUR</CURRENCY>
		<ITEMS>
			<ITEM>
				<CODE>001</CODE>
				<DESCRIPTION>Test product 1</DESCRIPTION>
				<ORDERQUANTITY>1</ORDERQUANTITY>
				<PRICEEXCL>8.2231</PRICEEXCL>
				<BTW>21</BTW>
			</ITEM>
			<ITEM>
				<CODE>002</CODE>
				<DESCRIPTION>Korting</DESCRIPTION>
				<ORDERQUANTITY>1</ORDERQUANTITY>
				<PRICEEXCL>-0.7851</PRICEEXCL>
				<BTW>21</BTW>
			</ITEM>
		</ITEMS>
	</API>

Voor zakelijke orders kan worden ingesteld dat we prijs inclusief btw accepteren op de API. Neem hiervoor contact op met onze klantenservice via [email protected] of via 010 - 414 14 73

Voorbeeld response goedkeuring:
	<API>
		<RESULT>MSG</RESULT>
		<MSG>
			<CODE>200</CODE>
			<DESCRIPTION>Order successfully added</DESCRIPTION>
		</MSG>
	</API>

Voorbeeld response foutcode:
	<API>
		<RESULT>MSG</RESULT>
		<MSG>
			<CODE>447</CODE>
			<DESCRIPTION>Missing check request uuid</DESCRIPTION>
		</MSG>
	</API>

Het kan voorkomen dat een order wordt afgewezen. In de meeste gevallen wordt dit veroorzaakt door ons fraude filter. In deze situatie moet een consument alsnog worden afgewezen. Daarnaast kan het voorkomen dat gegevens incompleet zijn. Wij geven dan een foutcode terug die hier gevonden kan worden.

Credit API

Met de Credit API kan er een product of bedrag worden gecrediteerd op de factuur. Deze API is optioneel.

Voor de Credit API hebben we de volgende waardes nodig:
VERSION In alle gevallen is dit "BILLINK2.0"
CLIENTUSERNAME Jouw Billink gebruikersnaam
CLIENTID Jouw unieke API-sleutel
ACTION In alle gevallen is dit "Credit"
INVOICENUMBER Factuurnummer welke is gebruikt bij het inschieten
CREDITAMOUNT Bedrag wat gecrediteerd moet worden inclusief BTW
DESCRIPTION Toelichting bij de credit
Voorbeeld Credit API:
POST: https://test.billink.nl/api/credit of https://client.billink.nl/api/credit
	<API>
		<VERSION>BILLINK2.0</VERSION>
		<CLIENTUSERNAME>usertest</CLIENTUSERNAME>
		<CLIENTID>d38a3439590889df026367bf01d621e687b8d278</CLIENTID>
		<ACTION>credit</ACTION>
		<INVOICES>
			<ITEM>
				<INVOICENUMBER>123456</INVOICENUMBER>
				<CREDITAMOUNT>10.95</CREDITAMOUNT>
				<DESCRIPTION>Test credit</DESCRIPTION>
			</ITEM>
		</INVOICES>
	</API>

Voorbeeld response bij succesvolle credit:
	<API>
		<RESULT>MSG</RESULT>
		<MSG>
			<STATUSES>
				<ITEM>
					<INVOICENUMBER>123456</INVOICENUMBER>
					<MESSAGE>Credit applied: 10.95 EURO.; Order paid.</MESSAGE>
					<CODE>200</CODE>
				</ITEM>
			</STATUSES>
		</MSG>
	</API>

Het kan voorkomen dat er een fout optreed tijdens de creditering. Lees meer over foutcodes en hoe je ze kunt oplossen.

Start Workflow API

Met de start workflow API kunnen orders worden gestart zodra deze zijn uitgeleverd. Standaard wordt er een automatische startvertraging van 3 dagen ingesteld. Wanneer je gebruik wil maken van deze API adviseren we je contact op te nemen met onze klantenservice om de automatische startvertraging uit te schakelen. Deze API is optioneel.

Voor de Start Workflow API hebben we de volgende waardes nodig:
VERSION In alle gevallen is dit "BILLINK2.0"
CLIENTUSERNAME Jouw Billink gebruikersnaam
CLIENTID Jouw unieke API-sleutel
ACTION In alle gevallen is dit "activate order"
INVOICENUMBER Factuurnummer welke is gebruikt bij het inschieten
WORKFLOWNUMBER Workflownummer waarop de order is ingeschoten, deze is optioneel
TRACKANDTRACE Track and trace code wanneer beschikbaar
Voorbeeld Start Workflow API:
POST: https://test.billink.nl/api/start-workflow of https://client.billink.nl/api/start-workflow
	<API>
		<VERSION>BILLINK2.0</VERSION>
		<CLIENTUSERNAME>usertest</CLIENTUSERNAME>
		<CLIENTID>d38a3439590889df026367bf01d621e687b8d278</CLIENTID>
		<ACTION>activate order</ACTION>
		<INVOICES>
			<ITEM>
				<INVOICENUMBER>123456</INVOICENUMBER>
				<WORKFLOWNUMBER>1</WORKFLOWNUMBER>
				<TRACKANDTRACE>3SHEM123456789</TRACKANDTRACE>
			</ITEM>
		</INVOICES>
	</API>

Voorbeeld response:
	<API>
		<RESULT>MSG</RESULT>
		<MSG>
			<CODE>500</CODE>
			<STATUSES>
				<ITEM>
					<INVOICENUMBER>123456</INVOICENUMBER>
					<MESSAGE>Success</MESSAGE>
					<CODE>500</CODE>
				</ITEM>
			</STATUSES>
		</MSG>
	</API>

Let op! Deze API kan worden gebruikt 1 minuut na het inschieten van de order.
Lees meer over foutcodes en hoe je ze kunt oplossen.

On Hold API

Met de On Hold API kunnen facturen twee weken in de wacht gezet worden. Deze API is optioneel.

Voor de On Hold API hebben we de volgende waardes nodig:
VERSION In alle gevallen is dit "BILLINK2.0"
CLIENTUSERNAME Jouw Billink gebruikersnaam
CLIENTID Jouw unieke API-sleutel
ACTION In alle gevallen is dit "on-hold"
INVOICENUMBER Factuurnummer welke is gebruikt bij het inschieten
WORKFLOWNUMBER Workflownummer waarop de order is ingeschoten
DAYS Aantal dagen dat de factuur in de wacht gezet moet worden (max 14)
Voorbeeld On Hold API:
POST: https://test.billink.nl/api/on-hold of https://client.billink.nl/api/on-hold
	<API>
		<VERSION>BILLINK2.0</VERSION>
		<CLIENTUSERNAME>usertest</CLIENTUSERNAME>
		<CLIENTID>d38a3439590889df026367bf01d621e687b8d278</CLIENTID>
		<ACTION>on-hold</ACTION>
		<INVOICENUMBER>123456</INVOICENUMBER>
		<WORKFLOWNUMBER>1</WORKFLOWNUMBER>
		<DAYS>14</DAYS>
	</API>

Voorbeeld response:
	<API>
		<RESULT>MSG</RESULT>
		<MSG>
			<CODE>500</CODE>
			<DESCRIPTION>Order successfully set on hold till 2021-05-05</DESCRIPTION>
		</MSG>
	</API>

Lees meer over foutcodes en hoe je ze kunt oplossen.

Payment API

Met de Payment API kan een betaling worden ingeboekt op de factuur. Deze API kan handig zijn als consumenten regelmatig bedragen naar de webshop overmaken. Deze API is optioneel.

Voor de Payment API hebben we de volgende waardes nodig:
VERSION In alle gevallen is dit "BILLINK2.0"
CLIENTUSERNAME Jouw Billink gebruikersnaam
CLIENTID Jouw unieke API-sleutel
ACTION In alle gevallen is dit "payment"
INVOICENUMBER Factuurnummer welke is gebruikt bij het inschieten
AMOUNT Het bedrag welke ingeboekt moet worden
DESCRIPTION Omschrijving bij de betaling
Voorbeeld Payment API:
POST: https://test.billink.nl/api/payment of https://client.billink.nl/api/payment
	<API>
		<VERSION>BILLINK2.0</VERSION>
		<CLIENTUSERNAME>usertest</CLIENTUSERNAME>
		<CLIENTID>d38a3439590889df026367bf01d621e687b8d278</CLIENTID>
		<ACTION>payment</ACTION>
		<INVOICENUMBER>123456</INVOICENUMBER>
		<AMOUNT>10.95</AMOUNT>
		<DESCRIPTION>Betaling van de klant naar ons</DESCRIPTION>
	</API>

Voorbeeld response:

	<API>
		<RESULT>MSG</RESULT>
		<MSG>
			<INVOICES>
				<ITEM>
					<INVOICENUMBER>123456</INVOICENUMBER>
					<MESSAGE>Success</MESSAGE>
					<CODE>500</CODE>
				</ITEM>
			</INVOICES>
		</MSG>
	</API>

Lees meer over foutcodes en hoe je ze kunt oplossen.

Status API

Met de Status API kan worden opgevraagd of een order betaald is of niet. Deze API is optioneel.

Voor de Status API hebben we de volgende waardes nodig:
VERSION In alle gevallen is dit "BILLINK2.0"
CLIENTUSERNAME Jouw Billink gebruikersnaam
CLIENTID Jouw unieke API-sleutel
ACTION In alle gevallen is dit "status"
INVOICENUMBER Factuurnummer welke is gebruikt bij het inschieten
WORKFLOWNUMBER Workflownummer waarop de order is ingeschoten
Voorbeeld Status API:
POST: https://test.billink.nl/api/status of https://client.billink.nl/api/status
	<API>
		<VERSION>BILLINK2.0</VERSION>
		<CLIENTUSERNAME>usertest</CLIENTUSERNAME>
		<CLIENTID>d38a3439590889df026367bf01d621e687b8d278</CLIENTID>
		<ACTION>status</ACTION>
		<INVOICENUMBER>123456</INVOICENUMBER>
		<WORKFLOWNUMBER>1</WORKFLOWNUMBER>
	</API>

Voorbeeld response:
	<API>
		<RESULT>MSG</RESULT>
		<MSG>
			<CODE>200</CODE>
			<INVOICES>
				<INVOICE>
					<INVOICENUMBER>123456</INVOICENUMBER>
					<STATUS>1</STATUS>
					<DESCRIPTION>FACTUUR</DESCRIPTION>
				</INVOICE>
			</INVOICES>
		</MSG>
	</API>

Uitleg verschillende codes:
-1 Factuur niet gevonden
0 Nog niet betaald
1 Betaald

Message API

Met de Message API kunnen er berichten worden geplaatst op een order. Deze berichten zijn terug te vinden in de backend van Billink door onze klantenservice. Deze API is optioneel.

Voor de Message API hebben we de volgende waardes nodig:
VERSION In alle gevallen is dit "BILLINK2.0"
CLIENTUSERNAME Jouw Billink gebruikersnaam
CLIENTID Jouw unieke API-sleutel
ACTION In alle gevallen is dit "message"
WORKFLOWNUMBER Workflownummer waarop de order is ingeschoten
INVOICENUMBER Factuurnummer welke is gebruikt bij het inschieten
MESSAGE Het bericht wat moet worden toegevoegd
Voorbeeld Message API:
POST: https://test.billink.nl/api/message of https://client.billink.nl/api/message
	<API>
		<VERSION>BILLINK2.0</VERSION>
		<CLIENTUSERNAME>usertest</CLIENTUSERNAME>
		<CLIENTID>d38a3439590889df026367bf01d621e687b8d278</CLIENTID>
		<ACTION>message</ACTION>
		<WORKFLOWNUMBER>1</WORKFLOWNUMBER>
		<INVOICENUMBER>123456</INVOICENUMBER>
		<MESSAGE>Bericht voor administratie</MESSAGE>
	</API>

Voorbeeld response:
	<API>
		<RESULT>SUCCESS</RESULT>
		<MSG>
			<CODE>500</CODE>
			<DESCRIPTION>Bericht toegevoegd</DESCRIPTION>
		</MSG>
	</API>

FAQ

Foutcodes

Per API leggen we de verschillende foutcodes uit en hoe je deze kunt oplossen.

Check API:
001 Versie klopt niet, gebruik "BILLINK2.0.
101 De gebruikersnaam of het UID is onjuist.
102 De gebruikersnaam of het UID is onjuist.
103 De actie is onbekend.
104 Workflownummer ontbreekt.
105 Worfklownummer klopt niet.
402 Onjuist telefoonnummer.
406 Geen type ingevuld.
407 Onjuist type.
408 Bedrijfsnaam ontbreekt.
410 Achternaam ontbreekt.
411 KVK nummer ontbreekt.
412 Voornaam ontbreekt.
414 Huisnummer ontbreekt.
415 Postcode ontbreekt.
416 Verkeerde postcode formaat.
417 Telefoonnummer ontbreekt.
418 Verkeerde opmaak geboortedatum.
419 Emailadres ontbreekt.
420 Verkeerde opmaak emailadres.
421 Geboortedatum ontbreekt.
422 Minimale leeftijd voor bestellingen via Billink is 16 jaar.
424 Verkeerde huisnummer opmaak.
425 Afleveradres: verkeerde huisnummer opmaak.
426 Afleveradres niet toegestaan.
427 Orderbedrag ontbreekt.
428 Orderbedrag te hoog.
429 Orderbedrag is groter dan toegestaan.
430 Bedrijfsnaam moet tussen de 2 en 50 karakters lang zijn.
431 Huisnummer extentie moet tussen de 0 en 10 karakters lang zijn.
435 Fraude risico te hoog.
500 Consument is goedgekeurd.
501 Consument is afgewezen.
601 Controleer opbouw XML.
603 Controleer opbouw XML.
607 De gebruikersnaam of het UID is onjuist.


Order API:
001 Versie klopt niet, gebruik "BILLINK2.0".
101 De gebruikersnaam of het UID is onjuist.
102 De gebruikersnaam of het UID is onjuist.
103 De actie is onbekend.
401 Workflownummer ontbreekt.
402 Worfklownummer klopt niet.
403 Factuurnummer bestaat al.
405 Datum ontbreekt.
406 Geen type ingevuld.
407 Onjuist type.
408 Bedrijfsnaam ontbreekt.
409 Voornaam ontbreekt.
410 Achternaam ontbreekt.
411 Geslacht ontbreekt.
412 Verkeerde opmaak geslacht.
413 Straat ontbreekt.
414 Huisnummer ontbreekt.
415 Postcode ontbreekt.
416 Stad ontbreekt.
417 Telefoonnummer ontbreekt.
418 Emailadres ontbreekt.
419 Woonplaats mag alleen letters, spaties en ' tekens bevatten.
420 Onjuiste landcode, gebruik ISO 3166.
421 Geboortedatum ontbreekt.
422 Verkeerde opmaak IP adres.
427 KVK nummer ontbreekt.
428 Artikelcode is te lang.
429 Verkeerde opmaak KvKnummer. Moet tussen de 5 en 25 karakters zijn.
430 Verkeerde opmaak BTW nummer.
431 Verkeerde opmaak BTW nummer.
432 Verkeerde opmaak emailadres.
433 Verkeerde opmaak tweede emailadres.
434 Factuurnummer voldoet niet aan de vereisten (alfanumeriek, _ en - zijn toegestaan).
440 CHECK-UUID klopt niet, voer een nieuwe Check API uit.
444 Orderbedrag is hoger dan aangevraagd in de Check API.
445 CHECK-UUID is verlopen, voer een nieuwe Check API uit.
446 CHECK-UUID is al gebruikt, voer een nieuwe Check API uit.
447 CHECK-UUID ontbreekt.
448 Bedrijfsnaam moet tussen de 2 en 50 karakters lang zijn.
449 Telefoonnummer mag alleen nummers bevatten.
450 Huisnummer extentie moet tussen de 0 en 10 karakters lang zijn.
451 Workflow without guarantee is used for check request.
452 Bedrag is hoger dan afgesproken.
501 Order is geweigerd op basis van fraude.
601 Controleer opbouw XML.
603 Controleer opbouw XML.
607 De gebruikersnaam of het UID is onjuist.


Credit API:
001 Versie klopt niet, gebruik "BILLINK2.0".
101 De gebruikersnaam of het UID is onjuist.
102 De gebruikersnaam of het UID is onjuist.
103 De actie is onbekend.
402 Worfklownummer klopt niet.
403 Factuurnummer bestaat al.
601 Controleer opbouw XML.
603 Controleer opbouw XML.
607 De gebruikersnaam of het UID is onjuist.
705 Factuur ontbreekt.
706 Factuur niet gevonden.
707 Credit kan niet worden uitgevoerd in deze fase.
708 Credit kan niet worden uitgevoerd. Probeer het later opnieuw.


Start Workflow API:
001 Versie klopt niet, gebruik "BILLINK2.0".
101 De gebruikersnaam of het UID is onjuist.
102 De gebruikersnaam of het UID is onjuist.
103 De actie is onbekend.
603 Controleer opbouw XML.
607 De gebruikersnaam of het UID is onjuist.
705 Factuur ontbreekt.
706 Factuur niet gevonden.
707 Credit kan niet worden uitgevoerd in deze fase.
708 Credit kan niet worden uitgevoerd. Probeer het later opnieuw.


On Hold API:
001 Versie klopt niet, gebruik "BILLINK2.0".
101 De gebruikersnaam of het UID is onjuist.
102 De gebruikersnaam of het UID is onjuist.
103 De actie is onbekend.
401 Factuurnummer ontbreekt.
402 Factuurnummer onjuist.
403 Periode is te lang. Maximaal 14 dagen.
603 Controleer opbouw XML.
607 De gebruikersnaam of het UID is onjuist.
701 Bestelling kan niet in de wacht worden geplaatst.


Payment API:
001 Versie klopt niet, gebruik "BILLINK2.0".
101 De gebruikersnaam of het UID is onjuist.
102 De gebruikersnaam of het UID is onjuist.
103 De actie is onbekend.
402 Workflownummer is onbekend.
420 Factuurnummer ontbreekt.
603 Controleer opbouw XML.
607 De gebruikersnaam of het UID is onjuist.
701 Bestelling kan niet in de wacht worden geplaatst.
704 Factuurnummer onbekend.
706 Op deze factuur kan geen betaling worden ingeboekt.
707 Bestelling is al betaald.
708 Omschrijving is te lang. Maximaal 30 karakters.

Contact

Wij kijken uit naar een succesvolle samenwerking. Mocht je toch niet helemaal uit de integratie komen helpen we je graag. Dit kan op werkdagen van 08:30 uur tot 17:00 uur via [email protected] of via 010 - 414 14 73