# 盘点管理

盘点管理分类提供盘点单创建和查询接口，共 **2** 个API。

---

## 接口列表

| 序号 | 接口名称 | Method | 说明 |
|------|----------|--------|------|
| 1 | [盘点单创建](#1-盘点单创建) | `foonsu.erp.stockCheckOrder.save` | 创建盘点单 |
| 2 | [盘点单查询](#2-盘点单查询) | `foonsu.erp.stockCheckOrder.list` | 查询盘点单 |

---

## 1. 盘点单创建

**Method：** `foonsu.erp.stockCheckOrder.save`

**请求方式：** POST

**简要描述：** 创建盘点单

### 请求参数

| 参数名 | 必选 | 类型 | 说明 |
|--------|------|------|------|
| warehouseId | 是 | Long | 仓库ID |
| checkDate | 是 | Date | 盘点日期 |
| outOrderNo | 否 | String | 外部系统盘点单号 |
| remark | 否 | String | 备注 |
| stockCheckOrderGoodsList | 是 | List[Object] | 盘点单商品明细列表，最大50 |

### stockCheckOrderGoodsList 请求参数

| 参数名 | 必选 | 类型 | 说明 |
|--------|------|------|------|
| goodsCode | 是 | String | 商品编码 |
| skCount | 是 | BigDecimal | 盘点数量 |

### 返回参数

data 为 null，成功返回 `"success": true`。

### 请求示例

```json
{
    "warehouseId": 9000000000001253,
    "checkDate": "2021-06-20 11:11:11",
    "remark": "备注xxx",
    "stockCheckOrderGoodsList": [{
        "goodsCode": "111",
        "skCount": 10
    }, {
        "goodsCode": "8012882331",
        "skCount": 22
    }, {
        "goodsCode": "bj001",
        "skCount": 65
    }],
    "outOrderNo": "outso123"
}
```

---

## 2. 盘点单查询

**Method：** `foonsu.erp.stockCheckOrder.list`

**请求方式：** POST

**简要描述：** 查询盘点单

### 请求参数

| 参数名 | 必选 | 类型 | 说明 |
|--------|------|------|------|
| pageIndex | 否 | Integer | 当前页码 |
| pageSize | 否 | Integer | 默认 20，最大不超过 50 |
| stockCheckOrderNoList | 否 | List[String] | 指定盘点单号（ERP系统单号），最多20，和时间段不能同时为空 |
| outStockCheckOrderNoList | 否 | List[String] | 指定盘点单号（外部系统盘点单号），最多20，和时间段不能同时为空 |
| beginDate | 否 | Date | 创建起始时间，和结束时间必须同时存在，时间间隔不能超过7天，和盘点单号不能同时为空 |
| endDate | 否 | Date | 创建结束时间，和起始时间必须同时存在，时间间隔不能超过7天，和盘点单号不能同时为空 |
| checkStatus | 否 | String | 状态：0-未审核；1-已审核；9-作废 |

### data(Object)返回参数

| 参数名 | 类型 | 说明 |
|--------|------|------|
| total | Integer | 记录总数 |
| data | List[Object] | 集合参数响应 |

### data(List)返回参数

| 参数名 | 类型 | 说明 |
|--------|------|------|
| orderNo | String | ERP系统盘点单号 |
| outOrderNo | String | 外部系统盘点单号 |
| warehouseId | Long | 仓库ID |
| warehouseName | String | 仓库名称 |
| createDate | Date | 创建时间 |
| stockDate | Date | 盘点时间 |
| statusDate | Date | 审核时间 |
| creator | String | 创建人 |
| statusUser | String | 审核人 |
| status | String | 状态：0-未审核；1-已审核；9-作废 |
| remark | String | 备注 |
| stockCheckCount | BigDecimal | 盘点数量 |
| stockCheckOrdersGoodsList | List[Object] | 库存盘点单商品集合 |

### stockCheckOrdersGoodsList 响应参数

| 参数名 | 类型 | 说明 |
|--------|------|------|
| goodsCode | String | 商品编码 |
| goodsName | String | 商品名称 |
| goodsSpecs | String | 规格名称 |
| skCount | BigDecimal | 盘点数量 |
| remark | String | 备注 |
| stockCheckOrdersGoodsBatchList | List[Object] | 库存盘点单商品批次集合 |

### stockCheckOrdersGoodsBatchList 响应参数

| 参数名 | 类型 | 说明 |
|--------|------|------|
| batchNo | String | 批次号/唯一码 |
| skCount | BigDecimal | 盘点数量 |