跳转到内容
Cheeli 文档
返回官网

消息通知

核心场景 系统消息/回调通知相关说明。

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

消息topic消息说明第三方系统订单状态变更第三方系统退款状态变更
fc_print_trade_print_finish蜂巢打单电子面单打印完成，做了发货的操作动作触发。

蜂巢打单电子面单打印完成，做了发货的操作动作触发。 发货可能成功，也可能会失败。 如果是失败的话，会有失败的原因，不管成功或失败， 蜂巢会推送发货的结果给您， 如有必要，您可以根据失败原因进一步处理业务逻辑。

以上消息需要开发者开通对应的消息权限。

蜂巢打单电子面单打印完成

fc_print_trade_print_finish

消息生产条件： 在蜂巢打单系统中，点发货完成，产生此消息，推送的消息格式如下：

一、成功的示例

{
"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\"
}"
}

二、失败的示例

{
"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参数说明

参数名类型说明
opint电商平台编码，1：淘宝， 2：拼多多 ， 3：抖店OMS ， 5：京东 ， 6：1688 ，8：快手
logistics_codeString快递公司代码
logistics_nameString快递公司名称
logistics_noString物流单号，如果有多个单号，使用用逗号隔开。如子母单。第1个是母单号。
out_trade_noString订单导入时传入自己系统侧的订单号,原样返回
seller_nickString电商平台的商家账号
tidString电商平台的订单号 ,即导入订单时的trade_no , 如果有拆单，此值会在原订单上加序号-x
orders集合订单中商品明细列表
－－order_idString订单中的子订单明细标识order_id，即导入订单时的order_id，原样返回
－－qtyint商品明细里数量。
statusint调用电商平台发货是否成功，0：失败，1：成功
messageString若电商平台发货失败，则包含失败原因

说明： data字段发送失败的原因message可能会有多种，常见如下：

  1. 该物流公司揽收或派送范围不支持

  2. 订单[3912560886642498520]发货失败,订单状态为[已收货]，不是待发货状态

  3. 当前订单[291066544547]不符合用户行为[1]规则,详情请看文档[https://joyspace.jd.com/pages/oCLTiHpIQphOqPV4crgK]

  4. 业务服务错误,订单已退款

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