AncillarySSR

  • Purpose: Through this interface, you can obtain the price of the supplier’s auxiliary services, including checked baggage, boarding baggage, express boarding, etc.
  • Request: POST
  • Encryption: No

Request

Parameter Name Type Required Description
requestId string ✅ Request ID. Each interface in the booking process is unique. A complete booking process can be connected through this field. The length is 32 bits.
segments array/Segment Element ✅ Itinerary information
orderNo string ⬜️ AeroHub ticket order number must be entered when purchasing ancillary products again after the ticket is issued.
isCache int ⬜️ Whether to use cached data, empty or 0 - do not use cache, 1 - use cached data

array/Segment Element

Parameter Name Type Required Description
depAirport string ✅ Departure airport code, using IATA three-letter code as the standard
arrAirport string ✅ Arrival airport code, using IATA three-letter code as the standard
flightNumber string ✅ Flight number, such as: CA123
depDate str ✅ Departure date, format: YYYYMMDD, for example, 20230310 means March 10, 2023
passengerName string ✅ Passenger name, separated by / between last name and first name, LastName/FirstName MiddleName
passengerNo int ✅ Passenger’s serial number, starting from 0
ageType int ✅ Passenger type, 0 adult, 1 child, 2 infant
nationality string ⬜️ Passenger nationality, using ISO 3166 two-character code as the standard
birthday string ✅ Date of birth, format: YYYYMMDD
gender string ✅ Passenger gender, M male, F female
cardType int ✅ Document types: 1 Unknown, 2 Passport, 3 Hong Kong and Macao Pass, 4 Taiwan Permit, 5 Taiwan Compatriot Permit (Taiwan and Mainland Travel Permit), 6 Home Return Permit (Hong Kong and Macao Mainland Travel Permit), 7 International Seaman’s Certificate, 8 ID Card
cardNo string ⬜️ ID number, maximum 15 characters
cardExpired string ⬜️ Certificate validity period, format: YYYYMMDD
pnrCode string ✅ The PNR code of the ticket order. This code can be used for reservation management on the airline’s official website.

Sample Request

{
    "requestId": "74e155e75f9d4a33",
    "orderNo": "F123123123111121",
    "isCache": 0,
    "segments": [{
        "depAirport": "CNX",
        "arrAirport": "DMK",
        "flightNumber": "DD133",
        "depDate": "20231226",
        "passengerName": "CHEN/RU",
        "passengerNo": 1,
        "ageType": 0,
        "birthday ": "20231226",
        "gender ": "F"
    }]
}

Response

Parameter Name Type Required Description
marketErrorCode int ✅ Supplier system error code is used to assist AeroHub and suppliers in troubleshooting problems. Please return the true error truthfully.
marketErrorMsg string ✅ Supplier system error description, please truthfully return the real error reason, the length is less than 300 characters
passengers array/Passengers Element ⬜️ Passenger information, returned when purchasing auxiliary accommodation again after ticketing
flights array/flights Element ✅ Itinerary and baggage information

array/passengers Element

Parameter Name Type Required Description
passengerName string ✅ Passenger name, separated by / between last name and first name, LastName/FirstName MiddleName
ageType int ✅ Passenger type, 0 adult, 1 child, 2 infant
passengerNo int ✅ Passenger’s serial number, starting from 0
nationality string ⬜️ Passenger nationality, using ISO 3166 two-character code as the standard
birthday string ✅ Date of birth, format: YYYYMMDD
gender string ✅ Passenger gender, M male, F female
cardType int ⬜️ Document types: 1 Unknown, 2 Passport, 3 Hong Kong and Macao Pass, 4 Taiwan Permit, 5 Taiwan Compatriot Permit (Taiwan and Mainland Travel Permit), 6 Home Return Permit (Hong Kong and Macao Mainland Travel Permit), 7 International Seaman’s Certificate
cardNo string ⬜️ ID number, maximum 15 characters
cardExpired string ⬜️ Certificate validity period, format: YYYYMMDD

array/flights Element

Parameter Name Type Required Description
passengerNo int ✅ Passenger’s serial number, starting from 0
ssrs array/ssrs Element ✅ Baggage information for the flight segment
flightNumber string ✅ Flight number, such as: CA123
isDirect bool ✅ Whether the baggage is direct, true is direct, false is indirect, and needs to be checked in again.

array/ssrs Element

Parameter Name Type Required Description
applyType int ✅ Auxiliary operation type, 1 during reservation, 2 after reservation
name string ✅ Auxiliary camp name
code string ✅ Auxiliary code, please refer to the SSR Code Enum of this document for rules.
type int ✅ Auxiliary type, 0 checked baggage, 1 boarding baggage, 2 check-in, 3 boarding baggage + priority boarding package
bookSalePrice float ✅ Auxiliary operation price, rounded to 2 decimal places
currency string ✅ The auxiliary currency should be consistent with the ticket
weight int ✅ Baggage weight, unknown or no value can be assigned to 0
dimensions object/dimensions Element ⬜️ Specifications and models of auxiliary operations
unit string ✅ For the unit of measurement of the auxiliary operation, please pass KG for luggage, and please pass PC for check-in and express boarding.
desc string ✅ For the description of the auxiliary camp, please pass an empty string if there is no description.

object/dimensions Element

Parameter Name Type Required Description
length int ✅ length of auxiliary camp
width int ✅ Auxiliary camp width
height int ✅ height of auxiliary camp

Response Example

Success Response:

{
    "marketErrorCode": 200,
    "marketErrorMsg": "Successful",
    "passengers": [{
        "passengerName": "John/Doe",
        "ageType": 0,
        "passengerNo": 1,
        "nationality": "US",
        "birthday": "19850101",
        "gender": "M",
        "cardType": 2,
        "cardNo": "1234567890",
        "cardExpired": "20251231"
        }],
    "flights": [{
        "passengerNo": 0,
        "ssrs": [{
            "applyType": 1,
            "name": "40 KG",
            "code": "PA40",
            "type": 0,
            "bookSalePrice": 38.86,
            "currency": "USD",
            "weight": 40,
            "dimensions": {
                "length": 10,
                "width": 5,
                "height": 2
                },
            "unit": "KG",
            "desc": ""
        },
        {
            "applyType": 1,
            "name": "25 KG",
            "code": "PA25",
            "type": 0,
            "bookSalePrice": 22.4,
            "currency": "USD",
            "weight": 25,
            "dimensions": {
                "length": 10,
                "width": 5,
                "height": 2
                },
            "unit": "KG",
            "desc": ""
        }],
        "flightNumber": "DD133",
        "isDirect": true
    }]
}

SSR Code Enum

  • The weight of the baggage is specified together with the code (for example, PA20 means 20 kilograms. If the airline has no weight specification, PA00 is passed)
Code Example definition describe
PA+Weight PA20 Checked baggage during booking This code is used by passengers to add checked baggage when booking
PB+Weight PB15 Check baggage after booking This code is used by passengers to add checked baggage after booking
CA+Weight CA10 Check-in baggage during booking This code is used by passengers to add carry-on (carry-on) baggage to their booking
CB+Weight CB10 Check-in baggage after booking This code is used by passengers to add check-in (carry-on) baggage after booking
PE00 PE00 Quick boarding during booking This code indicates that fast boarding is added when booking. If fast boarding is packed with other ancillary items such as boarding baggage, the value must be passed as fast boarding (for example: PE00)
PS00 PS00 Quick boarding after booking This code indicates that fast boarding is added after booking. If fast boarding is packed with other ancillary items such as boarding baggage, the value must be passed as fast boarding (for example: PS00)
Author：AeroHub  Create time：2024-04-18 11:46
Last editor：AeroHub  Update time：2026-10-20 11:54