工具 API

tuniuHotelCreateOrder

创建酒店预订订单。 前置条件(重要): 1. 必须先调用 tuniuHotelDetail 获取酒店详情和可用报价 2. 从详情返回的 roomTypes[].ratePlans[] 中选择报价,获取 preBookParam 3. 本工具会自动进行验价,无需手动调用 tuniuHotelVerifyPrice 使用场景: - 用户确认预订酒店房间 - 提交入住人信息和联系方式 - 完成酒店预订流程 必填参数: - hotelId:酒店ID(来自酒店详情) - roomId:房型ID(来自 roomTypes[].roomTypeId) - preBookParam:预订参数(来自 ratePlans[].preBookParam,用于标识具体报价方案) - checkInDate:入住日期(格式 YYYY-MM-DD,需与查询详情时一致) - checkOutDate:离店日期(格式 YYYY-MM-DD,需与查询详情时一致) - roomCount:预订房间数量 - roomGuests:每间房的入住人信息数组,长度应等于 roomCount。每个元素包含 guests 数组(该房间的入住人列表,每位入住人需提供 firstName 和 lastName) - contactName:联系人姓名 - contactPhone:联系人电话 可选参数: - contactEmail:联系人邮箱 预订限制(按所选报价的 bookingRequirements 文案强制校验): - 「预定必须要英文姓名」:roomGuests 中每位入住人的 firstName/lastName 必须为英文字母姓名(拼音或护照名) - 「预定必须要邮箱」:contactEmail 必填且格式合法 缺失时本工具会返回错误,请先向用户收集后再调用。 返回信息包括:订单ID、确认号、订单状态等。 注意:如果报价缓存已失效,需重新调用 tuniuHotelDetail(传入相同的 checkIn、checkOut)刷新报价信息。

lifestyleOAuth1 积分

调用信息

工具标识
tuniu.tuniuHotelCreateOrder
服务提供方
途牛
平均响应
0 ms
近 7 天调用
0

输入参数

hotelId必填

酒店ID

roomId必填

房型ID

preBookParam必填

预订参数,用于标识具体报价方案

checkInDate必填

入住日期,格式 YYYY-MM-DD

checkOutDate必填

离店日期,格式 YYYY-MM-DD

roomCount必填

预订房间数量

roomGuests必填

每间房的入住人信息,数组长度应等于 roomCount,每个元素包含该房间的入住人列表

contactName必填

联系人姓名

contactPhone必填

联系人电话

contactEmail

string