为方便蜂巢打单和第三方业务系统的交互,同步订单及相关单号信息。第三方系统可以对接蜂巢消息服务,对相关消息事件进行处理。

消息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可能会有多种,常见如下:

  1. 该物流公司揽收或派送范围不支持
  2. 订单[3912560886642498520]发货失败,订单状态为[已收货],不是待发货状态
  3. 当前订单[291066544547]不符合用户行为[1]规则,详情请看文档[https://joyspace.jd.com/pages/oCLTiHpIQphOqPV4crgK]
  4. 业务服务错误,订单已退款

如果要精确定位失败原因,请根据上面失败原因中的关键字匹配

文档更新时间: 2024-07-04 13:48   作者:admin