oms/backend/database/migrations/20260915001900-seed-missing-wms-express-codes.js
liufumingren 39c19a4de7 feat(backend): 出入库记录与库存锁定链路、出库单快递/收件人与推送队列
- 出入库记录(库存流水):新增 stock_records 表/模型/只读接口(列表 + 业务动作选项)与「出入库记录」菜单;
  库存变动统一收敛到 app/utils/stockRecord.js#applyStockChange,与流水写入同事务(含变动前后总/锁定/可用数量)
- 发货单:审核(1→2) 按明细锁定库存、发货确认(3→4) 扣减、推送失败退回/驳回/取消/作废释放(新增 stock_locked 列);
  恢复(9→1) 时曾推送过的单据换号(WMS 取消后原单号仍被占用,沿用旧号重推会被判「订单已存在」)
- 出库单:新增快递(express_code/express_name)、收件人(receiver_*) 与多运单号(express_codes) 字段;
  推送报文补齐 logisticsCode/receiverInfo;新增出库单推送服务与定时任务
- 快递:多运单号回填、仓库快递映射(warehouse_express_mappings) 与快递字典补录等迁移
- 契约:补充出入库记录、出库单快递/收件人等定义(swagger.json 为本地生成、不入库)
2026-09-14 00:59:23 +08:00

59 lines
2.4 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

'use strict';
/**
* 补齐 WMS 侧存在、OMS 字典缺失的快递公司编码(对齐 `wms_express`)
*
* 背景:2026-09-14 加「回传快递编码必须在字典里」的校验后,若字典缺编码会导致
* WMS 正常回传的确认回调被拒绝。实测 WMS 库 `wms_express` 有 21 条,OMS `express_companies`
* 只有 12 条且与之不一致(例如 WMS 回传过的 `ZT` 自提 / `OTHER` 其他 在 OMS 里都没有),
* 故先把 WMS 有而 OMS 没有的编码补进来(名称取 WMS 的 `wms_express.name`)。
*
* 口径:
* - 只 **新增**(INSERT IGNORE,依赖唯一索引 uk_express_companies_code),**不改动**已有行:
* 已在 OMS 的编码(含 `HTKY`=百世快递、`YD`=韵达速递 等与 WMS 语义不符的)留待人工决定是否改名/停用
* - 幂等:已存在的编码不会被覆盖,可重复执行
* - 补的是 WMS 现行 21 条里 OMS 缺失的 14 条;如后续 WMS 字典新增,需同步维护
* (长期方案是加开放接口 + 定时同步,见会话记录)
*/
const MISSING_FROM_WMS = [
{ code: 'ANKY', name: '安能', sort: 130 },
{ code: 'DBWL', name: '德邦物流', sort: 140 },
{ code: 'FENGWANG', name: '丰网速运', sort: 150 },
{ code: 'HTKD', name: '百世极兔', sort: 160 },
{ code: 'KYE', name: '跨越物流', sort: 170 },
{ code: 'SFKY', name: '顺丰快运', sort: 180 },
{ code: 'SZKKE', name: '京广快运', sort: 190 },
{ code: 'TTKDEX', name: '天天快递', sort: 200 },
{ code: 'YUNDA', name: '韵达快递', sort: 210 },
{ code: 'ZTKY', name: '中通快运', sort: 220 },
{ code: 'POSTB', name: '邮政小包', sort: 230 },
{ code: 'POST_DSBK', name: '邮政电商标快', sort: 240 },
{ code: 'ZT', name: '自提', sort: 250 },
{ code: 'OTHER', name: '其他', sort: 260 },
];
module.exports = {
async up(queryInterface) {
const now = new Date();
await queryInterface.bulkInsert(
'express_companies',
MISSING_FROM_WMS.map(c => ({
code: c.code,
name: c.name,
sort: c.sort,
status: 1,
remark: '对齐 WMS wms_express 快递字典(2026-09-14)',
created_at: now,
updated_at: now,
})),
{ ignoreDuplicates: true }
);
},
async down(queryInterface, Sequelize) {
await queryInterface.bulkDelete('express_companies', {
code: { [Sequelize.Op.in]: MISSING_FROM_WMS.map(c => c.code) },
});
},
};