Hotel- en vluchtboekings-API: één reis, twee boekingen

Het ticket zegt: "hotels toevoegen aan de vluchtflow, één checkout, één totaal". Een redelijk verzoek van een productmanager, en het klinkt als een dag werk, want u hebt al vluchtzoeken en u hebt al een betaalpagina. Drie weken later discussieert het team over wat er moet gebeuren als de luchtvaartmaatschappij bevestigt en het hotel niet. Een hotel- en vluchtboekings-API is geen integratie met twee soorten resultaat. Het zijn twee integraties die een winkelmand delen.
Hoe eerder de code dat toegeeft, hoe minder ervan herschreven wordt. Wat volgt is het deel dat integratiegidsen overslaan: waarin de twee helften verschillen, welke u het eerst vastlegt en wat een reis in uw datamodel moet zijn.
De twee helften gedragen zich niet hetzelfde
Beide komen terug als JSON met een prijs en een referentie, dus op de lijn lijken ze op elkaar. Ze lijken niet op elkaar in wat ze beloven zodra u de referentie hebt.
| Vraag | Vlucht | Hotel |
|---|---|---|
| Wat u na het boeken in handen hebt | Een reservering (PNR) die nog geen ticket is | Een bevestiging die meestal al het verkochte product is |
| Hoe lang de prijs geldt | Tot het tarief bij het boeken opnieuw wordt geprijsd, wat kan afwijken van de zoekopdracht | Tot het tarief verloopt, en een tarief kan veranderen tussen beschikbaarheid en boeking |
| Wat het bevestigt | Ticketing, vaak tegen een tijdslimiet | De bevestiging van de leverancier, soms direct, soms in behandeling |
| Hoe het ongedaan wordt | Een void als u er vroeg bij bent, anders een terugbetaling volgens de tariefregels, vaak met boete | Een annulering volgens het eigen beleid van het tarief, bij veel tarieven gratis tot een deadline |
| Wat het bedrag laat nog verandert | Tarief, belastingen, soms de valuta van het tarief | Belastingen en kosten ter plaatse betaald, de maaltijdbasis, de kamer die echt wordt toegewezen |
U mag het met een rij oneens zijn, want leveranciers verschillen, maar niet met de vorm: de ene helft heeft een ticketingstap en de andere een annuleringsvenster, en die lopen in de tijd niet gelijk. De vluchtkant van de volgorde behandelden we in integratie van een vluchtboekings-API en het probleem van de trage leverancier aan de hotelkant in clientontwerp voor een hotelbeschikbaarheids-API. Dit stuk begint waar die eindigen, bij de naad.
Welke boekt u eerst?
Niemand zegt u dat dit een ontwerpbeslissing is, en het is precies de beslissing die bepaalt wat een fout kost.
Stel: een klant koopt een vlucht en een hotel voor dezelfde data. U stuurt de ene boeking en dan de andere. Er kunnen drie dingen gebeuren: beide lukken, of één mislukt, of één mislukt nadat de andere al gelukt is. Het eerste is een goede dag. De andere twee bepalen uw supportwachtrij.
Tickett u eerst de vlucht en weigert het hotel daarna, dan hebt u een klant met een stoel naar een stad en geen kamer, die al betaald heeft, en een terugbetaling op een ticket met boete. Boekt u eerst het hotel en mislukt daarna de vlucht, dan houdt u een kamer vast die u vaak gratis kunt annuleren, dus het herstel is goedkoop. Het omgekeerde risico bestaat ook, want een niet-annuleerbaar hoteltarief is het slechtste om vast te houden; lees dus de annuleringsvoorwaarden van het tarief voordat u het voor laat gaan.
Dit is een vuistregel, geen wet, en het punt is dat u de volgorde bewust kiest. Leg de helft die makkelijker ongedaan te maken is vast vóór de moeilijkere, controleer de prijs van beide vlak voordat een van de twee vastligt, en schrijf op wat u doet bij elk van de drie uitkomsten. Reviewers vragen er zelden naar. Klanten komen er altijd achter.
Eén reis, twee boekingen
De vorm die standhoudt is een reisrecord dat twee boekingen bezit, elk met een eigen referentie, een eigen status en eigen voorwaarden. De klant ziet één totaal. Uw database ziet twee rijen, en het totaal is een som die u berekent, niet iets dat bij de leverancier bestaat.
Houd de twee statussen gescheiden. "Bevestigd" voor het hotel en "getickt" voor de vlucht zijn niet dezelfde toestand, en één statuskolom die ze platslaat zal vroeg of laat "geboekt" zeggen over een half geboekte reis.
Houd ook de twee sets wijzigingsvoorwaarden gescheiden, en toon ze. Een getoond totaal verbergt dat de data verzetten aan de ene kant gratis is en aan de andere kant geld kost. Toont uw front-end "data wijzigen" als één knop, beslis dan wat die doet als maar één helft kan bewegen, voordat een klant het voor u uitzoekt. Hetzelfde geldt voor de marge: zet u die per dienst, zoals de meeste verkopers doen, dan bestaat het reistotaal uit twee marges, en een terugbetaling op één helft moet weten welke marge ze teruggeeft. Geld is waar een gecombineerde reis duur wordt, omdat de regels op verschillende tijdlijnen worden afgerekend, en de terugbetaling van een vlucht komt niet binnen op het moment dat de hotelannulering dat doet.
Waar dit platform staat
Zonder omwegen: het platform biedt API's voor vluchten en hotels, en toegang begint met een gesprek, niet met een selfservice-sleutel. Diensten worden per tenant aangezet, dus een tenant die hotels verkoopt en geen tours, draagt het tour-oppervlak niet mee. Niets hier belooft één aanroep die beide helften atomair boekt, en u moet niet ontwerpen alsof dat zo is. Behandel ze als de twee boekingen die ze zijn, onder een reis die van u is.
Wilt u de echte aanroepen en voorwaarden zien voordat u erop bouwt, begin dan bij de pagina met reis-API's en neem de volgorde mee waarin u wilt boeken. Twijfelt u nog wat gratis toegang u oplevert, dan zet gratis hotelboekings-API de soorten gratis op een rij.
Wat het kost als het misgaat
De dure versie is de stille. Een klant heeft een ticket naar een stad en de kamer is weg, en het eerste wat u ervan hoort is een bericht 's nachts, vanaf een luchthaven. Goedkoper maar nog steeds echt: een checkout die één geruststellend totaal toont en dan, na een prijscontrole, een tweede bedrag waarmee de klant niet akkoord ging; een terugbetaling die de vlucht teruggeeft en het hotel vergeet; en een status die "geboekt" zegt terwijl de leverancier iets anders zegt.
Niets daarvan vraagt om een slimme oplossing. Het vraagt dat de reis een echt object is, dat de volgorde een beslissing is die iemand heeft opgeschreven, en dat beide prijzen op het laatste moment opnieuw worden gecontroleerd voordat er een vastligt. Bouw dat één keer en de checkout kan er net zo eenvoudig uitzien als het ticket vroeg.