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

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.
| Domanda | Volo | Hotel |
|---|---|---|
| Cosa hai in mano dopo la prenotazione | Una prenotazione (PNR) che non è ancora un biglietto | Una conferma che di solito è già ciò che hai venduto |
| Quanto vale il prezzo | Fino a quando la tariffa viene ricalcolata alla prenotazione, e può differire dalla ricerca | Fino alla scadenza della tariffa, che può cambiare tra disponibilità e prenotazione |
| Cosa conferma | L'emissione, spesso entro un limite di tempo | La conferma del fornitore, a volte istantanea, a volte in sospeso |
| Come si annulla | Un void se preso in tempo, altrimenti un rimborso secondo le regole tariffarie, spesso con penale | Un annullamento secondo la politica della tariffa, gratuito fino a una scadenza su molte tariffe |
| Cosa cambia l'importo più tardi | Tariffa, tasse, a volte la valuta della tariffa | Tasse 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.