ResLink

Get Operator Voucher Component Availability


Request Profile Table

Element | @Attribute Description/Contents
GetOpVoucherComponentAvailability_RQ Root element of message.
ComponentID Element indicating ID of Operater Voucher Component.
PaxCount Element indicating number of people to check availability for.
DateFrom Start Date of the date range to check availability for.
DateTo End Date of the date range to check availability for.
Agent Element representing the agent.
To specify an agent you can just provide either the ID, or the GUID. If both are provided ResLink will make a check to see if the GUID and ID match in the database and will error if they don't.
PackageID Package Id used for pricing. If set to 0 the standalone/addon rates are returned. If an ID is specified then the rates for the component on the specified package are returned.
  @ID (optional) The agent ID to set up commissions and costs.
  @GUID (optional) The agent GUID to set up commissions and costs

Scenario:

You want to retrieve Availability of the Operator Voucher Component with ID 307. The rates to be returned are for TEST_AGENT for a standalone/addon booking.


Example message:

<?xml version="1.0" encoding="utf-8"?>
<GetOpVoucherComponentAvailability_RQ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <ComponentID xmlns="ResLink">307</ComponentID>
  <PaxCount xmlns="ResLink">1</PaxCount>
  <DateFrom xmlns="ResLink">2013-07-17</DateFrom>
  <DateTo xmlns="ResLink">2013-07-20</DateTo>
  <PackageID xmlns="ResLink">0</PackageID>
  <Agent xmlns="ResLink" ID="" GUID="TEST_AGENT" />
</GetOpVoucherComponentAvailability_RQ>


Response Profile Table

Element | @Attribute Description/Contents
GetOpVoucherComponentAvailability_RS Root element of message.
ComponentAvailabilities Collection of Component Availabilities.
ComponentAvailability Element indicating a single availability for an Operator Voucher Component.
  @ID The ID of the Component Availability.
  @AvailabilityType The type of availability. Valid values are [NONE, ALLOCATION, LIVE, FREESELL].
  @StartDate The starting date/time of the Component Availability.
  @Available Number of components available.
PricingTable Collection of PriceItem elements
PriceItem Element representing a single Pricing value
  @PaxCount The number of pax the price is for
  @RackRate The Rack Rate for the Operator Voucher Component.
  @Commission The Commission for the Operator Voucher Component.
  @Currency Currency Code.
Status Element indicating the return status of the transaction.
  @Code A numerical code for the status.
  @Message The message of the status. The messages (and corresponding codes) returned are:
Code Message
0 Get Component Availability request successful.
1 Valid Start Date for availability is required. The Start Date must be greater than the Current Date.
2 Valid Finish Date for availability is required. The Finish Date must be greater than the Current Date.
3 Start Date must be before Finish Date.
4 Invalid Pax Count. The PaxCount specified must be greater than 0.

Example message:

<?xml version="1.0" encoding="utf-16"?>
<GetOpVoucherComponentAvailability_RS xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <ComponentID xmlns="ResLink">307</ComponentID>
  <PaxCount xmlns="ResLink">1</PaxCount>
  <DateFrom xmlns="ResLink">2013-07-17</DateFrom>
  <DateTo xmlns="ResLink">2013-07-20</DateTo>
  <ComponentAvailabilities xmlns="ResLink">
    <ComponentAvailability ID="41472" AvailabilityType="ALLOCATION" StartDate="2013-07-17T00:00:00" Available="5" />
        <PricingTable>
            <PriceItem PaxCount="1" RackRate="30" Commission="9.0" Currency="AUD" />
        </PricingTable>
    <ComponentAvailability ID="41473" AvailabilityType="ALLOCATION" StartDate="2013-07-18T00:00:00" Available="3" />
        <PricingTable>
            <PriceItem PaxCount="1" RackRate="30" Commission="9.0" Currency="AUD" />
        </PricingTable>
    <ComponentAvailability ID="41474" AvailabilityType="ALLOCATION" StartDate="2013-07-19T00:00:00" Available="9" />
        <PricingTable>
            <PriceItem PaxCount="1" RackRate="33" Commission="9.10" Currency="AUD" />
        </PricingTable>
  </ComponentAvailabilities>
  <Status Code="0" xmlns="ResLink" />
  <TimeStamp xmlns="ResLink">2008-08-22T13:38:30.7035532+10:00</TimeStamp>
  <Errors xmlns="ResLink" />
  <Warnings xmlns="ResLink" />
</GetOpVoucherComponentAvailability_RS>