The Cruise Rate Code task returns price category options, such as full fare, past passenger fares, promotions, and allows selection from the list of availabilities.
Transaction Name:
CruiseAvailability_1_0
Can any other transactions perform this same task?
No other transaction can perform this same task.
Can this task be performed in a sessionless environment?
This task can be performed in a sessionless environment.
Are the request and response identical on both the Apollo and Galileo systems?
The request and response are allowed only on Apollo.
List any industry-specific knowledge required to understand this task in terms of the specific business process.
Understanding of cruise-industry concepts, such as rate codes and categories, is required. Knowledge of Galileo's LeisureShopper product is helpful.
Explain any special limits or distinct restrictions to the input data.
CruiseAvailability_1_0 does not currently support availability for multiple vendors through a single availability request. To obtain availability from more than one vendor, a separate availability request must be sent to each vendor. In this case, each vendor must have a unique Customer Identity; the same User ID cannot be used at one time for different vendors.
Note: For Galileo Web Services client applications only, this transaction must be submitted using the SubmitCruiseTransaction method.
Request:
Unless otherwise specified, use ALL CAPS in any request data.
<CruiseAvailMods> is sent with the <VendorRegionMods> and <RateCodeIndicators> elements to request all rate codes associated with a sailing.
Prerequisite tasks:
Because availability data is transmitted directly from the vendor's database through the CRS, a vendor search, CruiseVendorSearch_1_0, must be performed before requesting availability from a specific vendor.
Expected response:
If the Cruise Rate Code request transaction completes successfully, <CruiseAvail> is returned with the following child elements:
<SailingRate>. all rate codes associated with a sailing along with the appropriate description and remarks information.
<VendorChangedData>. information regarding any changes that have been made by the vendor.
If the vendor needs to verify the agency, <CustomerIdentification> returns with the <TextDisplay>. If it returns with a negative response 'N', the agency needs to contact the cruise line. If a positive response 'Y', the agency will need to re-submit the request.
Error and warning responses:
If Cruise Rate Code request transaction encounters an error, the <CruiseAvail> with the <ErrText> tag is returned. The <ErrText> tag contains the error code, the element ID, and text providing a complete error message, including any inserted text items. The following error messages may be received:
| 0002 Transaction Not Allowed | |
| 0024 Link Not Available | |
| 0042 Invalid Destination | |
| 0045 Invalid Vendor Code | |
| 0048 Invalid Currency Code | |
| 0054 LeisureShopper Not Available | |
| 0091 Invalid Length | |
| 0245 Invalid Ship Name | |
| 0390 System Error Occurred | |
| 1075 Request Not Available - Cruise Line Air | |
| 1076 Request Not Available - Number in Cabin | |
| 1077 Request Not Available - Origin City Transportation | |
| 1078 Request Not Available - Destination | |
| 1079 Request Not Supported - Destination | |
| 1080 Request Not Supported - Cruise Line Air | |
| 1081 Invalid Package ID | |
| 1082 Request Not Available - Cabin | |
| 1083 Request Not Available - Sailing | |
| 1084 Children Not Allowed | |
| 1085 Time Restriction Applies - Please Call Vendor | |
| 1086 Vendor Air Required | |
| 1087 Invalid Ship Name | |
| 1088 Request Not Supported - Length of Cruise | |
| 1089 Request Not Available - Category | |
| 1090 Request Not Supported - Cruise Line Air | |
| 1091 Request Not Supported - PSGR Departure City | |
| 1092 Invalid Embarkation Port |
1093 Infants Not Allowed
1094 No Adults Included in Request
1095 Request Not Available - Rate Code
1096 Request Not Available - Charter
1097 Request Not Available - Date Out of Range
1098 Request Not Supported - Number in Party Exceeds Category Limit
1099 Cruise Availability - Agency Recognized
1100 Agency Not Recognized
1101 Date Requested - Too Close to Departure to Book in LeisureShopper
1330 KLR ID Does Not Match Request
1333 Uniglobe Not Allowed
1334 Invalid Category Changed Indicator
1335 Invalid Category
1340 Invalid Vendor Confirmation Number
1341 Invalid Number of Passengers
1342 Invalid Rate Code
1343 Invalid Rate Code Change Indicator
1344 Invalid Vendor Record ID
1345 Invalid Disembarkation Port
1346 Invalid Departure Date
1347 Invalid Departure City
1348 Invalid Departure City Changed
1349 Invalid Air Transportation
1350 Invalid Air Transportation Change
1351 Invalid Age
1358 Invalid Lowest Rate Code Indicator
Text Not Found for MSG NBR - #### (error message number)
For a complete list of cruise errors, see Cruise Error Messages.
Follow-on requests:
Cruise Rate Code is followed by the CruiseCabinHold_1_0 transaction.
|
<CruiseAvailMods> |
Terminal Equivalents: |
Apollo: LSAC |
Not available on Galileo. |
|
Ordering |
KLR |
Min/Max |
XML Tag |
|
1 |
LCA0 |
1-1 |
<VendorRegionMods> |
|
2 |
LCA1 |
1-1 |
<SailingMods> (optional for initial) |
|
<CruiseAvail> |
|
|
Ordering |
KLR |
Min/Max |
XML Tag |
|
1 |
LCRT |
1-1 |
<SailingRate> |
|
2 |
LCVV |
1-1 |
<VendorChangedData> (ONLY IF DATA CHANGES) |
|
N/A |
TEXT |
1-1 |
<TextMsg> |
|
1 |
EROR |
1-1 |
<ErrText> |
|
<CruiseAvail> |
|
|
Ordering |
KLR |
Min/Max |
XML Tag |
|
1 |
LCTD |
1-1 |
<CustomerIdentification> |
|
2 |
LCCX |
1-1 |
<TextDisplay> |