Salt la conținut
Blog

API de rezervări hotel și zbor: o călătorie, două rezervări

Redacția Tekravel
Scris cu ajutorul IA

Tichetul spune: "adăugăm hoteluri în fluxul de zboruri, un checkout, un total". E o cerere rezonabilă de la un product manager și sună a muncă de o zi, pentru că aveți deja căutarea de zboruri și aveți deja o pagină de plată. Trei săptămâni mai târziu, echipa se ceartă despre ce trebuie să se întâmple când compania aeriană confirmă și hotelul nu. Un API de rezervări hotel și zbor nu este o integrare cu două tipuri de rezultat. Sunt două integrări care împart un coș.

Cu cât codul recunoaște asta mai devreme, cu atât mai puțin din el va fi rescris. Ce urmează este partea pe care ghidurile de integrare o sar: prin ce diferă cele două jumătăți, pe care o confirmați prima și ce trebuie să fie o călătorie în modelul vostru de date.

Cele două jumătăți nu se comportă la fel

Ambele vin înapoi ca JSON cu un preț și o referință, deci pe fir arată la fel. Nu sunt la fel în ceea ce vă promit după ce aveți referința.

ÎntrebareZborHotel
Ce aveți după rezervareO rezervare (PNR) care încă nu este biletO confirmare care, de obicei, este deja ceea ce ați vândut
Cât timp e valabil prețulPână când tariful este recalculat la rezervare, iar el poate diferi de căutarePână expiră tariful, iar un tarif se poate schimba între disponibilitate și rezervare
Ce o confirmăEmiterea biletului, adesea cu termen limităConfirmarea furnizorului, uneori instantanee, alteori în așteptare
Cum se anuleazăUn void dacă prindeți momentul devreme, altfel o rambursare după regulile tarifului, adesea cu penalizareO anulare după politica tarifului, gratuită până la un termen la multe tarife
Ce schimbă suma la finalTariful, taxele, uneori moneda tarifuluiTaxe și comisioane plătite la hotel, tipul de masă, camera efectiv alocată

Puteți să nu fiți de acord cu un rând, pentru că furnizorii diferă, dar nu cu forma: o jumătate are un pas de emitere, cealaltă are o fereastră de anulare, iar ele nu se aliniază în timp. Partea de zbor a secvenței am tratat-o în integrarea unui API de rezervări zboruri, iar problema furnizorului lent pe partea de hotel în designul clientului pentru un API de disponibilitate hotelieră. Textul acesta începe acolo unde se termină ele: la îmbinare.

Pe care o rezervați prima?

Nimeni nu vă spune că asta e o decizie de design, și tocmai ea stabilește cât costă un eșec.

Să zicem că un client cumpără un zbor și un hotel pentru aceleași date. Trimiteți o rezervare, apoi pe cealaltă. Se pot întâmpla trei lucruri: ambele reușesc, una eșuează, sau una eșuează după ce cealaltă a reușit deja. Primul e o zi bună. Celelalte două vă decid coada de suport.

Dacă emiteți întâi biletul și hotelul refuză apoi, aveți un client cu loc în avion spre un oraș și fără cameră, deja taxat, și o rambursare pe un bilet cu penalizare. Dacă rezervați întâi hotelul și zborul eșuează apoi, țineți o cameră pe care adesea o puteți anula gratuit, deci reparația e ieftină. Riscul invers există și el, fiindcă un tarif de hotel nerambursabil e cel mai rău lucru de ținut, așa că citiți condițiile de anulare ale tarifului înainte să-l lăsați primul.

E o regulă practică, nu o lege, iar ideea este să alegeți ordinea intenționat. Confirmați jumătatea mai ușor de anulat înaintea celei mai grele, verificați prețul la amândouă chiar înainte ca vreuna să fie confirmată și scrieți ce faceți în fiecare dintre cele trei rezultate. Recenzenții întreabă rar. Clienții află întotdeauna.

O călătorie, două rezervări

Forma care rezistă este o înregistrare de călătorie care deține două rezervări, fiecare cu referința ei, statusul ei și condițiile ei. Clientul vede un singur total. Baza voastră de date vede două rânduri, iar totalul e o sumă pe care o calculați, nu ceva ce există la furnizor.

Țineți cele două statusuri separat. "Confirmat" pentru hotel și "emis" pentru zbor nu sunt aceeași stare, iar o singură coloană de status care le aplatizează va scrie, mai devreme sau mai târziu, "rezervat" peste o călătorie rezervată pe jumătate.

Țineți separat și cele două seturi de condiții de modificare, și arătați-le. Un total afișat ascunde faptul că mutarea datelor e gratuită într-o jumătate și costă în cealaltă. Dacă front-end-ul vostru arată "schimbă datele" ca un singur buton, decideți ce face când doar o jumătate se poate muta, înainte ca un client să afle în locul vostru. La fel și cu adaosul: dacă îl puneți pe serviciu, cum face majoritatea vânzătorilor, totalul călătoriei înseamnă două adaosuri, iar o rambursare pe o jumătate trebuie să știe ce adaos returnează. Banii sunt locul unde o călătorie combinată devine scumpă, pentru că liniile se decontează pe termene diferite, iar rambursarea unui zbor nu sosește atunci când sosește anularea hotelului.

Unde se situează această platformă

Direct: platforma expune API-uri pentru zboruri și hoteluri, iar accesul începe cu o discuție, nu cu o cheie în self-service. Serviciile se activează per tenant, deci un tenant care vinde hoteluri și nu tururi nu poartă după el partea de tururi. Nimic de aici nu promite un singur apel care rezervă atomic ambele jumătăți, și nu proiectați ca și cum ar promite. Tratați-le ca pe cele două rezervări care sunt, sub o călătorie care vă aparține.

Dacă vreți să vedeți apelurile și condițiile reale înainte să construiți pe ele, porniți de la pagina de API-uri de călătorie și veniți cu ordinea în care intenționați să rezervați. Dacă încă decideți ce vă oferă accesul gratuit, API gratuit de rezervări hoteliere explică tipurile de "gratuit".

Cât costă greșeala

Versiunea scumpă e cea tăcută. Un client are bilet spre un oraș și camera a dispărut, iar primul lucru pe care îl aflați e un mesaj noaptea, dintr-un aeroport. Mai ieftin, dar tot real: un checkout care arată un total liniștitor și apoi, după o verificare de preț, o a doua sumă cu care clientul nu a fost de acord; o rambursare care returnează zborul și uită hotelul; și un status care spune "rezervat" în timp ce furnizorul spune altceva.

Nimic din toate astea nu cere o soluție ingenioasă. Cere ca o călătorie să fie un obiect real, ca ordinea să fie o decizie pe care cineva a scris-o și ca ambele prețuri să fie reverificate în ultimul moment înainte ca vreunul să fie confirmat. Construiți asta o dată și checkout-ul poate arăta la fel de simplu cum a cerut tichetul.

Redacția Tekravel

Departamentul de tehnologii de turism

Departamentul de tehnologii de turism al Tekravel scrie pentru industrie: proprietari de agenții, consolidatori și dezvoltatorii care îi integrează. Fiecare articol este verificat pe platforma pe care o descrie înainte de publicare.