修正发货回调流程
This commit is contained in:
@@ -32,7 +32,7 @@ export const paymentStatusTable: ParamSpec[] = [
|
||||
{ name: 'cancelled', type: 'payment_status', desc: '已取消' },
|
||||
]
|
||||
|
||||
// 订单对象公共字段说明,下单/查询/取消/回传响应共用。
|
||||
// 订单对象公共字段说明,下单/查询/取消响应共用。
|
||||
const orderFields: ParamSpec[] = [
|
||||
{ name: 'order_no', type: 'string', required: true, desc: '平台订单号' },
|
||||
{ name: 'client_order_no', type: 'string', required: true, desc: '调用方传入的幂等单号' },
|
||||
@@ -50,8 +50,8 @@ const orderFields: ParamSpec[] = [
|
||||
{ name: 'currency', type: 'string', desc: '货币,默认 POINT' },
|
||||
{ name: 'buyer_reference', type: 'string', desc: '买家标识/备注' },
|
||||
{ name: 'data', type: 'object', desc: '下单时透传的请求数据(原样回显)' },
|
||||
{ name: 'result', type: 'object', desc: '履约器回传的结果数据(原样回显)' },
|
||||
{ name: 'provider_order_no', type: 'string', desc: '履约器侧单号' },
|
||||
{ name: 'result', type: 'object', desc: '发货平台回调的结果数据(原样回显)' },
|
||||
{ name: 'provider_order_no', type: 'string', desc: '发货平台侧单号' },
|
||||
{ name: 'failure_reason', type: 'string', desc: '最近一次失败原因' },
|
||||
{ name: 'created_at', type: 'datetime', desc: '创建时间' },
|
||||
{ name: 'delivered_at', type: 'datetime', desc: '履约成功时间' },
|
||||
@@ -200,32 +200,6 @@ export const endpoints: EndpointSpec[] = [
|
||||
'已进入 processing/succeeded 的订单不可取消,返回 400。',
|
||||
],
|
||||
},
|
||||
{
|
||||
key: 'ship-notify',
|
||||
method: 'POST',
|
||||
path: '/api/client/v1/orders/{order_no}/ship-notify',
|
||||
summary: '履约器回传履约结果(processing/success/failed)',
|
||||
scope: 'fulfillment:write',
|
||||
pathParams: [{ name: 'order_no', type: 'string', required: true, desc: '平台订单号', example: 'FO20260730000123' }],
|
||||
bodyParams: [
|
||||
{ name: 'ship_status', type: 'enum(processing|success|failed)', required: true, desc: '履约结果', example: 'success' },
|
||||
{ name: 'provider_order_no', type: 'string', desc: '履约器侧单号', example: 'SRC20260720001' },
|
||||
{ name: 'fail_reason', type: 'string', desc: '失败原因(failed 时建议填)' },
|
||||
{ name: 'result', type: 'object', desc: '履约结果数据,原样存储并回显' },
|
||||
],
|
||||
requestExample: `{
|
||||
"ship_status": "success",
|
||||
"provider_order_no": "SRC20260720001",
|
||||
"result": { "delivered_at": "2026-07-30T10:05:00+08:00" }
|
||||
}`,
|
||||
responseExample: orderResponseExample,
|
||||
responseFields: orderFields,
|
||||
notes: [
|
||||
'processing → fulfillment_status=processing;success → succeeded;failed → failed(可重试)。',
|
||||
'已 succeeded 的订单再推 success 仍返回成功,不重复处理(幂等)。',
|
||||
'已 succeeded 推 failed、或 cancelled 订单推送 → 返回 400 拒绝。',
|
||||
],
|
||||
},
|
||||
{
|
||||
key: 'get-wallet',
|
||||
method: 'GET',
|
||||
|
||||
Reference in New Issue
Block a user