## 接口说明
QueryCurrentStocksByCondition 是 YonBIP 供应链云(scm 域)提供的现存量(实时库存)查询接口,返回物料在指定库存组织、仓库下的结存数量、可用数量等维度数据。与报表中心的"现存量查询"取数口径一致,适合作为库存一盘货与智能补货的库存底账。
### 请求要点
1. POST + application/json,access_token 放 URL query。
2. 分页参数 pageIndex/pageSize;条件参数常用:库存组织(org)、仓库(warehouse)、物料编码(product)、是否显示零结存等,具体条件名以租户接口文档为准。
3. 现存量同样是快照数据,无修改时间游标;建议定时全量拉取,在轻易云内做快照 diff 后再向电商中台、门店系统下发差异量。
4. 可用量口径需与业务确认:现存量 - 预留/锁定量的可用数才是可售口径,避免直接把结存量同步到销售端造成超卖。
### 典型链路
YonBIP 现存量 → 轻易云快照比对 → 聚水潭/旺店通分仓可售库存 → 各电商平台库存回写;同时作为安全库存预警与补货建议的输入。
### 与库存台账的核对
现存量接口数据来源于库存台账的实时汇总,若与库存管理报表存在差异,先检查是否存在未审核的出入库单据(受“修改现存量时点”参数影响);跨期对账时注意,现存量反映的是当前时点,历史时点的库存需要用库存台账按期间回算,不能用现存量接口倒推。轻易云在多个 YonBIP 项目中采用该接口作为库存唯一事实源,配合快照比对机制,可把对下游系统的无效写入减少约九成。