AirPostBookingAncillary

AirPostBookingAncillary is an after-booking service provided by airlines that allows to add ancillary services to their existing flight booking, such as baggage allowance and flight meals. To access this service, customers are required to provide their Order ID and GDS Booking Reference, which will enable the airline to retrieve their booking details and display the available ancillary options.

Once have accessed the AirPostBookingAncillary service, they can select from a variety of ancillary services based on their personal preferences and needs. For example, a customer may choose to add extra baggage allowance, pre-order a special meal

The AirPostBookingAncillary service is particularly useful who may have forgotten to add an ancillary service during the initial booking process or wants to make changes in their preBookingAncillary service selection.

Note: GDS-Global Distribution System.

Schema

Document

Name: Provide the name for the request. This is a String value.
ReferenceVersion: Provide the version number. This is a Numeric value.

Party

Travel Agency Sender:
- Name: Provide the name for the request. This is a String value.
- IATA Number: Provide the IATA number for the request. This is a String value.
- Agency ID: Provide the agency ID. This is a String value.
- Contacts: This is an Array.
  - EmailContact: Provide the email contact for the request. This is a String value.

Query

OrderID: This is the unique identifier that is typically provided by the airline at the time of booking. This is the required field, and the value will be String.
GdsBookingReference: This is the code that is used by GDS to identify the booking. The GDS booking references are typically provided by the airlines at the time of booking. This is the required field, and the value will be the String.

Response References

ShoppingResponseId: Unique identifier for the shopping response.
ServiceListResponseId: Unique identifier for the service list response.

ALaCarteOffer

Parameters :
- TotalItemQuantity - Total Passenger count.
TimeLimits:
- OfferExpiration: The timestamp when the offer expires.
ALaCarteOfferItem: List of additional purchase options.
- OfferItemID: Unique identifier for the item.
- Eligibility:
  - PassengerRefs: Reference to the passenger(s).
  - SegmentRefs: Reference to the applicable flight segment(s).
- Price:
  - Base: The base price before taxes.
    - BookingCurrencyPrice: Price in the booking currency.
    - EquivCurrencyPrice: Price in the equivalent currency
  - Total: Final price including taxes.
    - BookingCurrencyPrice: Total price in booking currency.
    - EquivCurrencyPrice: Equivalent total price in requested currency.
  - Tax: Tax amount applied to the item.
    - BookingCurrencyPrice: Tax amount in booking currency.
    - EquivCurrencyPrice: Equivalent tax amount in requested currency.

Service List

ServiceList: A list of services associated with offer items.
- OfferItemRefs: Reference to the associated offer item.
- ServiceID: Unique identifier for the service.
- ServiceDefinitionRef: Reference to the service definition.

Data Lists

PassengerList: Contains passenger details.
- Passengers: List of passengers.
  - PassengerID: Unique identifier for the passenger.
  - PTC: Passenger type code (e.g., ADT for adult).
ServiceDefinitionList: Defines the available services.
- ServiceDefinition: List of service definitions.
  - ServiceDefinitionID: Unique identifier for the service definition.
  - ServiceType: Type of service (e.g., BAG for baggage).
  - ServiceCode: Service code identifier.
  - ServiceName: Human-readable name of the service.
FlightSegmentList: Details about individual flight segments.
- FlightSegment: List of flight segments.
  - SegmentKey: Unique identifier for the segment.
  - Departure: Departure details.
    - AirportCode: IATA code of the departure airport.
    - Date: Departure date.
    - Time: Departure time.
    - AirportName: Name of the departure airport.
    - Terminal: Terminal details (if available).
  - Arrival: Arrival details.
    - AirportCode: IATA code of the arrival airport.
    - Date: Arrival date.
    - Time: Arrival time.
    - AirportName: Name of the arrival airport.
    - Terminal: Terminal details (if available).
  - MarketingCarrier: Marketing airline information.
    - AirlineID: IATA airline code.
    - Name: Airline name.
    - FlightNumber: Flight number assigned by the marketing carrier.
  - OperatingCarrier: Operating airline information.
    - AirlineID: IATA airline code.
    - Name: Airline name.
    - FlightNumber: Flight number assigned by the operating carrier.
  - Equipment: Aircraft details.
    - AircraftCode: Code of the aircraft.
    - Name: Name of the aircraft.
  - Code: Additional segment codes.
    - MarriageGroup: Marriage group code for flight segments.
  - FlightDetail: Additional flight details.
    - FlightDuration: Total flight duration.
    - Stops: Number of stopovers.
  - BrandId: Fare brand identifier.
FlightList: List of flights.
- Flight: Flight details.
  - FlightKey: Unique flight identifier.
  - Journey: Journey details.
    - Time: Total journey time.
    - Stops: Number of stops in the journey.
  - SegmentReferences: References to associated flight segments.
OriginDestinationList: Origin and destination details.
- OriginDestination: List of origin-destination details.
  - OriginDestinationKey: Unique identifier for the origin-destination pair.
  - DepartureCode: Departure airport code.
  - ArrivalCode: Arrival airport code.
  - FlightReferences: References to flights associated with this origin-destination pair.

Request URL

curl --location --request POST 'https://newapi.tltid.com/AirPostBookingAncillary' \
--header 'Authorization: <YOUR_ACCESS_TOKEN>' \

Request Body Sample

{
    "AirServiceListRQ": {
        "Document": {
            "Name": "Wintlt NDC GATEWAY",
            "ReferenceVersion": "1.0"
        },
        "Party": {
            "Sender": {
                "TravelAgencySender": {
                    "Name": "Skyroute B2B Portal",
                    "IATA_Number": "1111111111",
                    "AgencyID": "Skyroute B2B Portal",
                    "Contacts": {
                        "Contact": [
                            {
                                "EmailContact": "pst@claritytts.com"
                            }
                        ]
                    }
                }
            }
        },
        "Query": {
            "OrderID": "NREFQIDC",
            "GdsBookingReference": ["OUFSVJ"]
        }
    }
}

Response Sample

{
    "AirServiceListRS": {
        "Document": {
            "Name": "API GATEWAY",
            "ReferenceVersion": "1.2"
        },
        "Party": {
            "Sender": {
                "TravelAgencySender": {
                    "Name": "Lucky Travels",
                    "IATA_Number": "",
                    "AgencyID": "",
                    "Contacts": {
                        "Contact": [
                            {
                                "EmailContact": "j.priyadharshini@claritytts.com"
                            }
                        ]
                    }
                }
            }
        },
        "ShoppingResponseId": "1679299656823220978",
        "ServiceListResponseId": "1679299905760281451",
        "ALaCarteOffer": {
            "Parameters": {
                "TotalItemQuantity": 1
            },
            "TimeLimits": {
                "OfferExpiration": "2023-03-20T08:41:48"
            },
            "ALaCarteOfferItem": [
                {
                    "OfferItemID": "ALaCarteOfferItem-1",
                    "Eligibility": {
                        "PassengerRefs": "ADT1",
                        "SegmentRefs": "Segment1"
                    },
                    "Price": {
                        "Base": {
                            "BookingCurrencyPrice": 0,
                            "EquivCurrencyPrice": 0
                        },
                        "Tax": {
                            "BookingCurrencyPrice": 0,
                            "EquivCurrencyPrice": 0
                        },
                        "Total": {
                            "BookingCurrencyPrice": 0,
                            "EquivCurrencyPrice": 0
                        }
                    }
                }
            ]
        },
        "ServiceList": [
            {
                "OfferItemRefs": "ALaCarteOfferItem-1",
                "ServiceID": "1679299908086613481",
                "ServiceDefinitionRef": "SRV-1"
            }
        ],
        "DataLists": {
            "PassengerList": {
                "Passengers": [
                    {
                        "attributes": {
                            "PassengerID": "ADT1"
                        },
                        "PassengerID": "ADT1",
                        "PTC": "ADT",
                        "BirthDate": "1996-03-15",
                        "NameTitle": "Mr",
                        "FirstName": "LEBRON",
                        "MiddleName": "",
                        "LastName": "JAMES",
                        "Gender": "Male",
                        "TravelDocument": {
                            "DocumentNumber": "",
                            "ExpiryDate": "2001-01-01",
                            "IssuingCountry": "",
                            "DocumentType": "P"
                        },
                        "Preference": {
                            "WheelChairPreference": {
                                "Reason": ""
                            },
                            "SeatPreference": "any"
                        },
                        "LoyaltyProgramAccount": [],
                        "ContactInfoRef": "CTC1"
                    }
                ]
            },
            "ServiceDefinitionList": {
                "ServiceDefinition": [
                    {
                        "ServiceDefinitionID": "SRV-1",
                        "ServiceType": "BAG",
                        "ServiceCode": "ASSISTIVE DEVICE",
                        "ServiceName": "ASSISTIVE DEVICE"
                    }
                ]
            },
            "FlightSegmentList": {
                "FlightSegment": [
                    {
                        "SegmentKey": "Segment1",
                        "Departure": {
                            "AirportCode": "YKF",
                            "Date": "2023-05-26",
                            "Time": "22:00:00",
                            "AirportName": "Waterloo Airport",
                            "Terminal": {
                                "Name": ""
                            }
                        },
                        "Arrival": {
                            "AirportCode": "YVR",
                            "Date": "2023-05-26",
                            "Time": "22:45:00",
                            "AirportName": "Vancouver International Airport",
                            "Terminal": {
                                "Name": ""
                            }
                        },
                        "MarketingCarrier": {
                            "AirlineID": "WS",
                            "Name": "Westjet",
                            "FlightNumber": "8503"
                        },
                        "OperatingCarrier": {
                            "AirlineID": "WS",
                            "Name": "Westjet",
                            "FlightNumber": "8503"
                        },
                        "Equipment": {
                            "AircraftCode": "73H",
                            "Name": "73H"
                        },
                        "Code": {},
                        "FlightDetail": {
                            "FlightDuration": {
                                "Value": "3 Hrs 45 Min"
                            },
                            "Stops": {
                                "Value": 0
                            }
                        },
                        "BrandId": ""
                    }
                ]
            },
            "FlightList": {
                "Flight": [
                    {
                        "FlightKey": "Flight1",
                        "Journey": {
                            "Time": "3 H 45 M",
                            "Stops": 0
                        },
                        "SegmentReferences": "Segment1"
                    }
                ]
            },
            "OriginDestinationList": {
                "OriginDestination": [
                    {
                        "OriginDestinationKey": "OD1",
                        "DepartureCode": "YKF",
                        "ArrivalCode": "YVR",
                        "FlightReferences": "Flight1"
                    }
                ]
            }
        }
    }
}