POST/hotel/queryHotelOrderPage管理后台

酒店订单表-分页查询

酒店 / 订单· HotelOrderController#queryHotelOrderPage

基本信息

接口状态前端在用置信度高
接口URLPOSThttps://dscp-dev.hn12301.net/manage-api/hotel/queryHotelOrderPage
请求方式POST
Content-Typeapplication/json
暴露渠道管理后台　前缀 /manage-api
名称来源源码注释
调用方已确认在用 · 管理后台（1 个前端）
需求上下文酒店模块订单系列表创建
维护人 / 最后改动liuxu　2024-12-17　最近提交：酒店模块订单系列表创建
读写数据表hotel_order、hotel_room_type　反查该表全部接口 →
控制器com.jxxx.dscp.api.controller.hotel.HotelOrderController#queryHotelOrderPage
源码位置jxxx-dscp/dscp-service-business/src/main/java/com/jxxx/dscp/api/controller/hotel/HotelOrderController.java:106
判定依据1 个调用点：dscp-html-manage/src/api/hotel/hotel.ts

请求参数

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

Header 请求参数

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

Query 请求参数

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

路径参数及说明

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

Body 请求参数

Body 类型 HotelOrderPageRequest

参数名	参数值	是否必填	参数类型	描述说明
pageNo	…	否	Integer	当前页面
pageSize	…	否	Integer	每页记录数
orderBy	…	否	String	排序语句
merchantId	…	否	Long	所属商户id，关联merchant表id → hotel_room_type.merchant_id
shopId	…	否	Long	所属商铺id，关联shop表id → hotel_room_type.shop_id
hotelId	…	否	Long	酒店ID → hotel_room_type.hotel_id
roomTypeId	…	否	Long	房型ID → hotel_order.room_type_id
planId	…	否	Long	价格方案ID → hotel_order.plan_id
purchaseDateRange	…	否	Date[]	购买日期
checkInDateRange	…	否	Date[]	入住日期
checkOutDateRange	…	否	Date[]	离店日期
paymentStatus	…	否	HotelOrderPaymentStatus	支付状态(0-未支付,1-部分支付,2-已支付,3-已退款,4-部分退款) → hotel_order.payment_status 0＝未支付 1＝部分支付 2＝已支付 3＝已退款 4＝部分退款 5＝退款中 6＝退款失败
status	…	否	HotelOrderStatus	订单状态(0-待支付,1-待确认,2-待入住,3-已完成,4-已取消) → hotel_room_type.status 0＝待支付 1＝待确认 2＝待入住 3＝已入住 4＝已退房 5＝已取消 6＝部分退房

认证方式

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

响应参数

data 类型 PageInfo<HotelOrderListResponse>

参数名	参数值	是否必填	参数类型	描述说明
list	…	否	List<T><HotelOrderListResponse>	分页数据集合（元素结构见下一行）
id	…	否	Long	订单ID → hotel_room_type.id
orderNo	…	否	String	订单编号 → hotel_order.order_no
createdTime	…	否	Date	创建时间 → hotel_room_type.created_time
status	…	否	HotelOrderStatus	订单状态 → hotel_room_type.status 0＝待支付 1＝待确认 2＝待入住 3＝已入住 4＝已退房 5＝已取消 6＝部分退房
roomNum	…	否	Integer	房间数量 → hotel_order.room_num
roomTypeName	…	否	String	房型名称
stayNights	…	否	Integer	入住天数 → hotel_order.stay_nights
checkInDate	…	否	Date	入住日期 → hotel_order.check_in_date
checkOutDate	…	否	Date	离店日期 → hotel_order.check_out_date
contactName	…	否	String	联系人姓名 → hotel_order.contact_name
contactPhone	…	否	String	联系人手机号 → hotel_order.contact_phone
originalAmount	…	否	Integer	订单原价(分) → hotel_order.original_amount
discountAmount	…	否	Integer	优惠金额(分) → hotel_order.discount_amount
totalAmount	…	否	Integer	订单应付金额(分) → hotel_order.total_amount
total	…	否	Long	数据总数

响应示例

成功响应示例 code=0

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "list": "[]",
    "id": "1",
    "orderNo": "\"string\"",
    "createdTime": "\"2026-01-01 00:00:00\"",
    "status": "0",
    "roomNum": "1",
    "roomTypeName": "\"string\"",
    "stayNights": "1",
    "checkInDate": "\"2026-01-01 00:00:00\"",
    "checkOutDate": "\"2026-01-01 00:00:00\"",
    "contactName": "\"string\"",
    "contactPhone": "\"string\""
  }
}

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

附录 · 实现细节

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

涉及数据表：hotel_order、hotel_room_type　反查全部引用接口 →

HotelOrderController#queryHotelOrderPage
HotelOrderService#queryPage（HotelOrderServiceImpl）
HotelOrderMapper#queryPage
HotelRoomTypeService#queryList（HotelRoomTypeServiceImpl）
HotelRoomTypeMapper#queryList
BeanUtils.map → HotelOrderQuery

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

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

1. 查询订单列表
按创建时间倒序
2. 查询房型信息
3. 转换响应对象
4. 构建分页结果

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

调用点证据

dscp-html-manage/src/api/hotel/hotel.ts:121　管理后台 · request