ORS Documentation

This is an old revision of the document!

---

====== Offer and Trip Info method ====== <WRAP center round important 80%> This method is deprecated. We will not include this method in the next API version. </WRAP> Information about an offer and trip by sending ''hsc'' code. This information is only returned if session hasn't expired yet. If you send search parameters that you have used with [[trips|trips method]], a system will try to recreate session. ===== Valid content types ===== * ''pauschal'' * ''hotel'' * ''trips'' * (''charter'' **is not supported!**) * (''oneway'' **is not supported!**) * (''extras'' **is not supported!**) ===== Description ===== <code php> public array offerTripInfo( array $searchData, array $headerData ) </code> ===== Parameters ===== * ''searchData (array)'' : search parameters. Required serach parameters: ''hsc'' * ''headerData (array)'' : [[soap_header|SOAP Header Information]] ===== Return Values ===== Gets detailed information about an offer and trip via trip ''hsc'' code. <code> Array ( [xmlReq] => [searchtermin_xmlReq] => [header] => Array ( [typ] => hotel [offers] => 1 [rgc] => [rgn] => 0 [rgg] => [rggn] => [pages] => 1 [perpage] => 20 [offset] => [sid] => pg1l77hauar2k7h3vfq96grmf6 ) [offer] => Array ( [pic] => http://www.ors.si/giata-pics/80970//full.jpg [gid] => 80970 [htn] => Pavillons Slaven [stc] => 1.5 [ovr] => 67 [emf] => 100 [cnt] => 9 [oid] => 5390 [hon] => Selce [fcts] => bea=0,ben=0,chf=0,clb=0,ani=0,pol=0,wel=0,spt=0,sgl=0,stn=0,ski=0 [dtemp] => [wtemp] => [rgc] => 100434 [rgn] => Croatia - Kvarner [rgg] => 100023 [rggn] => Croatia [geo] => 1 [lat] => 45.1548430000000000 [lon] => 14.7177340000000000 ) [trip] => Array ( [sub] => lastmin [gid] => 80970 [toc] => PALM [tockoda] => 80657677 [ton] => Palma [rgc] => 100434 [oid] => 5390 [zac] => DZ [zackoda] => 6890 [zan] => double room [vpc] => HP [vpckoda] => 7280 [vpn] => half board [od] => aid=,iid=,lid=,vid=,zid=palm_31204 [htc] => LEHRV2131495 [svc] => 31204 DZ HP [ahckoda] => [vnd] => 2014-09-20 [bsd] => 2014-09-25 [tdc] => 5 [md5p] => 44f032470126b41c04ee78d21bd076cd [md5t] => 6e3bb74d62872af863754b37f09ce146 [hsc] => 6e3bb74d62872af863754b37f09ce146 [ppc] => 95 [alt] => 0 [top] => 0 [tocpic] => http://www.ors.si/ibe/ikonce/toc/palm.gif [aid] => [atx] => [iid] => [itx] => [lid] => [ltx] => [vid] => [vtx] => [zid] => palm_31204 [ztx] => ) ) </code> ===== Return parameters ===== * ''header'' (array) : information about a selected region and paging information * ''typ'' : content type * ''offers'' : number of offers found * ''pages'' : number of pages * ''perpage'' : records per page * ''offset'' : current page (first page have offset 0, second page have offset 1, ...) * ''sid'' : session id used * ''rgc'' : selected region code (ID) * ''rgn'' : selected region name * ''rgg'' : selected region group code (ID) * ''rggn'' : selected region group name * ''offer (array)'' : an offer information * ''pic'' : picture thumbnail * ''gid'' : accommodation GIATA ID * ''htn'' : accommodation name * ''stc'' : hotel category * ''ovr'' : overall rating * ''emf'' : guests recommendation (in percents) * ''cnt'' : number of evaluators * ''hon'' : city name * ''oid'' : city ID * ''zhn'' : destination name * ''zhc'' : destination code (IATA code) * ''fcts'' : hotel facts * ''dtemp'' : air temperature * ''wtemp'' : water temperature * ''rgc'' : region code (ID) * ''rgn'' : region name * ''rgg'' : region group ID * ''rggn'' : region group name * ''geo'' : does this accommodatin have a geo location codes (1) or not (0) * ''lat'' : latitude * ''lon'' : longitude * ''trip (array)'' : trip information * ''sub'' : sub category (catalog, earlybird, lastmin, ...) * ''gid'' : accommodation GIATA ID * ''toc'' : touroperator code * ''ton'' : touroperator name * ''tocpic'' : touroperator logo * ''zac'' : room type code * ''zan'' : room type name * ''vpc'' : service type code * ''vpn'' : service type name * ''htc'' : hotel code (or product code) * ''svc'' : service code * ''vnd'' : checkin date * ''bsd'' : checkout date * ''tdc'' : duration * ''md5p'' : unique hash for this offer (for internal use only) * ''md5t'' : unique hash for this trip (for internal use only) * ''hsc'' : unique hash for this trip * ''alt'' : alternative trip (1) or a normal trip (0) * ''top'' : top trip (1) or a normal trip (0) * ''aid'' , ''iid'' , ''lid'' , ''vid'' , ''zid'' : (for internal use only) * ''atx'' : room facilities text * ''ltx'' : room location text * ''ztx'' : room detail description * ''itx'' : included services in room price * ''ppc'' : price per person * ''url'' : a suggested URL with search parameters for [[check|check method]] ===== Examples ===== * Example of ''offerTripInfo'' request <code php> $searchParams = array( 'vnd' => '30.10.2014', // start date 'bsd' => '15.11.2014', // end date 'tdc' => '1-4', // duration [min-max] days 'epc' => '2', // number of adults 'gid' => '71088', // selected hotel by GIATA ID 'hsc' => '6e3bb74d62872af863754b37f09ce146', // trip hash code ); $offerTripInfo = $soapClient->orsxml_hotel_api_call( 'offerTripInfo', $searchParams, $header ); </code>