Passive HHL Segments
Passive HHL Segments are created using HotelCreateReservationReq. Note that unlike other passive hotel segment types, they are NOT created using PassiveCreateReservationReq.
Implementation by Provider
See Implemented Transactions for provider functionality specific to each transaction.
Provider |
Implementation |
---|---|
Galileo (1G) | Supports Passive HHL segments in Galileo, but does not support them via Universal API. |
Apollo (1V) | Does not support Passive HHL segments. |
Worldspan (1P) | Supports Passive HHL segments in Universal API. |
Booking Confirmations and Status Codes
Passive HHL segments require the supplier’s Booking Confirmation identifier in the Hotel Booking (HotelCreateReservationReq). @BookingConfirmation supports 1 to 25 alphanumeric characters.
The Booking Confirmation can also be manipulated for an existing hotel reservation using UniversalRecordModifyReq. A Booking Confirmation can be:
- Added using UniversalRecordModify/UniversalModifyCmd/HotelAdd @BookingConfirmation.
- Changed using Universal Record Modify/UniversalModifyCmd/HotelUpdate @BookingConfirmation.
- Deleted using Universal Record Modify/UniversalModifyCmd/HotelUpdate , where the value of @BookingConfirmation="0".
Booking Confirmations can only be added when the booking also contains a passive status code:
- For creating a new hotel booking (HotelCreateReservationReq), the following passive status codes are supported: MK and ML.
- For adding a Booking Confirmation to an existing hotel reservation(UR Modify/HotelAdd), the following passive status codes are supported: AK, BK, MK, and GK.
- For updating an existing Booking Confirmation (UR Modify/HotelUpdate), the following passive status codes are supported: AK, BK, GK, MK, AL, BL, GL, and ML.
Booking Confirmation and Status Code information is supported in Universal Record History in HotelReservation when these values are added, updated, or retrieved for a PNR.
HX Status Codes
An HX status code for the hotel reservation is not returned when UniversalRecordModifyReq/HotelUpdate is sent with Booking Confirmation Number=”0” and Booking Status in Hotel reservation is “AK/BK/GK/MK/ AL/BL/GL/ML”.
Universal Record History
The following Passive HLL segment data is added to the Universal Record History.
Functionality | ElementType and Action |
---|---|
Create Hotel Booking (HotelCreateReservationReq) | ElementType=”HotelReservation” Action=”HotelCreate” |
Add Booking Confirmation | ElementType=”HotelReservation” Action=”HoteAdd” |
Update Booking Confirmation | ElementType=”HotelReservation” Action=”HotelUpdate” |
Delete Booking Confirmation | ElementType=”HotelReservation” Action=”HotelUpdate” |
Retrieve Booking Confirmation | ElementType=”HotelReservation” Action=”Sync” |
Multiple UniversalModifyCmd with HotelAdd/HotelUpdate | ElementType=”HotelReservation” Action=”URModify” |
Error and Warning Messages
Condition | Message |
---|---|
If a Status Code is not included with the Booking Confirmation in a Hotel Booking request. | Passive status Code required for Booking Confirmation. |
If a Booking Confirmation is already present in an existing Hotel Reservation. | Booking Confirmation already exists. |
If @BookingConfirmation and @StatusCode in a Hotel Booking request for a provider other than “1P” (Worldspan), these values are ignored. |
Booking Confirmation and Status Code not allowed for requested Provider. |
If a UR Modify (HotelAdd) request attempts to add a Booking Confirmation to a Hotel Booking (PNR) that already contains a Booking Confirmation. | Booking Confirmation already exists. |
If a UR Modify (HotelUpdate) request attempts to change Booking Confirmation in a Hotel Booking (PNR) that does not already contain a Booking Confirmation. | Booking Confirmation must be present in Hotel Reservation for update. |
If @Booking Confirmation in HotelCreateReservationReq or UR Modify (HotelAdd) is empty or has a value of “0”. |
Provide 1-25 valid characters for Booking Confirmation. |
If @StatusCode is sent in UR Modify (HotelAdd) with a value that is not AK, BK, MK, or GK. | Booking Confirmation can only be added/updated for Passive Hotel Reservation. |
If the added or updated Booking Confirmation is not validated by Worldspan (1P). | Booking Confirmation can only be added/updated for Passive Hotel Reservation. |
If a UR Modify (HotelUpdate) request does not contain a Booking Confirmation.
|
Booking Confirmation must be present in Hotel Reservation for update. |