Varausmoottorin API:n virheenkäsittely: kolme virhettä, jotka maksavat

Tukipyyntö saapuu torstai-iltana. Asiakas maksoi, sivu pyöri ja näytti sitten yleisen virheen. Kortilta on veloitettu. Lokissasi näkyy POST toimittajalle, joka ei koskaan saanut vastausta. Pitikö lentoyhtiö paikkaa? Kukaan ei osaa sanoa, ja asiakas odottaa. Hyvä varausmoottorin API:n virheenkäsittely on lähinnä työtä sen eteen, ettet koskaan joudu tähän tilanteeseen, tai ainakin sen eteen, että tiedät tarkalleen, mitä tehdä, kun joudut.
Useimmat integraatio-oppaat kohtelevat virheitä tilakoodien luettelona. Varauksissa koodit ovat helppo osa. Rahaa maksavat muutamat tilanteet, joissa pyyntö näyttää epäonnistuneen mutta maailma silti muuttui, tai näyttää onnistuneen mutta maailma ei muuttunut. Kolme niistä on tärkeämpiä kuin muut.
Virhe yksi: hinta liikkui haun ja varauksen välillä
Hakutulos on tarjous, ei sopimus. Hinnat ovat välimuistissa, saatavuus jaetaan kaikkien kanavien kesken, joiden kautta toimittaja myy, ja klo 14.02 näyttämäsi luku voi olla vanhentunut muutamaa minuuttia myöhemmin. Toimittaja kertoo asiasta varauksen luontivaiheessa, joskus selkeällä «hinta muuttui» -vastauksella, joskus palauttamalla hiljaa eri loppusumman muuten onnistuneessa vastauksessa.
Jälkimmäinen on vaarallinen. Jos koodisi lukee vahvistuksen, tallentaa varauksen ja veloittaa asiakkaalta nähdyn summan, erotus maksetaan katteestasi tai myöhemmin ADM:stä. Sääntö on siksi yksinkertainen: vertaa toimittajan vahvistamaa loppusummaa asiakkaan hyväksymään loppusummaan joka kerta, koodissa, ennen kuin otat maksun.
Mitä teet, kun ne eroavat, riippuu eron koosta ja siitä, kuka sen kantaa. Muutaman sentin pyöristys valuuttojen välillä on toleranssi, jonka asetat kerran. Kaikki suurempi palaa asiakkaalle uutena hintana ja selkeänä hyväksy-painikkeena. Älä koskaan absorboi sitä automaattisesti äläkä koskaan veloita sitä automaattisesti.
Virhe kaksi: varattu, mutta ei lipputtu
PNR:n olemassaolo ei ole sama asia kuin lipun olemassaolo. Monet kulut luovat varauksen ensin ja antavat sähköisen lipun erillisessä vaiheessa, jonkin aikarajan päässä. Jos maksu onnistuu ja lipunanto epäonnistuu, sinulla on asiakkaan rahat ja varaus, joka vanhenee omalla kellollaan.
Virhe on harvoin äänekäs. Lipunantokutsu palauttaa virheen tai aikakatkaisun, ja varaus jää tilaan, jota tietokantasi sanoo «maksetuksi», vaikka toimittaja sanoo yhä «pidossa». Samaan aikaan lipunannon aikaraja tikittää, eikä lentoyhtiö toisin kuin tukijonosi odota.
Käsittele se omana tilanaan, älä onnistumisen tai epäonnistumisen muunnelmana. Varauksella pitää olla vähintään nämä tilat: luotu, pidossa, maksu otettu, lipun anto käynnissä, lipputtu, epäonnistunut ja hyvitettävä. Tila «maksu otettu, lipun anto käynnissä» tarvitsee ajastimen: kun varaus on ollut siinä liian kauan, työn pitää lukea varaus uudelleen toimittajalta ja ratkaista asia, ei odottaa, että ihminen huomaa. Päätös on halpa, kun tunnet toimittajan aikarajan, sillä se kertoo, kuinka kauan voit turvallisesti yrittää uudelleen ennen kuin sinun on hyvitettävä.
Virhe kolme: aikakatkaisu, jonka lopputulos on tuntematon
Tämä on torstai-illan tukipyyntö. Pyyntösi lähti, vastausta ei tullut, yhteys kuoli tai yhdyskäytävä luovutti. Toimittaja on saattanut käsitellä sen kokonaan, osittain tai ei lainkaan.
Houkutus on yrittää uudelleen. Älä toista varauksenluontikutsua sokkona, sillä toinen yritys voi tuottaa toisen varauksen, ja kaksoiskappale on todellinen kustannus: kaksi paikkaa pidossa, ehkä kaksi annettua lippua, hyvitysriita toisesta.
Turvallinen järjestys on: pysähdy, lue, päätä. Pysäytä asiakkaan näkymä rehellisellä tilalla «vahvistamme varaustasi». Lue toimittajan puoli hakemalla varaus viitteellä, jonka loit ennen kutsua (siksi luot oman asiakasviitteesi ensin ja lähetät sen mukana, jos toimittaja sen hyväksyy). Vasta sitten päätä: löytyi tarkoittaa jatkamista todellisesta tilasta; ei löytynyt toimittajan oman käsittelyikkunan jälkeen tarkoittaa, että yksi uusi yritys on turvallinen.
Jos toimittaja ei salli hakua viitteelläsi, hae matkustajan nimellä, reitillä ja päivällä kapealla aikaikkunalla ja pidä osumaa löydettynä. Rumaa, mutta paljon halvempaa kuin kaksoiskappale.
Päätöstaulukko, josta saat olla eri mieltä
| Mitä näet | Mitä tiedät | Mitä tehdä | Mitä ei saa tehdä |
|---|---|---|---|
| Toimittaja vastaa, että hinta muuttui | Mitään ei varattu | Näytä uusi loppusumma, pyydä hyväksyntä, aja luonti uudelleen | Ajaa uudelleen vanhalla hinnalla ja toivoa |
| Onnistui, mutta loppusumma poikkeaa asiakkaan hyväksymästä | Varaus on olemassa uudella hinnalla | Pidä maksu, kysy asiakkaalta, mitätöi varaus jos hän kieltäytyy | Veloittaa vanha summa ja niellä erotus |
| Maksu otettu, lipunantokutsu antaa virheen | PNR on olemassa, lipun tila tuntematon | Lue varaus uudelleen, yritä lipunantoa aikarajan sisällä, hyvitä sen jälkeen | Merkitä varaus epäonnistuneeksi ja unohtaa PNR |
| Aikakatkaisu luonnissa | Lopputulos tuntematon | Hae viitteelläsi, sitten jatka tai yritä kerran uudelleen | Välitön sokea uusintayritys |
| Aikakatkaisu peruutuksessa | Saatat yhä vastata segmentistä | Lue tila uudelleen ennen kuin kerrot asiakkaalle mitään | Näyttää «peruttu», koska klikkaus tapahtui |
Yksi rivi, jonka saatat kiistää: jotkin tiimit hyvittävät jo ensimmäisestä lipunantovirheestä pitääkseen asiakkaan rauhallisena. Pienissä lipuissa se on puolustettavissa, kalliissa huono tapa, koska voit menettää hinnan, joka olisi voitu pelastaa minuuttia myöhemmin.
Mitä virhe maksaa
Jokaisella virheellä on oma laskunsa. Huomaamatta jäänyt hinnanmuutos on katetta, joka katoaa jokaisesta varauksesta, johon se osuu, usein huomaamatta täsmäytykseen asti. Varattu mutta ei lipputtu tarkoittaa asiakasta, joka saapuu lentokentälle vanhentuneen varauksen ja korttiveloituksen kanssa, eli sekä takaisinveloituksen että maineongelman. Sokea uusintayritys aikakatkaisun jälkeen on kaksoisvaraus, ja lentoyhtiöt auditoivat kaksoiskappaleita; niiden toistuva kuvio päätyy juuri ADM:ään.
Mikään tästä ei ole eksoottista. Se on näyttämätöntä putkitusta, joka erottaa demon sellaisesta, minkä voi jättää pyörimään viikonlopuksi.
Rakenna täsmäytysajo ennen kuin tarvitset sitä
Kaikki kolme virhettä päättyvät samoin: tietokantasi ja toimittajan ovat eri mieltä. Kirjoita siis ajo, joka vertaa niitä, ennen ensimmäistä välikohtausta, ei sen jälkeen. Yöllinen ajo on vähimmäinen; muutaman minuutin välein kaikelle siirtymätilassa olevalle on parempi. Se listaa varaukset, jotka ovat jumissa tilassa pidossa, lipun anto käynnissä tai tuntematon, kysyy toimittajalta, mitä tämä ajattelee, ja joko korjaa tietueen tai avaa tiketin todisteet liitettynä.
Säilytä jokainen varauskutsun pyyntö ja vastaus, aikakatkaisut mukaan lukien, yhdessä lähettämäsi viitteen kanssa. Kun asiakas kiistää veloituksen, tuo loki on argumenttisi. Se pitää myös viivekeskustelun rehellisenä: katso mitä API:n viiveelle voi ja ei voi tehdä, miksi aikakatkaisut ovat elämän tosiasia eikä hävitettävä vika.
Jos vielä päätät, miten itse toimittajayhteys kytketään, opas lentovarausten API-integraatio käy läpi kutsujen järjestyksen, jonka tämä artikkeli olettaa. Ja jos haluat jutella siitä, miten nämä tilat vastaavat lento- ja hotelli-API:itamme, pääsy alkaa keskustelulla: katso travel-API-sivu.