一些特殊如代收货款的场景,为便于核算与快递公司代收货款,需要感知客户对快递的签收动作。

一、设置开通

二、跟踪签收

  对订单进行发货以后,系统会自动跟踪快递的流转信息。

三、签收信息

查询已经签收的订单,如果已经签收,会显示“已签收”字样。

四、快递签收消息下发

注意:本事件将下线,请使用第五小节的事件。

  此节为高级内容,一般用户可跳过,对于系统与蜂巢对接,蜂巢将快递签收事件下发。

消息topic 消息说明
fc_erp_logistics_sign 客户签收快递后触发。

  
以上消息需要联系客服开通消息“蜂巢全渠道快递签收”。
 
签收消息示例

{
    "uuid": "COqQBBAHGAAgAA==",
    "code": 0,
    "msg": "success",
    "topic": "fc_erp_logistics_sign",
   "data": "{\"logistics_code\":\"SF\",\"out_trade_no\":\"H5\",\"sign_time\":\"2026-01-22 16:29:51\",\"tid\":\"h202601211637476199\",\"logistics_no\":\"SF3267453357288\",\"sign_status\":1}"
}

data参数说明

参数名 类型 说明
logistics_code String 快递公司代码
logistics_no String 物流单号,如果是子母单,只返回母单号。
out_trade_no String 订单导入时传入自己系统侧的订单号,原样返回
tid String 电商平台的订单号 ,即导入订单时的trade_no , 如果有拆单,此值会在原订单上加序号-x
sign_time String 快递签收时间
sign_status int 1:客户签收, 2:退件签收(即客户退件,商家已签收)

五、快递跟踪事件

  此节为高级内容,一般用户可跳过,对于系统与蜂巢对接,蜂巢将快递签收事件下发。

消息topic 消息说明
fc_erp_logistics_node 快递节点事件,比如异常,拒收,签收

  
以上消息需要联系客服开通消息“蜂巢全渠道快递签收”。
 
签收消息示例

{
    "uuid": "COqQBBAHGAAgAA==",
    "code": 0,
    "msg": "success",
    "topic": "fc_erp_logistics_node",
   "data": "{\"logistics_code\":\"SF\",\"logistics_no\":\"SF5121772464167\",\"op_code\":\"SIGN\",\"op_desc\":\"已签收\",\"op_sub_code\":\"\",\"op_time\":\"2026-03-05 11:22:13\",\"out_trade_no\":\"H5\",\"tid\":\"h202603011127110687\"}"
} 

data参数说明

参数名 类型 说明
logistics_code String 快递公司代码
logistics_no String 物流单号,如果是子母单,只返回母单号。
out_trade_no String 订单导入时传入自己系统侧的订单号,原样返回
tid String 电商平台的订单号 ,即导入订单时的trade_no , 如果有拆单,此值会在原订单上加序号-x
op_time String 快递节点发生时间
sign_status int 1:客户签收, 2:退件签收(即客户退件,商家已签收)
op_code String 节点事件。SIGN: 客户签收, REJECT: 客户拒绝 ,FAILED: 异常
op_sub_code String 节点子事件。RETURN:退回
op_desc String 节点事件描述,比如:您的包裹因已被拒收,如有疑问联系快递小哥余小涛:18767002211

友情提醒: op_code为SIGN为签收,但同时op_sub_code为RETURN就是退回签收,而不是正常的买家签收。

文档更新时间: 2026-03-05 12:01   作者:admin