Modifying Universal Records

Existing data in a Universal Record can be added to, deleted, or updated for general record and traveler data and for travel bookings.

Note:RCSrail bookings and ACH air bookings cannot be canceled because these are ticketed and paid when they are booked, and may incur a cancellation fee. These bookings must be refunded or exchanged at the PNR level. See Exceptions for details.

Schema

See the following transactions for modifying a Universal Record:

Request

  1. Send the UniversalRecordModifyReq to make changes to the Universal Record and associated PNRs.
  2. Specify the travel segments and passive segments to be modified in UniversalModifyCmd
  3. Notes:

Multiple Modifications

Each addition, deletion, or update to the UR information requires a separate UniversalModifyCmd request. For example, if three phone numbers are added to the Universal Record, three instances of UniversalModifyCmd must be sent. Or, if a hotel segment is added and a vehicle segment is deleted, two instances of UniversalModifyCmd must be sent to accommodate each change.

Note: For Worldspan (1P), it is not recommended to send modifications for multiple products (such as universal, passive, vehicle, air, and/or hotel) in a single UniversalModifyCmd request.

Canceling and Rebooking

A command to add a new segment can be combined in a single call with a request to delete an existing segment. For example, to cancel and rebook and air segment, an AirAdd request can be combined with an AirDelete request.

Loyalty Cards and Cross-Accruals

To accommodate cross-accruals among loyalty memberships, AirAdd, HotelAdd, and VehicleAdd can also be used to add or update a loyalty card for an air, car, or vehicle supplier, even if that segment type is not included in the PNR. Similarly, AirUpdate, HotelUpdate, and VehicleUpdate can be used to modify loyalty card data.

For example, AirAdd can be used to include loyalty card information in a PNR that contains only hotel segments if the air supplier has a cross-accrual agreement with a hotel chain.

For all segment types, cross-accrued loyalty cards must be added for the primary traveler in the UR; if the loyalty card is added for a non-primary traveler , an error is returned: User is not the primary traveler on the PNR, action not allowed.

Note: Prior to Universal v33.0, when a Cross Accrual was applied on a Universal Record (UR) with an existing loyalty card tied to a Passenger Name Record (PNR), if cross accrual failed, the existing loyalty card associated to the PNR was deleted. With Universal v33.0, Universal API now adds the loyalty information back in if the cross accrual application fails.

Emulating PCC

Note: Refer to Emulation for more information.

The OverridePCC is used to specify the emulated PCC in Common.xsd. When the Override PCC is sent in a booking request:

If OverridePCC is NOT sent in the booking request, the OwningPCC attribute in ProviderReservationInfo is set to the Target Branch.

Form of Payment

In Universal schema:

Commission Override

A Commission Override modifier can be included in a UR Modify request. It updates the booking with a document instructions line (DI) that allows the commission to be overridden if a commission mismatch error is returned by the provider in AirTicketingRsp: "CAT 35 COMMISSION EXISTS-ADD -OK OPTION TO OVERRIDE".

If an error is returned in the Air Ticketing response, @CommissionOverride can be sent in the UR Modify request to override the mismatch:

After the Universal Record is modified, the Air Ticketing request must be sent again.

Note: Only Worldspan (1P) support this functionality.

Special Service Requests (SSR)

@ProfileID and @ProfileSecureFlightDocKey can be included in the request for DOCO, DOCA, or DOCS SSRs (Special Service Requests). Universal API validates the TravelerID in BookingTraveler/AppliedProfile against the Universal Record and the Air Booking request that is being sent. The ProfileSecureFlightDocKey is not validated.

Both ProfileID or ProfileSecureFlightDocKey must be sent in the request for secure flight SSRs or an error is returned.

If a Traveler name is more than 55 characters, the secure flight SSR is displayed at the Universal Record level and not at the Booking Traveler level. This means that when SSR @ProfileID and @ProfileSecureFlightDocKey are sent in the request, they are returned in the response at either:

After SSRs are added successfully with the Traveler ProfileID and ProfileSecureFlightDocKey and the UR is finalized, the UR displays the ProfileID and ProfileSecureFlightDocKey that is associated to SSR DOCS/DOCO/DOCA.

Response

UniversalRecordModifyRsp is returned with the modified UR information in the UniversalRecord.

Errors

More structured warnings and errors are available if any or all of the commands fail in a Universal Modify request. Errors and warnings are mapped to the respective commands in the UniversalRecordModify request where some of the commands resulted in errors and warnings. This mapping is especially helpful when batch Universal Record modifications are made in a single request. When keys are specified in the request at UniversalRecordModifyCmd @Key, errors and warnings in the response are mapped to the key provided in the request. If all of the commands in the UniversalRecordModify request fail, structured error messages are returned in the SOAP Fault response.

Exceptions