注意:以下文档只适用于TOP接口,请谨慎使用!

文档中心 > 电子面单对接知识库

电子面单基本介绍

更新时间:2024/01/22 访问次数:241190

物流公司编码

目前支持的物流公司如下,申请电子面单时需要通过code来识别不同的物流公司,注意大小写

快递

  • 直营型
物流公司 公司编码(取号使用) 资源编码(发货使用)
顺丰 SF SF
EMS标准快递 EMS EMS
宅急送 ZJS ZJS
邮政快递包裹 POSTB POSTB
德邦快递 DBKD DBKD
联邦快递 FEDEX FEDEX
日日顺 100005492 DISTRIBUTOR_13204867
苏宁快递 SNWL DISTRIBUTOR_13452378
菜鸟速递 CP570969 DISTRIBUTOR_13503931
快弟来了 LE14027000 DISTRIBUTOR_30752655
安迅 21000026002 DISTRIBUTOR_13365751
邮政电商标快 EYB EYB
  • 直营带网点型
物流公司 公司编码(取号使用) 资源编码(发货使用)
跨越速运 CN7000001003751 DISTRIBUTOR_13211725
如风达 100004928 BJRFD-001
远成快运 2460304407_385 2460304407_385
九曳供应链 2383545689_32 DISTRIBUTOR_13323734
圆通承诺达 CP468398 DISTRIBUTOR_13469985
  • 加盟型
物流公司 公司编码(取号使用) 资源编码(发货使用)
极兔速递 HTKY HTKY
圆通速递 YTO YTO
中通快递 ZTO ZTO
优速快递 UC UC
国通快递 GTO GTO
天天快递 TTKDEX TTKDEX
全峰快递 QFKD QFKD
申通快递 STO STO
韵达快递 YUNDA YUNDA
安能物流 2608021499_235 DISTRIBUTOR_12017865
山东递速 100007887 DISTRIBUTOR_13460212
信丰物流 XFWL XFWL
百世云配 CP443514 DISTRIBUTOR_13468073
京广速递 CP449455 DISTRIBUTOR_13462882
韵达同城 LE10032270 DISTRIBUTOR_30506953
平安达腾飞 CP446881 DISTRIBUTOR_13468071
丰网速运 LE09252050 DISTRIBUTOR_30464910
融阅物流 LE21354850 DISTRIBUTOR_31071684

快运

  • 直营带网点型
物流公司 公司编码(取号使用) 资源编码(发货使用)
德邦快运 CN7000001009020 DISTRIBUTOR_13327526
壹米滴答 2744832184_543 2744832184_543
百世快运 BESTQJT BESTQJT
天地华宇 HOAU HOAU
中铁快运 ZTKY ZTKY
安得物流 100002392 DISTRIBUTOR_13211787
  • 加盟型
物流公司 公司编码(取号使用) 资源编码(发货使用)
中通快运 3108002701_1011 DISTRIBUTOR_13222803
安能快运 CN7000001000869 DISTRIBUTOR_12017865
韵达快运 CN7000001021040 DISTRIBUTOR_13421750
申通快运 CN7000001017817 DISTRIBUTOR_13422944
速尔快运 SURE SURE
加运美 CP446169 DISTRIBUTOR_13468074
顺心捷达 CP471906 DISTRIBUTOR_13484485
速腾快递 CN7000001028572 DISTRIBUTOR_13509344
中通冷链 LE14066700 DISTRIBUTOR_30764443

注:
电子面单取号接口请传入公司编码的值,发货接口请传入资源编码的值。

关于子母单

目前快运都支持子母单,快递支持子母单(仅top链路支持)的有:顺丰速递,德邦快递,平安达腾飞,跨越速运,京广速递。
除了顺丰,子母单都不支持追加,第一次传入的总包裹数是几,只能取几个号。
快递走子母单,取号参数multi_packages_shipment传true,总包裹数必传,同样的订单号,不同包裹号,具体可参考快运白皮书 https://support-cnkuaidi.taobao.com/doc.htm#?docId=108902&docType=1
PS:快运子母单逻辑,总包裹数必传,物流服务必传,同样的订单号,不同包裹号。

直营加盟物流公司

对于加盟型的物流公司有网点的概念。商家需要订购网点,并且管理网点的余额。

订单渠道

商家申请电子面单时,需要上传订单信息。包括渠道code、订单号信息,渠道code见下,订单号要上传对应平台的订单号。淘系即是淘宝订单号。

Order Channel 渠道描述
TB 淘宝
TM 天猫
JD 京东
PP 拍拍
YX 易讯
DD 当当
EBAY EBAY
AMAZON 亚马逊
QQ QQ
SN 苏宁
GM 国美
WPH 唯品会
JM 聚美
LF 乐蜂
MGJ 蘑菇街
JS 聚尚
PX 拍鞋
YT 银泰
YHD 1号店
VANCL 凡客
YL 邮乐
YG 优购
1688 1688
YOU_ZAN 有赞
PIN_DUO_DUO 拼多多
ZHE_800 折800
CHU_CHU_JIE 楚楚街
JUAN_PI 卷皮
BEI_BEI 贝贝
WEI_DIAN 微店
QIAN_MI 千米
MEI_LI_SHUO 美丽说
FAN_LI 返利
MENG_DIAN 萌店
YAN_XUAN 网易严选
WEI_MENG 微盟
WEI_SHANG 微商
XIAO_MI 小米
KAO_LA 考拉
MI_YA 蜜芽
YUN_JI 云集
BEI_DIAN 贝店
XIAN_YU 闲鱼
WAN_WU_DE_ZHI 玩物得志
DOU_YIN 抖音
KUAI_SHOU 快手
XIAO_HONG_SHU 小红书
HUAWEI 华为
YANG_MA_TOU 洋码头
WO_MAI 我买
JIU_XIAN_WANG 酒仙网
BEN_LAI_SHENG_HUO 本来生活
DU
OTHERS 其他

注意: 使用时能够确定的电商平台尽量都用其对应的电商平台编码,不推荐使用OTHERS。

菜鸟打印组件

电子面单有统一的面单模板标准,电子面单系统提供的菜鸟打印组件已经内嵌了目前支持的物流公司的标准模板,不再需要ISV进行画制。ISV也可以利用打印组件进行自定义模板(拣货单、纸质面单等)的打印。在申请电子面单时,需要携带标准模板的URL,通过cainiao.cloudprint.stdtemplates.get获得。

订购关系

商家如果使用电子面单,必须要订购电子面单服务。电子面单系统通过发货地址来匹配用户订购的电子面单服务。
对于加盟型的物流公司,通过发货地址来映射到具体的发货网点。(不同网点的订购地址尽量区别)
如果没有发货地址没有匹配到订购服务,会返回“发货地址没有匹配的电子面单服务”错误,为了保证发货地址的正确性,请使用search接口获取用户已经订购的发货地址。

电子面单余额

电子面单余额的概念只在加盟型物流公司有效。
申请面单时,需要保证面单余额充足,否则会报“电子面单余额不足”错误。
商家余额是由商家线下与物流公司沟通,物流公司对商家账号进行充值。每次取号会对余额进行扣减,扣减到不足够申请面单时,会报错。
商家对于没有使用的面单号,可以进行取消,但是取消后不会立即回充余额,需要等到面单回收后,再对商家的余额进行回充。

电子面单状态解释

  1. 已揽收、已签收、回收的面单不允许再进行取消动作。
  2. 已取消、已回收的面单号不允许再进行发货、揽收等动作。

物流产品

在申请电子面单时,可以为面单绑定物流产品信息,目前支持代收货款服务。 电子面单系统会将物流服务信息下发到物流公司,并且在面单纸上进行展示。
ISV可以根据订单上的物流服务自动绑定申请面单的产品服务。

分拣信息

分拣信息是物流公司对包裹分拣、路由的有效信息,根据收发地址进行计算得到。 电子面单系统在返回这些信息(集包地、大头笔、三段码等),目前很多网点有要求,面单上必须要有分拣信息。
目前分拣信息上有时会返回数字,这种是正常的,是物流公司的编码。
有些情况分拣信息没有计算出,返回为空。这种情况一般是收货地址不标准。
对于一些地址为高新区、其它区的地址,是难以计算分拣信息的,需要商家提供更细致的地址才能够计算。
下面几种情况是得不到分拣信息的:
1. 没有 区、街道信息 province:浙江省;city:杭州市;detial:西溪园区四号楼
2. 区 为其它区,高新区之类 province:浙江省;city:杭州市; district:其它区; detial:西溪园区四号楼

拆合单及退换货

对于拆单发货和合单发货的面单,以及同一订单需要进行换货重新取号的场景,电子面单那系统通过package_info.id来实现。(下图中的package_id就是package_info.id)

拆合单
假设一个电商订单号(比如淘宝订单号)买的宝贝用一个包裹发不下,需要拆成两个包裹来发,那么就是下面的模型:

image
退换货
如果一个订单发货之后又需要退换货,之前一、二期是不能重新获取面单号的,三期中可以通过使用不同package_info.id来实现,场景模型如下
(1)第一次正常下单发货模型:
image
(2)申请换货,重新发货模型:
image

拆合单场景枚举
注:tid订单号,pid包裹号(ERP订单号),wb电子面单号

应用场景 场景描述 使用模型 描述
拆单 一个订单发两个包裹 tid1 + pid1 => wb1
tid1 + pid2 => wb2
生成两个包裹的面单号
合单 两个订单发一个包裹 (tid1+tid2) + pid1 => wb1 生成一个面单号
退换货 该订单需要重新发货 tid1 + pid1 => wb1
tid1 + pid2 => wb2
生成两个包裹的面单号
拆单再合单 合单不能改变原有的组合 tid1 + pid1 => wb1
(tid1+tid2) + pid2 => wb2
生成两个包裹的面单号
错误的合单 订单1一部分自己发一个包裹,一部分和订单2合包 tid1 + pid1 => wb1
(tid1+tid2) + pid1 => wb2
返回错误。1.如果是想tid2和tid1合单,要先cancel,在执行第二步。2.如果想tid1拆单之后在和tid2合单,第二步改成pid2.
部分订单查询功能 合单之后,可以通过其中一个订单来查询面单号信息 (tid1+tid2) + pid1 => wb1
tid1 + pid1 => wb1
合单成功,通过其中某个订单返回对应的面单信息.(第一步是获取,第二步是查询)
合单再拆单 tid1一部分和tid2一起合包,一部分自己一包 (tid1+tid2) + pid1 => wb1
tid1 + pid2 => wb2
生成两个面单号
特殊拆包 tid1拆包操作,但第二次pid传了-1或者不传 tid1 + pid1 => wb1
tid1 + (-1) => wb2
认为是拆单,建议ISV不要传-1或不传
Get接口重新获取面单号 tid+pid对应的面单号状态为已取消时 / 返回新获取的面单号(即获取功能)
Get接口获取原先的面单号 tid+pid对应的面单号状态为已分配;已确认打印;已揽收;已签收时 / 返回原先的单号(即查询功能)

批量接口顺序

电子面单不保证出参顺序与入参顺序保持一致 需要通过objectId进行识别
在入参和出参中都有objectId字段
此字段与业务无关,在批量调用时,需要保证每个对象的objectid不同,在获取到返回值后,可以通过比对出参中的objectId,可以得到与入参的对应关系。
只需要在一次请求中保证不同即可。可以用索引下标代替

接口出参解释

在请求到出参后,可以根据打印组件发送协议要求,拼装打印请求,向打印组件发送打印消息,进行打印。

printData 值解释

{
    "signature": "RSA:hqUkugCY2FFXJK10fRcUE0TsvDppxXuBdOEnPVntF3u4H2yaYiPsPXqjdI1C5oXs60vVCfqd8YC6vZx57TnN9/u0VYM/TiFmMtxix9ouPQ2p7G64UyX9BrnRQQCp5ETqJogSzIpxVlz5rx3hy19C+VQrqWgQEw5JqOkoBFXhMi8",   // 打印签名信息,打印组件使用,使用者不需关心
    "templateURL": "http://cloudprint.cainiao.com/cloudprint/template/getStandardTemplate.json?template_id=1001",// 打印模板信息,打印组件使用,使用者不需关心
"data":{
    "recipient": {//收件人信息
        "address": {
            "city": "北京市",
            "detail": "花家地社区卫生服务站",
            "district": "朝阳区",
            "province": "北京",
            "town": "望京街道"
        },
        "mobile": "1326443654",  //手机号码
        "name": "Bar", 
        "phone": "057123222" // 固定电话
    },
    "routingInfo": {  // 路由信息
        "consolidation": {"name":"集包地","code":"123"}, //集包地信息
        "origin": {  //发件网点信息
            "code": "POSTB","name":"发件网点名称"
        },
        "sortation": {//  大头笔信息
            "name": "杭州"
        },
        "dmsSortingInfo": {// 落地配仓库系统调用智分宝DMS预分拣返回结果,根据智分宝返回的信息展示
                "siteAreaCode": "",
                "siteAreaName": "",
                "citySimpleCode": ""
         }
        "routeCode":"12-121-1"  //三段码信息
    },
    "sender": {// 发件信息
        "address": {
            "city": "北京市",
            "detail": "花家地社区卫生服务站",
            "district": "朝阳区",
            "province": "北京",
         
   "town": "望京街道"
        },
        "mobile": "1326443654",
        "name": "Bar",
        "phone": "057123222"
    },
    "shippingOption": {
        "code": "COD",// 产品编码
        "services": {,//服务
            "SVC-COD": {
                "value": "200"
            }
        },
        "title": "代收货款" ,//产品名称
    },
    "cpCode":"POSTB",
    "waybillCode": "9890000160004",//面单号
}
}

注意:这里和之前接口的区别有一点要注意,以前的大头笔,在云打印接口中拆分成sortation ,routeCode.

风控

为保障电子面单商家的正常使用电子面单的权益,需要对渠道code、订单号、使用者id保证正确。
如果传错,可能会导致商家发货失败。

FAQ

关于此文档暂时还没有FAQ
返回
顶部