业务介绍
小智回收是熊洞科技旗下专注回收与二手流通领域的品牌平台，依托数字化能力为合作伙伴提供订单管理、货源匹配、数据分析等全套工具。通过开放平台，您可以将回收能力嵌入自有系统，实现从用户下单到回收履约的完整闭环。
回收类目体系
三级类目树（家用电器、医疗健康、母婴等），支持全品类回收品类查询与动态更新
智能估价系统
基于品类、品牌、型号、成新率多维度自动询价，支持口价与询价两种价格模式
订单全生命周期
从创建、派物流、签收、验机到完成，11种订单状态全程可追踪
分拣中心管理
标准化分拣流程，支持入库、质检、定级、出库全流程数字化管理
逆向物流调度
支持自行寄回与上门取件两种模式，物流状态实时推送回调
数据分析能力
回收量趋势、品类分布、验机报告等可视化数据分析，支持集团渠道接入
典型应用场景
电商平台以旧换新
在电商结算页嵌入回收估价与抵扣，用户以旧换新一步完成
品牌商回收体系
品牌商通过 API 对接自建回收系统，管理全生命周期产品流向
集团渠道接入
集团渠道通过专属接口实现批量回收分类与订单接入
政府回收监管平台
为政府提供回收数据接口，支撑家电回收体系建设与政策落地
接入指南
按照以下步骤完成 小智回收 API 的接入，全程技术团队提供支持。
认证方式
小智回收 API 采用 URL Query 参数认证方式。每次请求需在 URL 中携带 appkey、dateline 和 sign 三个参数，sign 通过 MD5 签名算法生成。
appkey应用 APPKEY，由熊洞提供，注意保密
dateline当前 unix 时间戳，10 位整数
sign验签参数，MD5 签名结果
params请求参数 JSON 格式，参数为空时用 {}
签名规则
参数组合：str = appkey + dateline + params + secret
示例：2021040817941695102019{"order_code":"test2022222"}16e8615fa24e36f56490d65b2f2d345d
签名加密：sign = md5(str)
示例结果：eaec0e1c41eaedfc6389e7391e6cffe2
请求格式：https://api.bearhome.cn/papi/hs/open/xxx?appkey=xxx&dateline=xxx&sign=xxx
1
注册成为熊洞商家
前往熊洞商家中心注册账号，提交企业营业执照、法人身份证等资质信息，完成商家认证。
前往商家中心注册 →2
联系商务审核
联系熊洞商务团队进行资质审核，确认回收业务接入需求与方案。商务联系电话：400-155-5151。
拨打商务电话 →3
获取对接信息
商务审核通过后创建对接群，由小智开发团队提供 appkey、secret 等对接凭证信息。注意：params 为空时用 {} 代替。
// 对接凭证
appkey = "202104081794" // 由小智开发提供
secret = "16e8615fa24e36f56490d65b2f2d345d" // 由小智开发提供
// 签名规则
str = appkey + dateline + params + secret
sign = md5(str)
// 示例
str = "202104081794" + "17941695102019" + '{"order_code":"test2022222"}' + "16e8615fa24e36f56490d65b2f2d345d"
sign = md5(str) = "eaec0e1c41eaedfc6389e7391e6cffe2"
4
开始联调测试
使用开发环境地址进行联调测试，验证签名算法与接口调用。
curl -X POST "https://uat-papi.juranguanjia.com/hs/open/v2/cates?appkey=202104081794&dateline=1695102019&sign=eaec0e1c41eaedfc6389e7391e6cffe2" \
-H "version: 2.0" \
-H "Content-Type: application/json" \
-d '{}'
5
验收上线
联调测试通过后，配置线上 appsecret 信息，切换至生产环境地址正式上线。同时需实现消息订阅回调接口接收订单状态变更通知。
# 生产环境
https://api.bearhome.cn/papi/hs/open/xxx?appkey=xxx&dateline=xxx&sign=xxx
环境地址
生产环境https://api.bearhome.cn/papi/
开发环境https://uat-papi.juranguanjia.com/
API 文档
小智回收 提供以下 API 接口，点击展开查看详细参数与示例。
查询小智回收支持的全部回收品类，返回三级类目树结构。Header 需携带 version: 2.0。
请求 Header 参数
| 参数名 | 类型 | 必填 | 说明 |
|---|
| version | string | 是 | 接口版本，固定值 2.0 |
请求示例
GET /hs/open/v2/cates?appkey=xxx&dateline=xxx&sign=xxx
Header: version: 2.0
返回示例
{
"code": 200,
"data": [
{
"id": 2442,
"parent_id": 0,
"name": "家用电器",
"image": null,
"price_type": 1,
"type": "cates",
"has_child": "false",
"child": [
{
"id": 2456,
"name": "大家电",
"child": [
{ "id": 2555, "name": "冰箱" },
{ "id": 2557, "name": "洗衣机" },
{ "id": 2556, "name": "电视" }
]
}
]
}
]
}
根据三级分类ID查询品牌列表（brand_id 传 0），或根据品牌ID查询型号列表。返回品牌/型号信息及询价配置项。
请求 Header 参数
| 参数名 | 类型 | 必填 | 说明 |
|---|
| version | string | 是 | 接口版本，固定值 2.0 |
请求 Body 参数
| 参数名 | 类型 | 必填 | 说明 |
|---|
| cate_id | int | 是 | 三级分类ID |
| brand_id | int | 是 | 品牌ID，首次查询传 0 获取品牌列表 |
请求示例
{
"cate_id": 2555,
"brand_id": 0
}
返回示例
{
"code": 200,
"data": {
"child": [
{ "id": 101, "name": "海尔", "image": "url", "price": 0, "min_price": 0, "has_child": "true" }
],
"config": [
{ "group_id": 1, "group_name": "外观成色", "group_more": 0,
"group_data": [
{ "id": 11, "name": "九成新", "rate": 1.0 },
{ "id": 12, "name": "八成新", "rate": 0.8 }
]
}
]
}
}
根据品类、品牌、型号及用户选择的询价配置项，查询回收报价。返回报价单ID（cate_code）用于后续下单。
请求 Header 参数
| 参数名 | 类型 | 必填 | 说明 |
|---|
| version | string | 是 | 接口版本，固定值 2.0 |
请求 Body 参数
| 参数名 | 类型 | 必填 | 说明 |
|---|
| cate_id | int | 是 | 三级分类ID |
| brand_id | int | 是 | 品牌ID |
| model_id | int | 是 | 型号ID |
| selected | object | 是 | 询价配置选择，格式 {group_id: [选项ID, ...]} |
请求示例
{
"cate_id": 2555,
"brand_id": 101,
"model_id": 201,
"selected": {
"1": [11],
"2": [21, 22]
}
}
返回示例
{
"code": 200,
"data": {
"price_type": 1,
"cate_code": "RC20250120001",
"price": 150,
"min_price": 120,
"max_price": 180,
"item_cates": "冰箱",
"item_brand": "海尔",
"item_model": "BCD-218"
}
}
根据报价单ID（cate_code）创建回收订单，支持指定物流方式（自行寄回或上门取件）。
请求 Body 参数
| 参数名 | 类型 | 必填 | 说明 |
|---|
| cate_code | string | 是 | 报价单ID（来自询价接口） |
| order_no | string | 否 | 三方订单号 |
| name | string | 是 | 联系人姓名 |
| mobile | string | 是 | 联系电话 |
| prov_name | string | 是 | 省份 |
| city_name | string | 是 | 城市 |
| area_name | string | 是 | 区域 |
| address | string | 是 | 详细地址 |
| in_express | int | 是 | 物流方式：0无/1自行寄回/2上门取件 |
| in_express_time | string | 否 | 预约取件时间 |
| remark | string | 否 | 备注 |
请求示例
{
"cate_code": "RC20250120001",
"name": "张三",
"mobile": "17000001234",
"prov_name": "北京",
"city_name": "北京市",
"area_name": "朝阳区",
"address": "xxx路xx号",
"in_express": 2,
"in_express_time": "2025-01-20 10:00"
}
返回示例
{
"code": 200,
"data": {
"order_id": 123456,
"order_code": "RC20250120001"
},
"msg": "创建成功"
}
根据订单编号查询回收订单的详细信息，包括状态、地址、验机价格、物流信息等。
请求 Body 参数
| 参数名 | 类型 | 必填 | 说明 |
|---|
| order_code | string | 是 | 小智回收订单编号 |
请求示例
{
"order_code": "RC20250120001"
}
返回示例
{
"code": 200,
"data": {
"code": "RC20250120001",
"name": "张三",
"mobile": "17000001234",
"recover_price": 150,
"price": 150,
"vaild_price": 140,
"status": 30,
"status_name": "已验机等待确认",
"item_cates": "冰箱",
"item_brand": "海尔",
"express": [
{ "type": 0, "company": "京东物流", "number": "JD123456" }
]
}
}
对已验机的订单进行确认操作。确认回收（is_confirm=1）或提出异议并退回（is_confirm=4）。
请求 Body 参数
| 参数名 | 类型 | 必填 | 说明 |
|---|
| order_code | string | 是 | 订单编号 |
| is_confirm | int | 是 | 1=确认回收，4=有异议并退回 |
| remark | string | 否 | 异议原因（is_confirm=4 时填写） |
请求示例
{
"order_code": "RC20250120001",
"is_confirm": 1
}
返回示例
{
"code": 200,
"data": null,
"msg": "确认成功"
}
取消未完成的回收订单。
请求 Body 参数
| 参数名 | 类型 | 必填 | 说明 |
|---|
| order_code | string | 是 | 订单编号 |
| cancel_time | string | 否 | 取消时间 |
| remark | string | 否 | 取消原因 |
请求示例
{
"order_code": "RC20250120001",
"remark": "用户取消"
}
返回示例
{
"code": 200,
"data": null,
"msg": "取消成功"
}
分页查询回收订单列表，支持按订单号、手机号、状态、日期等条件筛选。默认返回最近一个月数据。
请求 Body 参数
| 参数名 | 类型 | 必填 | 说明 |
|---|
| page_no | int | 是 | 页码，从1开始 |
| page_size | int | 是 | 每页条数 |
| order_code | string | 否 | 订单号筛选 |
| mobile | string | 否 | 手机号筛选 |
| status | int | 否 | 订单状态筛选 |
| start_date | string | 否 | 开始日期 |
| over_date | string | 否 | 结束日期 |
请求示例
{
"page_no": 1,
"page_size": 20,
"status": 100
}
返回示例
{
"code": 200,
"data": {
"list": [
{
"code": "RC20250120001",
"name": "张三",
"mobile": "138****0000",
"item_cates": "冰箱",
"item_brand": "海尔",
"price": 150,
"status": 100,
"source_name": "API接入"
}
],
"total": 1
}
}
AI 智能体（MCP）
将 小智回收 的业务能力封装为标准 MCP 工具，AI 智能体（如千问办公、Cursor、Claude Desktop、阿里云百炼等）可直接接入调用，让 AI 真正融入业务运营。
MCP 使用指南包含客户端配置、Token 获取、工具调用示例等完整操作说明
查看使用指南 什么是 MCP
小智回收 MCP 服务（xiongdong-mcp-server）将回收业务能力封装为标准 MCP 工具，AI 智能体可通过对话直接查询回收订单状态、创建回收订单、批量导入订单、按业务维度分析回收数据，让 AI 真正融入回收业务运营。
智能订单处理
AI 直接查询回收订单状态、创建回收订单、取消物流、取消订单，订单全生命周期智能管理
Excel 批量导入
支持按 Excel 文件批量导入回收订单，AI 助手可辅助完成大批量订单录入
业务数据分析
按业务维度分析签收、验机、拆解、翻新、入库、出库等全流程数据，辅助经营决策
服务信息
服务名xiongdong-mcp-server
连接地址https://mcp.bearhome.cn/jmcp/sse
传输协议SSE（兼容 Streamable HTTP）
服务能力覆盖 4 大类 8 个工具
客户端接入配置
在 AI 客户端（如千问办公、Cursor、Claude Desktop 等）的 MCP 配置中，添加以下配置即可完成接入：
{
"mcpServers": {
"xiongdong_fw": {
"url": "https://mcp.bearhome.cn/jmcp/sse",
"type": "sse",
"headers": {
"mcptoken": "你的Token"
},
"disabled": false
}
}
}
常见问题
整理了接入 小智回收 API 过程中最常见的问题与解答。
−接入小智回收 API 需要什么资质？
需要提供企业营业执照、法人身份证等企业资质信息，通过商务审核后即可获得 appkey 与 secret。个人开发者暂不支持接入。
+签名算法是怎样的？
签名规则：将 appkey + dateline + params（JSON字符串）+ secret 拼接为一个字符串，然后计算该字符串的 MD5 值即为 sign。注意 params 为空时用 {} 代替。
+订单状态有哪些？
订单状态值：0=已下单待确认，5=已确认等待派单，10=已派物流等待签收，15=回收服务中，20=已签收等待验机，30=已验机等待确认，60=用户退机申请，70=回收取消，80=回收退单，90=异常挂单，100=回收完成。
+价格类型（price_type）有什么区别？
price_type=0 为询价模式（需选择配置项后查询报价），1 为口价模式（直接显示固定价格），2 为最低价，3 为其他类型。
+如何接收订单状态变更通知？
需要实现消息订阅回调接口（3.0接口），提供一个 HTTPS 服务端接收地址。当订单状态变更时，小智回收会主动推送 order_code、order_status、status_name、物流信息等到该地址。
+支持哪些物流方式？
目前支持三种方式：in_express=0 无物流，in_express=1 自行寄回（用户自行寄到分拣中心），in_express=2 上门取件（平台调度物流上门）。
没有找到答案？
如果以上内容未能解决您的问题，请随时联系我们的技术支持团队，我们将为您提供一对一接入指导。
联系技术支持 →