Create Booking
create_bookingCreate a hotel booking from a verified rate. Configure a valid TourMind user_key in a trusted local Skill or client integration that supplies the user_key tool argument. Do not ask users to paste user keys into chat. 普通 ToC 酒店查询可匿名,user_key 可选;下单、订单查询、取消和支付需要客户端安全配置的 user_key。 先验价并让用户确认酒店、日期、每房入住人、总价/币种、餐食和取消费用,再创建订单。下单不代表支付或酒店确认;使用 query_booking 查最新状态。使用优惠券时必须先查券并确认券后金额,提供 request_id、coupon_code 和 expected_payable_amount。结果不明时重试须复用同一个 request_id 和全部原始参数;UNKNOWN/PROCESSING 不得换ID重建。FAILED_NO_ORDER 表示未创建订单,最多使用新 request_id 重试一次;若用户授权已过期或预订条款已变更,须先请用户重新确认。未提供 request_id 的旧请求仍须先核实订单,不得盲目重试。
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"user_key": "<user_key>",
"hotel_id": "<hotel_id>",
"rate_code": "<rate_code>",
"check_in_date": "<check_in_date>",
"check_out_date": "<check_out_date>",
"guest_name": "<guest_name>",
"adults": "<adults>",
"room_count": "<room_count>",
"currency": "<currency>",
"total_price": "<total_price>"
},
"name": "create_booking"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| rooms | No | 按房间分组的入住人,提供非空数组时长度必须等于有效 room_count;每房至少 1 名、最多 adults 名,优先于 guest_name。 | |
| adults | Yes | 每房成人数,不是所有房间合计;相同入住配置应用于每间房。有效入住人数必须大于 0。 此入口不提供默认值;在使用入住条件时必须显式提供。 | |
| children | No | 每房儿童数,非负整数;省略或 0 表示无儿童,必须等于 children_ages 数组长度。 | |
| currency | Yes | 核实报价的 ISO 4217 币种;订单实际以鉴权账号结算币种为准,本参数不改变账号币种。 | |
| hotel_id | Yes | TourMind 酒店 ID,数字字符串;从地点/酒店搜索返回取得,不使用 Google place_id。 | |
| user_key | Yes | 由可信本地客户端配置的 TourMind 用户凭证;勿让用户在聊天中粘贴。普通 ToC 查询可省略,订单/支付操作必填;OAuth 与 ToB 不接受此字段。 | |
| rate_code | Yes | 不透明报价代码,原样传递;验价使用 query_room_rates 返回值,下单使用 check_room_availability 最新返回值,酒店/日期/入住人数必须一致。 | |
| guest_name | Yes | 入住人法定全名;现有 MCP Schema 要求该字段始终存在。未提供非空 rooms 时业务处理器按本字段解析姓名;rooms 非空时优先使用其姓名。 | |
| request_id | No | 客户端为本次创单生成的稳定ID,最多64字节;使用优惠券时必填。相同请求重试必须复用,不得换ID重试未知结果。 | |
| room_count | Yes | 相同入住配置的房间数;业务处理器将 0 按 1 间处理,负数无效。查询工具可省略;下单工具原有 MCP Schema 要求此字段存在。 | |
| coupon_code | No | query_available_coupons 返回的可用券码;省略表示不在创单阶段用券。 | |
| total_price | Yes | 最新验价的全部房间、整段入住总价,currency 主单位,必须大于 0;未含另列 Stripe 手续费。价格变化须先征得用户确认。 | |
| check_in_date | Yes | 入住日期,YYYY-MM-DD。 此入口不提供默认值;在使用入住条件时必须显式提供。 | |
| children_ages | No | 每房儿童年龄数组,逐个为 0–17 岁整数;数组长度必须等于 children,同一组年龄应用于每间房。省略/null/[] 只适用于 children=0。 | |
| contact_email | No | 订单通知邮箱,可省略;应向用户核实,不编造。 | |
| contact_phone | No | 联系手机号,可带国家码;最多 32 字节,不允许换行。可省略。 | |
| check_out_date | Yes | 离店日期,YYYY-MM-DD,必须晚于 check_in_date。 此入口不提供默认值;在使用入住条件时必须显式提供。 | |
| expected_payable_amount | No | 用户已确认的券后实付金额,账号币种主单位;使用券时必填,不含另列支付手续费。 |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||