开发规范

调用说明

本开放平台基于 HTTP 协议开发，用户只需要按照开发规范拼装正确的 URL 以及参数，即可请求成功。

调用入口

https服务器地址
https://scc.litb.cn/

系统级参数

名称	类型	是否必填	描述
token	string	是	用户认证信息，请前往门户权限页面获取
timestamp	long	是	时间戳
businessId	string	是	业务ID

注：所有请求都需要带上系统级参数，系统级参数不区分请求方式，统一使用query parameters方式传递。

示例

https://scc.litb.cn/{具体api}?
token=你的token
&timestamp=发起请求时间戳
&businessId=你的业务id

业务参数

API调用除必须包含公共参数外，如果API本身有业务级的参数也必须传入。

返回值

说明：返回值统一为JSON格式

名称	类型	描述
success	boolean	结果状态，true请求成功，false请求失败
detail	string	错误信息
data	object	如果有额外信息，会通过该属性返回
status	int	错误码

示例：

{ "success": true, "detail": "", "data": 8286, "status": 0 }

错误码

错误码	错误内容	描述
40100	认证失败
40101	没有检查到token
40102	签名校验失败
40103	参数错误	系统参数
40104	业务ID不能为空
40105	时间戳格式错误
40106	时间戳格式错误	请使用当前时间的时间戳
40107	请勿重复提交	并发拒绝
40108	无该接口权限
40109	token无接入权限	token被关闭
40110	token对应账户类型错误	token账户类型不匹配
40001	参数错误	业务参数
10001	错误商家编码,请修改后重试
10002	没有权限操作当前商家编码
10003	在预处理清单处有待处理订单，请先去预处理清单界面处理
10004	部分商品报缺存在异常
10005	超过单次报缺上限
10006	非主供商品不能报缺,请删除后重试
10101	查无此发货单
10102	时间格式错误
10103	超出单次查询个数上限
10104	ExpressId填写错误，参考发货API文档支持的快递公司
10105	预计到货日期格式填写错误，参考yyyy-MM-dd
10106	预计到货日期不能小于当前日期
10107	匹配到错误的商家SKU编码
10108	存在异常状态采购单无法发货，请先到门户处理异常
10109	未查询到需要发货的采购单行
10110	存在多个收货仓库
10111	存在不同收货模式，不能发货
10112	发货数量不能小于1个且不能超过采购数量，不能发货
10113	未填写快递单号，不能发货
10114	已确认发货单，不允许继续添加单行
10115	没有可发货的单行
10116	更新时间必须包含起止时间
10117	只有草稿状态下的发货单才能修改单行数量
10118	存在不属于自己的SKU
10119	不能维护长度超过32的商家SKU编码
10120	部分商家SKU编码维护失败
10121	产品信息不存在
10301	参数存在重复的sku编码
10302	缺少商家sku编码
10303	库存数量必须大于0
10304	缺少库存参数
10305	当前供应商未开启库存管理
10306	库存数量必须大于等于0
10307	不能超过每次最大导入库存数量
10401	配仓每次调用只能配1个采购单行
10402	单行不满足状态或不存在
10403	无商家SKU编码
10404	无现货库存
0	执行成功
-1	服务器内部错误，请稍后重试