开通快递签收回传

核心场景 开通快递签收状态回传能力。

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

一、设置开通

二、跟踪签收

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

三、签收信息

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

四、快递签收消息下发

注意：本事件将下线，不再推送，请使用第五小节的事件。

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

消息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\"，\"op_message \",\"客户已签收快递\"}"
}

data参数说明

参数名	类型	说明
logistics_code	String	快递公司代码
logistics_no	String	物流单号，如果是子母单，只返回母单号。
out_trade_no	String	订单导入时传入自己系统侧的订单号,原样返回
tid	String	电商平台的订单号 ,即导入订单时的trade_no , 如果有拆单，此值会在原订单上加序号-x
op_time	String	快递节点发生时间
op_code	String	节点事件。SIGN: 客户签收, REJECT:　客户拒绝　，FAILED: 异常
op_sub_code	String	节点子事件。RETURN:退回
op_desc	String	节点事件描述
op_message	String	节点事件说明，比如：已和客户约定重新派送时间等。
友情提醒：　op_code为SIGN为签收，但同时op_sub_code为RETURN就是退回签收，而不是正常的买家签收。　第四节中的sign_status可以根据这2个字段判断得出。