渠道库存模块

API域名以及签名 统一签名, 此模块路由地址为/open/v6, 旧版本路由可以继续使用

全局响应参数:

参数名称	数据类型	参数说明
code	Integer	0:成功 其他失败
data	Object	返回数据
message	String	错误信息

---

一、渠道库存

1、渠道列表

（1）接口地址:/channel/list

（2）请求方式:POST

（3）请求数据类型:application/json

（4）响应数据类型:application/json

（5）请求参数:

参数名称	数据类型	是否必须	参数说明
codes	String	false	渠道编码
name	String	false	渠道名称
level	Integer	false	等级 1、2、3级
isValid	Integer	false	是否有效 1:是 0:否

（6）请求示例:

{
  "codes": ["ZY"],
  "name": "1111",
  "level": 1,
  "isValid": 1
}

（7）响应参数:

参数名称	数据类型	参数说明
code	Integer	0:成功 其他失败
data	List	渠道信息列表
└ id	Long	渠道id
└ code	String	渠道编码
└ name	String	渠道名称
└ level	Integer	渠道等级 1、2、3级
└ parentId	Long	父级渠道id
└ parentPath	String	渠道父id路径
└ remark	String	备注
└ isValid	Integer	是否有效 1:是 0:否
message	String	错误信息

（8）响应示例:

{
  "code": 0,
  "data": [
    {
      "id": 0,
      "code": "",
      "name": "",
      "level": 0,
      "parentId": 0,
      "parentPath": "",
      "remark": "",
      "isValid": 0
    }
  ],
  "message": ""
}

---

2、渠道子集列表

（1）接口地址:/channel/getSubChannelList

（2）请求方式:GET

（3）请求数据类型:application/x-www-form-urlencoded

（4）响应数据类型:application/json

（5）请求参数:

参数名称	数据类型	是否必须	参数说明
channelId	Long	true	渠道id,查询当前渠道的下一级渠道信息

（6）请求示例:

/channel/getSubChannelList?channelId=

（7）响应参数:

参数名称	数据类型	参数说明
code	Integer	0:成功 其他失败
data	List	渠道信息列表
└ id	Long	渠道id
└ code	String	渠道编码
└ name	String	渠道名称
└ level	Integer	渠道等级 1、2、3级
└ parentId	Long	父级渠道id
└ parentPath	String	渠道id路径
└ remark	String	备注
└ isValid	Integer	是否有效 1:是 0:否
message	String	错误信息

（8）响应示例:

{
  "code": 0,
  "data": [
    {
      "id": 0,
      "code": "",
      "name": "",
      "level": 0,
      "parentId": 0,
      "parentPath": "",
      "remark": "",
      "isValid": 0
    }
  ],
  "message": ""
}

---

3、渠道库存

（1）接口地址:/channel/getMarketableNum

（2）请求方式:POST

（3）请求数据类型:application/json

（4）响应数据类型:application/json

（5）请求参数:

参数名称	数据类型	是否必须	参数说明
skuCode	String	true	sku编码
storeCode	String	false	店铺编码
virtualChannelCode	String	false	虚拟渠道编码
virtualChannelName	String	false	虚拟渠道名称

（6）请求示例:

{
  "skuCode": "6926523402821",
  "storeCode": "",
  "virtualChannelCode": "",
  "virtualChannelName": ""
}

（7）响应参数:

参数名称	数据类型	参数说明
code	Integer	0:成功 其他失败
data	List	渠道库存列表
└ virtualChannelCode	String	虚拟渠道编码
└ virtualChannelName	String	虚拟渠道名称
└ skuCode	String	sku编码
└ skuName	String	sku名称
└ onWayNum	Integer	在途数
└ lockNum	Integer	锁定数
└ marketableNum	Integer	可销数
└ marketableNoLockNum	Integer	可销数（剔除总锁库）
message	String	错误信息

（8）响应示例:

{
  "code": 0,
  "data": [
    {
      "virtualChannelCode": "",
      "virtualChannelName": "",
      "skuCode": "",
      "skuName": "",
      "onWayNum": 0,
      "lockNum": 0,
      "marketableNum": 0
    }
  ],
  "message": ""
}