在传统库存管理模式中企业常常面临资金占用大、库存周转慢、市场响应迟滞的痛点。尤其在处理经销商、代理商或特定客户的货物时货物所有权与存放地点的分离使得账务处理复杂对账困难极易产生纠纷。寄售Consignment作为一种创新的供应链管理模式正是解决这些问题的关键。本文将深入探讨如何在一体化ERP系统中设计并实现寄售管理模块从核心概念、业务流程、数据库设计到代码实现提供一套完整、可落地的实战方案。无论你是正在选型的项目经理、负责开发的软件工程师还是希望优化业务流程的业务顾问都能从中获得清晰的指引和可直接复用的代码示例。1. 寄售管理的核心概念与业务价值1.1 什么是寄售Consignment寄售是一种特殊的商品销售方式。在这种模式下供应商寄售方将商品发送给客户承销方但商品的所有权在客户实际售出或消耗之前仍归属于供应商。客户只有在销售了商品后才需要向供应商支付货款。对于未售出的商品客户有权将其退还给供应商。这与传统的“先买后卖”模式有本质区别传统购销客户先购买货物获得所有权再销售。资金和库存风险由客户承担。寄售模式客户先获得货物实物销售后才结算。供应商承担库存资金压力客户则降低了资金占用和滞销风险。1.2 为什么企业需要ERP寄售管理在未系统化管理的寄售业务中企业常遇到以下挑战账实不符实物在客户仓库但公司系统内无库存或库存地点混乱。对账困难依赖手工表格记录发货、销售和结算效率低下且易出错。库存可视性差无法实时掌握分布在各个客户处的寄售库存数量、库龄和状态。结算延迟销售数据反馈慢导致供应商开票和回款周期长。价格管理复杂寄售商品可能采用特殊定价策略与正常销售价格体系不同。一体化ERP中的寄售管理模块正是通过系统化的流程、清晰的库存状态标识和自动化的结算驱动来解决上述问题实现降低渠道伙伴资金压力增强合作关系。加速新品市场渗透供应商可主动铺货。提高供应链整体效率实现供应商管理库存VMI的初级形态。强化财务风险控制清晰核算资产与收入。1.3 寄售业务的主要参与方与流程概览一次完整的寄售业务通常涉及以下核心流程寄售补货供应商向客户的寄售仓库发货。ERP生成“寄售发货单”库存状态转为“寄售”。寄售消耗客户销售或使用商品。客户向供应商提供消耗通知或数据。寄售结算供应商根据消耗数据在ERP中创建“寄售结算单”或销售发票将寄售库存转为实际销售并结转成本。寄售退货客户将未售出的商品退回给供应商。ERP生成“寄售退货单”库存状态转回自有或核销。2. 系统设计与环境准备2.1 技术栈与版本说明本文将基于一个典型的Java Web技术栈进行设计演示这套方案具有通用性可根据实际技术选型调整。后端框架Spring Boot 2.7.x (提供快速开发能力)持久层MyBatis-Plus 3.5.x (简化数据库操作)数据库MySQL 8.0 (也可适配Oracle, PostgreSQL等)前端Vue 3 Element Plus (用于演示数据交互本文侧重后端逻辑)项目管理Maven 3.6IDEIntelliJ IDEA 或 Eclipse重要提示版本号应根据你的项目实际情况调整。本文重点在于阐述设计思路与核心实现代码示例力求清晰可直接作为参考。2.2 核心数据库表设计数据库设计是寄售管理的基石。关键在于通过库存状态字段来区分寄售库存与自有库存。-- 商品主数据表 CREATE TABLE product ( id bigint(20) NOT NULL AUTO_INCREMENT COMMENT 主键, sku_code varchar(64) NOT NULL COMMENT 商品SKU编码, name varchar(255) NOT NULL COMMENT 商品名称, specification varchar(500) DEFAULT NULL COMMENT 规格型号, unit varchar(20) DEFAULT NULL COMMENT 单位, PRIMARY KEY (id), UNIQUE KEY uk_sku_code (sku_code) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT商品表; -- 客户/合作伙伴表 CREATE TABLE customer ( id bigint(20) NOT NULL AUTO_INCREMENT COMMENT 主键, code varchar(64) NOT NULL COMMENT 客户编码, name varchar(255) NOT NULL COMMENT 客户名称, is_consignment_customer tinyint(1) DEFAULT 0 COMMENT 是否为寄售客户 0-否 1-是, PRIMARY KEY (id), UNIQUE KEY uk_code (code) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT客户表; -- 仓库表 CREATE TABLE warehouse ( id bigint(20) NOT NULL AUTO_INCREMENT COMMENT 主键, code varchar(64) NOT NULL COMMENT 仓库编码, name varchar(255) NOT NULL COMMENT 仓库名称, type tinyint(4) NOT NULL COMMENT 仓库类型 1-自有仓 2-客户寄售仓 3-第三方仓, related_customer_id bigint(20) DEFAULT NULL COMMENT 关联客户ID当type2时必填, PRIMARY KEY (id), UNIQUE KEY uk_code (code), KEY idx_related_customer (related_customer_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT仓库表; -- 库存明细表核心表 CREATE TABLE inventory_detail ( id bigint(20) NOT NULL AUTO_INCREMENT COMMENT 主键, sku_id bigint(20) NOT NULL COMMENT 商品ID, warehouse_id bigint(20) NOT NULL COMMENT 仓库ID, quantity decimal(15,3) NOT NULL DEFAULT 0.000 COMMENT 当前数量, stock_status tinyint(4) NOT NULL COMMENT 库存状态 1-正常可用 2-寄售待结算 3-冻结 4-在途, batch_no varchar(100) DEFAULT NULL COMMENT 批次号, production_date date DEFAULT NULL COMMENT 生产日期, PRIMARY KEY (id), UNIQUE KEY uk_stock (sku_id,warehouse_id,stock_status,batch_no), -- 联合唯一键 KEY idx_sku_warehouse (sku_id,warehouse_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT库存明细表; -- 寄售发货单主表 CREATE TABLE consignment_order ( id bigint(20) NOT NULL AUTO_INCREMENT COMMENT 主键, order_no varchar(64) NOT NULL COMMENT 寄售单号, customer_id bigint(20) NOT NULL COMMENT 客户ID, consignment_warehouse_id bigint(20) NOT NULL COMMENT 寄售仓库ID, total_amount decimal(15,2) DEFAULT NULL COMMENT 订单总金额预估, order_status tinyint(4) NOT NULL COMMENT 状态 10-待审核 20-已审核 30-部分发货 40-已完成 90-已关闭, create_time datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT 创建时间, create_by varchar(64) DEFAULT NULL COMMENT 创建人, PRIMARY KEY (id), UNIQUE KEY uk_order_no (order_no), KEY idx_customer (customer_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT寄售订单主表; -- 寄售发货单明细表 CREATE TABLE consignment_order_item ( id bigint(20) NOT NULL AUTO_INCREMENT COMMENT 主键, order_id bigint(20) NOT NULL COMMENT 主表ID, sku_id bigint(20) NOT NULL COMMENT 商品ID, quantity decimal(15,3) NOT NULL COMMENT 发货数量, unit_price decimal(15,2) NOT NULL COMMENT 寄售单价, shipped_quantity decimal(15,3) DEFAULT 0.000 COMMENT 已发货数量, settled_quantity decimal(15,3) DEFAULT 0.000 COMMENT 已结算数量, PRIMARY KEY (id), KEY idx_order_id (order_id), KEY idx_sku_id (sku_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT寄售订单明细表; -- 寄售结算单主表 CREATE TABLE consignment_settlement ( id bigint(20) NOT NULL AUTO_INCREMENT COMMENT 主键, settlement_no varchar(64) NOT NULL COMMENT 结算单号, customer_id bigint(20) NOT NULL COMMENT 客户ID, settlement_date date NOT NULL COMMENT 结算日期, total_quantity decimal(15,3) NOT NULL COMMENT 结算总数量, total_amount decimal(15,2) NOT NULL COMMENT 结算总金额, status tinyint(4) NOT NULL COMMENT 状态 10-草稿 20-已过账 90-已取消, create_time datetime NOT NULL DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY uk_settlement_no (settlement_no) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT寄售结算单主表; -- 寄售结算单明细表 CREATE TABLE consignment_settlement_item ( id bigint(20) NOT NULL AUTO_INCREMENT COMMENT 主键, settlement_id bigint(20) NOT NULL COMMENT 结算单ID, sku_id bigint(20) NOT NULL COMMENT 商品ID, quantity decimal(15,3) NOT NULL COMMENT 结算数量, unit_price decimal(15,2) NOT NULL COMMENT 结算单价, amount decimal(15,2) NOT NULL COMMENT 结算金额, source_order_item_id bigint(20) DEFAULT NULL COMMENT 来源的寄售订单明细ID用于反写, PRIMARY KEY (id), KEY idx_settlement_id (settlement_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT寄售结算单明细表;设计要点解析库存状态分离inventory_detail表中的stock_status字段是核心。2-寄售待结算状态明确标识了这部分库存的所有权仍属于供应商。仓库类型区分warehouse表的type字段区分了自有仓和客户寄售仓。寄售仓关联特定客户逻辑上属于客户地点但库存资产属于供应商。单据状态流转consignment_order和consignment_settlement都有明确的状态字段用于控制业务流程如审核后才能发货过账后生成财务凭证。数量跟踪consignment_order_item中的shipped_quantity已发货和settled_quantity已结算用于精细跟踪每一行商品的执行进度。3. 核心业务流程与代码实现3.1 寄售补货发货流程此流程将自有可用库存转为客户寄售库存。后端服务层代码示例 (Java Spring Boot MyBatis-Plus)// 1. 寄售发货单DTO数据传输对象 Data public class ConsignmentOrderDTO { private String orderNo; private Long customerId; private Long consignmentWarehouseId; private ListConsignmentOrderItemDTO items; // 其他字段... } Data public class ConsignmentOrderItemDTO { private Long skuId; private BigDecimal quantity; private BigDecimal unitPrice; } // 2. 服务层接口 public interface ConsignmentOrderService extends IServiceConsignmentOrder { /** * 创建并审核寄售发货单 */ boolean createAndAuditOrder(ConsignmentOrderDTO dto, String operator); /** * 执行发货扣减自有库存增加寄售库存 */ boolean shipOrder(Long orderId, String operator); } // 3. 服务层实现关键业务逻辑 Service Transactional(rollbackFor Exception.class) public class ConsignmentOrderServiceImpl extends ServiceImplConsignmentOrderMapper, ConsignmentOrder implements ConsignmentOrderService { Autowired private InventoryService inventoryService; Autowired private ConsignmentOrderItemService orderItemService; Override public boolean createAndAuditOrder(ConsignmentOrderDTO dto, String operator) { // 1. 基础校验 if (dto null || CollectionUtils.isEmpty(dto.getItems())) { throw new BusinessException(寄售单明细不能为空); } Customer customer customerService.getById(dto.getCustomerId()); if (customer null || !Boolean.TRUE.equals(customer.getIsConsignmentCustomer())) { throw new BusinessException(客户不存在或非寄售客户); } // 2. 保存主单 ConsignmentOrder order new ConsignmentOrder(); BeanUtils.copyProperties(dto, order); order.setOrderNo(generateOrderNo()); // 生成单号规则如CO202310250001 order.setOrderStatus(20); // 已审核 order.setCreateBy(operator); this.save(order); // 3. 保存明细 ListConsignmentOrderItem itemList dto.getItems().stream().map(itemDto - { ConsignmentOrderItem item new ConsignmentOrderItem(); BeanUtils.copyProperties(itemDto, item); item.setOrderId(order.getId()); item.setShippedQuantity(BigDecimal.ZERO); item.setSettledQuantity(BigDecimal.ZERO); return item; }).collect(Collectors.toList()); orderItemService.saveBatch(itemList); // 4. 可选的库存可用性预检查在发货前做 // checkInventoryAvailability(dto.getItems()); return true; } Override public boolean shipOrder(Long orderId, String operator) { ConsignmentOrder order this.getById(orderId); if (order null || order.getOrderStatus() ! 20) { throw new BusinessException(寄售单不存在或状态不允许发货); } ListConsignmentOrderItem items orderItemService.lambdaQuery() .eq(ConsignmentOrderItem::getOrderId, orderId) .list(); // 关键库存事务操作 for (ConsignmentOrderItem item : items) { // 场景从公司“自有可用仓”假设ID1发货到客户的“寄售仓” Long fromWarehouseId 1L; // 自有仓库ID实际应从配置或单据中获取 Long toWarehouseId order.getConsignmentWarehouseId(); // 扣减自有可用库存 (stock_status 1) inventoryService.reduceInventory(item.getSkuId(), fromWarehouseId, 1, item.getQuantity(), order.getOrderNo(), CONSIGNMENT_SHIP); // 增加寄售待结算库存 (stock_status 2) inventoryService.addInventory(item.getSkuId(), toWarehouseId, 2, item.getQuantity(), order.getOrderNo(), CONSIGNMENT_SHIP); // 更新已发货数量 item.setShippedQuantity(item.getQuantity()); } orderItemService.updateBatchById(items); // 更新订单状态 order.setOrderStatus(40); // 已完成 this.updateById(order); // 记录操作日志 logOperation(orderId, SHIP, operator); return true; } } // 4. 库存服务核心方法 Service public class InventoryServiceImpl implements InventoryService { Autowired private InventoryDetailMapper inventoryDetailMapper; Override Transactional(rollbackFor Exception.class) public boolean reduceInventory(Long skuId, Long warehouseId, Integer stockStatus, BigDecimal quantity, String refNo, String bizType) { // 使用MyBatis-Plus的UpdateWrapper进行原子操作防止超卖 UpdateWrapperInventoryDetail updateWrapper new UpdateWrapper(); updateWrapper.eq(sku_id, skuId) .eq(warehouse_id, warehouseId) .eq(stock_status, stockStatus) // 乐观锁确保当前数量足够扣减 .ge(quantity, quantity) .setSql(quantity quantity - quantity); int rows inventoryDetailMapper.update(null, updateWrapper); if (rows 0) { // 扣减失败可能库存不足或记录不存在 throw new BusinessException(扣减库存失败库存不足或状态不符。SKU: skuId); } // 插入库存变动流水记录用于追溯 InventoryLog log new InventoryLog(skuId, warehouseId, stockStatus, quantity.negate(), refNo, bizType); inventoryLogMapper.insert(log); return true; } Override Transactional(rollbackFor Exception.class) public boolean addInventory(Long skuId, Long warehouseId, Integer stockStatus, BigDecimal quantity, String refNo, String bizType) { // 先尝试更新现有记录 UpdateWrapperInventoryDetail updateWrapper new UpdateWrapper(); updateWrapper.eq(sku_id, skuId) .eq(warehouse_id, warehouseId) .eq(stock_status, stockStatus) .setSql(quantity quantity quantity); int rows inventoryDetailMapper.update(null, updateWrapper); if (rows 0) { // 无现有记录则插入一条新记录 InventoryDetail newDetail new InventoryDetail(); newDetail.setSkuId(skuId); newDetail.setWarehouseId(warehouseId); newDetail.setStockStatus(stockStatus); newDetail.setQuantity(quantity); inventoryDetailMapper.insert(newDetail); } // 插入库存变动流水记录 InventoryLog log new InventoryLog(skuId, warehouseId, stockStatus, quantity, refNo, bizType); inventoryLogMapper.insert(log); return true; } }3.2 寄售结算流程此流程是寄售业务的核心将寄售库存转为实际销售成本并生成应收款。// 1. 结算单服务 Service public class ConsignmentSettlementServiceImpl extends ServiceImplConsignmentSettlementMapper, ConsignmentSettlement implements ConsignmentSettlementService { Autowired private InventoryService inventoryService; Autowired private ConsignmentOrderItemService orderItemService; Autowired private FinancialService financialService; // 财务服务用于生成凭证 /** * 创建结算单基于客户提供的消耗数据 * param settlementDTO 包含客户、结算日期、结算明细SKU、数量、单价 */ Override Transactional(rollbackFor Exception.class) public boolean createSettlement(ConsignmentSettlementDTO settlementDTO, String operator) { // 1. 校验结算明细的库存是否充足 for (ConsignmentSettlementItemDTO itemDTO : settlementDTO.getItems()) { BigDecimal availableConsignmentQty getConsignmentInventory( itemDTO.getSkuId(), settlementDTO.getCustomerId() ); if (availableConsignmentQty.compareTo(itemDTO.getQuantity()) 0) { throw new BusinessException(String.format( 商品[%s]寄售库存不足。可用%s结算%s, itemDTO.getSkuId(), availableConsignmentQty, itemDTO.getQuantity() )); } } // 2. 保存结算单主单 ConsignmentSettlement settlement new ConsignmentSettlement(); BeanUtils.copyProperties(settlementDTO, settlement); settlement.setSettlementNo(generateSettlementNo()); settlement.setStatus(10); // 草稿状态 this.save(settlement); // 3. 保存结算单明细并关联源寄售订单明细先进先出或指定批次 ListConsignmentSettlementItem itemList new ArrayList(); for (ConsignmentSettlementItemDTO itemDTO : settlementDTO.getItems()) { // 分配库存来源FIFO逻辑 ListConsignmentOrderItem sourceItems allocateSourceItems( itemDTO.getSkuId(), settlementDTO.getCustomerId(), itemDTO.getQuantity() ); for (ConsignmentOrderItem sourceItem : sourceItems) { ConsignmentSettlementItem settlementItem new ConsignmentSettlementItem(); BeanUtils.copyProperties(itemDTO, settlementItem); settlementItem.setSettlementId(settlement.getId()); settlementItem.setSourceOrderItemId(sourceItem.getId()); // 实际结算数量可能拆分自多个源订单行 BigDecimal settleQty sourceItem.getShippedQuantity() .subtract(sourceItem.getSettledQuantity()) .min(itemDTO.getQuantity()); settlementItem.setQuantity(settleQty); settlementItem.setAmount(settleQty.multiply(itemDTO.getUnitPrice())); itemList.add(settlementItem); // 更新源订单明细的已结算数量 sourceItem.setSettledQuantity( sourceItem.getSettledQuantity().add(settleQty) ); itemDTO.setQuantity(itemDTO.getQuantity().subtract(settleQty)); if (itemDTO.getQuantity().compareTo(BigDecimal.ZERO) 0) { break; } } } settlementItemService.saveBatch(itemList); orderItemService.updateBatchById(/* 更新后的sourceItems */); // 4. 更新结算单汇总金额 recalculateSettlementTotal(settlement.getId()); return true; } /** * 过账结算单核心库存转移 生成财务凭证 */ Override Transactional(rollbackFor Exception.class) public boolean postSettlement(Long settlementId, String operator) { ConsignmentSettlement settlement this.getById(settlementId); if (settlement null || settlement.getStatus() ! 10) { throw new BusinessException(结算单不存在或状态不允许过账); } ListConsignmentSettlementItem items settlementItemService .lambdaQuery().eq(ConsignmentSettlementItem::getSettlementId, settlementId).list(); for (ConsignmentSettlementItem item : items) { // 获取对应的寄售仓库ID通过源订单找到 Long consignmentWarehouseId getConsignmentWarehouseId(item.getSourceOrderItemId()); // 关键操作扣减“寄售待结算”库存 inventoryService.reduceInventory(item.getSkuId(), consignmentWarehouseId, 2, item.getQuantity(), settlement.getSettlementNo(), CONSIGNMENT_SETTLE); // 注意这里不增加“自有可用库存”因为商品已售出。 // 成本结转在财务凭证中体现借主营业务成本贷寄售商品 // 如果需要可以增加“已销售”或“成本已结转”的特殊库存状态用于跟踪但通常财务总账已处理。 } // 调用财务接口生成会计凭证 // 借应收账款 / 银行存款 // 贷主营业务收入 // 借主营业务成本 // 贷寄售商品资产类科目 financialService.generateConsignmentSettlementVoucher(settlement, items); // 更新结算单状态 settlement.setStatus(20); // 已过账 settlement.setPostBy(operator); settlement.setPostTime(new Date()); this.updateById(settlement); return true; } /** * 查询客户寄售库存可用量 */ private BigDecimal getConsignmentInventory(Long skuId, Long customerId) { // 查询该客户下所有寄售仓中此SKU的寄售库存总量 ListLong consignmentWarehouseIds warehouseService.getConsignmentWarehouseIdsByCustomer(customerId); if (CollectionUtils.isEmpty(consignmentWarehouseIds)) { return BigDecimal.ZERO; } return inventoryDetailMapper.sumQuantityBySkuAndWarehousesAndStatus( skuId, consignmentWarehouseIds, 2); // status2 寄售待结算 } }3.3 寄售退货流程退货流程相对简单是发货的逆向操作将寄售库存转回自有可用库存。Service public class ConsignmentReturnServiceImpl implements ConsignmentReturnService { Autowired private InventoryService inventoryService; public boolean createReturn(ConsignmentReturnDTO returnDTO, String operator) { // 1. 校验退货数量不超过客户处该商品的寄售库存 for (ConsignmentReturnItemDTO item : returnDTO.getItems()) { BigDecimal consignmentQty getConsignmentInventory(item.getSkuId(), returnDTO.getCustomerId()); if (consignmentQty.compareTo(item.getReturnQuantity()) 0) { throw new BusinessException(退货数量超过寄售库存); } } // 2. 生成退货单并保存省略单据保存代码 // 3. 执行库存转移 for (ConsignmentReturnItemDTO item : returnDTO.getItems()) { Long fromWarehouseId getCustomerConsignmentWarehouseId(returnDTO.getCustomerId()); Long toWarehouseId getOwnAvailableWarehouseId(); // 自有可用仓 // 扣减客户寄售仓的寄售库存 inventoryService.reduceInventory(item.getSkuId(), fromWarehouseId, 2, item.getReturnQuantity(), returnDTO.getReturnNo(), CONSIGNMENT_RETURN); // 增加自有可用仓的可用库存 inventoryService.addInventory(item.getSkuId(), toWarehouseId, 1, item.getReturnQuantity(), returnDTO.getReturnNo(), CONSIGNMENT_RETURN); } return true; } }4. 关键业务逻辑与最佳实践4.1 库存成本核算方法寄售库存的成本核算至关重要直接影响到结算时的毛利计算。移动加权平均法推荐每次采购入库时重新计算物料的加权平均成本。寄售发货时成本按当前加权平均成本计算从“库存商品”科目转入“寄售商品”科目。结算时按发货时的成本从“寄售商品”科目转入“主营业务成本”。优点核算相对简单成本波动平滑。实现需要在inventory_detail表或单独的成本表中记录unit_cost字段并在每次采购入库时更新。先进先出法FIFO需要为库存记录批次号batch_no和入库时间。寄售发货和结算时必须指定或系统自动匹配发出的是哪个批次的库存。优点更符合实物流动尤其在食品、医药等有保质期要求的行业。实现inventory_detail表需要增加batch_no作为唯一键的一部分库存操作需按批次进行。4.2 与财务模块的集成寄售业务必须在财务上清晰体现。核心会计分录如下寄售发货时商品所有权未转移不确认收入借寄售商品资产类科目 贷库存商品此分录可在月末汇总进行或发货时实时处理寄售结算时客户消耗所有权转移确认收入成本借应收账款 / 银行存款 贷主营业务收入 应交税费 - 应交增值税销项税额 借主营业务成本 贷寄售商品最佳实践在ERP中通过“凭证模板”或“自动会计”功能实现。上述结算服务中的financialService.generateConsignmentSettlementVoucher()方法就是调用此功能传入结算单数据自动生成标准会计分录。4.3 寄售价格管理寄售价格可能与正常销售价不同。独立价格体系在商品主数据或客户-商品关系中维护专门的consignment_price。价格有效期增加价格生效日期和失效日期。审批流程价格变更需走审批流程确保合规。在创建寄售订单和结算单时优先读取寄售价格。5. 常见问题与排查思路问题现象可能原因排查步骤与解决方案寄售发货时提示“库存不足”1. 商品在发货源仓库的“可用状态”库存不足。2. 库存被其他订单预留或锁定。3. 仓库或库存状态配置错误。1. 检查inventory_detail表确认stock_status1的对应仓库数量是否充足。2. 检查是否存在未完成的出库单、调拨单占用了库存。3. 确认发货单上指定的“发货仓库”是否正确。结算时提示“寄售库存不足”1. 客户实际消耗数据有误超过实际发货量。2. 部分寄售库存已被其他结算单占用系统bug。3. 库存数据不同步如手工修改了数据库。1. 核对客户提供的消耗清单与系统发货记录。2. 查询consignment_order_item表比较shipped_quantity与settled_quantity找出未结算的库存。3. 执行库存核对脚本修复inventory_detail与业务单据的差异。寄售库存对账不平1. 业务单据发货、结算、退货状态与库存操作未同步。2. 极端情况下的并发操作导致数据不一致。3. 有直接操作数据库的“后门”程序。1. 开发对账报表理论寄售库存 累计发货 - 累计结算 - 累计退货与inventory_detail中stock_status2的库存对比。2. 所有库存变动必须通过标准服务接口并记录流水(inventory_log)。3. 定期如每日运行对账任务发送差异告警。结算生成财务凭证失败1. 财务科目配置不全或错误。2. 结算金额为0或为负。3. 财务模块接口异常或网络问题。1. 检查商品、客户对应的收入、成本、寄售资产科目是否配置正确。2. 在结算单过账前增加金额校验。3. 实现财务凭证生成的异步重试与补偿机制记录失败日志。查询客户寄售库存慢1. 数据量大未对inventory_detail表的查询条件建立索引。2. 查询逻辑复杂多次联表。1. 确保(sku_id, warehouse_id, stock_status)有联合索引。2. 将客户寄售库存汇总表customer_consignment_summary通过定时任务更新供查询使用。6. 生产环境部署与运维建议6.1 性能优化索引策略如前所述在inventory_detail表的查询关键字段上建立复合索引。对于consignment_order,consignment_settlement等业务单表在customer_id,order_status,create_time上建立索引。读写分离将对账、报表等复杂查询操作指向只读从库减轻主库压力。缓存应用将不常变的客户信息、商品信息、价格信息放入Redis等缓存中。异步处理财务凭证生成、短信邮件通知等非实时核心操作放入消息队列异步处理。6.2 数据一致性保障事务边界发货、结算、退货等涉及多表更新和库存变动的操作必须在一个数据库事务内完成。使用Spring的Transactional注解并合理设置超时时间和回滚规则。幂等性设计所有对外提供的API特别是库存扣减、单据过账需要支持幂等调用防止网络重试导致重复操作。可通过唯一业务流水号如订单号操作类型来实现。对账与补偿每日定时运行对账作业核对业务单据流水与库存余额。发现差异时触发人工审核或自动补偿流程需谨慎。6.3 监控与告警业务监控监控寄售库存周转天数、超期未结算库存、结算单处理时效等关键业务指标。系统监控监控库存相关接口的响应时间、错误率。设置库存余额预警如低于安全库存、高于上限库存。日志审计详细记录所有库存变动日志(inventory_log)包含操作人、时间、数量、前后值、业务单号便于问题追溯。6.4 安全与权限数据权限基于客户、仓库、业务部门进行数据隔离。销售员只能看到自己负责客户的寄售数据。操作权限严格区分“制单”、“审核”、“发货”、“过账”等权限。结算单过账权限应赋予财务人员而非业务人员。价格保护寄售价格修改需高级别审批系统记录修改历史。寄售管理作为ERP系统中深化供应链协同的重要模块其成功实施关键在于“账实相符”与“流程清晰”。本文从业务概念、数据模型、核心代码到运维实践提供了一套完整的实现框架。在实际项目中还需结合企业的具体业务规则如结算周期、价格策略、退货条款进行细化。建议先在一个业务单元进行试点跑通全流程并验证财务数据准确性后再逐步推广。
ERP寄售管理模块实战：Spring Boot + MyBatis-Plus实现供应链协同
在传统库存管理模式中企业常常面临资金占用大、库存周转慢、市场响应迟滞的痛点。尤其在处理经销商、代理商或特定客户的货物时货物所有权与存放地点的分离使得账务处理复杂对账困难极易产生纠纷。寄售Consignment作为一种创新的供应链管理模式正是解决这些问题的关键。本文将深入探讨如何在一体化ERP系统中设计并实现寄售管理模块从核心概念、业务流程、数据库设计到代码实现提供一套完整、可落地的实战方案。无论你是正在选型的项目经理、负责开发的软件工程师还是希望优化业务流程的业务顾问都能从中获得清晰的指引和可直接复用的代码示例。1. 寄售管理的核心概念与业务价值1.1 什么是寄售Consignment寄售是一种特殊的商品销售方式。在这种模式下供应商寄售方将商品发送给客户承销方但商品的所有权在客户实际售出或消耗之前仍归属于供应商。客户只有在销售了商品后才需要向供应商支付货款。对于未售出的商品客户有权将其退还给供应商。这与传统的“先买后卖”模式有本质区别传统购销客户先购买货物获得所有权再销售。资金和库存风险由客户承担。寄售模式客户先获得货物实物销售后才结算。供应商承担库存资金压力客户则降低了资金占用和滞销风险。1.2 为什么企业需要ERP寄售管理在未系统化管理的寄售业务中企业常遇到以下挑战账实不符实物在客户仓库但公司系统内无库存或库存地点混乱。对账困难依赖手工表格记录发货、销售和结算效率低下且易出错。库存可视性差无法实时掌握分布在各个客户处的寄售库存数量、库龄和状态。结算延迟销售数据反馈慢导致供应商开票和回款周期长。价格管理复杂寄售商品可能采用特殊定价策略与正常销售价格体系不同。一体化ERP中的寄售管理模块正是通过系统化的流程、清晰的库存状态标识和自动化的结算驱动来解决上述问题实现降低渠道伙伴资金压力增强合作关系。加速新品市场渗透供应商可主动铺货。提高供应链整体效率实现供应商管理库存VMI的初级形态。强化财务风险控制清晰核算资产与收入。1.3 寄售业务的主要参与方与流程概览一次完整的寄售业务通常涉及以下核心流程寄售补货供应商向客户的寄售仓库发货。ERP生成“寄售发货单”库存状态转为“寄售”。寄售消耗客户销售或使用商品。客户向供应商提供消耗通知或数据。寄售结算供应商根据消耗数据在ERP中创建“寄售结算单”或销售发票将寄售库存转为实际销售并结转成本。寄售退货客户将未售出的商品退回给供应商。ERP生成“寄售退货单”库存状态转回自有或核销。2. 系统设计与环境准备2.1 技术栈与版本说明本文将基于一个典型的Java Web技术栈进行设计演示这套方案具有通用性可根据实际技术选型调整。后端框架Spring Boot 2.7.x (提供快速开发能力)持久层MyBatis-Plus 3.5.x (简化数据库操作)数据库MySQL 8.0 (也可适配Oracle, PostgreSQL等)前端Vue 3 Element Plus (用于演示数据交互本文侧重后端逻辑)项目管理Maven 3.6IDEIntelliJ IDEA 或 Eclipse重要提示版本号应根据你的项目实际情况调整。本文重点在于阐述设计思路与核心实现代码示例力求清晰可直接作为参考。2.2 核心数据库表设计数据库设计是寄售管理的基石。关键在于通过库存状态字段来区分寄售库存与自有库存。-- 商品主数据表 CREATE TABLE product ( id bigint(20) NOT NULL AUTO_INCREMENT COMMENT 主键, sku_code varchar(64) NOT NULL COMMENT 商品SKU编码, name varchar(255) NOT NULL COMMENT 商品名称, specification varchar(500) DEFAULT NULL COMMENT 规格型号, unit varchar(20) DEFAULT NULL COMMENT 单位, PRIMARY KEY (id), UNIQUE KEY uk_sku_code (sku_code) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT商品表; -- 客户/合作伙伴表 CREATE TABLE customer ( id bigint(20) NOT NULL AUTO_INCREMENT COMMENT 主键, code varchar(64) NOT NULL COMMENT 客户编码, name varchar(255) NOT NULL COMMENT 客户名称, is_consignment_customer tinyint(1) DEFAULT 0 COMMENT 是否为寄售客户 0-否 1-是, PRIMARY KEY (id), UNIQUE KEY uk_code (code) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT客户表; -- 仓库表 CREATE TABLE warehouse ( id bigint(20) NOT NULL AUTO_INCREMENT COMMENT 主键, code varchar(64) NOT NULL COMMENT 仓库编码, name varchar(255) NOT NULL COMMENT 仓库名称, type tinyint(4) NOT NULL COMMENT 仓库类型 1-自有仓 2-客户寄售仓 3-第三方仓, related_customer_id bigint(20) DEFAULT NULL COMMENT 关联客户ID当type2时必填, PRIMARY KEY (id), UNIQUE KEY uk_code (code), KEY idx_related_customer (related_customer_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT仓库表; -- 库存明细表核心表 CREATE TABLE inventory_detail ( id bigint(20) NOT NULL AUTO_INCREMENT COMMENT 主键, sku_id bigint(20) NOT NULL COMMENT 商品ID, warehouse_id bigint(20) NOT NULL COMMENT 仓库ID, quantity decimal(15,3) NOT NULL DEFAULT 0.000 COMMENT 当前数量, stock_status tinyint(4) NOT NULL COMMENT 库存状态 1-正常可用 2-寄售待结算 3-冻结 4-在途, batch_no varchar(100) DEFAULT NULL COMMENT 批次号, production_date date DEFAULT NULL COMMENT 生产日期, PRIMARY KEY (id), UNIQUE KEY uk_stock (sku_id,warehouse_id,stock_status,batch_no), -- 联合唯一键 KEY idx_sku_warehouse (sku_id,warehouse_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT库存明细表; -- 寄售发货单主表 CREATE TABLE consignment_order ( id bigint(20) NOT NULL AUTO_INCREMENT COMMENT 主键, order_no varchar(64) NOT NULL COMMENT 寄售单号, customer_id bigint(20) NOT NULL COMMENT 客户ID, consignment_warehouse_id bigint(20) NOT NULL COMMENT 寄售仓库ID, total_amount decimal(15,2) DEFAULT NULL COMMENT 订单总金额预估, order_status tinyint(4) NOT NULL COMMENT 状态 10-待审核 20-已审核 30-部分发货 40-已完成 90-已关闭, create_time datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT 创建时间, create_by varchar(64) DEFAULT NULL COMMENT 创建人, PRIMARY KEY (id), UNIQUE KEY uk_order_no (order_no), KEY idx_customer (customer_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT寄售订单主表; -- 寄售发货单明细表 CREATE TABLE consignment_order_item ( id bigint(20) NOT NULL AUTO_INCREMENT COMMENT 主键, order_id bigint(20) NOT NULL COMMENT 主表ID, sku_id bigint(20) NOT NULL COMMENT 商品ID, quantity decimal(15,3) NOT NULL COMMENT 发货数量, unit_price decimal(15,2) NOT NULL COMMENT 寄售单价, shipped_quantity decimal(15,3) DEFAULT 0.000 COMMENT 已发货数量, settled_quantity decimal(15,3) DEFAULT 0.000 COMMENT 已结算数量, PRIMARY KEY (id), KEY idx_order_id (order_id), KEY idx_sku_id (sku_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT寄售订单明细表; -- 寄售结算单主表 CREATE TABLE consignment_settlement ( id bigint(20) NOT NULL AUTO_INCREMENT COMMENT 主键, settlement_no varchar(64) NOT NULL COMMENT 结算单号, customer_id bigint(20) NOT NULL COMMENT 客户ID, settlement_date date NOT NULL COMMENT 结算日期, total_quantity decimal(15,3) NOT NULL COMMENT 结算总数量, total_amount decimal(15,2) NOT NULL COMMENT 结算总金额, status tinyint(4) NOT NULL COMMENT 状态 10-草稿 20-已过账 90-已取消, create_time datetime NOT NULL DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY uk_settlement_no (settlement_no) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT寄售结算单主表; -- 寄售结算单明细表 CREATE TABLE consignment_settlement_item ( id bigint(20) NOT NULL AUTO_INCREMENT COMMENT 主键, settlement_id bigint(20) NOT NULL COMMENT 结算单ID, sku_id bigint(20) NOT NULL COMMENT 商品ID, quantity decimal(15,3) NOT NULL COMMENT 结算数量, unit_price decimal(15,2) NOT NULL COMMENT 结算单价, amount decimal(15,2) NOT NULL COMMENT 结算金额, source_order_item_id bigint(20) DEFAULT NULL COMMENT 来源的寄售订单明细ID用于反写, PRIMARY KEY (id), KEY idx_settlement_id (settlement_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT寄售结算单明细表;设计要点解析库存状态分离inventory_detail表中的stock_status字段是核心。2-寄售待结算状态明确标识了这部分库存的所有权仍属于供应商。仓库类型区分warehouse表的type字段区分了自有仓和客户寄售仓。寄售仓关联特定客户逻辑上属于客户地点但库存资产属于供应商。单据状态流转consignment_order和consignment_settlement都有明确的状态字段用于控制业务流程如审核后才能发货过账后生成财务凭证。数量跟踪consignment_order_item中的shipped_quantity已发货和settled_quantity已结算用于精细跟踪每一行商品的执行进度。3. 核心业务流程与代码实现3.1 寄售补货发货流程此流程将自有可用库存转为客户寄售库存。后端服务层代码示例 (Java Spring Boot MyBatis-Plus)// 1. 寄售发货单DTO数据传输对象 Data public class ConsignmentOrderDTO { private String orderNo; private Long customerId; private Long consignmentWarehouseId; private ListConsignmentOrderItemDTO items; // 其他字段... } Data public class ConsignmentOrderItemDTO { private Long skuId; private BigDecimal quantity; private BigDecimal unitPrice; } // 2. 服务层接口 public interface ConsignmentOrderService extends IServiceConsignmentOrder { /** * 创建并审核寄售发货单 */ boolean createAndAuditOrder(ConsignmentOrderDTO dto, String operator); /** * 执行发货扣减自有库存增加寄售库存 */ boolean shipOrder(Long orderId, String operator); } // 3. 服务层实现关键业务逻辑 Service Transactional(rollbackFor Exception.class) public class ConsignmentOrderServiceImpl extends ServiceImplConsignmentOrderMapper, ConsignmentOrder implements ConsignmentOrderService { Autowired private InventoryService inventoryService; Autowired private ConsignmentOrderItemService orderItemService; Override public boolean createAndAuditOrder(ConsignmentOrderDTO dto, String operator) { // 1. 基础校验 if (dto null || CollectionUtils.isEmpty(dto.getItems())) { throw new BusinessException(寄售单明细不能为空); } Customer customer customerService.getById(dto.getCustomerId()); if (customer null || !Boolean.TRUE.equals(customer.getIsConsignmentCustomer())) { throw new BusinessException(客户不存在或非寄售客户); } // 2. 保存主单 ConsignmentOrder order new ConsignmentOrder(); BeanUtils.copyProperties(dto, order); order.setOrderNo(generateOrderNo()); // 生成单号规则如CO202310250001 order.setOrderStatus(20); // 已审核 order.setCreateBy(operator); this.save(order); // 3. 保存明细 ListConsignmentOrderItem itemList dto.getItems().stream().map(itemDto - { ConsignmentOrderItem item new ConsignmentOrderItem(); BeanUtils.copyProperties(itemDto, item); item.setOrderId(order.getId()); item.setShippedQuantity(BigDecimal.ZERO); item.setSettledQuantity(BigDecimal.ZERO); return item; }).collect(Collectors.toList()); orderItemService.saveBatch(itemList); // 4. 可选的库存可用性预检查在发货前做 // checkInventoryAvailability(dto.getItems()); return true; } Override public boolean shipOrder(Long orderId, String operator) { ConsignmentOrder order this.getById(orderId); if (order null || order.getOrderStatus() ! 20) { throw new BusinessException(寄售单不存在或状态不允许发货); } ListConsignmentOrderItem items orderItemService.lambdaQuery() .eq(ConsignmentOrderItem::getOrderId, orderId) .list(); // 关键库存事务操作 for (ConsignmentOrderItem item : items) { // 场景从公司“自有可用仓”假设ID1发货到客户的“寄售仓” Long fromWarehouseId 1L; // 自有仓库ID实际应从配置或单据中获取 Long toWarehouseId order.getConsignmentWarehouseId(); // 扣减自有可用库存 (stock_status 1) inventoryService.reduceInventory(item.getSkuId(), fromWarehouseId, 1, item.getQuantity(), order.getOrderNo(), CONSIGNMENT_SHIP); // 增加寄售待结算库存 (stock_status 2) inventoryService.addInventory(item.getSkuId(), toWarehouseId, 2, item.getQuantity(), order.getOrderNo(), CONSIGNMENT_SHIP); // 更新已发货数量 item.setShippedQuantity(item.getQuantity()); } orderItemService.updateBatchById(items); // 更新订单状态 order.setOrderStatus(40); // 已完成 this.updateById(order); // 记录操作日志 logOperation(orderId, SHIP, operator); return true; } } // 4. 库存服务核心方法 Service public class InventoryServiceImpl implements InventoryService { Autowired private InventoryDetailMapper inventoryDetailMapper; Override Transactional(rollbackFor Exception.class) public boolean reduceInventory(Long skuId, Long warehouseId, Integer stockStatus, BigDecimal quantity, String refNo, String bizType) { // 使用MyBatis-Plus的UpdateWrapper进行原子操作防止超卖 UpdateWrapperInventoryDetail updateWrapper new UpdateWrapper(); updateWrapper.eq(sku_id, skuId) .eq(warehouse_id, warehouseId) .eq(stock_status, stockStatus) // 乐观锁确保当前数量足够扣减 .ge(quantity, quantity) .setSql(quantity quantity - quantity); int rows inventoryDetailMapper.update(null, updateWrapper); if (rows 0) { // 扣减失败可能库存不足或记录不存在 throw new BusinessException(扣减库存失败库存不足或状态不符。SKU: skuId); } // 插入库存变动流水记录用于追溯 InventoryLog log new InventoryLog(skuId, warehouseId, stockStatus, quantity.negate(), refNo, bizType); inventoryLogMapper.insert(log); return true; } Override Transactional(rollbackFor Exception.class) public boolean addInventory(Long skuId, Long warehouseId, Integer stockStatus, BigDecimal quantity, String refNo, String bizType) { // 先尝试更新现有记录 UpdateWrapperInventoryDetail updateWrapper new UpdateWrapper(); updateWrapper.eq(sku_id, skuId) .eq(warehouse_id, warehouseId) .eq(stock_status, stockStatus) .setSql(quantity quantity quantity); int rows inventoryDetailMapper.update(null, updateWrapper); if (rows 0) { // 无现有记录则插入一条新记录 InventoryDetail newDetail new InventoryDetail(); newDetail.setSkuId(skuId); newDetail.setWarehouseId(warehouseId); newDetail.setStockStatus(stockStatus); newDetail.setQuantity(quantity); inventoryDetailMapper.insert(newDetail); } // 插入库存变动流水记录 InventoryLog log new InventoryLog(skuId, warehouseId, stockStatus, quantity, refNo, bizType); inventoryLogMapper.insert(log); return true; } }3.2 寄售结算流程此流程是寄售业务的核心将寄售库存转为实际销售成本并生成应收款。// 1. 结算单服务 Service public class ConsignmentSettlementServiceImpl extends ServiceImplConsignmentSettlementMapper, ConsignmentSettlement implements ConsignmentSettlementService { Autowired private InventoryService inventoryService; Autowired private ConsignmentOrderItemService orderItemService; Autowired private FinancialService financialService; // 财务服务用于生成凭证 /** * 创建结算单基于客户提供的消耗数据 * param settlementDTO 包含客户、结算日期、结算明细SKU、数量、单价 */ Override Transactional(rollbackFor Exception.class) public boolean createSettlement(ConsignmentSettlementDTO settlementDTO, String operator) { // 1. 校验结算明细的库存是否充足 for (ConsignmentSettlementItemDTO itemDTO : settlementDTO.getItems()) { BigDecimal availableConsignmentQty getConsignmentInventory( itemDTO.getSkuId(), settlementDTO.getCustomerId() ); if (availableConsignmentQty.compareTo(itemDTO.getQuantity()) 0) { throw new BusinessException(String.format( 商品[%s]寄售库存不足。可用%s结算%s, itemDTO.getSkuId(), availableConsignmentQty, itemDTO.getQuantity() )); } } // 2. 保存结算单主单 ConsignmentSettlement settlement new ConsignmentSettlement(); BeanUtils.copyProperties(settlementDTO, settlement); settlement.setSettlementNo(generateSettlementNo()); settlement.setStatus(10); // 草稿状态 this.save(settlement); // 3. 保存结算单明细并关联源寄售订单明细先进先出或指定批次 ListConsignmentSettlementItem itemList new ArrayList(); for (ConsignmentSettlementItemDTO itemDTO : settlementDTO.getItems()) { // 分配库存来源FIFO逻辑 ListConsignmentOrderItem sourceItems allocateSourceItems( itemDTO.getSkuId(), settlementDTO.getCustomerId(), itemDTO.getQuantity() ); for (ConsignmentOrderItem sourceItem : sourceItems) { ConsignmentSettlementItem settlementItem new ConsignmentSettlementItem(); BeanUtils.copyProperties(itemDTO, settlementItem); settlementItem.setSettlementId(settlement.getId()); settlementItem.setSourceOrderItemId(sourceItem.getId()); // 实际结算数量可能拆分自多个源订单行 BigDecimal settleQty sourceItem.getShippedQuantity() .subtract(sourceItem.getSettledQuantity()) .min(itemDTO.getQuantity()); settlementItem.setQuantity(settleQty); settlementItem.setAmount(settleQty.multiply(itemDTO.getUnitPrice())); itemList.add(settlementItem); // 更新源订单明细的已结算数量 sourceItem.setSettledQuantity( sourceItem.getSettledQuantity().add(settleQty) ); itemDTO.setQuantity(itemDTO.getQuantity().subtract(settleQty)); if (itemDTO.getQuantity().compareTo(BigDecimal.ZERO) 0) { break; } } } settlementItemService.saveBatch(itemList); orderItemService.updateBatchById(/* 更新后的sourceItems */); // 4. 更新结算单汇总金额 recalculateSettlementTotal(settlement.getId()); return true; } /** * 过账结算单核心库存转移 生成财务凭证 */ Override Transactional(rollbackFor Exception.class) public boolean postSettlement(Long settlementId, String operator) { ConsignmentSettlement settlement this.getById(settlementId); if (settlement null || settlement.getStatus() ! 10) { throw new BusinessException(结算单不存在或状态不允许过账); } ListConsignmentSettlementItem items settlementItemService .lambdaQuery().eq(ConsignmentSettlementItem::getSettlementId, settlementId).list(); for (ConsignmentSettlementItem item : items) { // 获取对应的寄售仓库ID通过源订单找到 Long consignmentWarehouseId getConsignmentWarehouseId(item.getSourceOrderItemId()); // 关键操作扣减“寄售待结算”库存 inventoryService.reduceInventory(item.getSkuId(), consignmentWarehouseId, 2, item.getQuantity(), settlement.getSettlementNo(), CONSIGNMENT_SETTLE); // 注意这里不增加“自有可用库存”因为商品已售出。 // 成本结转在财务凭证中体现借主营业务成本贷寄售商品 // 如果需要可以增加“已销售”或“成本已结转”的特殊库存状态用于跟踪但通常财务总账已处理。 } // 调用财务接口生成会计凭证 // 借应收账款 / 银行存款 // 贷主营业务收入 // 借主营业务成本 // 贷寄售商品资产类科目 financialService.generateConsignmentSettlementVoucher(settlement, items); // 更新结算单状态 settlement.setStatus(20); // 已过账 settlement.setPostBy(operator); settlement.setPostTime(new Date()); this.updateById(settlement); return true; } /** * 查询客户寄售库存可用量 */ private BigDecimal getConsignmentInventory(Long skuId, Long customerId) { // 查询该客户下所有寄售仓中此SKU的寄售库存总量 ListLong consignmentWarehouseIds warehouseService.getConsignmentWarehouseIdsByCustomer(customerId); if (CollectionUtils.isEmpty(consignmentWarehouseIds)) { return BigDecimal.ZERO; } return inventoryDetailMapper.sumQuantityBySkuAndWarehousesAndStatus( skuId, consignmentWarehouseIds, 2); // status2 寄售待结算 } }3.3 寄售退货流程退货流程相对简单是发货的逆向操作将寄售库存转回自有可用库存。Service public class ConsignmentReturnServiceImpl implements ConsignmentReturnService { Autowired private InventoryService inventoryService; public boolean createReturn(ConsignmentReturnDTO returnDTO, String operator) { // 1. 校验退货数量不超过客户处该商品的寄售库存 for (ConsignmentReturnItemDTO item : returnDTO.getItems()) { BigDecimal consignmentQty getConsignmentInventory(item.getSkuId(), returnDTO.getCustomerId()); if (consignmentQty.compareTo(item.getReturnQuantity()) 0) { throw new BusinessException(退货数量超过寄售库存); } } // 2. 生成退货单并保存省略单据保存代码 // 3. 执行库存转移 for (ConsignmentReturnItemDTO item : returnDTO.getItems()) { Long fromWarehouseId getCustomerConsignmentWarehouseId(returnDTO.getCustomerId()); Long toWarehouseId getOwnAvailableWarehouseId(); // 自有可用仓 // 扣减客户寄售仓的寄售库存 inventoryService.reduceInventory(item.getSkuId(), fromWarehouseId, 2, item.getReturnQuantity(), returnDTO.getReturnNo(), CONSIGNMENT_RETURN); // 增加自有可用仓的可用库存 inventoryService.addInventory(item.getSkuId(), toWarehouseId, 1, item.getReturnQuantity(), returnDTO.getReturnNo(), CONSIGNMENT_RETURN); } return true; } }4. 关键业务逻辑与最佳实践4.1 库存成本核算方法寄售库存的成本核算至关重要直接影响到结算时的毛利计算。移动加权平均法推荐每次采购入库时重新计算物料的加权平均成本。寄售发货时成本按当前加权平均成本计算从“库存商品”科目转入“寄售商品”科目。结算时按发货时的成本从“寄售商品”科目转入“主营业务成本”。优点核算相对简单成本波动平滑。实现需要在inventory_detail表或单独的成本表中记录unit_cost字段并在每次采购入库时更新。先进先出法FIFO需要为库存记录批次号batch_no和入库时间。寄售发货和结算时必须指定或系统自动匹配发出的是哪个批次的库存。优点更符合实物流动尤其在食品、医药等有保质期要求的行业。实现inventory_detail表需要增加batch_no作为唯一键的一部分库存操作需按批次进行。4.2 与财务模块的集成寄售业务必须在财务上清晰体现。核心会计分录如下寄售发货时商品所有权未转移不确认收入借寄售商品资产类科目 贷库存商品此分录可在月末汇总进行或发货时实时处理寄售结算时客户消耗所有权转移确认收入成本借应收账款 / 银行存款 贷主营业务收入 应交税费 - 应交增值税销项税额 借主营业务成本 贷寄售商品最佳实践在ERP中通过“凭证模板”或“自动会计”功能实现。上述结算服务中的financialService.generateConsignmentSettlementVoucher()方法就是调用此功能传入结算单数据自动生成标准会计分录。4.3 寄售价格管理寄售价格可能与正常销售价不同。独立价格体系在商品主数据或客户-商品关系中维护专门的consignment_price。价格有效期增加价格生效日期和失效日期。审批流程价格变更需走审批流程确保合规。在创建寄售订单和结算单时优先读取寄售价格。5. 常见问题与排查思路问题现象可能原因排查步骤与解决方案寄售发货时提示“库存不足”1. 商品在发货源仓库的“可用状态”库存不足。2. 库存被其他订单预留或锁定。3. 仓库或库存状态配置错误。1. 检查inventory_detail表确认stock_status1的对应仓库数量是否充足。2. 检查是否存在未完成的出库单、调拨单占用了库存。3. 确认发货单上指定的“发货仓库”是否正确。结算时提示“寄售库存不足”1. 客户实际消耗数据有误超过实际发货量。2. 部分寄售库存已被其他结算单占用系统bug。3. 库存数据不同步如手工修改了数据库。1. 核对客户提供的消耗清单与系统发货记录。2. 查询consignment_order_item表比较shipped_quantity与settled_quantity找出未结算的库存。3. 执行库存核对脚本修复inventory_detail与业务单据的差异。寄售库存对账不平1. 业务单据发货、结算、退货状态与库存操作未同步。2. 极端情况下的并发操作导致数据不一致。3. 有直接操作数据库的“后门”程序。1. 开发对账报表理论寄售库存 累计发货 - 累计结算 - 累计退货与inventory_detail中stock_status2的库存对比。2. 所有库存变动必须通过标准服务接口并记录流水(inventory_log)。3. 定期如每日运行对账任务发送差异告警。结算生成财务凭证失败1. 财务科目配置不全或错误。2. 结算金额为0或为负。3. 财务模块接口异常或网络问题。1. 检查商品、客户对应的收入、成本、寄售资产科目是否配置正确。2. 在结算单过账前增加金额校验。3. 实现财务凭证生成的异步重试与补偿机制记录失败日志。查询客户寄售库存慢1. 数据量大未对inventory_detail表的查询条件建立索引。2. 查询逻辑复杂多次联表。1. 确保(sku_id, warehouse_id, stock_status)有联合索引。2. 将客户寄售库存汇总表customer_consignment_summary通过定时任务更新供查询使用。6. 生产环境部署与运维建议6.1 性能优化索引策略如前所述在inventory_detail表的查询关键字段上建立复合索引。对于consignment_order,consignment_settlement等业务单表在customer_id,order_status,create_time上建立索引。读写分离将对账、报表等复杂查询操作指向只读从库减轻主库压力。缓存应用将不常变的客户信息、商品信息、价格信息放入Redis等缓存中。异步处理财务凭证生成、短信邮件通知等非实时核心操作放入消息队列异步处理。6.2 数据一致性保障事务边界发货、结算、退货等涉及多表更新和库存变动的操作必须在一个数据库事务内完成。使用Spring的Transactional注解并合理设置超时时间和回滚规则。幂等性设计所有对外提供的API特别是库存扣减、单据过账需要支持幂等调用防止网络重试导致重复操作。可通过唯一业务流水号如订单号操作类型来实现。对账与补偿每日定时运行对账作业核对业务单据流水与库存余额。发现差异时触发人工审核或自动补偿流程需谨慎。6.3 监控与告警业务监控监控寄售库存周转天数、超期未结算库存、结算单处理时效等关键业务指标。系统监控监控库存相关接口的响应时间、错误率。设置库存余额预警如低于安全库存、高于上限库存。日志审计详细记录所有库存变动日志(inventory_log)包含操作人、时间、数量、前后值、业务单号便于问题追溯。6.4 安全与权限数据权限基于客户、仓库、业务部门进行数据隔离。销售员只能看到自己负责客户的寄售数据。操作权限严格区分“制单”、“审核”、“发货”、“过账”等权限。结算单过账权限应赋予财务人员而非业务人员。价格保护寄售价格修改需高级别审批系统记录修改历史。寄售管理作为ERP系统中深化供应链协同的重要模块其成功实施关键在于“账实相符”与“流程清晰”。本文从业务概念、数据模型、核心代码到运维实践提供了一套完整的实现框架。在实际项目中还需结合企业的具体业务规则如结算周期、价格策略、退货条款进行细化。建议先在一个业务单元进行试点跑通全流程并验证财务数据准确性后再逐步推广。