波次播种

websocket测试

POST

请求地址/router

接口描述

波次播种

请求地址

|环境|服务地址(HTTP/HTTPS)| |-|-| |V2正式环境（推荐）| https://gw.superboss.cc/router| **2022年4月1日**以后申请的APP Key，统一使用V2正式环境的请求地址：**https://gw.superboss.cc/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

必填

API接口地址

参数名

类型

描述

必填

method

string

erp.trade.wave.seed

必填

请求参数

参数名

类型

描述

必填

waveId

long

波次号

必填

list

string

播种详情json字符串见示例

必填

jobNum

string

员工工号

必填

请求示例

示例一： ----------------- ```` { "waveId":1111, "list":"[{ "details": [{ "matchedNum": 5, //播种的数量 "outerId": "MN-milk" //商家编码 }], "positionNo": 1 //位置号 }]" } ````

响应参数

参数名

类型

描述

errorList

object

播种异常的信息

positionNo

long

位置号

errorOuterIdList

object

异常的商家编码信息

outerId

string

商品商家编码

unMatchedNum

integer

未正常播种的数量

errorMsg

string

异常信息

success

boolean

示例：true

trace_id

string

示例：3553483395407017

响应示例

``` 播种成功响应： { "traceId": "2475286737140096010", "success": true } 存在异常播种响应： { "traceId": "2475286737140096010", "errorList": [ { "errorOuterIdList": [ { "outerId": "MN-milk", "unMatchedNum": 4 } ], "positionNo": 1, "errorMsg": "位置号1播种数量大于可播数量!" } ], "success": false } ```

异常示例

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

错误码解释

| 错误码 |错误信息|解决方案| |-|-|-| |25|服务方法(erp.trade.multi.packs.query:1.0)的签名无效|签名参数错误|