1. 订单
电商3.0-运营平台开放接口
  • 接入说明与返回码
  • 订单
    • 查询订单列表
      POST
    • 查询订单详情
      POST
    • 取消预约
      POST
  • 售后
    • 申请退单
      POST
    • 查询退单
      POST
  • 景区
    • 查询景区列表
      POST
    • 查询景区详情
      POST
  • 数据模型
    • OpenOpsRequest
    • OpenOpsResponse
  1. 订单

查询订单详情

POST
/operator/open/order/orderGet
最后修改时间：2026-11-11 17:37:56
责任人：未设置

接口说明#

查询一张订单。
接口编码：operator.order.order.get

请求业务字段#

字段类型必填说明
orderNostring否平台订单号，销售订单号或子订单号
outOrderNostring否商家订单号（渠道订单号），只匹配销售订单
orderNo、outOrderNo 至少传一个；都传时必须是同一张订单。

请求业务示例#

{
  "orderNo": "261008165806061002"
}
按商家订单号：
{
  "outOrderNo": "1116545256674291229"
}

响应业务字段#

data 为订单，字段同「查询订单列表」的 orderList 元素。
字段类型说明
orderNostring平台订单号
parentOrderNostring子订单所属的销售订单号；销售订单为 null
outOrderNostring商家订单号（渠道订单号）
businessTypestring业态类型：TICKET 门票、SHOW 演出、HOTEL 酒店、GOODS 商品、PRESALES 预售、COMBO 组品
saleTypestring销售类型：SINGLE 销售订单（含预售券订单、组品主订单），退订用「申请退单」；PRESALE 预约子订单（预售券预约后生成），退订用「取消预约」；COMBO 组品子订单，随组品主订单退
productTypestring产品类型：CALENDAR 日历票、PROMISSORY 期票、CARD 年卡次卡、FULLDAY 全日房、HOURLY 钟点房、GOODS 商品、CATERING 餐饮、COMBO 组品
productCodestring产品编码
productNamestring产品名称
poiNamestring景区 / 酒店 / 店铺名称
showNamestring演出名称，仅演出订单有值
orderStatusstring订单状态：WAIT_PAY 待支付、WAIT_CONFIRM 待接单、CONFIRM_FAIL 接单失败、WAIT_CHECK 待使用、EXPIRED 已过期、COMPLETED 已完成、REFUNDING 退单中、REFUNDED 已退单、CLOSED 已关闭
payStatusstring支付状态：WAIT_PAY 待支付、NOT_PAY 无需支付、PAY_SUCCESS 支付成功、PAY_FAILED 支付失败、PAY_CLOSED 支付关闭
confirmStatusstring确认（接单）状态：ISSUING 待接单、ISSUED 接单成功、ISSUE_FAILED 接单失败
checkStatusstring核销状态：WAIT_CHECK 待核销、PARTIAL_CHECKING 部分核销、CHECKED 已核销、UNCHECKED 未核销、INVALID 已失效
lockStatusstring锁定状态：1 已锁定（不可退单）、0 未锁定
reservationFlagstring是否需要预约，仅预售券订单有值：1 是、0 否
appointmentStatusstring预约状态，仅预售券订单有值
buyQuantityinteger购买数量
returnedQuantityinteger已退数量
checkQuantityinteger已核销数量
totalAmountstring订单总金额，单位分
discountAmountstring优惠金额，单位分
payAmountstring实付金额，单位分
payMethodstring支付方式
bookTimestring下单时间
payTimestring支付时间
playDatestring游玩日期
sessionTimestring场次时间，如 19:00
startDatestring有效期 / 入住开始日期
endDatestring有效期 / 入住结束日期
firstCheckTimestring首次核销时间
lastCheckTimestring最近核销时间
linkNamestring联系人姓名
linkMobilestring联系人电话；订单没有填写联系人手机号时，为第一位出行人的手机号
clientNamestring客户（分销商）名称
clientCodestring客户（分销商）编码，如 DT26012109180879
parentOrgNamestring主体
sceneTypestring场景类型
sourcestring订单来源
remarkstring订单备注

响应示例（解密后）#

{
  "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": "示例分销商",
    "clientCode": "DT26012109180879",
    "parentOrgName": "示例主体",
    "sceneType": "CHANNEL",
    "source": "OPEN",
    "remark": null
  },
  "ok": true
}

说明#

传子订单号时返回子订单本身，parentOrderNo 为所属销售订单号。

业务错误#

codemsg说明
1021orderNo、outOrderNo 至少传一个两个单号都没有传
2010订单不存在orderNo 或 outOrderNo 不存在
1020orderNo 与 outOrderNo 不是同一张订单两个单号都传了，但不是同一张订单
1020outOrderNo 对应多张订单，请改用 orderNo 查询，或用「查询订单列表」按 outOrderNo 查询全部只传 outOrderNo，它对应多张订单
1031该接口仅支持运营平台操作员调用该应用实例不能调用本接口，请联系平台管理员
1020业务参数格式有误，必须为JSON对象业务参数不是 JSON 对象，或字段类型不对
{
  "code": 1021,
  "msg": "orderNo、outOrderNo 至少传一个",
  "data": null,
  "ok": false
}

请求参数

Body 参数application/json必填

示例
{
    "key": "调用方的key",
    "timestamp": 1794370000000,
    "body": "业务参数加密后的Base64密文",
    "sign": "MD5(body+timestamp+secret)"
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://scthub-open.dev.dmqwl.com/operator/open/order/orderGet' \
--header 'Content-Type: application/json' \
--data '{
    "key": "调用方的key",
    "timestamp": 1794370000000,
    "body": "业务参数加密后的Base64密文",
    "sign": "MD5(body+timestamp+secret)"
}'

返回响应

🟢200成功
application/json
解密后为 OpenOpsResponse，data 结构如下
Headers

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": "示例分销商",
        "clientCode": "DT26012109180879",
        "parentOrgName": "示例主体",
        "sceneType": "CHANNEL",
        "source": "OPEN",
        "remark": null
    },
    "ok": true
}
修改于 2026-11-11 17:37:56
上一页
查询订单列表
下一页
取消预约
Built with