啡快算价
工具名称
calculate_pickup_price
MCP Endpoint
tools/call · calculate_pickup_price
分类
算价与下单
做什么
用于 MOP 啡快到店自取 场景的订单价格试算。 适用于用户已经确定门店、商品、规格或杯型、加料和可选优惠券， 想在正式下单前确认优惠金额和应付金额时调用。
响应会返回 temp_order_id，后续 create_pickup_order
必须原样回传该 temp_order_id，相同 temp_order_id 的重复请求会返回首次结果而不是重复执行。
调用前置
请求头 x-customer-id 与 x-user-id 二选一必传（由会员登录态注入）。
入参
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| store_id | string | 是 | 门店 ID，必须使用 search_stores 返回的值，不要传门店名称。 |
| item_list | ItemInput[] | 是 | 商品列表，至少 1 项；字段需直接来自 get_product / get_combo 返回值，禁止根据名称猜测。 |
| combo_group_info_list | ComboGroup[] | 否 | 套餐或多件组合活动信息列表；仅套餐场景传，普通单品不传。 |
| coupon_list | string[] | 否 | 用户准备试算的优惠券 ID 列表；不传则按无券场景算价。 |
| used_star_options | StarOption[] | 否 | 使用星星抵扣，从上一次算价响应 canUseStar 中获取。 |
商品项关键字段
item_list[*] 需包含：
item_id/item_name/item_price— 来自get_product或get_combo.groups[*].products[*]；spec_id/sku_id— 来自所选规格；用户未明确指定时优先取is_default_sku=true的 spec；quantity— 用户未指定时默认 1；sku_attrs[]— 当前spec_id下required=true的默认配料 + 用户明确选择的客制化项； 两级结构（options → sub_options）只取最内层option_id / code / price，不传父级。
套餐场景
购买 combo 时，agent 必须：
- 先调用
get_combo获取套餐详情； - 将
get_combo.item_id写入combo_group_info_list[*].activity_id与对应item_list[*].activity_id； - 显式生成一个 UUID 写入
combo_group_info_list[*].group_id与对应商品的item_list[*].group_id； - 组类型映射：
fixcombo → 3、combo_v2 → 0、combo_v3 → 5。
券二次试算
若响应中 can_use_coupon 不为空，应提示用户存在可用券；
用户选定后需将对应 coupon_id 放入下一次算价请求的 coupon_list 中重新试算。