服务与工具
麦当劳
麦当劳点餐与门店查询（需授权）
19 个可用工具
available-coupons
查询用户当前可领取的麦麦省的优惠券列表。返回券名称、图片、状态和促销标签。当用户询问有什么优惠、可以领什么券时使用此工具。
query-nearby-stores
Description: 到店自提场景下查询用户可点餐门店，仅支持到店场景下使用 When： - 用户询问"我想到店" - 我想吃一份麦当劳，到店自取 - 看看我附近有哪些麦当劳的门店 Input: - searchType: 必传，searchType=2 按位置进行搜索， searchType=1 搜索收藏餐厅，默认searchType=1 - city: 城市，非必填，searchType=…
campaign-calendar
查询麦当劳中国当月的营销活动日历，返回进行中、往期和未来日期的活动。适用于查看用户进行中和即将到来的可参与活动，还可查询用户对活动的订阅状态。
now-time-info
获取当前时间信息 - 返回当前服务器的完整时间信息，包括： - 时间戳（毫秒级） - 格式化的日期时间 - 年月日信息 - 时区和UTC时间 在你不知道当前时间，并且用户需要指定日期查询活动日历的时候有用
auto-bind-coupons
自动领取麦麦省所有当前可用的麦当劳优惠券。无需指定具体的优惠券和couponId，系统会自动领取用户可领的所有券。当用户说"帮我领券"、"自动领取优惠券"、"一键领券"时使用此工具。
calculate-price
Description: 计算商品的价格（含优惠），支持到店自提(orderType=1)和外送(orderType=2)两种场景 【强制】必须先确定订单类型，必填 (1：到店，2外送) 【强制】必须先获取门店信息，不可跳过 When： - 用户问"这些商品多少钱" - 用户问"总价是多少" - 用户想知道使用优惠券后的价格 - 用户选好商品后想看价格 Preconditions： - 【强制…
create-order
Description: 创建麦当劳订单，支持到店(orderType=1)和外送(orderType=2)两种场景下单, 必须先确定订单类型，必填 (1：到店，2外送) When： - 用户说"我要下单" - 用户说"帮我点餐" - 用户说"创建订单" - 用户选好商品后想结账 Input: - addressId: 配送地址ID， orderType=2时必填 - storeCode: 必填 …
delivery-create-address
Description: 创建用户配送地址，需要提供beType以便于创建地址后查询可用门店 When： - 用户想添加新的配送地址 - 用户想要麦乐送点餐，但是该用户配送地址列表为空 - 用户想要麦乐送点餐，但是要配送的地址不在该用户的配送地址列表 - 用户想要点团餐，但没有适合的配送的地址 Preconditions： - 必须提供完整的地址信息 - 如果用户未提供任何必填参数，必须先询问用户…
delivery-query-addresses
Description: 外送场景下，支持麦乐送(beType=2)和企业团餐(beType=6)两种外送场景下，查询用户配送地址列表 When： - 用户想点麦乐送 - 用户想吃麦当劳，并配送到家 - 我想点团餐 Preconditions: - 外送场景下，需要引导用户选择是麦乐送还是企业团餐(企业团餐起售门槛) Input: - beType：必传，麦乐送(beType=2)，团餐(beTy…
list-nutrition-foods
获取麦当劳常见餐品的营养成分数据，包括能量、蛋白质、脂肪、碳水化合物、钠、钙等信息，当用户咨询麦当劳餐品的热量、营养，帮助用户搭配指定热量套餐时有用
mall-create-order
创建积分兑换订单 - 当用户询问"用积分兑换这个商品"、"兑换这个券"、用户确认兑换商品时使用,切记：如果单个商品一个订单下单；如果用户需要兑换多个商品‘必须’分别下单且‘需要排队’，等前面订单结束响应成功后再调用【mall-create-order】下新的订单 前提条件： - 必须调用【mall-create-order】完成交易，**禁止**直接生成"下单成功"等结论性文字 - 用户已登录 -…
mall-points-products
查询可兑换餐品券列表 - 当用户询问"有哪些积分兑换商品"、"积分可以兑换什么"、"查看积分商城"时使用 前提条件： - 用户已登录
mall-product-detail
查询积分兑换商品详情 - 当用户询问"这个商品详情是什么"、"查看商品详细信息"、用户点击商品查看详情时使用 前提条件： - 已知商品SPU ID，需要从查询可兑换餐品券列表让用户选择一个spu才可以
query-meal-detail
Description: 餐品详情, 支持到店自提(orderType=1)和外送(orderType=2)两种场景 Input: - storeCode: 门店编码，必填 - 到店自提场景: orderType=1 && beCode=null - 外送场景: orderType=2 && beCode 为delivery-query-address中的beCode
query-meals
Description: 餐品列表, 支持到店自提(orderType=1)和外送(orderType=2)两种场景 企业团餐场景下，可按照这个规则给用户进行搭配 - **20元以下**: 小食 - **20-30元**：汉堡+小食 或 汉堡+饮料 - **30-40元**：汉堡+薯条/小食+饮料 - **40-50元**：汉堡+薯条+小食+饮料 - **50元以上**：丰富组合，优先不重复小食 …
query-my-account
查询用户积分账户详情 - 当用户询问"我有多少积分"、"查下我的积分"、"积分余额"、"查询过期积分"时使用 前提条件： - 用户已登录
query-my-coupons
获取用户卡包中的优惠券资产信息，用于“我有什么券 / 券详情查看”等展示与管理场景。 注意：该接口返回的是用户拥有的券，不进行门店、渠道、配送方式等下单规则校验，因此不承诺可用于当前订单。 若业务目标是“当前门店/当前订单可用的券”，请调用 query-store-coupons
query-order
Description: 查询订单详细信息 When： - 用户询问"查下订单详情"、"订单状态"、"我的订单" - 用户提供了麦当劳订单编号想查询配送进度 - 用户说我已支付或者支付失败时，查询一下最新的订单状态 Preconditions： - 必须已知完整的34位订单号 - 订单号必须是用户提供的原始数字，不能是脱敏后的占位符 Input: - orderId: 麦当劳订单追踪编号（34位…
query-store-coupons
Description: 查询用户在当前门店可用的优惠券，支持到店自提(orderType=1)和外送(orderType=2)两种场景 When： - 当用户已获取到门店时，用户询问"我有什么优惠券可以用" - 当用户已获取到门店时，用户想在某门店下单前查看可用优惠 - 当用户已获取到门店时，用户选择了商品后想看能用哪些券 - 当用户已获取到门店时，用户问"这个门店能用什么券" - 当用户已获取…