POST/tickets/order/queryTicketsOrderList管理后台

单票订单-列表查询

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

基本信息

接口状态未见调用·长期未改动（待确认）置信度低
接口URLPOSThttps://dscp-dev.hn12301.net/manage-api/tickets/order/queryTicketsOrderList
请求方式POST
Content-Typeapplication/json
暴露渠道管理后台　前缀 /manage-api
名称来源源码注释
调用方本次扫描未发现调用　不等于可以下线
需求上下文单票票种订单相关后端初始化
维护人 / 最后改动liuxu　2025-06-18　最近提交：单票票种订单相关后端初始化
读写数据表tickets_order　反查该表全部接口 →
控制器com.jxxx.dscp.api.controller.tickets.TicketsOrderController#queryTicketsOrderList
源码位置jxxx-dscp/dscp-service-business/src/main/java/com/jxxx/dscp/api/controller/tickets/TicketsOrderController.java:319
判定依据无调用证据且最后改动已 451 天（单票票种订单相关后端初始化）

请求参数

Header 请求参数

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

Query 请求参数

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

路径参数及说明

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

Body 请求参数

Body 类型 TicketsOrderListRequest

参数名	参数值	是否必填	参数类型	描述说明
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[]

认证方式

需登录态：Authorization: Bearer <token>（多租户另带 tenant-id）；30002 会话失效需重登。详见全局公共参数。

响应参数

data 类型 List<TicketsOrderResponse>

参数名	参数值	是否必填	参数类型	描述说明
id	…	否	Long	id → tickets_order.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.created_by
createdTime	…	否	Date	创建时间 → tickets_order.created_time
updatedBy	…	否	String	修改人 → tickets_order.updated_by
updatedTime	…	否	Date	修改时间 → tickets_order.updated_time
skuName	…	否	String
orderDate	…	否	String
name	…	否	String
skuPrice	…	否	Integer
checkStatus	…	否	String
refundAmount	…	否	Integer

响应示例

成功响应示例 code=0

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

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

附录 · 实现细节

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

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

TicketsOrderController#queryTicketsOrderList
TicketsOrderService#queryList（TicketsOrderServiceImpl）
TicketsOrderMapper#queryList
BeanUtils.map → TicketsOrderQuery
BeanUtils.mapList → TicketsOrderResponse

逻辑摘要：列表查询（ticketsOrderService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

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

设置其他查询条件