# 仓库API

# 创建仓库

接口地址:/api/open/v2/warehouses/create

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

请求示例:

{
  "body": {
    "code": "",
    "name": "",
    "staffCodes": [],
    "warehouseType": 0
  }
}

请求参数:

参数名称	参数说明	请求类型	是否必须	数据类型	schema
warehouseSaveParamRequestParameter	warehouseSaveParamRequestParameter	body	true	RequestParameter«WarehouseSaveParam»	RequestParameter«WarehouseSaveParam»
body			false	WarehouseSaveParam	WarehouseSaveParam
code	编码		false	string
name	名称		false	string
staffCodes	负责员工编码		false	array	string
warehouseType	仓库类型 1 普通仓库，2 线边仓,可用值:1,2		false	integer

响应状态:

状态码	说明	schema
200	OK	BaseResponse
201	Created
401	Unauthorized
403	Forbidden
404	Not Found

响应参数:

参数名称	参数说明	类型	schema
code		integer(int32)	integer(int32)
message		string

响应示例:

{
	"code": 0,
	"message": ""
}

# 删除仓库

接口地址:/api/open/v2/warehouses/delete

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

请求示例:

{
  "body": ""
}

请求参数:

参数名称	参数说明	请求类型	是否必须	数据类型	schema
code	code	body	true	RequestParameter«string»	RequestParameter«string»
body			false	string

响应状态:

状态码	说明	schema
200	OK	BaseResponse
201	Created
401	Unauthorized
403	Forbidden
404	Not Found

响应参数:

参数名称	参数说明	类型	schema
code		integer(int32)	integer(int32)
message		string

响应示例:

{
	"code": 0,
	"message": ""
}

# 查询仓库列表

接口地址:/api/open/v2/warehouses/query

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

请求示例:

{
  "body": {
    "code": "",
    "codeLike": "",
    "name": "",
    "nameLike": "",
    "names": [],
    "pagingParam": {
      "length": 0,
      "start": 0
    }
  }
}

请求参数:

参数名称	参数说明	请求类型	是否必须	数据类型	schema
queryParamRequestParameter	queryParamRequestParameter	body	true	RequestParameter«WarehouseQueryParam»	RequestParameter«WarehouseQueryParam»
body			false	WarehouseQueryParam	WarehouseQueryParam
code	编码完全匹配		false	string
codeLike	编码模糊匹配		false	string
name	名称完全匹配		false	string
nameLike	名称模糊匹配		false	string
names	名称列表匹配		false	array	string
pagingParam			false	PagingParam	PagingParam
length			false	integer
start			false	integer

响应状态:

状态码	说明	schema
200	OK	ListPagingResponse«WarehouseDTO»
201	Created
401	Unauthorized
403	Forbidden
404	Not Found

响应参数:

参数名称	参数说明	类型	schema
code		integer(int32)	integer(int32)
data		ListPagingResponseData«WarehouseDTO»	ListPagingResponseData«WarehouseDTO»
length		integer(int32)
list		array	WarehouseDTO
code	编码	string
isSystemDefault		integer
name	名称	string
staffs	负责员工编码	array	StaffDTO
code	编码	string
name	名称	string
warehouseType	仓库类型 1 普通仓库，2 线边仓， 3 待检仓， 4 报废仓	integer
recordsTotal		integer(int32)
start		integer(int32)
message		string

响应示例:

{
	"code": 0,
	"data": {
		"length": 0,
		"list": [
			{
				"code": "",
				"isSystemDefault": 0,
				"name": "",
				"staffs": [
					{
						"code": "",
						"name": ""
					}
				],
				"warehouseType": 0
			}
		],
		"recordsTotal": 0,
		"start": 0
	},
	"message": ""
}

# 修改仓库详情

接口地址:/api/open/v2/warehouses/update

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

请求示例:

{
  "body": {
    "code": "",
    "name": "",
    "staffCodes": [],
    "warehouseType": 0
  }
}

请求参数:

参数名称	参数说明	请求类型	是否必须	数据类型	schema
warehouseSaveParamRequestParameter	warehouseSaveParamRequestParameter	body	true	RequestParameter«WarehouseSaveParam»	RequestParameter«WarehouseSaveParam»
body			false	WarehouseSaveParam	WarehouseSaveParam
code	编码		false	string
name	名称		false	string
staffCodes	负责员工编码		false	array	string
warehouseType	仓库类型 1 普通仓库，2 线边仓,可用值:1,2		false	integer

响应状态:

状态码	说明	schema
200	OK	BaseResponse
201	Created
401	Unauthorized
403	Forbidden
404	Not Found

响应参数:

参数名称	参数说明	类型	schema
code		integer(int32)	integer(int32)
message		string

响应示例:

{
	"code": 0,
	"message": ""
}

# 创建更新仓库

接口地址:/api/open/v2/warehouses/upsert

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

请求示例:

{
  "body": {
    "code": "",
    "name": "",
    "staffCodes": [],
    "warehouseType": 0
  }
}

请求参数:

参数名称	参数说明	请求类型	是否必须	数据类型	schema
warehouseSaveParamRequestParameter	warehouseSaveParamRequestParameter	body	true	RequestParameter«WarehouseSaveParam»	RequestParameter«WarehouseSaveParam»
body			false	WarehouseSaveParam	WarehouseSaveParam
code	编码		false	string
name	名称		false	string
staffCodes	负责员工编码		false	array	string
warehouseType	仓库类型 1 普通仓库，2 线边仓,可用值:1,2		false	integer

响应状态:

状态码	说明	schema
200	OK	BaseResponse
201	Created
401	Unauthorized
403	Forbidden
404	Not Found

响应参数:

参数名称	参数说明	类型	schema
code		integer(int32)	integer(int32)
message		string

响应示例:

{
	"code": 0,
	"message": ""
}

# 库位API

# 批量创建库位

接口地址:/api/open/v2/warehouseBin/batch/create

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

请求示例:

{
  "body": [
    {
      "nodeValues": [],
      "warehouseCode": ""
    }
  ]
}

请求参数:

参数名称	参数说明	请求类型	是否必须	数据类型	schema
parameter	parameter	body	true	RequestParameter«List«WarehouseBinSaveParam»»	RequestParameter«List«WarehouseBinSaveParam»»
body			false	array	WarehouseBinSaveParam
nodeValues	库位信息，库位长度最大为5		false	array	string
warehouseCode	仓库编码		false	string

响应状态:

状态码	说明	schema
200	OK	BaseResponse
201	Created
401	Unauthorized
403	Forbidden
404	Not Found

响应参数:

参数名称	参数说明	类型	schema
code		integer(int32)	integer(int32)
message		string

响应示例:

{
	"code": 0,
	"message": ""
}

# 创建库位

接口地址:/api/open/v2/warehouseBin/create

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

请求示例:

{
  "body": {
    "nodeValues": [],
    "warehouseCode": ""
  }
}

请求参数:

参数名称	参数说明	请求类型	是否必须	数据类型	schema
parameter	parameter	body	true	RequestParameter«WarehouseBinSaveParam»	RequestParameter«WarehouseBinSaveParam»
body			false	WarehouseBinSaveParam	WarehouseBinSaveParam
nodeValues	库位信息，库位长度最大为5		false	array	string
warehouseCode	仓库编码		false	string

响应状态:

状态码	说明	schema
200	OK	BaseResponse
201	Created
401	Unauthorized
403	Forbidden
404	Not Found

响应参数:

参数名称	参数说明	类型	schema
code		integer(int32)	integer(int32)
message		string

响应示例:

{
    "code": 0,
        "message": ""
}

← 企业地址 API 计划 API →