Versions Compared

Version Old Version 15 New Version 16
Changes made by

Yana Brilevskaya

Yana Brilevskaya

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: commissions were added in Total

Reservation Initiate Response returns final price and availability of the requested offer.

OTA_HotelResRS:

*mandatory

Element

Attribute

Type

Description

Min…Max occurs

TransactionIdentifier*

Unique transaction ID generated by GP Travel HUB. This attribute must be further passed on reservation confirmation or ignore step to identify the booking request.

1...1

Success*

For more information see Common Data Description section in Glossary.

Warnings/Warning

HotelReservations*

Unites all the separate room reservations in one basket.

1...1

ResStatus*

string ("Reserved", "Requested", "Request denied")

Mandatory only for multibooking reservation. Reservation status that can be one of:

"Reserved" - accommodation was successfully reserved. Anyway ,reservation confirmation request is still required.

"Request denied" - supplier denied this request and accommodation can not be booked.

"Requested" - GP Travel HUB has done best effort to ensure that accommodation can be booked, however, this status doesn't guarantee, that accommodation will be booked. This status usually denotes, that supplier doesn't support two-pass booking.

Info

Important note: in Multibooking the status of the whole reservation (basket) is defined according to the status of sub-reservations and is calculated by the following priority:

  1. If any of HotelReservation has ResStatus Request denied=> ResStatus of the whole booking is Request denied.

  2. If any of HotelReservation has ResStatus Requested=> ResStatus of the whole booking is Requested.

  3. If any of HotelReservation has ResStatus Reserved=> ResStatus of the whole booking is Reserved.

1...1

HotelReservations/ HotelReservation*

In successful response, element represents booking information.

Info

Important note: each separate room reservation has a separate reservation status (ResStatus), and these reservation statuses could differ for each reservation block. 

1...*

HotelReservations/Total

Total booking price for all rooms for all travelers and whole stay duration. If a Service was added in OTA_HotelResRQ, then the Total price includes the Service price. Mandatory only for multibooking reservation.

0...1

AmountAfterTax*

For more information see Common Data Description section in Glossary.

1...1

CurrencyCode*

1...1

CommissionAmount

Contains supplier comission if supplier returns it.

0...1

CommissionPercent

Contains the commission percent.

0...1

HotelReservations/ HotelReservationIDs/ HotelReservationID

The same client/agent reservation ID that has been sent in Reservation Initiate Request. For multi-room booking is mandatory, it defines a unique basket identifier within all separate room reservations.

0...1

ResID_Source*

string ("basket")

Has value "basket" for the whole list of room reservations.

1...1

ResID_Value*

string

A unique identifier of a separate multi-room reservation (basket).

1...1

OTA_HotelResRS/HotelReservations/HotelReservation*:

Element

Attribute

Type

Description

Min…Max occurs

ResStatus*

string ("Reserved", "Requested", "Request denied")

Shows the status of a particular reservation.

1...1

RoomStays/RoomStay*

Room description that correspond to requested rooms.

1...*

ResGuests/ResGuest*

For more information see Reservation Initiate Request section.

1...*

ResGlobalInfo*

For more information see Reservation Initiate Request section.

1...1

OTA_HotelResRS/HotelReservations/HotelReservation/RoomStays/RoomStay*:

Element

Attribute

Type

Description

Min…Max occurs

RoomTypes/RoomType*

For more information see Hotel Availability Response section.

1...1

RatePlans/RatePlan*

For more information see Hotel Availability Response section.

1...1

RoomRates/RoomRate*

Contains room offer description including availability, room type, meal type, discount and price.

1...*

TimeSpan*

For more information see Common Data Description section in Glossary.

Guarantee

For more information see Hotel Availability Response section.

0...5

CancelPenalties/CancelPenalty

For more information see Hotel Availability Response section.

0...*

Total*

For more information see Hotel Availability Response section.

1...1

TotalRetail

For more information see Hotel Availability Response section.

0...1

BasicPropertyInfo*

For more information see Hotel Availability Response section.

1...1

OTA_HotelResRS/HotelReservations/HotelReservation/RoomStays/RoomStay/RoomRates/RoomRate*:

Elements are the same as in Hotel Availability Response, but some are added:

Element

Attribute

Type

Description

Min…Max occurs

InvBlockCode*

A room identifier. Must start from 1 and must be unique within booking. Together with ResGuestRPH this element allows to allocate passengers in rooms. It must be "1" in current implementation. For multi-room reservation InvBlockCode increments within next room reservation.

1...1

Services/Service

Additional services that can be booked with room.  

Info

Note: Reservation Initiate Response will return ONLY services that were requested at Reservation Initiate Request, not all the services available.

Info

Note: In Reservation Initiate and Confirmation Responses price for the service is always included in Total Price.

Info

Note: In Reservation Initiate and Confirmation Responses Inclusive attribute will always have value Inclulsive=“true“.

Attributes remain the same as in Hotel Availability Response, might be one additional:

0...*

ReservationStatusType*

Has the same type as ResStatus.

Specifies booking status of requested services.

Info

Note: If ResStatus is “Reserved“ it does not guarantee that ReservationStatusType will be “Reseved” too. Service booking status and the status of the reservation may be different.

1…1

...