开发平台后台:https://openapi-stats.pospal.cn 支持ai问答,调用日志等

电话咨询 400-000-7749

QQ咨询

盘点API

更新时间:2018-04-12

1.查询历史盘点记录

2.查询某一盘点记录明细

3.查询某一盘点详情

1. 查询历史盘点记录

参数名	是否必须	类型	说明
接口地址	http://host:port/pospal-api2/openapi/v1/stockTakingOpenApi/queryStockTakingHistories
请求头	User-Agent: openApi Content-Type: application/json; charset=utf-8 accept-encoding: gzip,deflate time-stamp: 1437528688233 data-signature: BF706E6AC693BA3B1BABD32E6713431D
请求方式	POST
请求体	{ "appId": "abcdefghijklmn", "startTime": "2016-09-30 23:59:59", "endTime": "2016-10-31 23:59:59" }
appId	是	String	Pospal配置的访问凭证
startTime	是	String	开始时间，格式为yyyy-MM-dd hh:mm:ss,不包含开始时间
endTime	是	String	结束时间，格式为yyyy-MM-dd hh:mm:ss,包含结束时间 endDate – startDate <=90天
返回结果	{ "status": "success", "messages": [], "data": [ { "id": 8422, "createdDateTime": "2017-09-07 11:47:31", "cashierUid": 832101480292933200, "operateType": 1, "remark": "", "markName": "" } ] }
字段名	类型	说明
status	String	是否正确处理请求，返回success或error，不区分大小写
messages	String[]	处理结果的消息
errorCode	int	业务处理的错误代码,参见错误代码表
id	int	盘点记录ID
createdDateTime	String	盘点记录创建时间
cashierUid	long	收银员uid
operateType	BigDecimal	盘点方式：1 明盘;0或2 暗盘。
remark	String	盘点备注
markName	String	标记名称==》如标识货架等

2. 查询某一盘点记录明细

参数名	是否必须	类型	说明
接口地址	http://host:port/pospal-api2/openapi/v1/stockTakingOpenApi/queryStockTakingItems
请求头	User-Agent: openApi Content-Type: application/json; charset=utf-8 accept-encoding: gzip,deflate time-stamp: 1437528688233 data-signature: BF706E6AC693BA3B1BABD32E6713431D
请求方式	POST
请求体	{ "appId": "abcdefghijklmn", "stockTakingId": 8422 }
appId	是	String	Pospal配置的访问凭证
stockTakingId	是	int	盘点记录ID
返回结果	{ "status": "success", "messages": [], "data": [ { "stockTakingId": 8422, "productUid": 242258285416665380, "oldStock": 66, "newStock": 30, "buyPrice": 2, "sellPrice": 15, "losePrice": 2, "takingStock": 10, "takingStockUnitUid": 1500947506799175400 } ] }
字段名	类型	说明
status	String	是否正确处理请求，返回success或error，不区分大小写
messages	String[]	处理结果的消息
errorCode	int	业务处理的错误代码,参见错误代码表
stockTakingId	int	盘点记录id
productUid	long	商品唯一标识
oldStock	int	盘点前库存（基准单位）
newStock	int	盘点后库存（基准单位）
buyPrice	BigDecimal	进货价
sellPrice	BigDecimal	销售价
losePrice	BigDecimal	亏损价
takingStock	int	盘点时的库存量==》结合盘点单位使用
takingStockUnitUid	long	盘点单位

3. 查询某一盘点详情

参数名	是否必须	类型	说明
接口地址	http://host:port/pospal-api2/openapi/v1/stockTakingOpenApi/queryStockTakingDetailsById
请求头	User-Agent: openApi Content-Type: application/json; charset=utf-8 accept-encoding: gzip,deflate time-stamp: 1437528688233 data-signature: BF706E6AC693BA3B1BABD32E6713431D
请求方式	POST
请求体	{ "appId": "abcdefghijklmn", "stockTakingId": 8422 }
appId	是	String	Pospal配置的访问凭证
stockTakingId	是	int	盘点记录ID
返回结果	{ "status": "success", "messages": [], "data": { "id": 8422, "createdDateTime": "2017-09-07 11:47:31", "cashierUid": 832101480292933200, "operateType": 1, "remark": "", "markName": "", "items": [{ "stockTakingId": 8422, "productUid": 293529870988965885, "oldStock": 123.000, "newStock": 123.000, "buyPrice": 2.00, "sellPrice": 12.00, "losePrice": 2.00 }, { "stockTakingId": 8422, "productUid": 74308856246946452, "oldStock": -217.700, "newStock": -217.700, "buyPrice": 13.85, "sellPrice": 20.00, "losePrice": 13.85 }] } }
字段名	类型	说明
status	String	是否正确处理请求，返回success或error，不区分大小写
messages	String[]	处理结果的消息
errorCode	int	业务处理的错误代码,参见错误代码表
id	int	盘点记录ID
createdDateTime	String	盘点记录创建时间
cashierUid	long	收银员uid
operateType	BigDecimal	盘点方式：1 明盘;0或2 暗盘。
remark	String	盘点备注
markName	String	标记名称==》如标识货架等
items	数组	盘点明细列表，详情请见查询某一盘点记录明细