Starbucks星巴克 MCP 开放平台

专星送创建订单

工具名称
create_delivery_order
MCP Endpoint
tools/call · create_delivery_order
分类
算价与下单

做什么

MCP 专星送创建订单 —— 外卖场景创建订单使用。 调用前应先通过 calculate_delivery_price 完成算价并获取临时订单信息。

调用前置

  • 用户身份从请求头 x-customer-idx-user-id 获取。
  • 配送场景下必须先调用 list_delivery_addresses
  • 下单请求中的 store_idconsignee_nameconsignee_phoneconsignee_addresslatitudelongitude 必须从用户选择的地址记录中获取,禁止自行拼接
  • delivery_provider 优先从地址 delivery_type 取,取不到默认 1
  • consignee_gender 优先从地址 gender 取,取不到默认"保密"。
幂等

必须携带有效 temp_order_id;相同 temp_order_id 的重复请求返回首次结果而非重复执行。

入参

参数类型必填说明
store_idstring门店 ID,来自地址 store_items[].store_id。
temp_order_idstring有效临时订单号,来自 calculate_delivery_price。
consignee_namestring收件人姓名,来自地址 recipient_name。
consignee_phonestring收件人手机号,来自地址 phone。
consignee_addressstring收件人地址,来自地址 detailed_address。
consignee_genderstringMale=先生、Female=女士、其他=保密;优先从地址 gender 取。
latitudestring纬度,来自地址 latitude。
longitudestring经度,来自地址 longitude。
delivery_providerinteger配送商:1-蜂鸟、2-美团、3-顺丰、4-达达。
delivery_feeinteger配送费。
coupon_liststring[]优惠券 ID 列表。