专星送创建订单
工具名称
create_delivery_order
MCP Endpoint
tools/call · create_delivery_order
分类
算价与下单
做什么
MCP 专星送创建订单 —— 外卖场景创建订单使用。
调用前应先通过 calculate_delivery_price
完成算价并获取临时订单信息。
调用前置
- 用户身份从请求头
x-customer-id、x-user-id获取。 - 配送场景下必须先调用
list_delivery_addresses。 - 下单请求中的
store_id、consignee_name、consignee_phone、consignee_address、latitude、longitude必须从用户选择的地址记录中获取,禁止自行拼接。 delivery_provider优先从地址delivery_type取,取不到默认1。consignee_gender优先从地址gender取,取不到默认"保密"。
幂等
必须携带有效 temp_order_id;相同 temp_order_id 的重复请求返回首次结果而非重复执行。
入参
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| store_id | string | 是 | 门店 ID,来自地址 store_items[].store_id。 |
| temp_order_id | string | 是 | 有效临时订单号,来自 calculate_delivery_price。 |
| consignee_name | string | 是 | 收件人姓名,来自地址 recipient_name。 |
| consignee_phone | string | 是 | 收件人手机号,来自地址 phone。 |
| consignee_address | string | 是 | 收件人地址,来自地址 detailed_address。 |
| consignee_gender | string | 是 | Male=先生、Female=女士、其他=保密;优先从地址 gender 取。 |
| latitude | string | 是 | 纬度,来自地址 latitude。 |
| longitude | string | 是 | 经度,来自地址 longitude。 |
| delivery_provider | integer | 是 | 配送商:1-蜂鸟、2-美团、3-顺丰、4-达达。 |
| delivery_fee | integer | 是 | 配送费。 |
| coupon_list | string[] | 否 | 优惠券 ID 列表。 |