仓库
字段可选
M：must 必填
O：optional 选填
C: conditional 某些条件下必选
全部仓库
接口名
/warehouse/ware_category
Method
GET
请求
无
响应
code M int 返回码，0表示成功，其他表示错误
msg M string 错误信息
data M string 返回json数据
[
{
"name" M string 仓库名
"child": [{ O list 仓库下的库区
"name" M string 库区名
"child": [{ O list 库区下的库位
"name" M string 库位名
"child": [{ O list 库位下的通道
"name" M string 通道名
"id" M string 通道ID
"level" M int 仓库分类级别（1:仓库;2:库区;3:库位;4:通道）
"type" M int 仓库类别（1:公库;2:私库）
}],
"id" M string 库位ID
"level" M int 仓库分类级别（1:仓库;2:库区;3:库位;4:通道）
"type" M int 仓库类别（非通道级别暂无区别，都为1公库）
}],
"id" M string 库位ID
"level" M int 仓库分类级别（1:仓库;2:库区;3:库位;4:通道）
"type" M int 仓库类别（非通道级别暂无区别，都为1公库）
}],
"id" M string 仓库ID
"level" M int 仓库分类级别（1:仓库;2:库区;3:库位;4:通道）
"type" M int 仓库类别（非通道级别暂无区别，都为1公库）
}
]
示例
request
http://test.guanmai.cn:8888/warehouse/ware_category
response
{
"data": [{
"name": "A1",
"child": [{
"name": "B12",
"child": [{
"name": "C13",
"child": [{
"name": "D12",
"id": "WD000267",
"level": 4,
"type": 1
}],
"id": "WC000242",
"level": 3,
"type": 1
}],
"id": "WB000239",
"level": 2,
"type": 1
}],
"id": "WA000001",
"level": 1,
"type": 1
}],
"code": 0,
"msg": "ok"
}
可入库的仓库（有绑定客户合同的才可以入库）
接口名
/warehouse/ware_category/can_stock_in
Method
GET
请求
customer_id M string 客户ID
响应
code M int 返回码，0表示成功，其他表示错误
msg M string 错误信息
data M string 返回json数据
[
{
"name" M string 仓库名
"child": [{ O list 仓库下的库区
"name" M string 库区名
"child": [{ O list 库区下的库位
"name" M string 库位名
"child": [{ O list 库位下的通道
"name" M string 通道名
"id" M string 通道ID
"level" M int 仓库分类级别（1:仓库;2:库区;3:库位;4:通道）
"type" M int 仓库类别（1:公库;2:私库）
}],
"id" M string 库位ID
"level" M int 仓库分类级别（1:仓库;2:库区;3:库位;4:通道）
"type" M int 仓库类别（非通道级别暂无区别，都为1公库）
}],
"id" M string 库位ID
"level" M int 仓库分类级别（1:仓库;2:库区;3:库位;4:通道）
"type" M int 仓库类别（非通道级别暂无区别，都为1公库）
}],
"id" M string 仓库ID
"level" M int 仓库分类级别（1:仓库;2:库区;3:库位;4:通道）
"type" M int 仓库类别（非通道级别暂无区别，都为1公库）
}
]
示例
request
http://test.guanmai.cn:8888/warehouse/ware_category/can_stock_in?customer_id=K0001
response
{
"data": [{
"name": "A1",
"child": [{
"name": "B12",
"child": [{
"name": "C13",
"child": [{
"name": "D12",
"id": "WD000267",
"level": 4,
"type": 1
}],
"id": "WC000242",
"level": 3,
"type": 1
}],
"id": "WB000239",
"level": 2,
"type": 1
}],
"id": "WA000001",
"level": 1,
"type": 1
}],
"code": 0,
"msg": "ok"
}
可调货的仓库（目前只能公库转当前仓库的其它通道）
接口名
/warehouse/ware_category/can_move_in
Method
GET
请求
batch_id M string 批次号
响应
code M int 返回码，0表示成功，其他表示错误
msg M string 错误信息
data M string 返回json数据
[
{
"name" M string 仓库名
"child": [{ O list 仓库下的库区
"name" M string 库区名
"child": [{ O list 库区下的库位
"name" M string 库位名
"child": [{ O list 库位下的通道
"name" M string 通道名
"id" M string 通道ID
"level" M int 仓库分类级别（1:仓库;2:库区;3:库位;4:通道）
"type" M int 仓库类别（1:公库;2:私库）
}],
"id" M string 库位ID
"level" M int 仓库分类级别（1:仓库;2:库区;3:库位;4:通道）
"type" M int 仓库类别（非通道级别暂无区别，都为1公库）
}],
"id" M string 库位ID
"level" M int 仓库分类级别（1:仓库;2:库区;3:库位;4:通道）
"type" M int 仓库类别（非通道级别暂无区别，都为1公库）
}],
"id" M string 仓库ID
"level" M int 仓库分类级别（1:仓库;2:库区;3:库位;4:通道）
"type" M int 仓库类别（非通道级别暂无区别，都为1公库）
}
]
示例
request
http://test.guanmai.cn:8888/warehouse/ware_category/can_move_in?batch_id=123-1
response
{
"data": [{
"name": "A1",
"child": [{
"name": "B12",
"child": [{
"name": "C13",
"child": [{
"name": "D12",
"id": "WD000267",
"level": 4,
"type": 1
}],
"id": "WC000242",
"level": 3,
"type": 1
}],
"id": "WB000239",
"level": 2,
"type": 1
}],
"id": "WA000001",
"level": 1,
"type": 1
}],
"code": 0,
"msg": "ok"
}
可供绑定合同的公库仓库
接口名
/warehouse/ware_category/contract/share
Method
GET
请求
无
响应
code M int 返回码，0表示成功，其他表示错误
msg M string 错误信息
data M string 返回json数据
[{
"name" M string 仓库名
"level" M int 这里目前都为1
"id" M string 仓库ID
}]
示例
request
http://test.guanmai.cn:8888/warehouse/ware_category/contract/share
response
{
"data": [{
"name": "A1",
"level": 1,
"id": "WA000001"
}],
"code": 0,
"msg": "ok"
}
可供绑定合同的私库通道
接口名
/warehouse/ware_category/contract/private
Method
GET
请求
无
响应
code M int 返回码，0表示成功，其他表示错误
msg M string 错误信息
data M string 返回json数据
[
{
"name" M string 仓库名
"child": [{ O list 仓库下的库区
"name" M string 库区名
"child": [{ O list 库区下的库位
"name" M string 库位名
"child": [{ O list 库位下的通道
"name" M string 通道名
"id" M string 通道ID
"level" M int 仓库分类级别（1:仓库;2:库区;3:库位;4:通道）
"type" M int 仓库类别，这里统一为2（私库）
}],
"id" M string 库位ID
"level" M int 仓库分类级别（1:仓库;2:库区;3:库位;4:通道）
"type" M int 仓库类别（非通道级别暂无区别，都为1公库）
}],
"id" M string 库位ID
"level" M int 仓库分类级别（1:仓库;2:库区;3:库位;4:通道）
"type" M int 仓库类别（非通道级别暂无区别，都为1公库）
}],
"id" M string 仓库ID
"level" M int 仓库分类级别（1:仓库;2:库区;3:库位;4:通道）
"type" M int 仓库类别（非通道级别暂无区别，都为1公库）
}
]
示例
request
http://test.guanmai.cn:8888/warehouse/ware_category/contract/private
response
{
"data": [{
"name": "A1",
"child": [{
"name": "B12",
"child": [{
"name": "C13",
"child": [{
"name": "D12",
"id": "WD000267",
"level": 4,
"type": 2
}],
"id": "WC000242",
"level": 3,
"type": 1
}],
"id": "WB000239",
"level": 2,
"type": 1
}],
"id": "WA000001",
"level": 1,
"type": 1
}],
"code": 0,
"msg": "ok"
}
编辑仓库分类（编辑的逻辑是先删除再添加）
接口名
/warehouse/ware_category/edit
Method
POST
请求
"id" M string 仓库分类ID
"name" O string 仓库分类名
"type" O int 仓库类别（1:公库;2:私库）
响应
code M int 返回码，0表示成功，其他表示错误
msg M string 错误信息
data M string 返回改变了的所有仓库分类
这里返回的仓库分类级数会根据修改的仓库分类具体级别变动，这里以修改了库位为例
修改库位会修改其下所有的通道，这里会返回新的库位及其下的所有通道
"name" M string 库位名
"child": [{ O list 库位下的通道
"name" M string 通道名
"id" M string 通道ID
"level" M int 仓库分类级别（1:仓库;2:库区;3:库位;4:通道）
"type" M int 仓库类别（1:公库;2:私库）
}],
"id" M string 库位ID
"level" M int 仓库分类级别（1:仓库;2:库区;3:库位;4:通道）
"type" M int 仓库类别（非通道级别暂无区别，都为1公库）
示例
request
http://test.guanmai.cn:8888/warehouse/ware_category/edit
form-data
id: WC0001
name: "141"
response
{
"data": {
"child": [{
"child": [],
"name": "13131",
"level": 4,
"id": "WD000993"
}],
"name": "141",
"level": 3,
"id": "WC000994"
},
"code": 0,
"msg": "ok"
}
添加仓库分类
接口名
/warehouse/ware_category/create
Method
POST
请求
"parent_id" M string 父仓库分类ID，如果是添加仓库，传""
"name" M string 仓库分类名
"type" O int 仓库类别（1:公库;2:私库）
响应
code M int 返回码，0表示成功，其他表示错误
msg M string 错误信息
data M string 返回仓库分类ID
示例
request
http://test.guanmai.cn:8888/warehouse/ware_category/create
form-data
parent_id: WC0001
name: "141"
response
{
"data": "WD001",
"code": 0,
"msg": "ok"
}
删除仓库分类
接口名
/warehouse/ware_category/delete
Method
POST
请求
"id" M string 仓库分类ID
响应
code M int 返回码，0表示成功，其他表示错误
msg M string 错误信息
data M string 空
示例
request
http://test.guanmai.cn:8888/warehouse/ware_category/delete
form-data
id: WC0001
response
{
"data": "",
"code": 0,
"msg": "ok"
}
仓库分类基础信息
接口名
/warehouse/ware_category/base_info
Method
GET
请求
无
响应
code M int 返回码，0表示成功，其他表示错误
msg M string 错误信息
data M string 基础信息
示例
request
127.0.0.1:8888/warehouse/ware_category/base_info
response
{
"data": {
"type": {
"SHARE": 1,
"PRIVATE": 2
}
},
"code": 0,
"msg": "ok"
}