User Tools

Site Tools


data:request:regions

Inquiry: regions

Descriptions

File with the list of regions is always available at: https://mdswsdata.merlinx.eu/mdsws/regions.zip It contains two types of data, a list of countries and regions (the type of value is controlled 3rd field), the regions with the same numbers can be repeated, the first value is always that we use in our system, all others are variations of the name of the region that have come from tour-operators and were joined. In addition, filtered list is generated with utf-8 encoding https://mdswsdata.merlinx.eu/mdsws/regions_utf8.zip: it includes regions that have occurred in the data up to 7 days back. Relationship between country and its regions can be downloaded from the address https://mdswsdata.merlinx.eu/mdsws//regions_tree_utf8.zip

Inquiry

Field nametype contains
ofr_candybitmaskCandy (bonus)
ofr_catalogcharCatalog code
obj_categoryintCategory of the object multiplied by 10
trp_depDatedateDate of departure / departure / start of trip
trp_skiDestinationintDestination regions for ski.
obj_xDistBeachintDistance from beach
obj_xDistSkiintDistance from ski lift
obj_codeNameFtstextEnabling search of offers based by string name of the hotel
obj_xCodeintID assigned to the hotel by MerlinX
obj_xServiceIdintID meal/service assigned by MerlinX
obj_bookBedsboolIf reservation on individual beds is possible
obj_luggagecharMain baggage is included or not
obj_xRoomDescCountintMinimum number of required Room description that match the offer
obj_xAttributesCountintMinimum number of required attributes that match the offer
par_chdintNumber of children
trp_flightChangeCountintNumber of stops for ongoing flight
rFlightChangeCountintNumber of stops for return flight
obj_typecharObject type (hotel/round trip/cruise /...)
obj_xAttributesbitmaskObject's attributes / flag offer
obj_xAttributesNotInbitmaskObject's attributes / flag offer
obj_xNametextObject's name that is assigned by MerlinX (original or revised)
ofr_refundablecharOffer have some flex rules or not
trp_destinationintRegion of the trip/event
ofr_residentcharResident is available or not
obj_roomcharRoom code/ accommodation
obj_xRoomDesccharRoom description processed by MerlinX
geo_xCircleintSearch in max radius='dstance' (in kilometers) from lat,long
geo_xPolygonintSearch in polygon described by at least 3 pairs of lat,long
obj_xCityFtstextString allows searching offers by town name
obj_xCityIdtextThe city in which the object is assigned by MerlinX (original or revised)
obj_nametextThe name of the object (the hotel / cruise / circuit / package)
ofr_transferTypecharTransfer included or not
ofr_typecharType of offer
par_chdAgetextage of children or children bitrh dates
ofr_xCatalogcharcatalogs unified by MerlinX
trp_rDepCodechardeparture code of the return place
trp_rDesCodechardestination code of the return trip
external_search_idtextexternal search id
obj_codecharhotel code
maxPriceintmaximum price for an adult
minPriceintminimum price per adult
par_adtintnumber of adults
trp_durationintnumber of days
trp_durationMintnumber of days
par_infintnumber of infants
ofr_xStatuscharoffer availability
trp_depNametextplace of departure / start
trp_retDatedatepossible late date of the return trip
useMerlinMarginboolreturns price with agency margin
totalPriceboolreturns the total price for the asked product
excludeFromRulestextrule name
includeFromRulestextrule name
obj_zScoreintsearch based of Zoover rating
obj_zScoreCntintsearch based of amount of Zoover opinions
wtr_uvintsearch by UV index
wtr_bintsearch by forecast beach activities score (1-10)
wtr_biintsearch by forecast biking activities score (1-10)
wtr_cintsearch by forecast camping activities score (1-10)
wtr_pintsearch by forecast precipitation (mm)
wtr_pcintsearch by forecast precipitation chance (%)
wtr_tintsearch by forecast temperature ( in degrees Celsius )
wtr_tnintsearch by forecast tennis score (1-10)
wtr_trintsearch by forecast terrace activities score (1-10)
wtr_wkintsearch by forecast walking activities score (1-10)
wtr_wtintsearch by forecast water sports activities score (1-10)
wtr_sdintsearch by sun hours duration
ofr_tourOpchartouroperator code
<?xml version='1.0'?>
<mds>
    <auth>
        <login>login</login>
        <pass>pass</pass>
    </auth>
   <request>
     <type>regions</type>
     <conditions>
       <par_adt>2</par_adt>     
       <ofr_tourOp>ITAK</ofr_tourOp>
       <trp_depDate>20101020:20101124</trp_depDate>
       <obj_codeNameFts>Resort</obj_codeNameFts>
     </conditions>
   </request>
</mds>

Answer

Field nametype contains
trp_destinationintRegion of the trip/event
reg_priceintlowest offer for the region
reg_idcharregion ID {country}_{region}
<response>
  <reg id="38_57" price="1349"/>
  <reg id="11_154" price="1494"/>
  <reg id="11_203" price="1739"/>
  <reg id="11_2323" price="1849"/>
  <reg id="6_17" price="2319"/>
  <reg id="15_50" price="3110"/>
  <reg id="243_2541" price="3539"/>
  <reg id="36_4105" price="3880"/>
  <reg id="19_4191" price="3899"/>
  <reg id="19_116" price="3949"/>
  <reg id="36_4104" price="4289"/>
  <reg id="49_2503" price="6380"/>
  <reg id="49_1316" price="6880"/>
  <reg id="413_20" price="6989"/>
</response>
data/request/regions.txt · Last modified: 2023/07/18 15:08 by Maciej Pokrzywa