Below are some common use cases on how to modify a booking:

CSL hotel booking - add a new corporate ID number

To ensure successful booking modification, the request should contain the below information:

1. Add confirmationId (PNR Locator) and bookingSignature elements to verify the booking status and prevent applying any unexpected changes.

   Important! You can obtain bookingSignature value and other booking details by using the Get Booking method.

2. Add hotel details under before (original booking details) and after (desired booking details) properties to determine the scope of changes.

3. Add the hotel itemId element to indicate the desired item to change.

4. Make sure that traveler data travelers is specified in the Modify Booking Request and associated with the hotel booking (travelerIndices, leadTravelerIndex, numberOfGuests), to fulfill requirements regarding lead guest information.

5. Add paymentPolicy information.

The successful operation will result in no errors and a normalized view of the reservation will be provided in the API response (if specified in the request). In this case, new property "corporateDiscountCode": 6878700, will be added to the hotel booking.

CSL hotel booking - change the check-in/check-out date

To ensure successful booking modification, the request should contain the below information:

1. Add confirmationId (PNR Locator) and bookingSignature elements to verify the booking status and prevent applying any unexpected changes.

   Important! You can obtain bookingSignature value and other booking details by using Get Booking method.

2. Add hotel details under before (original booking details) and after (desired booking details) properties to determine the scope of changes.
3. Add the hotel itemId element to indicate the desired item to change.
4. Make sure that traveler data travelers is specified in the Modify Booking Request and associated with the hotel booking (travelerIndices, leadTravelerIndex, numberOfGuests), to fulfill requirements regarding lead guest information.
5. Add paymentPolicy information.

The successful operation will result in no errors, and a normalized view of the reservation will be provided in the API response (if specified in the request). In this case, the modified value of the checkOutDate": "2022-05-21 will be updated in the hotel booking.

Date modification outside of the original date range requires an additional step regarding a re-shop operation.

6. Add valid bookingKey property for change that requires a re-shop step.

Modify Booking will automatically verify whether this information is present in the request. If not, you will receive an error in the response:

A proper request:

The successful operation will result in no errors, and a normalized view of the reservation will be provided in the API response (if specified in the request). In this case the modified value of the checkInDate": "2022-05-24 and checkOutDate": "2022-05-28 be updated in the hotel booking.

CSL hotel booking - delete guest loyalty information

To ensure successful booking modification, the request should contain the below information:

1. Add confirmationId (PNR Locator) and bookingSignature elements to verify the booking status and prevent applying any unexpected changes.

   Important! You can obtain bookingSignature value and other booking details by using the Get Booking method.

2. Add hotel details under before (original booking details) and after (desired booking details) properties to determine the scope of changes.
3. Add the hotel itemId element to indicate the desired item to change.
4. Make sure that traveler data travelers is specified in the Modify Booking Request and associated with the hotel booking (travelerIndices, leadTravelerIndex, numberOfGuests), to fulfill requirements regarding lead guest information.
5. Add paymentPolicy information.

The successful operation will result in no errors, and a normalized view of the reservation will be provided in the API response (if specified in the request). In this case, loyaltyPrograms property will not be present in the hotel booking anymore.

CSL hotel booking - change number of guests

To ensure successful booking modification, the request should contain the below information:

1. Add confirmationId (PNR Locator) and bookingSignature elements to verify the booking status and prevent applying any unexpected changes.

   Important! You can obtain bookingSignature value and other booking details by using the Get Booking method.

2. Add hotel details under before (original booking details) and after (desired booking details) properties to determine the scope of changes.
3. Add the hotel itemId element to indicate the desired item to change.
4. Make sure that traveler data travelers is specified in the Modify Booking Request and associated with the hotel booking (travelerIndices, leadTravelerIndex, numberOfGuests), to fulfill requirements regarding lead guest information.
5. Add paymentPolicy information.
6. Add valid bookingKey property for change that requires a re-shop step.

Scenario 1: Modification of number of guests without altering guest personal information

Update numberOfGuests to reflect information stored in the newly generated bookingKey.

The successful operation will result in no errors and a normalized view of the reservation will be provided in the API response (if specified in the request). In this case, numberOfGuests property will change the value from 1 to 2.

Scenario 2: Modification of number of guests including a change of guest personal information

Update numberOfGuests to reflect information stored in the newly generated bookingKey. You can modify hotel guest association by using travelerIndices property. Sample request containing:

• increasing the number of guests
• altering traveler details
• changing lead guest
• new loyalty information
• updating typos in the original traveler name
  {
      "bookingSignature": "9ee349dccc46231954b80367fabb9f7c644f9226ec6dff9079906262b9a24f8f995f3db63e0ed47a31e291cb9256e9237e8ad7969ccfb249f1be69af73f2d9d1",
      "confirmationId": "BGLGVG",
      "retrieveBooking": true,
      "before": {
          "creationDetails": {
              "agencyIataNumber": "63211116"
          },
          "hotels": [
              {
                  "itemId": "22",
                  "checkInDate": "2022-05-24",
                  "checkOutDate": "2022-05-28",
                  "leadTravelerIndex": 1,
                  "room": {
                      "travelerIndices": [
                          1
                      ]
                  },
                  "numberOfGuests": 1,
                  "paymentPolicy": "GUARANTEE"
              }
          ],
          "travelers": [
              {
                  "givenName": "JOHN",
                  "surname": "SMITHHH",
                  "passengerCode": "ADT",
                  "phones": [
                      {
                          "number": "+123456"
                      }
                  ],
                  "loyaltyPrograms": [
                      {
                          "programType": "LOYALTY_ID",
                          "programNumber": "987654321"
                      }
                  ]
              }
          ],
          "payments": {
              "formsOfPayment": [
                  {
                      "type": "PAYMENTCARD",
                      "cardTypeCode": "VI",
                      "cardNumber": "4487971000000006",
                      "expiryDate": "2022-10"
                  }
              ]
          }
      },
      "after": {
          "creationDetails": {
              "agencyIataNumber": "63211116"
          },
          "hotels": [
              {
                  "itemId": "22",
                  "bookingKey": "e3ce2acd-4e09-4223-ab7c-f982f0013163",
                  "checkInDate": "2022-05-24",
                  "checkOutDate": "2022-05-28",
                  "leadTravelerIndex": 2,
                  "room": {
                      "travelerIndices": [
                          1,2
                      ]
                  },
                  "numberOfGuests": 2,
                  "paymentPolicy": "GUARANTEE"
              }
          ],
          "travelers": [
              {
                  "givenName": "JOHN",
                  "surname": "SMITH",
                  "passengerCode": "ADT"
              },
              {
                  "givenName": "MARY",
                  "surname": "SMITH",
                  "passengerCode": "ADT",
                  "phones": [
                      {
                          "number": "+676767"
                      }
                  ],
                  "loyaltyPrograms": [
                      {
                          "programType": "LOYALTY_ID",
                          "programNumber": "4455667"
                      }
                  ]
              }
          ],
          "payments": {
              "formsOfPayment": [
                  {
                      "type": "PAYMENTCARD",
                      "cardTypeCode": "VI",
                      "cardNumber": "4487971000000006",
                      "expiryDate": "2022-10"
                  }
              ]
          }
      }
  }

  Expected response:

  {
      "booking": {
          "startDate": "2022-05-24",
          "endDate": "2022-05-28",
          "isTicketed": false,
          "agencyCustomerNumber": "1234567",
          "creationDetails": {
              "creationUserSine": "AWV",
              "creationDate": "2022-05-16",
              "creationTime": "07:07",
              "agencyIataNumber": "63211116",
              "userWorkPcc": "U9PK",
              "userHomePcc": "U9PK",
              "primeHostId": "1S"
          },
          "contactInfo": {
              "phones": [
                  "123456"
              ]
          },
          "travelers": [
              {
                  "givenName": "JOHN",
                  "surname": "SMITH",
                  "type": "ADULT",
                  "passengerCode": "ADT"
              },
              {
                  "givenName": "MARY",
                  "surname": "SMITH",
                  "type": "ADULT",
                  "passengerCode": "ADT",
                  "phones": [
                      {
                          "number": "+676767"
                      }
                  ],
                  "loyaltyPrograms": [
                      {
                          "programType": "LOYALTY_ID",
                          "programNumber": "4455667"
                      }
                  ]
              }
          ],
          "remarks": [
              {
                  "type": "FORM_OF_PAYMENT",
                  "text": "VI4XXXXXXXXXXX0006¥10/22"
              }
          ],
          "hotels": [
              {
                  "itemId": "79",
                  "confirmationId": "3253513908-",
                  "hotelName": "THE WALDORF HILTON LONDON",
                  "address": {
                      "street": "ALDWYCH",
                      "city": "LONDON",
                      "postalCode": "WC2B 4DD",
                      "countryCode": "GB"
                  },
                  "checkInDate": "2022-05-24",
                  "checkInTime": "00:00",
                  "checkOutDate": "2022-05-28",
                  "checkOutTime": "00:00",
                  "leadTravelerIndex": 2,
                  "room": {
                      "quantity": 1,
                      "description": "QUEEN GUEST ROOM DOUBLE BED IN CONTEMPORY SETTING PLASMA TV RAINDROP SHOWER MODEM POINT ROOM ONLY, STRICTER THAN STANDARD CXL POLICY. SEE TERMS AND CONDITIONS FOR CXL POLICY. 326.01 PER NIGHT STARTING 24MAY22 395.01 PER NIGHT STARTING 25MAY22 326.01 PER NIGHT STARTING 27MAY22 TAXES AND SERVICE CHARGES INCLUDED",
                      "roomRate": {
                          "amount": "395.01",
                          "currencyCode": "GBP"
                      },
                      "travelerIndices": [
                          1,
                          2
                      ]
                  },
                  "isRefundable": true,
                  "refundPenalties": [
                      {
                          "applicableFromDate": "2022-05-16T12:09:39.716666",
                          "applicableToDate": "2022-05-21T00:00:00",
                          "penalty": {
                              "amount": "0.00",
                              "currencyCode": "GBP"
                          }
                      },
                      {
                          "applicableFromDate": "2022-05-21T00:00:00",
                          "applicableToDate": "2022-05-28T00:00:00",
                          "penalty": {
                              "amount": "0.00",
                              "currencyCode": "GBP"
                          }
                      }
                  ],
                  "hotelStatusCode": "HK",
                  "hotelStatusName": "Confirmed",
                  "chainCode": "HL",
                  "chainName": "HiltonHotels",
                  "propertyId": "100020146",
                  "contactInfo": {
                      "phones": [
                          "44-207-8362400"
                      ],
                      "faxes": [
                          "44-207-8367244"
                      ]
                  },
                  "guaranteeTypeCode": 5,
                  "guaranteeTypeName": "Credit card",
                  "paymentPolicy": "GUARANTEE",
                  "payment": {
                      "subtotal": "1442.03",
                      "total": "1442.03",
                      "currencyCode": "GBP"
                  },
                  "numberOfGuests": 2,
                  "sourceTypeCode": 100,
                  "sourceTypeName": "Sabre GDS"
              }
          ],
          "allSegments": [
              {
                  "id": "79",
                  "type": "HOTEL",
                  "text": "3253513908-",
                  "vendorCode": "HL",
                  "locationCode": "LHR",
                  "address": {
                      "street": "ALDWYCH",
                      "city": "LONDON",
                      "postalCode": "WC2B 4DD",
                      "countryCode": "GB"
                  },
                  "startDate": "2022-05-24",
                  "startTime": "00:00",
                  "endDate": "2022-05-28",
                  "endTime": "00:00"
              }
          ],
          "payments": {
              "hotelTotals": [
                  {
                      "subtotal": "1442.03",
                      "total": "1442.03",
                      "currencyCode": "GBP"
                  }
              ],
              "formsOfPayment": [
                  {
                      "type": "PAYMENTCARD",
                      "cardTypeCode": "VI",
                      "cardNumber": "4XXXXXXXXXXX0006",
                      "expiryDate": "2022-10"
                  }
              ]
          },
          "otherServices": [
              {
                  "chainCode": "HL",
                  "serviceMessage": "HHL HL 12451 ARR24MAY CXL 3 DAYS PRIOR TO AR"
              },
              {
                  "chainCode": "HL",
                  "serviceMessage": "HHL HL 12451 ARR24MAY CREDIT CARD GUARANTEE"
              },
              {
                  "chainCode": "HL",
                  "serviceMessage": "HHL 100020146 A03DN8  D SEMI-FLEX"
              },
              {
                  "chainCode": "HL",
                  "serviceMessage": "HHL 100020146 A03DN8  C CANCEL 3 DAY PRIOR TO ARRIVA"
              },
              {
                  "chainCode": "HL",
                  "serviceMessage": "HHL 100020146 A03DN8  D QUEEN GUEST ROOM DOUBLE BED"
              },
              {
                  "chainCode": "HL",
                  "serviceMessage": "HHL 100020146 A03DN8  D IN CONTEMPORY SETTING PLASMA"
              },
              {
                  "chainCode": "HL",
                  "serviceMessage": "HHL 100020146 A03DN8  TP 1442.03 GBP APPROX. TTL PRI"
              },
              {
                  "chainCode": "HL",
                  "serviceMessage": "HHL 100020146 A03DN8  TD INCLUDES TAXES AND SURCHARG"
              }
          ]
      },
      "request": {
          "bookingSignature": "9ee349dccc46231954b80367fabb9f7c644f9226ec6dff9079906262b9a24f8f995f3db63e0ed47a31e291cb9256e9237e8ad7969ccfb249f1be69af73f2d9d1",
          "confirmationId": "BGLGVG",
          "retrieveBooking": true,
          "receivedFrom": "Modify Booking",
          "before": {
              "creationDetails": {
                  "agencyIataNumber": "63211116"
              },
              "hotels": [
                  {
                      "itemId": "22",
                      "checkInDate": "2022-05-24",
                      "checkOutDate": "2022-05-28",
                      "leadTravelerIndex": 1,
                      "room": {
                          "travelerIndices": [
                              1
                          ]
                      },
                      "numberOfGuests": 1,
                      "paymentPolicy": "GUARANTEE"
                  }
              ],
              "payments": {
                  "formsOfPayment": [
                      {
                          "type": "PAYMENTCARD",
                          "cardTypeCode": "VI",
                          "cardNumber": "4487971000000006",
                          "expiryDate": "2022-10"
                      }
                  ]
              },
              "travelers": [
                  {
                      "givenName": "JOHN",
                      "surname": "SMITHHH",
                      "passengerCode": "ADT",
                      "phones": [
                          {
                              "number": "+123456"
                          }
                      ],
                      "loyaltyPrograms": [
                          {
                              "programType": "LOYALTY_ID",
                              "programNumber": "987654321"
                          }
                      ]
                  }
              ]
          },
          "after": {
              "creationDetails": {
                  "agencyIataNumber": "63211116"
              },
              "hotels": [
                  {
                      "itemId": "22",
                      "bookingKey": "e3ce2acd-4e09-4223-ab7c-f982f0013163",
                      "checkInDate": "2022-05-24",
                      "checkOutDate": "2022-05-28",
                      "leadTravelerIndex": 2,
                      "room": {
                          "travelerIndices": [
                              1,
                              2
                          ]
                      },
                      "numberOfGuests": 2,
                      "paymentPolicy": "GUARANTEE"
                  }
              ],
              "payments": {
                  "formsOfPayment": [
                      {
                          "type": "PAYMENTCARD",
                          "cardTypeCode": "VI",
                          "cardNumber": "4487971000000006",
                          "expiryDate": "2022-10"
                      }
                  ]
              },
              "travelers": [
                  {
                      "givenName": "JOHN",
                      "surname": "SMITH",
                      "passengerCode": "ADT"
                  },
                  {
                      "givenName": "MARY",
                      "surname": "SMITH",
                      "passengerCode": "ADT",
                      "phones": [
                          {
                              "number": "+676767"
                          }
                      ],
                      "loyaltyPrograms": [
                          {
                              "programType": "LOYALTY_ID",
                              "programNumber": "4455667"
                          }
                      ]
                  }
              ]
          }
      }
  }

Important! Modify Booking prevents removing travelers originally stored in the PNR. This operation is available only if a particular traveler is only part of the lodging guest list. You can still update their name/surname information though.

CSL hotel booking - modify the form of payment

To ensure successful booking modification, the request should contain the below information:

1. Add confirmationId (PNR Locator) and bookingSignature elements to verify the booking status and prevent applying any unexpected changes.

   Important! You can obtain bookingSignature value and other booking details by using the Get Booking method.

2. Add hotel details under before (original booking details) and after (desired booking details) properties to determine the scope of changes.
3. Add the hotel itemId element to indicate the desired item to change.
4. Make sure that traveler data travelers is specified in the Modify Booking Request and associated with the hotel booking (travelerIndices, leadTravelerIndex, numberOfGuests), to fulfill requirements regarding lead guest information.
5. Add paymentPolicy information.

The successful operation will result in no errors, and a normalized view of the reservation will be provided in the API response (if specified in the request). In this case, formsOfPayment property will contain new credit card information.

Expected response:

Group booking - modify the traveler details

To ensure successful booking modification, the request should contain the below information:

1. Add confirmationId (PNR Locator) and bookingSignature elements to verify the booking status and prevent applying any unexpected changes.

   Important! You can obtain bookingSignature value and other booking details by using the Get Booking method.

2. Add booking details under the before (original booking details) and after (desired booking details) properties to determine the scope of the changes.
3. Ensure that traveler data (travelers) specified in the Modify Booking request is associated with the group (isGrouped: true).

The successful operation will result in no errors, and a normalized view of the reservation will be provided in the API response (if specified in the request). In this case, the travelers array will contain new adult and infant traveler details. Additionally, the phone number of the first traveler will be updated.

Expected response:

ATPCO booking - add new special service request (SSR)

To ensure successful booking modification, the request should contain the below information:

1. Add confirmationId (PNR Locator) and bookingSignature elements to verify the booking status and prevent applying any unexpected changes.

   Important! You can obtain bookingSignature value and other booking details by using the Get Booking method.

2. Add booking details under the before (original booking details) and after (desired booking details) properties to determine the scope of the changes.
3. Ensure that special service information (specialServices) is specified in the Modify Booking request.

The successful operation will result in no errors, and a normalized view of the reservation will be provided in the API response (if specified in the request). In this case, the specialServices array will contain new SSR details. Additionally, traveler's information will be updated (added email and frequent flyer program).

Expected response:

ATPCO booking - modify identity document (PASSPORT) details

To ensure successful booking modification, the request should contain the information below:

1. Add confirmationId (PNR Locator) and bookingSignature elements to verify the booking status and prevent applying any unexpected changes.

   Important! You can obtain bookingSignature value and other booking details by using the Get Booking method.

2. Add booking details under the before (original booking details) and after (desired booking details) properties to determine the scope of your changes.
3. Ensure that passport information (travelers.identityDocuments) is updated in the Modify Booking request.

Important! Modification of identity documents is done by means of the travelers.identityDocuments properties. The corresponding special service request (specialServices) is changed automatically. A direct modification of the DOCO, DOCA, and DOCO SSRs is not allowed.

Successful operation results in no errors, and a normalized view of the reservation is provided in the API response (if specified in the request). In this case, the identityDocuments array contains new PASSPORT document details.

Expected response: