Hoeveel hotel-API-leveranciers heb je nodig? Tel de mapping mee

De hotelzoekfunctie ging vorig kwartaal live op één leverancier, en een tijdlang klaagde niemand. Dan stuurt sales een screenshot door. Een klant was Istanbul aan het plannen, vond een viersterrenhotel op zijn telefoon en vroeg waarom jullie site het helemaal niet toonde. Geen slechtere prijs. Geen vermelding. Het volgende bericht is aan jou gericht: voegen we een extra leverancier toe?
Waarschijnlijk wel. Maar hoeveel hotel-API-leveranciers heb je nodig is geen dekkingsvraag met een dekkingsantwoord. Elke leverancier die je toevoegt verbreedt de inventaris en stuurt je ook hotels die je al hebt, onder een andere naam, een ander ID en net iets andere coördinaten. De tweede integratie is vooral code. Alles daarna is vooral ontdubbelen, en dat is de kostenpost die mensen weglaten als ze leveranciers tellen.
Elke leverancier is twee feeds, niet één
Een hotelleverancier levert je twee heel verschillende dingen, en ze als één behandelen is de oorzaak van de meeste vroege fouten.
Het eerste is statische content: namen van accommodaties, adressen, coördinaten, sterren, foto's, kamerbeschrijvingen, faciliteiten. Die verandert langzaam. Je haalt ze in bulk op, slaat ze op en ververst ze volgens een schema dat je in dagen meet. Het tweede zijn live tarieven: wat is beschikbaar voor deze data, voor deze bezetting, tegen welke prijs, onder welk annuleringsbeleid. Dat verandert tussen de zoekopdracht en de boeking. Je cachet het hooguit minuten, en je controleert het opnieuw bij de prebook, wat de zoekopdracht ook zei.
Dus twee cachelevensduren, twee manieren om te falen. Verouderde statische content toont de verkeerde foto. Een verouderd tarief verkoopt een kamer tegen een prijs die de leverancier niet zal honoreren. Als je een leverancier toevoegt, voeg je beide feeds toe, en in de statische zit het echte werk verborgen, want die moet je afstemmen op alles wat je al hebt.
Waarom hetzelfde hotel drie keer binnenkomt
Koppel drie leveranciers in dezelfde stad en zoek. Je ziet iets als dit: de ene leverancier noemt het Grand Plaza Hotel Taksim, een andere Grand Plaza Taksim, een derde GRAND PLAZA HTL - ISTANBUL. Drie interne codes. Drie sets coördinaten op een paar minuten lopen van elkaar. Drie fotosets, waarvan één van vóór de verbouwing. Voor je reiziger ziet het eruit als een kapotte site.
De oplossing is een mappinglaag, en het veld waarop je ontdubbelt is niet de naam. Het is je eigen canonieke accommodatie-ID. Elke hotelcode van een leverancier wijst daarnaar via een mappingtabel: leverancier, hotelcode van de leverancier, canoniek ID. De leveranciercode wordt nooit de primaire sleutel van je catalogus, want zodra je een tweede leverancier toevoegt wordt die beslissing heel duur om terug te draaien.
Hoe je bepaalt dat twee codes één hotel zijn, is een matchingprobleem, en dat is zelden schoon:
- Een gedeelde externe mappingcode, als leveranciers die meegeven, is het sterkste signaal. Niet allemaal doen ze dat, en niet voor elke accommodatie.
- Coördinaten binnen een kleine straal, plus een genormaliseerde naam (strip „hotel”, de stad, leestekens, hoofdletters), vangen het grootste deel van de rest.
- Adres en telefoonnummer beslissen de twijfelgevallen. Twee vestigingen van dezelfde keten in één straat zijn precies het geval waarin naam en afstand kloppen en de hotels verschillend zijn.
- Wat overblijft gaat naar een wachtrij voor menselijke controle. Dat gaat niet live op een gok.
Kamers zijn lastiger dan hotels
Als de accommodatie eenmaal gemapt is, blijven de kamers het oneens. „Deluxe King”, „Superior Room, 1 King Bed” en „Tweepersoonskamer - uitzicht op de stad” kunnen dezelfde kamer zijn of drie verschillende. De meeste teams vergelijken kameraanbiedingen op accommodatieniveau, per verzorging, annuleringsvoorwaarden en prijs, in plaats van elke kamernaam over leveranciers heen te mappen. Dat is een verdedigbare keuze. Maak hem alleen bewust, en toon de reiziger genoeg van de eigen kamerbeschrijving van de leverancier om te weten wat hij boekt.
Eén leverancier, meerdere, of een aggregator
Drie routes, en de eerlijke vergelijking gaat over wie de mapping en het pariteitsrisico draagt, niet over de dekking in de brochure.
| Dekking | Risico op tariefpariteit | Integratie-inspanning | Wie doet de mapping | |
|---|---|---|---|---|
| Eén leverancier, direct | Sterk waar die leverancier sterk is, dun elders | Hoog: als zijn prijs fout is, heb je geen tweede offerte | Eén integratie, beide feeds | Niemand hoeft het; één code per hotel |
| Meerdere leveranciers, direct | De breedste die je zelf in de hand hebt | Lager: je kiest per verblijf de betere offerte | Eén per leverancier, plus de mappinglaag, plus het onderhoud ervan | Jij, permanent |
| Een aggregator | Breed, bepaald door de bronnen van de aggregator | Gemengd: je ziet de prijs die hij kiest door te geven | Eén integratie | De aggregator, met jouw oordeel over wat erdoorheen glipt |
Je mag het oneens zijn met de middelste rij, en veel teams zijn dat: de mapping bezitten is ook de kwaliteit van je resultaten bezitten, en sommige zouden dat nooit uit handen geven. Het punt is dat het evenzeer een personeelsbeslissing is als een technische. De mappingtabel is geen project met een einddatum.
Het aantal bepalen
Tel markten, geen leveranciers. Begin met één leverancier die sterk is waar jij het meest verkoopt. Houd een logboek bij van zoekopdrachten die leeg of dun terugkwamen, en van de screenshots die sales doorstuurt. Voeg de tweede leverancier toe als je de steden en accommodaties kunt benoemen die de eerste mist, en controleer of de kandidaat ze echt dekt voordat je iets tekent.
Elke toevoeging moet een gat dichten dat je kunt opsommen. Kun je dat niet, dan stuurt de nieuwe leverancier je vooral duplicaten van hotels die je al verkoopt. We schreven apart over hoe je reis-API's beoordeelt op hun assen in plaats van op hun brochures, en dat kader geldt voor elke kandidaat hier.
Niet alles zelf integreren
Er is een vierde route: één keer integreren met een platform dat de leverancierskoppelingen al heeft. Op dit platform wordt leverancierscontent gedeeld via leveranciersgroepen in plaats van via één-op-één-afspraken, en een tenant ziet de leveranciers die zijn groepen hem toekennen. Voor een ontwikkelaar verplaatst dat de vraag „welke leveranciers zitten achter mijn hotelzoekfunctie” van code naar configuratie: je bouwt tegen één hotel-API, en de leveranciersmix is een commerciële afspraak, geen nieuwe integratiesprint.
Het neemt de vragen uit dit artikel niet weg. Vraag hoe de mapping wordt afgehandeld voor de leveranciers die je toegekend zou krijgen, en test het in de steden waar jij verkoopt, niet in de demostad. Toegang tot de vlucht- en hotel-API's begint als een gesprek en niet als een selfservice-sleutel, en dat is precies het moment om die vraag te stellen.
Wat te weinig integreren je kost
Het ontbrekende hotel op de screenshot is niet één verloren boeking. Het is een klant die nu zijn telefoon checkt voordat hij je een bericht stuurt, en na nog een paar van die momenten, in plaats van jou een bericht te sturen. Het reisbureau deed niets verkeerd in de service. Zijn zoekfunctie wist simpelweg niet dat de accommodatie bestond.
Te veel integreren kost op een andere manier: drie regels van hetzelfde hotel in je resultaten, drie annuleringsvoorwaarden om aan de balie uit te leggen, drie contracten en drie sets inloggegevens om te roteren. Geen van beide fouten verschijnt in een leverancierstelling. Allebei verschijnen ze in wat een reiziger op de resultatenpagina ziet.
Bouw de kant van de live tarieven zo dat die trage leveranciers overleeft; dat behandelden we in het ontwerpen van een client voor hotelbeschikbaarheid. Laat dan de gaten die je kunt benoemen bepalen hoeveel leveranciers erachter zitten.