Youzan Order

---
name: youzan-order
version: 1.1.37
description: "有赞原生订单、全渠道订单索引、退款单、自提点配置和批量原始数据导出查询；不提供订单、退款或自提配置的远端数据变更能力，不做趋势、归因、画像、推荐或经营诊断。"
---

# 订单与退款

使用本 skill 前，确认当前授权范围、店铺上下文和金额单位。预约和服务履约使用 `youzan-booking`，供应链单据使用 `youzan-supplychain`。

## 查询数量限制

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

## 支持能力

- 查询有赞原生订单的单笔详情和订单列表，支持按时间、状态、商品、客户和分页条件筛选。
- 查询已接入客户关系管理系统或外部渠道的全渠道订单摘要；只有用户明确要求跨渠道、线下或三方订单时才使用该范围。
- 批量导出有赞原生或全渠道订单，并查询导出任务状态和结果。
- 查询退款单列表和单笔退款详情，并通过订单号理解订单与退款的关联。
- 查询自提城市、自提点配置以及订单已选择的自提信息。
- 区分列表数据、单笔详情和导出数据的字段差异；涉及营业收入时只提供原始金额和退款字段，不自动替代业务口径。

## 字段提示

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

### 必填信息

- 查询单笔订单时必须提供订单号。
- 查询单笔退款时必须提供退款单标识；按订单筛选退款时必须提供订单号。
- 使用时间范围筛选订单时必须同时提供开始时间和结束时间；未指定时间范围时不默认补充日期。
- 查询全渠道订单时必须明确“全渠道、线下、三方或多店聚合”等范围；按渠道或多店筛选时再提供对应渠道或店铺条件。
- 查询指定自提点时必须提供城市编码或自提点所属节点标识。

### 非必填信息

- 订单列表的状态、客户、商品、渠道、金额、支付时间、创建时间和字段分组可选；分页参数必须按“查询数量限制”传入。
- 订单详情可按需补充字段分组，以获取优惠、退款、导购或自提信息。
- 退款列表的状态、订单号、类型和时间范围可选；分页参数必须按“查询数量限制”传入。
- 导出查询可补充输出格式、字段范围和时间范围。

## 使用案例

- 用户说“查昨天所有订单”时，补齐自然日开始和结束时间，不默认添加完成状态；用户明确说“已完成订单”时才筛选对应状态。
- 用户提供订单号时，直接查询订单详情；如果订单商品是套餐且用户要看子商品，追加套餐子商品信息返回模块。
- 用户说“查某客户的退款单”时，优先确认客户手机号或订单号，再使用退款列表。退款单详情需要退款单标识。
- 用户说“取消订单、执行退款或修改自提点”时，说明本 skill 只支持读取和导出。

## 边界

- 预约单、服务履约单和课程履约信息使用 `youzan-booking`。
- 入库、出库、采购、要货、调拨和盘点单据使用 `youzan-supplychain`。
- 订单取消、退款处理、售后处理、自提点维护和其他远端数据变更不在本入口范围内。
- 不把买家实付、订单金额或退款字段直接解释为营业收入，不做跨系统归因和经营结论。