Fornitore XML

Il Tour Operator può aggiornare le seguenti voci dei fornitori dalle impostazioni di Configurazione > Configurazione Plugin.

  • markup_delta_opaque: è un delta che modifica il markup nel caso di rate opache
  • markup_delta_package: è un delta che modifica il markup nel caso di pacchetti dinamici
  • markup_minimum: se definito è il markup da applicare al netto fornitore, non potrà essere inferiore a questo parametro. Se non è definito questo limite è 0.0
  • skip_price_comparison: se valorizzato con "true", ai risultati di questo feed non verrà applicato il price comparison (quindi compariranno i suddetti risultati anche se ci sono soluzioni più convenienti).

I seguenti parametri permettono di definire una finestra temporale entro la quale deve ricadere il checkin affinché la richiesta venga inoltrata al fornitore. Può essere espressa sia in forma di date che di giorni da data oggi:

  • booking_window_from_date: scegliere la data esatta da cui è possibile effettuare il checkin nel formato YYYY-MM-DD

  • booking_window_to_date: scegliere la data esatta fino alla quale è possibile effettuare il checkin nel formato YYYY-MM-DD

  • booking_window_from_days: è possibile effettuare il checkin dall'n-esimo giorno, contando oggi come giorno 0 (numero di giorni). Esempio: impostando "2", considerando oggi come 13 agosto, significa che il primo check-in possibile è il 15 agosto (13/08 = giorno 0, 14/08 = giorno 1, 15/08 = giorno 2)

  • booking_window_to_days: è possibile effettuare il checkin fino al giorno n compreso, contando oggi come giorno 0 (numero di giorni). Esempio: impostando "5", considerando oggi come 13 agosto, significa che l’ultimo check-in possibile è il 18 agosto (13/08 = giorno 0, …, 18/08 = giorno 5)

  • only_single_hotel_availability: se valorizzato a "yes" si intende che questo feed è riservato per richieste di singolo hotel, richieste per più hotel o per città non verranno effettuate. Si consiglia di usare al suo posto "max_hotels_to_search" in quanto se valorizzato, questo parametro viene ignorato

  • blooked_rooms_types: può contenere una lista di tipi di stanze, separate da virgola, per le quali non effettuare ricerche. Per esempio: TRP, QUD

  • max_hotels_to_search: preferibile a "only_single_hotel_availability". Se valorizzato come numero, il feed è attivo solo per le richieste di al massimo questo numero hotel

  • deadlinehour: definire eventuali ore che si aggiungono alle deadline del fornitore. Nel caso in cui si voglia vendere tutto il prodotto solo come non rimborsabile, consigliamo di aggiungere un valore molto alto (esempio 100.000). Le ore indicate qui hanno scopo esclusivamente tutelativo: se un Cliente cancella entro questo periodo, la cancellazione seguirà le condizioni effettive del fornitore

  • deadlinetime: nel formato HH:MM dopo aver applicato le ore di margine, la deadline viene impostata a questo orario. Se non è valorizzato viene usato "12:00"

  • alias: permette di definire un alias mnemonico alla plugin

I seguenti filtri bloccano il traffico già in richiesta:

  • allowed_nationalities: il feed è abilitato solo per i passeggeri la cui nazionalità rientra in questa lista di codici (codici country iso2), separati con virgola senza spazi
  • denied_nationalities: il feed è disabilitato per i passeggeri la cui nazionalità rientra in questa lista di codici (codici country iso2), separati con virgola senza spazi
  • allowed_localities: il sistema permette di definire delle localities (macro-aree che possono essere definite dai Tour Operator) e di ricercare su di esse. Di default le ricerche per locality non vengono inoltrate ai feed xml, a meno che questo parametro non sia impostato a "yes"
  • allowed_countries: lista dei codici nazione (consultabili in amministrazione > dati statici > nazioni > primo campo "codice") separati da virgola dove è abilitato il feed. Una volta definiti si possono cercare hotel e città solo in queste nazioni
  • denied_countries: lista dei codici nazione (consultabili in amministrazione > dati statici > nazioni > primo campo "codice") separati da virgola dove è disabilitato il feed. Una volta definiti non si possono cercare hotel e città in queste nazioni.

È possibile inoltre definire delle condizioni che una richiesta disponibilità deve soddisfare per essere inoltrata al fornitore di questo feed, tramite:

  • max_rooms: numero massimo di stanze richieste

  • min_rooms: numero minimo di stanze richieste

  • max_nights: numero massimo di notti

  • min_nights: numero minimo di notti

  • max_deadline_hours: vengono scartati dal feed i contratti per cui tra checkin e deadline ci sono più ore rispetto a come è valorizzata questa opzione

  • recommended: i contratti provenienti da questo feed sono marcati come "recommended"

  • send_customer_reference: se il booking viene fatto da sito, in fase di booking il comportamento di default è mandare come riferimento il nome del servizio nel sistema che sta facendo l'acquisto. Se invece è un booking creato tramite Kalima, è preferibile inviare il riferimento cliente (tramite valorizzazione di questa opzione a “yes”). Si prega di notare che al momento Towers è asincrono e dunque se c’è incompatibilità con i protocolli asincroni, non è possibile individuare il booking corretto in fase di notifica asincrona

  • allowed_currencies: lista opzionale di currency, separata da virgola. Se la currency cliente (nel quale è necessario convertire i prezzi) non si trova in questa lista, viene usata la prima currency della lista

  • min_timeout: per evitare timeout troppo brevi di un fornitore xml dopo ogni query, da definire se non sono disponibili "min_timeout_multi_hotels" e "min_timeout_single_hotel" in secondi

  • min_timeout_multi_hotels: per evitare timeout troppo brevi di un fornitore xml dopo ogni query, nel caso venga richiesto un solo hotel, espresso in secondi

  • min_timeout_single_hotel: per evitare timeout troppo brevi di un fornitore xml dopo ogni query, nel caso vengano richiesti più hotel id, espresso in secondi

  • compare_results: quando un feed restituisce molti risultati, con minime differenze solo sui prezzi, si può impostare a "yes" questo parametro per applicare una prima scrematura e ridurre il numero di contratti restituiti

  • deadline_timezone_from: permette di definire in quale timezone il feed restituisce i risultati in termini di cancellazione, può essere una timezone specifica, oppure la stringa "supplier", ad indicare che viene fornita direttamente dal feed stesso oppure "hotel" ad indicare che viene considerata in base ai dati statici degli hotel. In caso non sia definita viene presunta la timezone CET

  • remark_for_availability

  • remark_for_booking

  • remark_for_voucher

  • deduct_commission questo campo serve solo per quei Fornitori che inviano la commissione. Si dà la possibilità al Tour Operator di decidere se dedurla dal prezzo oppure no tramite:

    • true, il sistema sottrarrà la commissione e applicherà il markup sul prezzo al netto della commissione (che dovrebbe quindi avere un numero positivo)
    • false, il sistema considererà il prezzo al lordo della commissione e appliccherà di conseguenza il markup (che dovrebbe perciò avere un valore negativo)

  • url

  • actor

  • user

  • markup: deve essere un carattere numerico. Sarà aggiunto ai prezzi ricevuti dai fornitori e sarà il guadagno del Tour Operator. Può essere anche un valore negativo, se impostato è necessario anche definire un markup minimo (che di default è 0.0) Se il Tour Operator decide di disabilitare un fornitore, è necessario inserire nella riga di markup un carattere alfabetico e cliccare su "modifica" per salvare l'azione. Suggeriamo di inserire "DISABLED" con l'ultimo markup inserito (ad esempio DISABLED7). NB: se ad un cliente viene disattivato un fornitore tramite blocco plugin (Amministrazione > Clienti > Blocchi plugin), in caso di cancellazione di una prenotazione fatta in precedenza, la cancellazione parte comunque in quanto le plugin disabilitate bloccano solo le nuove ricerche di disponibilità.

  • password