为方便蜂巢打单和第三方业务系统的交互,同步订单及相关单号信息。第三方系统可以对接蜂巢消息服务,对相关消息事件进行处理。
消息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": "{\"op\":1, \"logistics_code\":\"SF283814214\",\"logistics_name\":\"顺丰\",\"logistics_no\":\"SF283814214\",\"out_trade_no\":\"28832132143\",\"seller_nick\":\"XX旗舰店\",\"tid\":\"108813814128421\",\"status\":1,\"message\":\"成功\"}"
}
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\"}",
}
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 | 电商平台的订单号 |
status | int | 调用电商平台发货是否成功,0:失败,1:成功 |
message | String | 若电商平台发货失败,则包含失败原因 |
说明: data字段发送失败的原因message可能会有多种,常见如下:
- 该物流公司揽收或派送范围不支持
- 订单[3912560886642498520]发货失败,订单状态为[已收货],不是待发货状态
- 当前订单[291066544547]不符合用户行为[1]规则,详情请看文档[https://joyspace.jd.com/pages/oCLTiHpIQphOqPV4crgK]
- 业务服务错误,订单已退款
如果要精确定位失败原因,请根据上面失败原因中的关键字匹配
文档更新时间: 2024-07-04 13:48 作者:admin