Xiaozhi Recycle Order

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

小智回收自助下单

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 脚本提交订单：

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 和参数：

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

Step 4: 解析响应

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

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

关键注意事项

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

Resources

scripts/create_order.py

下单核心脚本，可直接执行，也可被 import 使用。

references/api.md

API 接口参考文档，包含参数说明和请求示例。