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 ✅ 辅营订单详情。

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 格式。
ancillaryType string ⬜ 辅营订单类型：ssr 表示原有行李等 SSR 订单，seat 表示座位订单；历史订单可能返回空字符串。
ssr array/SSR Element ⬜ 行李辅营明细
seat array/Seat 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 ✅ 乘客序号，从 0 开始。
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 ✅ 币种。
pnrCode string ✅ 当前行李明细对应的 PNR。拆单出票时，不同座位明细可以返回不同的 PNR。

array/Seat Element

参数名称 类型 必填 说明
passengerNo int ✅ 乘客序号，从 0 开始。
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 婴儿。
ticketNo string ⬜ 当前乘客及航段对应的票号。
flightNumber string ✅ 航班号。
depAirport string ✅ 出发机场代码。
arrAirport string ✅ 到达机场代码。
depTime string ✅ 起飞日期和时间（当地时间），采用 ISO 8601 格式。
arrTime string ✅ 到达日期和时间（当地时间），采用 ISO 8601 格式。
rowNo string ✅ 座位行号。
colNo string ✅ 座位列号。
deck string ✅ 客舱层级：M 主舱下层，U 上层客舱。
amount float ✅ 当前座位的销售金额。
currency string ✅ 币种。
pnrCode string ✅ 当前座位明细对应的 PNR。拆单出票时，不同座位明细可以返回不同的 PNR。

返回规则

  • 当 ancillaryType=ssr 时，返回原有 ssr[]；不要求在 ssr[] 中增加 pnrCode。
  • 当 ancillaryType=seat 时，返回新增的 seat[]；每个座位元素返回一个 pnrCode。
  • 一个辅营订单存在多个 PNR 时，通过不同的 seat[] 元素分别返回，并使用 passengerNo、flightNumber、ticketNo 和 pnrCode 建立对应关系。
  • 同一个 PNR 可以在多条座位明细中重复。
  • 历史订单可能没有 ancillaryType，或者返回空字符串；调用方应保持向后兼容。

SSR 订单成功响应示例：

{
  "code": 200,
  "msg": "Successful",
  "data": {
    "purchaseOrderNo": "333679914567",
    "ancillaryOrderNo": "A1772961465922359296",
    "ancillaryOrderStatus": "ISSUED",
    "totalCost": 24.44,
    "lastUpdateTime": "2024-03-11T12:30:45",
    "createTime": "2024-03-10T15:45:20",
    "ancillaryType": "ssr",
    "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-12T03:25:22",
        "arrTime": "2023-01-12T03:25:22",
        "name": "15 KG",
        "type": 1,
        "code": "PA15",
        "weight": 15,
        "count": 2,
        "bookSalePrice": 12.22,
        "currency": "USD"
      }
    ]
  }
}

座位订单成功响应示例（拆单出票）：

{
  "code": 200,
  "msg": "Successful",
  "data": {
    "purchaseOrderNo": "333679914567",
    "ancillaryOrderNo": "A1772961465922359297",
    "ancillaryOrderStatus": "ISSUED",
    "totalCost": 58.64,
    "lastUpdateTime": "2024-03-11T12:30:45",
    "createTime": "2024-03-10T15:45:20",
    "ancillaryType": "seat",
    "contact": {
      "fullName": "ZHANG/SAN",
      "address": "haugenlia 12447",
      "postCode": "10001",
      "email": "sansan@aerohub.uk",
      "mobile": "13801112547"
    },
    "seat": [
      {
        "passengerNo": 0,
        "passengerName": "CHEN/RUKUN",
        "nationality": "PE",
        "birthday": "19650929",
        "gender": "F",
        "cardType": 2,
        "cardNo": "2230512125",
        "cardExpired": "20280327",
        "ageType": 0,
        "ticketNo": "1234567890123",
        "flightNumber": "5J378",
        "depAirport": "CGY",
        "arrAirport": "MNL",
        "depTime": "2023-01-12T03:25:22",
        "arrTime": "2023-01-12T03:25:22",
        "rowNo": "12",
        "colNo": "A",
        "deck": "M",
        "amount": 29.32,
        "currency": "USD",
        "pnrCode": "YF7F6F"
      },
      {
        "passengerNo": 1,
        "passengerName": "LI/MING",
        "nationality": "CN",
        "birthday": "19900101",
        "gender": "M",
        "cardType": 2,
        "cardNo": "E12345678",
        "cardExpired": "20300101",
        "ageType": 0,
        "ticketNo": "1234567890124",
        "flightNumber": "5J378",
        "depAirport": "CGY",
        "arrAirport": "MNL",
        "depTime": "2023-01-12T03:25:22",
        "arrTime": "2023-01-12T03:25:22",
        "rowNo": "12",
        "colNo": "B",
        "deck": "M",
        "amount": 29.32,
        "currency": "USD",
        "pnrCode": "A2B3C4"
      }
    ]
  }
}

错误响应示例：

{
  "code": 1000,
  "msg": "Invalid API Key"
}
Author：AeroHub  Create time：2024-03-13 10:13
Last editor：AeroHub  Update time：2026-10-20 11:34