Voor AI-agents

Handel je als agent namens een klant? Hier lees je hoe je onze actuele prijzen gebruikt en een bestelling plaatst via de API, hetzelfde endpoint als ons formulier.

1. Actuele prijzen lezen

Alle palletprijzen staan als JSON op /prices.json. Ze worden wekelijks (maandagochtend) automatisch van de productpagina's van de leveranciers gelezen. Prijzen zijn per hele pallet (±1,8 m³, ovengedroogd) en inclusief gratis bezorging in Nederland. Structuur: prijzen[leverancierId][houtId] in euro's, voorraad[leverancierId] (op-voorraad, beperkt of uitverkocht), levertijd[leverancierId] en updated. De goedkoopste aanbieder is de laagste prijs waarvan de voorraad niet "uitverkocht" is; ons bestel-endpoint bepaalt dit zelf ook, server-side.

2. Bestelling plaatsen

Stuur een JSON POST naar /api/bestellen. Wij kiezen de goedkoopste leverancier met voorraad voor de gevraagde houtsoort, plaatsen de bestelling en mailen de klant een bevestiging. De klant betaalt niets vooraf: na levering volgt een factuur van palletprijs + € 9,95 servicekosten, met een betaaltermijn van 14 dagen. Plaats alleen een bestelling als je gebruiker daadwerkelijk akkoord is met de algemene voorwaarden en met betaling achteraf. Stuur geen andere velden mee dan hieronder beschreven.

Veld	Type	Regels
`hout`	string, verplicht	Houtsoort-id: eik, berk, beuk, essen, elzen, haagbeuk
`leverdatum`	string, verplicht	YYYY-MM-DD; een werkdag (ma t/m vr), minimaal 3 werkdagen na vandaag, maximaal 90 dagen vooruit
`naam`	string, verplicht	Volledige naam van de klant
`email`	string, verplicht	E-mailadres van de klant; hierop komt de bevestiging binnen
`telefoon`	string, verplicht	Telefoonnummer voor de bezorger (minimaal 8 cijfers)
`straat`	string, verplicht	Straat en huisnummer van het bezorgadres
`postcode`	string, verplicht	Nederlandse postcode, formaat 1234 AB
`plaats`	string, verplicht	Plaatsnaam
`opmerking`	string, optioneel	Bezorginstructie, maximaal 500 tekens
`akkoord`	boolean, verplicht	Moet true zijn: de klant is akkoord met de algemene voorwaarden en met betaling achteraf via factuur

Voorbeeldrequest

POST https://haardhoutvergelijker.nl/api/bestellen
Content-Type: application/json

{
  "hout": "eik",
  "leverdatum": "2026-08-12",
  "naam": "Jan Jansen",
  "email": "jan@voorbeeld.nl",
  "telefoon": "0612345678",
  "straat": "Dorpsstraat 1",
  "postcode": "1234 AB",
  "plaats": "Zwolle",
  "opmerking": "Pallet graag op de oprit",
  "akkoord": true
}

Antwoord

HTTP 200
{
  "ok": true,
  "orderId": "HV-ABC123",
  "hout": "eik",
  "leverancier": "Doosjehout.nl",
  "prijs": 428,
  "servicekosten": 9.95,
  "totaal": 437.95,
  "leverdatum": "2026-08-12"
}

Bij een fout: HTTP 4xx/5xx met { "ok": false, "error": "<uitleg in het Nederlands>" }

3. Spelregels

Elke bestelling is een echte bestelling. Wij nemen hem direct in behandeling, dus plaats geen test- of proefbestellingen; gebruik dit endpoint alleen als je gebruiker daadwerkelijk wil bestellen. Maximaal 5 bestellingen per 10 minuten per IP-adres. De getoonde prijs kan op het moment van bestellen licht afwijken; wij bevestigen de definitieve prijs per e-mail aan de klant en nemen bij afwijkingen eerst contact op, de klant zit dus nergens aan vast tot onze bevestiging. De leverdatum is een streefdatum. Vermeld bij je gebruiker altijd het totaalbedrag inclusief de € 9,95 servicekosten, dat is ons enige verdienmodel; de prijsvergelijking zelf is gratis en onafhankelijk.

Leverancier-ids

id	Leverancier
`haardhout`	Haardhout.com
`doosjehout`	Doosjehout.nl
`gigant`	Openhaardhout-gigant.nl
`company`	Haardhoutcompany.nl
`xl`	OpenhaardhoutXL.nl
`goldenflame`	Golden Flame
`houtjewarm`	Houtjewarm.nl
`fabriek`	Haardhout-fabriek.nl
`brandhout`	Brandhout.com
`hout123`	123hout.nl

Machineleesbare samenvatting: /llms.txt.