## 接口说明
gy.erp.stock.get 查询管易云 ERP 的库存数据,按【仓库 + 商品/SKU】维度返回库存量、可用量等信息。管易作为订单中台时,库存主账通常在 ERP(金蝶/用友),该接口更多用于管易侧占用与在途数据的核对;管易作为库存主账时,它是全渠道库存下发的出数口。
### 请求要点
1. 系统级参数与签名同调用规范;业务参数常用:page_no/page_size 分页、warehouse_code(仓库代码)、item_code/sku_code(商品/SKU 代码精确查)。
2. 返回行包含 warehouse_code、item_code、sku_code、qty(库存量)、available_qty(可用量)等;可用量口径为库存量减去订单占用。
3. 库存为快照数据,建议定时全量拉取后做快照 diff,仅把差异 SKU 下发到销售渠道,控制写请求量。
4. 多仓场景按 warehouse_code 分批拉取,避免单次全量超时。
### 典型链路
管易库存 → 轻易云快照比对 → 可售量按店铺配额计算 → 回写聚水潭/旺店通/平台库存;差异超阈值时触发库存校准告警,防止静默超卖。
### 占用与退货在途
管易的库存占用来自已抓单未发货的订单,大促期间占用量会瞬时放大,向销售端同步前建议以“可用量 - 安全缓冲”作为对外值,缓冲按类目动销速度配置;退货入库未质检的商品不计入可用量,质检完成后才释放,跨系统对库存时注意这个时间差,别把在途退货当成可售。库存校准任务建议与订单同步任务错峰运行,避免大促期间两个任务同时高频访问管易网关触发限流,影响订单履约链路的实时性。