跳到主要内容

商品唯一码更新

系统相关界面​

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

请求地址​

环境服务地址(HTTP/HTTPS)
V2正式环境（推荐）https://gw.superboss.cc/router
V2测试环境https://gw3.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;charset=UTF-8
必填

API接口地址​

全部展开
参数名
类型
描述
必填
method
string
erp.item.unique.code.update
必填

请求参数​

全部展开
参数名
类型
描述
必填
默认值
generateParams
string
入参json字符串
必填

请求示例​

示例一：

[
    {
        "uniqueCode": "YS001%2c000371",  // 唯一码 必传
        "extendField2": "extendField2",  // 扩展字段2
        "extendField3": "extendField3",  // 扩展字段3
        "extendField4": "extendField4",  // 扩展字段4
        "extendField5": "extendField5",  // 扩展字段5
        "ICCID": "ICCID"  // 扩展字段1
    }
]

响应参数​

全部展开
参数名
类型
描述
必填
list
array
唯一码列表
uniqueCode
string
唯一码
extendField2
string
扩展字段2
extendField3
string
扩展字段3
extendField4
string
扩展字段4
extendField5
string
扩展字段5
ICCID
string
扩展字段1
success
boolean
示例：true
trace_id
string
示例：3553483395407017

响应示例​

{
    "traceId": "3668774785566822984",
    "success": true,
    "list": [
        {
        "uniqueCode": "YS001%2c000371",  
        "extendField2": "extendField2",  
        "extendField3": "extendField3", 
        "extendField4": "extendField4",  
        "extendField5": "extendField5",  
        "ICCID": "ICCID"  
    }
    ]
}

异常示例​

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

错误码解释​

错误信息错误码解决方案
资源异常,请联系管理员!400检查参数是否合法
非法参数!50检查参数类型等是否合法
系统订单号数量最大支持20组！20003参数过长
内部单号数量最大支持20组！20005参数过长
售后单号数量最大支持20组！20006参数过长
唯一码类型不合法！[1（单）；2（多）；3（备）]50枚举值不合法
是否查询总数枚举值不合法！[true/false]50枚举值不合法
系统订单号格式不正确！20009检查参数是否合法
内部订单号格式不正确20011检查参数是否合法
售后单号格式不正确20012检查参数是否合法