Přeskočit na obsah
Blog

API pro rezervace hotelů a letenek: jedna cesta, dvě rezervace

Redakce Tekravel
Napsáno s pomocí AI

V tiketu stojí: "přidat hotely do toku letenek, jeden checkout, jedna částka". Rozumný požadavek od produktového manažera a zní jako práce na den, protože vyhledávání letů už máte a platební stránku taky. O tři týdny později se tým hádá, co se má stát, když letecká společnost potvrdí a hotel ne. API pro rezervace hotelů a letenek není jedna integrace se dvěma druhy výsledku. Jsou to dvě integrace, které sdílejí košík.

Čím dřív to kód přizná, tím méně se ho bude přepisovat. Dál následuje část, kterou integrační návody přeskakují: v čem se obě poloviny liší, kterou potvrdit jako první a čím musí být cesta ve vašem datovém modelu.

Obě poloviny se nechovají stejně

Obě se vracejí jako JSON s cenou a referencí, takže na drátě vypadají podobně. Podobné nejsou v tom, co slibují, když už referenci máte.

OtázkaLetHotel
Co držíte po rezervaciRezervaci (PNR), která ještě není letenkouPotvrzení, které obvykle už je tím, co jste prodali
Jak dlouho platí cenaDokud se tarif při rezervaci znovu nenacení, a ten se může od vyhledávání lišitDokud sazba nevyprší, a sazba se může změnit mezi dostupností a rezervací
Co ji potvrzujeVystavení letenky, často s časovým limitemPotvrzení dodavatele, někdy okamžité, někdy čekající
Jak se rušíVoid, pokud to stihnete brzy, jinak refundace podle tarifních pravidel, často s pokutouStorno podle podmínek samotné sazby, u mnoha sazeb zdarma do určitého termínu
Co mění částku pozděTarif, daně, někdy měna tarifuDaně a poplatky placené na místě, typ stravování, skutečně přidělený pokoj

S některým řádkem můžete nesouhlasit, protože dodavatelé se liší, ale ne s tvarem: jedna polovina má krok vystavení letenky, druhá okno pro storno, a časově se nepotkávají. Leteckou stranu této sekvence jsme probrali v integraci API pro rezervace letenek a problém pomalého dodavatele na hotelové straně v návrhu klienta pro API dostupnosti hotelů. Tento text začíná tam, kde ty končí: ve spoji.

Co rezervovat jako první?

Nikdo vám neřekne, že jde o návrhové rozhodnutí, a právě to určuje, kolik selhání stojí.

Řekněme, že zákazník kupuje let a hotel na stejné termíny. Pošlete jednu rezervaci a potom druhou. Mohou nastat tři věci: obě vyjdou, jedna selže, nebo jedna selže poté, co druhá už vyšla. To první je dobrý den. Zbylé dvě rozhodují o vaší frontě podpory.

Když nejdřív vystavíte letenku a hotel pak odmítne, máte zákazníka s místem v letadle do města a bez pokoje, už zatíženého platbou, a refundaci letenky s pokutou. Když nejdřív zarezervujete hotel a let pak selže, držíte pokoj, který jde často zrušit zdarma, takže náprava je levná. Opačné riziko existuje taky, protože nevratná hotelová sazba je to nejhorší, co držet, takže si storno podmínky sazby přečtěte dřív, než ji pustíte napřed.

Je to praktické pravidlo, ne zákon, a jde o to vybrat pořadí záměrně. Potvrďte polovinu, kterou jde snáz vrátit, před tou těžší, ověřte cenu obou těsně předtím, než se kterákoli potvrdí, a zapište si, co uděláte v každém ze tří výsledků. Revieweři se ptají málokdy. Zákazníci na to přijdou vždycky.

Jedna cesta, dvě rezervace

Tvar, který vydrží, je záznam cesty, jemuž patří dvě rezervace, každá s vlastní referencí, vlastním stavem a vlastními podmínkami. Zákazník vidí jednu částku. Vaše databáze vidí dva řádky a částka je součet, který počítáte, ne něco, co u dodavatele existuje.

Držte oba stavy odděleně. "Potvrzeno" u hotelu a "vystaveno" u letu není stejný stav a jeden sloupec stavu, který je zploští, dřív nebo později napíše "rezervováno" nad napůl rezervovanou cestu.

Odděleně držte i obě sady podmínek pro změny a ukazujte je. Zobrazená částka skrývá, že posun termínu je v jedné polovině zdarma a ve druhé za poplatek. Pokud váš front-end ukazuje "změnit termín" jako jedno tlačítko, rozhodněte, co udělá, když se pohnout dá jen jedna polovina, dřív než to za vás zjistí zákazník. Totéž platí pro přirážku: pokud ji přidáváte po službách, jak to dělá většina prodejců, je celková částka cesty dvě přirážky a refundace jedné poloviny musí vědět, kterou přirážku vrací. Peníze jsou místo, kde spojená cesta zdraží, protože položky se vypořádávají v různých lhůtách a refundace letenky nepřijde ve chvíli, kdy přijde storno hotelu.

Kde stojí tato platforma

Na rovinu: platforma nabízí API pro lety a hotely a přístup začíná rozhovorem, ne samoobslužným klíčem. Služby se zapínají pro každého tenanta zvlášť, takže tenant, který prodává hotely a ne výlety, s sebou nenese výletovou část. Nic tady neslibuje jedno volání, které atomicky zarezervuje obě poloviny, a neměli byste navrhovat, jako by to slibovalo. Zacházejte s nimi jako se dvěma rezervacemi, kterými jsou, pod cestou, která patří vám.

Pokud chcete vidět skutečná volání a podmínky dřív, než na nich začnete stavět, začněte na stránce s cestovními API a přineste pořadí, ve kterém chcete rezervovat. Pokud se ještě rozhodujete, co vám dá bezplatný přístup, bezplatné API pro rezervace hotelů rozebírá druhy "zdarma".

Kolik stojí chyba

Drahá verze je ta tichá. Zákazník má letenku do města, pokoj je pryč a první, co o tom slyšíte, je zpráva v noci z letiště. Levnější, ale pořád skutečné: checkout, který ukáže jednu uklidňující částku a pak, po kontrole ceny, druhé číslo, se kterým zákazník nesouhlasil; refundace, která vrátí let a zapomene na hotel; a stav "rezervováno", zatímco dodavatel tvrdí něco jiného.

Nic z toho nepotřebuje chytré řešení. Potřebuje to, aby cesta byla skutečný objekt, aby pořadí bylo rozhodnutí, které někdo zapsal, a aby se obě ceny v poslední chvíli před potvrzením kterékoli z nich znovu ověřily. Postavte to jednou a checkout může vypadat tak jednoduše, jak tiket chtěl.

Redakce Tekravel

Rubrika cestovních technologií

Rubrika cestovních technologií Tekravel píše pro obor: majitele agentur, konsolidátory a vývojáře, kteří je integrují. Každý článek je před vydáním ověřen na platformě, kterou popisuje.