# 其他出入库管理

其他出入库管理分类提供其他出入库单类型查询、单据查询和创建接口，共 **3** 个API。

---

## 接口列表

| 序号 | 接口名称 | Method | 说明 |
|------|----------|--------|------|
| 1 | [其他出入库单类型查询](#1-其他出入库单类型查询) | `foonsu.erp.stockOtherOrders.listType` | 查询出入库类型 |
| 2 | [其他出入库单查询](#2-其他出入库单查询) | `foonsu.erp.stockOtherOrders.list` | 查询出入库单 |
| 3 | [其他出入库单创建](#3-其他出入库单创建) | `foonsu.erp.stockOtherOrders.save` | 创建出入库单 |

---

## 1. 其他出入库单类型查询

**Method：** `foonsu.erp.stockOtherOrders.listType`

**请求方式：** POST

**简要描述：** 查询其他出入库单类型

### 请求参数

| 参数名 | 必选 | 类型 | 说明 |
|--------|------|------|------|
| pageIndex | 否 | Integer | 当前页码 |
| pageSize | 否 | Integer | 默认 20，最大不超过 50 |
| type | 否 | String | 单据类型：0-其他入库单；1-其他出库单 |
| status | 否 | String | 状态：0-启用；1-禁用 |

### data(List)返回参数

| 参数名 | 类型 | 说明 |
|--------|------|------|
| type | String | 类型编码 |
| id | Long | 类型ID |
| othersName | String | 类型名称 |
| status | String | 状态：0-启用；1-禁用 |
| remark | String | 备注 |

---

## 2. 其他出入库单查询

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

**请求方式：** POST

**简要描述：** 查询其他出入库单

### 请求参数

| 参数名 | 必选 | 类型 | 说明 |
|--------|------|------|------|
| pageIndex | 否 | Integer | 第几页，从1开始，默认1 |
| pageSize | 否 | Integer | 默认20，最大不超过50 |
| stockOtherOrdersNoList | 否 | List[String] | 其他出入库单号列表 |
| outStockOtherOrdersNoList | 否 | List[String] | 外部单号列表 |
| beginDate | 否 | Date | 起始时间 |
| endDate | 否 | Date | 结束时间 |
| timeType | 否 | String | 时间类型：1-创建时间；2-修改时间 |
| type | 否 | String | 类型 |
| status | 否 | String | 状态 |

### data(List)返回参数

| 参数名 | 类型 | 说明 |
|--------|------|------|
| stockOtherOrdersId | Long | 单据ID |
| stockOtherOrdersNo | String | 单据编号 |
| type | String | 类型 |
| typeName | String | 类型名称 |
| warehouseName | String | 仓库名称 |
| totalQuantity | BigDecimal | 总数量 |
| totalAmount | BigDecimal | 总金额 |
| createDate | Date | 创建时间 |
| status | String | 状态 |
| remark | String | 备注 |
| outOrderNo | String | 外部单号 |
| stockOtherOrdersGoodsList | List[Object] | 商品明细列表 |

### 返回示例

```json
{
  "errorCode": null,
  "msg": "操作成功",
  "data": {
    "total": 3,
    "data": [
      {
        "stockOtherOrdersId": 123,
        "stockOtherOrdersNo": "QTCK202001010001",
        "type": "1",
        "typeName": "盘亏出库",
        "warehouseName": "主仓库",
        "totalQuantity": 10,
        "totalAmount": 100.00,
        "createDate": "2020-01-01 12:00:00",
        "status": "1",
        "remark": "",
        "outOrderNo": "EXT202001010001",
        "stockOtherOrdersGoodsList": [
          {
            "goodsId": 456,
            "goodsCode": "SP001",
            "goodsName": "测试商品",
            "quantity": 10,
            "price": 10.00,
            "amount": 100.00,
            "batchNo": "B20200101",
            "productionDate": "2020-01-01",
            "validDays": 365
          }
        ]
      }
    ]
  },
  "date": null,
  "version": null,
  "success": true
}
```

---

## 3. 其他出入库单创建

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

**请求方式：** POST

**简要描述：** 创建其他出入库单

### 请求参数

| 参数名 | 必选 | 类型 | 说明 |
|--------|------|------|------|
| warehouseId | 是 | Long | 仓库ID |
| type | 是 | String | 单据类型：0-其他入库单；1-其他出库单 |
| stockDate | 是 | Date | 出入库日期 |
| othersTypeId | 是 | Long | 出入库类型ID |
| outStockOthersOrderNo | 否 | String | 外部系统单号 |
| shopId | 否 | Long | 店铺ID（其他出库单选填） |
| reamrk | 否 | String | 单据备注 |
| providerName | 否 | String | 供应商名称 |
| cancel | 否 | String | 取消订单：0-否；1-是 |
| stockOtherOrdersGoodsList | 是 | List[Object] | 商品明细列表 |

### stockOtherOrdersGoodsList 参数

| 参数名 | 必选 | 类型 | 说明 |
|--------|------|------|------|
| goodsCode | 是 | String | 商品编码 |
| quantity | 是 | BigDecimal | 数量 |
| remark | 否 | String | 备注 |
| price | 否 | BigDecimal | 单价 |
| externalPrice | 否 | String | 外部价格 |