User Tools

Site Tools


ors-soap-api:public:offertripinfo

This is an old revision of the document!


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 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

public array offerTripInfo( array $searchData, array $headerData )

Parameters

  • searchData (array) : search parameters. Required serach parameters: hsc
  • headerData (array) : SOAP Header Information

Return Values

Gets detailed information about an offer and trip via trip hsc 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] => 
        )
)

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
    • ltx : location
    • ztx : short room description
    • itx : 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 method

Examples

  • Example of offerTripInfo request
$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 );
ors-soap-api/public/offertripinfo.1435061685.txt.gz · Last modified: 2015/06/23 14:14 by admin