工具 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)刷新报价信息。
调用信息
- 工具标识
- tuniu.tuniuHotelCreateOrder
- 服务提供方
- 途牛
- 平均响应
- 0 ms
- 近 7 天调用
- 0
输入参数
hotelId必填酒店ID
roomId必填房型ID
preBookParam必填预订参数,用于标识具体报价方案
checkInDate必填入住日期,格式 YYYY-MM-DD
checkOutDate必填离店日期,格式 YYYY-MM-DD
roomCount必填预订房间数量
roomGuests必填每间房的入住人信息,数组长度应等于 roomCount,每个元素包含该房间的入住人列表
contactName必填联系人姓名
contactPhone必填联系人电话
contactEmailstring