haha/qdb-sdk/08-盘点管理.md

盘点管理

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

---

接口列表

序号	接口名称	Method	说明
1	盘点单创建	foonsu.erp.stockCheckOrder.save	创建盘点单
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。

请求示例

{
    "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	盘点数量