为方便蜂巢打单和第三方业务系统的交互,同步订单及相关单号信息。第三方系统可以对接蜂巢消息服务,对相关消息事件进行处理。
| 消息topic | 消息说明 | 第三方系统订单状态变更 | 第三方系统退款状态变更 |
|---|---|---|---|
| fc_print_trade_print_finish | 蜂巢打单电子面单打印完成,做了发货的操作动作触发。 |
蜂巢打单电子面单打印完成,做了发货的操作动作触发。 发货可能成功,也可能会失败。 如果是失败的话,会有失败的原因,不管成功或失败, 蜂巢会推送发货的结果给您, 如有必要,您可以根据失败原因进一步处理业务逻辑。
以上消息需要开发者开通对应的消息权限。
1. 蜂巢打单电子面单打印完成(fc_print_trade_print_finish)
消息生产条件: 在蜂巢打单系统中,点发货完成,产生此消息,推送的消息格式如下:
1. 成功的示例
{
"uuid": "CNK+ChAAGAAgAA==",
"code": 0,
"msg": "success",
"topic": "fc_print_trade_print_finish",
"data": "{
\"logistics_code\": \"SF\",
\"logistics_name\": \"顺丰快递\",
\"logistics_no\": \"SF3270428903757\",
\"message\": \"成功\",
\"op\": 9,
\"orders\": [
{
\"order_id\": \"DO202511071126162748211\",
\"qty\": 12
}
],
\"out_trade_no\": \"DO20251107112616274821\",
\"seller_nick\": \"全渠道店铺\",
\"status\": 1,
\"tid\": \"DO20251107112616274821\"
}"
}
2. 失败的示例
{
"uuid": "CNK+ChAAGAAgAA==",
"code": 0,
"msg": "success",
"topic": "fc_print_trade_print_finish",
"data": "{\"logistics_code\":\"ZJS\",\"logistics_name\":\"宅急送\",\"logistics_no\":\"ZJS000383452882\",\"message\":\"订单[3912560886642498520]发货失败,订单状态为[已收货],不是待发货状态。\",\"op\":6,\"seller_nick\":\"b2b-1624961198\",\"status\":0,\"tid\":\"3912560886642498520\" , \"orders\": [{ \"order_id\": \"DO202511071126162748211\", \"qty\": 12 }]}",
}
data参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| op | int | 电商平台编码,1:淘宝, 2:拼多多 , 3:抖店OMS , 5:京东 , 6:1688 ,8:快手 |
| logistics_code | String | 快递公司代码 |
| logistics_name | String | 快递公司名称 |
| logistics_no | String | 物流单号 |
| out_trade_no | String | 订单导入时传入自己系统侧的订单号,原样返回 |
| seller_nick | String | 电商平台的商家账号 |
| tid | String | 电商平台的订单号 ,即导入订单时的trade_no , 如果有拆单,此值会在原订单上加序号-x |
| orders | 集合 | 订单中商品明细列表 |
| --order_id | String | 订单中的子订单明细标识order_id,即导入订单时的order_id,原样返回 |
| --qty | int | 商品明细里数量。 |
| status | int | 调用电商平台发货是否成功,0:失败,1:成功 |
| message | String | 若电商平台发货失败,则包含失败原因 |
说明: data字段发送失败的原因message可能会有多种,常见如下:
- 该物流公司揽收或派送范围不支持
- 订单[3912560886642498520]发货失败,订单状态为[已收货],不是待发货状态
- 当前订单[291066544547]不符合用户行为[1]规则,详情请看文档[https://joyspace.jd.com/pages/oCLTiHpIQphOqPV4crgK]
- 业务服务错误,订单已退款
如果要精确定位失败原因,请根据上面失败原因中的关键字匹配。
文档更新时间: 2025-11-11 14:36 作者:admin