XML Supplier

The Tour Operator can update the suppliers' features from Configurations > Plugin settings.

  • markup_delta_opaque: is a delta that modifies the markup in case of opaque rate
  • markup_delta_package: is a delta that modifies the markup in case of dynamic packets
  • markup_minimum: if defined is the markup to be applied to the supplier net, it cannot be less than this parameter. If it is not defined this limit is 0.0
  • skip_price_comparison: if valorized with "true", price comparison will not be applied to the results of this feed (so the above results will appear even if there are cheaper solutions)

The following parameters define a time window during which the check-in must occur for the request to be forwarded to the supplier. This window can be specified either as exact dates or as a range of days relative to today.

  • booking_window_from_date: choose the exact date from which check-in is allowed, in the format YYYY-MM-DD
  • booking_window_to_date: choose the exact date until which check-in is allowed, in the format YYYY-MM-DD
  • booking_window_from_days: check-in is allowed starting from the n-th day, counting today as day 0 (number of days)

  • booking_window_to_days: check-in is allowed up to and including the n-th day, counting today as day 0 (number of days)

  • only_single_hotel_availability: if valorized to “yes” it means that this feed is reserved for single hotel requests, multiple hotel or city requests will not be made. It is recommended to use “max_hotels_to_search” instead since if valorized, this parameter is ignored
  • blooked_rooms_types:may contain a comma-separated list of room types for which not to search. For example: TRP, QUD
  • max_hotels_to_search: preferred to “only_single_hotel_availability”. If valued as a number, the feed is active only for requests for at most this hotel number
  • deadlinehour: define any hours that are in addition to supplier deadlines, in case you wish to sell the entire product as non-refundable only, we recommend entering a very high value (e.g., 100.000)
  • deadlinetime: in HH:MM format after applying the margin hours, the deadline is set to this time. If it is not valued, “12:00” is used
  • alias: allows you to define a mnemonic alias to the plugin

The following filters block the traffic already being requested:

  • allowed_nationalities: the feed is enabled only for passengers whose nationality falls within this code list (iso2 country codes)
  • denied_nationalities: the feed is disabled for passengers whose nationality falls within this code list (iso2 country codes)
  • allowed_localities: the system allows you to define localities (macro-areas that can be defined by tour operators) and search on them. By default, searches by locality are not forwarded to xml feeds unless this parameter is set to “yes”
  • allowed_countries: list of country codes (available under Admin > Static Data > Countries > first field ‘Code’) separated by commas where the feed is enabled. Once defined, hotels and cities can only be searched within these countries
  • denied_countries: list of country codes (available under Admin > Static Data > Countries > first field ‘Code’) separated by commas where the feed is disabled. Once defined, hotels and cities cannot be searched in these countries. It is also possible to define conditions that an availability request must meet in order to be forwarded to the supplier of this feed, through:
  • max_rooms: maximum number of rooms required
  • min_rooms: minimum number of rooms required
  • max_nights: maximum number of nights
  • min_nights: minimum number of nights
  • max_deadline_hours: contracts for which there are more hours between checkin and deadline than how this option is valued are discarded from the feed
  • recommended: contracts from this feed are marked as “recommended”
  • send_customer_reference: if the booking is made from site, when booking, the default behavior is to send as reference the name of the service in the system that is making the purchase. Instead, if it is a booking created via Kalima, it is preferable to send the customer reference (enhancing this option to “yes”). Please note that at the moment Towers is asynchronous and therefore if there is incompatibility with asynchronous protocols, it is not possible to locate the correct booking during asynchronous notification
  • allowed_currencies: optional list of currencies, separated by comma. If the client currency (into which prices need to be converted) is not in this list, the first currency in the list is used
  • min_timeout: to avoid too short timeouts of an xml provider after each query, to be defined if “min_timeout_multi_hotels” and “min_timeout_single_hotels” are not available
  • min_timeout_multi_hotels: to avoid too short timeouts of an xml provider after each query, in case only one hotel is requested
  • min_timeout_single_hotel: to avoid too short timeouts of an xml provider after each query, in case multiple hotel ids are requested
  • compare_results: when a feed returns many results, with minimal differences only on prices, you can set this parameter to “yes” to apply a first skim and reduce the number of contracts returned
  • deadline_timezone_from: allows to define in which timezone the feed returns the results the cancellation terms, it can be a specific timezone, or the string “supplier”, indicating that it is provided directly by the feed itself or “hotel” indicating that it is considered based on the hotels static data. In case it is not defined the CET timezone is assumed
  • username
  • password
  • url
  • markup: has to be a numeric character. It will be added to the prices received by suppliers and it will be the earning of the Tour Operator. If Tour Operator decide to disable a supplier, it is necessary to insert in the markup row an alphabetic character and click “change” to save the action. We suggest to insert "DISABLED" with the last markup inserted (for example DISABLED7). Please note: if a customer is disabled a supplier via plugin blocking (Admin > Client > Block Plugin), in case of cancellation of a previously made reservation, the cancellation starts anyway as disabled plugins only block new availability searches
  • default_nationality