酒店预定

  • 接口:
  • Method: POST
  • 接口说明: 酒店预定
  • 文档末尾有文档版本记录
请求参数
字段名称 字段类型 字段描述 是否必填
source String 商旅平台 是
hotelBookRequest HotelBookRequest 酒店预定信息 是
HotelBookRequest:
字段名称 字段类型 字段描述 是否必填
passengerList List<Integer> 入住人列表，云简的员工Id 是
doucumentNum String 申请单号 否
hotelCode String 酒店代码 是
roomTypeCode String 房间类型代码 是
startTime String 入住时间，yyyy-MM-dd HH:mm 是
endTime String 离店时间， yyyy-MM-dd HH:mm 是
bookNum Integer 预定房间数 是
示例
{
 "source":"ctrip",
 "hotelBookRequest":{
 "passengerList": [
 145666
 ],
 "doucumentNum":"REQ0000000001",
 "hotelCode":"1662",
 "roomTypeCode":"12",
 "startTime":"2023-08-23 12:00",
 "endTime":"2023-08-23 12:00",
 "bookNum":1
 }
}
返回参数
字段名称 字段类型 字段描述
resCode Integer 响应状态码
resMsg String 响应信息
data BookResult 响应数据
BookResult
字段名称 字段类型 字段描述
bookStatus Boolean 预定结果，预定失败为false
hotelBookOrderInfo HotelOrderInfo 预定成功后的订单展示
HotelOrderInfo
字段名称 字段类型 字段描述
source String 商旅平台
source_type String 订单类型
order_id String 订单号，渠道内唯一
document_num String 云简申请单号
amount BigDecimal 订单总价，实际金额
price BigDecimal 原始价格
service_price BigDecimal 服务费
coupon BigDecimal 购买优惠券金额
deduction_coupon BigDecimal 优惠券抵扣金额
person_pay BigDecimal 个人实际支付金额
company_pay BigDecimal 公司实际支付金额
currency String 币种，默认CNY
other_price List<BasePrice> 其他费用
scene_code String 场景代码
scene_name String 场景名称
order_datetime Long 预定时间，13位时间戳
start_datetime Long 入住时间，13位时间戳
end_datetime Long 离店时间，13位时间戳
order_date_time String 预定时间，当地时间，yyyy-MM-dd HH:mm:ss
start_date_time String 入住时间，当地时间，yyyy-MM-dd HH:mm:ss
end_date_time String 离店时间，当地时间，yyyy-MM-dd HH:mm:ss
seller_invoice_title String 开票方的发票抬头
city_id Integer 酒店城市云简id
city_name String 酒店城市名称
hotel_name String 酒店名称
hotel_address String 酒店地址
brand_code String 品牌或者集团代码
brand_name String 品牌名称
brand_group String 品牌集团
start_date String 入住日期，yyyy-MM-dd
end_date String 离店日期，yyyy-MM-dd
extra_charge BigDecimal 后收服务费
send_invoice_price BigDecimal 配送发票费
penalty_price BigDecimal 酒店违约金
invoice_type Integer 发票类型，标准值列表-附录12：发票类型
rooms Integer 房间数
star String 酒店星级
room_type String 房型
meal_description String 餐食综合描述信息
meal_num Integer 餐食份数
pay_location_point Object 买单坐标
hotel_location_point Object 酒店坐标
pay_distance BigDecimal 买单距离
示例
{
 "resCode": 200000,
 "resMsg": "success",
 "data": {
 "bookStatus": true,
 "hotelBookOrderInfo":{
  "source": "ctrip",
  "source_type": "hotel",
  "order_id": "H202308230001",
  "document_num": "REQ0000000001",
  "amount": 680.00,
  "price": 650.00,
  "service_price": 30.00,
  "company_pay": 680.00,
  "person_pay": 0.00,
  "currency": "CNY",
  "city_name": "上海",
  "hotel_name": "示例酒店",
  "hotel_address": "上海市示例路1号",
  "start_date": "2023-08-23",
  "end_date": "2023-08-24",
  "rooms": 1,
  "room_type": "大床房"
 }
 }
}
文档版本记录
版本号 编写日期 更改内容
V1.0 2023.10.07 初稿
V1.1 2026.06.15 根据common-charlie补充HotelOrderInfo返回字段，修正预订示例字段

results matching ""

    No results matching ""