Siirry sisältöön
Blogi

Hotelli- ja lentovarausten API: yksi matka, kaksi varausta

Tekravelin toimitus
Kirjoitettu tekoälyn avulla

Tiketissä lukee: "lisätään hotellit lentopolkuun, yksi checkout, yksi kokonaissumma". Järkevä pyyntö tuotepäälliköltä, ja se kuulostaa päivän työltä, koska lentohaku on jo olemassa ja maksusivukin on. Kolme viikkoa myöhemmin tiimi kiistelee siitä, mitä pitää tapahtua, kun lentoyhtiö vahvistaa ja hotelli ei. Hotelli- ja lentovarausten API ei ole yksi integraatio, jolla on kahdenlaisia tuloksia. Se on kaksi integraatiota, jotka jakavat ostoskorin.

Mitä aiemmin koodi myöntää tämän, sitä vähemmän sitä kirjoitetaan uudelleen. Seuraavaksi tulee osa, jonka integraatio-oppaat ohittavat: miten kaksi puoliskoa eroavat, kumpi sidotaan ensin ja mitä matkan pitää olla tietomallissanne.

Puoliskot eivät käyttäydy samoin

Molemmat palaavat JSONina, jossa on hinta ja viite, joten verkossa ne näyttävät samanlaisilta. Ne eivät ole samanlaisia siinä, mitä ne lupaavat, kun viite on jo kädessä.

KysymysLentoHotelli
Mitä teillä on varauksen jälkeenVaraus (PNR), joka ei vielä ole lippuVahvistus, joka yleensä on jo se, minkä myitte
Kauanko hinta on voimassaKunnes hinta lasketaan uudelleen varaushetkellä, ja se voi poiketa haustaKunnes hinta vanhenee, ja hinta voi muuttua saatavuuden ja varauksen välillä
Mikä sen vahvistaaLipun kirjoittaminen, usein aikarajaa vastaanToimittajan vahvistus, joskus heti, joskus odottava
Miten se perutaanVoid, jos ehditte ajoissa, muuten hyvitys hintasääntöjen mukaan, usein maksua vastaanPeruutus hinnan oman ehdon mukaan, monissa hinnoissa maksutta tiettyyn määräaikaan asti
Mikä muuttaa summaa myöhäänHinta, verot, joskus hinnan valuuttaPaikan päällä maksettavat verot ja maksut, ateriapohja, todellisuudessa annettu huone

Voitte olla eri mieltä jostain rivistä, koska toimittajat eroavat, mutta ette muodosta: toisella puoliskolla on lipunkirjoitusvaihe ja toisella peruutusikkuna, eivätkä ne osu ajallisesti yhteen. Lentopuolen käsittelimme kirjoituksessa lentovarausten API-integraatio ja hitaan toimittajan ongelman hotellipuolella kirjoituksessa hotellien saatavuus-API:n asiakassuunnittelu. Tämä teksti alkaa siitä, mihin ne loppuvat: saumasta.

Kumman varaatte ensin?

Kukaan ei kerro, että tämä on suunnittelupäätös, ja juuri se ratkaisee, mitä virhe maksaa.

Oletetaan, että asiakas ostaa lennon ja hotellin samoille päiville. Lähetätte yhden varauksen ja sitten toisen. Kolme asiaa voi tapahtua: molemmat onnistuvat, toinen epäonnistuu, tai toinen epäonnistuu sen jälkeen, kun toinen on jo onnistunut. Ensimmäinen on hyvä päivä. Kaksi muuta ratkaisevat tukijononne.

Jos kirjoitatte lennon ensin ja hotelli sitten kieltäytyy, teillä on asiakas, jolla on paikka koneessa kaupunkiin eikä huonetta, jolta on jo veloitettu, ja hyvitys lipusta, johon liittyy maksu. Jos varaatte hotellin ensin ja lento sitten epäonnistuu, pidätte huonetta, jonka voi usein perua maksutta, joten korjaus on halpa. Käänteinen riski on myös todellinen, koska hotellihinta, jota ei voi perua, on pahin asia pitää kädessä, joten lukekaa hinnan peruutusehdot ennen kuin päästätte sen ensimmäiseksi.

Tämä on nyrkkisääntö, ei laki, ja pointti on valita järjestys tarkoituksella. Sitokaa helpommin peruttava puolisko ennen vaikeampaa, tarkistakaa molempien hinta juuri ennen kuin kumpikaan sitoutuu, ja kirjoittakaa ylös, mitä teette kussakin kolmesta lopputuloksesta. Katselmoijat kysyvät harvoin. Asiakkaat saavat aina selville.

Yksi matka, kaksi varausta

Kestävä muoto on matkatietue, joka omistaa kaksi varausta, kummallakin oma viite, oma tila ja omat ehdot. Asiakas näkee yhden kokonaissumman. Tietokantanne näkee kaksi riviä, ja kokonaissumma on laskemanne summa, ei jotain, mitä toimittajalla on olemassa.

Pitäkää kaksi tilaa erillään. "Vahvistettu" hotellille ja "kirjoitettu" lennolle eivät ole sama tila, ja yksi tilasarake, joka litistää ne, sanoo ennemmin tai myöhemmin "varattu" puoliksi varatusta matkasta.

Pitäkää erillään myös kaksi muutosehtojen joukkoa, ja näyttäkää ne. Näytetty kokonaissumma kätkee sen, että päivien siirto on toisella puoliskolla maksutonta ja toisella maksullista. Jos front-endinne näyttää "vaihda päivät" yhtenä painikkeena, päättäkää, mitä se tekee, kun vain toinen puolisko voi liikkua, ennen kuin asiakas selvittää sen puolestanne. Sama koskee katetta: jos lisäätte sen palvelukohtaisesti, kuten useimmat myyjät, matkan kokonaissumma on kaksi katetta, ja toisen puoliskon hyvityksen on tiedettävä, minkä katteen se palauttaa. Raha on kohta, jossa yhdistetty matka tulee kalliiksi, koska rivit selvitetään eri aikatauluissa, eikä lennon hyvitys saavu silloin, kun hotellin peruutus saapuu.

Missä tämä alusta on

Suoraan sanottuna: alusta tarjoaa API:t lennoille ja hotelleille, ja pääsy alkaa keskustelulla, ei itsepalveluavaimella. Palvelut kytketään päälle tenant-kohtaisesti, joten tenant, joka myy hotelleja eikä retkiä, ei kanna retkiosuutta mukanaan. Mikään tässä ei lupaa yhtä kutsua, joka varaa molemmat puoliskot atomisesti, eikä teidän pidä suunnitella ikään kuin lupaisi. Käsitelkää niitä kahtena varauksena, joita ne ovat, teidän omistamanne matkan alla.

Jos haluatte nähdä todelliset kutsut ja ehdot ennen kuin rakennatte niiden varaan, aloittakaa matka-API-sivulta ja tuokaa mukananne järjestys, jossa aiotte varata. Jos vielä mietitte, mitä maksuton pääsy antaa, maksuton hotellivarausten API käy läpi maksuttoman eri muodot.

Mitä virhe maksaa

Kallis versio on hiljainen. Asiakkaalla on lippu kaupunkiin ja huone on mennyt, ja ensimmäinen tieto siitä on viesti yöllä lentokentältä. Halvempaa mutta yhä todellista: checkout, joka näyttää yhden rauhoittavan kokonaissumman ja sitten hintatarkistuksen jälkeen toisen luvun, jota asiakas ei hyväksynyt; hyvitys, joka palauttaa lennon ja unohtaa hotellin; ja tila, jossa lukee "varattu", vaikka toimittaja sanoo muuta.

Mikään tästä ei vaadi nokkelaa ratkaisua. Se vaatii, että matka on oikea olio, että järjestys on päätös, jonka joku on kirjoittanut ylös, ja että molemmat hinnat tarkistetaan uudelleen viime hetkellä ennen kuin kumpikaan sitoutuu. Rakentakaa se kerran, niin checkout voi näyttää yhtä yksinkertaiselta kuin tiketti pyysi.

Tekravelin toimitus

Matkailuteknologian osasto

Tekravelin matkailuteknologian osasto kirjoittaa alalle: toimistojen omistajille, konsolidaattoreille ja heitä integroiville kehittäjille. Jokainen juttu tarkistetaan kuvatulla alustalla ennen julkaisua.