Prijeđi na sadržaj
Blog

API za rezervacije hotela i letova: jedno putovanje, dvije rezervacije

Uredništvo Tekravel
Napisano uz pomoć umjetne inteligencije

Zadatak glasi: "dodajte hotele u tijek za letove, jedna blagajna, jedan ukupni iznos". Razuman zahtjev voditelja proizvoda, i zvuči kao posao za jedan dan, jer već imate pretragu letova i već imate stranicu za plaćanje. Tri tjedna kasnije tim se svađa oko toga što treba biti kad zrakoplovna tvrtka potvrdi, a hotel ne. API za rezervacije hotela i letova nije jedna integracija s dvije vrste rezultata. To su dvije integracije koje dijele jednu košaricu.

Što prije kod to prizna, manje će ga se morati prepisivati. Slijedi dio koji vodiči za integraciju preskaču: po čemu se dvije polovice razlikuju, koju prvu potvrditi i što putovanje mora biti u vašem podatkovnom modelu.

Dvije polovice se ne ponašaju jednako

Obje se vraćaju kao JSON s cijenom i referencom, pa na žici izgledaju slično. Nisu slične u onome što vam obećavaju nakon što referencu već imate.

PitanjeLetHotel
Što držite nakon rezervacijeRezervaciju (PNR) koja još nije kartaPotvrdu koja je obično već ono što ste prodali
Koliko dugo vrijedi cijenaDok se tarifa ne preračuna pri rezervaciji, a može se razlikovati od pretrageDok tarifa ne istekne, a tarifa se može promijeniti između raspoloživosti i rezervacije
Što je potvrđujeIzdavanje karte, često uz rokPotvrda dobavljača, ponekad odmah, ponekad na čekanju
Kako se poništavaVoid ako se uhvati rano, inače povrat po tarifnim pravilima, često s penalomOtkaz po uvjetima same tarife, besplatan do roka na mnogim tarifama
Što kasno mijenja iznosTarifa, pristojbe, ponekad valuta tarifePorezi i naknade plaćeni u objektu, vrsta usluge, soba koja je stvarno dodijeljena

Možete se ne složiti s nekim retkom, jer se dobavljači razlikuju, ali ne i s oblikom: jedna polovica ima korak izdavanja, druga ima prozor za otkaz, i oni se ne poklapaju u vremenu. Stranu letova obradili smo u tekstu integracija API-ja za rezervacije letova, a problem sporih dobavljača na strani hotela u tekstu dizajn klijenta za API raspoloživosti hotela. Ovaj tekst počinje tamo gdje oni završavaju, na spoju.

Koju rezervirate prvu?

Nitko vam ne kaže da je ovo dizajnerska odluka, a upravo ona određuje koliko pogreška košta.

Recimo da kupac kupuje let i hotel za iste datume. Šaljete jednu rezervaciju, pa drugu. Mogu se dogoditi tri stvari: obje uspiju, ili jedna ne uspije, ili jedna ne uspije nakon što je druga već uspjela. Prvo je dobar dan. Druge dvije određuju red u vašoj podršci.

Ako prvo izdate kartu, a hotel zatim odbije, imate kupca sa sjedalom do jednog grada i bez sobe, koji je već terećen, i povrat za kartu s penalom. Ako prvo rezervirate hotel, a let zatim ne uspije, držite sobu koju često možete besplatno otkazati, pa je popravak jeftin. I obrnuti rizik je stvaran, jer hotelska tarifa bez mogućnosti otkaza je gora stvar za držati, zato pročitajte uvjete otkaza tarife prije nego što je pustite prvu.

Ovo je pravilo iz iskustva, ne zakon, a poanta je da redoslijed odaberete namjerno. Potvrdite polovicu koju je lakše poništiti prije one koju je teže, provjerite cijenu obje neposredno prije nego što bilo koja bude potvrđena, i zapišite što radite za svaki od tri ishoda. Recenzenti rijetko pitaju. Kupci uvijek saznaju.

Jedno putovanje, dvije rezervacije

Oblik koji izdrži je zapis putovanja koji posjeduje dvije rezervacije, svaku sa svojom referencom, svojim statusom i svojim uvjetima. Kupac vidi jedan ukupni iznos. Baza vidi dva retka, a ukupni iznos je zbroj koji vi računate, ne nešto što postoji kod dobavljača.

Držite dva statusa odvojeno. "Potvrđeno" za hotel i "izdano" za let nisu isto stanje, a jedan stupac statusa koji ih spljošti reći će prije ili kasnije "rezervirano" za napola rezervirano putovanje.

Držite odvojeno i dva skupa uvjeta izmjene, i prikažite ih. Prikazani ukupni iznos skriva da je pomicanje datuma besplatna izmjena na jednoj polovici i naknada na drugoj. Ako frontend prikazuje "promijeni datume" kao jedan gumb, odlučite što radi kad se samo jedna polovica može pomaknuti, prije nego što to kupac otkrije umjesto vas. Isto vrijedi za maržu: ako je dodajete po usluzi, kao što radi većina prodavača, ukupni iznos putovanja su dvije marže, a povrat za jednu polovicu mora znati koju maržu vraća. Novac je mjesto gdje spojeno putovanje postaje skupo, jer se stavke namiruju po različitim rokovima, a povrat za let ne stiže kad stiže otkaz hotela.

Gdje stoji ova platforma

Otvoreno: platforma nudi API-je za letove i hotele, a pristup počinje razgovorom, ne ključem koji sami preuzimate. Usluge se uključuju po tenantu, pa tenant koji prodaje hotele, a ne ture, ne nosi površinu za ture. Ništa ovdje ne obećava jedan poziv koji atomski rezervira obje polovice, i ne biste trebali projektirati kao da obećava. Tretirajte ih kao dvije rezervacije, što i jesu, pod putovanjem koje vi posjedujete.

Ako želite vidjeti stvarne pozive i uvjete prije nego što gradite oko njih, počnite od stranice o turističkim API-jima i ponesite redoslijed kojim namjeravate rezervirati. Ako još odlučujete što vam besplatan pristup donosi, tekst besplatan API za rezervacije hotela redom navodi vrste besplatnog.

Koliko košta pogreška

Skupa verzija je tiha. Kupac ima kartu do jednog grada, sobe nema, i prvo što čujete je poruka noću, sa zračne luke. Jeftinije, ali i dalje stvarno: blagajna koja pokazuje jedan umirujući iznos, a zatim, nakon provjere cijene, drugi broj na koji kupac nije pristao; povrat koji vrati let i zaboravi hotel; i status "rezervirano" dok dobavljač kaže drukčije.

Ništa od toga ne traži pametno rješenje. Traži da putovanje bude pravi objekt, da redoslijed bude odluka koju je netko zapisao, i ponovnu provjeru obje cijene u posljednjem trenutku prije nego što bilo koja bude potvrđena. Izgradite to jednom i blagajna može izgledati jednostavno kao što je zadatak tražio.

Uredništvo Tekravel

Desk za putničke tehnologije

Desk za putničke tehnologije Tekravela piše za struku: vlasnike agencija, konsolidatore i programere koji ih integriraju. Svaki se članak prije objave provjerava na platformi koju opisuje.