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:
9.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>
9.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* | | For more information see Common Data Description section in Glossary. | |
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>
9.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>
9.4. ERROR AND WARNING CODES
Here we list all possible errors and warnings that can occur at car messages.
9.4.1. CAR LOCATION SEARCH
GP_VehLocSearchRQ
Warning/Error | Code | Short text | Possible reason | Status |
Warning | 172 | Requested action not possible | Search by city is not supported. Please use another type of search. Search by points is not supported. Please use another type of search. Search by airport is not supported. Please use another type of search. Supplier does not support the following airports: JFK. The driver cannot be a resident of the US country.
| NOT_SENT |
Warning | 172 | Requested action not possible | The specified seconds in pick up or return time were changed. Supplier doesn't support requested language.
| SENT |
Error | 450 | Unable to process | | SENT |
9.4.2. CAR RENTAL LOCATION DETAIL
GP_VehLocDetailRQ
Warning/Error | Code | Short text | Possible reason | Status |
Warning | 172 | Requested action not possible | Supplier does not provide such method.
| NOT_SENT |
Error | 450 | Unable to process | | SENT |
9.4.3. CAR AVAILABILITY SEARCH
GP_VehAvailRateRQ
Warning/Error | Code | Short text | Possible reason | Status |
Warning | 172 | Requested action not possible | Search by city is not supported. Please use another type of search. Search by points is not supported. Please use another type of search. Search by airport is not supported. Please use another type of search. Supplier does not support the following airports: JFK. The driver cannot be a resident of the US country.
| NOT_SENT |
Warning | 172 | Requested action not possible | The specified seconds in pick up or return time were changed. Supplier doesn't support requested language.
| SENT |
Warning | 322 | No availability | | SENT |
Warning | 558 | Accounts are settled in a currency different from the quoted rate currency | Requested currency is not supported by supplier. | SENT |
Warning | 450 | Unable to process | | SENT |
9.4.3. CAR RENTAL CONDITIONS
GP_VehRateRuleRQ
Warning/Error | Code | Short text | Possible reason | Status |
Error | 322 | No availability | | SENT |
Error | 450 | Unable to process | | SENT |
9.4.3. CAR RESERVATION INITIATE
GP_VehResRQ_Initiate
Warning/Error | Code | Short text | Possible reason | Status |
Error | 15 | Invalid date | The search was done for the next dates: PickUpDateTime - 2018-03-01T10:00:00, ReturnDateTime - 2018-03-09T12:00:00, but booking is doing for dates: PickUpDateTime - 2018-03-02T10:00:00, ReturnDateTime - 2018-03-10T12:00:00. Please check reservation request or do new search. | NOT_SENT |
Error | 27 | Passenger details are mandatory | NamePrefix is mandatory, but the value is empty. | NOT_SENT |
Warning | 172 | Requested action not possible | Requested equipment cannot be booked. Supplier does not support comments. Email address has been changed. We use test@gpsolutions.com for test only.
| SENT |
Error | 172 | Requested action not possible | Requested equipment cannot be booked. | SENT |
Warning | 189 | Price has been changed | The price has been changed. | SENT |
Error | 197 | Undetermined error - please report | Search was done for a driver of 25 years old, but reservation is doing for driver of 30 years old. Element country code is required, but value is empty. The search was done for a driver from a country with code - DE, but booking is doing for driver from a country with code - FR. Please check reservation request or do new search.
| NOT_SENT |
Warning | 231 | Requested special equipment not available | Special Equipment(s) is(are) not available. | SENT |
Error | 450 | Unable to process | | SENT |
Warning | 568 | Unable to identify timezone. | Unable to identify timezone. Periods of penalties (dates and time) have timezone of PickUp location. | SENT |
9.4.3. CAR RESERVATION IGNORE
GP_VehResRQ_Ignore
Warning/Error | Code | Short text | Possible reason | Status |
Error | 161 | Search criteria invalid | TransactionIdentifier 999999 not found. | NOT_SENT |
Error | 450 | Unable to process | Transaction identifier 499 has been already closed. | NOT_SENT |
9.4.3. CAR RESERVATION CONFIRMATION
GP_VehResRQ_Book
Warning/Error | Code | Short text | Possible reason | Status |
Error | 15 | Invalid date | The search was done for the next dates: PickUpDateTime - 2018-03-01T10:00:00, ReturnDateTime - 2018-03-09T12:00:00, but booking is doing for dates: PickUpDateTime - 2018-03-02T10:00:00, ReturnDateTime - 2018-03-10T12:00:00. Please check reservation request or do new search. | NOT_SENT |
Error | 27 | Passenger details are mandatory | NamePrefix is mandatory, but the value is empty. | NOT_SENT |
Warning | 172 | Requested action not possible | Requested equipment cannot be booked. Supplier does not support comments. Email address has been changed. We use test@gpsolutions.com for test only.
| SENT |
Warning | 189 | Price has been changed | The price has been changed. | SENT |
Error | 197 | Undetermined error - please report | Reservation with this transaction has been already ignored. Search was done for a driver of 25 years old, but reservation is doing for driver of 30 years old. State code value is mandatory for citizens of the United States and Canada. Element country code is required, but value is empty. Information about country code on initiate and booking is not equal. The search was done for a driver from a country with code - DE, but booking is doing for driver from a country with code - FR. Please check reservation request or do new search.
| NOT_SENT |
Warning | 231 | Requested special equipment not available | Special Equipment(s) is(are) not available. | SENT |
Error | 450 | Unable to process | Your reservation wasn't confirmed by supplier. Please, contact supplier and check your booking. | SENT |
Warning | 568 | Unable to identify timezone. | Unable to identify timezone. Periods of penalties (dates and time) have timezone of PickUp location. | SENT |
9.4.3. CAR BOOKING RETRIEVAL QUOTE
GP_VehResRQ_Quote
Warning/Error | Code | Short text | Possible reason | Status |
Error | 97 | Booking reference not found | Client reference 'realFake' is not found. | NOT_SENT |
Warning | 172 | Requested action not possible | The request was not sent to the supplier. The booking information was taken from the cache. | NOT_SENT |
Error | 450 | Unable to process | | SENT |
9.4.3. CAR CANCELLATION INITIATE
OTA_CancelRQ_Initiate
Warning/Error | Code | Short text | Possible reason | Status |
Error | 16 | Service has been cancelled | User attempts to request Modification or Cancellation for a booking that is already cancelled. | NOT_SENT |
Warning | 58 | Price(s) cannot be validated | This cancellation fees may be not final. | SENT |
Error | 95 | Booking already canceled | Booking already canceled. | SENT |
Warning | 342 | Cancel fee may apply | Charges amount may be inappropriate. Please, contact the supplier. | SENT |
Error | 450 | Unable to process | | SENT |
9.4.3. CAR CANCELLATION IGNORE
OTA_CancelRQ_Ignore
Warning/Error | Code | Short text | Possible reason | Status |
Error | 97 | Booking reference not found | Client reference 'realFake' is not found. | NOT_SENT |
Error | 161 | Search criteria invalid | TransactionIdentifier 999999 not found. | NOT_SENT |
Error | 450 | Unable to process | Transaction identifier 499 has been already closed. | NOT_SENT |
9.4.3. CAR CANCELLATION CONFIRMATION
OTA_CancelRQ_Book
Warning/Error | Code | Short text | Possible reason | Status |
Warning | 58 | Price(s) cannot be validated | This cancellation fees may be not final. | SENT |
Error | 95 | Booking already canceled | Booking already canceled. | NOT_SENT |
Error | 193 | Cancellation process failed | Cancellation operation for transaction 1 has been already ignored. | NOT_SENT/SENT |
Error | 197 | Undetermined error - please report | Undetermined error - please report. | NOT_SENT |
Error | 450 | Unable to process | | SENT |
0 Comments