Je website stuurt een aanvraag als JSON met een POST naar de API URL van de Website-integratie. Verplicht zijn de websiteCode en het klanttype; een afgekeurde aanvraag gaat niet verloren maar komt onder Aandacht nodig.
Voor wie: beheerders
Dit artikel is voor je websitebouwer. Hoe je de koppeling in Bas aanzet, staat in Aanvragen van je website in Bas ontvangen.
Stuur bij elke inzending een POST met Content-Type: application/json naar de API URL die bij de koppeling staat. In die URL zitten je Omgeving ID en Integratie ID al. Er is geen sleutel of extra header: de URL en de websiteCode samen geven toegang. Verstuur daarom vanaf je server, niet vanuit de browser van de bezoeker.
| Veld | Verplicht | Wat |
|---|---|---|
websiteCode |
ja | De Unieke code van de website in Bas |
customer |
ja | De klant, zie hieronder |
addresses |
nee | Nul, één of meer adressen, zie hieronder |
preferredMovingDate |
nee | Gewenste verhuisdatum, jjjj-mm-dd |
notes |
nee | Komt in het dossier bij de notities onder Algemeen |
customerNotes |
nee | Komt in het dossier bij de notities onder Voor de klant |
De websiteCode moet precies gelijk zijn aan een Unieke code bij de koppeling. De datum moet als 2026-09-15 binnenkomen; '15 september' keurt Bas af.
| Veld | Verplicht | Wat |
|---|---|---|
relationType |
ja | private of business |
lastName |
bij private |
Achternaam |
companyName |
bij business |
Bedrijfsnaam |
firstName, middleName |
nee | Voornaam en tussenvoegsel |
salutation |
nee | Aanhef, zie de lijst hieronder |
gender |
nee | male, female of leeg |
emailAddress |
nee | Een geldig e-mailadres |
phoneNumber, mobileNumber |
nee | Een geldig telefoonnummer |
region |
nee | Landcode voor het telefoonnummer, zoals NL of BE |
vatNumber |
nee | Btw-nummer |
howDidYouFindUs |
nee | Hoe de klant je vond. Leeg: Bas zet de Naam van de website |
Bij een particuliere klant is de achternaam verplicht, bij een zakelijke klant de bedrijfsnaam. Een telefoonnummer stuur je internationaal, zoals +31612345678, of je stuurt region mee zodat Bas 0612345678 kan lezen.
Toegestane waarden voor salutation: leeg, heer, mevrouw, de heer en mevrouw, familie, Dhr., Mevr., Fam., Mr, Ms en family. Stuur ze precies zo, met hoofdletters en punten.
| Veld | Verplicht | Wat |
|---|---|---|
addressType |
ja | from (laadadres) of to (losadres) |
streetName, houseNumber |
ja | Straat en huisnummer, apart |
zipCode, city |
ja | Postcode en plaats |
country |
ja | Landcode, zoals NL of BE |
primary |
nee | true voor het hoofdadres van dat type. Leeg is false |
houseNumberAddition |
nee | Toevoeging |
buildingType |
nee | Type woning, zie de lijst hieronder |
floor, hasElevator, notes |
nee | Verdieping, lift, opmerking bij het adres |
Stuur je een adres mee, dan moeten alle verplichte velden gevuld zijn. Is een adres nog onbekend, laat het hele adres dan weg. Een half adres keurt Bas af, en daarmee de hele aanvraag. Zet primary op true bij het laadadres en bij het losadres: alleen een hoofdadres gebruikt Bas verderop als laad- of losadres van het dossier.
Toegestane waarden voor buildingType: apartment, studio, house, bungalow, office, storage, drive-in, double-apartment, villa, farm, two-under-one-roof, mansion, upstairs-apartment, detached-house, terraced-house, corner-house, school, nursing-home, assisted-living-center, senior-housing, commercial-building, dike-house, school-building, houseboat, garage of leeg. Toont je formulier Nederlandse namen, vertaal ze dan voor het versturen.
| Antwoord | Betekenis |
|---|---|
| 202 | Gelukt. Het dossier staat in Bas |
| 200 met fouten in de JSON | Een veld klopt niet. De aanvraag staat onder Aandacht nodig |
| 404 | De URL of de websiteCode klopt niet. Bas heeft niets bewaard |
| 503 | Bas kon niets bewaren. Stuur de aanvraag later opnieuw |
Controleer op 202 voor succes: ook een afgekeurde aanvraag krijgt een 200 terug. Bas bewaart die aanvraag onder Aandacht nodig en maakt de taak 'Een nieuwe lead "[naam]" kon niet worden verwerkt'. Bij een 404 bewaart Bas niets en komt er geen taak.
{
"websiteCode": "mijnbedrijf-website",
"customer": {
"relationType": "private",
"salutation": "heer",
"firstName": "Jan",
"lastName": "Jansen",
"emailAddress": "[email protected]",
"phoneNumber": "+31612345678"
},
"preferredMovingDate": "2026-11-14",
"notes": "Gewenste verhuisdatum: 14 november",
"addresses": [
{
"addressType": "from",
"primary": true,
"streetName": "Dorpsstraat",
"houseNumber": "1",
"zipCode": "1234AB",
"city": "Middelburg",
"country": "NL",
"buildingType": "terraced-house"
}
]
}