API pre ceny letov: prečo zobrazené číslo ešte nie je tarifa

Demo funguje. Vývojár zapojí API pre ceny letov do kalendára najlacnejších dní na cestu, tabuľka sa zaplní číslami a všetci v miestnosti sú spokojní. Potom prvý skutočný zákazník vyberie dátum, na stránke s výsledkami uvidí nižšiu sumu než na stránke platby a napíše podpore so snímkou obrazovky. Nič nie je pokazené. API urobilo presne to, čo sa od neho žiadalo: odpovedalo na otázku o cene, a web túto odpoveď vzal ako sľub.
Cena je ponuka s krátkou pamäťou
Cena leteckého lístka nie je pevná nálepka na sedadle. Je to cenová trieda, ktorá sa otvára a zatvára, ako sa sedadlá predávajú, a suma k nej sa mení s kombináciou cestujúcich, presnými letmi, poplatkami letísk a menou, v ktorej je ponuka vyjadrená. Odpoveď o cene je snímka tohto stavu urobená v jednom okamihu pre jednu sadu vstupov. Ak ju budete brať ako fakt o minulosti, postavíte správnu vec; ak ako fakt o prítomnosti, mesiac strávite vracaním peňazí.
Užitočná otázka pre vývojára preto nikdy nie je len aká je cena. Je to, o aký druh ceny ide, ako je stará a čo systém urobí, ak sa ukáže ako nesprávna.
Tri čísla, ktorým všetci hovoria cena
Väčšina poskytovateľov vracia všetky tri niekde v dokumentácii, často pod rovnakým názvom poľa. Vo vlastnom dátovom modeli ich držte oddelene od prvého dňa.
| Stav | Odkiaľ pochádza | Ako je aktuálna | Dá sa predať? | Čo zobraziť |
|---|---|---|---|---|
| Cena na prehliadanie | Vyhľadávanie z vyrovnávacej pamäte alebo agregované, stavané na rýchlosť a šírku | Možno zastaraná a nevypočítaná pre vašich cestujúcich | Nie | Slovo „od” a poznámka, že sa môže zmeniť |
| Ocenená ponuka | Živý dopyt na presný itinerár, typy cestujúcich a tarifu | Čerstvá v čase volania, s expiráciou alebo signálom na prepočet | Áno, do vypršania | Celková suma, položkové dane, pravidlá tarify |
| Suma vystavenej letenky | To, čo letecká spoločnosť alebo vystavujúci systém skutočne účtoval pri objednávke | Konečná | Už predané | Doklad; zosúladiť s ponukou |
Cena na prehliadanie umožňuje kalendáre a štítky „najlacnejšie od” a je to úplne dobrá vec na vytvorenie. Len nie je to ten istý objekt ako druhý riadok. Chybou je jediné pole price, do ktorého tečú všetky tri.
V praxi to znamená tri samostatné typy alebo tabuľky v kóde, nie jeden s príznakom. Cena na prehliadanie sa smie v drobnostiach mýliť, lebo je to len výzva ku kliknutiu. Ocenená ponuka je záväzok, ktorý beriete na seba pod vlastným menom, takže sa ukladá s časom získania, vstupmi, z ktorých vznikla, a identifikátorom, ktorý poskytovateľ bude pri objednávke chcieť späť. Suma vystavenej letenky je účtovníctvo. Keď sa podpora spýta, prečo zákazník zaplatil iné číslo než v e-maile, odpoveď leží v rozdiele medzi riadkami a ten prečítate, len ak ste si uchovali všetky tri.
Čo musí odpoveď o cene niesť
Na holom čísle sa pokladňa postaviť nedá. Keď čítate ukážkovú odpoveď poskytovateľa, hľadajte nasledovné a buďte podozrievaví voči všetkému, čo prichádza ako voľný text.
- Mena, uvedená v odpovedi, nie predpokladaná z vášho účtu.
- Základná tarifa a dane osobitne, aby ste mohli ukázať rozpis a aby zmena dane nevyzerala ako zmena tarify.
- Typy cestujúcich, pre ktoré sa cena počítala. Cena pre dospelého krát tri nie je rodinná tarifa.
- Pravidlá tarify a batožina ako štruktúrované dáta, lebo od nich závisí, či je lacnejšia možnosť pre vášho zákazníka skutočne lacnejšia.
- Expirácia alebo signál na prepočet: časová pečiatka alebo výslovné tvrdenie, že pred objednávkou musíte cenu prepočítať.
Poslednú položku ľudia vynechávajú. Ak vám nič v odpovedi nehovorí, ako dlho ponuka žije, hádate, a hádanie sa deje v produkcii.
Prepočítať pred objednávkou, nie po nej
Najbezpečnejší rytmus má v sebe pravidlo. Vyhľadávajte na prehliadanie. Keď zákazník vyberie itinerár, vyžiadajte si živú ocenenú ponuku presne pre ten itinerár a týchto cestujúcich. Ukážte zákazníkovi túto celkovú sumu. Až potom vytvorte objednávku. Ak sa živá cena líši od tej na stránke výsledkov, povedzte to zákazníkovi pred platbou, jasnými slovami, nie až po nej.
Ak preskočíte prostredný krok, zdedíte rozdiel. Buď účtujete viac, než zákazník videl, a prídete o predaj na stránke platby, alebo rešpektujete nižšie číslo a rozdiel ide z vašej marže. Malá agentúra to dokáže pár ráz absorbovať, no nie ako návrh systému.
Opýtajte sa na toto písomne ešte pred integráciou
Dokumentácia popisuje šťastnú cestu. Správanie, ktoré vás stojí peniaze, je v odpovediach na krátky zoznam otázok a tie odpovede je lepšie mať v e-maile než v hovore.
- Je cena v odpovedi vyhľadávania živá alebo z vyrovnávacej pamäte a je to uvedené priamo v odpovedi?
- Existuje samostatné volanie na ocenenie presného itinerára a je pred objednávkou povinné?
- Čo sa stane pri objednávke, ak sa cena pohla: odmietnutie, nová cena v odpovedi alebo tichá letenka za novú sumu?
- Ako sú dane a príplatky dopravcu rozpísané a môžu sa medzi oceňovaním a vystavením zmeniť?
- V akej mene sa cena počíta a kde prebieha prepočet, ak zákazník vidí inú?
- Ako dlho zostáva ocenená ponuka platná a ako sa to dozviete?
Poskytovateľ, ktorý odpovie presne, o pokladni premýšľal. Ten, kto odpovie „je vždy aktuálne”, vám nepovedal nič, čo by ste mohli otestovať. Ak správanie nemôžete vyskúšať sami, je to dôvod, prečo sa pred rozhodnutím stavať okolo neho pozrieť na celý systém inak.
Koľko stojí chyba
Zriedka zlyhá hlasno. Zlyhá ako malý pokles v kroku platby, ktorý nikto nepripíše cene, ako tikety podpory začínajúce „cena sa zmenila”, ako zákazník, ktorý veril stránke výsledkov a teraz už neverí. Zamestnanci pred vystavením ručne znova potvrdzujú tarify. Niekto nakoniec navrhne pravidlo, ktoré ceny pre istotu zaokrúhľuje nahor, a stránka je drahá na jedinej obrazovke, kde ľudia porovnávajú. Každé z toho je daň z rozhodnutia, ktoré bolo na začiatku lacné urobiť správne.
Kde sa nachádza táto platforma
Platforma ponúka API pre lety a hotely, aktivované pre každého nájomcu. Prístup sa začína rozhovorom, nie samoobslužným kľúčom, takže neexistuje registračný formulár, ktorý vám dá token a tabuľku limitov. Táto stránka nezverejňuje latenciu, pokrytie ani počty tarify, pretože číslo, o ktorom vám nevieme ukázať, ako ho otestovať, nestojí za vytlačenie. Môžete si priniesť uvedené otázky na ten rozhovor a požiadať o odpoveď pre ocenenú ponuku, nielen pre vyhľadávanie. Ak ste v tejto fáze, stránka o cestovných API je miesto, kde to začína.