小智回收自助下单#

Overview#

通过小智回收开放平台 REST API 完成自助下单。支持两类订单：

• 设备品类（device）：手机、电脑、家电等电子设备回收，固定价格 0.01 元
• 衣服品类（clothing）：旧衣物回收，按重量计价，需先询价后下单

设备下单和衣服下单均需微信登录授权（ jr_sso_token）。 衣服询价接口无需授权，可直接调用。

此外支持 设备铭牌 OCR 识别：用户上传设备铭牌/合格证图片，调用熊洞 OCR 接口 （ https://ai.bearhome.cn/xd-ocr）自动提取设备名称、型号、SN 码，并推断品牌/品类/型号， 用于快速填写设备下单信息。

触发场景#

• 用户说「帮我提交一个回收订单」
• 用户提供设备/衣物信息要求「小智回收下单」
• 用户需要「获取回收报价并下单」
• 用户询问「怎么自助回收XX」
• 用户上传设备铭牌/合格证图片，要求「识别这个设备信息并下单」或「拍一下铭牌帮我回收」

下单流程#

Step 1: 判断品类并收集信息#

首先询问用户要回收的是 设备 还是 衣服。

---

A. 设备品类信息收集

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

以下字段使用默认值， 无需向用户询问，也不在订单摘要中展示：

• price: 固定 0.01（不展示给用户）
• source: 固定 172
• sale_item_name: 自动取 item_cates 的值

A1. 设备铭牌识别（可选，替代手动填写品牌/品类/型号）

若用户上传了设备铭牌/合格证图片，或提供了图片 URL，可先调用 OCR 识别自动提取 item_brand、 item_cates、 item_model，免去手动填写。识别后仍需向用户确认。

bash

# 本地图片（用户直接上传的铭牌照片，先保存到本地再传入）
python3 scripts/ocr_recognize.py --image /path/to/nameplate.jpg

# 图片 URL
python3 scripts/ocr_recognize.py --image-url "https://example.com/plate.jpg"

脚本返回结构化结果，关键字段：

字段说明映射到下单字段name识别出的设备名称—model识别出的型号item_model``snSN 码可选写入 remark``suggested_brand推断的品牌item_brand``suggested_cates推断的品类item_cates``suggested_model推断的型号（优先取 model，缺省取 name）item_model

使用规则：

1. 识别/推断结果（品牌、品类、型号） 必须展示给用户确认，用户确认后才进入下单；识别不可靠时允许用户手动修正。
2. 若脚本推断的品牌或品类为空（未命中关键词库），根据 name、 model、 ocr_text 中的描述自行推断，或直接询问用户。
3. 型号择优：OCR 的 型号 字段可能是铭牌编号（如 MFB2AM）或含 CMIIT 无线电核准码（如 2017DP5526），而 名称 字段往往才是完整产品型号（如「米家智能微压IH电饭煲3L」）。选择 item_model 时优先取能完整描述产品的字段——若 名称 含品类词（电饭煲/空气净化器等）说明是完整产品名，优先取 名称；否则取 型号。CMIIT ID、铭牌编号、SN 码等写入 remark 备注。
4. SN 码不单独作为下单必填项，可写入 remark 备注（如「SN:33844」）以便追溯。
5. 识别完成后继续走「Step 2 确认订单摘要 → Step 4 授权下单」流程，无需改变后续步骤。

---

B. 衣服品类信息收集

字段说明示例name联系人姓名彭先生mobile联系电话15711111111prov_name省份北京city_name城市北京市area_name区/县朝阳区address详细地址北苑路北item_weight衣服重量（kg）11in_express_time期望上门时间2026-06-16 16:00:00detail订单备注（可选）无

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

• source: 固定 172
• goods_type: 固定 1
• category_id: 固定 2767
• item_cates: 固定 衣服
• item_name: 固定 衣服
• in_express: 固定 2

Step 2: 确认订单摘要#

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

Step 3: 衣服品类 — 询价#

（仅衣服品类需要此步骤）

用户确认信息后，先调询价接口获取单价：

bash

python3 scripts/create_order.py \
  --order-type clothing \
  --query-price-only \
  --prov-name "北京" \
  --city-name "北京市" \
  --area-name "朝阳区"

将返回的单价展示给用户，确认总价（单价 × 重量），用户确认后进入下单步骤。

Step 4: 生成授权页面 + 微信扫码授权 + 自动下单#

用户确认后，生成自带小程序码的 HTML 授权页面（适配网页聊天等各类终端）：

bash

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：生成网页二维码链接

然后 在前台执行 轮询下单脚本（不要用后台/异步方式）：

设备品类：

bash

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>"

衣服品类：

bash

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 手动指定。

关键注意事项#

1. 信息收集完成后向用户展示订单摘要，确认后再提交
2. 衣服品类需先询价，用户确认价格后再下单
3. 微信扫码授权：默认生成 HTML 授权页面（ --login-url-only --code-html），内嵌小程序码，用 preview_url 展示即可适配所有终端
4. sendCode 每次请求动态生成，不可重复使用
5. 轮询超时（120s）后需重新生成 sendCode 发起授权
6. 若返回「该询价信息已下单，请勿重复使用」，说明该询价对应的订单已存在，需要新的询价记录
7. OCR 识别的品牌/品类/型号为推断值， 必须经用户确认后方可下单；识别结果模糊或推断为空时询问用户手动补充
8. OCR token 有效期约 1 小时，401 时脚本会自动重新生成 token 重试一次

Resources#

scripts/create_order.py#

下单核心脚本，可直接执行，也可被 import 使用。支持设备/衣服双品类、微信扫码授权、询价和下单。

scripts/ocr_recognize.py#

设备铭牌 OCR 识别脚本，调用熊洞 OCR 接口（ https://ai.bearhome.cn/xd-ocr）识别设备名称/型号/SN 码， 并推断品牌/品类/型号供设备下单使用。支持本地图片（ --image）与图片 URL（ --image-url）。

references/api.md#

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

references/ocr.md#

OCR 铭牌识别接口参考文档，包含鉴权算法、请求/响应格式与字段说明。