Vai al contenuto
Blog

API per prenotare hotel e voli: un viaggio, due prenotazioni

Redazione Tekravel
Scritto con l'aiuto dell'IA

Il ticket dice: «aggiungere gli hotel al flusso dei voli, un solo checkout, un solo totale». È una richiesta ragionevole da parte di un product manager e sembra il lavoro di una giornata, perché la ricerca voli e la pagina di pagamento ci sono già. Tre settimane dopo il team discute di cosa debba succedere quando la compagnia aerea conferma e l'hotel no. Una API per prenotare hotel e voli non è un'integrazione con due tipi di risultato. Sono due integrazioni che condividono un carrello.

Prima il codice lo ammette, meno ne verrà riscritto. Quello che segue è la parte che le guide all'integrazione saltano: in cosa le due metà differiscono, quale impegnare per prima e che cosa deve essere un viaggio nel tuo modello dati.

Le due metà non si comportano allo stesso modo

Entrambe arrivano come JSON con un prezzo e un riferimento, quindi sul filo si somigliano. Non si somigliano in ciò che ti promettono una volta che hai il riferimento.

DomandaVoloHotel
Cosa hai in mano dopo la prenotazioneUna prenotazione (PNR) che non è ancora un bigliettoUna conferma che di solito è già ciò che hai venduto
Quanto vale il prezzoFino a quando la tariffa viene ricalcolata alla prenotazione, e può differire dalla ricercaFino alla scadenza della tariffa, che può cambiare tra disponibilità e prenotazione
Cosa confermaL'emissione, spesso entro un limite di tempoLa conferma del fornitore, a volte istantanea, a volte in sospeso
Come si annullaUn void se preso in tempo, altrimenti un rimborso secondo le regole tariffarie, spesso con penaleUn annullamento secondo la politica della tariffa, gratuito fino a una scadenza su molte tariffe
Cosa cambia l'importo più tardiTariffa, tasse, a volte la valuta della tariffaTasse e costi pagati in struttura, trattamento, la camera effettivamente assegnata

Puoi non essere d'accordo con una riga, perché i fornitori differiscono, ma non con la sua forma: una metà ha una fase di emissione e l'altra una finestra di annullamento, e non coincidono nel tempo. Il lato voli della sequenza lo abbiamo trattato in integrazione API di prenotazione voli e il problema del fornitore lento lato hotel in progettazione del client API di disponibilità hotel. Questo pezzo parte da dove quelli finiscono, nel punto di giunzione.

Quale prenoti per primo?

Nessuno ti dice che è una decisione di progetto, ed è quella che stabilisce quanto costa un errore.

Poniamo che un cliente acquisti un volo e un hotel per le stesse date. Invii una prenotazione e poi l'altra. Possono succedere tre cose: vanno entrambe, una fallisce, oppure una fallisce dopo che l'altra è riuscita. La prima è una buona giornata. Le altre due decidono la tua coda di assistenza.

Se emetti prima il volo e l'hotel poi rifiuta, hai un cliente con un posto per una città e nessuna camera, già addebitato, e il rimborso di un biglietto con penale. Se prenoti prima l'hotel e il volo poi fallisce, hai una camera che spesso puoi annullare gratis, quindi la riparazione costa poco. Anche il rischio opposto è reale, perché una tariffa alberghiera non annullabile è la cosa peggiore da tenere in mano, perciò leggi le condizioni di annullamento della tariffa prima di lasciarla andare per prima.

È una regola pratica, non una legge, e il punto è scegliere l'ordine di proposito. Impegna la metà più facile da annullare prima di quella più difficile, controlla il prezzo di entrambe appena prima che una si impegni e scrivi cosa fai per ciascuno dei tre esiti. I revisori chiedono raramente. I clienti lo scoprono sempre.

Un viaggio, due prenotazioni

La forma che regge è un record di viaggio che possiede due prenotazioni, ciascuna con il proprio riferimento, il proprio stato e le proprie condizioni. Il cliente vede un totale. Il tuo database vede due righe, e il totale è una somma che calcoli tu, non qualcosa che esista presso il fornitore.

Tieni separati i due stati. «Confermato» per l'hotel e «emesso» per il volo non sono lo stesso stato, e una singola colonna di stato che li appiattisce prima o poi scriverà «prenotato» su un viaggio prenotato a metà.

Tieni separate anche le condizioni di modifica, e mostrale. Un totale mostrato nasconde che spostare le date è una modifica gratuita su una metà e un costo sull'altra. Se il tuo front end mostra «cambia date» come un unico pulsante, decidi cosa fa quando può spostarsi solo una metà, prima che sia un cliente a scoprirlo al posto tuo. Lo stesso vale per il ricarico: se lo aggiungi per servizio, come fa la maggior parte dei venditori, il totale del viaggio è due ricarichi, e un rimborso su una metà deve sapere quale ricarico sta restituendo. I soldi sono il punto in cui un viaggio unito diventa costoso, perché le righe si chiudono con tempistiche diverse e il rimborso del volo non arriva quando arriva l'annullamento dell'hotel.

Dove si colloca questa piattaforma

Detto chiaramente: la piattaforma espone API per voli e hotel, e l'accesso parte da una conversazione anziché da una chiave self-service. I servizi si attivano per tenant, quindi un tenant che vende hotel e non tour non si porta dietro la superficie dei tour. Qui non si promette una singola chiamata che prenoti atomicamente entrambe le metà, e non dovresti progettare come se esistesse. Trattale per le due prenotazioni che sono, sotto un viaggio di cui sei proprietario.

Se vuoi vedere le chiamate e le condizioni reali prima di costruirci attorno, parti dalla pagina delle API di viaggio e porta l'ordine in cui intendi prenotare. Se stai ancora decidendo cosa ottieni con l'accesso gratuito, API gratuita per prenotare hotel descrive i tipi di gratuito.

Quanto costa sbagliare

La versione costosa è quella silenziosa. Un cliente ha il biglietto per una città e la camera non c'è più, e la prima notizia è un messaggio di notte, da un aeroporto. Più economico ma ugualmente reale: un checkout che mostra un totale rassicurante e poi, dopo un controllo prezzo, un secondo numero che il cliente non aveva accettato; un rimborso che restituisce il volo e dimentica l'hotel; e uno stato che dice «prenotato» mentre il fornitore dice altro.

Niente di questo richiede una soluzione furba. Richiede che il viaggio sia un oggetto vero, che l'ordine sia una decisione che qualcuno ha scritto e che entrambi i prezzi vengano ricontrollati all'ultimo momento prima che uno dei due si impegni. Costruiscilo una volta e il checkout potrà sembrare semplice come chiedeva il ticket.

Redazione Tekravel

Desk tecnologie per il turismo

Il desk tecnologie per il turismo di Tekravel scrive per gli operatori: titolari di agenzie, consolidatori e gli sviluppatori che li integrano. Ogni articolo viene verificato sulla piattaforma che descrive prima della pubblicazione.