Spring til indhold
Blog

Booking-API til hotel og fly: én rejse, to bookinger

Tekravel Redaktion
Skrevet med hjælp fra AI

Opgaven lyder: "tilføj hoteller til flyflowet, én checkout, ét total". Det er en rimelig anmodning fra en produktchef, og det lyder som en dags arbejde, for I har allerede flysøgning og allerede en betalingsside. Tre uger senere diskuterer teamet, hvad der skal ske, når flyselskabet bekræfter, og hotellet ikke gør. Et booking-API til hotel og fly er ikke én integration med to slags resultater. Det er to integrationer, der deler en kurv.

Jo før koden indrømmer det, jo mindre af den skal skrives om. Det følgende er den del, integrationsguiderne springer over: hvordan de to halvdele adskiller sig, hvilken I binder først, og hvad en rejse skal være i jeres datamodel.

De to halvdele opfører sig ikke ens

Begge kommer tilbage som JSON med en pris og en reference, så på ledningen ligner de hinanden. De ligner ikke hinanden i det, de lover, når I først har referencen.

SpørgsmålFlyHotel
Hvad I har efter bookingenEn reservation (PNR), der endnu ikke er en billetEn bekræftelse, der som regel allerede er det, I solgte
Hvor længe prisen holderIndtil prisen beregnes igen ved booking, og den kan afvige fra søgningenIndtil raten udløber, og en rate kan ændre sig mellem tilgængelighed og booking
Hvad der bekræfter denUdstedelse af billetten, ofte mod en tidsfristLeverandørens bekræftelse, nogle gange med det samme, nogle gange afventende
Hvordan den fortrydesEn void, hvis I når det tidligt, ellers en refusion efter prisreglerne, ofte med gebyrEn afbestilling efter ratens egen politik, på mange rater gratis indtil en frist
Hvad der ændrer beløbet sentPris, skatter, nogle gange prisens valutaSkatter og gebyrer betalt på stedet, forplejningen, det værelse der faktisk tildeles

I kan være uenige i en række, for leverandører er forskellige, men ikke i formen: den ene halvdel har et udstedelsestrin og den anden et afbestillingsvindue, og de ligger ikke samme sted i tid. Flysiden af forløbet dækkede vi i integration af et flybooking-API og problemet med den langsomme leverandør på hotelsiden i klientdesign til et API for hoteltilgængelighed. Denne tekst begynder, hvor de slutter: i samlingen.

Hvilken booker I først?

Ingen fortæller jer, at det er en designbeslutning, og det er netop den, der afgør, hvad en fejl koster.

Lad os sige, at en kunde køber fly og hotel til de samme datoer. I sender den ene booking og så den anden. Tre ting kan ske: begge lykkes, én fejler, eller én fejler, efter at den anden allerede er lykkedes. Det første er en god dag. De to andre afgør jeres supportkø.

Udsteder I flyet først, og hotellet derefter afviser, har I en kunde med et sæde til en by og intet værelse, som allerede er trukket, og en refusion på en billet med gebyr. Booker I hotellet først, og flyet derefter fejler, holder I et værelse, som ofte kan afbestilles gratis, så reparationen er billig. Den omvendte risiko findes også, for en hotelrate, der ikke kan afbestilles, er det værste at sidde med, så læs ratens afbestillingsvilkår, før I lader den gå først.

Det er en tommelfingerregel, ikke en lov, og pointen er at vælge rækkefølgen med vilje. Bind den halvdel, der er lettest at fortryde, før den sværere, tjek prisen på begge lige før nogen af dem bindes, og skriv ned, hvad I gør i hvert af de tre udfald. Reviewere spørger sjældent. Kunder finder altid ud af det.

Én rejse, to bookinger

Den form, der holder, er en rejsepost, der ejer to bookinger, hver med sin egen reference, sin egen status og sine egne vilkår. Kunden ser ét total. Jeres database ser to rækker, og totalen er en sum, I beregner, ikke noget, der findes hos leverandøren.

Hold de to statusser adskilt. "Bekræftet" for hotellet og "udstedt" for flyet er ikke samme tilstand, og en enkelt statuskolonne, der flader dem ud, vil før eller siden skrive "booket" over en halvt booket rejse.

Hold også de to sæt ændringsvilkår adskilt, og vis dem. Et vist total skjuler, at det er gratis at flytte datoerne på den ene halvdel og koster på den anden. Viser jeres front-end "skift datoer" som én knap, så beslut, hvad den gør, når kun den ene halvdel kan flyttes, før en kunde finder ud af det for jer. Det samme gælder avancen: lægger I den på per ydelse, som de fleste sælgere gør, er rejsens total to avancer, og en refusion på den ene halvdel skal vide, hvilken avance den giver tilbage. Penge er der, hvor en samlet rejse bliver dyr, fordi linjerne afregnes på forskellige tidslinjer, og refusionen for et fly kommer ikke, når hotellets afbestilling gør.

Hvor denne platform står

Lige ud: platformen udstiller API'er til fly og hoteller, og adgangen begynder med en samtale, ikke med en selvbetjeningsnøgle. Tjenester slås til per tenant, så en tenant, der sælger hoteller og ikke ture, slæber ikke turdelen med sig. Intet her lover ét kald, der booker begge halvdele atomart, og I bør ikke designe, som om det gjorde. Behandl dem som de to bookinger, de er, under en rejse, som er jeres.

Vil I se de faktiske kald og vilkår, før I bygger omkring dem, så start på siden om rejse-API'er og tag den rækkefølge med, I vil booke i. Overvejer I stadig, hvad gratis adgang giver jer, gennemgår gratis hotelbooking-API de slags gratis, der findes.

Hvad det koster at gøre det forkert

Den dyre version er den stille. En kunde har billet til en by, og værelset er væk, og det første, I hører om det, er en besked om natten fra en lufthavn. Billigere, men stadig virkeligt: en checkout, der viser ét beroligende total og så, efter et pristjek, et andet tal, som kunden ikke sagde ja til; en refusion, der giver flyet tilbage og glemmer hotellet; og en status, der siger "booket", mens leverandøren siger noget andet.

Intet af det kræver en smart løsning. Det kræver, at rejsen er et rigtigt objekt, at rækkefølgen er en beslutning, som nogen har skrevet ned, og at begge priser tjekkes igen i sidste øjeblik, før nogen af dem bindes. Byg det én gang, og checkouten kan se lige så enkel ud, som opgaven bad om.

Tekravel Redaktion

Desk for rejseteknologi

Tekravels desk for rejseteknologi skriver til branchen: bureauejere, konsolidatorer og de udviklere, der integrerer dem. Hver artikel kontrolleres mod den platform, den beskriver, inden den udgives.