OrderList

  • 用途：用于获取指定时间范围内的订单列表
  • 请求方式：POST
  • 接口加密：否
  • FareMarket地址：/supplier/v2/api/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+08:00",
    "endDatetime": "2023-01-12T09:17:17+08:00"
}

返回参数

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

Data Element

参数名称 类型 必填 说明
purchaseOrderNo string ✅ AeroHub的订单号，与Order接口请求时的OrderNo对应
supplierOrderNo string ✅ 供应商自己系统的订单号，与Order接口返回时的OrderNo对应

返回示例

Success-Response:

{
    "code": 200,
    "msg": "Successful",
    "data": [{
        "purchaseOrderNo": "F1745527321051406356",
        "supplierOrderNo": "240112032518897783"
        },
        {
        "purchaseOrderNo": "F1745527321051406357",
        "supplierOrderNo": "240112032518897784"
        }
    }]
}

Error-Response

{
    "code": 1000,
    "msg": "Invalid API Key"
}

注意事项

  • 在遇到返回的 JSON 数据中 code 不等于 200 或 HTTP 状态码非 200 的情况时，供应商需要重试调用以确保请求的成功处理。
Author：AeroHub  Create time：2024-03-15 15:09
Last editor：AeroHub  Update time：2025-10-28 15:50