1.当前,仓库用PDA操作,是用浏览器登入ERP,本质跟PC端登入仓库操作界面一样;
2.仓库操作反馈,PDA若出现卡顿,高频功能都会卡顿,跟158整体性能有关;
需求链接
https://alidocs.dingtalk.com/i/nodes/Gl6Pm2Db8D3kB579tmg6DXXNJxLq0Ee4
需求链接
https://alidocs.dingtalk.com/i/nodes/Gl6Pm2Db8D3kB579tmg6DXXNJxLq0Ee4
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页面

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请求示例

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页面

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请求示例

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请求示例

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、请求地址
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 |
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请求示例

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请求示例

| 所属迭代 | 技术研发中心 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 |
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请求示例