User Tools

Site Tools


data:request:offers

Inquiry: offers

Description

Query type offers returns a list of all offers that meet search conditions. You can download the first maximum of 1000 items.

Inquiry

Filed name TypeLengthContains
extraDataxmlAdditional info about offers
excludeFromRulestextrule name
par_chdAgetextage of children or children bitrh dates
obj_xCityFtstextString allows searching offers by town name
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
obj_codeNameFtstextEnabling search of offers based by string name of the hotel
external_search_idtextexternal search id
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_luggagechar1Main baggage is included or not
obj_xRoomDescchar3Room description processed by MerlinX
order_bycharnumber for sorting
ofr_catalogchar4Catalog code
trp_rDepCodechar3departure code of the return place
obj_roomchar5Room code/ accommodation
ofr_xCatalogcharcatalogs unified by MerlinX
ofr_tourOpchar4touroperator code
ofr_typechar2Type of offer
trp_rDesCodechar3destination code of the return trip
trp_depCodechar3Code of departure location/airport ( IATA Code )
obj_typechar3Object type (hotel/round trip/cruise /...)
obj_codechar20hotel code
ofr_xStatuscharoffer availability
obj_tourOpAndCodechar${kod_operatora}_${kod_obiektu}
ofr_transferTypechar1Transfer included or not
ofr_refundablechar1Offer have some flex rules or not
ofr_residentchar1Resident 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_candybitmask64Candy (bonus)
obj_xAttributesbitmask64Object's attributes / flag offer
obj_xAttributesNotInbitmask64Object's attributes / flag offer
<?xml version='1.0'?>
<mds>
    <auth>
        <login>login</login>
        <pass>pass</pass>
    </auth>
   <request>
     <type>offers</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 TypeContainscontaining
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_desCodechar3Usually the airport code serving the area where hotel is located
obj_roomchar5Room code/ accommodation
ofr_idcharup to 1 KBoffer identifier. ** IMPORTANT: ** Do not assume that there will always be a hexadecimal string
ofr_statuschar2last known status/availability of offers
trp_flightCodechar20service code for flight / transport
ofr_catalogchar4Catalog code
trp_rDepCodechar3departure code of the return place
ofr_tourOpchar4touroperator code
ofr_xCatalogcharcatalogs unified by MerlinX
trp_type2char2supplement field trp_type
trp_typechar2service type of transport (plane / bus /...)
obj_typechar3Object type (hotel/round trip/cruise /...)
trp_tourCodechar20
trp_rFlightCodechar20service code of the return flight / transport (information can be included also in the field trp_flightCode)
obj_codechar20hotel code
trp_seasonchar2
trp_rDesCodechar3destination code of the return trip
ofr_operCurrchar3currency used by the operator
trp_desCodechar3Code of destination location/airport ( IATA Code )
obj_servicechar2Service code/board
trp_depCodechar3Code of departure location/airport ( IATA Code )
ofr_typechar2Type of offer
obj_xRoomDescchar3Room description processed by MerlinX
room_hashcharHotel room id
ofr_transferTypechar1Transfer included or not
obj_luggagechar1Main baggage is included or not
ofr_refundablechar1Offer have some flex rules or not
ofr_residentchar1Resident 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_xAttributesbitmask64Object's attributes / flag offer
ofr_candybitmask64Candy (bonus)
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<response>
	<ofr id="cafc9c55c61765013b70f7c3fa763f2e219a9fdeb566ece37793980eba3ab128" catalog="MADA" tourOp="MADA" type="H" sweet="0" status="BA" operPrice="25" operCurr="PLN" price="25">
		<obj name="Tatralandia - tydzień w aquaparku" city="Liptov" category="30" code="193" room="193" service="I" roomDesc="Apartament 2+2" minPax="1" maxPax="4" minAdt="1" maxAdt="4" xCode="-924" region="Kotlina Liptowska" acomodation="" attributes="(nil)" type="H" serviceDesc="śniadania kolacje" serviceId="1" country="Słowacja" bookBeds="0" rating="" desCode="a59" xName="Tatralandia - tydzień w aquaparku" xCity="Liptov" lat="" long=""/>
		<trp desCode="" depCode="" depDate="20101112" duration="7" flightCode="" carrierCode="" rFlightCode="" rCarrierCode="" depTime="0000" arrTime="0000" rDepTime="0000" rArrTime="0000" type="" type2="" dstCode="428_3456" depDesc="" desDesc="" rDepDate="20101119" desDate="20101112" rDesDate="20101119" rDepCode="" rDesCode="" startDate="20101112" tourCode="" busStop="" durationM="7" season="0" busStopDesc="" flightOp="" stay=""/>
	</ofr>
	<ofr id="18a71e7373561ad94fa984291669596d219a9fdeb566ece37793980eba3ab128" catalog="MADA" tourOp="MADA" type="H" sweet="0" status="BA" operPrice="25" operCurr="PLN" price="25">
		<obj name="Tatralandia - tydzień w aquaparku" city="Liptov" category="30" code="193" room="218" service="I" roomDesc="Apartament 5 os" minPax="1" maxPax="5" minAdt="1" maxAdt="5" xCode="-924" region="Kotlina Liptowska" acomodation="" attributes="(nil)" type="H" serviceDesc="śniadania kolacje" serviceId="1" country="Słowacja" bookBeds="0" rating="" desCode="a59" xName="Tatralandia - tydzień w aquaparku" xCity="Liptov" lat="" long=""/>
		<trp desCode="" depCode="" depDate="20101112" duration="7" flightCode="" carrierCode="" rFlightCode="" rCarrierCode="" depTime="0000" arrTime="0000" rDepTime="0000" rArrTime="0000" type="" type2="" dstCode="428_3456" depDesc="" desDesc="" rDepDate="20101119" desDate="20101112" rDesDate="20101119" rDepCode="" rDesCode="" startDate="20101112" tourCode="" busStop="" durationM="7" season="0" busStopDesc="" flightOp="" stay=""/>
	</ofr>
          (...)
	<count>15427</count>
</response>
data/request/offers.txt · Last modified: 2012/04/24 11:08 by marekj