Functional Errors (HTTP 200)
These errors may occur when the request can not be satisfied within the CRS due to business reasons. Reasons may include the property being temporarily inactive or there is no available inventory for the requested date of arrival. These HTTP 200 errors only return from calls made to Dcshop. They will not be seen calling DCRes. An example:
{
"arrivalDate": "2019-12-22",
"departureDate": "2019-12-26",
"lengthOfStay": 735,
"numAdults": 2,
"propCode": "LONSB",
"statusCode": 1740,
"statusMessage": "REQUESTED RATE PLANS ARE NOT AVAILABLE"
}
DCShop responses that return availablity will always return statusCode=0.
Examples of HTTP200 responses that did not return availability from DCShop can return the following status codes:
HTTP 200 Codes - CRS errors
Status | Message | Comments |
---|---|---|
1 | Reservation System error | Error due to a temporary CRS system performance issue. Client is advised to retry the booking. |
7 | Invalid length of stay was specified | |
14 | Invalid property code was specified | |
51 | PRESELL 01 JAN 2020 | Various temporarily inactive property errors due to reasons such as brand change / under construction, etc. NOTE: This is an example message, the actual message will be specific to the property |
52 | Property Inactive | |
610 | The data base table has too many records to support this transaction | Dates searched that the CRS could not provide availability for. Most frequently occurs if searched dates are in past or father than 1 year in the future |
1740 | Requested Rate Plans Are Not Available |
Bad Request (HTTP 400)
Swagger Error Response and Notification Definition
HTTP 400 responses can be returned due to malformed JSON requests or data that fails validation within API or CRS.
By default, the response will contain an ‘ErrorDetail’ block defining the error class and the service context that triggered the response. The ErrorDetail may include one or more ‘Notifications’ which provide additional details of the specific error type and fields affected (optional). HTTP400 error responses will include error information including the Hilton custom error code as well as associated OTA error code based on OTA 2014B ERR table. The full list of errors that are currently supported can be found in this spreadsheet. OTA Error Codes.xlsm
Swagger ErrorDetail
ErrorDetail:
required:
- context
- code
- message
type: object
properties:
context:
type: string
code:
type: integer
message:
type: string
notifications:
type: array
items:
$ref: '#/definitions/ErrorNotification'
Swagger ErrorNotification
ErrorNotification:
required:
- message
type: object
properties:
code:
type: string
otaErrorCode:
type: integer
description: Online travel agency error code.
fields:
type: array
items:
type: string
message:
type: string
Error Response Example with Notification
For HTTP status code 400, an error body will be returned with the details about the errors. The body of the response will be in the following format:
Expanded details on cause of common errors that clients have reported trouble resolving.
HTTP 400 Codes - API errors
Status | Message | Sub Code | Sub Message | Comments |
---|---|---|---|---|
1001 | Reservation Error | 45 | No travel agent address | Modify request did not pass TA address thus treated as attempt to remove from reservation. |
1001 | Reservation Error | 180 | Operator ID 'xxx' is invalid at location 'TVPT' | Hilton configuration error |
1001 | Reservation Error | 234 | Record not found | The ID number provided is not valid or was not found in the system. This applies to any ID number, including Client ID (both Corporate & Travel Agent), Member ID (e.g., Hilton Honors Number, Travel Partner Number), etc. |
1001 | Reservation Error | 284 | There cannot be more names than max occ | The number of guest names passed on the request exceed the number of people allowed in the room type NOTE: This includes additional names. |
400 | Reservation Error | 1182 | Guarantee type (Guaranteed) is not valid for this property | The credit card type used is not accepted for guarantees. |