电商3.0-运营平台开放接口
    • 概览
    • 快速开始
    • 请求与加密
    • 响应处理
    • 示例与自测
    • 数据约定
    • 返回码与排查
    • 更新日志
    • 订单
      • 查询订单列表
        POST
      • 查询订单详情
        POST
      • 取消预约
        POST
    • 售后
      • 申请退单
        POST
      • 查询退单
        POST
    • 景区
      • 查询景区列表
        POST
      • 查询景区详情
        POST

    更新日志

    本页按日期倒序记录对接方可见的接口变更（地址、字段、返回码）。

    2026-11-12#

    申请退单、取消预约：按订单号和订单当前状态幂等，不新增参数。超时、网络异常、2312 后用相同参数重试不会重复办理；已办理的返回 code=0 和已有结果。规则见两个接口页的「幂等」，返回码变化见返回码与排查。
    申请退单：响应字段 refundQuantity 的含义明确为「这笔退单的退单数量」（重复调用时返回已有退单的数量）。
    查询景区详情：原「查询景区营业时间」改名，地址改为 /operator/open/scenic/infoGet；请求为 scenicCode，响应字段为 scenicCode、scenicName、businessHours、openStatus、address、longitude、latitude、mapType。
    查询订单列表：改为分页，请求新增 current、size，data 改为分页对象（current、size、total、orderList）；响应新增 clientCode。
    查询订单详情：新增，按 orderNo 或 outOrderNo 查询一笔订单。
    申请退单：请求只保留 orderNo、refundReason；refundReason 必填，最长 256 个字符；响应不再返回外部退单号。商品订单已核销返回 2314；酒店订单扣除手续费后可退金额为 0 时返回 2315。
    取消预约：请求为 orderNo、reservationOrderNo（选填）、cancelReason；cancelReason 必填，最长 256 个字符；orderNo 只收预售券订单号，只取消一笔预约时传 reservationOrderNo。
    查询退单：outRefundNo 表示其他渠道发起退单时带来的外部退单号。
    返回码：退单原因、取消原因没传返回 1021，超长返回 1020；业务返回码 1031 的提示语改为「该应用实例无权调用本接口，请联系平台管理员」；请求体为空时返回 1031；提示语中订单的量词统一为「笔」。

    2026-11-11#

    接口按开放平台命名规范统一改名，旧地址不再可用，现行地址见各接口页。
    查询订单列表：请求参数改为 linkPhone、bookStartDate、bookEndDate、subOrderFlag（0 / 1）；响应字段改为 bookTime、firstCheckTime、checkQuantity、linkName、linkMobile、parentOrgName，订单类别统一用 saleType（SINGLE / PRESALE / COMBO）。
    取消预约：响应字段改为 detailList、detailList[].reservationOrderNoList；取消失败状态统一为 FAILED。
    查询退单：申请时间字段改为 refundTime，新增 refundStatus。
    返回码：业务错误按场景返回 1020、1021、2010、2309、2310 等，业态服务的返回码原样透出。
    修改于 2026-11-11 19:18:00
    上一页
    返回码与排查
    下一页
    查询订单列表
    Built with