POST/tickets/order/queryTicketsOrderPage开放/回调

单票订单-分页查询

门票与景区 / 订单· TicketsOrderController#queryTicketsOrderPage

基本信息

接口状态前端在用置信度高免鉴权
接口URLPOSThttps://dscp-dev.hn12301.net/open-api/tickets/order/queryTicketsOrderPage
请求方式POST
Content-Typeapplication/json
暴露渠道开放/回调　前缀 /open-api
名称来源源码注释
调用方已确认在用 · 质惠游公众号 H5、湘工惠商城（2 个前端）
需求上下文单票票种订单相关后端初始化
维护人 / 最后改动liuxu　2025-06-18　最近提交：单票票种订单相关后端初始化
读写数据表tickets_order、tickets_check、tickets_order_payment、tickets_order_goods　反查该表全部接口 →
控制器com.jxxx.dscp.api.controller.tickets.TicketsOrderController#queryTicketsOrderPage
源码位置jxxx-dscp/dscp-service-business/src/main/java/com/jxxx/dscp/api/controller/tickets/TicketsOrderController.java:202
判定依据2 个调用点：h5-meike/common/http.api.js、xghmall/common/http.api.js

请求参数

分页字段来自 AbstractPageRequest：pageNo（不是 pageNum）· pageSize · orderBy

Header 请求参数

参数名	参数值	是否必填	参数类型	描述说明
无（渠道统一鉴权头见《认证方式》）

Query 请求参数

参数名	参数值	是否必填	参数类型	描述说明
无

路径参数及说明

参数名	参数值	是否必填	参数类型	描述说明
无

Body 请求参数

Body 类型 TicketsOrderPageRequest

参数名	参数值	是否必填	参数类型	描述说明
pageNo	…	否	Integer	当前页面
pageSize	…	否	Integer	每页记录数
orderBy	…	否	String	排序语句
keywords	…	否	String	关键字
orderStatus	…	否	OrderStatus	→ tickets_order.order_status 1＝待支付 2＝待发货 3＝已发货 4＝已完成 5＝已取消 6＝退款中 7＝已退款
orderPhone	…	否	String	→ tickets_order.order_phone
payStatus	…	否	PayStatus	→ tickets_order.pay_status 1＝待支付 2＝已支付 3＝已退款 4＝退款失败 5＝退款中 6＝退款申请
createdTimeRange	…	否	Date[]

认证方式

免鉴权：@Route(auth = false) —— 该接口不校验登录态，改动前确认调用方与签名校验。

响应参数

data 类型 PageInfo<TicketsOrderResponse>

参数名	参数值	是否必填	参数类型	描述说明
list	…	否	List<T><TicketsOrderResponse>	分页数据集合（元素结构见下一行）
id	…	否	Long	id → tickets_order_payment.id
orderNo	…	否	String	订单号 → tickets_order.order_no
merchantId	…	否	Long	商户Id，merchant表Id → tickets_order.merchant_id
shopId	…	否	Long	商铺Id，shop表Id → tickets_order.shop_id
memberId	…	否	Long	会员用户Id → tickets_order.member_id
orderType	…	否	OrderType	订单类型，1景区套票，2酒店民宿，3餐饮美食，4美食特产，5自驾路线，6非遗专区，7旅游卡 → tickets_order.order_type 1＝景区套票 2＝酒店民宿 3＝餐饮美食 4＝美食特产 5＝自驾路线 6＝非遗专区 7＝旅游卡 8＝旅游卡
orderSource	…	否	OrderSource	订单来源，1H5，2微信小程序，3支付宝小程序，4安卓APP，5IOSAPP → tickets_order.order_source 1＝H5 2＝微信小程序 3＝支付宝小程序 4＝安卓APP 5＝IOSAPP 6＝YOUZHENG 7＝XIANGGONGHUI 8＝XIANGYUEMA 9＝ZHIHUIYOU 10＝BCM 11＝JIANHANG 24＝MEIKE
buyNum	…	否	Integer	购买份数 → tickets_order.buy_num
orderAmount	…	否	Integer	订单金额，订单原始金额 → tickets_order.order_amount
receivableAmount	…	否	Integer	应收金额 → tickets_order.receivable_amount
payableAmount	…	否	Integer	实收金额 → tickets_order.payable_amount
reducedPrice	…	否	Integer	优惠金额 → tickets_order.reduced_price
discountAmount	…	否	Integer	折扣金额 → tickets_order.discount_amount
payStatus	…	否	PayStatus	支付状态，1=待支付 2=已支付 3=已退款 → tickets_order.pay_status 1＝待支付 2＝已支付 3＝已退款 4＝退款失败 5＝退款中 6＝退款申请
orderStatus	…	否	OrderStatus	订单状态，1=待确认 2=待发货 3=已发货 4=已完成 5=已取消 → tickets_order.order_status 1＝待支付 2＝待发货 3＝已发货 4＝已完成 5＝已取消 6＝退款中 7＝已退款
orderPhone	…	否	String	下单人手机 → tickets_order.order_phone
orderContactMobile	…	否	String	→ tickets_order.order_contact_mobile
orderContactName	…	否	String	→ tickets_order.order_contact_name
orderRemark	…	否	String	订单备注 → tickets_order.order_remark
orderTime	…	否	Date	下单时间 → tickets_order.order_time
orderExpressTime	…	否	Date	订单失效时间 → tickets_order.order_express_time
createdBy	…	否	String	创建人 → tickets_order_payment.created_by
createdTime	…	否	Date	创建时间 → tickets_order_payment.created_time
updatedBy	…	否	String	修改人 → tickets_order_payment.updated_by
updatedTime	…	否	Date	修改时间 → tickets_order_payment.updated_time
skuName	…	否	String
orderDate	…	否	String
name	…	否	String	→ tickets_check.name
skuPrice	…	否	Integer	→ tickets_order_goods.sku_price
checkStatus	…	否	String
refundAmount	…	否	Integer
total	…	否	Long	数据总数

响应示例

成功响应示例 code=0

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "list": "[]",
    "id": "1",
    "orderNo": "\"string\"",
    "merchantId": "1",
    "shopId": "1",
    "memberId": "1",
    "orderType": "1",
    "orderSource": "1",
    "buyNum": "1",
    "orderAmount": "1",
    "receivableAmount": "1",
    "payableAmount": "1"
  }
}

示例来自源码/导出内容，仅结构参考，非线上真实数据。

附录 · 实现细节

调用链 / 数据表 / 调用点证据 / 源码注释 / 逻辑摘要

涉及数据表：tickets_order、tickets_check、tickets_order_payment、tickets_order_goods　反查全部引用接口 →

TicketsOrderController#queryTicketsOrderPage
TicketsOrderService#queryPage（TicketsOrderServiceImpl）
TicketsOrderMapper#queryPage
TicketsCheckService#queryList（TicketsCheckServiceImpl）
TicketsCheckMapper#queryList
TicketsOrderPaymentService#queryList（TicketsOrderPaymentServiceImpl）
TicketsOrderPaymentMapper#queryList
BeanUtils.map → TicketsOrderQuery
BeanUtils.mapPage → TicketsOrderResponse

逻辑摘要：分页查询（ticketsOrderService.queryPage）；查询详情（ticketsOrderGoodsService.get）；查询详情（ticketsCheckService.get）；入参与返回值经 BeanUtils 做对象/分页映射

源码内联注释（旧站解析结果）

设置其他查询条件

旧站环境备注：pro：（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

调用点证据

xghmall/common/http.api.js:49　湘工惠商城 · queryTicketsOrderPageUrl
h5-meike/common/http.api.js:12　质惠游公众号 H5 · queryTicketsOrderPageUrl