跳到主要内容

波次播种回传

接口描述​

波次播种回传，用于将已经播好的商品回传到系统

请求地址​

环境服务地址(HTTP/HTTPS)
V2正式环境（推荐）https://gw.superboss.cc/router

2022年4月1日以后申请的APP Key，统一使用V2正式环境的请求地址：https://gw.superboss.cc/router

公共参数​

调用任何一个API都必须传入的参数，目前支持的公共参数有：

参数名称参数类型是否必须参数描述
methodstring是API接口名称
appKeystring是分配给应用的AppKey
timestampstring是时间戳，时区为GMT+8，例如：2020-09-21 16:58:00。API服务端允许客户端请求最大时间误差为10分钟
formatstring否响应格式。默认为json格式，可选值：json
versionstring是API协议版本 可选值：1.0
sign_methodstring否签名的摘要算法(默认 hmac)，可选值为：hmac，md5，hmac-sha256。
signstring是签名
sessionstring是授权会话信息 （即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)的签名无效签名参数错误