feat(order): confirmIntercept 改为 ids 批量确认拦截
- 入参由单值 order_id 改为批量 ids(数组/逗号字符串,兼容 id/order_id/orderId 单值写法) - 仅拦截发起中状态(requested/requesting/intercepting,历史值 intercepted 兼容)允许确认;none 静默跳过,已确认拦截及其它非可确认状态记录 failed - 更新 SQL where 同步限定 intercept_status 白名单,防止查询后状态被并发修改导致误更新 - 售后工单+快递群通知改为按成功订单 ID 汇总后统一调用一次 - 返回 success/failed 列表与 success_count/failed_count;同步更新接口文档与变更记录
This commit is contained in:
parent
9327611552
commit
bfbe231ff2
@ -2,6 +2,14 @@
|
|||||||
|
|
||||||
const OrderBaseService = require('./base');
|
const OrderBaseService = require('./base');
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 允许确认拦截(更新为 intercepted_at_warehouse)的前置拦截状态:
|
||||||
|
* 拦截发起中(requested/requesting/intercepting)与历史遗留值 intercepted。
|
||||||
|
* 其余状态(none/空、intercepted_at_warehouse、intercepted_in_transit、returning、returned、
|
||||||
|
* delivered_by_mistake、timeout、cancelled、failed、exception)一律不允许确认拦截。
|
||||||
|
*/
|
||||||
|
const CONFIRMABLE_INTERCEPT_STATUSES = [ 'requested', 'requesting', 'intercepting', 'intercepted' ];
|
||||||
|
|
||||||
class RecheckOrderService extends OrderBaseService {
|
class RecheckOrderService extends OrderBaseService {
|
||||||
/**
|
/**
|
||||||
* 初始化复核订单系统方法免登录、免权限、免日志与免鉴权配置。
|
* 初始化复核订单系统方法免登录、免权限、免日志与免鉴权配置。
|
||||||
@ -3617,130 +3625,212 @@ class RecheckOrderService extends OrderBaseService {
|
|||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 确认仓库拦截:通过订单ID直接匹配订单,将其拦截状态更新为"仓库拦截成功"。
|
* 确认仓库拦截:通过订单 ID 列表直接匹配订单,批量将其拦截状态更新为"仓库拦截成功"。
|
||||||
* 仅拦截当前指定订单(不波及波次内其他订单)。
|
* 仅拦截当前指定订单(不波及波次内其他订单),支持部分失败:未找到的订单与处理失败的
|
||||||
|
* 订单记录在 failed 列表并返回失败原因,其余订单继续处理。
|
||||||
|
*
|
||||||
|
* 前置条件:订单必须处于拦截发起中状态(requested/requesting/intercepting,历史值 intercepted 兼容)。
|
||||||
|
* 未发起拦截(none/空)的订单直接静默跳过不参与处理;已确认拦截(intercepted_at_warehouse)及其它
|
||||||
|
* 非可确认状态(intercepted_in_transit/returning/returned/delivered_by_mistake/timeout/cancelled/failed/
|
||||||
|
* exception)的订单一律跳过并记录失败原因;更新 SQL 的 where 同时限定拦截状态,防止并发修改导致误更新。
|
||||||
|
*
|
||||||
|
* 每个订单的拦截处理:
|
||||||
|
* 1. 更新 wms_order_delivery:intercept_status = intercepted_at_warehouse、step=4、outbound_status=fin
|
||||||
|
* 2. 同步更新运单表:is_intercept='Y'、is_back='Y'(库内拦截确认,货物在库内需退回)
|
||||||
|
* 3. 释放储位分配(cancelAllocateStorage,归还库存)
|
||||||
|
* 4. 释放订单锁(lock_status='none')
|
||||||
|
* 5. 写入操作日志(ORDER_INTERCEPT_CONFIRM)
|
||||||
|
* 全部订单处理完后,按成功订单 ID 汇总批量创建售后工单 + 通知快递群。
|
||||||
|
* 运单标记、储位释放、锁释放、工单创建、日志写入失败均不影响主流程。
|
||||||
|
*
|
||||||
* @param {Object} data 请求体。
|
* @param {Object} data 请求体。
|
||||||
* @param {number} data.order_id 订单ID。
|
* @param {number[]|string} data.ids 订单 ID 列表,支持数组或以逗号分隔的字符串(兼容 id/order_id/orderId 单值写法)。
|
||||||
* @return {Promise<Object>} 拦截确认结果,包含 order_id、intercept_status 与更新时间。
|
* @return {Promise<Object>} 批量拦截结果,包含 success/failed 列表与 success_count/failed_count 计数。
|
||||||
*/
|
*/
|
||||||
async confirmIntercept(data = {}) {
|
async confirmIntercept(data = {}) {
|
||||||
const { ctx } = this;
|
const { ctx } = this;
|
||||||
const { order_id } = data;
|
|
||||||
const warehouseId = this.getWarehouseId();
|
const warehouseId = this.getWarehouseId();
|
||||||
const orderId = Number(order_id);
|
const orderIds = this.normalizeOrderIds(data);
|
||||||
|
|
||||||
if (!orderId || !Number.isFinite(orderId) || orderId <= 0) {
|
if (orderIds.length === 0) {
|
||||||
throw new Error('order_id 无效');
|
this.ctx.throw(400, '订单ID列表不能为空');
|
||||||
}
|
}
|
||||||
|
|
||||||
const orderModel = await this.getOrderModelByTableType('current', warehouseId);
|
const orderModel = await this.getOrderModelByTableType('current', warehouseId);
|
||||||
const orderWhere = this.buildOrderWhere([ orderId ], warehouseId);
|
const orderRows = await orderModel.findAll({
|
||||||
const order = await orderModel.findOne({
|
where: this.buildOrderWhere(orderIds, warehouseId),
|
||||||
where: orderWhere,
|
|
||||||
attributes: [ 'id', 'delivery_order_code', 'pre_delivery_order_code', 'intercept_status', 'wave_no' ],
|
attributes: [ 'id', 'delivery_order_code', 'pre_delivery_order_code', 'intercept_status', 'wave_no' ],
|
||||||
raw: true,
|
raw: true,
|
||||||
});
|
});
|
||||||
|
|
||||||
if (!order) {
|
const orderMap = new Map();
|
||||||
throw new Error('未找到对应订单');
|
for (const row of orderRows) {
|
||||||
|
orderMap.set(Number(row.id), row);
|
||||||
}
|
}
|
||||||
|
|
||||||
const now = new Date();
|
const successOrders = [];
|
||||||
const updateValues = {
|
const failedOrders = [];
|
||||||
intercept_status: 'intercepted_at_warehouse',
|
const successOrderIds = [];
|
||||||
step: 4,
|
|
||||||
outbound_status: 'fin',
|
|
||||||
updated_at: now,
|
|
||||||
};
|
|
||||||
const updateResult = await orderModel.update(updateValues, {
|
|
||||||
where: orderWhere,
|
|
||||||
});
|
|
||||||
const affectedRows = Array.isArray(updateResult) ? Number(updateResult[0] || 0) : Number(updateResult || 0);
|
|
||||||
|
|
||||||
if (affectedRows <= 0) {
|
for (const orderId of orderIds) {
|
||||||
throw new Error('拦截状态更新失败,请稍后重试');
|
const order = orderMap.get(orderId);
|
||||||
|
|
||||||
|
if (!order) {
|
||||||
|
failedOrders.push({ order_id: orderId, reason: '未找到对应订单' });
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
|
||||||
|
const orderWhere = this.buildOrderWhere([ orderId ], warehouseId);
|
||||||
|
const orderNo = String(order.delivery_order_code || order.pre_delivery_order_code || '').trim();
|
||||||
|
const interceptStatus = String(order.intercept_status || '').trim();
|
||||||
|
|
||||||
|
// 未发起拦截(none/空)的订单直接跳过,不参与确认拦截处理
|
||||||
|
if (interceptStatus === '' || interceptStatus === 'none') {
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
|
||||||
|
// 已确认拦截的订单跳过,避免重复执行副作用(释放储位/工单/日志等)
|
||||||
|
if (interceptStatus === 'intercepted_at_warehouse') {
|
||||||
|
failedOrders.push({
|
||||||
|
order_id: orderId,
|
||||||
|
delivery_order_code: orderNo,
|
||||||
|
reason: '订单已确认拦截',
|
||||||
|
});
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
|
||||||
|
// 仅拦截发起中(requested/requesting/intercepting)与历史值 intercepted 允许确认,
|
||||||
|
// 其余状态(intercepted_in_transit/returning/returned/delivered_by_mistake/timeout/
|
||||||
|
// cancelled/failed/exception)不允许确认拦截
|
||||||
|
if (!CONFIRMABLE_INTERCEPT_STATUSES.includes(interceptStatus)) {
|
||||||
|
failedOrders.push({
|
||||||
|
order_id: orderId,
|
||||||
|
delivery_order_code: orderNo,
|
||||||
|
reason: `订单拦截状态不允许确认拦截: ${interceptStatus}`,
|
||||||
|
});
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
|
||||||
|
try {
|
||||||
|
const now = new Date();
|
||||||
|
const updateValues = {
|
||||||
|
intercept_status: 'intercepted_at_warehouse',
|
||||||
|
step: 4,
|
||||||
|
outbound_status: 'fin',
|
||||||
|
updated_at: now,
|
||||||
|
};
|
||||||
|
const updateResult = await orderModel.update(updateValues, {
|
||||||
|
where: {
|
||||||
|
...orderWhere,
|
||||||
|
// 数据库层再次限定拦截状态,防止查询后状态被并发修改导致误更新
|
||||||
|
intercept_status: { [ctx.app.Sequelize.Op.in]: CONFIRMABLE_INTERCEPT_STATUSES },
|
||||||
|
},
|
||||||
|
});
|
||||||
|
const affectedRows = Array.isArray(updateResult) ? Number(updateResult[0] || 0) : Number(updateResult || 0);
|
||||||
|
|
||||||
|
if (affectedRows <= 0) {
|
||||||
|
throw new Error('拦截状态更新失败,请稍后重试');
|
||||||
|
}
|
||||||
|
|
||||||
|
// 同步更新运单表:标记拦截 + 退回(库内拦截确认,货物在库内需退回)
|
||||||
|
try {
|
||||||
|
await ctx.model.OrderExpress.update(
|
||||||
|
{ is_intercept: 'Y', is_back: 'Y' },
|
||||||
|
{ where: { order_id: orderId, warehouse_id: warehouseId } }
|
||||||
|
);
|
||||||
|
} catch (expressErr) {
|
||||||
|
ctx.logger.warn(
|
||||||
|
`[recheckOrder.confirmIntercept] 更新运单拦截/退回标记失败, orderId=${orderId}, error=${expressErr.message}`
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
// 拦截成功后释放储位分配(归还库存)
|
||||||
|
try {
|
||||||
|
await this.service.systems.orderStorageAllocation.cancelAllocateStorage({
|
||||||
|
order_ids: [ orderId ],
|
||||||
|
});
|
||||||
|
} catch (allocErr) {
|
||||||
|
ctx.logger.warn(
|
||||||
|
`[recheckOrder.confirmIntercept] 释放储位分配失败,不影响拦截, orderId=${orderId}, error=${allocErr.message}`
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
// 拦截成功后释放订单锁
|
||||||
|
try {
|
||||||
|
await orderModel.update(
|
||||||
|
{ lock_status: 'none', updated_at: now },
|
||||||
|
{ where: orderWhere }
|
||||||
|
);
|
||||||
|
} catch (lockErr) {
|
||||||
|
ctx.logger.warn(
|
||||||
|
`[recheckOrder.confirmIntercept] 释放锁失败,不影响拦截, orderId=${orderId}, error=${lockErr.message}`
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
// 写入操作日志(失败不影响主流程)
|
||||||
|
try {
|
||||||
|
const operator = this.getOrderLogOperator();
|
||||||
|
const logWarehouseId = this.getOrderLogWarehouseId(warehouseId);
|
||||||
|
await ctx.service.systems.operationLog.createOperationLog({
|
||||||
|
businessType: 'order',
|
||||||
|
businessId: orderId,
|
||||||
|
operationCode: 'ORDER_INTERCEPT_CONFIRM',
|
||||||
|
operator,
|
||||||
|
extras: {
|
||||||
|
warehouseId: logWarehouseId,
|
||||||
|
orderId,
|
||||||
|
orderNo,
|
||||||
|
previousInterceptStatus: String(order.intercept_status || '').trim(),
|
||||||
|
newInterceptStatus: 'intercepted_at_warehouse',
|
||||||
|
},
|
||||||
|
beforeChanges: null,
|
||||||
|
});
|
||||||
|
} catch (logErr) {
|
||||||
|
ctx.logger.warn(
|
||||||
|
`[recheckOrder.confirmIntercept] 写入操作日志失败,不影响业务, orderId=${orderId}, error=${logErr.message}`
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
successOrders.push({
|
||||||
|
order_id: orderId,
|
||||||
|
order_no: orderNo,
|
||||||
|
intercept_status: 'intercepted_at_warehouse',
|
||||||
|
updated_at: now,
|
||||||
|
});
|
||||||
|
successOrderIds.push(orderId);
|
||||||
|
} catch (error) {
|
||||||
|
ctx.logger.warn(
|
||||||
|
`[recheckOrder.confirmIntercept] 确认拦截失败, orderId=${orderId}, error=${error.message}`
|
||||||
|
);
|
||||||
|
failedOrders.push({
|
||||||
|
order_id: orderId,
|
||||||
|
delivery_order_code: orderNo,
|
||||||
|
reason: `确认拦截失败: ${error.message}`,
|
||||||
|
});
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
// 同步更新运单表:标记拦截 + 退回(库内拦截确认,货物在库内需退回)
|
// 创建售后工单 + 通知快递群(成功订单 ID 汇总统一调用,失败不影响主流程)
|
||||||
try {
|
if (successOrderIds.length > 0) {
|
||||||
await ctx.model.OrderExpress.update(
|
try {
|
||||||
{ is_intercept: 'Y', is_back: 'Y' },
|
const operator = this.getOrderLogOperator();
|
||||||
{ where: { order_id: orderId, warehouse_id: warehouseId } }
|
await this.service.systems.afterSale.createInterceptWorkOrdersAndNotify({
|
||||||
);
|
orderIds: successOrderIds,
|
||||||
} catch (expressErr) {
|
warehouseId,
|
||||||
ctx.logger.warn(
|
creatorLabel: operator.name || '系统',
|
||||||
`[recheckOrder.confirmIntercept] 更新运单拦截/退回标记失败, orderId=${orderId}, error=${expressErr.message}`
|
});
|
||||||
);
|
} catch (workOrderErr) {
|
||||||
}
|
ctx.logger.warn(
|
||||||
|
`[recheckOrder.confirmIntercept] 创建工单/通知失败, orderIds=${successOrderIds.join(',')}, error=${workOrderErr.message}`
|
||||||
// 拦截成功后释放储位分配(归还库存)
|
);
|
||||||
try {
|
}
|
||||||
await this.service.systems.orderStorageAllocation.cancelAllocateStorage({
|
|
||||||
order_ids: [ orderId ],
|
|
||||||
});
|
|
||||||
} catch (allocErr) {
|
|
||||||
ctx.logger.warn(
|
|
||||||
`[recheckOrder.confirmIntercept] 释放储位分配失败,不影响拦截, orderId=${orderId}, error=${allocErr.message}`
|
|
||||||
);
|
|
||||||
}
|
|
||||||
|
|
||||||
// 拦截成功后释放订单锁
|
|
||||||
try {
|
|
||||||
await orderModel.update(
|
|
||||||
{ lock_status: 'none', updated_at: now },
|
|
||||||
{ where: orderWhere }
|
|
||||||
);
|
|
||||||
} catch (lockErr) {
|
|
||||||
ctx.logger.warn(
|
|
||||||
`[recheckOrder.confirmIntercept] 释放锁失败,不影响拦截, orderId=${orderId}, error=${lockErr.message}`
|
|
||||||
);
|
|
||||||
}
|
|
||||||
|
|
||||||
// 创建售后工单 + 通知快递群(失败不影响主流程)
|
|
||||||
try {
|
|
||||||
const operator = this.getOrderLogOperator();
|
|
||||||
await this.service.systems.afterSale.createInterceptWorkOrdersAndNotify({
|
|
||||||
orderIds: [ orderId ],
|
|
||||||
warehouseId,
|
|
||||||
creatorLabel: operator.name || '系统',
|
|
||||||
});
|
|
||||||
} catch (workOrderErr) {
|
|
||||||
ctx.logger.warn(
|
|
||||||
`[recheckOrder.confirmIntercept] 创建工单/通知失败, orderId=${orderId}, error=${workOrderErr.message}`
|
|
||||||
);
|
|
||||||
}
|
|
||||||
|
|
||||||
const orderNo = String(order.delivery_order_code || order.pre_delivery_order_code || '').trim();
|
|
||||||
|
|
||||||
// 写入操作日志(失败不影响主流程)
|
|
||||||
try {
|
|
||||||
const operator = this.getOrderLogOperator();
|
|
||||||
const logWarehouseId = this.getOrderLogWarehouseId(warehouseId);
|
|
||||||
await ctx.service.systems.operationLog.createOperationLog({
|
|
||||||
businessType: 'order',
|
|
||||||
businessId: orderId,
|
|
||||||
operationCode: 'ORDER_INTERCEPT_CONFIRM',
|
|
||||||
operator,
|
|
||||||
extras: {
|
|
||||||
warehouseId: logWarehouseId,
|
|
||||||
orderId,
|
|
||||||
orderNo,
|
|
||||||
previousInterceptStatus: String(order.intercept_status || '').trim(),
|
|
||||||
newInterceptStatus: 'intercepted_at_warehouse',
|
|
||||||
},
|
|
||||||
beforeChanges: null,
|
|
||||||
});
|
|
||||||
} catch (logErr) {
|
|
||||||
ctx.logger.warn(
|
|
||||||
`[recheckOrder.confirmIntercept] 写入操作日志失败,不影响业务, orderId=${orderId}, error=${logErr.message}`
|
|
||||||
);
|
|
||||||
}
|
}
|
||||||
|
|
||||||
return {
|
return {
|
||||||
order_id: orderId,
|
success: successOrders,
|
||||||
order_no: orderNo,
|
failed: failedOrders,
|
||||||
intercept_status: 'intercepted_at_warehouse',
|
success_count: successOrders.length,
|
||||||
updated_at: now,
|
failed_count: failedOrders.length,
|
||||||
};
|
};
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|||||||
@ -1,4 +1,21 @@
|
|||||||
[
|
[
|
||||||
|
{
|
||||||
|
"version": "2026.08.19-recheckOrder.confirmIntercept-ids",
|
||||||
|
"date": "2026-08-19",
|
||||||
|
"type": "enhanced",
|
||||||
|
"summary": "order.recheckOrder.confirmIntercept 入参由单值 order_id 改为批量 ids:支持数组或以逗号分隔的字符串(兼容 id/order_id/orderId 单值写法),批量确认拦截,返回 success/failed 列表与 success_count/failed_count 计数;单个订单失败不再阻断整体,未找到订单与更新失败订单记录在 failed 列表",
|
||||||
|
"methods": [
|
||||||
|
"order.recheckOrder.confirmIntercept"
|
||||||
|
],
|
||||||
|
"notes": [
|
||||||
|
"app/service/systemMethods/order/recheckOrder.js confirmIntercept:用 base.normalizeOrderIds 解析 ids(兼容 ids/id/order_id/orderId),findAll 批量查询后逐订单执行拦截主流程(intercept_status=intercepted_at_warehouse、step=4、outbound_status=fin,运单标记 is_back/is_intercept='Y',释放储位分配与订单锁,写入 ORDER_INTERCEPT_CONFIRM 操作日志),未找到订单与处理异常订单记录 failed 不抛错,仅 ids 全部无效时 400「订单ID列表不能为空」",
|
||||||
|
"确认拦截前置校验:仅拦截发起中状态(requested/requesting/intercepting,历史值 intercepted 兼容)允许确认;未发起拦截(none/空)的订单直接静默跳过不参与处理,已确认拦截(intercepted_at_warehouse)订单跳过避免重复副作用并记录 failed「订单已确认拦截」,其余非可确认状态(intercepted_in_transit/returning/returned/delivered_by_mistake/timeout/cancelled/failed/exception)记录 failed「订单拦截状态不允许确认拦截: {状态}」;更新 SQL where 同时限定 intercept_status 白名单(CONFIRMABLE_INTERCEPT_STATUSES),防止查询后状态被并发修改导致误更新",
|
||||||
|
"售后工单+快递群通知由原每订单调用改为按成功订单 ID 汇总后统一调用一次 afterSale.createInterceptWorkOrdersAndNotify,失败仅告警",
|
||||||
|
"返回结构由单对象改为 { success, failed, success_count, failed_count },success 每项保持 order_id/order_no/intercept_status/updated_at,failed 每项含 order_id/delivery_order_code/reason",
|
||||||
|
"同步更新 methods/system.json 中该接口 params(ids)、response 与 errors 文档"
|
||||||
|
],
|
||||||
|
"module": "order.recheckOrder"
|
||||||
|
},
|
||||||
{
|
{
|
||||||
"version": "2026.08.18-order-list-lock-status-filter-doc",
|
"version": "2026.08.18-order-list-lock-status-filter-doc",
|
||||||
"date": "2026-08-18",
|
"date": "2026-08-18",
|
||||||
|
|||||||
@ -6039,7 +6039,7 @@
|
|||||||
},
|
},
|
||||||
{
|
{
|
||||||
"method": "order.recheckOrder.confirmIntercept",
|
"method": "order.recheckOrder.confirmIntercept",
|
||||||
"description": "确认拦截:通过订单ID直接匹配订单,将其拦截状态更新为 intercepted_at_warehouse(仓库已拦截),同时释放储位分配(cancelAllocateStorage)与订单锁(lock_status=none)。仅拦截当前指定订单,不波及波次内其他订单。操作成功后写入操作日志(ORDER_INTERCEPT_CONFIRM)。储位释放、锁释放、日志写入失败均不影响主流程。",
|
"description": "确认拦截:通过订单 ID 列表批量匹配订单,将拦截状态更新为 intercepted_at_warehouse(仓库已拦截,step=4、outbound_status=fin),同步标记运单退回与拦截(is_back='Y', is_intercept='Y'),并释放储位分配(cancelAllocateStorage)与订单锁(lock_status=none)。仅拦截当前指定订单,不波及波次内其他订单。前置条件:订单必须处于拦截发起中状态(requested/requesting/intercepting,历史值 intercepted 兼容),未发起拦截(none/空)的订单直接静默跳过不参与处理,已确认拦截(intercepted_at_warehouse)及其它非可确认状态(intercepted_in_transit/returning/returned/delivered_by_mistake/timeout/cancelled/failed/exception)一律跳过并记录失败原因;更新 SQL 的 where 同时限定拦截状态白名单,防止并发修改导致误更新。支持部分失败:未找到的订单与处理失败的订单记录在 failed 列表并返回失败原因,其余订单继续处理。全部订单处理完后按成功订单 ID 汇总批量创建售后工单 + 通知快递群。每个订单操作成功后写入操作日志(ORDER_INTERCEPT_CONFIRM)。运单标记、储位释放、锁释放、工单创建、日志写入失败均不影响主流程。",
|
||||||
"isNeedAuth": false,
|
"isNeedAuth": false,
|
||||||
"isNeedLogin": true,
|
"isNeedLogin": true,
|
||||||
"headers": [
|
"headers": [
|
||||||
@ -6052,53 +6052,83 @@
|
|||||||
],
|
],
|
||||||
"params": [
|
"params": [
|
||||||
{
|
{
|
||||||
"name": "order_id",
|
"name": "ids",
|
||||||
"type": "number",
|
"type": "array<number>|string",
|
||||||
"required": true,
|
"required": true,
|
||||||
"source": "body",
|
"source": "body",
|
||||||
"description": "订单 ID"
|
"description": "订单 ID 列表,支持数组或以逗号分隔的字符串。兼容 id / order_id / orderId 单值写法"
|
||||||
}
|
}
|
||||||
],
|
],
|
||||||
"response": [
|
"response": [
|
||||||
{
|
{
|
||||||
"name": "order_id",
|
"name": "success",
|
||||||
|
"type": "array",
|
||||||
|
"required": true,
|
||||||
|
"description": "拦截成功的订单列表",
|
||||||
|
"children": [
|
||||||
|
{
|
||||||
|
"name": "order_id",
|
||||||
|
"type": "number",
|
||||||
|
"description": "订单 ID"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"name": "order_no",
|
||||||
|
"type": "string",
|
||||||
|
"description": "订单号(优先 delivery_order_code,其次 pre_delivery_order_code)"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"name": "intercept_status",
|
||||||
|
"type": "string",
|
||||||
|
"description": "拦截状态(固定为 'intercepted_at_warehouse')"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"name": "updated_at",
|
||||||
|
"type": "string",
|
||||||
|
"description": "更新时间(ISO 字符串)"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"name": "failed",
|
||||||
|
"type": "array",
|
||||||
|
"required": true,
|
||||||
|
"description": "拦截失败的订单列表",
|
||||||
|
"children": [
|
||||||
|
{
|
||||||
|
"name": "order_id",
|
||||||
|
"type": "number",
|
||||||
|
"description": "订单 ID"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"name": "delivery_order_code",
|
||||||
|
"type": "string",
|
||||||
|
"description": "发货单号(订单存在时返回)"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"name": "reason",
|
||||||
|
"type": "string",
|
||||||
|
"description": "失败原因(未找到对应订单 / 订单已确认拦截 / 订单拦截状态不允许确认拦截: xxx / 确认拦截失败: xxx);拦截状态为 none 的订单静默跳过,不进入 failed"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"name": "success_count",
|
||||||
"type": "number",
|
"type": "number",
|
||||||
"required": true,
|
"required": true,
|
||||||
"description": "订单 ID"
|
"description": "成功数量"
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
"name": "order_no",
|
"name": "failed_count",
|
||||||
"type": "string",
|
"type": "number",
|
||||||
"required": true,
|
"required": true,
|
||||||
"description": "订单号(优先 delivery_order_code,其次 pre_delivery_order_code)"
|
"description": "失败数量"
|
||||||
},
|
|
||||||
{
|
|
||||||
"name": "intercept_status",
|
|
||||||
"type": "string",
|
|
||||||
"required": true,
|
|
||||||
"description": "拦截状态(固定为 'intercepted_at_warehouse')"
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"name": "updated_at",
|
|
||||||
"type": "string",
|
|
||||||
"required": true,
|
|
||||||
"description": "更新时间(ISO 字符串)"
|
|
||||||
}
|
}
|
||||||
],
|
],
|
||||||
"errors": [
|
"errors": [
|
||||||
{
|
{
|
||||||
"code": 400,
|
"code": 400,
|
||||||
"message": "order_id 无效",
|
"message": "订单ID列表不能为空",
|
||||||
"description": "order_id 无效(为空或非正整数)"
|
"description": "ids 为空或全部无效(非正整数)时返回"
|
||||||
},
|
|
||||||
{
|
|
||||||
"code": 404,
|
|
||||||
"message": "未找到对应订单"
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"code": 500,
|
|
||||||
"message": "拦截状态更新失败,请稍后重试",
|
|
||||||
"description": "数据库更新影响行数为 0 时返回"
|
|
||||||
}
|
}
|
||||||
]
|
]
|
||||||
},
|
},
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user