小智回收自助下单
Overview
通过小智回收开放平台 REST API 完成自助下单。支持两类订单：
- 设备品类（device）：手机、电脑、家电等电子设备回收，固定价格 0.01 元
- 衣服品类（clothing）：旧衣物回收，按重量计价，需先询价后下单
设备下单和衣服下单均需微信登录授权（jr_sso_token）。
衣服询价接口无需授权，可直接调用。
触发场景
- 用户说「帮我提交一个回收订单」
- 用户提供设备/衣物信息要求「小智回收下单」
- 用户需要「获取回收报价并下单」
- 用户询问「怎么自助回收XX」
下单流程
Step 1: 判断品类并收集信息
首先询问用户要回收的是设备还是衣服。
A. 设备品类信息收集
| 字段 | 说明 | 示例 |
|---|---|---|
name |
联系人姓名 | 张三 |
mobile |
联系电话 | 13800138000 |
prov_name |
省份 | 北京 |
city_name |
城市 | 北京市 |
area_name |
区/县 | 朝阳区 |
address |
详细地址 | XX路XX号 |
item_brand |
设备品牌 | 华为 |
item_cates |
设备品类 | 手机 |
item_model |
设备型号 | Mate 60 Pro |
remark |
备注（可选） | 期望上门时间 YYYY-MM-DD |
以下字段使用默认值，无需向用户询问，也不在订单摘要中展示：
- price: 固定 0.01（不展示给用户）
- source: 固定 172
- sale_item_name: 自动取 item_cates 的值
B. 衣服品类信息收集
| 字段 | 说明 | 示例 |
|---|---|---|
name |
联系人姓名 | 彭先生 |
mobile |
联系电话 | 15711111111 |
prov_name |
省份 | 北京 |
city_name |
城市 | 北京市 |
area_name |
区/县 | 朝阳区 |
address |
详细地址 | 北苑路北 |
item_weight |
衣服重量（kg） | 11 |
in_express_time |
期望上门时间 | 2026-06-16 16:00:00 |
detail |
订单备注（可选） | 无 |
以下字段使用默认值，无需向用户询问：
- source: 固定 172
- goods_type: 固定 1
- category_id: 固定 2767
- item_cates: 固定 衣服
- item_name: 固定 衣服
- in_express: 固定 2
Step 2: 确认订单摘要
信息收集完成后向用户展示订单摘要，等用户确认。
Step 3: 衣服品类 — 询价
（仅衣服品类需要此步骤）
用户确认信息后，先调询价接口获取单价：
python3 scripts/create_order.py \
--order-type clothing \
--query-price-only \
--prov-name "北京" \
--city-name "北京市" \
--area-name "朝阳区"
将返回的单价展示给用户，确认总价（单价 × 重量），用户确认后进入下单步骤。
Step 4: 生成授权页面 + 微信扫码授权 + 自动下单
用户确认后，生成自带小程序码的 HTML 授权页面（适配网页聊天等各类终端）：
python3 scripts/create_order.py --login-url-only --code-html
输出 code_html 字段中包含 HTML 页面的本地路径。使用 preview_url 打开该页面，直接呈现给用户，页面内嵌小程序码图片，用户用微信扫码即可跳转小智回收小程序完成授权。
> 其他模式（向后兼容）：
> - --login-url-only（无 --code-html）：生成小程序码图片文件
> - --login-url-only --code-type qrcode：生成网页二维码链接
然后在前台执行轮询下单脚本（不要用后台/异步方式）：
设备品类：
python3 scripts/create_order.py \
--order-type device \
--name "张三" \
--mobile "13800138000" \
--prov-name "北京" \
--city-name "北京市" \
--area-name "朝阳区" \
--address "XX路XX号" \
--item-brand "华为" \
--item-cates "手机" \
--item-model "Mate 60 Pro" \
--send-code "<sendCode>"
衣服品类：
python3 scripts/create_order.py \
--order-type clothing \
--name "彭先生" \
--mobile "15711111111" \
--prov-name "北京" \
--city-name "北京市" \
--area-name "朝阳区" \
--address "北苑路北" \
--item-weight 11 \
--item-price 0.60 \
--in-express-time "2026-06-16 16:00:00" \
--send-code "<sendCode>"
脚本会先提示用户扫码授权，然后实时输出轮询进度。用户扫码点击「允许」后，脚本立即提示「已收到您的确认授权，正在为您自动下单...」并提交订单，用户立刻看到下单成功的响应。无需用户再次输入任何指令。
行政编码说明
衣服品类下单需要 provId、cityId、areaId（国家标准 GB/T 2260 行政区划代码）。脚本内置了主要省市区映射，会自动根据名称解析。如果解析失败，可以使用 --prov-id、--city-id、--area-id 手动指定。
关键注意事项
- 信息收集完成后向用户展示订单摘要，确认后再提交
- 衣服品类需先询价，用户确认价格后再下单
- 微信扫码授权：默认生成 HTML 授权页面（
--login-url-only --code-html），内嵌小程序码，用preview_url展示即可适配所有终端 - sendCode 每次请求动态生成，不可重复使用
- 轮询超时（120s）后需重新生成 sendCode 发起授权
- 若返回「该询价信息已下单，请勿重复使用」，说明该询价对应的订单已存在，需要新的询价记录
Resources
scripts/create_order.py
下单核心脚本，可直接执行，也可被 import 使用。支持设备/衣服双品类、微信扫码授权、询价和下单。
references/api.md
API 接口参考文档，包含参数说明和请求示例。
