11

啊鑫

2025-01-08 7e4085b2b97386abb8b7dc5626953dc79b1f1b45

 Controllers/Warehouse/TransferOutController.cs

@@ -7,7 +7,7 @@
namespace NewPdaSqlServer.Controllers.Warehouse;

/// <summary>
/// 调拨出库相关接口
///     调拨出库相关接口
/// </summary>
[Route("api/[controller]")]
[ApiController]
@@ -18,7 +18,7 @@
    #region 基础CRUD

    /// <summary>
    /// 获取所有调拨出库单
    ///     获取所有调拨出库单
    /// </summary>
    /// <returns>调拨出库单列表</returns>
    [HttpPost("GetList")]
@@ -46,11 +46,11 @@
    #region 调拨出库业务

    /// <summary>
    /// 获取未完成的调拨出库单号列表
    ///     获取未完成的调拨出库单号列表
    /// </summary>
    /// <returns>未完成的调拨出库单号列表</returns>
    /// <remarks>
    /// 获取申请数量(sq)不等于已扫数量(ys)的调拨出库单号列表
    ///     获取申请数量(sq)不等于已扫数量(ys)的调拨出库单号列表
    /// </remarks>
    /// <response code="200">成功获取调拨出库单号列表</response>
    /// <response code="400">获取失败</response>
@@ -75,33 +75,33 @@
    }

    /// <summary>
    /// 根据单据号获取待处理的调拨出库明细列表
    ///     根据单据号获取待处理的调拨出库明细列表
    /// </summary>
    /// <param name="query">查询参数</param>
    /// <returns>待处理的调拨出库明细列表</returns>
    /// <remarks>
    /// 请求示例:
    /// 
    ///     请求示例:
    ///     POST /api/TransferOut/GetTransferOutDetailListByBillNo
    ///     {
    ///         "billNo": "DB202401010001"  // 调拨单号(必填)
    ///     "billNo": "DB202401010001"  // 调拨单号(必填)
    ///     }
    /// 
    /// 返回未完成的明细记录(ShNum-YsNum>0)，包含：
    /// - ItemNo: 物料编号
    /// - ItemModel: 物料规格
    /// - ShNum: 申请数量
    /// - YsNum: 已扫数量
    ///     返回未完成的明细记录(ShNum-YsNum>0)，包含：
    ///     - ItemNo: 物料编号
    ///     - ItemModel: 物料规格
    ///     - ShNum: 申请数量
    ///     - YsNum: 已扫数量
    /// </remarks>
    /// <response code="200">成功获取调拨出库明细</response>
    /// <response code="400">获取失败，返回具体错误信息</response>
    [HttpPost("GetTransferOutDetailListByBillNo")]
    public ResponseResult GetTransferOutDetailListByBillNo([FromBody] WarehouseQuery query)
    public ResponseResult GetTransferOutDetailListByBillNo(
        [FromBody] WarehouseQuery query)
    {
        try
        {
            dynamic resultInfos = new ExpandoObject();
            resultInfos.tbBillList = _manager.GetTransferOutDetailListByBillNo(query);
            resultInfos.tbBillList =
                _manager.GetTransferOutDetailListByBillNo(query);
            return new ResponseResult
            {
                status = 0,
@@ -116,30 +116,27 @@
    }

    /// <summary>
    /// 扫描条码进行调拨出库处理
    ///     扫描条码进行调拨出库处理
    /// </summary>
    /// <param name="query">查询参数</param>
    /// <returns>处理结果和待处理明细</returns>
    /// <remarks>
    /// 请求示例:
    /// 
    ///     请求示例:
    ///     POST /api/TransferOut/ScanMoveBarcode
    ///     {
    ///         "billNo": "DB202401010001",  // 调拨单号(必填)
    ///         "userName": "admin",          // 用户名(必填)
    ///         "barcode": "BC001"           // 条码号(必填)
    ///     "billNo": "DB202401010001",  // 调拨单号(必填)
    ///     "userName": "admin",          // 用户名(必填)
    ///     "barcode": "BC001"           // 条码号(必填)
    ///     }
    /// 
    /// 业务处理：
    /// - 验证调拨单状态
    /// - 验证条码库存信息
    /// - 验证仓库一致性
    /// - 验证数量是否超出未扫数量
    /// - 执行调拨出库事务处理
    /// 
    /// 返回数据包含：
    /// - form: 处理结果表单
    /// - items: 待处理明细列表
    ///     业务处理：
    ///     - 验证调拨单状态
    ///     - 验证条码库存信息
    ///     - 验证仓库一致性
    ///     - 验证数量是否超出未扫数量
    ///     - 执行调拨出库事务处理
    ///     返回数据包含：
    ///     - form: 处理结果表单
    ///     - items: 待处理明细列表
    /// </remarks>
    /// <response code="200">扫描成功</response>
    /// <response code="400">扫描失败，返回具体错误信息</response>