AncillarySSR

  • 用途：通过本接口可获取到供应商收费辅营的价格，包含托运行李、登机行李、快速登机等
  • 请求方式：POST
  • 接口加密：否

请求参数

参数名称 类型 必填 说明
requestId string ✅ 请求ID，预订环节中的各个接口是唯一的，可通过本字段串联一个完整的预订流程，长度32位
segments array/Segment Element ✅ 行程信息
orderNo string ✅ AeroHub机票订单号，出票后再次购买辅营产品时必须传入
isCache int ⬜️ 是否使用缓存数据，为空或者为 0- 不使用缓存，为1-使用缓存数据

array/Segment Element

参数名称 类型 必填 说明
depAirport string ✅ 出发机场代码，采用 IATA 三字代码做为标准
arrAirport string ✅ 到达机场代码，采用 IATA 三字代码做为标准
flightNumber string ✅ 航班号，如：CA123
depDate str ✅ 起飞日期，格式：YYYYMMDD，例如20230310 表示2023年3月10日
passengerName string ✅ 乘客姓名，姓和名之间用/隔开，LastName/FirstName MiddleName
passengerNo int ✅ 乘客的序号，从0开始
ageType int ✅ 乘客类型，0 成人、1 儿童、2 婴儿
nationality string ⬜️ 乘客国籍，采用 ISO 3166 二字码做为标准
birthday string ✅ 出生日期，格式：YYYYMMDD
gender string ✅ 乘客性别，M 男、F 女
cardType int ✅ 证件类型：1 未知、2 护照、3 港澳通行证、4 台湾通行证、5 台胞证（台湾往返内地通行证）、6 回乡证（港澳往返内地通行证）、7 国际海员证、8 身份证
cardNo string ⬜️ 证件号码，最大 15 个字符
cardExpired string ⬜️ 证件有效期，格式：YYYYMMDD
pnrCode string ✅ 机票订单的PNR编码，可用此编码做航司官网的预定管理

请求示例

{
    "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"
    }]
}

返回参数

参数名称 类型 必填 说明
marketErrorCode int ✅ 供应商系统错误码，用于协助AeroHub与供应商排查问题，请如实返回真实错误
marketErrorMsg string ✅ 供应商系统错误描述，请如实返回真实错误原因，长度小于 300
passengers array/Passengers Element ⬜️ 乘客信息，出票后再次购买辅营时返回
flights array/flights Element ✅ 行程与行李信息

array/passengers Element

参数名称 类型 必填 说明
passengerName string ✅ 乘客姓名，姓和名之间用/隔开，LastName/FirstName MiddleName
ageType int ✅ 乘客类型，0 成人、1 儿童、2 婴儿
passengerNo int ✅ 乘客的序号，从0开始
nationality string ⬜️ 乘客国籍，采用 ISO 3166 二字码做为标准
birthday string ✅ 出生日期，格式：YYYYMMDD
gender string ✅ 乘客性别，M 男、F 女
cardType int ⬜️ 证件类型：1 未知、2 护照、3 港澳通行证、4 台湾通行证、5 台胞证（台湾往返内地通行证）、6 回乡证（港澳往返内地通行证）、7 国际海员证
cardNo string ⬜️ 证件号码，最大 15 个字符
cardExpired string ⬜️ 证件有效期，格式：YYYYMMDD

array/flights Element

参数名称 类型 必填 说明
passengerNo int ✅ 乘客的序号，从0开始
ssrs array/ssrs Element ✅ 航段的行李信息
flightNumber string ✅ 航班号，如：CA123
isDirect bool ✅ 行李是否直达，true 直达、false 非直达，需要重新办理托运

array/ssrs Element

参数名称 类型 必填 说明
applyType int ✅ 辅营类型，1 预定时、 2 预定后
name string ✅ 辅营名称
code string ✅ 辅营代码，规则参考本文档的SSR Code Enum
type int ✅ 辅营类型，0 托运行李、1 登机行李、2 值机、3 登机行李+优先登机套餐
bookSalePrice float ✅ 辅营价格，保留2位小数
currency string ✅ 辅营币种，应与机票一致
weight int ✅ 行李重量，未知或没有可赋值0
dimensions object/dimensions Element ⬜️ 辅营的规格型号
unit string ✅ 辅营的计量单位，行李请传递KG，值机和快速登机请传递PC
desc string ✅ 针对辅营的说明，没有请传空字符串

object/dimensions Element

参数名称 类型 必填 说明
length int ✅ 辅营的长度
width int ✅ 辅营的宽度
height int ✅ 辅营的高度

返回示例

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

  • 行李的重量与代码一起指定（ 例如PA20表示20公斤，若航司没有重量规格，则传递PA00 ）
代码 示例 定义 描述
PA+重量 PA20 预订中托运行李 该代码用于乘客在预订时添加托运行李
PB+重量 PB15 预订后托运行李 该代码用于乘客在预订后添加托运行李
CA+重量 CA10 预订中登机行李 该代码用于乘客在预订中添加登机（随身携带）行李
CB+重量 CB10 预订后登机行李 该代码用于乘客在预订后添加登机（随身携带）行李
PE00 PE00 预订中快速登机 该代码表示在预订时添加快速登机，若快速登机和登机行李等其他辅营一起打包，则要按快速登机传值（例如：PE00）
PS00 PS00 预订后快速登机 该代码表示在预订后添加快速登机，若快速登机和登机行李等其他辅营一起打包，则要按快速登机传值（例如：PS00）
Author：AeroHub  Create time：2024-03-26 17:31
Last editor：AeroHub  Update time：2025-10-28 15:50