通用下料场景开发使用文档

📦 通用下料模型场景开发使用文档

一、功能概述

在润信制造执行过程中，叫料业务需要 ERP、WCS、WMS、RCS 等多个系统协同完成。之前的开发方式中，各系统需重复开发需求推送、任务搬运、搬运反馈等功能，造成效率低下、逻辑重复。

为此，设计本“通用下料模型”，用于抽象各类叫料场景（如领料、退料等），统一托盘搬运与回调流程，实现业务与搬运任务解耦，提升开发效率与系统可维护性。

二、使用场景流程（以“领料”为例）

1. 创建下料需求

   • 建立下料清单 WMS_Allocation_Model​。

   • 明细分配方式：

     • 退料：用户手动选择；
     • 领料：通过调用 WMS 接口自动返回。

2. 发起叫料任务

   • 通过调用统一方法 StockOrderOut()​ 发起搬运任务。

3. 搬运到位处理

   • 搬运任务到达目标库位后：

     • 若 IsAutoOut = true​，系统自动完成出库；
     • 否则，库存停留在终点，等待手动处理。

4. 是否拆托

   • 可由系统判定或用户输入；

详细业务流程如下图：

‍

三、业务开发指引（仅需实现 3 步）

1. 创建下料需求

   • 可多次追加明细；
   • 总数量不超过申请数量。

2. 调用叫料搬运任务

   • 自动完成库存下料搬运到目的地。

3. 实现特殊出库逻辑

   • 非领料单出库的完善对应出库单逻辑。

如下图：开发仅需完善如下即可。

‍

‍

四、数据字段说明：

📄 t_WMS_Allocation_hd​ — 下料主表模型（Header）

📄 t_WMS_Allocation_dl​ — 下料明细表（Detail）

‍

‍

五、接口说明与调用样例

1、出库需求单相关接口

✅ 1. 新增下料需求

using VoionERP.Modules.IMS.WIP.Services.Service;

var newRequestList = new List<WMS_Allocation_Model>
{
    new WMS_Allocation_Model
    {
        BillNo = "BO20250401",
        BillItemId = 1,
        CompanyId = "C001",
        TaskType = "IN",
        TargetLocation = "A1-01",
        MachineNo = "M123",
        ItemNo = "ITM456",
        AppQty = 10,
        Details = new List<t_WMS_Allocation_dl>
        {
            new t_WMS_Allocation_dl {
                ContainerCode= "",
                ItemNo ="",
                Lotno="",
                Currlocation = "",
                TargetLocation = "",
                SourceLocation = "",
                SplitFlag = false,
                SourceLocType = "L",
                AppQty = 4
            }
        }
    }
};

var result = EngineContext.Current.Resolve<IWCSService>()
    .AddStockOrder(tran, newRequestList);
​

✏️ 2. 修改下料需求

同上接口 AddStockOrder​，重新传入结构即可。

❌ 3. 按单据取消需求

using VoionERP.Modules.IMS.WIP.Services.Service;

// 取消整单
var result = EngineContext.Current.Resolve<IWCSService>()
    .CancelStockOrder(tran, "业务单号", "公司ID", 0);

// 取消某一条明细
var result = EngineContext.Current.Resolve<IWCSService>()
    .CancelStockOrder(tran, "业务单号", "公司ID", 1);
​

❌ 4. 按托盘取消叫料

using VoionERP.Modules.IMS.WIP.Services.Service;

var result = EngineContext.Current.Resolve<IWCSService>()
    .CancelStockOrderByPackId(tran, "业务单号", "公司ID", "托盘号");
​

➕ 5. 多次新增托盘明细

using VoionERP.Modules.IMS.WIP.Services.Service;

var packList = new List<t_WMS_Allocation_dl>
{
    new t_WMS_Allocation_dl {
        ContainerCode= "",
        ItemNo ="",
        Lotno="",
        Currlocation = "",
        TargetLocation = "",
        SourceLocation = "",
        SplitFlag = false,
        SourceLocType = "P",
        AppQty = 6,
        status = "0"
    }
};

var result = EngineContext.Current.Resolve<IWCSService>()
    .AddStockPackOrder(tran, "业务单号", "公司ID", 1, packList);
​

🔄 6. 托盘状态更新

using VoionERP.Modules.IMS.WIP.Services.Service;

// 状态码 "4" = 已完成
var result = EngineContext.Current.Resolve<IWCSService>()
    .UpdateStockOrderStatus(tran, "业务单号", "公司ID", "托盘号", "4", "当前位置");
​

🔢 7. 拆托回报更新数量

暂未完成

​

2、下料搬运相关接口

🚚 1. 发起下料搬运任务

using VoionERP.Modules.IMS.WIP.Services.Service;

var result = EngineContext.Current.Resolve<IWCSService>()
    .StockOrderOut(tran, "业务单号", "公司ID");
​

3、最终出库接口实现

出库默认实现了领料单出库的方法，如果有其他特殊场景出库还需要实现,具体实现图下图，继承 IstockOrderOut 实现即可

如果是非领料单出库，实现了对应的出库之后，完善下述代码即可：

 namespace VoionERP.Modules.IMS.Repository
{
	public static class StockRepository
	{
		public static ServiceResponseResult CreateStockOrderOut(ServiceToken token, WMS_Allocation_Model stockOrder, t_WMS_Allocation_dl detail,string startCode,string endCode, ref string BillNo, ITransactionManager tran = null)
		 {
		     ServiceResponseResult result = new ServiceResponseResult();
		     switch (stockOrder.businesstype)
		     {
		         case "":
		         case "partout":
		         case "ProApp":
		             return new StockOrderOutContext(new StockOrderOut_AppOut()).CreateStockOrderOut(token, stockOrder, detail, startCode, BillNo, ref BillNo, tran);
		     }
		     result.Success = false;
		     result.ErrorMsg = "未知业务类型";
		     
		     return result;
		 }
	}
}
​