Add/Modify Offer Reference Payload API Reference

POST

book/offer/reservationworkbench/{workbenchID}/offers/buildfromcatalogofferings

For {workbenchID} send the workbench identifier returned in ReservationResponse/Identifer/value in the workbench create response.

Base path:

Pre-production https://api.pp.travelport.com/11/air/

Production https://api.travelport.com/11/air/

Send the Add/Modify Offer request as part of the GDS ticket exchange process. The Add/Modify Offer reference payload sends identifiers from an offer returned in a preceding Exchange Search response to use that offer to modify the offer on the current itinerary. The system compares the existing itinerary with the new itinerary, deletes any flight segments no longer needed, and adds the new flight segments. Any unmodified segments remain as they are.

Send Add/Modify after using the JSON Exchange Eligibility and Exchange Search APIs to confirm eligibility and search for a new itinerary. After Add/Modify Offer, use the Exchange Ticketing APIs to either hold or ticket the modified itinerary.

The Add/Modify Offer reference payload request supports the automated exchange workflow, in which updates are made and new ticket/s issued using the JSON APIs, Manual exchanges, which ticket a modified itinerary after making updates outside the JSON APIs, are not supported.

Request

Also see Authorization and Common Headers.

Query Parameters

None.

Request Body

Show Add/Modify Offer Request Body Table (reference payload)

Object	Description	Required/Optional
OfferQueryBuildFromCatalogOfferings	Top level object.	Required
BuildFromCatalogOfferingsRequest	Top level object.	Required
CatalogOfferingsIdentifier	Top level object for transaction identifier from the Exchange Search response. Key value pair: id: The id value from the Exchange Search response.	Required
CatalogOfferingsIdentifier/Identifier	Transaction identifier from the Exchange Search response.	Required
value	Send value from CatalogOfferings/Identifier/value	Required
authority	Send value from CatalogOfferings/Identifier/authority	Required
CatalogOfferingIdentifier	Top level object for offer identifier from the Exchange Search response for the offer you want to exchange for.	Required
CatalogOfferingIdentifier/Identifier	Offer identifier from the Exchange Search response.	Required
value	Send value from CatalogOffering/Identifier/value	Required
authority	Send value from CatalogOffering/Identifier/authority	Required

Response

The response returns a confirmation identifier.

Show Add/Modify Response Body Table (reference payload)

Object	Description
OfferListResponse	Top level object. Includes OfferID object.
OfferID	Top level object. Includes Identifier object.
Identifier	Internal identifier for the response. Key value pairs: authority: Source of information. value: Unique system-generated identifier.

Object

Description

OfferListResponse

Top level object. Includes OfferID object.

OfferID

Top level object. Includes Identifier object.

Identifier

Internal identifier for the response.

Key value pairs:

authority: Source of information.

value: Unique system-generated identifier.

Example Request

For additional examples and scenarios, download the developer toolkits and see Using Postman and Developer Toolkits.

The response returns a confirmation identifier per below.

Show Example

{
 "OfferQueryBuildFromCatalogOfferings": {
  "BuildFromCatalogOfferingsRequest": {
   "@type": "BuildFromCatalogOfferingsRequestAir",
   "CatalogOfferingsIdentifier": {
    "id": "CatalogOfferings_1",
    "Identifier": {
     "value": "04373e5e-b6b8-4cae-93eb-b630bcf6afdc",
     "authority": "Travelport"
    }
   },
   "CatalogOfferingIdentifier": {
    "Identifier": {
     "value": "o0.0",
     "authority": "Travelport"
    }
   }
  }
 }
}

Example Response

For additional examples and scenarios, download the developer toolkits and see Using Postman and Developer Toolkits.

The response returns a confirmation identifier per below.

Show Example Add/Modify Offer response

{
 "OfferListResponse": {
  "OfferID": [
   {
    "@type": "OfferIdentifier",
    "Identifier": {
     "authority": "Travelport",
     "value": "0995bea0-602d-4572-b1ef-bbe1c6e44807"
    }
   }
  ]
 }
}