Xiaozhi Recycle Order

SKILL.md

---
name: xiaozhi-recycle-order
description: 小智回收自助下单。用于通过小智回收开放平台 API 创建回收订单。当用户需要提交设备回收订单、小智回收下单、回收估价下单时触发此 skill。支持自定义填写回收设备信息（品牌、型号、品类）、联系人、上门地址等。
agent_created: true
---

# 小智回收自助下单

## Overview

通过小智回收开放平台 REST API 完成自助下单，将回收设备信息（品牌、型号、品类）、联系人、上门地址等信息提交到回收系统。

## 触发场景

- 用户说「帮我提交一个回收订单」
- 用户提供设备信息要求「小智回收下单」
- 用户需要「获取回收报价并下单」
- 用户询问「怎么自助回收XX设备」

## API 认证方式

认证信息通过 HTTP Header 携带，Token 由脚本自动生成，详细逻辑见 `scripts/create_order.py`。

## 下单流程

### Step 1: 收集订单信息

向用户确认以下必要信息，缺失则逐一询问：

| 字段 | 说明 | 示例 |
|------|------|------|
| `name` | 联系人姓名 | 张三 |
| `mobile` | 联系电话 | 13800138000 |
| `prov_name` | 省份 | 北京 |
| `city_name` | 城市 | 北京市 |
| `area_name` | 区/县 | 朝阳区 |
| `address` | 详细地址 | XX路XX号 |
| `item_brand` | 设备品牌 | 华为 |
| `item_cates` | 设备品类 | 手机 |
| `item_model` | 设备型号 | Mate 60 Pro |
| `remark` | 备注（可选） | 期望上门时间 2026-06-10 |

以下字段使用默认值，**无需向用户询问**：
- `price`: 固定 `0.01`
- `source`: 固定 `172`
- `sale_item_name`: 自动取 `item_cates` 的值

### Step 2: 确认并提交

信息收集完成后向用户展示订单摘要，等用户确认后再提交。

### Step 3: 调用下单接口

使用 `scripts/create_order.py` 脚本提交订单：

```bash
python3 scripts/create_order.py \
  --name "张三" \
  --mobile "13800138000" \
  --prov-name "北京" \
  --city-name "北京市" \
  --area-name "朝阳区" \
  --address "XX路XX号" \
  --item-brand "华为" \
  --item-cates "手机" \
  --item-model "Mate 60 Pro" \
  --price "0.01" \
  --remark "期望上门时间 2026-06-10 | 屏幕完好"
```

也可先用 `--dry-run` 验证 Token 和参数：

```bash
python3 scripts/create_order.py \
  --name "张三" \
  ... \
  --dry-run
```

### Step 4: 解析响应

成功时返回 JSON 响应体，从中提取订单号等信息展示给用户。失败时根据 HTTP 状态码和错误信息排查原因。

若返回「该询价信息已下单，请勿重复使用」，说明该询价对应的订单已存在，需要新的询价记录。

## 关键注意事项

1. 信息收集完成后向用户展示订单摘要，确认后再提交
2. 若返回「该询价信息已下单，请勿重复使用」，说明该询价对应的订单已存在，需要新的询价记录

## Resources

### scripts/create_order.py
下单核心脚本，可直接执行，也可被 import 使用。

### references/api.md
API 接口参考文档，包含参数说明和请求示例。