package com.zy.asrs.service;

import com.zy.asrs.entity.OrderPakin;
import com.zy.asrs.entity.param.OrderDomainParam;

/**
 * 越库服务接口
 * 用于处理越库入库单的创建、库存管理和自动生成越库出库单
 * 
 * @author system
 */
public interface CrossDockService {

    /**
     * 处理越库入库单
     * 
     * 功能说明：
     * 1. 将入库单状态设置为已上报（跳过ERP上报流程）
     * 2. 更新明细完成数量
     * 3. 在虚拟库位创建库存明细记录
     * 4. 自动生成对应的越库出库单
     * 5. 从虚拟库位扣减库存
     * 
     * @param order 入库单对象
     * @param param 订单参数（包含明细信息）
     * @param userId 操作人ID
     * @return 生成的出库单编号
     * @throws com.core.exception.CoolException 处理失败时抛出异常
     */
    String processCrossDockInbound(OrderPakin order, OrderDomainParam param, Long userId);
}