Skip to end of metadata
Go to start of metadata

You are viewing an old version of this content. View the current version.

Compare with Current View Version History

« Previous Version 4 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="tok1" 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="isrotel" 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 CODES

Error/Warning

Error code

Error short text

Possible error reason

Status

Error

16

Service has been cancelled.

User attempts to request Modification or Cancellation for a booking that is already cancelled.

SENT

Error

20

Number of passengers invalid.

  1. Paxes (number of adults/child/infants) in Reservation Initiate message differ from paxes in Availability search.

  2. Paxes (number of adults/child/infants) in Reservation Confirmation message differ from paxes in Reservation Initiate message.

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

Error

87

Booking reference invalid.

Client reference is not unique.

NOT_SENT

Error

95

Booking already canceled.

Attempt to cancel canceled booking.

SENT

Error

97

Booking reference not found.

Attempt to make retrieve for nonexistent booking.

NOT_SENT

Error

150

Changes are not permitted.

  1. Key fields changed between Availability and Reservation.

  2. Stay dates in Reservation message differ from stay dates in Availability search.

NOT_SENT

Error

189

Price has been changed.

Price is different from search response.

SENT

Error

193

Cancellation process failed.

SENT: Cancellation failed in supplier's system.
NOT_SENT: User attempts to run Cancel Confirmation without Cancel Initiate.

SENT/NOT_SENT

Error

244

Email address is invalid.

Email address is invalid.

SENT

Error

264

Reservation cannot be cancelled.

Reservation cannot be cancelled in supplier's system.

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

367

Invalid format.

Message validation against XSD failed

NOT_SENT

Error

426

No rates offered for this sell request.

Offer is not valid for requested passengers/stay dates in supplier's system.

SENT

Error

1001

Price has been changed.

Price in response differs from price announced in previous phases.

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.

  1. Supplier can not guarantee final price (end of season, etc.).

  2. Any messages where the price cannot be specified or the calculation is accurate.

SENT

Warning

161

Search criteria invalid.

  1. Search request contains incorrect conditions.

  2. Search days limit is 30 days.

NOT_SENT

Warning

322

No availability.

No availability found in supplier's system.

SENT

Warning

342

Cancel fee may apply.

  1. 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.

  2. Cancellation policy can be shown only after reservation.

SENT

Warning

357

Invalid city.

Invalid city code specified.

NOT_SENT

Warning

413

Modification.

Any changes have occurred in booking.

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

Warning

568

Unable to identify timezone.

Unable to identify timezone, for example for cancel penalties.

SENT

Warning/Error

22

Passengers exceed commercial rules.

  1. Passengers (adults and/or child) can not be allocated in one room.

  2. Number of passengers is limited by supplier.

NOT_SENT

Warning/Error

115

Board basis/meal plan invalid.

Invalid meal type specified in request.

SENT

Warning/Error

145

Duration period or dates incorrect.

  1. End date is earlier than Start date.

  2. You can't provide passed dates.

  3. The number of nights is limited by supplier.

  4. Start date must be within period of 365 days starting from current moment.

NOT_SENT

Warning/Error

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.
In error, it means that the requested action is not allowed at supplier (booking cancellation, modification, passing comments, etc.).

SENT/NOT_SENT

Warning/Error

175

Password invalid.

Invalid credentials for supplier.

SENT

Warning/Error

181

Invalid country code.

Invalid country code specified in request.

NOT_SENT

Warning/Error

184

Language code invalid.

Request contains incorrect language code.

NOT_SENT

Warning/Error

187

System currently unavailable.

Supplier system unavailable at this moment.

SENT

Warning/Error

197

Undetermined error - please report.

Unknown error.

SENT

Warning/Error

254

Reservation date has passed.

Reservation date has passed.

NOT_SENT

Warning/Error

320

Invalid value.

An invalid value is specified.

SENT/NOT_SENT

Warning/Error

321

Required field missing.

SENT

Warning/Error

366

Error during processing, please retry.

Error during processing of request on supplier side.

SENT

Warning/Error

396

Invalid name.

If the supplier requires a specific language or encoding for passenger names

SENT/NOT_SENT

Warning/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

Warning/Error

448

System error.

A system error occur.

SENT

Warning/Error

450

Unable to process.

Supplier can not process the request.

SENT

Warning/Error

497

Authorization error.

Authorization error on supplier side.

SENT

  • No labels