AncillaryOrderList

  • 用途：用于获取指定时间范围内的待处理的辅营订单、拉取订单列表
  • 请求方式：POST
  • 接口加密：否
  • FareMarket地址：/supplier/v1/api/ancillary_order_list

请求参数

参数名称 类型 必填 说明
apiKey string ✅ 每个供应商有自己唯一的apiKey，用于表示供应商身份，AeroHub在接口测试前提供给供应商
requestId string ✅ 请求ID，出票环节每个次调用是唯一的，长度32位
beginDatetime string ✅ 订单列表拉取时的起始时间，采用 ISO 8601 格式
endDatetime string ✅ 订单列表拉取时的的结束时间，采用 ISO 8601 格式

请求示例

{
    "apiKey": "PcrNq8964iFUkE0CyVV4bhgXXX",
    "requestId": "3fd720b5bf544161bd14c535c9",
    "beginDatetime": "2023-01-11T09:17:17",
    "endDatetime": "2023-01-12T09:17:17"
}

返回参数

参数名称 类型 必填 说明
code int ✅ AeroHub 状态码，参考通用说明中的 Market Errors。
msg string ✅ AeroHub 错误说明，参考通用说明中的 Market Errors。
data array/Data Element ⬜ 辅营订单列表。

array/Data Element

参数名称 类型 必填 说明
ancillaryOrderNo string ✅ AeroHub 辅营订单号。
lastUpdateTime string ✅ 订单在 AeroHub 系统中最后更新的时间，采用 ISO 8601 格式。
createTime string ✅ 订单在 AeroHub 系统中的创建时间，采用 ISO 8601 格式。
ancillaryType string ⬜ 辅营订单类型：ssr 表示原有行李等 SSR 订单，seat 表示座位订单；历史订单可能返回空字符串。

成功响应示例：

{
  "code": 200,
  "msg": "Successful",
  "data": [
    {
      "ancillaryOrderNo": "A1745527321051406356",
      "lastUpdateTime": "2023-01-12T03:25:19",
      "createTime": "2023-01-12T03:25:19",
      "ancillaryType": "seat"
    },
    {
      "ancillaryOrderNo": "A1745527321051406357",
      "lastUpdateTime": "2023-01-12T03:25:22",
      "createTime": "2023-01-12T03:25:21",
      "ancillaryType": "ssr"
    }
  ]
}

错误响应示例：

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