轻易云
注册体验
GEThttps://api.yonyouup.com/api/currentstock/batch_gettoken(query 传参)

现存量批量获取(currentstock/batch_get)

U8 OpenAPI 库存管理类现存量查询接口,批量拉取存货在各仓库的结存数量,用于库存同步、经销商要货可视与补货计算的库存底数。

## 接口说明 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 口径,建议改取可用量相关报表接口,或在集成层按确认后的公式自行计算,避免两边口径打架。对于年结存数据量大的账套,建议按存货分类分批拉取并在轻易云侧合并,既控制单次响应体积,也便于按分类设置不同的同步频率。

代码示例

curl
curl -G "https://api.yonyouup.com/api/currentstock/batch_get" \
  --data-urlencode "from_account=source_acc" \
  --data-urlencode "to_account=u8_acc" \
  --data-urlencode "app_key=your_app_key" \
  --data-urlencode "app_secret=your_app_secret" \
  --data-urlencode "token=YOUR_TOKEN" \
  --data-urlencode "rows_per_page=100"

错误码

错误码消息含义
0成功查询成功
20005U8 服务调用失败EAI 执行异常,检查 U8 服务状态后重试