Table of contents
-
- Search methods
- Check methods
- Booking methods
- Info methods
Data export
- Methods
Table of contents
Data export
To understand ORS SOAP API you must first understant its structure.
ORS currently supports 5 different content types. Each type has its own characteristics and therefore you must use a correct call method to get a desired content.
Content types:
pauschal
: Under pauchal type are packages of Hotel accommodations and Charter flights.hotel
: This are accommodations only (without transfer)trips
: Trips (or Roundtrips) are special offers that includes different transfers from specified location and back (bus, plane, ship, train, …).dhotel
: This content type is used for direct hotel connections (NEW!).charter
: charter plane ticketsoneway
: Plane tickets for one way travelextras
: Extra services. This content type is for special services / items that user can buy through ORS. For example: festival tickets, massage, bike riding, transfer, insurrance, …Here is a list of possible ORS search parameters.
vnd
: start datebsd
: end datetdc
: trip duration. Can also be a range ie: 5-8 , means from 5 to 8 daystoc
: tour operator code (also known as CRS code). Each tour operator has its unique code.epc
: a number of adults travelingka1
: an age of first childka2
: an age of second childka3
: an age of third childrgc
: region code (search by single region id – it is better to use rgcs
instead)rgcs
: extended rgc
! You can put here region group IDs and region IDs, separated by comma.zhc
: iata code for destination airportahc
: iata code for departure airporthon
: city nameoid
: city idhtc
: hotel code (also known as product code). Each tour operator sets unique code for different offer/package.gid
: giata id (unique hotel id set by GIATA standards).htn
: hotel name (also used as a name of other products like bus trips and so fort)stc
: hotel category (a number of stars that hotel has)vpc
: service type code (HP - half board, OV - no service, UF - breakfast only, …)zac
: room type code (DZ - double bed room, AP - appartment, ST - studio, …)hsc
: unique hash code of trip. This is used for booking.sid
: bus stop id (only in use for content type trips)typ
: content type (hotel, paushal, trips, charter, oneway)prc
: booking numberbkc
: ORS internal booking numbersub
: offer type (lastmin, earlybird) - to search for Lastminute or Firstminute offersSome of the IDs for search parameters can be found on our CSV lists:
Service types: http://ors.si/csvs/vpcs_en.csv
Room types: http://ors.si/csvs/zacs_en.csv
Regions: http://ors.si/csvs/regions_en.csv
City ID's: http://ors.si/csvs/oids_en.csv
Hotel facts: http://ors.si/csvs/facts_en.csv
IATA Codes (airports): http://ors.si/csvs/ahcs_en.csv
Touroperators and their CRS codes: http://ors.si/csvs/tocs.csv
SOAP Call is combined with api call and arguments. First argument is a string
and represent call method. The rest of arguments are call method parameters.
To retrieve offers for a specific content type you must use a correct api call.
Syntax:
Use this syntax for using a correct call method: orsxml_{$typ}_api_call
where $typ
is a one of the available ORS content types.
Usage:
// Example for 'hotel' call method // ...use $typ to create a valid call method $typ = 'hotel'; $soapClient->{"orsxml_{$typ}_api_call"}( 'regions', $searchParams, $header) // ...or without $typ $soapClient->orsxml_hotel_api_call( 'regions', $searchParams, $header) // Example for 'pauschal' call method $soapClient->orsxml_pauschal_api_call( 'regions', $searchParams, $header) // Example for 'trips' call method $soapClient->orsxml_trips_api_call( 'regions', $searchParams, $header) // Example for 'extras' call method $soapClient->orsxml_extras_api_call( 'offers', $searchParams, $header)