校验波次唯一码

websocket测试

POST

请求地址/router

系统相关界面

"界面路径：【仓储】----【唯一码管理】"

请求地址

公共参数

调用任何一个API都必须传入的参数，目前支持的公共参数有： | 参数名称 | 参数类型 | 是否必须 | 参数描述 | | --- | --- | --- | --- | | method | string | 是 | API接口名称 | | appKey | string | 是 | 分配给应用的AppKey | | timestamp | string | 是 | 时间戳，时区为GMT+8，例如：2020-09-21 16:58:00。API服务端允许客户端请求最大时间误差为10分钟 | | format | string | 否 | 响应格式。默认为json格式，可选值：json | | version | string | 是 | API协议版本可选值：1.0 | | sign\_method | string | 否 | 签名的摘要算法(默认 hmac)，可选值为：hmac，md5，hmac-sha256。 | | sign | string | 是 | 签名 | | session | string | 是 | 授权会话信息（即access_token，由系统分配） |

请求头

参数名

类型

描述

必填

Content-Type

string

application/x-www-form-urlencoded;charset=UTF-8

必填

API接口地址

参数名

类型

描述

必填

method

string

erp.wave.unique.code.validate

必填

请求参数

参数名

类型

描述

必填

默认值

uniqueCodes

string

唯一码号,多个逗号隔开，最多支持20组（时间或者唯一码其中一项必填）

可选

startTime

string

起始时间:格式yyyy-MM-dd HH:mm:ss，与endTime同时使用，时间跨度建议小时数不超过24

可选

endTime

string

截止时间:格式yyyy-MM-dd HH:mm:ss，与startTime同时使用，时间跨度建议小时数不超过24

可选

pageNo

Integer

页码

可选

pageSize

Integer

每页多少条，最大支持500，不能小于50

可选

请求示例

示例一： ----------------- ```` { "uniqueCodes":"baolsOpen124,MN-milk%2c439686%2c2%2c1002" } ````

响应参数

参数名

类型

描述

errorList

array

校验失败唯一码列表

waveId

long

波次号

uniqueCode

string

唯一码

sid

long

订单号

errorMsg

string

错误信息

success

boolean

示例：true

trace_id

string

示例：3553483395407017

响应示例

``` { "traceId": "3669319614952014527", "errorList": [ { "uniqueCode": "baolsOpen124", "errorMsg": "该唯一码不存在" }, { "uniqueCode": "MN-milk%2c439686%2c2%2c1002", "waveId": 439686, "errorMsg": "关联订单异常", "sid": 4123793511494333 } ], "hasNext": true, "success": true } ```

异常示例

```` { "code": "25", "msg": "服务方法(erp.wave.unique.code.validate:1.0)的签名无效", "success": false, "trace_id": "3553483395423660" } ````

错误码解释

| 错误信息 |错误码|解决方案| |-|-|-| |资源异常,请联系管理员!|400|检查参数是否合法|| |非法参数!|50|检查参数类型等是否合法|| |唯一码数量最大支持20组!|20029|参数过长||