## 接口说明
currentstock/batch_get 属于 U8 开放平台库存管理类接口,批量获取现存量数据(存货 × 仓库维度的结存数量),与 U8【库存管理 → 库存账 → 现存量查询】的口径一致。对于以 U8 为库存主账、向前端电商/经销商门户供给可售库存的企业,这是库存出数的标准接口。
### 请求要点
1. GET 方式,query 携带 token、from_account、to_account、app_key、app_secret 及分页参数(page_index、rows_per_page)。
2. 过滤条件可按仓库(cWhCode)、存货编码(cInvCode)收窄范围,生产上建议按仓库分批拉,降低单请求耗时。
3. 现存量为快照,无修改时间游标;建议定时全量拉取后由轻易云做快照比对,只对差异行触发下游同步,显著降低对电商中台的写入压力。
4. 注意 U8 的"修改现存量时点"参数会影响结存口径(保存即改 vs 审核才改),同步口径要与财务/仓库确认一致。
### 典型链路
U8 现存量 → 轻易云快照 diff → 计算可售量(结存 - 已占用)→ 聚水潭/旺店通/门店 POS 库存下发;同时输入安全库存预警与补货建议。
### 可用量口径
U8 的可用量由现存量、预计入库、预计出库、冻结量按库存选项参数组合计算,不同企业的设置不同,同步“可售库存”前务必与仓库确认公式;若需要 ATP 口径,建议改取可用量相关报表接口,或在集成层按确认后的公式自行计算,避免两边口径打架。对于年结存数据量大的账套,建议按存货分类分批拉取并在轻易云侧合并,既控制单次响应体积,也便于按分类设置不同的同步频率。