104 lines
3.8 KiB
C#
104 lines
3.8 KiB
C#
using System;
|
||
using System.Collections.Generic;
|
||
|
||
namespace HHWMS.Web.Services.Agv
|
||
{
|
||
/// <summary>
|
||
/// AGV 接单请求 DTO(方案 11.1;与手动下发页面参数保持一致)
|
||
/// </summary>
|
||
public class AgvReceiveRequest
|
||
{
|
||
/// <summary>上游任务号(可选;非空则作为 TaskNo,且按 SourceCode+SourceSystem 幂等)</summary>
|
||
public string SourceCode { get; set; }
|
||
|
||
/// <summary>上游来源系统标识(必填)</summary>
|
||
public string SourceSystem { get; set; }
|
||
|
||
/// <summary>上游任务类型(必填;字符串类型按场景配置 SourceTaskType 匹配,数字枚举 1~6 按 AgvTaskType 兼容)</summary>
|
||
public string TaskType { get; set; }
|
||
|
||
/// <summary>起点库位编码(必填,AGV 点位)</summary>
|
||
public string FromLocation { get; set; }
|
||
|
||
/// <summary>终点库位编码(必填,AGV 点位)</summary>
|
||
public string ToLocation { get; set; }
|
||
|
||
/// <summary>容器号(可选;不给则自动生成 LS 临时容器)</summary>
|
||
public string ContainerCode { get; set; }
|
||
|
||
/// <summary>优先级(可选;默认 0,越大越优先)</summary>
|
||
public int? Priority { get; set; }
|
||
|
||
/// <summary>起点楼层(可选;WMS 不做楼层管控,仅接收不校验)</summary>
|
||
public int? FromFloor { get; set; }
|
||
|
||
/// <summary>终点楼层(可选;WMS 不做楼层管控,仅接收不校验)</summary>
|
||
public int? ToFloor { get; set; }
|
||
|
||
/// <summary>物料明细(可选;缺 SKU 按空容器业务处理)</summary>
|
||
public List<AgvReceiveDetail> Details { get; set; }
|
||
}
|
||
|
||
/// <summary>
|
||
/// 接单物料明细(SKU,可不用但不能没有)
|
||
/// </summary>
|
||
public class AgvReceiveDetail
|
||
{
|
||
/// <summary>物料编码(本地不存在时调 ERP LoadInventory 补建)</summary>
|
||
public string MaterialCode { get; set; }
|
||
|
||
/// <summary>数量</summary>
|
||
public decimal? Qty { get; set; }
|
||
|
||
/// <summary>批次(入库报工 FinishIn 的 StepCode 来源,可空)</summary>
|
||
public string Batch { get; set; }
|
||
|
||
/// <summary>ERP 生产订单明细 ID(可空;入库报工 FinishIn 的 MoDetailId 来源)</summary>
|
||
public string ErpDetailId { get; set; }
|
||
}
|
||
|
||
/// <summary>
|
||
/// AGV 回调请求 DTO(方案 11.3)
|
||
/// </summary>
|
||
public class AgvCallbackRequest
|
||
{
|
||
/// <summary>WMS 任务号(=AGV 侧 orderId,必填)</summary>
|
||
public string TaskNo { get; set; }
|
||
|
||
/// <summary>事件(Accepted/ArrivedLoad/Loaded/ArrivedUnload/Unloaded/Error/Cancel,必填)</summary>
|
||
public string Event { get; set; }
|
||
|
||
/// <summary>事件发生时间</summary>
|
||
public DateTime? EventTime { get; set; }
|
||
|
||
/// <summary>容器号(与任务比对,不一致告警)</summary>
|
||
public string ContainerCode { get; set; }
|
||
|
||
/// <summary>实际卸货库位(Unloaded 必填,完成联动以该值落位)</summary>
|
||
public string ActualLocation { get; set; }
|
||
|
||
/// <summary>AGV 小车编号(可选)</summary>
|
||
public string AgvCarNo { get; set; }
|
||
|
||
/// <summary>错误码(异常/取消时)</summary>
|
||
public string ErrorCode { get; set; }
|
||
|
||
/// <summary>错误信息(异常/取消时)</summary>
|
||
public string ErrorMsg { get; set; }
|
||
}
|
||
|
||
/// <summary>
|
||
/// AGV 业务异常(带错误码,Controller 层转 ApiResultError)
|
||
/// </summary>
|
||
public class AgvBizException : Exception
|
||
{
|
||
/// <summary>错误码:param/notfound/status/lock/error</summary>
|
||
public string ErrorCode { get; }
|
||
|
||
public AgvBizException(string errorCode, string message) : base(message)
|
||
{
|
||
ErrorCode = errorCode;
|
||
}
|
||
}
|
||
}
|