商品出入库管理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必须为数字。
商品出入库管理API - 货物出库、入库、查询

原文地址: https://www.cveoy.top/t/topic/nTHC 著作权归作者所有。请勿转载和采集!

免费AI点我,无需注册和登录