User Tools

Site Tools


data:request:groups

Inquiry: groups

Description

Query type groups returns a unique list of objects and variants of the fields in the group.

In version 2.1 is required to provide a list of filters that are to be returned in the response.

Inquiry

Field name typecontains
extraDataxmlAdditional info about offers
excludeFromRulestextrule name
par_chdAgetextage of children or children bitrh dates
obj_xCityFtstextString allows searching offers by town name
obj_codeNameFtstextEnabling search of offers based by string name of the hotel
obj_xCityIdtextThe city in which the object is assigned by MerlinX (original or revised)
obj_xNametextObject's name that is assigned by MerlinX (original or revised)
trp_depNametextplace of departure / start
includeFromRulestextrule name
trp_depNametextplace of departure / start
obj_nametextThe name of the object (the hotel / cruise / circuit / package)
selectAnswerFieldstextfields name
external_search_idtextexternal search id
data:fields:names:mixtexttype of mixed offers
wtr_tnintsearch by forecast tennis score (1-10)
wtr_biintsearch by forecast biking 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
geo_xCircleintSearch in max radius='dstance' (in kilometers) from lat,long
obj_zScoreintsearch based of Zoover rating
obj_zScoreCntintsearch based of amount of Zoover opinions
obj_xDistSkiintDistance from ski lift
wtr_pcintsearch by forecast precipitation chance (%)
wtr_trintsearch by forecast terrace activities score (1-10)
maxPriceintmaximum price for an adult
obj_xServiceIdintID meal/service assigned by MerlinX
obj_categoryintCategory of the object multiplied by 10
par_chdintNumber of children
minPriceintminimum price per adult
obj_xDistBeachintDistance from beach
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
calc_foundintminimum number of offers returned in count (maximum 1000)
trp_durationMintnumber of days
wtr_wtintsearch by forecast water sports activities score (1-10)
par_adtintnumber of adults
obj_xCodeintID assigned to the hotel by MerlinX
par_infintnumber of infants
trp_destinationintRegion of the trip/event
obj_xRoomDescCountintMinimum number of required Room description that match the offer
limit_fromintfirst record (default 1, max 1000)
limit_countintNumber of records per page (default 10, max 100)
wtr_cintsearch by forecast camping activities score (1-10)
trp_flightChangeCountintNumber of stops for ongoing flight
rFlightChangeCountintNumber of stops for return flight
trp_retDatedatepossible late date of the return trip
trp_depDatedateDate of departure / departure / start of trip
obj_luggagecharMain baggage is included or not
obj_xRoomDesccharRoom description processed by MerlinX
order_bycharnumber for sorting
ofr_catalogcharCatalog code
trp_rDepCodechardeparture code of the return place
obj_roomcharRoom code/ accommodation
ofr_xCatalogcharcatalogs unified by MerlinX
ofr_tourOpchartouroperator code
ofr_typecharType of offer
trp_rDesCodechardestination code of the return trip
trp_depCodecharCode of departure location/airport ( IATA Code )
obj_typecharObject type (hotel/round trip/cruise /...)
obj_codecharhotel code
ofr_xStatuscharoffer availability
obj_tourOpAndCodechar${kod_operatora}_${kod_obiektu}
group_bycharname of the field after which data will be grouped
ofr_transferTypecharTransfer included or not
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>groups</type>
     <conditions>
       <ofr_type>F</ofr_type>
       <par_adt>2</par_adt>     
       <trp_depDate>20101122:20101124</trp_depDate>
       <obj_codeNameFts>Resort</obj_codeNameFts>
     </conditions>
   </request>
</mds>

Answer

Field name typecontains
extraDataxmlAdditional info about offers
trp_rArrTimetimetime of arrival of the return trip
trp_rDepTimetimeDeparture time of the return trip
trp_depTimetimetime of departure / start
trp_arrTimetimetimes of trip / directions
obj_countrytextCountry
obj_nametextThe name of the object (the hotel / cruise / circuit / package)
trp_depNametextplace of departure / start
obj_xCitytextThe city in which the object is assigned by MerlinX (original or revised)
obj_rating !!! not available anymore !!!textHotel rating by Zoover system
obj_xNametextObject's name that is assigned by MerlinX (original or revised)
trp_busStopDesctextDescription of the bus stop
trp_rCarrierCodetextcarrier code and flight number of return (if both information is available)
obj_citytextThe city in which the object is located
wtrtextWeather information
trp_depNametextplace of departure / start
wtr_valtextweather value
obj_serviceDesctextdescription of the meals / service
trp_carrierDesctextName of carrier
obj_roomDesctextDescription of room / accommodation
obj_regiontextThe name of the region in which the object is located
trp_carrierCodetextcarrier code and flight number (if both of the information is available)
trp_busStoptext
trp_desDesctextplace of trip/ directions
obj_xskiregpathtextInformation about ski regions
trp_flightOptextflight operator name
trp_flightChangeCountintNumber of stops for ongoing flight
obj_maxAdtintMaximum number of adults
obj_xCountryIdintID assigned to a country by MerlinX
obj_maxPaxintMaximum number of people (occupancy)
obj_minAdtintThe minimum number of adults
obj_minPaxintThe minimum number of people (occupancy)
obj_xCodeintID assigned to the hotel by MerlinX
obj_categoryintCategory of the object multiplied by 10
obj_xServiceIdintID meal/service assigned by MerlinX
ofr_priceintPrice per adult (in the case ofr_operCurr pathologist from PLN should be taken as approximate this value!)
trp_durationintnumber of days
ofr_operPriceintPrice per adult in the currency of the operator
trp_stayintnumber of nights
trp_durationMintnumber of days
countintnumber of matching results for the given query
obj_xRegionIdintID assigned to a region by MerlinX
rFlightChangeCountintNumber of stops for return flight
obj_xLatfloatLatitude location of the object
obj_xLongfloatLongitude position of the object
trp_desDatedatedate of reach the destination
trp_rDepDatedateDeparture date of the return trip
trp_rDesDatedateDate of return
trp_startDatedateTour start date
trp_depDatedateDate of departure / departure / start of trip
obj_acomodationcharDEPRECIATED! Code assignment, unites the value of the code room and board, used by the booking system
obj_desCodecharUsually the airport code serving the area where hotel is located
obj_roomcharRoom code/ accommodation
ofr_idcharoffer identifier. ** IMPORTANT: ** Do not assume that there will always be a hexadecimal string
ofr_statuscharlast known status/availability of offers
trp_flightCodecharservice code for flight / transport
ofr_catalogcharCatalog code
trp_rDepCodechardeparture code of the return place
ofr_tourOpchartouroperator code
ofr_xCatalogcharcatalogs unified by MerlinX
trp_type2charsupplement field trp_type
trp_typecharservice type of transport (plane / bus /...)
obj_typecharObject type (hotel/round trip/cruise /...)
trp_tourCodechar
trp_rFlightCodecharservice code of the return flight / transport (information can be included also in the field trp_flightCode)
obj_codecharhotel code
trp_seasonchar
trp_rDesCodechardestination code of the return trip
ofr_operCurrcharcurrency used by the operator
trp_desCodecharCode of destination location/airport ( IATA Code )
obj_servicecharService code/board
trp_depCodecharCode of departure location/airport ( IATA Code )
ofr_typecharType of offer
obj_xRoomDesccharRoom description processed by MerlinX
room_hashcharHotel room id
ofr_transferTypecharTransfer included or not
obj_luggagecharMain baggage is included or not
ofr_refundablecharOffer have some flex rules or not
ofr_residentcharResident is available or not
obj_bookBedsboolIf reservation on individual beds is possible
ofr_sweetboolCandy - promoted flag ads (provided by the operator)
ofr_TFGincludedboolreturns the price including TFG
obj_xAttributesbitmaskObject's attributes / flag offer
ofr_candybitmaskCandy (bonus)
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<response>
	<grp>
		<ofr id="f6b87684a59b0ae6ba9ffc291ec965b822bb6c264abd6235cc9aae4395078577" catalog="KAT" tourOp="EXIM" type="F" sweet="0" status="BA" price="1399">
			<obj name="Regina Nuweiba Resort" city="Taba - Nuweiba" category="30" code="618" room="1" service="H" roomDesc="Standard/DBL" minPax="2" maxPax="4" minAdt="2" maxAdt="3" xCode="4037" region="Taba" acomodation="" xAttributes="0x51862030" type="H" serviceDesc="Sniadania i obiadokolacje" xServiceId="2" country="Egipt" bookBeds="0" rating="A:5/P:6/O:10/J:7/B:7/R:7/a:5.1/p:5.6/o:6.2/j:5/b:3.6/r:5.3" desCode="TCP" xName="Regina Nuweiba" xCity="Taba"/>
			<trp desCode="TCP" depCode="Warszawa" depDate="20101123" duration="7" flightCode="WAWTCP1" carrierCode="924" rFlightCode="TCPWAW1" rCarrierCode="925" depTime="1950" arrTime="0055" rDepTime="0355" rArrTime="0605" type="F" type2="" dstCode="11_203" depDesc="Warszawa" desDesc="Taba" rDepDate="20101201" desDate="20101124" rDesDate="20101201" rDepCode="TCP" rDesCode="WAW" startDate="20101123" tourCode="" busStop="" durationM="7" season="0" busStopDesc="" flightOp="" stay=""/>
		</ofr>
		<variants tourOp="EXIM"/>
	</grp>
	<grp>
 
		<ofr id="0ab763430e705a439c390dbfd3472a7005e04ec2019ac0e66912bc16c5a7c9de" catalog="KAT" tourOp="SRSU" type="F" sweet="0" status="OK" price="1515">
			<obj name="Sahara  Mexicana Sharm Resort" city="Sharm El Sheikh" category="30" code="573" room="19" service="H" roomDesc="Standard" minPax="2" maxPax="4" minAdt="2" maxAdt="3" xCode="1461" region="Sharm El Sheikh" acomodation="" xAttributes="0x550f3030" type="H" serviceDesc="Śniadania i obiadokolacje" xServiceId="2" country="Egipt" bookBeds="0" rating="a:7.2/p:6.3/o:6.5/j:6.4/b:4.5/r:6.8" desCode="SSH" xName="Creative Mexicana" xCity="Sharm El Sheikh"/>
			<trp desCode="SSH" depCode="Wrocław" depDate="20101123" duration="7" flightCode="WROSSH1" carrierCode="5573" rFlightCode="SSHWRO1" rCarrierCode="5574" depTime="1650" arrTime="2230" rDepTime="1220" rArrTime="1600" type="F" type2="" dstCode="11_154" depDesc="Wroclaw" desDesc="Sharm El Sheik" rDepDate="20101130" desDate="20101123" rDesDate="20101130" rDepCode="SSH" rDesCode="WRO" startDate="20101123" tourCode="" busStop="" durationM="7" season="0" busStopDesc="" flightOp="" stay=""/>
		</ofr>
		<variants tourOp="ALFA,SRSU,BFRE"/>
	</grp>
 
           (...)
	<count>11</count>
 
</response>
data/request/groups.txt · Last modified: 2012/07/27 12:01 by marekj