Youzan Supplychain

---
name: youzan-supplychain
version: 1.1.37
description: "供应链与进销存原始数据查询，覆盖仓库商品规格库存、库存预警、供货关系、出入库、盘点、采购、要货、调拨、供应商、供应商商品、物料清单和原材料；不提供供应链单据或主数据的远端变更能力，不做补货、成本、趋势或经营结论。"
---

# 供应链与进销存

使用本 skill 前，确认当前授权范围、店铺上下文和金额单位。消费者商品主档使用 `youzan-item`，店铺组织和库存模式使用 `youzan-shop`。

## 查询数量限制

- 列表查询必须显式传入页码和每页数量，不得依赖接口默认分页；每页最多查询 20 条。
- 批量查询每批最多传入 20 个对象或标识；超过 20 个时必须拆分为多个批次依次查询，且每批均不得超过 20 个。

## 支持能力

- 查询出库、入库、盘点、采购、要货和调拨单据的列表、详情或商品明细。
- 查询仓库商品规格在途库存、库存预警和安全库存。
- 查询门店或网店对应的供货关系。
- 查询供应商、供应商商品、采购单位、采购价和税率等供应侧字段。
- 查询物料清单配方、加工成品和原材料明细。
- 返回单据、库存和供应协同主数据的原始结构，不生成补货建议或成本结论。

## 字段提示

- 查询参数和返回结果中的字段必须使用中文字段名，不展示接口英文原始字段名。

### 必填信息

- 查询出库或入库单详情时必须由用户或上游提供仓库编码，同时提供单据号；不能用仓库标识替代。
- 查询在途库存时必须提供仓库编码和至少一个商品规格编码。
- 查询指定供应商商品时必须提供供应商标识。
- 查询单个物料清单、采购单、要货单、调拨单或盘点单时必须提供对应单据或配方标识。
- 查询门店供货关系时必须提供目标门店或网店名称。

### 非必填信息

- 单据列表的仓库、商品规格、条码、状态和时间范围可选；分页参数必须按“查询数量限制”传入。
- 库存预警可补充商品规格、过保日期、剩余保质期和是否预警条件。
- 供应商、物料清单和原材料列表的名称、编码、仓库和状态条件可选；分页参数必须按“查询数量限制”传入。
- 在途库存单批最多查询 20 个商品规格编码；超过 20 个时必须拆分查询。

## 使用案例

- 用户说“查某仓库的在途库存”时，必须提供仓库编码和商品规格编码；仓库名称不唯一时要求用户确认。
- 用户说“查采购单详情”或“查入库单明细”时，使用对应单据标识和仓库上下文，不把商品标识当作单据号。
- 用户说“查某供应商能供哪些商品”时，提供供应商标识后查询供应商商品。
- 用户说“创建采购单、审核入库、调拨库存或修改物料清单”时，说明本 skill 只支持读取。

## 边界

- 商品主档、可售商品规格、商品价格、上下架和销售库存使用 `youzan-item`。
- 店铺组织、仓库节点和库存模式解释使用 `youzan-shop`。
- 采购、要货、调拨、入库、出库、盘点、供应商和物料清单的创建、编辑、审核、提交及其他远端数据变更不在本入口范围内。
- 不从库存预警直接推导补货量、周转、成本或经营建议。