Hoppa till innehållet
Blogg

Leverantör av hotellbokning-API: bedöm den i receptionen

Tekravel Redaktion
Skriven med hjälp av AI

Det första supportärendet efter lansering handlar sällan om sökning. Det är en gäst i en reception klockan elva på kvällen med ett bekräftelsenummer i mobilen, och en receptionist som skriver in det två gånger och säger att hotellet inte har någon bokning på det namnet. Gästen har betalat dig. Ditt system säger att bokningen är bekräftad. Båda talar sanning, och det är problemet.

Det ärendet är vad valet av leverantör av hotellbokning-API egentligen handlar om. De flesta team väljer efter det som syns i en demo: hur många boenden som kommer tillbaka för en stad, hur ren tillgänglighetsendpointen är, hur snabbt SDK:n ger ett första resultat. Det spelar roll. Det är också ungefär detsamma överallt, och inget av det avgör vad som händer i receptionen.

Varför täckning är fel första fråga

En sökning som ger fler hotell känns som ett bättre API. Men ett boende du kan visa och en bokning som hotellet står för är två olika löften, givna av två olika delar av leverantörens verksamhet. Det första kommer från ett innehållsflöde. Det andra kommer från avtal, anslutning till hotellets egna system och en supportdisk som någon bemannar en lördag.

Om du avgör hur många leverantörer du ska ansluta alls, har den frågan en egen artikel, och mappningsproblemet den beskriver är verkligt. Den här förutsätter att du väljer leverantören och frågar vad bokningssvaret är värt efter att gästen har betalat.

De fem egenskaperna hos en leverantör av hotellbokning-API som syns efter betalning

Skala ner leverantörens dokumentation till de svar din sajt sparar när pengarna väl har rört sig. Det är på de här raderna som två leverantörer med identiska sökendpoints visar sig vara olika produkter.

EgenskapHur ett bra svar ser utVad det kostar dig när det saknas
AvbokningsvillkorStrukturerade: en frist, en avgift och tidszonen för fristenFri text som någon måste läsa, och en återbetalning som avgörs på gissning
Vem som tar emot pengarnaAnges per pris: förbetalt till dig eller betalas på hotellet, och vem som är merchant of recordEn gäst som debiteras två gånger, en gång av dig och en gång vid utcheckning
Hotellets eget bekräftelsenummerReturneras, eller levereras senare via en dokumenterad kanalBara leverantörens referens, som inte betyder något i receptionen
Prisändring mellan tillgänglighet och bokningEtt uttryckligt nytt pris eller ett tydligt avslag, aldrig en tyst skillnadSkillnaden mellan visat och bokat pris tas ur din marginal
Ingen bokning vid ankomstEtt namngivet förfarande och en kontakt som svarar utanför kontorstidDin personal i telefon med hotellet medan gästen väntar i lobbyn

Du kan vara oenig om ordningen. Du kan inte lansera en sajt som tar kort utan ett svar på varje rad.

Avbokning är data, annars är den ett ansvar

Titta noga på första raden, för den felar tystast. Många svar anger avbokningspolicyn som en mening: gratis avbokning till ett datum, därefter debiteras första natten. För en människa läses det bra. Din kod kan inte agera på en mening utan att tolka den, och så tar sig felen in i produktion.

Detaljen som biter är tidszonen. En frist vid midnatt är ett ögonblick i hotellets stad, ett annat på din server och ett tredje i gästens mobil. Om leverantören inte säger vilken, kommer din sajt en dag att säga till en gäst att hen fortfarande kan avboka gratis, återbetala och sedan upptäcka att hotellet debiterade avgiften ändå. Inget kastade något fel. Pengarna försvann bara.

Icke återbetalbara priser förtjänar samma granskning. En leverantör som markerar dem tydligt, i ett fält och inte bara i prisnamnet, har tänkt på sajten som säljer dem. Be att få se båda sorterna i ett riktigt svar innan något skrivs under.

Vems namn står på gästens kortutdrag

Den andra raden låter som bokföring. Den är i själva verket en kundtjänstfråga. När ett pris är förbetalt betalar gästen dig, du eller leverantören betalar hotellet, och hotellet ska inte debitera gästen något utöver extra som minibaren eller en lokal skatt som tas ut i receptionen. När ett pris betalas på hotellet tar din sajt inte emot några pengar för rummet alls, och gästens kort debiteras av boendet, ofta vid incheckning eller utcheckning.

Båda modellerna fungerar. Det som inte fungerar är en kassa som inte kan skilja dem åt. Om leverantören returnerar de två sorternas priser i samma form, med betalningsmodellen gömd i en beskrivning, kommer din sajt förr eller senare att debitera ett rum som hotellet sedan debiterar igen. Gästen ser två rader på utdraget och ringer namnet på den första, som är ditt.

Svaret du vill ha är alltså per pris, i ett fält, och det omfattar vem som är merchant of record. Den sista delen avgör vems beskrivning som syns på kortet och vem som hanterar en chargeback.

Frågor att ställa skriftligt innan du skriver under

Demos visar den lyckliga vägen. Skriftliga svar visar om leverantören har mött de andra. Skicka dessa och spara svaren:

  • Visa mig ett bokningssvar för ett icke återbetalbart pris och ett för ett pris med frist för gratis avbokning.
  • I vilken tidszon uttrycks den fristen, och var i svaret står det?
  • När kommer hotellets eget bekräftelsenummer, och hur får jag det om det kommer efter bokningsanropet?
  • För ett pris som betalas på hotellet, vad ser gästen exakt på sitt kort, från vem och när?
  • När en gäst anländer och hotellet inte har någon bokning, vem ringer de eller jag, och vilka tider?

En leverantör som svarar på den sista frågan med ett förfarande har varit med om det förut. En som svarar med ett funktionsnamn har inte det. Detsamma gäller på flygsidan, där det som står bakom API:et betyder mer än själva API:et.

Vad det kostar att göra fel

Varje fel är litet och upprepas. En återbetalning som betalas ur din marginal för att en frist lästes i fel tidszon. En gäst som debiterats två gånger för att ett pris som betalas på hotellet såg förbetalt ut i din kassa. En medarbetare som börjar varje vecka med att ringa hotell för att bekräfta bokningar för hand, eftersom leverantören aldrig returnerade ett nummer hotellet känner igen. Inget av det syns i en täckningssiffra, och allt syns i supportinkorgen inom första månaden av riktig trafik.

Arbetet för att undvika det är en eftermiddag: läs fem bokningssvar med tabellen ovan bredvid dig.

Var vi står

Tekravel erbjuder hotell- och flyg-API:er. Åtkomst börjar med ett samtal i stället för en självbetjäningsnyckel, tjänster slås på per tenant, och leverantörsinnehåll når en tenant via leverantörsgrupper i stället för en-till-en-avtal. Vi publicerar inga antal boenden på den här sidan, och vi vill hellre att du ställer de fem frågorna ovan än att du tar ett tal på tro. Om du är i det skedet är API-sidan där samtalet börjar.

Tekravel Redaktion

Desk för resetechnologi

Tekravels desk för resetechnologi skriver för branschen: byråägare, konsolidatorer och utvecklarna som integrerar dem. Varje artikel kontrolleras mot plattformen den beskriver innan den publiceras.