|
@@ -23,7 +23,7 @@ LINE 创建使用 `{ddId:orderNo}`;OMG 创建使用 `{orderId:orderNo,paymentM
|
|
|
## 骑手/平台
|
|
## 骑手/平台
|
|
|
|
|
|
|
|
- 骑手待抢列表对同骑手配送组只返回一个任务,显示各店及总计;已生效、到预约开放时点才可见。`POST /system/multiStoreCheckout/groups/accept`,JSON `{groupId,version,clientRequestId}`,原子承接全部有效成员;旧单笔接单 API 对组成员拒绝拆抢。骑手仍逐子单取餐/送达。接组须以创建时首店为位置基准,在同一骑手锁内重验资格、位置时效、接单范围、容量与成员状态。首店到其他门店的合并围栏另行校验,不用最近店替代首店。组详情路径为 `GET /groups/{groupId}`,待抢/已接列表和角标使用下节的统一口径。
|
|
- 骑手待抢列表对同骑手配送组只返回一个任务,显示各店及总计;已生效、到预约开放时点才可见。`POST /system/multiStoreCheckout/groups/accept`,JSON `{groupId,version,clientRequestId}`,原子承接全部有效成员;旧单笔接单 API 对组成员拒绝拆抢。骑手仍逐子单取餐/送达。接组须以创建时首店为位置基准,在同一骑手锁内重验资格、位置时效、接单范围、容量与成员状态。首店到其他门店的合并围栏另行校验,不用最近店替代首店。组详情路径为 `GET /groups/{groupId}`,待抢/已接列表和角标使用下节的统一口径。
|
|
|
-- 组详情 `members[]` 逐子单返回 `legacyOrder`、`juli`、`jvli`:`juli` 沿旧普通详情的无定位口径返回空,`jvli` 为建单时服务端道路里程的公里快照,并与 `legacyOrder.jvli` 一致;历史无快照时为空。组卡顶层没有单一门店配送距离。
|
|
|
|
|
|
|
+- 组详情 `members[]` 逐子单返回 `legacyOrder`、`juli`、`jvli`:`juli` 在传入骑手 `longitude`/`latitude`(成对可选,只传其一拒绝)时按定位到订单坐标的直线公里距离计算,与统一列表同口径,不传为空;`jvli` 为建单时服务端道路里程的公里快照,并与 `legacyOrder.jvli` 一致;历史无快照时为空。组卡顶层没有单一门店配送距离。
|
|
|
- 商家已接未取但实际无法供餐:`POST /merchant/members/cancelUnavailable`,body `{batchId,orderId,reason:"MERCHANT_UNAVAILABLE",clientRequestId}`。仅授权门店、已接组中尚未被骑手取餐的本子单可取消;本店实收登记原路退款意图,其他店不补差;最后一个有效子单取消时结清组和父单。
|
|
- 商家已接未取但实际无法供餐:`POST /merchant/members/cancelUnavailable`,body `{batchId,orderId,reason:"MERCHANT_UNAVAILABLE",clientRequestId}`。仅授权门店、已接组中尚未被骑手取餐的本子单可取消;本店实收登记原路退款意图,其他店不补差;最后一个有效子单取消时结清组和父单。
|
|
|
- 平台配置 `GET/PUT /system/multiStoreCheckout/config`:开关、围栏米、最多店数、缓冲分钟、可增删改折扣阶梯;保存会校验并更新规则版本,仅影响新报价。平台退款跟进列表显示各商家渠道、实收、退款意图/结果/待人工处理,不提供“手工标记渠道已退款”。
|
|
- 平台配置 `GET/PUT /system/multiStoreCheckout/config`:开关、围栏米、最多店数、缓冲分钟、可增删改折扣阶梯;保存会校验并更新规则版本,仅影响新报价。平台退款跟进列表显示各商家渠道、实收、退款意图/结果/待人工处理,不提供“手工标记渠道已退款”。
|
|
|
- 平台退款跟进只读接口 `GET /system/multiStoreCheckout/admin/refunds?page=1&size=20&status=ALL`,可按 `PENDING/PROCESSING/UNKNOWN/FAILED/MANUAL_REVIEW/REFUNDED` 过滤;需要现有 `system:order:list` 权限,按退款意图逐笔分页,返回 `batchId/memberId/orderId/storeId/channel/amount/merchantOrderNo/intentStatus/gatewayStatus/effectiveStatus`。仅 `REFUNDED` 表示原渠道已证实退款;测试 OMG 无法实际退款时不得手工置为成功。
|
|
- 平台退款跟进只读接口 `GET /system/multiStoreCheckout/admin/refunds?page=1&size=20&status=ALL`,可按 `PENDING/PROCESSING/UNKNOWN/FAILED/MANUAL_REVIEW/REFUNDED` 过滤;需要现有 `system:order:list` 权限,按退款意图逐笔分页,返回 `batchId/memberId/orderId/storeId/channel/amount/merchantOrderNo/intentStatus/gatewayStatus/effectiveStatus`。仅 `REFUNDED` 表示原渠道已证实退款;测试 OMG 无法实际退款时不得手工置为成功。
|