Youzan Supplychain

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

ahang1598 Updated 94 repo stars

File contents

供应链与进销存

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

查询数量限制

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

支持能力

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

字段提示

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

必填信息

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

非必填信息

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

使用案例

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

边界

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

ahang1598/doubao-workbuddy-qwenwork-skills commit 8c8533c3ad

Frequently asked questions

npx get-skill add ahang1598/youzan-supplychain