## 接口说明
youzan.items.onsale.get 分页查询店铺出售中的商品列表,返回 item_id、title、price、quantity(总库存)、item_no(商家编码)及 SKU 明细(sku_id、sku_no、price、quantity)。配套接口 youzan.items.inventory.get 查仓库中的商品(含下架),两者并集覆盖全量商品档案。
### 请求要点
1. POST + application/json,access_token 放 URL query;路径版本号按接口文档(如 4.0.0)。
2. 分页:page_no、page_size;可按 update_time 窗口增量(q 模糊搜标题、tag_id 等可选条件按文档)。
3. SKU 级字段是库存校准的关键:sku_no(商家编码)是跨系统对齐商品的主键,集成前必须保证有赞 sku_no 与 ERP 物料编码的一一映射。
4. quantity 为有赞侧在售库存,与 ERP 库存主账比对可发现同步漏单(超卖/滞销两侧不一致)。
### 典型链路
ERP 商品主数据 → 轻易云字段映射(编码、条码、类目、价格)→ 有赞商品档案创建/更新;定时用本接口回拉有赞商品与库存,生成"ERP-有赞商品对照差异报告",供运营修正。
### 与库存接口的配合
商品列表返回的是商品维度的总库存;如需按 SKU 精确维护库存,应使用 SKU 库存更新接口,以 sku_id 或 item_no + sku_no 定位。下架商品不在本接口返回,全量商品盘点要并用 youzan.items.inventory.get,两个接口的结果按 item_id 去重合并后才是完整商品档案。