Ugrás a tartalomra
Blog

Foglalási motor API hibakezelése: három hiba, ami pénzbe kerül

Tekravel Szerkesztőség
Mesterséges intelligencia segítségével írva

Az ügyfélszolgálati jegy egy csütörtök esti órán érkezik. Egy vásárló fizetett, az oldal pörgött, majd általános hibát mutatott. A kártyát megterhelték. A naplóidban egy POST látszik a szállító felé, amely sosem kapott választ. Tartott a légitársaság helyet? Senki sem tudja megmondani, és a vásárló vár. A jó foglalási motor API hibakezelése nagyrészt arról szól, hogy soha ne kerülj ebbe a helyzetbe, vagy legalább pontosan tudd, mit tegyél, ha mégis.

A legtöbb integrációs útmutató a hibákat állapotkódok katalógusaként kezeli. Foglalásnál a kódok a könnyű rész. Pénzbe az a néhány helyzet kerül, amikor a kérés úgy tűnik, elbukott, de a világ mégis megváltozott, vagy úgy tűnik, sikerült, a világ viszont nem változott. Három közülük fontosabb a többinél.

Első hiba: az ár elmozdult a keresés és a foglalás között

A keresési találat ajánlat, nem szerződés. A viteldíjakat gyorsítótárazzák, a készlet minden olyan csatornán osztozik, amelyen a szállító értékesít, és a 14:02-kor mutatott összeg néhány perccel később már elavult lehet. A szállító a foglalás létrehozásakor szól, olykor tiszta „a viteldíj megváltozott” válasszal, olykor úgy, hogy egy egyébként sikeres válaszban csendben más végösszeget ad vissza.

A második fajta a veszélyes. Ha a kódod beolvassa a visszaigazolást, elmenti a foglalást, és azt az összeget terheli, amit a vásárló látott, a különbség a árrésedből megy, vagy később egy ADM-ből. A szabály tehát egyszerű: hasonlítsd össze a szállító által visszaigazolt végösszeget azzal, amelyet a vásárló elfogadott, minden alkalommal, kódból, mielőtt a fizetést beszedéd.

Hogy mit teszel eltérésnél, az a különbség méretétől és attól függ, ki viseli. Pár fillér kerekítés a pénznemek között olyan tűréshatár, amit egyszer beállítasz. Minden ennél nagyobb új árként tér vissza a vásárlóhoz, kifejezett elfogadás gombbal. Soha ne nyeld le automatikusan, és soha ne terheld automatikusan.

Második hiba: lefoglalva, de jegy nélkül

Az, hogy létezik PNR, nem azt jelenti, hogy létezik jegy. Sok folyamat előbb létrehozza a foglalást, és az e-jegyet külön lépésben állítja ki, a kettő között határidővel. Ha a fizetés sikerül, a kiállítás meg nem, egy vásárló pénzét és egy olyan foglalást tartasz, amely a maga órája szerint jár le.

A hiba ritkán hangos. A kiállító hívás hibát vagy időtúllépést ad, a foglalás pedig olyan állapotban marad, amelyet az adatbázisod „fizetett”-nek nevez, miközben a szállító még „tartott”-at mond. Közben a kiállítási határidő ketyeg, és az ügyfélszolgálati sorodtól eltérően a légitársaság nem vár.

Kezeld külön állapotként, ne a siker vagy a kudarc változataként. Egy foglalásnak legalább ezek kellenek: létrehozva, tartva, fizetés beszedve, kiállítás folyamatban, kiállítva, sikertelen és visszatéríthető. A „fizetés beszedve, kiállítás folyamatban” az az állapot, amely időzítőt kér: ha egy foglalás túl sokáig áll ott, egy feladatnak újra kell olvasnia a foglalást a szállítótól és döntenie, nem várnia, hogy egy ember észrevegye. A döntés olcsó, ha ismered a szállító határidejét, mert az megmondja, meddig próbálkozhatsz biztonságosan, mielőtt vissza kell térítened.

Harmadik hiba: az időtúllépés ismeretlen kimenettel

Ez a csütörtök esti jegy. A kérésed elment, válasz nem jött, a kapcsolat megszakadt vagy az átjáró feladta. A szállító teljesen, részben vagy egyáltalán nem dolgozhatta fel.

A kísértés az újrapróbálás. Ne ismételj vakon egy foglalás-létrehozó hívást, mert a második kísérlet második foglalást szülhet, a duplikátum pedig valódi költség: két tartott hely, talán két kiállított jegy, visszatérítési vita az egyikről.

A biztonságos sorrend: állj meg, olvass, dönts. Állítsd meg az ügyfél felőli folyamatot őszinte állapottal: „megerősítjük a foglalását”. Olvasd ki a szállító oldalát úgy, hogy megkeresed a foglalást a hívás előtt generált hivatkozással (ezért hozod létre előbb a saját kliens-hivatkozásodat, és küldöd el, ha a szállító fogad ilyet). Csak ezután dönts: ha megvan, a tényleges állapotból folytasd; ha nincs meg a szállító saját feldolgozási ablaka után, biztonságos egyszer újrapróbálni.

Ha a szállító nem enged hivatkozás szerint keresni, keress az utas neve, az útvonal és a dátum szerint szűk időablakban, és az egyezést tekintsd megtaláltnak. Csúnya, de sokkal olcsóbb a duplikátumnál.

Egy döntési táblázat, amivel vitatkozhatsz

Amit látszAmit tudszAmit tegyélAmit ne tegyél
A szállító „a viteldíj megváltozott” választ adSemmi nem lett lefoglalvaMutasd az új végösszeget, kérj elfogadást, futtasd újra a létrehozástÚjrafuttatni a régi árral és reménykedni
Siker, de a végösszeg eltér a vásárló által elfogadottólVan foglalás az új áronTartsd vissza a fizetést, kérdezd meg a vásárlót, ha elutasítja, érvénytelenítsBeszedni a régi összeget és lenyelni a különbséget
Fizetés beszedve, a kiállító hívás hibát adVan PNR, a jegy állapota ismeretlenOlvasd újra a foglalást, próbáld a kiállítást a határidőn belül, utána téríts visszaSikertelennek jelölni a foglalást és elfelejteni a PNR-t
Időtúllépés létrehozáskorA kimenet ismeretlenKeress a hivatkozásod alapján, aztán folytasd vagy próbáld újra egyszerAzonnali vak újrapróbálás
Időtúllépés lemondáskorMég mindig felelős lehetsz a szakaszértOlvasd újra az állapotot, mielőtt bármit mondasz a vásárlónak„Lemondva”-t mutatni, mert megtörtént a kattintás

Egy sor, amit vitathatsz: egyes csapatok már az első kiállítási hibánál visszatérítenek, hogy az ügyfél nyugodt maradjon. Kis jegyeknél ez védhető, drágáknál rossz szokás, mert elveszíthetsz egy viteldíjat, amelyet egy perccel később még meg lehetett volna menteni.

Mibe kerül, ha rosszul csinálod

Minden hibának más a számlája. Egy elmulasztott árváltozás minden érintett foglaláson elveszett árrés, gyakran az egyeztetésig észrevétlenül. A lefoglalt, de ki nem állított jegy olyan utas, aki a repülőtéren egy lejárt foglalással és egy kártyaterheléssel jelenik meg, vagyis egyszerre visszaterhelés és hírnévprobléma. A vak újrapróbálás időtúllépés után kettős foglalás, és a légitársaságok vizsgálják a duplikátumokat; ezek mintázata pontosan az, ami ADM-ben végződik.

Ebből semmi nem egzotikus. Ez a szürke vízvezeték-munka, amely a demót elválasztja attól, amit egy hétvégére magára hagyhatsz.

Építsd meg az egyeztető feladatot, mielőtt szükség van rá

Mindhárom hiba ugyanúgy végződik: az adatbázisod és a szállítóé nem ért egyet. Írd meg tehát az összehasonlító feladatot az első incidens előtt, nem utána. Az éjszakai futás a minimum; átmeneti állapotban lévő foglalásokra néhány percenként még jobb. Listázza a tartott, kiállítás alatti vagy ismeretlen állapotban elakadt foglalásokat, megkérdezi a szállítót, mit gondol, és vagy javítja a rekordot, vagy jegyet nyit a bizonyítékokkal.

Őrizz meg minden kérést és választ a foglalási hívásoknál, az időtúllépéseket is, az elküldött hivatkozással együtt. Ha egy vásárló vitatja a terhelést, ez a napló az érved. A késleltetésről szóló vitát is őszintén tartja: lásd mit tehetsz és mit nem az API késleltetésével, hogy az időtúllépések miért az élet részei, nem kiirtandó hibák.

Ha még azon dolgozol, hogyan kösd be magát a szállítói kapcsolatot, a repülőjegy-foglalási API integráció bemutatója a hívások sorrendjét tárgyalja, amelyet ez a cikk feltételez. És ha beszélnél arról, hogyan képeződnek le ezek az állapotok a repülő- és szállás-API-jainkra, a hozzáférés beszélgetéssel indul: nézd meg a travel API oldalt.

Tekravel Szerkesztőség

Utazástechnológiai rovat

A Tekravel utazástechnológiai rovata a szakmának ír: irodatulajdonosoknak, konszolidátoroknak és az őket integráló fejlesztőknek. Minden cikket a leírt platformon ellenőrzünk a megjelenés előtt.