API cen lotów: dlaczego ta liczba nie jest jeszcze taryfą

Demo działa. Programista podłącza API cen lotów do kalendarza najtańszych dni na podróż, siatka wypełnia się liczbami i wszyscy na sali są zadowoleni. Potem pierwszy prawdziwy klient wybiera datę, widzi na stronie wyników niższą kwotę niż na stronie płatności i pisze do obsługi ze zrzutem ekranu. Nic się nie zepsuło. API zrobiło dokładnie to, o co je poproszono: odpowiedziało na pytanie o cenę, a serwis potraktował odpowiedź jak obietnicę.
Cena to oferta z krótką pamięcią
Taryfa linii lotniczej nie jest stałą etykietą przyczepioną do fotela. To klasa, która otwiera się i zamyka w miarę sprzedaży miejsc, a przypisana do niej liczba zmienia się wraz ze składem pasażerów, dokładnymi lotami, opłatami lotniskowymi i walutą, w której podano wycenę. Odpowiedź z ceną to migawka zrobiona w jednej chwili dla jednego zestawu danych. Potraktuj ją jak fakt o przeszłości, a zbudujesz właściwą rzecz; potraktuj jak fakt o teraźniejszości, a miesiąc spędzisz na zwrotach.
Dla programisty użyteczne pytanie nigdy więc nie brzmi tylko: ile wynosi cena. Brzmi: jakiego rodzaju to cena, jak jest stara i co zrobi system, jeśli okaże się błędna.
Trzy liczby, które nazywa się ceną
Większość dostawców zwraca wszystkie trzy gdzieś w dokumentacji, często pod tą samą nazwą pola. W swoim modelu danych rozdziel je od pierwszego dnia.
| Stan | Skąd pochodzi | Jak świeża | Czy można sprzedać? | Co pokazać |
|---|---|---|---|---|
| Cena orientacyjna | Wyszukiwanie z pamięci podręcznej lub zagregowane, zbudowane dla szybkości i zasięgu | Możliwe, że nieaktualna i nieliczona dla Twoich pasażerów | Nie | Sformułowanie „od” i informacja, że może się zmienić |
| Wyceniona oferta | Zapytanie na żywo o dokładną trasę, typy pasażerów i taryfę | Świeża w chwili wywołania, z terminem ważności lub sygnałem do ponownej wyceny | Tak, do wygaśnięcia | Sumę, wyszczególnione podatki, warunki taryfy |
| Kwota wystawiona | To, co linia lub system wystawiający faktycznie obciążył przy zamówieniu | Ostateczna | Już sprzedane | Potwierdzenie; uzgodnij je z ofertą |
Cena orientacyjna umożliwia kalendarze i plakietki „najtaniej od” i to dobra rzecz do zbudowania. Po prostu nie jest tym samym obiektem co drugi wiersz. Błąd polega na jednym polu o nazwie price, do którego wpadają wszystkie trzy.
W praktyce oznacza to trzy osobne typy lub tabele w kodzie, a nie jeden z flagą. Cena orientacyjna może się nieznacznie mylić, bo to tylko zachęta do kliknięcia. Wyceniona oferta to zobowiązanie, które za chwilę zaciągasz w swoim imieniu, więc zapisuje się ją z czasem pobrania, danymi wejściowymi, które ją wytworzyły, i identyfikatorem, o który dostawca poprosi przy zamówieniu. Kwota wystawiona to księgowość. Gdy obsługa pyta, dlaczego klient zapłacił inną kwotę niż w mailu, odpowiedź leży w różnicy między wierszami, a tę różnicę odczytasz tylko wtedy, gdy zachowałeś wszystkie trzy.
Co musi zawierać odpowiedź z ceną
Sama liczba nie wystarczy, by zbudować na niej proces płatności. Czytając przykładową odpowiedź dostawcy, szukaj poniższego i bądź podejrzliwy wobec wszystkiego, co przychodzi jako wolny tekst.
- Waluta podana w odpowiedzi, a nie zakładana z Twojego konta.
- Taryfa bazowa i podatki osobno, aby pokazać zestawienie i by zmiana podatku nie wyglądała na zmianę taryfy.
- Typy pasażerów, dla których policzono cenę. Cena dorosłego razy trzy to nie taryfa rodzinna.
- Warunki taryfy i bagaż jako dane ustrukturyzowane, bo to one rozstrzygają, czy tania opcja jest naprawdę tańsza dla klienta.
- Termin ważności lub sygnał ponownej wyceny: znacznik czasu albo wyraźna informacja, że przed zamówieniem trzeba wycenić ponownie.
Ten ostatni punkt pomijają najczęściej. Jeśli nic w odpowiedzi nie mówi, jak długo żyje oferta, zgadujesz, a zgadywanie odbywa się na produkcji.
Wyceniaj ponownie przed zamówieniem, nie po
Najbezpieczniejszy rytm zawiera regułę. Wyszukuj, żeby przeglądać. Gdy klient wybierze trasę, poproś o wycenioną ofertę na żywo dokładnie dla tej trasy i tych pasażerów. Pokaż klientowi tę sumę. Dopiero wtedy utwórz zamówienie. Jeśli cena na żywo różni się od tej na stronie wyników, powiedz to klientowi przed płatnością, prostymi słowami, a nie po niej.
Pomiń środkowy krok, a odziedziczysz różnicę. Albo obciążysz więcej, niż klient widział, i stracisz sprzedaż na stronie płatności, albo uszanujesz niższą kwotę i różnica pójdzie z Twojej marży. Mała agencja może to wchłonąć kilka razy; nie może tego wchłaniać jako założenia projektowego.
Zapytaj o to na piśmie przed integracją
Dokumentacja opisuje szczęśliwą ścieżkę. Zachowanie, które kosztuje, kryje się w odpowiedziach na krótką listę pytań, i lepiej mieć je w mailu niż w rozmowie telefonicznej.
- Czy cena w odpowiedzi wyszukiwania jest na żywo, czy z pamięci podręcznej, i czy mówi o tym sama odpowiedź?
- Czy istnieje osobne wywołanie wyceny dla dokładnej trasy i czy jest wymagane przed zamówieniem?
- Co dzieje się przy zamówieniu, gdy cena się zmieniła: odmowa, nowa cena w odpowiedzi, czy cichy bilet po nowej kwocie?
- Jak wyszczególniono podatki i dopłaty przewoźnika i czy mogą się zmienić między wyceną a wystawieniem?
- W jakiej walucie liczona jest cena i gdzie następuje przeliczenie, jeśli klient widzi inną?
- Jak długo wyceniona oferta pozostaje ważna i skąd będziesz o tym wiedzieć?
Dostawca, który odpowiada precyzyjnie, myślał o procesie płatności. Ten, który mówi „zawsze jest aktualne”, nie powiedział nic, co dałoby się sprawdzić. Jeśli nie możesz sam przetestować zachowania, to powód, by spojrzeć inaczej na cały stos, zanim zaczniesz budować wokół niego.
Ile kosztuje pomyłka
Rzadko zawodzi głośno. Zawodzi jako niewielki spadek na etapie płatności, którego nikt nie przypisuje cenie, jako zgłoszenia zaczynające się od „cena się zmieniła”, jako klient, który zaufał stronie wyników, a teraz już nie. Pracownicy w końcu ręcznie potwierdzają taryfy przed wystawieniem. Ktoś w końcu proponuje regułę zaokrąglającą ceny w górę dla bezpieczeństwa, i wtedy serwis jest drogi na jedynym ekranie, na którym ludzie porównują. Każde z tych zjawisk to podatek od decyzji, którą na początku tanio było podjąć dobrze.
Gdzie jest ta platforma
Platforma udostępnia API lotów i hoteli, aktywowane dla każdego tenanta. Dostęp zaczyna się od rozmowy, a nie od klucza samoobsługowego, więc nie ma formularza, który wydaje token i tabelę limitów. Ta strona nie publikuje opóźnień, pokrycia ani liczby taryf, bo liczby, której nie możemy pokazać, jak sprawdzić, nie warto drukować. Możesz za to przynieść powyższe pytania do tej rozmowy i poprosić o odpowiedź dla wycenionej oferty, nie tylko dla wyszukiwania. Jeśli jesteś na tym etapie, zacznij od strony o API podróży.