任务描述
区域入库功能
需求描述


业务背景
1.当前,仓库用PDA操作,是用浏览器登入ERP,本质跟PC端登入仓库操作界面一样;
2.仓库操作反馈,PDA若出现卡顿,高频功能都会卡顿,跟158整体性能有关;

需求链接

https://alidocs.dingtalk.com/i/nodes/Gl6Pm2Db8D3kB579tmg6DXXNJxLq0Ee4

验收标准
 以需求描述的功能点和流程进行验收
历史记录  
  1. 2023-03-10 16:10:16, 由 程伟 创建。
  2. 2023-03-10 18:00:02, 由 程伟 编辑。
    修改了 开发组,旧值为 "",新值为 "4"。
  3. 2023-03-21 14:21:14, 由 谢业福 添加备注。

    1.获取用户未完成的区域入库任务的数据

    1.1请求参数


    Method:GetAreaTaskData//必须固定值GetAreaTaskData

    CustomerId:1 客户id 默认1

    WarehouseId:4148 当前仓库id

    UserId:1378 当前登录用户Id

    1.2返回参数

    错误返回

    {
    "Data": null,
    "Success": false,
    "Msg": "获取数据失败"
    }

    有数据返回


    {
        "Data": {
            "HasNoComplete": true,//是否有未完成的,true :是  false:否 当是时,点击去上架的时候 直接跳转到上架页面,否的时候调用接口 ReceivePutTask
            "AreaId": 152,//区域id
            "AreaName": "C区域",//区域名称
            "UnReceivePutTaskNum": 0,//更多未领取的任务
            "NoCompleteTaskNum": 1,//未完成的周转箱数
            "Details": [//详情
                {
                    "TurnoverBoxNo": "G00467",//周转箱
                    "SingleDetailId": '@2206@',//下单条码
                    "DetailId": '*16613*',//采购条码
                    "SKU": "1225307",//系统sku
                    "IsUrgent": false,//是否加急
                    "PutNum": 0,//已入库
                    "PutTaskNum": 5,//任务数
                    "IeRed": false//是否红色字体显示
                }
            ]
        },
        "Success": true,
        "Msg": "获取数据成功"
    }
    PDA页面


    1.3请求示例


  4. 2023-03-21 15:03:11, 由 谢业福 添加备注。

    2.区域入库扫描周转箱领取任务

    2.1请求参数

    Method:AreaPutScanTurnoverBoxNo//必须固定值AreaPutScanTurnoverBoxNo

    CustomerId:1 客户id 默认1

    WarehouseId:4148 当前仓库id

    UserId:1378 当前登录用户Id

    UserName:''当前登录用户名称,

    TurnoverBoxs:当前接口AreaPutScanTurnoverBoxNo返回的TurnoverBoxs,第一次默认为空字符串,

    TurnoverBox:扫描的周转箱


    2.2返回参数

    错误返回

    {
        "Code": "-1",//错误编码 -1 其他错误  0 正常  1,满足20自动创建任务失败 2:周转箱校验失败
        "Data": {
            "Details": null,
            "TurnoverBoxNos": null,//返回当前上架任务的所有周转箱 ,分割,下次调用此方法时需要传入
            "BoxNum": 0,//当前上架任务的箱数
            "IsFreshen": false,//是否需要刷新页面的Details 的数据 ,true 需要刷新
            "IsJump": false//是否满足20箱自动跳转到上架页面  true :跳转
        },
        "Success": false,
        "Msg": "缺少参数区域id"
    }
    正确返回:


    {
        "Code": "0",
        "Data": {
            "Details": [
                {
                    "TurnoverBoxNo": "G00288",
                    "SingleDetailId": "@2192@",
                    "DetailId": "*16603*",
                    "SKU": "1225307",
                    "IsUrgent": false,
                    "PutNum": 0,
                    "PutTaskNum": 9,
                    "IeRed": false
                }
            ],
            "TurnoverBoxNos": "G00288",
            "BoxNum": 1,
            "IsFreshen": true,
            "IsJump": false
        },
        "Success": true,
        "Msg": "获取数据成功"
    }


    2.3.请求示例

    PDA页面


  5. 2023-03-21 15:14:05, 由 谢业福 添加备注。

    3.区域入库领取后去上架

    3.1请求参数


    Method:ReceivePutTask//必须固定值ReceivePutTask

    CustomerId:1 客户id 默认1

    WarehouseId:4148 当前仓库id

    UserId:1378 当前登录用户Id

    UserName:Irobotbox系统管理员 047 当前用户名称

    TurnoverBoxs:接口AreaPutScanTurnoverBoxNo 返回的 TurnoverBoxs ,分割

    3.2返回参数


    {
        "Success": true,//跳转的上架页面
        "Msg": "领取成功"
    }


    3.3请求示例


  6. 2023-03-21 16:37:51, 由 谢业福 添加备注。

    4.区域入库获取未领取的任务

    4.1请求参数


    Method:GetUnReceivePutTask //必须固定值GetUnReceivePutTask

    CustomerId:1 客户id 默认1

    WarehouseId:4148 当前仓库id

    UserId:1378 当前用户id

    AreaId:区域Id,可传0,也可传接口GetAreaTaskData返回的,更多页面的更多必须传0

    PageIndex:当前页  1开始

    PageSize:每页查询数量

    4.2 返回参数


    {
        "Data": {
            "AreaName": "B区域",//区域名称
            "TotalCount": 6,//总记录数
            "Details": [
                {
                    "TurnoverBoxNo": "G00281",//周转箱
                    "PutTaskNo": "QT2022120000002",//入库任务号
                    "SkuNum": 1,//sku数
                    "PutTaskTotalNum": 2//产品数量
                },
                {
                    "TurnoverBoxNo": "G00019",
                    "PutTaskNo": "QT2022030000011",
                    "SkuNum": 1,
                    "PutTaskTotalNum": 20
                },
                {
                    "TurnoverBoxNo": "G00025",
                    "PutTaskNo": "QT2022030000005",
                    "SkuNum": 1,
                    "PutTaskTotalNum": 50
                },
                {
                    "TurnoverBoxNo": "G00026",
                    "PutTaskNo": "QT2022030000004",
                    "SkuNum": 1,
                    "PutTaskTotalNum": 19
                },
                {
                    "TurnoverBoxNo": "G00027",
                    "PutTaskNo": "QT2022030000003",
                    "SkuNum": 1,
                    "PutTaskTotalNum": 50
                },
                {
                    "TurnoverBoxNo": "G00028",
                    "PutTaskNo": "QT2022030000002",
                    "SkuNum": 1,
                    "PutTaskTotalNum": 10
                }
            ]
        },
        "Success": true,
        "Msg": "获取数据成功"
    }
    4.3请求示例


    PDA页面

  7. 2023-03-21 16:54:31, 由 谢业福 添加备注。

    5.根据下单条码获取区域入库数据

    5.1请求参数


    Method:GetAreaPutProductData//必须固定值GetAreaPutProductData

    CustomerId:1 客户id 默认1

    WarehouseId:4148 当前仓库id

    UserId:1378 当前登录用户Id

    UserName:Irobotbox系统管理员 047 当前登录用户名称,

    OrderBarcode:下单条码

    5.2返回参数

    错误返回

    {
        "Code": "-1",// -1 其他错误 0:正常  1:暂无 2:请扫描正确的下单条码 3:下单条码有多个周转框任务,请扫描周转箱
        "Data": null,
        "Success": false,
        "Msg": "请扫描下单条码"
    }
    正确返回


    {
        "Code": "0",
        "Data": {
            "SKU": "1225307",//系统sku
            "ClientSKU": "",//自定义sku
            //产品小图
            "MinImageUrl": "https://irobotbox-hd1.oss-cn-hangzhou.aliyuncs.com/1/ProductImages/1225307/2022/3/12/b22431d0a18e4022bc940aae94c9585e/adf23b27-565b-a4f0-e36f-48a74663f242.jpg?x-oss-process=image/resize,m_pad,w_100,h_100,limit_0,color_ffffff",
            //产品大图
            "ImageUrl": "https://irobotbox-hd1.oss-cn-hangzhou.aliyuncs.com/1/ProductImages/1225307/2022/3/12/b22431d0a18e4022bc940aae94c9585e/adf23b27-565b-a4f0-e36f-48a74663f242.jpg",
            "PositionCode": "FB066,FB069,FB073",//库位
            "ScanPositionCode": "",//扫描库位
            "PutInNum": 9,//可入库数量
            "ProductVitalityTypeImage": 0,//0 不显示图片 1,爆款图片  2 平款图片  3 旺款图片  4 滞销款图片
            "ProductNewTypeImage": 0,//0 不显示  1:显示产品新品图片
            "GoodNum": 2116,//现有库存
            "LockNum": 0,//锁定库存
            "GrossWeight": "300.00",//产品重量
            "ProductNameCN": "Lexicon记事本-01",//产品名称
            "RecommendPosition": "FB072",//推荐库位
            "TurnoverBoxNo": "G00288"//周转箱,单箱直接带出来
        },
        "Success": true,
        "Msg": "获取数据成功"
    }
    5.3请求示例




  8. 2023-03-21 17:04:04, 由 谢业福 添加备注。

    6.根据下单号和周转箱校验数据

    6.1请求参数 


    Method:CheckAreaPutTurnoverBoxNo//必须固定值CheckAreaPutTurnoverBoxNo

    CustomerId:1 客户id 默认1

    WarehouseId:4148 当前仓库id

    UserId:1378 当前登录用户Id

    OrderBarcode:下单条码

    TurnoverBox:周转箱号

    6.2返回参数

    错误返回

    {
        "Code": "1",//错误码 -1 其他错误  0 正常  1不匹配 2下单条码错误 
        "PutInNum": 0,
        "RecommendPosition": null,
        "Success": false,
        "Msg": "周转箱和下单条码不匹配或者未领取该周转箱任务"
    }
    正确返回

    {
        "Code": "0",
        "PutInNum": 9,//可入库数量需要更新输入框
        "RecommendPosition": "FB072",//推荐库位需要更新推荐库位
        "Success": true,
        "Msg": "获取数据成功"
    }

    6.3请求示例

  9. 2023-03-21 17:34:17, 由 谢业福 添加备注。

    7.根据下单条码获取区域入库数据

    7.1请求参数

    Method:AreaPutCheckPosition//必须固定值AreaPutCheckPosition

    CustomerID:1 客户id 默认1

    WarehouseID:4148 当前仓库id

    AdminID:1378 当前登录用户Id

    UserName:Irobotbox系统管理员 047 当前登录用户名称,

    ScanCode:下单条码

    codeType:条码类型  默认传 1


    ScanPositionCode:扫描库位,


    RecommendPositionCode:推荐库位


    ScanNumber:扫描次数




    PutInNum:入库数量




    7.2返回参数

    错误返回

    {
        "Data": {
            "RecommendPositionID": 0,//推荐库位id
            "RecommendPositionCode": "",//推荐库位
            "ScanNumber": 0,//是否需要前端记录扫描次数
            "IsOpenEditProduct": true,//是否需要更改产品尺寸
            "OldLength": 2.0000,//旧的产品长
            "OldWidth": 2.0000,//宽
            "OldHeight": 2.0000//高
        },
        "Success": false,
        "Msg": "未找到库位数据,库位【13131313】未设置区域"
    }

    正确返回


    {
        "Data": {
            "RecommendPositionID": 0,
            "RecommendPositionCode": "",
            "ScanNumber": 0,
            "IsOpenEditProduct": false,
            "OldLength": 2.0000,
            "OldWidth": 2.0000,
            "OldHeight": 2.0000
        },
        "Success": true,
        "Msg": ""
    }
    请求示例


    详细文档

    1、推荐库位-修改尺寸

    3.1、请求地址

    http://trunk.zhcxkj.com/Api/Index.ashx?Method=RecommendPosition&CustomerID=1&warehouseID=4306&scanCode=5816&PutinNum=700&ScanPositionCode=YT50&NewHeight=5&NewLength=15&NewWide=15&AdminID=2

    3.2、参数说明

    参数名称

    是否必填

    参数说明

    CustomerID

    是

    商户号

    warehouseID

    是

    仓库ID

    scanCode

    是

    扫描条码

    codeType

    否

    条码类型:1、下单条码 2、系统SKU,默认为1

    ScanPositionCode

    是

    扫描库位

    RecommendPositionCode

    否

    推荐库位(多次扫描的时候会用此库位来判断扫描次数)

    ScanNumber

    否

    扫描次数,默认为0

    PutInNum

    是

    入库数量

    MenuType

    否

    操作菜单

    NewLength

    否

    长(新尺寸),默认为0

    NewWide

    否

    宽(新尺寸),默认为0

    NewHeight

    否

    高(新尺寸),默认为0

    AdminID

    否

    操作人ID

     

     

     

     

     

     

     

     

     

     

     

     

     

    3.3、返回数据

    参数名称

    数据类型

    参数说明

    Data

    Object

    推荐库位内容

    RecommendPositionID

    Int

    推荐库位ID,默认为0

    RecommendPositionCode

    string

    推荐库位编码,默认为空字符串

    ScanNumber

    Int

    扫描次数,默认为0

    IsOpenEditProduct

    Bool

    是否打开修改产品尺寸弹窗,默认为false

    OldLength

    decimal

    长(原始尺寸),默认为0

    OldWidth

    decimal

    宽(原始尺寸),默认为0

    OldHeight

    decimal

    高(原始尺寸),默认为0

     

     

     

     

     

     

     

     

     

     

     



  10. 2023-03-21 17:42:46, 由 谢业福 添加备注。

    8.提交区域入库

    8.1请求参数


    Method:SumbitAreaPut//必须固定值SumbitAreaPut

    CustomerId:1 客户id 默认1

    WarehouseId:4148 当前仓库id

    UserId:1378 当前登录用户Id

    UserName:Irobotbox系统管理员 047 当前登录用户名称,

    OrderBarcode:下单条码

    PutInNum:入库数量

    TurnoverBox:周转箱

    ScanPositionCode:扫描库位

    8.2返回参数

    错误返回

    {
        "Success": false,
        "Msg": "扫描库位不能为空"
    }
    正确返回


    {
        "Success": true,
        "Msg": "入库成功"
    }
    8.3请求示例



  11. 2023-03-21 18:26:56, 由 谢业福 添加备注。

    9.完结区域入库

    9.1请求参数


    Method:CompleteAreaPutTask//必须固定值CompleteAreaPutTask

    CustomerId:1 客户id 默认1

    WarehouseId:4148 当前仓库id

    UserId:1378 当前登录用户Id

    UserName:Irobotbox系统管理员 047 当前登录用户名称

    TurnoverBox:周转箱

    9.2返回参数

    错误返回

    特别说明当Msg为"任务完成",需要跳转到领取页面

    {     "IsComplete": false,     "Success": false,     "Msg": "您没有领取任务或者已完结,不能异常完结!" }


    正确返回

    {
        "IsComplete": true,
        "Success": true,
        "Msg": "异常完结成功"
    }
    

    9.3请求示例


  12. 2023-03-22 18:47:08, 由 谢业福 完成。
    修改了 总计消耗,旧值为 "0",新值为 "4"。
    修改了 实际完成,旧值为 "",新值为 "2023-03-22 18:47:03"。
    修改了 任务状态,旧值为 "wait",新值为 "done"。
    修改了 实际开始,旧值为 "0000-00-00 00:00:00",新值为 "2023-03-22 18:47:08"。
    修改了 预计剩余,旧值为 "4",新值为 "0"。
    修改了 由谁完成,旧值为 "",新值为 "xieyefu"。
  13. 2023-04-03 14:19:25, 由 谢业福 关闭。
    修改了 任务状态,旧值为 "done",新值为 "closed"。
    修改了 指派给 ,旧值为 "xieyefu",新值为 "closed"。
    修改了 由谁关闭,旧值为 "",新值为 "xieyefu"。
    修改了 关闭时间,旧值为 "0000-00-00 00:00:00",新值为 "2023-04-03 14:19:25"。
    修改了 关闭原因,旧值为 "",新值为 "done"。
所属迭代 技术研发中心 3月第2版本(2023年)
所属模块 /
相关需求 OMS:PDA转APP二期需求(4月第一迭代)
指派给 Closed 于 2023-04-03 14:19:25
任务类型 后端
任务标签 初始
开发组
任务状态 已关闭
进度 100%
优先级 P2
关键词
抄送给
由谁创建 程伟 于 2023-03-10 16:10:16
由谁完成 谢业福 于 2023-03-22 18:47:03
由谁取消 暂无
由谁关闭 谢业福 于 2023-04-03 14:19:25
关闭原因 已完成
最后编辑 谢业福 于 2023-04-03 14:19:25
团队 最初预计 总计消耗 预计剩余
工时信息
最初预计 4工时
总计消耗 4工时
预计剩余 0工时
预计开始 0000-00-00
实际开始 2023-03-22
截止日期 0000-00-00