预约与服务履约
使用本 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。 - 服务资源主档、完整排班规则和可约库存主数据不在本入口范围内。
- 本入口不做任何预约、课次或履约状态的创建、修改、取消或其他远端变更。