AncillaryOrderDetail

  • 用途：用于获取指定订单的详情信息，包含所有订单状态
  • 请求方式：POST
  • 接口加密：否
  • FareMarket地址：/supplier/v1/api/ancillary_order_detail

请求参数

参数名称 类型 必填 说明
apiKey string ✅ 每个供应商有自己唯一的apiKey，用于表示供应商身份，AeroHub在接口测试前提供给供应商
requestId string ✅ 请求ID，出票环节每个次调用是唯一的，长度32位
ancillaryOrderNo string ✅ AeroHub的辅营订单号，与AncillaryOrderList接口请求时的AncillaryOrderNo对应

请求示例

{
    "apiKey": "PcrNq8964iFUkE0CyVV4bhgXXX",
    "requestId": "3fd720b5bf544161bd14c535c9",
    "ancillaryOrderNo": "F1745527321051406356"
}

返回参数

参数名称 类型 必填 说明
code int ✅ AeroHub的状态码，参考通用说明中的Market Errors
msg string ✅ AeroHub的错误说明，参考通用说明中的Market Errors
data object ✅ 辅营订单详情

Data Object

参数名称 类型 必填 说明
purchaseOrderNo string ✅ AeroHub的机票订单号
ancillaryOrderNo string ✅ AeroHub的辅营订单号
ancillaryOrderStatus string ✅ 辅营订单状态：TOBEISSUED:待出票, ISSUED:已完成,REJECTED:已拒回(指出票失败)
totalCost float ✅ 售后辅营总价
lastUpdateTime string ✅ 订单在AeroHub系统最后更新的时间，采用 ISO 8601 格式
createTime string ✅ 订单在AeroHub系统创建的时间，采用 ISO 8601 格式
ssr array/SSR Element ⬜️ 售后辅营信息
contact object/Contact Element ⬜️ 辅营订单联系人信息

object/Contact Element

参数名称 类型 必填 说明
fullName string ✅ 联系人姓名，姓和名之间用/隔开，LastName/FirstName MiddleName
address string ✅ 联系地址
postCode string ⬜️ 邮编
email string ✅ 联系人邮箱
mobile string ✅ 联系人手机号

array/SSR Element

参数名称 类型 必填 说明
passengerNo int ✅ 乘客序号
passengerName string ✅ 乘客姓名，姓和名之间用/隔开，LastName/FirstName MiddleName
nationality string ✅ 乘客国籍，采用 ISO 3166 二字码做为标准
birthday string ✅ 出生日期，格式：YYYYMMDD
gender string ✅ 乘客性别，M 男、F 女
cardType int ✅ 证件类型：0 空值、1 未知、2 护照、3 港澳通行证、4 台湾通行证、5 台胞证（台湾往返内地通行证）、6 回乡证（港澳往返内地通行证）、7 国际海员证、8 身份证
cardNo string ✅ 证件号码，最大 15 个字符
cardExpired string ✅ 证件有效期，格式：YYYYMMDD
ageType int ✅ 乘客类型，0 成人、1 儿童、2 婴儿
flightNumber string ✅ 航班号
depAirport string ✅ 出发机场
arrAirport string ✅ 到达机场
depTime string ✅ 起飞日期和起飞时间（当地时间），采用 ISO 8601 格式
arrTime string ✅ 到达日期和到达时间（当地时间），采用 ISO 8601 格式
name string ✅ 辅营名称
type int ✅ 辅营类型，0 托运行李、1 登机行李、2 值机、3 登机行李+优先登机套餐
code string ✅ 辅营代码
weight int ✅ 重量
count int ✅ 件数
bookSalePrice float ✅ 单价
currency string ✅ 币种

返回示例

Success-Response:

{
  "code": 200,
  "msg": "Success",
  "data": {
    "purchaseOrderNo": "333679914567",
    "AncillaryOrderNo": "A1772961465922359296",
    "ancillaryOrderStatus": “ISSUED”,
    "totalCost": 24.44,
    "lastUpdateTime": "2024-03-11T12:30:45",
    "createTime": "2024-03-10T15:45:20",
    "contact": {
        "fullName": "ZHANG/SAN",
        "address": "haugenlia 12447",
        "postCode": "10001",
        "email": "sansan@aerohub.uk",
        "mobile": "13801112547"
        },
    "ssr": [
      {
        "passengerNo": 0,
        "passengerName": "CHEN/RUKUN",
        "nationality": "PE",
        "birthday": "19650929",
        "gender": "F",
        "cardType": 2,
        "cardNo": "2230512125",
        "cardExpired": "20280327",
        "ageType": 0,
        "flightNumber": "DD123",
        "depAirport": "HKT",
        "arrAirport": "BKK",
        "depTime": "2023-01-12 03:25:22",
        "arrTime": "2023-01-12 03:25:22",
        "name": "15 KG",
        "type": 1,
        "code": "PA15",
        "weight": 15,
        "count": 2,
        "bookSalePrice": 12.22,
        "currency": "USD"
      }
    ]
  }
}

Error-Response

{
    "code": 1000,
    "msg": "Invalid API Key"
}
Author：AeroHub  Create time：2024-03-13 10:13
Last editor：AeroHub  Update time：2025-10-28 15:50