熊洞服务开放接口 - 熊洞科技开放平台

小智回收熊洞服务物流服务

返回首页

业务介绍

熊洞服务是熊洞科技旗下专业家电服务平台，覆盖安装、维修、清洗、拆装等全品类家电服务。通过开放平台，您可以将家电服务能力嵌入自有系统，实现从用户下单到工程师上门履约的完整闭环。服务通知机制确保每次状态变更都能实时触达。

工单智能管理

自动创建、分配、追踪工单全生命周期，支持催单、取消、改约、再次上门

工程师调度系统

自动匹配就近工程师，支持服务通知推送（分配、接单、开始服务、完工等10种通知类型）

全品类服务能力

覆盖安装、维修、检测、保养、拆机、拆装、回收等 8 种服务类型，支持 11 大品类

服务商品管理

可查询服务商品 SKU 列表，支持品牌、品类、型号维度筛选

电子签收单

服务完成后可查询电子签收单 PDF，支持线上化归档与对账

服务通知回调

10种通知类型（分配、接单、改约、开始、完工、审核、取消等），全流程实时推送

800+

服务门店网络

24h

核心城市响应

种服务类型

种通知类型

典型应用场景

电商平台服务嵌入

在电商商品详情页提供安装/维修服务预约，用户下单即安排工程师上门

品牌商售后体系

品牌商通过 API 对接全国售后服务网络，统一管理与调度工程师

物业管理集成

物业公司嵌入家电维修服务能力，为业主提供一站式居家服务

连锁门店管理

连锁零售门店统一管理售后工单，自动派单至就近工程师

接入指南

按照以下步骤完成熊洞服务 API 的接入，全程技术团队提供支持。

认证方式

熊洞服务 API 采用 Header 参数认证方式。每次请求需在 Header 中携带 APPKEY、TIMEMILLIS 和 SIGN 三个参数，SIGN 通过 MD5 签名算法生成。

APPKEY应用 APPKEY，由熊洞提供

TIMEMILLIS当前毫秒级时间戳

SIGN签名 = MD5(APPKEY + TIMEMILLIS + APPSECRET)

签名规则

text

签名规则：SIGN = MD5(APPKEY + TIMEMILLIS + APPSECRET)
示例：APPKEY = "B202206142044504181292148"
      TIMEMILLIS = "1695102019000"
      APPSECRET = "16e8615fa24e36f56490d65b2f2d345d"
      SIGN = MD5("B202206142044504181292148169510201900016e8615fa24e36f56490d65b2f2d345d")

注册成为熊洞商家

前往熊洞商家中心注册账号，提交企业营业执照、法人身份证等资质信息，完成商家认证。

前往商家中心注册 →

联系商务审核

联系熊洞商务团队进行资质审核，确认服务业务接入需求与方案。商务联系电话：400-155-5151。

拨打商务电话 →

获取对接信息

商务审核通过后创建对接群，由小智开发团队提供 APPKEY、APPSECRET 等对接凭证。注意：调用方服务器 IP 需提前报备，否则下单会失败。

text

// 对接凭证
APPKEY = "B202206142044504181292148"      // 由小智开发提供
APPSECRET = "16e8615fa24e36f56490d65b2f2d345d"  // 由小智开发提供

// 签名规则
SIGN = MD5(APPKEY + TIMEMILLIS + APPSECRET)
// 示例
TIMEMILLIS = "1695102019000"
SIGN = MD5("B202206142044504181292148" + "1695102019000" + "16e8615fa24e36f56490d65b2f2d345d")

开始联调测试

在 Header 中携带 APPKEY、TIMEMILLIS、SIGN 三个认证参数，Body 传入 JSON 格式的订单信息进行联调测试。

bash

curl -X POST "https://api.bearhome.cn/api/order/open/v1/preorder" \
  -H "APPKEY: B202206142044504181292148" \
  -H "TIMEMILLIS: 1695102019000" \
  -H "SIGN: xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"saleOrderNo":"SO001","receiver":"张三","serviceType":1,...}'

验收上线

联调测试通过后，配置线上 APPSECRET 信息，切换至生产环境地址正式上线。同时实现服务情况通知回调接口（servicenotify），接收工程师分配、开始服务、完工等 10 种状态通知。

text

# 生产环境
https://api.bearhome.cn/api/order/open/v1/

环境地址

生产环境https://api.bearhome.cn/api/order/open/v1/

开发环境联系商务获取开发环境地址

API 文档

熊洞服务提供以下 API 接口，点击展开查看详细参数与示例。

POST

/api/order/open/{version}/preorder

服务下单

展开

参数名	类型	必填	说明
saleOrderNo	string	是	三方销售单号
receiver	string	是	收件人姓名
receiverMobile	string	是	收件人手机号
provinceName	string	是	省份
cityName	string	是	城市
areaName	string	是	区域
receiverAddress	string	是	详细地址
serviceType	int	是	服务类型：1安装/2维修/3检测/4保养/5拆机/6其他/7拆装/8回收
paymentWay	int	是	支付方式：1钱包/2支付链接
inGuaranteePeriod	int	是	保修期：0保外/1保内/2其他
details	array	是	商品明细（skuId/skuNum/productBrand/productName 等）
reservationTime	string	否	预约时间

POST

/api/order/open/{version}/skulist

服务商品列表

展开

GET

/api/order/open/{version}/orderinfo

查询订单信息

展开

参数名	类型	必填	说明
orderCode	string	否	熊洞订单号（与 saleOrderNo 二选一）
saleOrderNo	string	否	三方销售单号

POST

/api/order/open/{version}/orderpage

查询订单分页列表

展开

参数名	类型	必填	说明
beginDateTime	string	否	开始时间
endDateTime	string	否	结束时间
customerMobile	string	否	客户手机号
orderCode	string	否	熊洞订单号
saleOrderNo	string	否	三方销售单号
serviceType	int	否	服务类型
pageNo	int	是	页码
pageSize	int	是	每页条数

POST

/api/order/open/{version}/cancelorder

取消订单

展开

参数名	类型	必填	说明
orderCode	string	是	熊洞订单号
cancelReason	string	是	取消原因

POST

/api/order/open/{version}/changereservationtime

更改预约时间

展开

参数名	类型	必填	说明
saleOrderNo	string	是	三方销售单号
reservationTime	string	是	新的预约时间

POST

/api/order/open/{version}/urgentorder

催单

展开

参数名	类型	必填	说明
saleOrderNo	string	是	三方销售单号
urgentContent	string	是	催单内容

GET

/api/order/open/{version}/selSignReceipt

查询电子签收单

展开

参数名	类型	必填	说明
saleOrderNo	string	是	三方销售单号

AI 智能体（MCP）

将熊洞服务的业务能力封装为标准 MCP 工具，AI 智能体（如千问办公、Cursor、Claude Desktop、阿里云百炼等）可直接接入调用，让 AI 真正融入业务运营。

MCP 使用指南包含客户端配置、Token 获取、工具调用示例等完整操作说明

查看使用指南

什么是 MCP

熊洞服务 MCP 服务（juranwuyou-mcp）将家电服务业务能力封装为标准 MCP 工具，AI 客户端（千问办公、Cursor、Claude Desktop、VS Code 等）可通过对话直接查询订单状态、发起催单、取消订单、查询供应商与服务商品、平台代供应商下单，并支持 Excel 批量导入供应商订单，大幅提升服务运营效率。

智能订单管理

AI 直接查询服务订单状态、发起催单、取消订单，服务订单全流程智能处理

供应商批量下单

查询供应商与服务商品、平台代供应商批量下单，支持 Excel 一键批量导入

Excel 智能导入

供应商订单 Excel 批量导入，自动解析供应商全称并匹配下单，杜绝人工录入错误

多客户端支持

兼容千问办公、Cursor、Claude Desktop、VS Code 等主流 AI 客户端

服务信息

服务名juranwuyou-mcp

连接地址https://mcp.bearhome.cn/fwmcp/mcp

鉴权方式请求头（Header）携带 mcptoken点击获取 Token →

传输协议Streamable HTTP / SSE 双模式

服务能力覆盖 3 大类 7 个工具

客户端接入配置

在 AI 客户端（如千问办公、Cursor、Claude Desktop 等）的 MCP 配置中，添加以下配置即可完成接入：

json

{
  "mcpServers": {
    "xiongdong_fw": {
      "url": "https://mcp.bearhome.cn/fwmcp/mcp/sse",
      "type": "sse",
      "headers": {
        "mcptoken": "你的Token"
      },
      "disabled": false
    }
  }
}

配置完成后，可参考 MCP 使用指南完成客户端验证与工具调用 →

工具清单（7 个工具）

订单类

query_order_status

查询订单状态

展开

参数名	类型	必填	说明
orderCode	string	是	订单号（code）

order_urgent

发起催单

展开

参数名	类型	必填	说明
orderCode	string	是	订单号（code）
urgentContent	string	否	催单内容

order_cancel

取消订单

展开

参数名	类型	必填	说明
orderCode	string	是	订单号（code）
labelRemark	string	否	取消备注

供应商下单类

query_supplier

查询供应商

展开

参数名	类型	必填	说明
supplierName	string	是	供应商名称（模糊搜索）

query_supplier_product

查询供应商服务商品

展开

参数名	类型	必填	说明
merchantId	integer	是	供应商（商家）ID
skuName	string	否	服务商品名称（模糊搜索）

create_supplier_order

平台代供应商下单（服务下单）

展开

参数名	类型	必填	说明
merchantId	integer	是	供应商（商家）ID
assetsType	integer	是	结算方式，取值 query_supplier 返回的 assetsType
items	string	是	服务商品列表 JSON 字符串，如 [{"id":6734,"nums":1}]
pricePay	number	是	结算金额（元）
province	string	是	用户省份
city	string	是	用户城市
area	string	是	用户区县
receiverName	string	是	收货人姓名
receiverMobile	string	是	收货人电话
receiverAddress	string	是	收货详细地址
customerName	string	否	客户姓名（默认同收货人）
saleOrderNo	string	否	商家销售单号
contractNo	string	否	商家合同单号
remark	string	否	备注信息
detail	string	否	备注详情

Excel 导入类

import_supplier_order

导入供应商订单（Excel 批量下单）

展开

参数名	类型	必填	说明
filePath	string	否	Excel 文件路径（服务端本机可访问）
fileContent	string	否	Excel 文件内容 Base64 编码（跨机上传必用）
fileName	string	否	文件名，如 order.xlsx
checkRepeat	integer	否	是否校验重复：0 否 / 1 是
expectedSize	integer	否	原 Excel 文件字节数（服务端强制比对）

常见问题

整理了接入熊洞服务 API 过程中最常见的问题与解答。

−接入熊洞服务 API 需要什么条件？

需要提供企业资质信息并申请 APPKEY 和 APPSECRET。特别注意的是，调用方服务器 IP 需要提前报备，IP 变化时需及时联系或后台更改，否则下单会失败。

+签名算法是怎样的？

+服务类型有哪些？

+服务通知有哪些类型？

+工程师隐私信息如何处理？

+支付方式有哪些？

没有找到答案？

如果以上内容未能解决您的问题，请随时联系我们的技术支持团队，我们将为您提供一对一接入指导。

联系技术支持 →

业务介绍

工单智能管理

工程师调度系统

全品类服务能力

服务商品管理

电子签收单

服务通知回调

典型应用场景

电商平台服务嵌入

品牌商售后体系

物业管理集成

连锁门店管理

接入指南

认证方式

注册成为熊洞商家

联系商务审核

获取对接信息

开始联调测试

验收上线

环境地址

API 文档

请求 Body 参数

请求示例

返回示例

请求示例

返回示例

请求 Query 参数

请求示例

返回示例

请求 Body 参数

请求示例

返回示例

请求 Body 参数

请求示例

返回示例

请求 Body 参数

请求示例

返回示例

请求 Body 参数

请求示例

返回示例

请求 Query 参数

请求示例

返回示例

AI 智能体（MCP）

什么是 MCP

智能订单管理

供应商批量下单

Excel 智能导入

多客户端支持

服务信息

客户端接入配置

工具清单（7 个工具）

订单类

参数说明

参数说明

参数说明

供应商下单类

参数说明

参数说明

参数说明

Excel 导入类

参数说明

常见问题

没有找到答案？