haha/qdb-sdk/07-其他出入库管理.md

其他出入库管理

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

---

接口列表

序号	接口名称	Method	说明
1	其他出入库单类型查询	foonsu.erp.stockOtherOrders.listType	查询出入库类型
2	其他出入库单查询	foonsu.erp.stockOtherOrders.list	查询出入库单
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]	商品明细列表

返回示例

{
  "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	外部价格