Live demo

Accommodatie-API

Een Accommodatie-API voor hotels, appartementen en vakantiehuizen

Een accommodatie-API brengt elk type verblijf naar uw boekingssite: hotelkamers, serviced appartementen, vakantiewoningen, hostels en pensions. Deze pagina legt de data achter een verblijf uit, de regels die vakantiehuizen anders maken dan hotels, en hoe PHPTRAVELS uw eigen objecten en leveranciersaanbod in één zoekopdracht verkoopt.

  • Object, eenheid, tarief, kalender
  • Minimumverblijf en kosten
  • Annuleringsperiodes
  • Eigen aanbod plus API-aanbod

Het datamodel

Vier lagen in elk verblijf

Of het nu een hotel met 300 kamers is of één strandhuis: een accommodatie-API beschrijft het in dezelfde vier geneste lagen. Elke laag beantwoordt een andere vraag die gasten voor het boeken stellen.

01Object

De plek zelf: naam, type, adres en kaartpositie, foto's, voorzieningen, sterren of kwaliteitsclassificatie, huisregels en inchecktijden.

property_id · type · address · geo · photos · amenities · check_in_from

02Kamer of eenheid

Wat daadwerkelijk wordt geboekt: een kamertype, een heel appartement of een bed in een slaapzaal, met oppervlakte, bedden en maximale bezetting.

unit_id · beds · size_m2 · max_adults · max_children

03Tariefplan

Hoe die eenheid wordt verkocht: de maaltijdoptie, het annuleringsbeleid, de betaalvoorwaarden en wie mag boeken, zoals publiek of alleen agenten.

rate_plan_id · board · cancel_policy · payment · channel

04Beschikbaarheid

Eén rij per nacht: de prijs, resterende eenheden, minimumverblijf en of aankomst of vertrek die dag is toegestaan.

date · price · units_left · min_stay · closed_to_arrival

Een gebouw, een kamer, een prijskaartje en een kalender als aparte, gestapelde lagen van één accommodatievermelding

PHPTRAVELS noemt zijn accommodatiemodule Stays, omdat hetzelfde model veel meer dekt dan hotels. Een object bevat eenheden, een eenheid wordt verkocht via een of meer tariefplannen en elk tariefplan heeft een kalender met prijs en beschikbaarheid per nacht. Als deze vier lagen kloppen, passen een hostelbed, een hotelsuite en een villa met drie slaapkamers in dezelfde zoekopdracht en afrekening.

Leveranciers geven de lagen verschillende namen en sommigen voegen er twee samen, maar de structuur is er altijd. De Verblijven koppelt elke bron eraan, zodat de gast één consistente pagina ziet.

Nacht voor nacht

In de beschikbaarheidskalender wordt een verblijf gewonnen of verloren

Elke accommodatie-API eindigt in een kalender. De zoekopdracht geeft een object alleen terug als elke nacht van het gevraagde verblijf vrij is, een prijs heeft en volgens de verblijfsregels is toegestaan.

Appartement met twee slaapkamers · StandaardtariefNovember 2026 · Prijs per nacht
  1. 26
  2. 27
  3. 28
  4. 29
  5. 30
  6. 31
  7. 1120
  8. 2120
  9. 3
  10. 4
  11. 5
  12. 6165
  13. 7140
  14. 8120
  15. 9
  16. 10
  17. 11
  18. 123+165
  19. 13165
  20. 14140
  21. 15120
  22. 16120
  23. 17120
  24. 18
  25. 19
  26. 20165
  27. 21140
  28. 22120
  29. 23120
  30. 24120
  31. 25120
  32. 263+165
  33. 27165
  34. 28140
  35. 29120
  36. 30120
  37. 1
  38. 2
  39. 3
  40. 4
  41. 5
  42. 6
  • Vrij, prijs per nacht
  • Al geboekt
  • Gesloten door de eigenaar
  • Minimumverblijf vanaf deze aankomst
  • Gesloten voor aankomst

Illustratieve data, vereenvoudigd

  • Prijzen gelden per nachtHet totaal van het verblijf is de som van elke nacht, dus een vrijdag en zaterdag tegen weekendtarief kosten meer dan twee doordeweekse dagen. Dag- en seizoensprijzen staan in de kalender, niet bij het object.
  • Regels voor minimumverblijfEen minimum van drie nachten bij aankomst op vrijdag verbergt de eenheid bij een zoekopdracht voor twee nachten. Vakantiehuizen gebruiken deze regels veel vaker dan hotels, vaak strenger in het weekend en in het hoogseizoen.
  • Gesloten voor aankomst of vertrekEen nacht kan boekbaar zijn als onderdeel van een langer verblijf, maar niet als eerste of laatste nacht. Wisseldagen bij vakantiehuizen werken zo.
  • Gesloten nachten en stop-sellEigenaren blokkeren data voor eigen gebruik of onderhoud en een stop-sell haalt een eenheid direct uit de verkoop. Elke gesloten nacht binnen de gevraagde data haalt de eenheid uit de resultaten.

Niet elk verblijf is een hotel

Hotels, appartementen en vakantiehuizen vergeleken

Het datamodel is gedeeld, maar elk type verblijf vult het anders in. Dit zijn de verschillen die uw boekingsflow moet afhandelen als u meer verkoopt dan hotelkamers.

Hotels

Inclusief hostels en pensions

Wat wordt geboekt
Een kamertype met veel identieke kamers, of een bed in een gedeelde slaapzaal.
Prijsstelling
Een nachttarief per kamer en maaltijdoptie; extra volwassenen of kinderen kunnen het wijzigen.
Verblijfsregels
Minimumverblijf alleen op piekdata; de meeste nachten kunnen los worden geboekt.
Kosten en borg
Stads- of toeristenbelasting, soms resortkosten ter plaatse.
Aankomst
Een 24-uurs of bemande receptie; inchecktijden op de voucher volstaan.
Typische bron
Bedbanks en groothandels, rechtstreekse contracten, channelmanagers.

Serviced appartementen

Aparthotels en stadsappartementen

Wat wordt geboekt
Een eenheidstype, vaak met keuken en aparte slaapkamers.
Prijsstelling
Een nachttarief per eenheid, met week- of maandprijzen voor lange verblijven.
Verblijfsregels
Minimumverblijven komen vaak voor en lange verblijven zijn een groot deel van de vraag.
Kosten en borg
Schoonmaakkosten per verblijf en een terugbetaalbare borg zijn gebruikelijk.
Aankomst
Receptietijden wisselen; late aankomst vraagt om een sleutelkluis of code.
Typische bron
Channelmanagers, rechtstreekse contracten en enkele groothandels.

Vakantiehuizen

Vakantiewoningen, villa's en cabins

Wat wordt geboekt
Eén specifiek huis. Meestal is er maar één van.
Prijsstelling
Een nachttarief voor het hele huis, plus een toeslag per extra gast boven een basisaantal.
Verblijfsregels
Minimumverblijven, vaste wisseldagen en data gesloten voor aankomst zijn de norm.
Kosten en borg
Schoonmaakkosten, terugbetaalbare borg voor schade en lokale belastingen, elk getoond voor de betaling.
Aankomst
Incheckinstructies, een adres en een contactpersoon worden voor aankomst verstuurd, nooit op de openbare pagina.
Typische bron
Eigenaren en beheerders, rechtstreeks of via een channelmanager.

Verkoopt u woningen van veel gastheren in plaats van uw eigen contracten? Dat is een marktplaats, behandeld op de pagina BnB-portaal.

Periodes van het annuleringsbeleid

Eén boeking, drie annuleringsperiodes

Een annuleringsbeleid is een tijdlijn die vanaf de aankomstdatum terugtelt. Elke periode bepaalt wat de gast terugkrijgt als hij daarbinnen annuleert.

BoekingCheck-in
  1. 01 · Tot 14 dagen voor aankomstGratis annulerenDe gast annuleert en krijgt het volledige bedrag terug. Dit is de deadline waar reizigers als eerste naar zoeken, toon die dus als datum, niet als regel.
  2. 02 · 14 tot 3 dagen ervoorGedeeltelijke boeteEr geldt een boete, vaak de eerste nacht of een percentage van het verblijf. Vakantiehuizen kunnen in deze periode de borg houden.
  3. 03 · Laatste 3 dagen en no-showNiet restitueerbaarHet volledige bedrag blijft ingehouden. Tariefplannen die als niet-restitueerbaar worden verkocht, vallen vanaf de boeking in deze periode.
Voorbeeldperiodes; elk tariefplan heeft zijn eigen.
  • Per tariefplan, niet per objectHetzelfde appartement kan een flexibel tarief en een goedkoper niet-restitueerbaar tarief hebben, dus het beleid hoort bij de laag van het tariefplan.
  • Data in de tijdzone van het object"14 dagen ervoor" wordt geteld vanaf de aankomstdatum op de plek van het object. Reken het om naar een duidelijke datum en tijd op de pagina en de voucher.
  • Het beleid van de leverancier geldtMet API-aanbod kunt u geen soepelere voorwaarden bieden dan uw leverancier. Met eigen contracten bepaalt u de periodes zelf.

Eigen aanbod en API-aanbod

Uw gecontracteerde objecten en leveranciers-API's in één zoekopdracht

De meeste verkopers van accommodaties doen beide: ze laden de plekken die ze zelf contracteren en voegen leveranciers-API's toe voor de rest. De reiziger mag nooit merken waar een verblijf vandaan komt.

Uw eigen objecten

  • Laad zelf objecten, eenheden en tariefplannen in de admin
  • Geef eigenaren en hotels een extranetlogin om hun kalender te beheren
  • Stel prijzen, minimumverblijven, gesloten data en annuleringsperiodes in
  • Allotments met releasedagen en stop-sell
  • Of ontvang tarieven en beschikbaarheid van een channelmanager

Aanbod van leveranciers-API's

  • Grote catalogi in bestemmingen die u nooit zelf zou kunnen contracteren
  • Live prijzen en beschikbaarheid op het moment van zoeken
  • Maaltijdopties, beleid en kosten van de leverancier bij elk tarief
  • Ingeschakeld met uw eigen leverancierscontract en inloggegevens
  • Boeking en annulering rechtstreeks naar de leverancier

Wat de gast krijgt

  • Eén resultatenlijst met één objectpagina per plek
  • Dezelfde kamer uit meerdere bronnen eenmaal getoond, tegen uw prijs
  • Uw opslagen per leverancier, bestemming of kanaal, en B2B-agenttarieven
  • Eén voucherformaat, welke bron het ook bevestigde

Het koppelen van een channelmanager staat op Channelmanager-integratie. Voor kamers die u onder contract heeft, zie Boekingsvoorraadsysteem.

Klaar in PHPTRAVELS

Reeds gekoppelde Stays-leveranciers

Deze accommodatieleveranciers zijn vandaag gekoppeld aan de Stays-module. U tekent bij de leverancier, voert uw eigen inloggegevens in de admin in, test in hun sandbox en gaat live. De lijst komt live uit onze integratiegids.

Heeft u een leverancier nodig die niet is vermeld, zoals een regionaal verhuurnetwerk? Elke accommodatie-API met documentatie kan worden toegevoegd, zie API-integratie op maat. Voor leverancierstypen en contentmapping leest u de pagina Hotel-API, en de twee grootste bedbankgidsen: RateHawk API-integratie en Hotelbeds API-integratie.

Boek een verblijf zoals uw gasten dat doen

Zoek, vergelijk tarieven en boek in de live demo en vertel ons daarna welke objecten en leveranciers u wilt verkopen.

Probeer de live demoVraag naar uw leveranciers

Bouwt u een eigen app of partnerfeed? De PHPTRAVELS REST API levert elke gekoppelde Stays-bron in één formaat, met webhooks voor boekingsgebeurtenissen. Hij zit in het Enterprise-abonnement, zie Prijzen en de ontwikkelaarsdocumentatie. Het grotere plaatje staat op Reis-API's.

FAQ

Accommodatie-API: vragen van ontwikkelaars en bureaus

Praat met sales

Een accommodatie-API is een set webservices waarmee een boekingssite accommodaties doorzoekt, prijzen en beschikbaarheid voor bepaalde data en gasten leest, en boekingen aanmaakt, opvraagt en annuleert. Ze dekt hotels en elk ander type verblijf: appartementen, vakantiehuizen, hostels en pensions.

De kernaanroepen zijn hetzelfde. Een accommodatie-API moet ook afhandelen wat niet-hotels nodig hebben: boekingen van hele eenheden, minimumverblijven en wisseldagen, toeslagen voor extra gasten, schoonmaakkosten, terugbetaalbare borg en incheckinstructies die voor aankomst worden verstuurd.

Ja. In PHPTRAVELS gebruikt de Stays-module één model van object, eenheid, tariefplan en beschikbaarheid voor elk type accommodatie, zodat hotels, appartementen en vakantiewoningen met hun eigen regels in dezelfde zoekopdracht verschijnen.

Elke nacht in de kalender kan een minimale verblijfsduur hebben, meestal gekoppeld aan de aankomstdatum. Zoekt een gast minder nachten dan het minimum, dan wordt de eenheid niet teruggegeven. Vlaggen voor gesloten voor aankomst en gesloten voor vertrek werken hetzelfde voor wisseldagen.

Ja. U kunt zelf objecten, eenheden, tariefplannen en kalenders toevoegen, eigenaren een extranetlogin geven of tarieven van een channelmanager ontvangen, en ze naast het aanbod van leveranciers in één resultatenlijst verkopen.

Van het tariefplan. Aanbod van leveranciers draagt het beleid van de leverancier en uw eigen objecten gebruiken de periodes die u instelt. De deadline wordt de gast voor de betaling getoond en op de voucher afgedrukt.

Nee. U tekent bij elke accommodatieleverancier en voert uw eigen inloggegevens in de admin in. PHPTRAVELS levert het boekingsplatform, de Stays-module en de kant-en-klare connectoren.

Ja. In het Enterprise-abonnement biedt de PHPTRAVELS REST API zoeken en boeken over elke gekoppelde bron in één formaat, met webhooks voor boekingsgebeurtenissen en de volledige broncode om uit te breiden.

Een PHPTRAVELS-licentie, uw eigen domein en minimaal één bron van aanbod: objecten die u zelf contracteert, een channelmanager of een leverancierscontract met een accommodatiegroothandel. De live demo toont eerst de hele flow.

Verder ontdekken

Meer over het platform