Each request to GP Travel HUB has to identify particular booking to be processed. For that purpose special unique identifiers are used.
You should store the necessary identifiers received from a response in your application, to be able then pass it to request on the next step.
There are identifiers that are used on different request/response chains.
11.1.1. EXCURSIONRESERVATIONIDS
The ExcursionReservationIDs is used as unique identifier of a booking.
The next values of ResID_Source attribute defines three possible types of HotelReservationID element:
"client". It is mandatory identifier required in all requests/responses. It can be any character string, but it must be unique in your system. This element allows GP Travel HUB to identify your booking within it.
"agent". This element is optional in request, but it is mandatory in response. If you did not pass "agent" identifier explicitly in request, GP Travel HUB will create it automatically (normally we just copy the "client" identifier) and return it in response. GP Travel HUB passes this identifier to supplier as client booking reference for booking identification. You can also use it as booking reference number in your system. Unlike "client" identifier, "agent" identifier may be the same for several booked services. This may be used for spanning several ordered services into one order.
"supplier". Each actual reservation returns "supplier" identifier - the unique identifier of the booking in supplier's system. Normally this value should be further used in hotel voucher. ResID_SourceContext attribute identifies the supplier. It is not necessary to pass the "supplier" identifier in all following requests; only "client" is required.
You have to store all values of HotelReservationIDs in your system, and use it unchanged through whole booking's life cycle.
Diagram 11.1.1.1. ExcursionReservationIDs flow
ExcursionReservationIDs example:
<ExcursionReservationIDs> <ExcursionReservationID ResID_Source="agent" ResID_Value="hjo8dfg"/> <ExcursionReservationID ResID_Source="client" ResID_Value="34rf4g3frre45"/> <ExcursionReservationID ResID_Source="supplier" ResID_SourceContext="supplierCode" ResID_Value="164-4732160"/> </ExcursionReservationIDs>