Vai al contenuto
Blog

Un'API per i prezzi dei voli: perché il numero non è ancora una tariffa

Redazione Tekravel
Scritto con l'aiuto dell'IA

La demo funziona. Uno sviluppatore collega un'API per i prezzi dei voli a un calendario dei giorni più economici, la griglia si riempie di numeri e tutti in sala sono soddisfatti. Poi il primo cliente vero sceglie una data, vede nella pagina dei risultati una cifra più bassa di quella nella pagina di pagamento e scrive all'assistenza con uno screenshot. Nulla è rotto. L'API ha fatto esattamente ciò che le era stato chiesto: ha risposto a una domanda sul prezzo, e il sito ha trattato la risposta come una promessa.

Un prezzo è un'offerta con la memoria corta

La tariffa di una compagnia aerea non è un'etichetta fissa su un posto. È una classe che si apre e si chiude man mano che i posti si vendono, e il numero collegato cambia con la composizione dei passeggeri, i voli esatti, le tasse degli aeroporti coinvolti e la valuta in cui è espressa la quotazione. La risposta di prezzo è un'istantanea scattata in un momento preciso, per un insieme preciso di dati. Trattala come un fatto sul passato e costruirai la cosa giusta; trattala come un fatto sul presente e passerai un mese a gestire rimborsi.

Per uno sviluppatore la domanda utile non è mai soltanto quale sia il prezzo. È di che tipo di prezzo si tratti, quanto sia vecchio e che cosa farà il sistema se si rivela sbagliato.

Tre numeri che si chiamano tutti prezzo

La maggior parte dei fornitori restituisce tutti e tre questi valori da qualche parte nella documentazione, spesso con lo stesso nome di campo. Tienili separati nel tuo modello dati fin dal primo giorno.

StatoDa dove vieneQuanto è frescoPuoi venderlo?Cosa mostrare
Prezzo di navigazioneRicerca in cache o aggregata, pensata per velocità e ampiezzaForse obsoleto e non calcolato per i tuoi passeggeriNoDicitura «da», con l'avviso che può cambiare
Offerta prezzataRichiesta live per l'itinerario esatto, i tipi di passeggero e la tariffaFresca al momento della chiamata, con scadenza o segnale di ricalcoloSì, fino alla scadenzaIl totale, tasse dettagliate, regole tariffarie
Importo emessoCiò che la compagnia o il sistema di emissione ha effettivamente addebitato all'ordineDefinitivoGià vendutoLa ricevuta; da riconciliare con l'offerta

Il prezzo di navigazione è quello che rende possibili i calendari e i badge «a partire da», ed è una cosa legittima da costruire. Semplicemente non è lo stesso oggetto della seconda riga. L'errore è un unico campo chiamato price in cui confluiscono tutti e tre.

In pratica significa tre tipi o tabelle distinti nel codice, non uno solo con un flag. Un prezzo di navigazione può sbagliare in piccolo, perché è solo un invito a cliccare. Un'offerta prezzata è un impegno che stai per assumere a nome tuo, quindi si salva con l'ora in cui è stata ottenuta, i dati che l'hanno prodotta e l'identificativo che il fornitore rivorrà al momento dell'ordine. L'importo emesso è contabilità. Quando l'assistenza chiede perché un cliente ha pagato una cifra diversa da quella dell'email, la risposta sta nello scarto tra le righe, e quello scarto lo leggi solo se hai conservato tutti e tre.

Cosa deve contenere una risposta di prezzo

Un numero nudo non basta per costruirci sopra un checkout. Quando leggi la risposta di esempio di un fornitore, cerca quanto segue e diffida di ciò che arriva come testo libero.

  • La valuta, indicata nella risposta, non presunta dal tuo account.
  • Tariffa base e tasse separate, così puoi mostrare il dettaglio e una variazione delle tasse non sembra una variazione di tariffa.
  • I tipi di passeggero per cui è stato calcolato il prezzo. Il prezzo di un adulto moltiplicato per tre non è una tariffa famiglia.
  • Regole tariffarie e bagaglio come dati strutturati, perché decidono se un'opzione economica lo è davvero per il cliente.
  • Una scadenza o un segnale di ricalcolo: un timestamp, oppure l'indicazione esplicita che devi ricalcolare prima dell'ordine.

L'ultimo punto è quello che tutti saltano. Se nella risposta non c'è nulla che dica quanto dura l'offerta, stai tirando a indovinare, e la scommessa si fa in produzione.

Ricalcola prima dell'ordine, non dopo

Il ritmo più sicuro ha una regola dentro. Cerca per navigare. Quando il cliente sceglie un itinerario, chiedi un'offerta prezzata live per quell'itinerario e quei passeggeri. Mostra al cliente quel totale. Solo allora crea l'ordine. Se il prezzo live differisce da quello nella pagina dei risultati, lo dici al cliente prima del pagamento, con parole semplici, invece che dopo.

Salta il passaggio centrale e ti ritrovi la differenza. O addebiti più di quanto il cliente ha visto e perdi la vendita nella pagina di pagamento, oppure rispetti il numero più basso e lo scarto esce dal tuo margine. Una piccola agenzia può assorbirlo qualche volta; non può assorbirlo come scelta di progetto.

Chiedi queste cose per iscritto prima di integrare

La documentazione descrive il percorso felice. Il comportamento che ti costa denaro sta nelle risposte a un breve elenco di domande, e conviene averle in un'email piuttosto che in una telefonata.

  1. Il prezzo nella risposta di ricerca è live o in cache, ed è indicato nella risposta stessa?
  2. Esiste una chiamata di prezzo separata per l'itinerario esatto ed è obbligatoria prima di un ordine?
  3. Cosa succede all'ordine se il prezzo si è mosso: un rifiuto, un nuovo prezzo nella risposta o un biglietto emesso in silenzio al nuovo importo?
  4. Come sono dettagliate tasse e supplementi del vettore, e possono cambiare tra la quotazione e l'emissione?
  5. In quale valuta viene calcolato il prezzo e dove avviene la conversione se il cliente ne vede un'altra?
  6. Per quanto tempo un'offerta prezzata resta valida e come lo saprai?

Un fornitore che risponde con precisione ha pensato al checkout. Uno che risponde «è sempre aggiornato» non ti ha detto nulla che tu possa verificare. Se non puoi provare tu stesso il comportamento, è un motivo per guardare l'intero stack in modo diverso prima di impegnarti a costruirci attorno.

Quanto costa sbagliare

Raramente fallisce in modo rumoroso. Fallisce come un piccolo calo al passaggio di pagamento che nessuno attribuisce al prezzo, come ticket di assistenza che iniziano con «il prezzo è cambiato», come un cliente che si fidava della pagina dei risultati e ora non più. Il personale finisce per riconfermare le tariffe a mano prima dell'emissione. Prima o poi qualcuno propone una regola che arrotonda i prezzi per eccesso per sicurezza, e il sito diventa caro proprio nella schermata in cui le persone confrontano. Ognuna di queste è una tassa su una decisione che costava poco prendere bene all'inizio.

Dove si colloca questa piattaforma

La piattaforma espone API per voli e hotel, attivate per singolo tenant. L'accesso parte da una conversazione e non da una chiave self-service, quindi non esiste un modulo di iscrizione che consegna un token e una tabella dei limiti. Questa pagina non pubblica latenza, copertura o numero di tariffe, perché un numero che non possiamo mostrarti come verificare non vale la pena di stamparlo. Quello che puoi fare è portare le domande qui sopra in quella conversazione e chiedere di vedere la risposta per un'offerta prezzata, non solo per una ricerca. Se sei a questo punto, la pagina delle API di viaggio è da dove si parte.

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.