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 nameType LengthContains
obj_xDistSkiintDistance from ski lift
obj_categoryintCategory of the object multiplied by 10
obj_xDistBeachintDistance from beach
obj_bookBedsboolIf reservation on individual beds is possible
ofr_typechar2Type of offer
obj_xRoomDescchar3Room description processed by MerlinX
trp_rDepCodechar3departure code of the return place
trp_rDesCodechar3destination code of the return trip
trp_depCodechar3Code of departure location/airport ( IATA Code )
obj_typechar3Object type (hotel/round trip/cruise /...)
ofr_catalogchar4Catalog code
ofr_tourOpchar4touroperator code
obj_roomchar5Room code/ accommodation
obj_codechar20hotel code
ofr_candybitmask64Candy (bonus)
obj_xAttributesbitmask64Object's attributes / flag offer
obj_xAttributesNotInbitmask64Object's attributes / flag offer
excludeFromRulestextrule name
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
extraDataxmlAdditional info about offers
obj_zScoreintsearch based of Zoover rating
obj_zScoreCntintsearch based of amount of Zoover opinions
wtr_pcintsearch by forecast precipitation chance (%)
wtr_trintsearch by forecast terrace activities score (1-10)
par_chdAgetextage of children or children bitrh dates
maxPriceintmaximum price for an adult
trp_retDatedatepossible late date of the return trip
obj_xCityFtstextString allows searching offers by town name
obj_xServiceIdintID meal/service assigned by MerlinX
order_bycharnumber for sorting
obj_xCityIdtextThe city in which the object is assigned by MerlinX (original or revised)
useMerlinMarginboolreturns price with agency margin
par_chdintNumber of children
minPriceintminimum price per adult
obj_xNametextObject's name that is assigned by MerlinX (original or revised)
totalPriceboolreturns the total price for the asked product
trp_depNametextplace of departure / start
includeFromRulestextrule name
ofr_xCatalogcharcatalogs unified by MerlinX
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_depDatedateDate of departure / departure / start of trip
trp_durationMintnumber of days
trp_depNametextplace of departure / start
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_nametextThe name of the object (the hotel / cruise / circuit / package)
obj_xRoomDescCountintMinimum number of required Room description that match the offer
selectAnswerFieldstextfields name
limit_fromintfirst record (default 1, max 1000)
limit_countintNumber of records per page (default 10, max 100)
ofr_xStatuscharoffer availability
wtr_cintsearch by forecast camping activities score (1-10)
obj_tourOpAndCodechar${kod_operatora}_${kod_obiektu}
obj_codeNameFtstextEnabling search of offers based by string name of the hotel
external_search_idtextexternal search id
<?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 nameType Containscontaining
obj_acomodationcharDEPRECIATED! Code assignment, unites the value of the code room and board, used by the booking system
obj_categoryintCategory of the object multiplied by 10
obj_bookBedsboolIf reservation on individual beds is possible
ofr_statuschar2last known status/availability of offers
trp_type2char2supplement field trp_type
trp_typechar2service type of transport (plane / bus /...)
trp_seasonchar2
obj_servicechar2Service code/board
ofr_typechar2Type of offer
obj_desCodechar3Usually the airport code serving the area where hotel is located
trp_rDepCodechar3departure code of the return place
obj_typechar3Object type (hotel/round trip/cruise /...)
trp_rDesCodechar3destination code of the return trip
ofr_operCurrchar3currency used by the operator
trp_desCodechar3Code of destination location/airport ( IATA Code )
trp_depCodechar3Code of departure location/airport ( IATA Code )
obj_xRoomDescchar3Room description processed by MerlinX
ofr_catalogchar4Catalog code
ofr_tourOpchar4touroperator code
obj_roomchar5Room code/ accommodation
trp_flightCodechar20service code for flight / transport
trp_tourCodechar20
trp_rFlightCodechar20service code of the return flight / transport (information can be included also in the field trp_flightCode)
obj_codechar20hotel code
obj_xAttributesbitmask64Object's attributes / flag offer
ofr_candybitmask64Candy (bonus)
obj_countrytextCountry
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_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_xCodeintID assigned to the hotel by MerlinX
obj_xLatfloatLatitude location of the object
obj_rating !!! not available anymore !!!textHotel rating by Zoover system
obj_xNametextObject's name that is assigned by MerlinX (original or revised)
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_busStopDesctextDescription of the bus stop
obj_xLongfloatLongitude position of the object
trp_rCarrierCodetextcarrier code and flight number of return (if both information is available)
trp_rArrTimetimetime of arrival of the return trip
obj_citytextThe city in which the object is located
trp_desDatedatedate of reach the destination
trp_rDepTimetimeDeparture time of the return trip
ofr_xCatalogcharcatalogs unified by MerlinX
trp_durationintnumber of days
ofr_operPriceintPrice per adult in the currency of the operator
wtrtextWeather information
trp_depNametextplace of departure / start
trp_rDepDatedateDeparture date of the return trip
trp_stayintnumber of nights
trp_rDesDatedateDate of return
trp_startDatedateTour start date
wtr_valtextweather value
trp_depTimetimetime of departure / start
obj_serviceDesctextdescription of the meals / service
trp_carrierDesctextName of carrier
trp_durationMintnumber of days
obj_roomDesctextDescription of room / accommodation
trp_depDatedateDate of departure / departure / start of trip
ofr_sweetboolCandy - promoted flag ads (provided by the operator)
trp_arrTimetimetimes of trip / directions
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
countintnumber of matching results for the given query
obj_xRegionIdintID assigned to a region by MerlinX
obj_xskiregpathtextInformation about ski regions
trp_flightOptextflight operator name
extraDataxmlAdditional info about offers
room_hashcharHotel room id
ofr_TFGincludedboolreturns the price including TFG
ofr_idcharup to 1 KBoffer identifier. ** IMPORTANT: ** Do not assume that there will always be a hexadecimal string
<?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