Youzan Shop

---
name: youzan-shop
version: 1.1.37
description: "店铺基础资料、连锁组织、客户关系管理店铺字典、店铺配置、插件服务期、同城配送范围、库存模式和仓库节点的原始数据查询；不提供店铺资料或配置的远端数据变更能力，不做门店经营分析。"
---

# 店铺与组织

使用本 skill 前，确认当前授权范围和店铺上下文。商品库存和物流模板分别使用 `youzan-item`，订单自提信息使用 `youzan-order`。

## 查询数量限制

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

## 支持能力

- 查询当前授权店铺的名称、店铺类型、地址、店长联系方式、组织角色和店铺标识。
- 查询连锁组织中的门店、仓库、合伙人、供货商和前置仓节点。
- 查询客户关系管理店铺和客户关系管理店铺组筛选字典。
- 查询店铺配置、软件或商业化插件服务期状态。
- 查询当前店铺或指定店铺的同城配送范围。
- 查询库存模式、仓库、门店仓和前置仓编码，供其他查询流程识别库存上下文。

## 字段提示

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

### 必填信息

- 查询单个指定店铺时必须提供店铺标识，未指定时使用当前授权店铺。
- 查询指定客户关系管理店铺组时必须提供店铺组标识；按名称搜索时提供关键词，二者按查询意图择一。
- 查询指定店铺配置、同城配送范围或库存模式时必须提供目标店铺名称；名称不唯一时要求用户确认。
- 查询指定插件服务期时必须提供插件名称；名称不唯一时要求用户确认。

### 非必填信息

- 组织列表的角色、名称、省市、状态和是否展开部门或客户关系管理信息可选；分页参数必须按“查询数量限制”传入。
- 店铺配置可补充配置键列表。
- 客户关系管理店铺和店铺组列表的关键词可选；分页参数必须按“查询数量限制”传入。
- 仓库列表的节点和类型条件可选；分页参数必须按“查询数量限制”传入。

## 使用案例

- 用户说“查当前店铺详情”时，读取店铺标识、业态、组织角色和地址等基础信息；未指定店铺时使用授权上下文。
- 用户说“查连锁下的某个分店商品”时，先确认目标分店名称和渠道；存在同名分店时要求用户确认。
- 用户说“查客户关系管理店铺组”时，区分店铺组标识与店铺标识；只提供业务名称时先查字典。
- 用户说“修改店铺配置、关闭插件或调整配送范围”时，说明本 skill 只支持读取。

## 边界

- 店铺名称、标志、简介、客服电话、配送范围、库存模式和其他配置的创建、编辑、启停或维护不在本入口范围内。
- 商品、商品规格和商品库存使用 `youzan-item`；仓库库存数量和供应关系使用 `youzan-supplychain`。
- 自提点和订单已选自提信息使用 `youzan-order`。
- 不做门店业绩、经营趋势、对比分析或推荐。