You are viewing an old version of this content. View the current version.
Compare with Current
View Version History
« Previous
Version 7
Next »
Each response from GP Travel HUB contains identifier whether it has been processed successfully or not - the elements <Success/>, <Warning/>, <Errors/>.
There are the following possible cases:
11.1. SUCCESS
Means that request was successfully sent and GP Travel HUB receives correct response from supplier without any warnings and errors from supplier.
Success Response Sample XML
<OTA_CancelRS Version="2" EchoToken="EchoToken" TransactionIdentifier="12232" xmlns:ota="http://www.opentravel.org/OTA/2003/05">
<Success/>
</OTA_CancelRS>
11.2. WARNING
Means that request was successfully sent and GP Travel HUB receives correct response from supplier, but there are some warnings to pay attention.
There is a structure of Warning Response that is common for every response.
Warnings/Warning:
*mandatory
Element | Attribute | Type | Description | Min…Max occurs |
---|
| Type* | integer (1, 3, 10, 11) | Defines type of the error or warning that occurred. Refers to OTA codes "Error Warning Type (EWT)”. | 1…1 |
Code* | integer (1 - 1051) | Defines Error/Warning code. | 1…1 |
Status* | string ("SENT", "NOT_SENT") | The values are (SENT | NOT_SENT). Used for defining actual status of request. | 1…1 |
ShortText* | string | Short error description. | 1…1 |
RecordID | string | This attribute specifies supplier ID. If requests spans multiple suppliers, you can use this attribute to identify which supplier caused the problem. | 0…1 |
Language* | | | |
DocURL | URI | If present, this URL refers to an online description of the error that occurred. | 0…1 |
Tag | string | If present, this attribute may identify an unknown or misspelled tag that caused an error in processing. | 0…1 |
Warning Response Sample XML
<Warnings>
<Warning Code="189" Language="en" RecordID="supplierCode" ShortText="Price has been changed." Status="SENT" Type="3"/>
</Warnings>
11.3. ERROR
Means that request was not sent to supplier (supplier temporally unavailable or failed data verification) or GP Travel HUB receives incorrect response or error from supplier. In case of error GP Travel HUB additionally returns original text from supplier.
Either there can be errors returned by GP Travel HUB itself. It mostly can be cases when a request validation not passed. Requests with incorrect format can not be processed by GP Travel HUB and passed to suppliers, so GP Travel HUB returns SOAP error message.
Errors/Error element has the same structure as Warnings/Warning.
Error Response Sample XML
<Errors>
<Error Type="3" Code="172" ShortText="Generic error." Status="NOT_SENT" Tag="NORMAL" Language="en">Invalid client specified [ID:stb, IDContext: null, Instance:null]</Error>
</Errors>
11.4. ERROR AND WARNING CODES
Here we list all possible errors and warnings that can occur at car messages.
11.4.1. HOTEL AVAILABILITY
OTA_HotelAvailRQ
Error/Warning | Error code | Error short text | Possible error reason | Status |
---|
Warning
| 22 | Passengers exceed commercial rules | Passengers (adults and/or child) can not be allocated in one room. Number of passengers is limited by supplier. | NOT_SENT |
Warning | 23 | Passenger type not supported | Supplier doesn't support infants for example. | NOT_SENT |
Warning | 26 | At least one adult must be included | No adults in list of passengers. There must be at least one. | NOT_SENT |
Warning | 58 | Price(s) cannot be validated | Supplier can not guarantee final price (end of season, etc.). | SENT |
Warning | 115 | Board basis/meal plan invalid | invalid meal type specified in request. | SENT |
Warning | 145 | Duration period or dates incorrect | End date earlier than Start date. | NOT_SENT |
Warning | 161 | Search criteria invalid | Search request contains incorrect conditions. | NOT_SENT |
Warning | 172 | Requested action not possible | In warning, it means that some of requested conditions can not be satisfied: requested currency or language does not supported by supplier, etc. | SENT
|
Warning | 172 | Requested action not possible | In warning, it means that some of requested conditions can not be satisfied: requested currency or language does not supported by supplier, etc. | NOT_SENT
|
Warning | 175 | Password invalid | Invalid credentials for supplier. | SENT |
Warning | 181 | Invalid country code | Invalid country code specified in request. | NOT_SENT |
Warning
| 184 | Language code invalid | Request contains incorrect language code. | NOT_SENT |
Warning | 187 | System currently unavailable | Supplier system unavailable at this moment. | SENT |
Warning | 189 | Price has been changed. | Price is different from search response. | SENT |
Warning | 197 | Undetermined error - please report | Unknown error. | SENT |
Warning | 254 | Reservation date has passed | Reservation date has passed. | NOT_SENT |
Warning | 320 | Invalid value | An invalid value is specified. | SENT |
Warning | 320 | Invalid value | An invalid value is specified. | NOT_SENT |
Warning | 322 | No availability | No availability found in supplier's system. | SENT |
Warning | 357 | Invalid city | Invalid city code specified. | NOT_SENT |
Warning | 361 | Invalid hotel | Invalid hotel code passes. | SENT |
Warning | 366 | Error during processing, please retry | Error during processing of request on supplier side. | SENT |
Warning | 367 | Invalid format | Message validation against XSD failed. | NOT_SENT |
Warning | 378 | Invalid - max number of rooms exceeded | Max number of rooms limitation exceeded. | SENT |
Warning | 392 | Invalid hotel code | Invalid hotel code specified. | NOT_SENT |
Warning | 392 | Invalid hotel code | Invalid hotel code specified. | SENT |
Warning | 411 | Minimum length of stay restriction | Minimum length of stay restriction. | SENT |
Warning | 422 | No active accommodation found | No active accommodation found in supplier's system. | SENT |
Warning | 430 | Ok | If requested action was completed successfully, but there is a clarifying warning. | SENT |
Warning | 436 | Rate does not exist | No available rates. | SENT |
Warning
| 438 | Requested rate not available | Requested offer is no longer available. | SENT |
Warning | 440 | Request completed | If requested action was completed successfully, but there is a clarifying warning. | SENT |
Warning
| 446 | Service request not allowed | It is not possible to request for information. Information is obtained from another source (e.g. price per day breakdown). | NOT_SENT |
Warning | 448 | System error | A system error occur. | SENT |
Warning | 450 | Unable to process | Supplier can not process the request. | SENT |
Warning | 497 | Authorization error | Authorization error on supplier side. | SENT |
Warning | 558 | Accounts are settled in a currency different from the quoted rate currency | Rates or cancellation fee are returned in other currency than it was requested. | SENT |
Warning | 568 | Unable to identify timezone. | Unable to identify timezone, for example for cancel penalties. | SENT |
11.4.2. HOTEL PRICE BREAKDOWN
OTA_HotelAvailRQ_PBD
Error/Warning | Error code | Error short text | Possible error reason | Status |
---|
Warning | 58 | Price(s) cannot be validated | Supplier can not guarantee final price (end of season, etc.). | SENT |
Warning
| 172 | Requested action not possible | In warning, it means that some of requested conditions can not be satisfied: requested currency or language does not supported by supplier, etc. | SENT |
Warning | 175 | Password invalid | Invalid credentials for supplier. | SENT |
Warning | 184 | Language code invalid | Request contains incorrect language code. | NOT_SENT |
Warning | 187 | System currently unavailable | Supplier system unavailable at this moment. | SENT |
Warning | 189 | Price has been changed. | Price is different from search response. | SENT |
Warning | 197 | Undetermined error - please report | Unknown error. | SENT |
Warning | 320 | Invalid value | An invalid value is specified. | SENT |
Warning | 320 | Invalid value | An invalid value is specified. | NOT_SENT |
Warning | 322 | No availability | No availability found in supplier's system. | SENT |
Warning | 366 | Error during processing, please retry | Error during processing of request on supplier side. | SENT |
Warning | 367 | Invalid format | Message validation against XSD failed. | NOT_SENT |
Warning | 430 | Ok | If requested action was completed successfully, but there is a clarifying warning. | SENT |
Warning | 438 | Requested rate not available | Requested offer is no longer available. | SENT |
Warning | 440 | Request completed | If requested action was completed successfully, but there is a clarifying warning. | SENT |
Warning | 446 | Service request not allowed | It is not possible to request for information. Information is obtained from another source (e.g. price per day breakdown). | NOT_SENT |
Warning | 448 | System error | A system error occur. | SENT |
Warning | 450 | Unable to process | Supplier can not process the request. | SENT |
Warning | 497 | Authorization error | Authorization error on supplier side. | SENT |
Warning | 568 | Unable to identify timezone. | Unable to identify timezone, for example for cancel penalties. | SENT |
Error | 1001 | Price has been changed. | Price in response differs from price announced in previous phases. | SENT |
11.4.3. HOTEL CHARGES
OTA_HotelChargesRQ
Error/Warning | Error code | Error short text | Possible error reason | Status |
---|
Warning
| 172 | Requested action not possible | In warning, it means that some of requested conditions can not be satisfied: requested currency or language does not supported by supplier, etc. | SENT |
Error | 175 | Password invalid | Invalid credentials for supplier. | SENT |
Error | 184 | Language code invalid | Request contains incorrect language code. | NOT_SENT |
Error | 187 | System currently unavailable | Supplier system unavailable at this moment. | SENT |
Warning | 189 | Price has been changed. | Price is different from search response. | SENT |
Error | 197 | Undetermined error - please report | Unknown error. | SENT |
Error | 320 | Invalid value | An invalid value is specified. | SENT |
Error | 320 | Invalid value | An invalid value is specified. | NOT_SENT |
Warning | 342 | Cancel fee may apply | Cancel Penalties are not provided by supplier, or provided as free text, so GP HUB is not able to return Cancellation Charges precisely as Amount. Or Cancellation policy can be shown only after reservation. | SENT |
Error | 366 | Error during processing, please retry | Error during processing of request on supplier side. | SENT |
Error | 367 | Invalid format | Message validation against XSD failed. | NOT_SENT |
Warning | 430 | Ok | If requested action was completed successfully, but there is a clarifying warning. | SENT |
Error | 438 | Requested rate not available | Requested offer is no longer available. | SENT |
Warning | 440 | Request completed | If requested action was completed successfully, but there is a clarifying warning. | SENT |
Error | 446 | Service request not allowed | It is not possible to request for information. Information is obtained from another source (e.g. price per day breakdown). | NOT_SENT |
Error | 448 | System error | A system error occur. | SENT |
Error | 450 | Unable to process | Supplier can not process the request. | SENT |
Error | 497 | Authorization error | Authorization error on supplier side. | SENT |
Warning | 568 | Unable to identify timezone. | Unable to identify timezone, for example for cancel penalties. | SENT |
Error | 783 | Room or rate not found | Requested rate is not available. | SENT |
Error | 1001 | Price has been changed. | Price in response differs from price announced in previous phases. | SENT |
11.4.4. HOTEL DESCRIPTIVE INFO
OTA_HotelDescriptiveInfoRQ
Error/Warning | Error code | Error short text | Possible error reason | Status |
---|
Error | 175 | Password invalid | Invalid credentials for supplier. | SENT |
Error | 184 | Language code invalid | Request contains incorrect language code. | NOT_SENT |
Error | 187 | System currently unavailable | Supplier system unavailable at this moment. | SENT |
Error | 320 | Invalid value | An invalid value is specified. | SENT |
Error | 320 | Invalid value | An invalid value is specified. | NOT_SENT |
Error | 366 | Error during processing, please retry | Error during processing of request on supplier side. | SENT |
Error | 367 | Invalid format | Message validation against XSD failed. | NOT_SENT |
Warning | 392 | Invalid hotel code | Invalid hotel code specified. | NOT_SENT |
Warning | 392 | Invalid hotel code | Invalid hotel code specified. | SENT |
Warning | 430 | Ok | If requested action was completed successfully, but there is a clarifying warning. | SENT |
Warning | 440 | Request completed | If requested action was completed successfully, but there is a clarifying warning. | SENT |
Error | 446 | Service request not allowed | It is not possible to request for information. Information is obtained from another source (e.g. price per day breakdown). | NOT_SENT |
Error | 448 | System error | A system error occur. | SENT |
Error | 450 | Unable to process | Supplier can not process the request. | SENT |
Error | 497 | Authorization error | Authorization error on supplier side. | SENT |
11.4.5. HOTEL RESERVATION INITIATE
OTA_HotelResRQ_Initiate
Error/Warning | Error code | Error short text | Possible error reason | Status |
---|
Error | 15 | Invalid date | Stay dates in Reservation Confirmation message differ from stay dates in Availability message. | NOT_SENT |
Error | 20 | Number of passengers invalid | Paxes (number of adults/child/infants) in Reservation Initiate message differ from paxes in Availability search.
| NOT_SENT |
Error | 22 | Passengers exceed commercial rules | Passengers (adults and/or child) can not be allocated in one room. Number of passengers is limited by supplier. | NOT_SENT |
Error | 25 | Passenger types not consistent | Passengers IDs not consistent. | NOT_SENT |
Error | 27 | Passenger details are mandatory | Mandatory passenger detail is missed, e.g. Age element is missed for a kid or baby. | SENT |
Warning | 58 | Price(s) cannot be validated | Supplier can not guarantee final price (end of season, etc.). | SENT |
Error | 87 | Booking reference invalid | Client reference is not unique. | NOT_SENT |
Error | 115 | Board basis/meal plan invalid | invalid meal type specified in request. | SENT |
Error | 142 | Occupancy rules not fulfilled | Occupancy rules not fulfilled, e.g. one passenger assigned to triple room that is not allowed by supplier. | SENT |
Error | 145 | Duration period or dates incorrect | End date earlier than Start date. | NOT_SENT |
Error | 150 | Changes are not permitted | Key fields changed between Availability and Reservation. | NOT_SENT |
Warning | 172 | Requested action not possible | In warning, it means that some of requested conditions can not be satisfied: requested currency or language does not supported by supplier, etc. | SENT
|
Error | 172 | Requested action not possible | In error, it means that the requested action is not allowed at supplier (booking cancellation, modification, passing comments, etc.). | NOT_SENT |
Error | 172 | Requested action not possible | In error, it means that the requested action is not allowed at supplier (booking cancellation, modification, passing comments, etc.). | SENT |
Error | 175 | Password invalid | Invalid credentials for supplier. | SENT |
Error | 181 | Invalid country code | Invalid country code specified in request. | NOT_SENT |
Error | 184 | Language code invalid | Request contains incorrect language code. | NOT_SENT |
Error | 187 | System currently unavailable | Supplier system unavailable at this moment. | SENT |
Warning | 189 | Price has been changed. | Price is different from search response. | SENT |
Error | 197 | Undetermined error - please report | Unknown error. | SENT |
Error | 244 | Email address is invalid | Email address is invalid. | SENT |
Error | 254 | Reservation date has passed | Reservation date has passed. | NOT_SENT |
Error | 320 | Invalid value | An invalid value is specified. | SENT |
Error | 320 | Invalid value | An invalid value is specified. | NOT_SENT |
Warning | 342 | Cancel fee may apply | Cancel Penalties are not provided by supplier, or provided as free text, so GP HUB is not able to return Cancellation Charges precisely as Amount. Or Cancellation policy can be shown only after reservation. | SENT |
Error | 352 | Invalid credit card type | Specified type of credit card is invalid. | NOT_SENT |
Error | 365 | Error credit card | Card is required for booking, but it is not specified. Mandatory card information is missing. | SENT |
Error | 366 | Error during processing, please retry | Error during processing of request on supplier side. | SENT |
Error | 367 | Invalid format | Message validation against XSD failed. | NOT_SENT |
Warning | 395 | Your comment will be ignored by hotels supplier | If supplier doesn't support comments. | SENT |
Warning/Error | 402 | Invalid room type | Invalid room type in request. | SENT/NOT_SENT |
Error | 411 | Minimum length of stay restriction | Minimum length of stay restriction. | SENT |
Error | 426 | No rates offered for this sell request | Offer is not valid for requested passengers/stay dates in supplier's system. | SENT |
Warning | 430 | Ok | If requested action was completed successfully, but there is a clarifying warning. | SENT |
Error | 438 | Requested rate not available | Requested offer is no longer available. | SENT |
Warning | 440 | Request completed | If requested action was completed successfully, but there is a clarifying warning. | SENT |
Error | 446 | Service request not allowed | It is not possible to request for information. Information is obtained from another source (e.g. price per day breakdown). | NOT_SENT |
Error | 448 | System error | A system error occur. | SENT |
Error | 450 | Unable to process | Supplier can not process the request. | SENT |
Error | 497 | Authorization error | Authorization error on supplier side. | SENT |
Warning | 568 | Unable to identify timezone. | Unable to identify timezone, for example for cancel penalties. | SENT |
Error | 1001 | Price has been changed. | Price in response differs from price announced in previous phases. | SENT |
Warning/Error
| 1002 | Сan not receive some information from supplier | Supplier did not return information about the booking/segment. Supplier did not return mandatory information for booking.
| SENT |