API rezerwacji hoteli i lotów: jedna podróż, dwie rezerwacje

Zgłoszenie brzmi: "dodać hotele do ścieżki lotów, jeden checkout, jedna suma". To rozsądna prośba od product managera i brzmi jak praca na jeden dzień, bo wyszukiwarkę lotów już macie, a stronę płatności też. Trzy tygodnie później zespół kłóci się o to, co ma się stać, gdy linia lotnicza potwierdza, a hotel nie. API rezerwacji hoteli i lotów to nie jedna integracja z dwoma rodzajami wyników. To dwie integracje, które dzielą jeden koszyk.
Im szybciej kod to przyzna, tym mniej z niego trzeba będzie przepisać. Dalej jest część, którą przewodniki integracyjne pomijają: czym różnią się obie połowy, którą zatwierdzić najpierw i czym podróż musi być w waszym modelu danych.
Obie połowy nie zachowują się tak samo
Obie wracają jako JSON z ceną i numerem referencyjnym, więc na łączu wyglądają podobnie. Nie są podobne w tym, co obiecują, gdy numer już macie.
| Pytanie | Lot | Hotel |
|---|---|---|
| Co macie po rezerwacji | Rezerwację (PNR), która nie jest jeszcze biletem | Potwierdzenie, które zwykle jest już tym, co sprzedaliście |
| Jak długo cena jest ważna | Do ponownej wyceny taryfy przy rezerwacji, która może różnić się od wyszukiwania | Do wygaśnięcia stawki, a stawka może się zmienić między dostępnością a rezerwacją |
| Co ją potwierdza | Wystawienie biletu, często z limitem czasu | Potwierdzenie dostawcy, czasem natychmiastowe, czasem oczekujące |
| Jak ją cofnąć | Void, jeśli zdążycie wcześnie, w przeciwnym razie zwrot według zasad taryfy, często z karą | Anulacja według polityki samej stawki, przy wielu stawkach bezpłatna do określonego terminu |
| Co zmienia kwotę na końcu | Taryfa, podatki, czasem waluta taryfy | Podatki i opłaty płatne w obiekcie, rodzaj wyżywienia, faktycznie przydzielony pokój |
Możecie nie zgadzać się z którymś wierszem, bo dostawcy się różnią, ale nie z kształtem całości: jedna połowa ma krok wystawienia biletu, druga okno anulacji, i te dwa momenty nie pokrywają się w czasie. Stronę lotniczą tej sekwencji omówiliśmy w integracji API rezerwacji lotów, a problem wolnego dostawcy po stronie hotelu w projekcie klienta API dostępności hoteli. Ten tekst zaczyna się tam, gdzie tamte się kończą: na styku.
Co rezerwować najpierw?
Nikt wam nie powie, że to decyzja projektowa, a właśnie ona ustala, ile kosztuje błąd.
Załóżmy, że klient kupuje lot i hotel na te same daty. Wysyłacie jedną rezerwację, potem drugą. Mogą się zdarzyć trzy rzeczy: obie się udają, jedna się nie udaje albo jedna się nie udaje po tym, jak druga już się udała. Pierwsza to dobry dzień. Dwie pozostałe decydują o waszej kolejce w supporcie.
Jeśli najpierw wystawicie bilet, a hotel potem odmówi, macie klienta z miejscem w samolocie do miasta i bez pokoju, już obciążonego, oraz zwrot za bilet z karą. Jeśli najpierw zarezerwujecie hotel, a potem lot się nie uda, trzymacie pokój, który często da się anulować za darmo, więc naprawa jest tania. Ryzyko odwrotne też istnieje, bo bezzwrotna stawka hotelowa to najgorsza rzecz do trzymania, więc przeczytajcie warunki anulacji stawki, zanim puścicie ją przodem.
To reguła praktyczna, nie prawo, a chodzi o to, by kolejność wybrać świadomie. Zatwierdźcie łatwiejszą do cofnięcia połowę przed trudniejszą, sprawdźcie cenę obu tuż przed zatwierdzeniem którejkolwiek i zapiszcie, co robicie w każdym z trzech wyników. Recenzenci rzadko o to pytają. Klienci zawsze się dowiadują.
Jedna podróż, dwie rezerwacje
Kształt, który się sprawdza, to rekord podróży, do którego należą dwie rezerwacje, każda z własnym numerem, własnym statusem i własnymi warunkami. Klient widzi jedną sumę. Wasza baza widzi dwa wiersze, a suma to wynik, który liczycie, a nie coś, co istnieje u dostawcy.
Trzymajcie oba statusy osobno. "Potwierdzony" dla hotelu i "wystawiony" dla lotu to nie ten sam stan, a jedna kolumna statusu, która je spłaszcza, prędzej czy później napisze "zarezerwowano" nad podróżą zarezerwowaną w połowie.
Trzymajcie też osobno oba zestawy warunków zmian i pokazujcie je. Wyświetlona suma ukrywa, że zmiana dat jest darmowa w jednej połowie i płatna w drugiej. Jeśli wasz front-end pokazuje "zmień daty" jako jeden przycisk, zdecydujcie, co on robi, gdy przesunąć da się tylko jedną połowę, zanim klient odkryje to za was. To samo dotyczy marży: jeśli doliczacie ją per usługa, jak robi to większość sprzedawców, suma podróży to dwie marże, a zwrot za jedną połowę musi wiedzieć, którą marżę oddaje. Pieniądze to miejsce, w którym łączona podróż robi się droga, bo pozycje rozliczają się w różnych terminach, a zwrot za lot nie przychodzi wtedy, gdy przychodzi anulacja hotelu.
Gdzie jest ta platforma
Wprost: platforma udostępnia API lotów i hoteli, a dostęp zaczyna się od rozmowy, nie od klucza w samoobsłudze. Usługi włącza się per tenant, więc tenant, który sprzedaje hotele, a nie wycieczki, nie nosi ze sobą części wycieczkowej. Nic tutaj nie obiecuje jednego wywołania, które atomowo rezerwuje obie połowy, i nie projektujcie tak, jakby obiecywało. Traktujcie je jak dwie rezerwacje, którymi są, w ramach podróży, która należy do was.
Jeśli chcecie zobaczyć prawdziwe wywołania i warunki, zanim na nich zbudujecie, zacznijcie od strony z API podróżniczymi i przynieście kolejność, w jakiej zamierzacie rezerwować. Jeśli wciąż rozważacie, co daje darmowy dostęp, darmowe API rezerwacji hoteli rozkłada rodzaje "darmowego".
Ile kosztuje pomyłka
Droga wersja jest cicha. Klient ma bilet do miasta, pokoju już nie ma, a pierwsze, co o tym słyszycie, to wiadomość w nocy z lotniska. Taniej, ale wciąż naprawdę: checkout, który pokazuje jedną uspokajającą sumę, a potem, po sprawdzeniu ceny, drugą kwotę, na którą klient się nie zgodził; zwrot, który oddaje lot i zapomina o hotelu; i status "zarezerwowano", podczas gdy dostawca mówi co innego.
Nic z tego nie wymaga sprytnego rozwiązania. Wymaga, by podróż była prawdziwym obiektem, by kolejność była decyzją, którą ktoś zapisał, i by obie ceny zostały ponownie sprawdzone w ostatniej chwili przed zatwierdzeniem którejkolwiek. Zbudujcie to raz, a checkout może wyglądać tak prosto, jak chciało zgłoszenie.