任务描述
采购理货入库功能
需求描述


业务背景
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 17:58:16, 由 程伟 编辑。
    修改了 开发组,旧值为 "",新值为 "4"。
  3. 2023-03-16 13:57:09, 由 谢业福 添加备注。

    1.获取用户未完成的上架任务

    1.1请求参数


    Method:GetReceiptAndStorageTaskData//必须固定值GetReceiptAndStorageTaskData

    CustomerId:1 客户id 默认1

    WarehouseId:4148 当前仓库id

    UserId:1378 当前登录用户Id

    1.2返回参数


    特别说明

    TaskState:上架任务状态:当为2 上架中的时候 不能点击理货操作,要提示去上架   

    TotalBoxNum:总的箱数,当为20的时候不能点击理货操作,要提示达到理货上限

    TaskNo:上架任务号,点击理货和上架的时候都需要传 这个值



    有任务未完成


    {   
        "Data": { //数据
            "HasNoComplete": true,//是否有未完成的任务:true 是
            "TaskNo": "SJ2023030000001",//上架任务号
            "TaskId": 1,//上架任务id
            "TaskState": 1,//上架任务状态值   0:待理货 1:理货中 2:上架中 3 :已完成
            "TaskStateName": "理货中",//上架任务状态名称
            "TallyBoxNum": 1,//采购理货数
            "PutBoxNum": 0,//采购入库数
            "Details": [//详情
                {
                    "TurnoverBoxNo": "G00463",//周转箱号
                    "SingleDetailID": 2205,//下单条码
                    "TallyNum": 1,//理货数量
                    "PutInNum": 0,//入库数量
                    "TaskState": 1,//周转箱状态 0:待质检  1待入库 2部分入库 3 已完成  4待理货
                    "TaskStateName": "待入库"//周转箱任务状态名称
                }
            ],
            "TotalBoxNum": 1//周转箱总数
        },
        "Success": true,
        "Msg": "获取数据成功"//错误提示
    }
    没有任务



    {
        "Data": {
            "HasNoComplete": false,
            "TaskNo": "SJ2023030000001",
            "TaskId": 0,
            "TaskState": 0,
            "TaskStateName": "待理货",
            "TallyBoxNum": 0,
            "PutBoxNum": 0,
            "Details": null,
            "TotalBoxNum": 0
        },
        "Success": true,
        "Msg": "获取数据成功"
    }
    1.3 请求示例


  4. 2023-03-16 14:06:17, 由 谢业福 添加备注。

    2.理货获取产品信息

    2.1请求参数


    Method:GetTallyProductData //必须固定值GetTallyProductData

    CustomerId:1 客户id 默认1

    WarehouseId:4148 当前仓库id

    OrderBarcode:@2205@ 下单条码

    TurnoverBox:G00463 周转箱号

    TaskNo:SJ2023030000001 任务号,上个菜单传过来的


    2.2 返回参数



    {
        "Code": "0",//-1 其他错误  0:正常 1:当前仓库不存在该周转箱号 2:请扫描正确的下单条码
        "Data": {//数据
            "SKU": "1225307",//系统sku
            "ClientSKU": "",//自定义sku
            "IsUrgent": false,//是否加急
            //产品小图100*100
            "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",
            //库位 取前3 updatetime 
            "PositionCode": "FB066,FB069,FB073",       
            "RecommendArea": "", //推荐区域
            "ProductVitalityTypeImage": "",//区域活跃度图片url
            "RealNum": 5,//已销单数量
            "PutNum": 0,//可入库数量
            "TallyNum": 0,//累计理货数量
            "CheckNum": 0,//质检数量
            "TotalBadNum": 0,//不良品数量
            "RealPutNum": 0,//已入库数量
            "CheckAdminName": "Irobotbox系统管理员  047",//质检人
            "IsFirstInWareHouse": "是"//是否首次入库
        },
        "Success": true,
        "Msg": "获取数据成功"
    }
    2.3 请求示例


  5. 2023-03-16 15:27:00, 由 谢业福 添加备注。

    3.提交理货

    3.1请求参数


    Method:SumbitTally //必须固定值SumbitTally

    CustomerId:1 客户id 默认1

    WarehouseId:4148 当前仓库id

    OrderBarcode:@2205@ 下单条码

    TurnoverBox:G00463 周转箱号

    TaskNo:SJ2023030000001 任务号,上个菜单传过来的

    TallyNum:1 理货数量

    UserId:1378 当前用户id

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

    3.2 返回参数

    提交成功

    {
        "Success": true,//提交是否成功
        "Msg": "操作成功"//错误信息
    }
    提交失败


    {
        "Success": false,
        "Msg": "超过当前周转箱可理货数量"
    }
    请求示例





    补充第2个返回接口参数

    ProductVitalityTypeImage 0 不显示图片 1,爆款图片  2 平款图片  3 旺款图片  4 滞销款图片


  6. 2023-03-17 11:26:48, 由 谢业福 添加备注。

    4.采购入库获取产品信息


    4.1请求参数


    Method:GetStorageProductData//必须固定值GetStorageProductData

    CustomerId:1 客户id 默认1

    WarehouseId:4148 当前仓库id

    OrderBarcode:@2205@ 下单条码

    TurnoverBox:G00463 周转箱号

    TaskNo:SJ2023030000001 任务号,上个菜单传过来的

    UserId:1378 当前用户id

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

    4.2 返回参数

    {
        "Code": "0",//-1 其他错误  0:正常 1:当前仓库不存在该周转箱号 2:请扫描正确的下单条码
        "Data": {//数据
            "SKU": "1225307",//系统sku
            "ClientSKU": "",//自定义sku
            "IsUrgent": false,//是否加急
            //产品小图 100*100
            "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",//库位
            "PutInNum": 1,//可入库数量,默认显示在入库数量的文本框内
            "ScanPositionCode": "",//扫描的库位,默认显示在库位的文本框内
            "ProductVitalityTypeImage": 0,//0 不显示图片 1,爆款图片  2 平款图片  3 旺款图片  4 滞销款图片
            "ProductNewTypeImage": 0, //0 不显示  1:显示产品新品图片
            "GoodNum": 2113,//现有库存
            "LockNum": 0,//锁定库存
            "GrossWeight": "300.00",//产品重量
            "ProductNameCN": "Lexicon记事本-01"//产品中文名称
        },
        "Success": true,
        "Msg": "获取数据成功"
    }
    4.3 请求示例





  7. 2023-03-17 11:35:46, 由 谢业福 添加备注。

    5.采购入库库位校验


    5.1请求参数


    Method:StorageCheckPosition//必须固定值StorageCheckPosition

    CustomerId:1 客户id 默认1

    WarehouseId:4148 当前仓库id

    OrderBarcode:@2205@ 下单条码

    UserId:1378 当前用户id

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

    ScanPositionCode:FB066 //库位编码

    5.2 返回参数

    校验不通过

    {
        "Success": false,
        "Msg": "库位不存在"
    }
    校验通过


    {
        "Success": true,
        "Msg": "校验通过"
    }
    5.3 请求示例





  8. 2023-03-17 11:43:01, 由 谢业福 添加备注。

    6.采购入库


    6.1请求参数


    Method:SumbitStorage//必须固定值SumbitStorage

    CustomerId:1 客户id 默认1

    WarehouseId:4148 当前仓库id

    OrderBarcode:@2205@ 下单条码

    TurnoverBox:G00463 周转箱号

    TaskNo:SJ2023030000001 任务号,上个菜单传过来的

    UserId:1378 当前用户id

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

    ScanPositionCode:FB066 //库位编码

    PutInNum:1:入库数量

    6.2 返回参数

    提交失败的

    {
        "Success": false,
        "Msg": "库位不存在"
    }
    提交成功的



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



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