海外仓库存模型升级：从单一数量到批次溯源

在自建日本海外仓的实际运营中，库存管理始终是核心环节。随着业务复杂度的持续提升，从单一数量模型向批次溯源模型的演进已成为必然趋势，这不仅优化了仓储效率，也极大增强了库存的可控性。

库存模型升级的驱动力

在基础阶段，库存模型仅记录每个SKU的总数量，结构如下：

sql
CREATE TABLE inventory (
    sku VARCHAR(64) PRIMARY KEY,
    quantity INT NOT NULL,
    warehouse_id VARCHAR(32)
);

这种简单的库存模型已无法满足日益复杂的业务需求，暴露出四个关键问题：

• 无法追溯商品来源：无法精准定位供应商与采购批次信息
• 无法处理保质期：食品、化妆品等有严格有效期要求的商品难以管理
• 无法处理批次质量问题：当某批次出现瑕疵时，无法高效召回
• 无法支持先进先出（FIFO）出库：库存周转优化难以实现

批次模型的引入

为彻底解决上述痛点，我们引入了批次（Batch）概念，并重新设计了库存模型：

sql
-- 批次表
CREATE TABLE batches (
    batch_no VARCHAR(32) PRIMARY KEY,
    sku VARCHAR(64) NOT NULL,
    supplier_id VARCHAR(32),
    inbound_date DATE,
    expiry_date DATE, -- 有效期
    purchase_price DECIMAL(10,2),
    quantity INT NOT NULL,
    remaining INT NOT NULL, -- 剩余数量
    status TINYINT -- 0:正常 1:已过期 2:已冻结
);

-- 库存明细表（每个商品一个记录）
CREATE TABLE inventory_details (
    id BIGINT PRIMARY KEY AUTO_INCREMENT,
    batch_no VARCHAR(32) NOT NULL,
    unique_code VARCHAR(64) UNIQUE, -- 每个商品的唯一码
    location_code VARCHAR(32), -- 货位
    status ENUM('in_stock', 'reserved', 'shipped', 'damaged'),
    reserved_order_id VARCHAR(64),
    created_at DATETIME,
    INDEX idx_batch (batch_no)
);

批次表完整记录了每个批次的供应商、入库日期、有效期等关键信息；库存明细表则通过唯一码和状态字段，实现了对每个商品的精细化追踪与管理。

FIFO出库的实现

出库操作时，系统自动选择最早入库的批次，确保商品严格遵循先进先出原则：

python
def get_fifo_items(sku, quantity):
    """获取最早入库的N个商品，实现FIFO出库"""
    batches = Batch.query(
        Batch.sku == sku,
        Batch.remaining > 0,
        Batch.expiry_date > datetime.now() # 仅选择未过期批次
    ).order_by(Batch.inbound_date.asc()).all()

    items = []
    remaining = quantity

    for batch in batches:
        if remaining <= 0:
            break
        take = min(remaining, batch.remaining)
        # 从当前批次中取出take个商品
        detail_items = InventoryDetail.query(
            InventoryDetail.batch_no == batch.batch_no,
            InventoryDetail.status == 'in_stock'
        ).limit(take).all()
        items.extend(detail_items)
        remaining -= take

    if remaining > 0:
        raise Exception(f"库存不足，缺少{remaining}件")
    return items

小提示：批次管理中，务必关注过期批次与冻结批次的状态处理，避免误出库导致库存数据错误。

唯一码的应用

对于高价值商品（如户外装备、日本动漫玩偶），我们为每个商品分配一个唯一码，实现精准追踪与溯源：

python
import uuid
import qrcode

def generate_unique_code():
    """生成唯一码（UUID格式）"""
    return str(uuid.uuid4()).replace('-', '')[:16]

def generate_qr_code(unique_code):
    """生成对应二维码"""
    qr = qrcode.QRCode(version=1, box_size=10, border=4)
    qr.add_data(unique_code)
    qr.make(fit=True)
    return qr.make_image(fill_color="black", back_color="white")

# 入库操作
def inbound_item(sku, batch_no, quantity):
    for _ in range(quantity):
        unique_code = generate_unique_code()
        InventoryDetail.create(
            sku=sku,
            batch_no=batch_no,
            unique_code=unique_code,
            status='in_stock'
        )
        # 打印二维码标签，粘贴于商品上
        qr_image = generate_qr_code(unique_code)
        sa ve_qr_label(qr_image, unique_code)

出库时扫描唯一码，系统自动扣减对应的商品库存：

python
def outbound_by_unique_code(unique_code, order_id):
    detail = InventoryDetail.get(InventoryDetail.unique_code == unique_code)
    if detail.status != 'in_stock':
        raise Exception(f"商品{unique_code}当前不可用")
    detail.status = 'shipped'
    detail.reserved_order_id = order_id
    detail.sa ve()
    # 同步更新批次剩余数量
    batch = Batch.get(Batch.batch_no == detail.batch_no)
    batch.remaining -= 1
    batch.sa ve()

常见问题：如何确保唯一码不重复？
解决方案：采用UUID生成，同时在数据库层面设置UNIQUE约束，双重保障唯一性，彻底杜绝重复。

总结

库存模型从“单一数量”演进到“批次+唯一码”，核心驱动力在于可追溯性与精细化运营能力。这套模型让自建日本海外仓的库存准确率从95%大幅提升至99.9%，有效解决了供应商溯源、保质期管理、批次召回和FIFO出库等核心挑战，为跨境电商仓储管理提供了坚实的技术支撑。