qmai-delivery

name	qmai-delivery
version	1.0.0
description	聚合配送：创建、取消、查询配送订单与同步配送状态
metadata	{"bins":["qmai"],"help":"qmai delivery --help"}

前置条件: 请先阅读 ../qmai-shared/SKILL.md 了解认证和配置

核心概念

• order: 创建配送单、取消配送单、查详情、查骑手位置、取消全部配送单
• status: 同步商家自配送状态
• create-and-update: 聚合接口，一次提交配送单创建和状态更新

命令概览

配送订单

qmai delivery order create --from-json delivery-create.json --dry-run
qmai delivery order cancel --multi-mark S001 --order-source 1 --origin-order-no O20260407001 --dry-run
qmai delivery order detail --order-source 1 --origin-order-no O20260407001
qmai delivery order rider-location --order-source 1 --origin-order-no O20260407001
qmai delivery order cancel-all --order-source 1 --origin-order-no O20260407001 --dry-run
qmai delivery order create-and-update --from-json delivery-update.json --dry-run

状态同步

qmai delivery status update --origin-order-no O20260407001 --order-status 5 --dry-run

开放平台 API 端点

操作	端点
创建配送订单	POST /v3/delivery/createDeliveryOrder
取消配送订单	POST /v3/delivery/cancelDeliveryOrder
查询配送单详情	POST /v3/delivery/getDeliveryOrderInfo
查询骑手当前位置	POST /v3/delivery/getRiderLocation
更新订单配送状态	POST /v3/delivery/updateSelfOrderStatus
取消全部配送单	POST /v3/delivery/cancelAllDeliveryOrder
创建配送单并更新配送状态	POST /v3/delivery/updateDeliveryStatus

注意事项（Agent 必读）

• create 和 create-and-update 请求体很大，统一用 --from-json
• cancel、cancel-all、status update 都支持 --dry-run
• create-and-update 官方文档明确说明不能和 create + updateSelfOrderStatus 混用
• order-source 和 order-status 都是平台枚举值，传值前要先按企迈文档核实