Youzan Booking

---
name: youzan-booking
version: 1.1.37
description: "预约与服务履约原始数据查询，包括预约单、服务单、课程、课次、可预约时段、预约看板和排期资源；不提供任何远端数据变更能力，不做经营分析、画像或推荐。"
---

# 预约与服务履约

使用本 skill 前，确认当前授权范围、店铺范围、敏感字段和金额单位的处理规则。

## 查询数量限制

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

## 支持能力

- 查询预约单列表和单笔预约详情，读取预约人、门店、预约时间、服务项目、资源、状态以及关联交易单信息。
- 查询服务履约单列表和单笔详情。服务履约单号通常以 `F` 开头，关联交易订单通常以 `E` 开头。
- 按门店、日期、服务项目和时长查询可预约时段。
- 查询课程列表、预约看板、课程课次详情，以及指定课程和门店的候选老师、助教和场地。
- 判断预约单、交易订单和服务履约单之间的关联关系，并将交易详情转交 `youzan-order`。
- 仅返回预约、排课和履约侧的原始结构，不据此推导到店率、爽约率、收入或趋势结论。

## 字段提示

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

### 必填信息

- 查询单笔预约时必须提供预约单号。
- 查询单笔服务履约单时必须提供明确的服务履约单号，不能用交易订单号替代。
- 查询课次详情时必须提供课次标识。
- 查询课程排期资源时必须提供门店节点标识和课程标识。
- 查询可预约时段时必须同时提供分店名称、预约日期、服务商品、服务时长和商品规格。分店名称不唯一时，必须让用户确认具体分店，不能默认选择总部。
- 按时间范围查询服务单时必须同时提供开始时间和结束时间；未指定时间类型时按创建时间筛选。

### 非必填信息

- 列表查询的状态、关键词和查询类型可选；分页参数必须按“查询数量限制”传入。
- 查询看板时可补充看板类型和视图类型；课程相关看板使用资源视图。
- 服务商品或商品规格由关键词命中多个候选时，必须让用户明确选择一个，不要自动合并查询。

## 使用案例

- 用户说“查最近 7 天的服务单”时，使用服务单列表，补齐成对的开始时间和结束时间；未明确状态时查询全部状态。
- 用户提供 `F` 开头的服务单号时，查询服务履约详情；提供 `E` 开头的交易订单号时，交易详情转给 `youzan-order`，涉及服务关联时再用服务单列表定位。
- 用户说“查某分店明天可预约的羽毛球时段”时，先确认分店名称、服务商品、商品规格和服务时长，再查询时段；多个商品或商品规格候选时先让用户选择。
- 用户说“取消预约、修改课次或停用课程”时，说明本 skill 只支持读取，不能执行远端变更。

## 边界

- 交易订单和退款详情使用 `youzan-order`。
- 商品、商品规格、商品库存和服务商品主档使用 `youzan-item`。
- 客户、门店和员工基础档案分别使用 `youzan-member`、`youzan-shop` 和 `youzan-staff`。
- 服务资源主档、完整排班规则和可约库存主数据不在本入口范围内。
- 本入口不做任何预约、课次或履约状态的创建、修改、取消或其他远端变更。