Web Services

Questa sezione deve essere compilata quando il Tour Operator intende vendere al Cliente tramite XML.

Se il Cliente acquista esclusivamente attraverso l'interfaccia web (sito web), selezionare No e procedere con la configurazione delle altre schede.

Se il Cliente acquista tramite XML, impostare il Livello 2 e configurare i seguenti parametri:

  • Kalima XML - Blocco prenotazioni sotto data: consente al Tour Operator di decidere se bloccare la prenotazione una volta superata la deadline e di definire il messaggio di errore da restituire

  • Comportamento dei remarks consente al Tour Operator di decidere come filtrare il remark testuale inserito dal cliente:

    • Predefinito: il remark può essere bloccante a seconda di quello che stabilisce il Cliente. IMPORTANTE: per i clienti "Synchronuous", che sono la maggior parte, falliranno automaticamente tutti i booking con il remark bloccante (si consiglia quindi di scegliere le seguenti due opzioni)
    • Non blocca la prenotazione e visibilità di default: il remark non è bloccante e mantiene la visibilità che aveva, pertanto nel caso di remark inserito dal cliente, NON verrà mostrato al fornitore (lo vedrà solo il Tour Operator)
    • Non blocca la prenotazione e visibile al fornitore: il remark non è bloccante e in più verrà inoltrato al fornitore via API (solo se l'API del fornitore supporta i remark)
  • Durata della cache in disponibilità (in secondi): se impostato, questo valore sovrascrive la durata predefinita della cache utilizzata per le richieste di disponibilità dei clienti, sia per le ricerche di città/multi-ID che per quelle di un singolo hotel. I valori più bassi danno luogo a dati di disponibilità più aggiornati

  • Soglia di timeout per la risposta del fornitore (in secondi) - MULTI ID (IMPORTANTE, da concordare con il cliente) consente al Tour Operator di specificare per quanti secondi il sistema deve attendere la risposta del Fornitore quando il Cliente effettua una ricerca su più ID, ad esempio per una specifica città o area.

    Il valore impostato definisce il tempo massimo a disposizione del Fornitore per restituire i risultati della ricerca. Se la risposta non viene ricevuta entro il tempo configurato, la richiesta viene considerata in timeout e il sistema interrompe l'attesa della risposta.

    L'impostazione di un valore adeguato permette di gestire correttamente i tempi di risposta nelle ricerche multi-ID, evitando attese eccessivamente lunghe e garantendo una gestione più efficiente delle richieste

  • Soglia di timeout per la risposta del fornitore (in secondi) - SINGLE ID IMPORTANTE, da concordare con il cliente. Consente al Tour Operator di specificare per quanti secondi il sistema deve attendere la risposta del Fornitore quando il Cliente effettua una ricerca su un singolo ID, ad esempio per uno specifico hotel.

    Il valore impostato definisce il tempo massimo a disposizione del Fornitore per restituire i risultati della ricerca. Se la risposta non viene ricevuta entro il tempo configurato, la richiesta viene considerata in timeout e il sistema interrompe l'attesa della risposta.

    L'impostazione di un valore adeguato permette di gestire correttamente i tempi di risposta nelle ricerche SINGLE ID, evitando attese eccessivamente lunghe e garantendo una gestione più efficiente delle richieste.

  • Usa le valute del fornitore: se selezionato, il sistema utilizza la valuta del Fornitore invece di quella del Cliente. Ciò consente al Tour Operator di rivendere al Cliente utilizzando la stessa valuta in cui acquista dal Fornitore
  • Landing url (solo per il B2C): il Tour Operator può scegliere un url specifico dove il Cliente atterrerà per finalizzare la prenotazione.
  • Blocca valuta dinamica: se selezionata, questa opzione ignora la valuta richiesta via XML

  • Valuta forzata: se selezionata, questa opzione sovrascrive la valuta scelta dall'utente per la richiesta. È utile quando si vuole mantenere invariata la valuta di navigazione del cliente sull'interfaccia, ma imporre una valuta diversa tramite XML. La valuta rimane coerente in tutto il flusso di prenotazione: se la disponibilità viene restituita in una valuta specifica, la prenotazione verrà confermata utilizzando quella stessa valuta. Solo nel caso in cui il cliente non trasmetta nessuna valuta via xml, il sistema considera la valuta impostata in Valuta di navigazione nel tab Configurazione

  • Nazionalità pax nella prenotazione hotel solo per richieste ricevute via API, permette al Tour Operator di definire il comportamento della nazionalità del passeggero (pax nationality) scegliendo tra
    • Obbligatorio: se la nazionalità del passeggero non è fornita, il sistema restituisce un errore
    • Opzionale (senza default): se la nazionalità del passeggero non è fornita, il sistema prende eventualmente i valori di default delle plugin
    • Opzionale (con default): se la nazionalità del passeggero è fornita, il sistema la utilizza; se non fornita applica un default configurabile
  • Sostituisci il tipo stanza se impreciso: se selezionato e se nel contratto è presente l'annotazione SYS_INACCURATE_BEDDING_TYPE, il sistema sostituisce il tipo di camera in base a una logica predefinita. Ad esempio, DBL/TWN viene interpretato come due passeggeri, mentre SGL/TSU viene interpretato come un passeggero

  • Timeout per la conferma delle prenotazioni: se richiesto, da concordare con il Cliente. Questa opzione annulla automaticamente la prenotazione se l'intervallo di tempo tra la creazione e la conferma supera il valore di timeout definito (in secondi). Se abilitata senza specificare un valore, il sistema utilizzerà il timeout predefinito di 60 secondi.

    Si raccomanda di evitare di offrire prenotazioni non rimborsabili ai clienti con timeout sulla conferma, selezionando Excludenonref nella scheda Limitation del profilo Cliente

  • Mostra fornitore: se selezionata, questa opzione restituisce un tag con il nome del fornitore nei messaggi XML
  • Mostra prezzi netti: se selezionata, questa opzione restituisce i prezzi netti (netto del Tour Operator) nelle risposte di disponibilità e prenotazione/tracciabilità
  • Mostra Channel Manager: se attivata, questa opzione restituisce un attributo “channel” nel tag agreement della risposta di disponibilità, indicando l'ID del Channel Manager collegato al contratto

  • Custom hotel inventory: possibilità di caricare un file txt o csv con un insieme specifico di hotel per cliente. Il file deve essere composto da un solo ID hotel per riga e nessun' altra informazione. Una volta caricato il file, appariranno due icone la prima permette di scaricare il file appena caricato, la seconda permette di scaricare l'inventario basato sui fornitori attivi per quel cliente (Amministrazione > Clienti > Blocchi plugin).

    Si rende noto che le modifiche successive al caricamento del file avverranno durante la notte.

  • Indirizzi IP autorizzati: IMPORTANTE, da concordare con il Cliente. Consente di specificare un elenco di IP (o classi di IP) che sono autorizzati a effettuare prenotazioni. Tutti gli IP non presenti nell'elenco saranno bloccati. Non è raccomandata la selezione su "Autorizza QUALSIASI indirizzo IP" in quanto il filtraggio sarà disabilitato
  • Shadow Limits: questa selezione è relativo al messaggio mostrato ai clienti durante la ricerca di disponibilità se raggiungono il limite di traffico
    • Se attivato: il messaggio mostrerà un generico “Nessuna disponibilità”
    • Se non attivato: il messaggio sarà l'errore di raggiungimento del limite di traffico

I seguenti valori sono da concordare col proprio KAM

  • Availability Multi: limite di query multi hotel per minuto (QPM)
  • Availability Single: limite di query su single hotel per minuto (QPM)
  • Evaluate: limite di query Evaluate (Prebook) su singola tariffa per minuto (QPM)