# 订单

> Shoplazza AI Toolkit 中 shoplazza-orders 技能的自然语言指令示例：查客户订单、发货、改运单号、按安全协议退款与标记已付款。

`shoplazza-orders` 技能的自然语言指令——大促后履约。每条请求前加 `/shoplazza-orders` 前缀，再描述任务。

## 前置条件

* [快速开始](../get-started)
* 对店铺完成认证：`shoplazza auth login --store-domain <域名> --domain orders`

## 示例

### 1. 查订单（跨域路由的经典边界）

```
/shoplazza-orders 看下 tom@example.com 这个客户下过哪些订单
```

按客户邮箱查订单属于 `orders`；而客户*资料*本身属于 [`customers`](../skills#选对业务域)。

### 2. 发货

```
/shoplazza-orders 订单 660011 发货,运单号 SF1234567890
```

运行 `orders +ship --order-id 660011` 并带上运单号。

### 3. 改运单号

```
/shoplazza-orders 刚那单运单号填错了,改成 SF9999999999
```

运行 `orders +update-tracking` 修正履约信息。

### 4. 部分退款（资金操作）

```
/shoplazza-orders 订单 660011 给买家退 15.50,备注 wrong size,库存退回
```

这涉及资金，智能体遵循安全协议：先用 `--dry-run` 预览退款，复述金额、备注与库存退回行为，等你明确确认后再执行。

### 5. 标记已支付

```
/shoplazza-orders 订单 660011 客户已经线下 PayPal 付了,交易号 TX789,帮我标记已支付
```

按给定交易号将订单标记为已支付。

### 6. 大促收尾看板

```
/shoplazza-orders 这次大促期间一共成了多少单?
```

在大促时间窗内运行 `orders +count`，返回总单量。

## 参见

* [商品示例](./products)
* [折扣示例](./discounts)
* [Shoplazza CLI：订单命令](/zh-CN/docs/app/developer-tools/shoplazza-cli/commands/orders)