加强发货提交可靠性并统一契约口径
- 发货提交记录阶段推进与失败分类,失败不再清空 result_data - 超时巡检区分已提交上游与提交中断两类卡单,避免误判 - 已提交上游的失败订单禁止自动重发,防止重复发货 - ship_attempts 仅在 claim 时计数,失败阶段只记录分类信息 - CanFulfill 对已提交上游的失败单返回不可发货 - 删除预留的 pending 订单状态,统一订单状态模型 - 契约改名:order.fulfillment.updated -> order.shipping.updated,fulfillment:read -> shipping:read - 文档修正 scope 为或关系
This commit is contained in:
@@ -18,7 +18,6 @@ export const errorCodes: ParamSpec[] = [
|
||||
|
||||
// 订单状态与可发货说明。
|
||||
export const orderStatusTable: ParamSpec[] = [
|
||||
{ name: 'pending', type: 'order_status', desc: '待支付(当前无真实支付流程,仅预留)', example: 'can_ship=false' },
|
||||
{ name: 'paid', type: 'order_status', desc: '已支付/已扣款,可发货', example: 'can_ship=true' },
|
||||
{ name: 'delivering', type: 'order_status', desc: '发货中', example: 'can_ship=false' },
|
||||
{ name: 'delivered', type: 'order_status', desc: '已交付', example: 'can_ship=false' },
|
||||
@@ -263,7 +262,7 @@ export const endpoints: EndpointSpec[] = [
|
||||
path: '/api/client/v1/orders/{order_no}/delivery-link',
|
||||
title: '获取发货链接',
|
||||
summary: '获取签名发货链接,适合直接跳转平台 Web 发货页',
|
||||
scope: 'orders:read + fulfillment:read',
|
||||
scope: 'orders:read 或 shipping:read',
|
||||
pathParams: [{ name: 'order_no', type: 'string', required: true, desc: '平台订单号', example: 'FO20260730000123' }],
|
||||
responseExample: deliveryLinkResponseExample,
|
||||
responseFields: [
|
||||
@@ -284,7 +283,7 @@ export const endpoints: EndpointSpec[] = [
|
||||
path: '/api/client/v1/orders/{order_no}/delivery',
|
||||
title: '查询发货数据',
|
||||
summary: '查询发货页结构化数据,适合商户自建发货界面',
|
||||
scope: 'orders:read + fulfillment:read',
|
||||
scope: 'orders:read 或 shipping:read',
|
||||
pathParams: [{ name: 'order_no', type: 'string', required: true, desc: '平台订单号', example: 'FO20260730000123' }],
|
||||
responseExample: deliveryOrderResponseExample,
|
||||
responseFields: [
|
||||
|
||||
Reference in New Issue
Block a user