POST/hotel/getHotelOrderDetail管理后台

酒店订单表-详情

酒店 / 订单· HotelOrderController#getHotelOrderDetail

基本信息

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

请求参数

Header 请求参数

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

Query 请求参数

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

路径参数及说明

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

Body 请求参数

Body 类型 IdRequest

参数名	参数值	是否必填	参数类型	描述说明
id	…	是	Long	id → hotel_room_type.id

认证方式

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

响应参数

data 类型 HotelOrderDetailResponse

参数名	参数值	是否必填	参数类型	描述说明
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.room_num
roomTypeName	…	否	String	房型名称
roomTypePlanName	…	否	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
guestNames	…	否	String	入住人姓名列表
guestNum	…	否	Integer	入住人数 → hotel_order.guest_num
expectedArrivalTime	…	否	Date	预计到店时间 → hotel_order.expected_arrival_time
channel	…	否	HotelChannel	订单渠道 → hotel_order.channel 1＝质慧游小程序
originalAmount	…	否	Integer	订单原价(分) → hotel_order.original_amount
discountAmount	…	否	Integer	优惠金额(分) → hotel_order.discount_amount
totalAmount	…	否	Integer	订单应付金额(分) → hotel_order.total_amount
couponId	…	否	String	优惠券ID → hotel_order.coupon_id
orderRoomList	…	否	List<OrderRoom>	订单房间明细列表
roomDate	…	否	Date	房间日期 → hotel_order_room.room_date
roomName	…	否	String	房型名称 → hotel_order_room.room_name
roomNum	…	否	Integer	房间数量 → hotel_order_room.room_num
roomPrice	…	否	Integer	房间单价(分) → hotel_order_room.room_price
totalPrice	…	否	Integer	房间总价(分) → hotel_order_room.total_price
roomStatus	…	否	Integer
checkedOutNum	…	否	Integer	已退房数量 → hotel_order_room.checked_out_num

响应示例

成功响应示例 code=0

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

失败响应示例

{
  "data": null,
  "可能返回": [
    {
      "errcode": "99999",
      "errmsg": "服务内部错误"
    }
  ]
}

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

附录 · 实现细节

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

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

HotelOrderController#getHotelOrderDetail
HotelOrderRoomService#queryList（HotelOrderRoomServiceImpl）
HotelOrderRoomMapper#queryList
HotelMemberTravelerService#queryList（HotelMemberTravelerServiceImpl）
HotelMemberTravelerMapper#queryList

逻辑摘要：查询详情（hotelOrderService.get）；查询详情（hotelRoomTypeService.get）；查询详情（hotelRoomTypePlanService.get）

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

1. 查询订单基本信息
2. 查询房型信息
3. 查询订单房间明细
4. 查询入住人信息
构建入住人信息字符串: 姓名|身份证号(隐藏中间部分)
5. 构建响应对象
设置格式化后的入住人信息
6. 构建房间明细列表

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

调用点证据

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

可能抛出的业务码：99999 服务内部错误　错误码字典 →