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