商品出入库管理API - 货物出库、入库、查询
商品出入库管理API
该API提供商品出入库管理功能,包括货物出库、入库、查询出入库记录等操作。
1. 货物出库
接口地址: /stockRecordManage/stockOut
请求方式: POST
请求参数:
| 参数名称 | 类型 | 说明 | 是否必填 | |---|---|---|---| | customerID | Integer | 客户ID | 是 | | goodsID | Integer | 货物ID | 是 | | repositoryID | String | 仓库ID | 否 | | number | long | 出库数量 | 是 |
返回数据:
{
"result": "success|error",
"msg": "操作结果信息"
}
示例:
{
"customerID": 1,
"goodsID": 10,
"repositoryID": "1",
"number": 100
}
2. 货物入库
接口地址: /stockRecordManage/stockIn
请求方式: POST
请求参数:
| 参数名称 | 类型 | 说明 | 是否必填 | |---|---|---|---| | supplierID | Integer | 供应商ID | 是 | | goodsID | Integer | 货物ID | 是 | | repositoryID | String | 仓库ID | 否 | | number | long | 入库数量 | 是 |
返回数据:
{
"result": "success|error",
"msg": "操作结果信息"
}
示例:
{
"supplierID": 2,
"goodsID": 12,
"repositoryID": "2",
"number": 200
}
3. 查询出入库记录
接口地址: /stockRecordManage/searchStockRecord
请求方式: GET
请求参数:
| 参数名称 | 类型 | 说明 | 是否必填 | |---|---|---|---| | searchType | String | 查询类型(all: 查询所有记录, in: 仅查询入库记录, out: 仅查询出库记录) | 是 | | repositoryID | String | 仓库ID | 否 | | startDate | String | 查询起始日期 (YYYY-MM-DD) | 否 | | endDate | String | 查询结束日期 (YYYY-MM-DD) | 否 | | limit | int | 分页大小 | 是 | | offset | int | 分页偏移值 | 是 |
返回数据:
{
"result": "success|error",
"msg": "操作结果信息",
"rows": [], // 记录数据列表
"total": 0 // 总记录数
}
示例:
{
"searchType": "all",
"repositoryID": "1",
"startDate": "2023-01-01",
"endDate": "2023-01-31",
"limit": 10,
"offset": 0
}
4. 权限校验
该API支持权限校验,只有拥有相应权限的用户才能进行操作。
- systemAdmin:系统管理员拥有所有权限;
- 其他角色:只能操作自己负责的仓库。
5. 注意事项
- 仓库ID参数为可选参数,若不填写则默认为用户负责的仓库。
- 日期格式应为 YYYY-MM-DD。
- 分页参数limit和offset必须为数字。
原文地址: https://www.cveoy.top/t/topic/nTHC 著作权归作者所有。请勿转载和采集!