Přeskočit na obsah
Blog

Zpracování chyb API rezervačního systému: tři selhání, která stojí peníze

Redakce Tekravel
Napsáno s pomocí AI

Ticket z podpory dorazí ve čtvrtek večer. Zákazník zaplatil, stránka se točila a pak ukázala obecnou chybu. Karta je zatížená. V logu vidíte POST na dodavatele, který nikdy nedostal odpověď. Držela aerolinka místo? Nikdo vám to neřekne a zákazník čeká. Dobré zpracování chyb API rezervačního systému je z velké části práce na tom, abyste se do téhle situace nikdy nedostali, nebo alespoň přesně věděli, co dělat, když se do ní dostanete.

Většina integračních příruček bere chyby jako katalog stavových kódů. U rezervací jsou kódy ta snazší část. Peníze stojí malá sada situací, kdy požadavek vypadá, že selhal, ale svět se přesto změnil, nebo vypadá, že uspěl, a svět se nezměnil. Tři z nich jsou důležitější než ostatní.

Selhání první: cena se mezi hledáním a rezervací pohnula

Výsledky hledání jsou nabídka, ne smlouva. Tarify se cachují, kapacita se sdílí přes všechny kanály, kterými dodavatel prodává, a částka, kterou jste ukázali ve 14:02, může být o pár minut později zastaralá. Dodavatel vám to řekne v kroku vytvoření rezervace, někdy čistou odpovědí „tarif se změnil“, jindy tím, že v jinak úspěšné odpovědi tiše vrátí jinou celkovou cenu.

Ten druhý případ je nebezpečný. Pokud váš kód přečte potvrzení, uloží rezervaci a strhne zákazníkovi částku, kterou viděl, rozdíl jde z vaší marže nebo později z ADM. Pravidlo je proto prosté: porovnejte celkovou cenu, kterou dodavatel potvrdil, s cenou, kterou zákazník přijal, pokaždé, v kódu, ještě než platbu zinkasujete.

Co dělat při rozdílu, závisí na jeho velikosti a na tom, kdo ho nese. Pár haléřů zaokrouhlení mezi měnami je tolerance, kterou nastavíte jednou. Cokoli většího se vrací zákazníkovi jako nová cena s výslovným tlačítkem pro přijetí. Nikdy ji neabsorbujte automaticky a nikdy ji automaticky neúčtujte.

Selhání druhé: zarezervováno, ale nevystaveno

Existující PNR neznamená existující letenku. Řada toků nejdřív vytvoří rezervaci a e-ticket vystaví jako samostatný krok s časovým limitem mezi nimi. Když platba projde a vystavení selže, držíte zákazníkovy peníze a rezervaci, která vyprší podle vlastních hodin.

Selhání je málokdy hlasité. Volání vystavení vrátí chybu nebo timeout a rezervace zůstane ve stavu, který vaše databáze označuje jako „zaplaceno“, zatímco dodavatel stále hlásí „držíme“. Mezitím běží limit pro vystavení a aerolinka, na rozdíl od vaší fronty podpory, nečeká.

Berte to jako samostatný stav, ne variantu úspěchu či selhání. Rezervace potřebuje alespoň tyto stavy: vytvořena, držena, platba zinkasována, vystavuje se, vystavena, selhala a lze vrátit peníze. „Platba zinkasována, vystavuje se“ je stav, který potřebuje časovač: když tam rezervace visí příliš dlouho, má úloha znovu načíst rezervaci od dodavatele a rozhodnout, ne čekat, až si toho všimne člověk. Rozhodnutí je levné, když znáte limit dodavatele, protože ten říká, jak dlouho můžete bezpečně opakovat, než musíte peníze vrátit.

Selhání třetí: timeout s neznámým výsledkem

Tohle je ticket ze čtvrtečního večera. Váš požadavek odešel, odpověď nepřišla, spojení zemřelo nebo brána to vzdala. Dodavatel ho mohl zpracovat celý, částečně, nebo vůbec.

Svádí to zkusit znovu. Nevolejte slepě znovu vytvoření rezervace, protože druhý pokus může vyrobit druhou rezervaci a duplicita je skutečný náklad: dvě držená místa, možná dvě vystavené letenky, spor o vrácení peněz u jedné z nich.

Bezpečné pořadí zní: zastavit, přečíst, rozhodnout. Zastavte tok směrem k zákazníkovi poctivým stavem „potvrzujeme vaši rezervaci“. Přečtěte stranu dodavatele vyhledáním rezervace podle reference, kterou jste vygenerovali před voláním (proto si vytváříte vlastní klientskou referenci jako první a posíláte ji, pokud ji dodavatel přijímá). Teprve pak rozhodněte: nalezeno znamená pokračovat ze skutečného stavu; nenalezeno po uplynutí dodavatelova okna zpracování znamená, že je bezpečné to jednou zopakovat.

Pokud dodavatel nenabízí vyhledání podle vaší reference, hledejte podle jména cestujícího, trasy a data v úzkém okně a shodu berte jako nalezeno. Nehezké, ale mnohem levnější než duplicita.

Rozhodovací tabulka, se kterou můžete nesouhlasit

Co vidíteCo víteCo udělatCo neudělat
Dodavatel vrací „tarif se změnil“Nic nebylo zarezervovánoUkázat novou celkovou cenu, vyžádat souhlas, znovu spustit vytvořeníSpustit znovu se starou cenou a doufat
Úspěch, ale celková cena se liší od té, kterou zákazník přijalRezervace existuje za novou cenuPodržet platbu, zeptat se zákazníka, při odmítnutí rezervaci stornovatZinkasovat starou částku a rozdíl spolknout
Platba zinkasována, volání vystavení vrací chybuPNR existuje, stav letenky neznámýZnovu načíst rezervaci, opakovat vystavení v časovém limitu, po jeho uplynutí vrátit penízeOznačit rezervaci za selhanou a na PNR zapomenout
Timeout při vytvořeníVýsledek neznámýVyhledat podle vaší reference, pak pokračovat nebo jednou zopakovatOkamžité slepé opakování
Timeout při zrušeníZa segment můžete stále odpovídatPřed jakoukoli informací zákazníkovi znovu zjistit stavUkázat „zrušeno“, protože se kliklo

Jeden řádek, který můžete zpochybnit: některé týmy vrací peníze už při první chybě vystavení, aby zákazníka uklidnily. U malých letenek obhajitelné, u drahých špatný zvyk, protože můžete přijít o tarif, který šel zachránit o minutu později.

Kolik vás stojí, když to uděláte špatně

Každé selhání má jinou účtenku. Přehlédnutá změna ceny je ztracená marže na každé rezervaci, kterou se dotkne, často neviditelná až do odsouhlasení. Zarezervováno, ale nevystaveno je zákazník, který přijde na letiště s propadlou rezervací a strženou platbou, tedy chargeback i problém s reputací najednou. Slepé opakování po timeoutu je duplicitní rezervace a aerolinky duplicity kontrolují; jejich vzorec je přesně to, co končí v ADM.

Nic z toho není exotické. Je to neokázalé potrubí, které odděluje demo od něčeho, co můžete nechat běžet celý víkend.

Napište odsouhlasovací úlohu dřív, než ji budete potřebovat

Všechna tři selhání končí stejně: vaše databáze a databáze dodavatele se rozcházejí. Napište proto úlohu, která je porovnává, před prvním incidentem, ne po něm. Noční běh je minimum; každých pár minut pro vše v přechodovém stavu je lepší. Vypíše rezervace uvízlé ve stavu držení, vystavování nebo neznámém, zeptá se dodavatele, co si myslí, a buď záznam opraví, nebo založí ticket s přiloženými důkazy.

Uchovávejte každý požadavek a odpověď u volání rezervací, včetně timeoutů, spolu s referencí, kterou jste poslali. Když zákazník zpochybní platbu, tenhle log je váš argument. Udržuje také poctivou debatu o latenci: viz co u latence API můžete a nemůžete opravit, proč jsou timeouty fakt života, a ne chyba k odstranění.

Pokud ještě řešíte, jak napojit samotného dodavatele, návod integrace API pro rezervaci letenek pokrývá pořadí volání, které tento článek předpokládá. A pokud chcete probrat, jak se tyto stavy promítají do našich API pro lety a hotely, přístup začíná rozhovorem: podívejte se na stránku travel API.

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.