Offer and Trip Info method [ORS Documentation]

ors-soap-api:public:offertripinfo

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.

====== Offer and Trip Info method ======

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'' : a list of room facilities
    * ''lty'' : location 
    * ''ztx'' : short room description
    * ''ltx'' : offer description or sometimes what this offer includes bersides a basic service
    * ''ppc'' : lowest price per person for this region
    * ''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>

ors-soap-api/public/offertripinfo.1425667708.txt.gz · Last modified: 2015/03/06 19:48 by admin