需求背景

FT 客户(傲基打单系统迁移)长期使用子母单与多SKU合单模式;傲基打单系统面单管理支持“多个不同SKU + 多件”的建单与打印。
现状:西邮系统面单管理仅支持“同一SKU,多件”的下单,无法覆盖 FT 客户主流出货场景。
目标:对齐傲基打单系统能力,在西邮“面单管理”统一实现“子母单推单(多SKU&多件)”。

需求内容

对下游渠道下单调整
支持子母件渠道的下单参数调整

开发设计

  1. 新增代卖包裹表:delivery_order_package,代卖附件表添加字段:package_id
    CREATE TABLE `:delivery_order_package` (
    `package_id` int NOT NULL AUTO_INCREMENT COMMENT '包裹id',
    `delivery_order_id` int NOT NULL COMMENT '发货订单ID',
    `delivery_order_code` varchar(50) NOT NULL COMMENT '发货订单号',
    `reference_no` varchar(50) NOT NULL COMMENT '包裹参考号',
    `package_quantity` int NOT NULL DEFAULT '1' COMMENT '包裹数量',
    `weight` decimal(10,3) NOT NULL DEFAULT '0.000' COMMENT '计费重量(KG)',
    `length` decimal(10,2) NOT NULL DEFAULT '0.00' COMMENT '长(CM)',
    `width` decimal(10,2) NOT NULL DEFAULT '0.00' COMMENT '宽(CM)',
    `height` decimal(10,2) NOT NULL DEFAULT '0.00' COMMENT '高(CM)',
    `add_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
    `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '修改时间',
    `product_declared_name` varchar(600) DEFAULT '' COMMENT '申报品名',
    `declared_value` decimal(10,3) DEFAULT NULL COMMENT '申报价值(货物价值)',
    PRIMARY KEY (`package_id`) USING BTREE,
    UNIQUE KEY `uniq_delivery_order_id_reference_no` (`delivery_order_id`,`reference_no`) USING BTREE,
    KEY `idx_delivery_order_id` (`delivery_order_id`) USING BTREE
    ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb3 COMMENT='发货订单包裹表';
  2. 预报代卖面单-包裹封装时,改用读取代卖包裹表数据,具体位置:getDeliveryOrderLable.formatOrders
  3. 需注意同时改动新旧版逻辑
  4. 获取标签成功后,保存标签需要记录packageId,方才知道标签与跟踪号对应关系

上线注意事项

  1. 代卖包裹表需初始化历史数据
  2. 订单入口 、预报同时上线,计费晚点上线
作者:黄天文  创建时间:2026-01-27 08:25
最后编辑:黄天文  更新时间:2026-03-03 10:08