Available Coupons
query_available_couponsEnsure automatic coupon entitlement and query the amount payable; does not reserve quota. 普通 ToC 酒店查询可匿名,user_key 可选;下单、订单查询、取消和支付需要客户端安全配置的 user_key。 在验价后使用相同酒店、日期、币种和整笔总价查询可用券;预览不占名额,须让用户确认券后实付再创建。 查询失败时先区分参数/鉴权错误和上游暂时失败:修正参数或重新授权后再调用,仅暂时失败可有限重试;不得把错误或空结果改述成成功。
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": {
"hotel_id": "<hotel_id>",
"rate_code": "<rate_code>",
"check_in_date": "<check_in_date>",
"check_out_date": "<check_out_date>",
"currency": "<currency>",
"total_price": "<total_price>",
"user_key": "<user_key>"
},
"name": "query_available_coupons"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| 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 最新返回值,酒店/日期/入住人数必须一致。 | |
| total_price | Yes | 最新验价的全部房间、整段入住总价,currency 主单位,必须大于 0;未含另列 Stripe 手续费。价格变化须先征得用户确认。 | |
| check_in_date | Yes | 入住日期,YYYY-MM-DD。 | |
| check_out_date | Yes | 离店日期,YYYY-MM-DD,必须晚于 check_in_date。 |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||