查询订单

接口说明

按订单编号、商家订单号、联系电话、证件号查询订单，返回订单数组。覆盖门票、演出、酒店、商品、预售、组品全部业态，返回统一结构。

默认只返回销售订单，即游客最初购买的那一单。subOrderFlag 传 1 时，同时返回销售订单下的子订单：预售券预约后生成的预约子订单、组品订单的组品子订单。子订单和销售订单在同一个数组里平级返回，用 saleType 区分（SINGLE 销售订单 / PRESALE 预约子订单 / COMBO 组品子订单），用 parentOrderNo 关联到销售订单。

订单数据来自订单中心，由各业态的订单变更同步而来，状态可能比实际晚几秒。

接口编码：operator.order.order.query

请求的加密、签名和响应解密规则见「接入说明与返回码」。

请求业务字段

以下为加密前的业务参数，序列化为 JSON 字符串并加密后填入外层 body。

字段	类型	必填	说明
`orderNo`	string	否	平台订单号，精确匹配。可以传销售订单号，也可以传子订单号；传子订单号时按它所属的销售订单查询
`outOrderNo`	string	否	商家订单号（渠道订单号），精确匹配
`linkPhone`	string	否	联系电话，精确匹配：订单联系人的手机号，或任意一位出行人的手机号。传不带国家码的手机号，如 `13800000000`
`certNo`	string	否	证件号，精确匹配：订单联系人的证件号，或任意一位出行人的证件号
`bookBegDate`	string	否	下单开始日期，格式 `yyyy-MM-dd`，含当天
`bookEndDate`	string	否	下单结束日期，格式 `yyyy-MM-dd`，含当天
`subOrderFlag`	string	否	是否同时返回子订单：`1` 是；`0` 或不传否（只返回销售订单）

orderNo、outOrderNo、linkPhone、certNo 至少传一个；同时传多个时，订单必须同时满足全部条件（AND）。

下单日期范围是附加条件，可以只传开始或只传结束，但不能单独使用。

outOrderNo、linkPhone、certNo、下单日期都按销售订单匹配（预约子订单、组品子订单上的信息不参与匹配）。

请求业务示例

{
  "orderNo": "261008165806061002",
  "subOrderFlag": "1"
}

按来电号码查询最近一个月的订单：

{
  "linkPhone": "13800000000",
  "bookBegDate": "2026-10-12",
  "bookEndDate": "2026-11-11"
}

按商家订单号查询：

{
  "outOrderNo": "1116545256674291229"
}

响应业务字段

响应体解密后为统一结构 {code, msg, data, ok}。data 为订单数组：销售订单按下单时间从晚到早排列，一次最多返回 50 张销售订单；subOrderFlag=1 时每张销售订单后面紧跟它的子订单（按下单时间从早到晚，子订单不计入 50 张）。没有符合条件的订单时为空数组 []。数组元素：

字段	类型	说明
`orderNo`	string	平台订单号
`parentOrderNo`	string	所属销售订单号。子订单为其销售订单（预售券订单 / 组品主订单）的 `orderNo`；销售订单本身为 `null`
`outOrderNo`	string	商家订单号（渠道订单号）
`businessType`	string	业态类型：`TICKET` 门票、`SHOW` 演出、`HOTEL` 酒店、`GOODS` 商品、`PRESALES` 预售、`COMBO` 组品
`saleType`	string	销售类型，同时表示订单在结果里的身份：`SINGLE` 销售订单（含预售券订单、组品主订单），退订用「申请退单」；`PRESALE` 预约子订单（预售券预约后生成），退订用「取消预约」；`COMBO` 组品子订单，随组品主订单退
`productType`	string	产品类型：`CALENDAR` 日历票、`PROMISSORY` 期票、`CARD` 年卡次卡、`FULLDAY` 全日房、`HOURLY` 钟点房、`GOODS` 商品、`CATERING` 餐饮、`COMBO` 组品
`productCode`	string	产品编码
`productName`	string	产品名称
`poiName`	string	景区 / 酒店 / 店铺名称
`showName`	string	演出名称，仅演出订单有值
`orderStatus`	string	订单状态：`WAIT_PAY` 待支付、`WAIT_CONFIRM` 待接单、`CONFIRM_FAIL` 接单失败、`WAIT_CHECK` 待使用、`EXPIRED` 已过期、`COMPLETED` 已完成、`REFUNDING` 退单中、`REFUNDED` 已退单、`CLOSED` 已关闭
`payStatus`	string	支付状态：`WAIT_PAY` 待支付、`NOT_PAY` 无需支付、`PAY_SUCCESS` 支付成功、`PAY_FAILED` 支付失败、`PAY_CLOSED` 支付关闭
`confirmStatus`	string	确认（接单）状态：`ISSUING` 待接单、`ISSUED` 接单成功、`ISSUE_FAILED` 接单失败
`checkStatus`	string	核销状态：`WAIT_CHECK` 待核销、`PARTIAL_CHECKING` 部分核销、`CHECKED` 已核销、`UNCHECKED` 未核销、`INVALID` 已失效
`lockStatus`	string	锁定状态：`1` 已锁定（不可退单）、`0` 未锁定
`reservationFlag`	string	是否需要预约，仅预售券订单有值：`1` 是、`0` 否
`appointmentStatus`	string	预约状态，仅预售券订单有值
`buyQuantity`	integer	购买数量
`returnedQuantity`	integer	已退数量
`checkQuantity`	integer	已核销数量
`totalAmount`	string	订单总金额，单位分
`discountAmount`	string	优惠金额，单位分
`payAmount`	string	实付金额，单位分
`payMethod`	string	支付方式
`bookTime`	string	下单时间
`payTime`	string	支付时间
`playDate`	string	游玩日期
`sessionTime`	string	场次时间，如 `19:00`
`startDate`	string	有效期 / 入住开始日期
`endDate`	string	有效期 / 入住结束日期
`firstCheckTime`	string	首次核销时间
`lastCheckTime`	string	最近核销时间
`linkName`	string	联系人姓名
`linkMobile`	string	联系人电话；订单没有填写联系人手机号时，为第一位出行人的手机号
`clientName`	string	客户（分销商）名称
`parentOrgName`	string	主体
`sceneType`	string	场景类型
`source`	string	订单来源
`remark`	string	订单备注

响应示例（解密后）

{
  "code": 0,
  "msg": null,
  "data": [
    {
      "orderNo": "261008165806061002",
      "parentOrderNo": null,
      "outOrderNo": null,
      "businessType": "PRESALES",
      "saleType": "SINGLE",
      "productType": null,
      "productCode": "BK0120261001094956",
      "productName": "宋城亲子套票预售券",
      "poiName": null,
      "showName": null,
      "orderStatus": "WAIT_CHECK",
      "payStatus": "PAY_SUCCESS",
      "confirmStatus": null,
      "checkStatus": "WAIT_CHECK",
      "lockStatus": "0",
      "reservationFlag": "1",
      "appointmentStatus": "1",
      "buyQuantity": 1,
      "returnedQuantity": 0,
      "checkQuantity": 0,
      "totalAmount": "20000",
      "discountAmount": "0",
      "payAmount": "20000",
      "payMethod": "IMPREST",
      "bookTime": "2026-10-08 16:58:06",
      "payTime": "2026-10-08 16:58:10",
      "playDate": null,
      "sessionTime": null,
      "startDate": "2026-10-08",
      "endDate": "2026-12-31",
      "firstCheckTime": null,
      "lastCheckTime": null,
      "linkName": "张三",
      "linkMobile": "13800000000",
      "clientName": "示例分销商",
      "parentOrgName": "示例主体",
      "sceneType": "CHANNEL",
      "source": "OPEN",
      "remark": null
    },
    {
      "orderNo": "2610081658060610020401",
      "parentOrderNo": "261008165806061002",
      "outOrderNo": null,
      "businessType": "TICKET",
      "saleType": "PRESALE",
      "productType": "CALENDAR",
      "productCode": "TK0120261001094956000001",
      "productName": "成人门票",
      "poiName": "杭州宋城景区",
      "showName": null,
      "orderStatus": "WAIT_CHECK",
      "payStatus": "NOT_PAY",
      "confirmStatus": "ISSUED",
      "checkStatus": "WAIT_CHECK",
      "lockStatus": "0",
      "reservationFlag": null,
      "appointmentStatus": null,
      "buyQuantity": 1,
      "returnedQuantity": 0,
      "checkQuantity": 0,
      "totalAmount": "0",
      "discountAmount": "0",
      "payAmount": "0",
      "payMethod": null,
      "bookTime": "2026-10-09 10:20:31",
      "payTime": null,
      "playDate": "2026-10-12",
      "sessionTime": null,
      "startDate": "2026-10-12",
      "endDate": "2026-10-12",
      "firstCheckTime": null,
      "lastCheckTime": null,
      "linkName": "张三",
      "linkMobile": "13800000000",
      "clientName": "示例分销商",
      "parentOrgName": "示例主体",
      "sceneType": "CHANNEL",
      "source": "OPEN",
      "remark": null
    }
  ],
  "ok": true
}

说明

orderNo 传子订单号与传它所属的销售订单号，返回结果相同。

只传 orderNo 且订单不存在时返回 code=2010「订单不存在」；带了其他条件时，订单编号存在但不满足其他条件、或按其他条件没有查到，都返回 code=0 和空数组。

符合条件的销售订单超过 50 张时只返回下单时间最近的 50 张，没有分页；请加上下单日期范围或其他条件缩小范围。

普通门票、演出、酒店、商品订单没有子订单，subOrderFlag 传 1 与不传结果相同。

预约取消后重新预约会生成新的预约子订单，已取消的预约子订单仍会返回，请用 orderStatus 判断子订单当前是否有效。

一张销售订单最多返回 200 个子订单。

极少数情况下子订单已同步而销售订单尚未同步：此时只用子订单号查询，返回该子订单本身（saleType 仍为子订单类型，parentOrderNo 为销售订单号）。

业务错误

业务校验不通过时 code 非 0，msg 为具体原因。返回码含义见「接入说明与返回码」第 9.2 节，下游业态服务给出的返回码原样透出：

code	msg	说明
`2010`	订单不存在	`orderNo` 不存在
`1021`	订单编号、渠道订单号、联系电话、证件号至少传一个，下单日期不能单独作为查询条件	四个主条件都没有传（包括只传了下单日期）
`1020`	下单开始日期格式有误，应为 yyyy-MM-dd	`bookBegDate` 不是合法日期；`bookEndDate` 同理，提示为「下单结束日期格式有误，应为 yyyy-MM-dd」
`1020`	下单开始日期不能晚于结束日期	`bookBegDate` 晚于 `bookEndDate`
`1020`	subOrderFlag 取值有误，仅支持 0、1	`subOrderFlag` 不是 `0` 或 `1`
`1031`	该接口仅支持运营平台操作员调用	应用实例绑定的不是运营平台操作员
`1020`	业务参数格式有误，必须为JSON对象	业务参数不是 JSON 对象，或字段类型不对

{
  "code": 2010,
  "msg": "订单不存在",
  "data": null,
  "ok": false
}

application/json

响应体为 Base64 密文，用 aesKey 解密后得到统一响应 OpenResponse，data 的结构如下；被网关拒绝时为明文 JSON，见「接入说明与返回码」

Bodyapplication/json

示例

{
    "code": 0,
    "msg": null,
    "data": [
        {
            "orderNo": "261008165806061002",
            "parentOrderNo": null,
            "outOrderNo": null,
            "businessType": "PRESALES",
            "saleType": "SINGLE",
            "productType": null,
            "productCode": "BK0120261001094956",
            "productName": "宋城亲子套票预售券",
            "poiName": null,
            "showName": null,
            "orderStatus": "WAIT_CHECK",
            "payStatus": "PAY_SUCCESS",
            "confirmStatus": null,
            "checkStatus": "WAIT_CHECK",
            "lockStatus": "0",
            "reservationFlag": "1",
            "appointmentStatus": "1",
            "buyQuantity": 1,
            "returnedQuantity": 0,
            "checkQuantity": 0,
            "totalAmount": "20000",
            "discountAmount": "0",
            "payAmount": "20000",
            "payMethod": "IMPREST",
            "bookTime": "2026-10-08 16:58:06",
            "payTime": "2026-10-08 16:58:10",
            "playDate": null,
            "sessionTime": null,
            "startDate": "2026-10-08",
            "endDate": "2026-12-31",
            "firstCheckTime": null,
            "lastCheckTime": null,
            "linkName": "张三",
            "linkMobile": "13800000000",
            "clientName": "示例分销商",
            "parentOrgName": "示例主体",
            "sceneType": "CHANNEL",
            "source": "OPEN",
            "remark": null
        },
        {
            "orderNo": "2610081658060610020401",
            "parentOrderNo": "261008165806061002",
            "outOrderNo": null,
            "businessType": "TICKET",
            "saleType": "PRESALE",
            "productType": "CALENDAR",
            "productCode": "TK0120261001094956000001",
            "productName": "成人门票",
            "poiName": "杭州宋城景区",
            "showName": null,
            "orderStatus": "WAIT_CHECK",
            "payStatus": "NOT_PAY",
            "confirmStatus": "ISSUED",
            "checkStatus": "WAIT_CHECK",
            "lockStatus": "0",
            "reservationFlag": null,
            "appointmentStatus": null,
            "buyQuantity": 1,
            "returnedQuantity": 0,
            "checkQuantity": 0,
            "totalAmount": "0",
            "discountAmount": "0",
            "payAmount": "0",
            "payMethod": null,
            "bookTime": "2026-10-09 10:20:31",
            "payTime": null,
            "playDate": "2026-10-12",
            "sessionTime": null,
            "startDate": "2026-10-12",
            "endDate": "2026-10-12",
            "firstCheckTime": null,
            "lastCheckTime": null,
            "linkName": "张三",
            "linkMobile": "13800000000",
            "clientName": "示例分销商",
            "parentOrgName": "示例主体",
            "sceneType": "CHANNEL",
            "source": "OPEN",
            "remark": null
        }
    ],
    "ok": true
}

接口说明

请求业务字段

请求业务示例

响应业务字段

响应示例（解密后）

说明

业务错误

请求参数

请求示例代码

返回响应

查询订单

接口说明#

请求业务字段#

请求业务示例#

响应业务字段#

响应示例（解密后）#

说明#

业务错误#

请求参数

请求示例代码

返回响应

接口说明

请求业务字段

请求业务示例

响应业务字段

响应示例（解密后）

说明

业务错误