小智回收自助下单

Overview

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

触发场景

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

API 认证方式

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

下单流程

Step 1: 收集订单信息

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

以下字段使用默认值，无需向用户询问：

• 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 接口参考文档，包含参数说明和请求示例。