- 仪表盘报表:新增 app/service/dashboard.js + app/controller/dashboard.js + app/lib/billStatus.js,注册 GET /api/dashboard/report(jwtAuth + principalCheck), 一次聚合返回概览指标、发货单/入库单/出库单状态分布与待办、近 N 天单据量与 出入库数量趋势、库存 Top 商品、最近出入库流水;warehouse_id 只过滤单据与流水 (product_stocks 无仓库维度);契约 dashboard* 同步到 swagger - 接口配置裁剪:仓库接口配置只保留 api_version 与 item_name_with_spec; 历史 warehouse_apis.extra 冗余键、owner_code 配置、递交/回传设置一并清理 (迁移 20260915002400~02800) - 入库/出库/发货单报文与字段对齐 WMS 标准:去掉 ownerCode、operatorCode 等多余字段, 入库明细补 itemId;发货单明细去掉无意义的 owner_code(迁移 20260915002600) - 单号 5 位起:四张单据表 AUTO_INCREMENT 提到 10000(迁移 20260915002900) - 账号名称/头像按主体维护:principal_users 增 name/avatar 并回填(迁移 20260915003000/03100), 新增 app/lib/accountProfile.js(关联表名称/头像 → users 兜底);审核人写入 operator/operator_name; register 不再写 nickname、updateProfile 仅接受邮箱/手机号 - 出库单推送/锁库存链路的配套调整(outboundOrderPush、订单与发货单控制器) Co-Authored-By: GitHub Copilot <noreply@github.com>
1357 lines
56 KiB
JavaScript
1357 lines
56 KiB
JavaScript
'use strict';
|
||
|
||
const { Controller } = require('egg');
|
||
const { parsePagination, buildPageResult } = require('../lib/pagination');
|
||
const { validateItems, buildItemRow } = require('../lib/orderDeliveryItems');
|
||
const recalcOrderDelivery = require('../utils/recalcOrderDelivery');
|
||
const nextRejectedBillNo = require('../utils/rejectBillNo');
|
||
const { lockDeliveryStock, releaseDeliveryStock } = require('../utils/deliveryStock');
|
||
const { isValidShopSyncStatus, SHOP_SYNC_STATUS_LIST } = require('../lib/shopSyncStatus');
|
||
const { resolveAccountName } = require('../lib/accountProfile');
|
||
const QimenWmsClient = require('../lib/wms/qimenClient');
|
||
const {
|
||
DELIVERY_ORDER_TYPE_LIST,
|
||
DEFAULT_DELIVERY_ORDER_TYPE,
|
||
normalizeDeliveryOrderType,
|
||
} = require('../lib/wms/orderTypes');
|
||
|
||
/**
|
||
* 发货单号前缀:单号一律由系统生成 `FH_{自增id}`,前端与接口均不可传入(对齐入库 RK_/出库 CK_ 约定)
|
||
* 注:历史搬迁数据保留原 orders.order_no 作为单号(见 20260915000300 迁移)
|
||
*/
|
||
const DELIVERY_BILL_PREFIX = 'FH';
|
||
|
||
/** 手工创建订单在扩展字段(extend_props)中写入的标记 */
|
||
const HANDMADE_ORDER_LABEL = '手工单';
|
||
|
||
/** 收件人必填字段(对齐取号硬依赖):姓名 / 省 / 市 / 区 / 镇 */
|
||
const RECEIVER_REQUIRED_FIELDS = [
|
||
[ 'name', '收件人姓名' ],
|
||
[ 'province', '省份' ],
|
||
[ 'city', '城市' ],
|
||
[ 'area', '区县' ],
|
||
[ 'town', '街道/镇' ],
|
||
];
|
||
|
||
/**
|
||
* 收件人信息校验:姓名/省/市/区/镇 必填;电话(tel)与手机(mobile)至少填写一个
|
||
* @param {Object} data 待校验数据(可为记录 + 本次变更合并后的结果)
|
||
* @return {string} 错误信息,校验通过返回空串
|
||
*/
|
||
function validateReceiver(data) {
|
||
const source = data || {};
|
||
for (const [ key, label ] of RECEIVER_REQUIRED_FIELDS) {
|
||
const value = source[key] == null ? '' : String(source[key]).trim();
|
||
if (!value) return `收件人信息不完整:${label}为必填项`;
|
||
}
|
||
const tel = source.tel == null ? '' : String(source.tel).trim();
|
||
const mobile = source.mobile == null ? '' : String(source.mobile).trim();
|
||
if (!tel && !mobile) return '收件人信息不完整:电话(tel)与手机(mobile)至少填写一个';
|
||
return '';
|
||
}
|
||
|
||
/**
|
||
* 由系统与业务事务推动,禁止通过通用新增/更新接口写入:
|
||
* - 单号(delivery_order_code):一律系统生成 FH_{自增id}
|
||
* - 状态与推送记录:避免绕过状态机或篡改推送结果
|
||
* - 统计(item_total/item_kind/item_amount):由明细增删改后统一重算(商品总金额由明细金额合计得出)
|
||
* - 审核/作废痕迹:只能由 audit / void 接口写入
|
||
* - 取号开关(need_oms_waybill):手工创建的订单恒为 0,该字段留给其他来源订单使用(暂不处理)
|
||
* - 运单号(express_code)/ 快递区域编码(logistics_area_code):手工不填写,由取号/快递策略或回写链路服务端写入
|
||
* - 手工单不填写:下单时间(取创建时间)、店铺名称(取所选店铺)、支付单号/支付时间/审核时间、
|
||
* 来源平台/卖家名称/买家名称、买家留言(只保留卖家留言作为「留言」)、预发货单号/ID、订单标记、
|
||
* 来源订单号集合、OAID 来源编码与收件人 OAID、扩展字段
|
||
* (扩展字段由服务端固定写 `labels: "手工单"`)
|
||
* (对齐出入库单的 MANAGED_FIELDS 约定)
|
||
*/
|
||
const MANAGED_FIELDS = [
|
||
'delivery_order_code',
|
||
'need_oms_waybill',
|
||
'express_code', 'logistics_area_code', 'express_codes',
|
||
'shop_sync_status', 'shop_sync_retry_count',
|
||
'status', 'pushed_at', 'wms_push_result', 'created_by', 'stock_locked',
|
||
'item_total', 'item_kind', 'item_amount',
|
||
'audit_by', 'audit_time',
|
||
'void_at', 'void_by', 'void_reason',
|
||
'place_order_time', 'pay_time', 'pay_no', 'operate_time',
|
||
'shop_nick', 'seller_nick', 'buyer_nick', 'buyer_message',
|
||
'source_platform_code', 'source_platform_name',
|
||
'pre_delivery_order_code', 'pre_delivery_order_id',
|
||
'order_flag', 'source_order_codes', 'oaid_order_source_code', 'oaid',
|
||
'extend_props',
|
||
// 操作人(奇门 operatorName)由审核流程写入 = 审核人在本主体下的账号名称,不接受接口传入
|
||
'operator_name',
|
||
];
|
||
|
||
/** 可编辑明细/单据头的状态:仅「待处理(1)」 */
|
||
const EDITABLE_STATUS = 1;
|
||
|
||
/**
|
||
* 可切换发货仓库的状态:待处理(1) 与 已审核(2)
|
||
* - 已推送(3) / 已完成(4):warehouseCode 已递交 WMS,切换会与仓库侧不一致
|
||
* - 已作废(5) / 已取消(9):切换无业务意义
|
||
*/
|
||
const SWITCHABLE_WAREHOUSE_STATUS = [ 1, 2 ];
|
||
|
||
/**
|
||
* 可设置所属店铺的状态:待处理(1) / 已审核(2) / 已推送(3)
|
||
* - 店铺只影响推送时的快递策略匹配(shopNick)与 OMS 自身记录,不回写 WMS,
|
||
* 所以「已推送(3)」也允许修正;已完成(4) / 已作废(5) / 已取消(9) 不再变更
|
||
*/
|
||
const SHOP_SWITCHABLE_STATUS = [ 1, 2, 3 ];
|
||
|
||
/**
|
||
* @controller OrderDeliveryController 发货单(订单)管理
|
||
* 单据头 order_deliveries;字段口径对齐 WMS wms_order_delivery 与奇门 deliveryOrder/receiverInfo
|
||
* 推送链路(接口配置、报文映射、重试与定时任务)见 app/service/orderDeliveryPush.js、app/schedule/orderDeliveryPush.js
|
||
*/
|
||
class OrderDeliveryController extends Controller {
|
||
/**
|
||
* @summary 发货单列表
|
||
* @description 分页查询发货单,支持按发货单号、状态、订单类型、店铺与仓库过滤
|
||
* @router get /api/order-deliveries
|
||
* @apikey
|
||
* @request query integer page 页码,默认 1
|
||
* @request query integer pageSize 每页条数,默认 20
|
||
* @request query integer principal_id 所属主体ID(必填,需当前账号已绑定该主体)
|
||
* @request query string delivery_order_code 发货单号,支持模糊匹配
|
||
* @request query integer status 状态:1待处理 2已审核 3已推送 4已完成 5已作废 9已取消
|
||
* @request query string order_type 订单类型(ORDER 组枚举):JYCK 一般交易出库单 / HHCK 换货出库 / BFCK 补发出库
|
||
* @request query integer shop_id 店铺ID
|
||
* @request query integer warehouse_id 仓库ID
|
||
* @request query integer shop_sync_status 回传平台店铺状态:0未同步 1同步中 2同步成功 3同步失败
|
||
* @response 200 orderDeliveryListResponse success
|
||
*/
|
||
async index() {
|
||
const { ctx } = this;
|
||
const Op = this.app.Sequelize.Op;
|
||
const { page, pageSize, offset, limit } = parsePagination(ctx.query);
|
||
const {
|
||
delivery_order_code: deliveryOrderCode,
|
||
status,
|
||
order_type: orderType,
|
||
shop_id: shopId,
|
||
warehouse_id: warehouseId,
|
||
shop_sync_status: shopSyncStatus,
|
||
} = ctx.query;
|
||
const principalId = ctx.state.principalId;
|
||
|
||
const where = { principal_id: principalId };
|
||
if (deliveryOrderCode) where.delivery_order_code = { [Op.like]: `%${deliveryOrderCode}%` };
|
||
if (status !== undefined && status !== '') where.status = Number(status);
|
||
if (orderType) where.order_type = String(orderType).trim().toUpperCase();
|
||
if (shopId) where.shop_id = Number(shopId);
|
||
if (warehouseId) where.warehouse_id = Number(warehouseId);
|
||
if (shopSyncStatus !== undefined && shopSyncStatus !== '') {
|
||
if (!isValidShopSyncStatus(shopSyncStatus)) {
|
||
ctx.status = 400;
|
||
ctx.body = {
|
||
code: 400,
|
||
message: `shop_sync_status 取值非法(支持 ${SHOP_SYNC_STATUS_LIST.map(i => `${i.value}${i.label}`).join(' / ')})`,
|
||
};
|
||
return;
|
||
}
|
||
where.shop_sync_status = Number(shopSyncStatus);
|
||
}
|
||
|
||
const { count, rows } = await ctx.model.OrderDelivery.findAndCountAll({
|
||
where,
|
||
offset,
|
||
limit,
|
||
order: [[ 'id', 'DESC' ]],
|
||
include: [
|
||
{ model: ctx.model.Shop, as: 'shop', attributes: [ 'id', 'name' ] },
|
||
{ model: ctx.model.Warehouse, as: 'warehouse', attributes: [ 'id', 'code', 'name' ] },
|
||
{ model: ctx.model.User, as: 'creator', attributes: [ 'id', 'nickname', 'username' ] },
|
||
],
|
||
});
|
||
|
||
ctx.body = { code: 0, message: 'success', data: buildPageResult(rows, count, { page, pageSize }) };
|
||
}
|
||
|
||
/**
|
||
* @summary 发货单详情
|
||
* @description 按主键查询发货单,含所属主体、店铺、仓库与创建人
|
||
* @router get /api/order-deliveries/{id}
|
||
* @apikey
|
||
* @request path integer *id 发货单主键ID
|
||
* @response 200 baseResponse success
|
||
*/
|
||
async show() {
|
||
const { ctx } = this;
|
||
const order = await ctx.model.OrderDelivery.findByPk(ctx.params.id, {
|
||
include: [
|
||
{ model: ctx.model.Shop, as: 'shop', attributes: [ 'id', 'name' ] },
|
||
{ model: ctx.model.Warehouse, as: 'warehouse', attributes: [ 'id', 'code', 'name' ] },
|
||
{ model: ctx.model.User, as: 'creator', attributes: [ 'id', 'nickname', 'username' ] },
|
||
// 子表商品明细(orderLines),按行号升序
|
||
{ model: ctx.model.OrderDeliveryItem, as: 'items', separate: true, order: [[ 'order_line_no', 'ASC' ], [ 'id', 'ASC' ]] },
|
||
],
|
||
});
|
||
|
||
if (!order) {
|
||
ctx.status = 404;
|
||
ctx.body = { code: 404, message: '发货单不存在' };
|
||
return;
|
||
}
|
||
|
||
ctx.body = { code: 0, message: 'success', data: order };
|
||
}
|
||
|
||
/**
|
||
* @summary 收件人信息智能识别
|
||
* @description 传入一段文本(如从聊天工具复制的姓名/电话/地址),调用 AI 抽取收件人字段并返回;
|
||
* 仅返回识别结果不落库,由前端回填表单;未配置 AI 密钥(DEEPSEEK_API_KEY)时返回 400 提示
|
||
* @router post /api/order-deliveries/parse-receiver
|
||
* @apikey
|
||
* @request body parseReceiverRequest *body
|
||
* @response 200 baseResponse success
|
||
*/
|
||
async parseReceiver() {
|
||
const { ctx } = this;
|
||
const text = String((ctx.request.body || {}).text || '').trim();
|
||
|
||
if (!text) {
|
||
ctx.status = 400;
|
||
ctx.body = { code: 400, message: 'text(待识别的文本)为必填项' };
|
||
return;
|
||
}
|
||
|
||
try {
|
||
const data = await ctx.service.ai.parseReceiver(text);
|
||
ctx.body = { code: 0, message: 'success', data };
|
||
} catch (err) {
|
||
ctx.status = 400;
|
||
ctx.body = { code: 400, message: err.message || '智能识别失败,请稍后重试' };
|
||
}
|
||
}
|
||
|
||
/**
|
||
* @summary 新增发货单
|
||
* @description 发货单号由系统生成(`FH_{自增id}`),不接受传入;
|
||
* 状态由服务端固定为 1(待处理);取号开关 need_oms_waybill 恒为 0(该字段留给其他来源订单,暂不处理);
|
||
* 下单时间取创建时间、店铺名称取所选店铺、扩展字段固定写 `labels: 手工单`;
|
||
* 收件人必填:姓名/省/市/区/镇,电话与手机至少填一个;
|
||
* 仓库必填(推送仓库需要 warehouseCode 与仓库接口配置);
|
||
* 仓库/店铺需属于当前主体;items 为子表商品明细(奇门 orderLines),随单在同一事务内创建
|
||
* @router post /api/order-deliveries
|
||
* @apikey
|
||
* @request body createOrderDeliveryRequest *body
|
||
* @response 200 baseResponse success
|
||
*/
|
||
async create() {
|
||
const { ctx } = this;
|
||
const body = ctx.request.body || {};
|
||
const principalId = ctx.state.principalId;
|
||
|
||
const warehouseId = body.warehouse_id != null && body.warehouse_id !== '' ? Number(body.warehouse_id) : null;
|
||
// 仓库必填:推送 WMS 需要 warehouseCode,且仓库接口配置(app_key/base_url)挂在仓库维度
|
||
if (!warehouseId) {
|
||
ctx.status = 400;
|
||
ctx.body = { code: 400, message: 'warehouse_id(仓库)为必填项:推送仓库需要仓库编码与仓库接口配置' };
|
||
return;
|
||
}
|
||
// 店铺必填:shopNick 取所选店铺名称,WMS 侧靠它匹配快递策略(缺失时可能匹配不到快递)
|
||
const shopId = body.shop_id != null && body.shop_id !== '' ? Number(body.shop_id) : null;
|
||
if (!shopId) {
|
||
ctx.status = 400;
|
||
ctx.body = { code: 400, message: 'shop_id(店铺)为必填项:推送仓库时 shopNick 取所选店铺名称' };
|
||
return;
|
||
}
|
||
|
||
// 订单类型:ORDER 组枚举(JYCK/HHCK/BFCK),非法值拒绝,不传时默认 JYCK(一般交易出库单)
|
||
const orderType = normalizeDeliveryOrderType(body.order_type);
|
||
if (body.order_type != null && String(body.order_type).trim() !== '' && !orderType) {
|
||
ctx.status = 400;
|
||
ctx.body = { code: 400, message: `order_type(订单类型)不合法,支持:${DELIVERY_ORDER_TYPE_LIST.join(' / ')}` };
|
||
return;
|
||
}
|
||
|
||
// 主体隔离:仓库/店铺必须属于当前主体(防止跨主体挂单)
|
||
const ownerCheck = await this.assertOwnerBelongsToPrincipal(warehouseId, body.shop_id);
|
||
if (!ownerCheck.ok) {
|
||
ctx.status = 404;
|
||
ctx.body = { code: 404, message: ownerCheck.message };
|
||
return;
|
||
}
|
||
|
||
// 明细校验:plan_qty 必须 > 0、item_id/item_code 至少一个、行号不重复(对齐 WMS addOrderLines 口径)
|
||
const items = Array.isArray(body.items) ? body.items : [];
|
||
if (items.length) {
|
||
const invalid = validateItems(items);
|
||
if (!invalid.ok) {
|
||
ctx.status = 400;
|
||
ctx.body = { code: 400, message: invalid.message };
|
||
return;
|
||
}
|
||
}
|
||
|
||
const payload = { ...body };
|
||
// 归属主体一律取中间件校验过的 principalId,防止请求体篡改越权
|
||
delete payload.principal_id;
|
||
delete payload.items;
|
||
// remark 列已删除(见迁移 20260915000900,留言统一写 seller_message)
|
||
delete payload.remark;
|
||
for (const f of MANAGED_FIELDS) delete payload[f];
|
||
|
||
// 收件人校验:姓名/省/市/区/镇 必填,电话与手机至少填一个
|
||
const receiverError = validateReceiver(payload);
|
||
if (receiverError) {
|
||
ctx.status = 400;
|
||
ctx.body = { code: 400, message: receiverError };
|
||
return;
|
||
}
|
||
|
||
// 仓库编码快照:未显式传入时按 warehouse_id 取 warehouses.code(推送时使用该编码)
|
||
if (warehouseId && !payload.warehouse_code) {
|
||
const warehouse = await ctx.model.Warehouse.findByPk(warehouseId, { attributes: [ 'id', 'code' ] });
|
||
if (warehouse) payload.warehouse_code = warehouse.code;
|
||
}
|
||
|
||
// 店铺名称(shop_nick)取所选店铺名称,无需手工填写(shopId 已在前面必填校验中解析)
|
||
let shopNick = null;
|
||
if (shopId) {
|
||
const shop = await ctx.model.Shop.findByPk(shopId, { attributes: [ 'id', 'name' ] });
|
||
if (shop) shopNick = shop.name;
|
||
}
|
||
|
||
// 取号开关:手工创建的订单恒为 0(need_oms_waybill 在 MANAGED_FIELDS 中,不接受传入)
|
||
|
||
const transaction = await ctx.model.transaction();
|
||
try {
|
||
const order = await ctx.model.OrderDelivery.create({
|
||
principal_id: principalId,
|
||
status: 1,
|
||
order_type: orderType || DEFAULT_DELIVERY_ORDER_TYPE,
|
||
need_oms_waybill: 0,
|
||
created_by: ctx.userId,
|
||
...payload,
|
||
warehouse_id: warehouseId,
|
||
// 手工单系统派生字段:店铺名称取所选店铺;下单时间取创建时间;扩展字段固定标记手工单
|
||
shop_nick: shopNick,
|
||
place_order_time: new Date(),
|
||
extend_props: { labels: HANDMADE_ORDER_LABEL },
|
||
// 单号不接受传入:先用临时号占位,拿到自增 id 后回写 FH_{id}
|
||
delivery_order_code: `${DELIVERY_BILL_PREFIX}_TMP_${Date.now()}_${Math.floor(Math.random() * 100000)}`,
|
||
}, { transaction });
|
||
|
||
if (items.length) {
|
||
await ctx.model.OrderDeliveryItem.bulkCreate(items.map((item, idx) => buildItemRow(item, {
|
||
principalId,
|
||
orderDeliveryId: order.id,
|
||
lineIndex: idx,
|
||
})), { transaction });
|
||
}
|
||
|
||
// 系统生成发货单号:FH_{自增id}
|
||
await order.update({ delivery_order_code: `${DELIVERY_BILL_PREFIX}_${order.id}` }, { transaction });
|
||
|
||
await transaction.commit();
|
||
// 商品总数/种类数:由明细统一重算(同出入库单口径)
|
||
if (items.length) await recalcOrderDelivery(ctx, order.id);
|
||
ctx.body = { code: 0, message: 'success', data: { id: order.id, delivery_order_code: order.delivery_order_code } };
|
||
} catch (err) {
|
||
await transaction.rollback();
|
||
ctx.status = 500;
|
||
ctx.body = { code: 500, message: '新增发货单失败,请稍后重试' };
|
||
}
|
||
}
|
||
|
||
/**
|
||
* @summary 更新发货单
|
||
* @description 未传入的字段保持原值;发货单号与状态/推送记录不可通过本接口修改
|
||
* @router put /api/order-deliveries/{id}
|
||
* @apikey
|
||
* @request path integer *id 发货单主键ID
|
||
* @request body updateOrderDeliveryRequest *body
|
||
* @response 200 baseResponse success
|
||
*/
|
||
async update() {
|
||
const { ctx } = this;
|
||
const order = await ctx.model.OrderDelivery.findByPk(ctx.params.id);
|
||
|
||
if (!order) {
|
||
ctx.status = 404;
|
||
ctx.body = { code: 404, message: '发货单不存在' };
|
||
return;
|
||
}
|
||
|
||
const body = { ...(ctx.request.body || {}) };
|
||
delete body.principal_id;
|
||
delete body.delivery_order_code;
|
||
// remark 列已删除(见迁移 20260915000900)
|
||
delete body.remark;
|
||
for (const f of MANAGED_FIELDS) delete body[f];
|
||
|
||
// 订单类型:ORDER 组枚举校验(不传则保持原值)
|
||
if (body.order_type !== undefined && body.order_type !== null && String(body.order_type).trim() !== '') {
|
||
const orderType = normalizeDeliveryOrderType(body.order_type);
|
||
if (!orderType) {
|
||
ctx.status = 400;
|
||
ctx.body = { code: 400, message: `order_type(订单类型)不合法,支持:${DELIVERY_ORDER_TYPE_LIST.join(' / ')}` };
|
||
return;
|
||
}
|
||
body.order_type = orderType;
|
||
}
|
||
|
||
// 仅「待处理(1)」可编辑单据头(对齐出入库单的编辑锁定约定)
|
||
if (Number(order.status) !== EDITABLE_STATUS) {
|
||
ctx.status = 400;
|
||
ctx.body = { code: 400, message: '发货单已审核或已结束,不允许编辑' };
|
||
return;
|
||
}
|
||
|
||
// 主体隔离:仓库/店铺必须属于当前主体
|
||
const ownerCheck = await this.assertOwnerBelongsToPrincipal(
|
||
body.warehouse_id === undefined ? order.warehouse_id : body.warehouse_id,
|
||
body.shop_id === undefined ? order.shop_id : body.shop_id
|
||
);
|
||
if (!ownerCheck.ok) {
|
||
ctx.status = 404;
|
||
ctx.body = { code: 404, message: ownerCheck.message };
|
||
return;
|
||
}
|
||
|
||
// 仓库必填:不允许清空(推送 WMS 需要 warehouseCode 与仓库接口配置)
|
||
const mergedWarehouseId = body.warehouse_id === undefined ? order.warehouse_id : body.warehouse_id;
|
||
if (!(Number(mergedWarehouseId) > 0)) {
|
||
ctx.status = 400;
|
||
ctx.body = { code: 400, message: 'warehouse_id(仓库)为必填项:推送仓库需要仓库编码与仓库接口配置' };
|
||
return;
|
||
}
|
||
|
||
// 店铺必填:不允许清空(shopNick 取店铺名称,推送时用于匹配快递策略)
|
||
const mergedShopId = body.shop_id === undefined ? order.shop_id : body.shop_id;
|
||
if (!(Number(mergedShopId) > 0)) {
|
||
ctx.status = 400;
|
||
ctx.body = { code: 400, message: 'shop_id(店铺)为必填项:推送仓库时 shopNick 取所选店铺名称' };
|
||
return;
|
||
}
|
||
|
||
if (body.warehouse_id !== undefined && body.warehouse_id !== null && body.warehouse_id !== '') {
|
||
body.warehouse_id = Number(body.warehouse_id);
|
||
// 仓库变更时同步刷新仓库编码快照
|
||
const warehouse = await ctx.model.Warehouse.findByPk(body.warehouse_id, { attributes: [ 'id', 'code' ] });
|
||
if (warehouse) body.warehouse_code = warehouse.code;
|
||
} else if (body.warehouse_id === '' || body.warehouse_id === null) {
|
||
body.warehouse_id = null;
|
||
body.warehouse_code = null;
|
||
}
|
||
|
||
// 店铺变更时同步刷新店铺名称(shop_nick 只读派生)
|
||
if (body.shop_id !== undefined) {
|
||
const shopId = body.shop_id === null || body.shop_id === '' ? null : Number(body.shop_id);
|
||
body.shop_id = shopId;
|
||
if (shopId) {
|
||
const shop = await ctx.model.Shop.findByPk(shopId, { attributes: [ 'id', 'name' ] });
|
||
body.shop_nick = shop ? shop.name : null;
|
||
} else {
|
||
body.shop_nick = null;
|
||
}
|
||
}
|
||
|
||
// 收件人校验:按「记录现值 + 本次变更」合并后的结果校验(姓名/省/市/区/镇 必填,电话与手机至少一个)
|
||
const merged = { ...order.get({ plain: true }), ...body };
|
||
const receiverError = validateReceiver(merged);
|
||
if (receiverError) {
|
||
ctx.status = 400;
|
||
ctx.body = { code: 400, message: receiverError };
|
||
return;
|
||
}
|
||
|
||
await order.update(body);
|
||
ctx.body = { code: 0, message: 'success', data: { id: order.id } };
|
||
}
|
||
|
||
/**
|
||
* @summary 批量切换发货仓库
|
||
* @description 按「选中单据(ids)」或「筛选条件」把发货单切换到目标仓库(同时刷新 warehouse_code 快照);
|
||
* 范围用 scope_by 显式指定:ids=按勾选(ids 必传),filter=按条件(忽略 ids);
|
||
* 仅「待处理(1)」「已审核(2)」可切换(已推送/已完成已递交 WMS,切换会与仓库侧不一致);
|
||
* 传 dry_run=true 时只返回影响范围(命中/可切换/不可切换数量与原因、样例单据),用于前端弹窗确认
|
||
* @router post /api/order-deliveries/change-warehouse
|
||
* @apikey
|
||
* @request body changeDeliveryWarehouseRequest *body
|
||
* @response 200 orderDeliveryWarehouseChangeResult success
|
||
*/
|
||
async changeWarehouse() {
|
||
const { ctx } = this;
|
||
const Op = this.app.Sequelize.Op;
|
||
const body = ctx.request.body || {};
|
||
const Model = ctx.model.OrderDelivery;
|
||
|
||
// 目标仓库:必填且需属于当前主体
|
||
const targetWarehouseId = body.warehouse_id != null && body.warehouse_id !== '' ? Number(body.warehouse_id) : null;
|
||
if (!targetWarehouseId) {
|
||
ctx.status = 400;
|
||
ctx.body = { code: 400, message: 'warehouse_id(目标仓库)为必填项' };
|
||
return;
|
||
}
|
||
const ownerCheck = await this.assertOwnerBelongsToPrincipal(targetWarehouseId, null);
|
||
if (!ownerCheck.ok) {
|
||
ctx.status = 404;
|
||
ctx.body = { code: 404, message: ownerCheck.message };
|
||
return;
|
||
}
|
||
const target = await ctx.model.Warehouse.findByPk(targetWarehouseId, { attributes: [ 'id', 'code', 'name' ] });
|
||
|
||
// 切换范围:scope_by 显式指定(ids 按勾选 / filter 按条件),传 filter 时忽略 ids
|
||
const built = this._buildScope(ctx, body);
|
||
if (!built.ok) {
|
||
ctx.status = 400;
|
||
ctx.body = { code: 400, message: built.message };
|
||
return;
|
||
}
|
||
const { scopeBy, ids, where: scope, dryRun } = built;
|
||
|
||
// 已是目标仓库的单据无需切换:命中范围里排除掉;
|
||
// 注意未指定仓库(warehouse_id IS NULL)的历史/脏数据要算作可切换,否则这类单据永远补不上仓库
|
||
const notTarget = { [Op.or]: [{ warehouse_id: { [Op.ne]: targetWarehouseId } }, { warehouse_id: null }] };
|
||
const matchedWhere = { [Op.and]: [ scope, notTarget ] };
|
||
const switchableWhere = { [Op.and]: [ matchedWhere, { status: { [Op.in]: SWITCHABLE_WAREHOUSE_STATUS } }] };
|
||
|
||
const matched = await Model.count({ where: matchedWhere });
|
||
const switchable = await Model.count({ where: switchableWhere });
|
||
const blocked = matched - switchable;
|
||
|
||
// 不可切换的原因分布(按状态聚合),供前端提示影响范围
|
||
const blockedRows = blocked > 0
|
||
? await Model.findAll({
|
||
where: { [Op.and]: [ matchedWhere, { status: { [Op.notIn]: SWITCHABLE_WAREHOUSE_STATUS } }] },
|
||
attributes: [ 'status', [ Model.sequelize.fn('COUNT', Model.sequelize.col('id')), 'count' ]],
|
||
group: [ 'status' ],
|
||
raw: true,
|
||
})
|
||
: [];
|
||
const blockedReason = {};
|
||
for (const row of blockedRows) blockedReason[row.status] = Number(row.count);
|
||
|
||
// 目标仓库与原仓库相同的命中行:已在 matchedWhere 中排除,这里额外统计被排除的条数以便提示
|
||
const sameWarehouse = await Model.count({
|
||
where: { [Op.and]: [ scope, { warehouse_id: targetWarehouseId }] },
|
||
});
|
||
|
||
const result = {
|
||
target_warehouse: { id: target.id, code: target.code, name: target.name },
|
||
matched,
|
||
switchable,
|
||
blocked,
|
||
blocked_reason: blockedReason,
|
||
same_warehouse: sameWarehouse,
|
||
scope: { by: scopeBy, ids: scopeBy === 'ids' ? ids : [] },
|
||
};
|
||
|
||
// 预览:返回样例单据 + 各数量,不写库
|
||
if (dryRun) {
|
||
const samples = matched > 0
|
||
? await Model.findAll({
|
||
where: matchedWhere,
|
||
attributes: [ 'id', 'delivery_order_code', 'status', 'warehouse_code' ],
|
||
include: [{ model: ctx.model.Warehouse, as: 'warehouse', attributes: [ 'id', 'name', 'code' ] }],
|
||
order: [[ 'id', 'ASC' ]],
|
||
limit: 5,
|
||
})
|
||
: [];
|
||
ctx.body = {
|
||
code: 0,
|
||
message: 'success',
|
||
data: {
|
||
...result,
|
||
samples: samples.map(s => ({
|
||
id: Number(s.id),
|
||
delivery_order_code: s.delivery_order_code,
|
||
status: Number(s.status),
|
||
warehouse_name: s.warehouse ? s.warehouse.name : (s.warehouse_code || null),
|
||
})),
|
||
},
|
||
};
|
||
return;
|
||
}
|
||
|
||
if (!switchable) {
|
||
ctx.body = { code: 0, message: 'success', data: { ...result, updated: 0 } };
|
||
return;
|
||
}
|
||
|
||
const [ updated ] = await Model.update(
|
||
{ warehouse_id: targetWarehouseId, warehouse_code: target.code },
|
||
{ where: switchableWhere }
|
||
);
|
||
ctx.body = { code: 0, message: 'success', data: { ...result, updated } };
|
||
}
|
||
|
||
/**
|
||
* @summary 批量设置所属店铺
|
||
* @description 按「选中单据(ids)」或「筛选条件」把发货单的店铺设为目标店铺(同时刷新 shop_nick 名称快照);
|
||
* 店铺只影响推送时的快递策略匹配(shopNick)与 OMS 记录、不回写 WMS,因此「已推送(3)」也允许修正;
|
||
* 传 dry_run=true 时只返回影响范围
|
||
* @router post /api/order-deliveries/change-shop
|
||
* @apikey
|
||
* @request body changeDeliveryShopRequest *body
|
||
* @response 200 orderDeliveryShopChangeResult success
|
||
*/
|
||
async changeShop() {
|
||
const { ctx } = this;
|
||
const Op = this.app.Sequelize.Op;
|
||
const body = ctx.request.body || {};
|
||
const Model = ctx.model.OrderDelivery;
|
||
|
||
const targetShopId = body.shop_id != null && body.shop_id !== '' ? Number(body.shop_id) : null;
|
||
if (!targetShopId) {
|
||
ctx.status = 400;
|
||
ctx.body = { code: 400, message: 'shop_id(目标店铺)为必填项' };
|
||
return;
|
||
}
|
||
const ownerCheck = await this.assertOwnerBelongsToPrincipal(null, targetShopId);
|
||
if (!ownerCheck.ok) {
|
||
ctx.status = 404;
|
||
ctx.body = { code: 404, message: ownerCheck.message };
|
||
return;
|
||
}
|
||
const target = await ctx.model.Shop.findByPk(targetShopId, { attributes: [ 'id', 'name' ] });
|
||
|
||
// shop_id 在本接口是「目标店铺」,不能当作筛选条件(否则 scope 里会出现 shop_id = target 导致命中 0 条)
|
||
const scopeBody = { ...body };
|
||
delete scopeBody.shop_id;
|
||
const built = this._buildScope(ctx, scopeBody);
|
||
if (!built.ok) {
|
||
ctx.status = 400;
|
||
ctx.body = { code: 400, message: built.message };
|
||
return;
|
||
}
|
||
const { scopeBy, ids, where: scope, dryRun } = built;
|
||
|
||
// 已是目标店铺(含店铺为空)的都要纳入:空店铺正是需要补的
|
||
const notTarget = { [Op.or]: [{ shop_id: { [Op.ne]: targetShopId } }, { shop_id: null }] };
|
||
const matchedWhere = { [Op.and]: [ scope, notTarget ] };
|
||
const switchableWhere = { [Op.and]: [ matchedWhere, { status: { [Op.in]: SHOP_SWITCHABLE_STATUS } }] };
|
||
|
||
const matched = await Model.count({ where: matchedWhere });
|
||
const switchable = await Model.count({ where: switchableWhere });
|
||
const blocked = matched - switchable;
|
||
const sameShop = await Model.count({ where: { [Op.and]: [ scope, { shop_id: targetShopId }] } });
|
||
|
||
const blockedRows = blocked > 0
|
||
? await Model.findAll({
|
||
where: { [Op.and]: [ matchedWhere, { status: { [Op.notIn]: SHOP_SWITCHABLE_STATUS } }] },
|
||
attributes: [ 'status', [ Model.sequelize.fn('COUNT', Model.sequelize.col('id')), 'count' ]],
|
||
group: [ 'status' ],
|
||
raw: true,
|
||
})
|
||
: [];
|
||
const blockedReason = {};
|
||
for (const row of blockedRows) blockedReason[row.status] = Number(row.count);
|
||
|
||
const result = {
|
||
target_shop: { id: target.id, name: target.name },
|
||
matched,
|
||
switchable,
|
||
blocked,
|
||
blocked_reason: blockedReason,
|
||
same_shop: sameShop,
|
||
scope: { by: scopeBy, ids: scopeBy === 'ids' ? ids : [] },
|
||
};
|
||
|
||
if (dryRun) {
|
||
const samples = matched > 0
|
||
? await Model.findAll({
|
||
where: matchedWhere,
|
||
attributes: [ 'id', 'delivery_order_code', 'status', 'shop_id', 'shop_nick' ],
|
||
order: [[ 'id', 'ASC' ]],
|
||
limit: 5,
|
||
})
|
||
: [];
|
||
ctx.body = {
|
||
code: 0,
|
||
message: 'success',
|
||
data: {
|
||
...result,
|
||
samples: samples.map(s => ({
|
||
id: Number(s.id),
|
||
delivery_order_code: s.delivery_order_code,
|
||
status: Number(s.status),
|
||
shop_nick: s.shop_nick || null,
|
||
})),
|
||
},
|
||
};
|
||
return;
|
||
}
|
||
|
||
if (!switchable) {
|
||
ctx.body = { code: 0, message: 'success', data: { ...result, updated: 0 } };
|
||
return;
|
||
}
|
||
|
||
const [ updated ] = await Model.update(
|
||
{ shop_id: targetShopId, shop_nick: target.name },
|
||
{ where: switchableWhere }
|
||
);
|
||
ctx.body = { code: 0, message: 'success', data: { ...result, updated } };
|
||
}
|
||
|
||
/**
|
||
* 主体隔离辅助:校验仓库/店铺是否属于当前主体(为空则跳过)
|
||
* @param {Number|null} warehouseId 仓库ID
|
||
* @param {Number|null|undefined} shopId 店铺ID
|
||
* @return {Promise<{ok: boolean, message?: string}>} 校验结果
|
||
*/
|
||
async assertOwnerBelongsToPrincipal(warehouseId, shopId) {
|
||
const { ctx } = this;
|
||
const principalId = ctx.state.principalId;
|
||
|
||
if (warehouseId != null && warehouseId !== '') {
|
||
const warehouse = await ctx.model.Warehouse.findOne({
|
||
where: { id: Number(warehouseId), principal_id: principalId },
|
||
attributes: [ 'id' ],
|
||
});
|
||
if (!warehouse) return { ok: false, message: '仓库不存在或不属于当前主体' };
|
||
}
|
||
|
||
if (shopId != null && shopId !== '') {
|
||
const shop = await ctx.model.Shop.findOne({
|
||
where: { id: Number(shopId), principal_id: principalId },
|
||
attributes: [ 'id' ],
|
||
});
|
||
if (!shop) return { ok: false, message: '店铺不存在或不属于当前主体' };
|
||
}
|
||
|
||
return { ok: true };
|
||
}
|
||
|
||
/**
|
||
* @summary 删除发货单
|
||
* @description 仅「待处理(1)」「已取消(9)」可删除;已审核及之后(含已作废 5)禁止删除,避免绕过状态机
|
||
* @router delete /api/order-deliveries/{id}
|
||
* @apikey
|
||
* @request path integer *id 发货单主键ID
|
||
* @response 200 baseResponse success
|
||
*/
|
||
async destroy() {
|
||
const { ctx } = this;
|
||
const order = await ctx.model.OrderDelivery.findByPk(ctx.params.id);
|
||
|
||
if (!order) {
|
||
ctx.status = 404;
|
||
ctx.body = { code: 404, message: '发货单不存在' };
|
||
return;
|
||
}
|
||
|
||
if (![ 1, 9 ].includes(Number(order.status))) {
|
||
ctx.status = 400;
|
||
ctx.body = { code: 400, message: '已审核及之后的单据禁止删除,可改为作废' };
|
||
return;
|
||
}
|
||
|
||
const transaction = await ctx.model.transaction();
|
||
try {
|
||
await ctx.model.OrderDeliveryItem.destroy({ where: { order_delivery_id: order.id }, transaction });
|
||
await order.destroy({ transaction });
|
||
await transaction.commit();
|
||
ctx.body = { code: 0, message: 'success' };
|
||
} catch (err) {
|
||
await transaction.rollback();
|
||
ctx.status = 500;
|
||
ctx.body = { code: 500, message: '删除失败,请稍后重试' };
|
||
}
|
||
}
|
||
|
||
/**
|
||
* @summary 审核发货单
|
||
* @description 状态流转:待处理(1) → 已审核(2);需先录入明细且已选择店铺(手工单必须选店铺);写入审核人与审核时间。
|
||
* **审核即锁定库存**:按明细 plan_qty 锁定(占用可用,可用不足则审核失败 400),锁定与状态流转同事务,
|
||
* 并写一条出入库记录(biz_type=order_lock);推送失败退回/驳回/取消/作废时释放,WMS 发货确认时扣减。
|
||
* **审核只入队不推送**:由定时任务(app/schedule/orderDeliveryPush.js)异步递交 WMS,避免集中审核打满对方服务;
|
||
* 也可用「批量推送」或单条「推送」接口立即推送
|
||
* @router post /api/order-deliveries/{id}/audit
|
||
* @apikey
|
||
* @request path integer *id 发货单主键ID
|
||
* @response 200 baseResponse success
|
||
*/
|
||
async audit() {
|
||
const { ctx } = this;
|
||
const order = await ctx.model.OrderDelivery.findByPk(ctx.params.id);
|
||
if (!order) {
|
||
ctx.status = 404;
|
||
ctx.body = { code: 404, message: '发货单不存在' };
|
||
return;
|
||
}
|
||
if (Number(order.status) !== 1) {
|
||
ctx.status = 400;
|
||
ctx.body = { code: 400, message: '只有「待处理」状态的单据可以审核' };
|
||
return;
|
||
}
|
||
|
||
const itemCount = await ctx.model.OrderDeliveryItem.count({ where: { order_delivery_id: order.id } });
|
||
if (!itemCount) {
|
||
ctx.status = 400;
|
||
ctx.body = { code: 400, message: '单据无明细,无法审核' };
|
||
return;
|
||
}
|
||
// 手工单必须选店铺:shopNick 取店铺名称,推送时 WMS 靠它匹配快递策略
|
||
if (!(Number(order.shop_id) > 0)) {
|
||
ctx.status = 400;
|
||
ctx.body = { code: 400, message: '单据未设置店铺,无法审核:请先选择店铺(可用「批量操作 → 设置所属店铺」)' };
|
||
return;
|
||
}
|
||
|
||
// 审核即锁定库存(按明细 plan_qty 占用可用,可用不足则审核失败),并写 order_lock 流水;
|
||
// 库存锁定与状态流转同事务,避免『已审核但未锁定』的不一致
|
||
// 操作人 = 审核人:取审核人在本主体下的账号名称(principal_users.name),推送为 operatorName
|
||
const operatorName = await resolveAccountName(ctx, ctx.userId, order.principal_id);
|
||
const transaction = await ctx.model.transaction();
|
||
let lockResult;
|
||
try {
|
||
lockResult = await lockDeliveryStock(ctx, order, { createdBy: ctx.userId, transaction });
|
||
// 清空上一轮推送记录(重试次数从 0 开始),状态置「已审核(2)」等待定时任务推送
|
||
await order.update({
|
||
status: 2,
|
||
audit_by: ctx.userId,
|
||
audit_time: new Date(),
|
||
operator_name: operatorName,
|
||
pushed_at: null,
|
||
wms_push_result: null,
|
||
}, { transaction });
|
||
await transaction.commit();
|
||
} catch (err) {
|
||
await transaction.rollback();
|
||
if (err.code === 'INSUFFICIENT_STOCK') {
|
||
const product = await ctx.model.Product.findByPk(err.productId, { attributes: [ 'item_code', 'item_name' ] });
|
||
const label = product ? `${product.item_name}(${product.item_code})` : `商品#${err.productId}`;
|
||
ctx.status = 400;
|
||
ctx.body = { code: 400, message: `库存不足,无法审核:${label} 可用 ${err.available},需 ${err.require}` };
|
||
return;
|
||
}
|
||
ctx.logger.error(`[order-delivery] 审核锁定库存失败 id=${order.id}`, err);
|
||
ctx.status = 500;
|
||
ctx.body = { code: 500, message: `审核失败:${err.message}` };
|
||
return;
|
||
}
|
||
|
||
ctx.body = {
|
||
code: 0,
|
||
message: '审核成功,已进入推送队列,稍后自动推送仓库',
|
||
data: {
|
||
id: order.id,
|
||
status: 2,
|
||
stock_locked: lockResult.affected,
|
||
stock_skipped_lines: lockResult.skippedLines,
|
||
},
|
||
};
|
||
}
|
||
|
||
/**
|
||
* @summary 批量审核发货单
|
||
* @description 按「选中单据(ids)」或「筛选条件」批量审核(1→2,只入队不推送);每单在独立事务内
|
||
* 先锁定库存再置状态(库存不足等失败仅跳过该单,不影响其他单据,失败明细见 data.failures);
|
||
* 传 dry_run=true 只返回影响范围(命中/可审核/跳过数量与样例)
|
||
* @router post /api/order-deliveries/audit-batch
|
||
* @apikey
|
||
* @request body orderDeliveryBatchRequest *body
|
||
* @response 200 orderDeliveryBatchResult success
|
||
*/
|
||
async auditBatch() {
|
||
const { ctx } = this;
|
||
const Op = this.app.Sequelize.Op;
|
||
const built = this._buildScope(ctx, ctx.request.body || {});
|
||
if (!built.ok) {
|
||
ctx.status = 400;
|
||
ctx.body = { code: 400, message: built.message };
|
||
return;
|
||
}
|
||
|
||
const matchedWhere = built.where;
|
||
// 可审核 = 待处理(1) 且已设置店铺(手工单必须选店铺,推送时 shopNick 取店铺名称)
|
||
const auditableWhere = { [Op.and]: [ matchedWhere, { status: 1 }, { shop_id: { [Op.ne]: null } }] };
|
||
|
||
const matched = await ctx.model.OrderDelivery.count({ where: matchedWhere });
|
||
const auditable = await ctx.model.OrderDelivery.count({ where: auditableWhere });
|
||
|
||
const result = {
|
||
matched,
|
||
affected: 0,
|
||
auditable,
|
||
skipped: matched - auditable,
|
||
scope: { by: built.scopeBy, ids: built.scopeBy === 'ids' ? built.ids : [] },
|
||
};
|
||
|
||
if (built.dryRun) {
|
||
const samples = matched > 0
|
||
? await ctx.model.OrderDelivery.findAll({
|
||
where: matchedWhere,
|
||
attributes: [ 'id', 'delivery_order_code', 'status' ],
|
||
order: [[ 'id', 'ASC' ]],
|
||
limit: 10,
|
||
})
|
||
: [];
|
||
result.samples = samples.map(s => ({
|
||
id: Number(s.id),
|
||
delivery_order_code: s.delivery_order_code,
|
||
status: Number(s.status),
|
||
}));
|
||
ctx.body = { code: 0, message: 'success', data: result };
|
||
return;
|
||
}
|
||
|
||
if (!auditable) {
|
||
ctx.body = { code: 0, message: 'success', data: result };
|
||
return;
|
||
}
|
||
|
||
// 逐单审核:每单在独立事务内「锁定库存 + 状态置 2」,单号级别失败(如库存不足)不影响其他单据
|
||
const rows = await ctx.model.OrderDelivery.findAll({
|
||
where: auditableWhere,
|
||
attributes: [ 'id', 'delivery_order_code', 'principal_id', 'warehouse_id', 'stock_locked' ],
|
||
order: [[ 'id', 'ASC' ]],
|
||
});
|
||
const failures = [];
|
||
let affected = 0;
|
||
for (const order of rows) {
|
||
const transaction = await ctx.model.transaction();
|
||
try {
|
||
await lockDeliveryStock(ctx, order, { createdBy: ctx.userId, transaction });
|
||
await order.update({
|
||
status: 2,
|
||
audit_by: ctx.userId,
|
||
audit_time: new Date(),
|
||
pushed_at: null,
|
||
wms_push_result: null,
|
||
}, { transaction });
|
||
await transaction.commit();
|
||
affected += 1;
|
||
} catch (err) {
|
||
await transaction.rollback();
|
||
failures.push({
|
||
id: Number(order.id),
|
||
delivery_order_code: order.delivery_order_code,
|
||
message: err.message,
|
||
});
|
||
ctx.logger.warn(`[order-delivery] 批量审核跳过 ${order.delivery_order_code}:${err.message}`);
|
||
}
|
||
}
|
||
|
||
result.affected = affected;
|
||
result.failed = failures.length;
|
||
if (failures.length) result.failures = failures.slice(0, 10);
|
||
ctx.body = { code: 0, message: 'success', data: result };
|
||
}
|
||
|
||
/**
|
||
* @summary 推送发货单到仓库(WMS)
|
||
* @description 已审核(2) → 已推送(3):立即按 deliveryorder.create(ORDER 组)递交 WMS 一次;
|
||
* 对方明确响应失败会退回「待审核(1)」;无响应/超时保留「已审核(2)」等定时任务重试(最多 3 次)
|
||
* @router post /api/order-deliveries/{id}/push
|
||
* @apikey
|
||
* @request path integer *id 发货单主键ID
|
||
* @response 200 baseResponse success
|
||
*/
|
||
async push() {
|
||
const { ctx } = this;
|
||
const order = await ctx.model.OrderDelivery.findByPk(ctx.params.id, { attributes: [ 'id', 'status' ] });
|
||
if (!order) {
|
||
ctx.status = 404;
|
||
ctx.body = { code: 404, message: '发货单不存在' };
|
||
return;
|
||
}
|
||
if (Number(order.status) !== 2) {
|
||
ctx.status = 400;
|
||
ctx.body = { code: 400, message: '只有「已审核」状态的单据可以推送' };
|
||
return;
|
||
}
|
||
|
||
const pushResult = await ctx.service.orderDeliveryPush.pushOne(order.id, { source: 'manual' });
|
||
if (!pushResult.ok) {
|
||
ctx.status = pushResult.skipped ? 400 : 502;
|
||
ctx.body = { code: ctx.status, message: pushResult.message };
|
||
return;
|
||
}
|
||
ctx.body = {
|
||
code: 0,
|
||
message: 'success',
|
||
data: { id: order.id, status: 3, attempts: pushResult.attempts, wms_response: pushResult.response },
|
||
};
|
||
}
|
||
|
||
/**
|
||
* @summary 批量推送发货单到仓库
|
||
* @description 按「选中单据(ids)」或「筛选条件」批量推送「已审核(2)」的单据;
|
||
* 顺序限流执行(每次最多 50 条,其余由定时任务继续推送);传 dry_run=true 只返回影响范围
|
||
* @router post /api/order-deliveries/push-batch
|
||
* @apikey
|
||
* @request body orderDeliveryBatchRequest *body
|
||
* @response 200 orderDeliveryBatchResult success
|
||
*/
|
||
async pushBatch() {
|
||
const { ctx } = this;
|
||
const Op = this.app.Sequelize.Op;
|
||
const body = ctx.request.body || {};
|
||
const built = this._buildScope(ctx, body);
|
||
if (!built.ok) {
|
||
ctx.status = 400;
|
||
ctx.body = { code: 400, message: built.message };
|
||
return;
|
||
}
|
||
|
||
const pushableWhere = { [Op.and]: [ built.where, { status: 2 }] };
|
||
const matched = await ctx.model.OrderDelivery.count({ where: built.where });
|
||
const pushable = await ctx.model.OrderDelivery.count({ where: pushableWhere });
|
||
|
||
const result = {
|
||
matched,
|
||
affected: 0,
|
||
pushable,
|
||
skipped: matched - pushable,
|
||
scope: { by: built.scopeBy, ids: built.scopeBy === 'ids' ? built.ids : [] },
|
||
};
|
||
|
||
if (built.dryRun) {
|
||
const samples = matched > 0
|
||
? await ctx.model.OrderDelivery.findAll({
|
||
where: built.where,
|
||
attributes: [ 'id', 'delivery_order_code', 'status' ],
|
||
order: [[ 'id', 'ASC' ]],
|
||
limit: 10,
|
||
})
|
||
: [];
|
||
result.samples = samples.map(s => ({
|
||
id: Number(s.id),
|
||
delivery_order_code: s.delivery_order_code,
|
||
status: Number(s.status),
|
||
}));
|
||
ctx.body = { code: 0, message: 'success', data: result };
|
||
return;
|
||
}
|
||
|
||
if (!pushable) {
|
||
ctx.body = { code: 0, message: 'success', data: result };
|
||
return;
|
||
}
|
||
|
||
const rows = await ctx.model.OrderDelivery.findAll({
|
||
where: pushableWhere,
|
||
attributes: [ 'id' ],
|
||
order: [[ 'id', 'ASC' ]],
|
||
});
|
||
const stat = await ctx.service.orderDeliveryPush.pushMany(rows.map(r => Number(r.id)));
|
||
ctx.body = {
|
||
code: 0,
|
||
message: 'success',
|
||
data: {
|
||
...result,
|
||
affected: stat.processed,
|
||
pending_rest: stat.pendingRest,
|
||
pushed: stat.pushed,
|
||
failed: stat.failed,
|
||
retry: stat.retry,
|
||
skipped_push: stat.skipped,
|
||
details: stat.details,
|
||
},
|
||
};
|
||
}
|
||
|
||
/**
|
||
* @summary 驳回发货单
|
||
* @description 审核的反向操作:已审核(2) → 待处理(1);
|
||
* 驳回会变更单号(基础单号后追加/递增 `_N`,首次 `_1`、再次 `_2`,与出入库单一致),
|
||
* 保证「一次推送对应一个全新的外部单号」(WMS 侧 deliveryOrderCode 为唯一键,沿用旧号重推会报单据已存在);
|
||
* 驳回同时释放审核时锁定的库存(写 order_unlock 流水);释放失败则不流转状态;
|
||
* 推送失败过且外部可能已建单的,会先冲正取消(未建成时该调用失败,忽略即可)
|
||
* @router post /api/order-deliveries/{id}/reject
|
||
* @apikey
|
||
* @request path integer *id 发货单主键ID
|
||
* @response 200 baseResponse success
|
||
*/
|
||
async reject() {
|
||
const { ctx } = this;
|
||
const order = await ctx.model.OrderDelivery.findByPk(ctx.params.id);
|
||
if (!order) {
|
||
ctx.status = 404;
|
||
ctx.body = { code: 404, message: '发货单不存在' };
|
||
return;
|
||
}
|
||
if (Number(order.status) !== 2) {
|
||
ctx.status = 400;
|
||
ctx.body = { code: 400, message: '只有「已审核」状态的单据可以驳回' };
|
||
return;
|
||
}
|
||
|
||
// 已提交过 WMS 但推送失败的单据:驳回前冲正外部单据,避免 WMS 残留(未推送成功时该调用返回失败,忽略即可)
|
||
const pushedResult = order.wms_push_result;
|
||
if (pushedResult && pushedResult.success === false) {
|
||
const pushService = ctx.service.orderDeliveryPush;
|
||
const api = await pushService.findWarehouseApi(order);
|
||
if (api) {
|
||
const client = new QimenWmsClient(api, this.app);
|
||
await pushService.cancelRemote(client, order);
|
||
}
|
||
}
|
||
|
||
// 驳回前释放审核时锁定的库存(并记 order_unlock 流水);释放失败则不流转状态,避免锁定泄漏
|
||
try {
|
||
await releaseDeliveryStock(ctx, order, { createdBy: ctx.userId, remark: '订单驳回释放锁定库存' });
|
||
} catch (err) {
|
||
ctx.logger.error(`[order-delivery] 驳回释放库存失败 id=${order.id}`, err);
|
||
ctx.status = 500;
|
||
ctx.body = { code: 500, message: `驳回失败(释放锁定库存异常):${err.message}` };
|
||
return;
|
||
}
|
||
|
||
// 驳回换号:FH_1 → FH_1_1 → FH_1_2,避免重新审核后用旧单号推送被 WMS 判重
|
||
const newCode = nextRejectedBillNo(order.delivery_order_code, order.id, DELIVERY_BILL_PREFIX);
|
||
await order.update({
|
||
status: 1,
|
||
delivery_order_code: newCode,
|
||
audit_by: null,
|
||
audit_time: null,
|
||
pushed_at: null,
|
||
wms_push_result: null,
|
||
});
|
||
ctx.body = { code: 0, message: 'success', data: { id: order.id, delivery_order_code: order.delivery_order_code } };
|
||
}
|
||
|
||
/**
|
||
* @summary 取消发货单
|
||
* @description 状态流转:待处理(1)/已审核(2)/已推送(3) → 已取消(9);
|
||
* 已完成(4)与已作废(5)不可取消;已推送(3)的单据会先调用 WMS order.cancel(ORDER 组)取消外部发货单,
|
||
* 取消失败(如仓库已开始配货)时不流转状态并返回失败原因;**取消成功后释放审核时锁定的库存**
|
||
* (写 order_unlock 流水,释放与状态流转同事务)。
|
||
* 注:WMS 主动取消(回调 deliveryorder.cancel)不在 OMS 处理范围内(未注册该回调),只处理 OMS 侧取消成功后的释放
|
||
* @router post /api/order-deliveries/{id}/cancel
|
||
* @apikey
|
||
* @request path integer *id 发货单主键ID
|
||
* @response 200 baseResponse success
|
||
*/
|
||
async cancel() {
|
||
const { ctx } = this;
|
||
const order = await this._findOrderWithWarehouse(ctx, ctx.params.id);
|
||
if (!order) {
|
||
ctx.status = 404;
|
||
ctx.body = { code: 404, message: '发货单不存在' };
|
||
return;
|
||
}
|
||
if (![ 1, 2, 3 ].includes(Number(order.status))) {
|
||
ctx.status = 400;
|
||
ctx.body = { code: 400, message: '已完成或已作废的单据不能取消' };
|
||
return;
|
||
}
|
||
|
||
// 已推送:先同步取消 WMS 侧发货单(释放库存锁定、置 CANCELLED)
|
||
if (Number(order.status) === 3) {
|
||
const api = await ctx.service.orderDeliveryPush.findWarehouseApi(order);
|
||
if (!api) {
|
||
ctx.status = 400;
|
||
ctx.body = { code: 400, message: '该仓库未配置启用的类奇门接口,无法取消已推送的外部发货单' };
|
||
return;
|
||
}
|
||
const client = new QimenWmsClient(api, this.app);
|
||
let resp = null;
|
||
try {
|
||
resp = await client.cancelDeliveryOrder(order);
|
||
} catch (err) {
|
||
ctx.status = 502;
|
||
ctx.body = { code: 502, message: `取消仓库发货单失败:${err.message}` };
|
||
return;
|
||
}
|
||
if (!client.isSuccess(resp)) {
|
||
ctx.status = 502;
|
||
ctx.body = { code: 502, message: `取消仓库发货单失败:${resp && (resp.message || resp.code)}` };
|
||
return;
|
||
}
|
||
const pushedResult = order.wms_push_result && typeof order.wms_push_result === 'object'
|
||
? order.wms_push_result
|
||
: {};
|
||
// 外部取消成功后才释放本地锁定:释放与状态流转同事务,避免「外部已取消、本地仍锁定」
|
||
const transaction = await ctx.model.transaction();
|
||
try {
|
||
await releaseDeliveryStock(ctx, order, { createdBy: ctx.userId, remark: '订单取消释放锁定库存', transaction });
|
||
await order.update({
|
||
status: 9,
|
||
wms_push_result: { ...pushedResult, cancelResult: resp, cancelledAt: new Date().toISOString() },
|
||
}, { transaction });
|
||
await transaction.commit();
|
||
} catch (err) {
|
||
await transaction.rollback();
|
||
ctx.logger.error(`[order-delivery] 取消释放库存失败 id=${order.id}`, err);
|
||
ctx.status = 500;
|
||
ctx.body = { code: 500, message: `取消失败(释放锁定库存异常):${err.message}` };
|
||
return;
|
||
}
|
||
ctx.body = { code: 0, message: 'success', data: { id: order.id, wms_response: resp } };
|
||
return;
|
||
}
|
||
|
||
// 未推送(1/2):OMS 侧取消即释放锁定(无外部单据)
|
||
const transaction = await ctx.model.transaction();
|
||
try {
|
||
await releaseDeliveryStock(ctx, order, { createdBy: ctx.userId, remark: '订单取消释放锁定库存', transaction });
|
||
await order.update({ status: 9 }, { transaction });
|
||
await transaction.commit();
|
||
} catch (err) {
|
||
await transaction.rollback();
|
||
ctx.logger.error(`[order-delivery] 取消释放库存失败 id=${order.id}`, err);
|
||
ctx.status = 500;
|
||
ctx.body = { code: 500, message: `取消失败(释放锁定库存异常):${err.message}` };
|
||
return;
|
||
}
|
||
ctx.body = { code: 0, message: 'success', data: { id: order.id } };
|
||
}
|
||
|
||
/**
|
||
* @summary 恢复发货单
|
||
* @description 状态流转:已取消(9) → 待处理(1);
|
||
* **曾推送过的单据恢复时换号**(基础单号后追加/递增 `_N`,如 FH_3 → FH_3_1 → FH_3_2),
|
||
* 原因:WMS 侧 deliveryOrderCode 为唯一键,且外部单据取消后原单号仍被占用,
|
||
* 沿用旧号重推会被判「订单已存在」(WMS 按成功返回,OMS 却可能指向已取消的外部单);
|
||
* 同时清空 audit_by/audit_time/pushed_at/wms_push_result(重回待处理,重试计数归零)。
|
||
* 从未推送过的单据(取消时还没推过)保持原单号,避免无意义换号
|
||
* @router post /api/order-deliveries/{id}/restore
|
||
* @apikey
|
||
* @request path integer *id 发货单主键ID
|
||
* @response 200 baseResponse success
|
||
*/
|
||
async restore() {
|
||
const { ctx } = this;
|
||
const order = await ctx.model.OrderDelivery.findByPk(ctx.params.id);
|
||
if (!order) {
|
||
ctx.status = 404;
|
||
ctx.body = { code: 404, message: '发货单不存在' };
|
||
return;
|
||
}
|
||
if (Number(order.status) !== 9) {
|
||
ctx.status = 400;
|
||
ctx.body = { code: 400, message: '只有「已取消」的单据可以恢复' };
|
||
return;
|
||
}
|
||
|
||
// 是否推送过:pushed_at 在每次真实推送尝试前写入(乐观锁),推送结果也存 wms_push_result
|
||
const pushedBefore = order.pushed_at != null || order.wms_push_result != null;
|
||
if (!pushedBefore) {
|
||
await order.update({ status: 1 });
|
||
ctx.body = { code: 0, message: 'success', data: { id: order.id, bill_no_changed: false } };
|
||
return;
|
||
}
|
||
|
||
// 推送过:换号(保证「一次推送对应一个全新的外部单号」)并清空审核/推送痕迹
|
||
const newCode = nextRejectedBillNo(order.delivery_order_code, order.id, DELIVERY_BILL_PREFIX);
|
||
await order.update({
|
||
status: 1,
|
||
delivery_order_code: newCode,
|
||
audit_by: null,
|
||
audit_time: null,
|
||
pushed_at: null,
|
||
wms_push_result: null,
|
||
});
|
||
ctx.body = {
|
||
code: 0,
|
||
message: 'success',
|
||
data: { id: order.id, delivery_order_code: order.delivery_order_code, bill_no_changed: true },
|
||
};
|
||
}
|
||
|
||
/**
|
||
* @summary 作废发货单
|
||
* @description 仅「已审核(2)」可作废;状态置为已作废(5),记录作废人/时间/原因,不可恢复也禁止删除;
|
||
* 作废时释放审核锁定的库存(写 order_unlock 流水)
|
||
* @router post /api/order-deliveries/{id}/void
|
||
* @apikey
|
||
* @request path integer *id 发货单主键ID
|
||
* @request body voidOrderDeliveryRequest *body
|
||
* @response 200 baseResponse success
|
||
*/
|
||
async voidOrder() {
|
||
const { ctx } = this;
|
||
const order = await ctx.model.OrderDelivery.findByPk(ctx.params.id);
|
||
if (!order) {
|
||
ctx.status = 404;
|
||
ctx.body = { code: 404, message: '发货单不存在' };
|
||
return;
|
||
}
|
||
if (Number(order.status) !== 2) {
|
||
ctx.status = 400;
|
||
ctx.body = { code: 400, message: '只有「已审核」状态的单据可以作废' };
|
||
return;
|
||
}
|
||
|
||
const body = ctx.request.body || {};
|
||
const reason = body.void_reason ? String(body.void_reason).trim() : '';
|
||
// 作废前释放审核时锁定的库存(并记 order_unlock 流水);释放失败则不流转状态
|
||
try {
|
||
await releaseDeliveryStock(ctx, order, { createdBy: ctx.userId, remark: '订单作废释放锁定库存' });
|
||
} catch (err) {
|
||
ctx.logger.error(`[order-delivery] 作废释放库存失败 id=${order.id}`, err);
|
||
ctx.status = 500;
|
||
ctx.body = { code: 500, message: `作废失败(释放锁定库存异常):${err.message}` };
|
||
return;
|
||
}
|
||
await order.update({
|
||
status: 5,
|
||
void_at: new Date(),
|
||
void_by: ctx.userId,
|
||
void_reason: reason || null,
|
||
});
|
||
ctx.body = { code: 0, message: 'success', data: { id: order.id } };
|
||
}
|
||
|
||
/**
|
||
* 查发货单(含仓库,推送需要 warehouses.code 作为 warehouseCode)
|
||
* @param {Object} ctx
|
||
* @param {number|string} id 发货单主键ID
|
||
* @return {Promise<Object|null>} 发货单实例
|
||
*/
|
||
async _findOrderWithWarehouse(ctx, id) {
|
||
return ctx.model.OrderDelivery.findByPk(id, {
|
||
include: [{ model: ctx.model.Warehouse, as: 'warehouse', attributes: [ 'id', 'code', 'name' ] }],
|
||
});
|
||
}
|
||
|
||
/**
|
||
* 解析批量操作范围(勾选 ids / 筛选条件),供批量审核、批量推送、切换仓库复用
|
||
* - scope_by 显式指定范围:ids=按勾选(ids 必传)/ filter=按条件(忽略 ids)
|
||
* - 未传 scope_by 时兜底为「有 ids 走 ids,否则走条件」
|
||
* @param {Object} ctx egg context
|
||
* @param {Object} body 请求体
|
||
* @return {{ok: boolean, message?: string, scopeBy?: string, ids?: number[], where?: Object, dryRun?: boolean}} 解析结果
|
||
*/
|
||
_buildScope(ctx, body) {
|
||
const Op = this.app.Sequelize.Op;
|
||
const principalId = ctx.state.principalId;
|
||
const ids = Array.isArray(body.ids)
|
||
? [ ...new Set(body.ids.map(v => Number(v)).filter(v => Number.isFinite(v) && v > 0)) ]
|
||
: [];
|
||
const scopeBy = body.scope_by === 'ids' || body.scope_by === 'filter'
|
||
? body.scope_by
|
||
: (ids.length ? 'ids' : 'filter');
|
||
|
||
const where = { principal_id: principalId };
|
||
if (scopeBy === 'ids') {
|
||
if (!ids.length) return { ok: false, message: '按选中操作时请至少勾选一条单据(ids 不能为空)' };
|
||
where.id = { [Op.in]: ids };
|
||
} else {
|
||
const code = body.delivery_order_code ? String(body.delivery_order_code).trim() : '';
|
||
const status = body.status === undefined || body.status === null || body.status === '' ? null : Number(body.status);
|
||
const orderType = body.order_type ? String(body.order_type).trim().toUpperCase() : '';
|
||
// 店铺筛选:from_shop_id 为通用写法(shop_id 仅作兼容,设置店铺接口里 shop_id 是「目标店铺」不能当条件)
|
||
const fromShopId = body.from_shop_id ? Number(body.from_shop_id) : (body.shop_id ? Number(body.shop_id) : null);
|
||
const fromWarehouseId = body.from_warehouse_id ? Number(body.from_warehouse_id) : null;
|
||
// 回传平台店铺状态筛选(与列表 index 同口径,保证「当前筛选条件」不被忽略)
|
||
const shopSyncStatus = body.shop_sync_status === undefined || body.shop_sync_status === null || body.shop_sync_status === ''
|
||
? null
|
||
: Number(body.shop_sync_status);
|
||
if (!code && status === null && !orderType && !fromShopId && !fromWarehouseId && shopSyncStatus === null) {
|
||
return { ok: false, message: '请指定操作范围:勾选单据(ids)或至少传一个筛选条件' };
|
||
}
|
||
if (code) where.delivery_order_code = { [Op.like]: `%${code}%` };
|
||
if (status !== null) where.status = status;
|
||
if (orderType) where.order_type = orderType;
|
||
if (fromShopId) where.shop_id = fromShopId;
|
||
if (fromWarehouseId) where.warehouse_id = fromWarehouseId;
|
||
if (shopSyncStatus !== null) where.shop_sync_status = shopSyncStatus;
|
||
}
|
||
|
||
const dryRun = body.dry_run === true || body.dry_run === 'true' || body.dry_run === 1;
|
||
return { ok: true, scopeBy, ids, where, dryRun };
|
||
}
|
||
|
||
}
|
||
|
||
module.exports = OrderDeliveryController;
|