1.获取验收-随机箱码配置 websocket测试 POST http://wms5idc12.jd.com/mcs/service/simpleWebServiceSoap 接口描述 获取验收配置 UI说明 # 1.master-wms系统配置-系统参数  > ### 1.1增加用户级别系统参数“randomBoxMark” |key|randomBoxMark| |-|-| |value|1| |描述|随机箱码开关(1-开启随机箱码；0-关闭随机箱码)| |特别说明|如果入库单包含序列号商品,则该配置不生效| # 2.采购入库  > ### 2.1扫描【入库单号】，扫单号时判断：当该订单中既含有序列号商品又含有非序列号商品时，如果“randomBoxMark =1”，也要强制按照=0的逻辑走，不能走打印随机箱码的逻辑 > ### 2.2扫描【验收容器】，判断“randomBoxMark =1”，系统自动生成一个随机箱号(生成规则:配送中心ID+仓库编号+年月日+流水号+固定字母) ```language 箱规”置灰； “箱号”置灰； 验收方式默认“件”，不可修改； “单品取消”置灰； ``` > ### 2.3点击【打印箱码】按钮，系统判断“randomBoxMark =1”，系统打印出箱签的同时，生成一个新的箱号 > ### 2.4点击“打印箱码”时，系统判断“randomBoxMark =1”且未进行容器扫描，系统提示：未查询到需要的数据，如需打印请使用“补打箱签”补打  > ### 2.5点击【箱号取消】时，已打印和未打印的箱号，均可以支持取消。取消后，系统内删除该箱下的验收记录，同时同步删除预检中对应的SKU明细记录  箱号取消时校验是否存在验收容器，如“验收容器”为空，则提示“请输入容器号” 箱号取消时校验验收容器是否已完验，如果容器已完验、或者该箱号不属于该容器则提示“未找到该容器的验收结果信息” 箱号取消时校验该箱号是否为本人验收箱号，如不是则提示“不能取消他人验收的箱数据，当前操作人xxxx，箱号验收人yyyy”  > ### 2.6容器取消：取消后，删除该容器下的验收记录，同步删除预检中对应的SKU明细记录及箱验收记录。 > ### 2.7容器完验时，系统校验该容器下箱子是否已经均打印过，如果有未打印的，进行提示“当前箱号未打印，请确认是否已使用打印箱码”。  是：直接完验，完验后需要通过【补打箱签】进行箱签补打，如再次验收生成新箱号 否：返回页面，不进行容器完验，运营可操作打印箱码 > ### 2.8点击【箱明】按钮显示验收的箱明细   > ### 2.9点击“补打箱签”后，弹出对话框，输入箱号，点击打印，执行补打。当点击此按钮时，系统加入判断逻辑：识别打印箱签配置开关，如果“randomBoxMark =1”，系统弹出如下对话框，进入界面如下：  入库单号：系统默认将当前的入库单号带出显示。支持修改或者扫描其他单号。 箱号：该入库单号下最近一个箱号带出显示，支持下拉选择该单号下的其他箱号。 明细位置：显示当前选择的箱号对应的箱明细：“商品编码”、“商品名称”、“装箱数量”。 确认无误后，点击“打印”执行箱号补打，点击“取消”退出当前界面。箱明细支持下拉显示 补打箱签不触发新箱号生成 # 3.上架(RF&盘古) 随机箱码验收的箱号支持【整箱上架】功能：  同一个上架任务不允许【F2 上架】和【整箱上架】交叉执行任务 如果该容器使用过整箱上架，则不允许再使用零散方式上架  如果上架任务使用过非整箱上架，则不允许再使用整箱上架  # 4.报表  装箱验收查询报表（packingCheckReport）： 商品等级字段显示错误，修正为显示商品等级别名（Master – 商品信息 – 商品等级管理 – 商品等级别名字段） 报表内容中增加验收容器号字段、报表查询条件中增加验收容器号  请求说明 / 示例 ```xml POST http://wms5idc12.jd.com/mcs/service/simpleWebServiceSoap HTTP/1.1 User-Agent: Mozilla/4.0 (compatible; MSIE 6.0; MS Web Services Client Protocol 4.0.30319.42000) routerule: 6,6,998 Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJsb2dpblRpbWUiOiIyMDIyLTA3LTI1IDExOjA3OjUxIiwiZGlzdHJpYnV0ZU5vIjoiNiIsIm9yZ05vIjoiNiIsIndhcmVob3VzZU5vIjoiOTk4IiwibG9naW5BY2NvdW50IjoibHVvcnVpMjQifQ.lw9lM8GPnU7Ognn-RNaLL3rN9PXvXuHj_t7iJVDzBaw txId: BC:54:2F:88:42:DF^1658817581889^138 spanId: 20 pSpanId: 10 Content-Type: text/xml; charset=utf-8 SOAPAction: "" Host: wms5idc12.jd.com Content-Length: 745 Expect: 100-continue <?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"> <soap:Body> <queryWs xmlns="http://wms3.360buy.com"> <arg0 xmlns=""> { "bizType":"getSysConfigValue", "uuid":"94d775e5-4d9f-4e79-ac47-f023f5b3f497", "callCode":"360BUY.WMS3.WS.CALLCODE.9999" } </arg0> <arg1 xmlns=""> { "aisle":null, "uuid":null, "zoneNo":null, "areaNo":null, "code":null, "key":"randomBoxMark", //随机箱码配置(1-表示开启随机箱码入库方式，其他值都是正常入库方式) "colNames":null, "needExtAttr":null, "returnMessageFlag":false, "createUser":null, "updateUser":null, "orgNo":"6", "warehouseNo":"998", "distributeNo":"6", "orgName":null, "dcName":null, "warehouseName":null } </arg1> </queryWs> </soap:Body> </soap:Envelope> ``` 响应说明/示例 ```xml HTTP/1.1 200 OK Server: openresty/1.11.2.1 Date: Tue, 26 Jul 2022 06:39:42 GMT Content-Type: text/xml;charset=UTF-8 Connection: close Expires: Tue, 26 Jul 2022 06:39:42 GMT Cache-Control: max-age=0 Content-Length: 301 <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <ns2:queryWsResponse xmlns:ns2="http://wms3.360buy.com"> <return> <resultCode>1</resultCode> <resultMessage>调用成功</resultMessage> <resultValue>0</resultValue> //0代表未开启随机箱码功能，1代表开启 </return> </ns2:queryWsResponse> </soap:Body> </soap:Envelope> ```
# 1.master-wms系统配置-系统参数  > ### 1.1增加用户级别系统参数“randomBoxMark” |key|randomBoxMark| |-|-| |value|1| |描述|随机箱码开关(1-开启随机箱码；0-关闭随机箱码)| |特别说明|如果入库单包含序列号商品,则该配置不生效| # 2.采购入库  > ### 2.1扫描【入库单号】，扫单号时判断：当该订单中既含有序列号商品又含有非序列号商品时，如果“randomBoxMark =1”，也要强制按照=0的逻辑走，不能走打印随机箱码的逻辑 > ### 2.2扫描【验收容器】，判断“randomBoxMark =1”，系统自动生成一个随机箱号(生成规则:配送中心ID+仓库编号+年月日+流水号+固定字母) ```language 箱规”置灰； “箱号”置灰； 验收方式默认“件”，不可修改； “单品取消”置灰； ``` > ### 2.3点击【打印箱码】按钮，系统判断“randomBoxMark =1”，系统打印出箱签的同时，生成一个新的箱号 > ### 2.4点击“打印箱码”时，系统判断“randomBoxMark =1”且未进行容器扫描，系统提示：未查询到需要的数据，如需打印请使用“补打箱签”补打  > ### 2.5点击【箱号取消】时，已打印和未打印的箱号，均可以支持取消。取消后，系统内删除该箱下的验收记录，同时同步删除预检中对应的SKU明细记录  箱号取消时校验是否存在验收容器，如“验收容器”为空，则提示“请输入容器号” 箱号取消时校验验收容器是否已完验，如果容器已完验、或者该箱号不属于该容器则提示“未找到该容器的验收结果信息” 箱号取消时校验该箱号是否为本人验收箱号，如不是则提示“不能取消他人验收的箱数据，当前操作人xxxx，箱号验收人yyyy”  > ### 2.6容器取消：取消后，删除该容器下的验收记录，同步删除预检中对应的SKU明细记录及箱验收记录。 > ### 2.7容器完验时，系统校验该容器下箱子是否已经均打印过，如果有未打印的，进行提示“当前箱号未打印，请确认是否已使用打印箱码”。  是：直接完验，完验后需要通过【补打箱签】进行箱签补打，如再次验收生成新箱号 否：返回页面，不进行容器完验，运营可操作打印箱码 > ### 2.8点击【箱明】按钮显示验收的箱明细   > ### 2.9点击“补打箱签”后，弹出对话框，输入箱号，点击打印，执行补打。当点击此按钮时，系统加入判断逻辑：识别打印箱签配置开关，如果“randomBoxMark =1”，系统弹出如下对话框，进入界面如下：  入库单号：系统默认将当前的入库单号带出显示。支持修改或者扫描其他单号。 箱号：该入库单号下最近一个箱号带出显示，支持下拉选择该单号下的其他箱号。 明细位置：显示当前选择的箱号对应的箱明细：“商品编码”、“商品名称”、“装箱数量”。 确认无误后，点击“打印”执行箱号补打，点击“取消”退出当前界面。箱明细支持下拉显示 补打箱签不触发新箱号生成 # 3.上架(RF&盘古) 随机箱码验收的箱号支持【整箱上架】功能：  同一个上架任务不允许【F2 上架】和【整箱上架】交叉执行任务 如果该容器使用过整箱上架，则不允许再使用零散方式上架  如果上架任务使用过非整箱上架，则不允许再使用整箱上架  # 4.报表  装箱验收查询报表（packingCheckReport）： 商品等级字段显示错误，修正为显示商品等级别名（Master – 商品信息 – 商品等级管理 – 商品等级别名字段） 报表内容中增加验收容器号字段、报表查询条件中增加验收容器号 
```xml POST http://wms5idc12.jd.com/mcs/service/simpleWebServiceSoap HTTP/1.1 User-Agent: Mozilla/4.0 (compatible; MSIE 6.0; MS Web Services Client Protocol 4.0.30319.42000) routerule: 6,6,998 Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJsb2dpblRpbWUiOiIyMDIyLTA3LTI1IDExOjA3OjUxIiwiZGlzdHJpYnV0ZU5vIjoiNiIsIm9yZ05vIjoiNiIsIndhcmVob3VzZU5vIjoiOTk4IiwibG9naW5BY2NvdW50IjoibHVvcnVpMjQifQ.lw9lM8GPnU7Ognn-RNaLL3rN9PXvXuHj_t7iJVDzBaw txId: BC:54:2F:88:42:DF^1658817581889^138 spanId: 20 pSpanId: 10 Content-Type: text/xml; charset=utf-8 SOAPAction: "" Host: wms5idc12.jd.com Content-Length: 745 Expect: 100-continue <?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"> <soap:Body> <queryWs xmlns="http://wms3.360buy.com"> <arg0 xmlns=""> { "bizType":"getSysConfigValue", "uuid":"94d775e5-4d9f-4e79-ac47-f023f5b3f497", "callCode":"360BUY.WMS3.WS.CALLCODE.9999" } </arg0> <arg1 xmlns=""> { "aisle":null, "uuid":null, "zoneNo":null, "areaNo":null, "code":null, "key":"randomBoxMark", //随机箱码配置(1-表示开启随机箱码入库方式，其他值都是正常入库方式) "colNames":null, "needExtAttr":null, "returnMessageFlag":false, "createUser":null, "updateUser":null, "orgNo":"6", "warehouseNo":"998", "distributeNo":"6", "orgName":null, "dcName":null, "warehouseName":null } </arg1> </queryWs> </soap:Body> </soap:Envelope> ```
```xml HTTP/1.1 200 OK Server: openresty/1.11.2.1 Date: Tue, 26 Jul 2022 06:39:42 GMT Content-Type: text/xml;charset=UTF-8 Connection: close Expires: Tue, 26 Jul 2022 06:39:42 GMT Cache-Control: max-age=0 Content-Length: 301 <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <ns2:queryWsResponse xmlns:ns2="http://wms3.360buy.com"> <return> <resultCode>1</resultCode> <resultMessage>调用成功</resultMessage> <resultValue>0</resultValue> //0代表未开启随机箱码功能，1代表开启 </return> </ns2:queryWsResponse> </soap:Body> </soap:Envelope> ```