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

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

三、签收信息
查询已经签收的订单,如果已经签收,会显示“已签收”字样。
四、快递签收消息下发
注意:本事件将下线,请使用第五小节的事件。
此节为高级内容,一般用户可跳过,对于系统与蜂巢对接,蜂巢将快递签收事件下发。
| 消息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