为了提升商家发货效率、降低发货成本,菜鸟电子面单开始逐步支持国内快运公司。该方案可以解决多环节打单、贴单的问题,实现一单到底,节省成本、提升效率。
本次接入的网络型快运公司有
快运公司
cpCode
德邦快运
CN7000001009020
百世快运
BESTQJT
安能快运
CN7000001000869
壹米滴答
2744832184_543
韵达快运
CN7000001021040
中通快运
3108002701_1011
速尔快运
SURE
申通快运
CN7000001017817
卡行天下快运
CP457538
天地华宇
HOAU
顺心捷达
CP471906
加运美快递
LE33128010
中铁快运
ZTKY
中铁智慧物流
LE32538030
速腾快递
CN7000001028572
顺丰快运
SF
中邮快运
FJZYWL
源之安达速运
LE04826230
京东快运
LE38289910
快捷快物流
LE05872340
目前快运的物流公司都是独立的cpCode,比如德邦快递和德邦快运,是不同的cpCode,当快运电子面单取号时,直接获取子母件单号。
注:中铁智慧物流为中铁快运(ZTKY)的新CP,后期中铁快运将逐步下线。
注意子母单号生成递增序号是基于之前取到的序号之上的,如果并发来获取,可能会导致两个请求同时到达系统,会导致只有一个成功取到单号,因此大家对于子母单件必须是串行取号,前一个单号生成了再获取下个单号。
ISV要支持用户填入获取快运子母件的必要参数,并且支持用户选择快递公司提供的物流服务。当商家使用ERP系统填入需要获取的总件数,
以下给出的服务定义,仅供参考,实际服务选择应该以接口返回的数据,动态来创建。
CPCode
ServiceCode
服务名称
服务描述
需要审核
需要订购
需要属性
需要必填
属性描述
安能快运(CN7000001000869)
SVC-INSURE
保价服务
false
true
[{"name":"保价金额","type":{"min":0,"type":"number","required":true},"key":"value"}]安能快运(CN7000001000869)
SVC-ANE56-PAYMENT-TYPE
安能物流产品支付类型服务
[{"name":"支付类型","type":{"type":"enum","required":true,"desc":{"102":"现金","103":"到付","104":"月结"}},"key":"value"}]安能快运(CN7000001000869)
SVC-ANE56-DELIVERY-TYPE
安能物流配送类型服务
[{"name":"配送类型","type":{"type":"enum","required":true,"desc":{"179":"送货上楼","180":"送货上门","285":"自提"}},"key":"value"}]安能快运(CN7000001000869)
SVC-ANE56-PRODUCT-TYPE
安能物流产品类型服务
安能物流产品类型
[{"name":"产品类型","type":{"type":"enum","required":true,"desc":{"23":"定时达,重量>70KG","24":"标准快运","211":"易碎品(标准快运),重量>70KG","212":"易碎品(定时达),重量>70KG","213":"易碎品(mini小包),重量<=70KG","270":"普惠达,重量>1000KG","95":"MINI大件,重量>70KG"}},"key":"value"}]韵达快运(CN7000001021040)
SVC-YDKY-DELIVERY-RECEIPT
签收回单
[{"name":"签收回单","type":{"type":"enum","required":true,"desc":{"SIGNED":"签回单"}},"key":"value"}]韵达快运(CN7000001021040)
SVC-YDKY-BIZ-TYPE
韵达快运业务类型
[{"name":"业务类型","type":{"type":"enum","required":true,"desc":{"ECOMMERCE":"电商"}},"key":"value"}]韵达快运(CN7000001021040)
SVC-YDKY-PRODUCT-TYPE
韵达快运产品类型
[{"name":"产品类型","type":{"min":0,"type":"enum","required":true,"desc":{"YDKY-PROMISED-DELIVERY":"韵准达","YDKY-168":"168大件","YDKY-YUE-PROMISED-DELIVERY":"粤准达","STANDARD_EXPRESS":"标准快运"}},"key":"value"}]韵达快运(CN7000001021040)
用于定义保价金额
[{"name":"保价金额","type":{"min":0,"type":"number","required":true},"key":"value"}]韵达快运(CN7000001021040)
SVC-YDKY-PAYMENT-TYPE
韵达支付类型服务
用于定义运费的付款方式
[{"name":"付款方式","type":{"type":"enum","required":true,"desc":{"RECEIVER-PAY":"到付","MONTHLY-PAY":"月结","CASH":"现金"}},"key":"value"}]韵达快运(CN7000001021040)
SVC-YDKY-DELIVERY-TYPE
派送方式
[{"name":"派送方式","type":{"type":"enum","required":true,"desc":{"FLOOR":"送货上楼","SELF":"自提","SEND":"派送"}},"key":"value"}]壹米滴答快运(2744832184_543)
SVC-YMDD-TIMED-DELIVERY
壹米滴答时效服务
[{"name":"运输方式","type":{"type":"enum","required":true,"desc":{"1":"标准件","2":"次日达","3":"次晨达","4":"优运件","5":"内部件"}},"key":"value"}]壹米滴答快运(2744832184_543)
SVC-YMDD-PAYMENT-TYPE
壹米滴答支付类型服务
[{"name":"付款方式","type":{"type":"enum","required":true,"desc":{"1":"寄付","2":"到付","3":"月结"}},"key":"value"}]壹米滴答快运(2744832184_543)
SVC-YMDD-DELIVERY-TYPE
壹米滴答配送类型服务
用于定义收货客户的提货方式
[{"name":"提货方式","type":{"type":"enum","required":true,"desc":{"1":"港到门","2":"港到港","3":"门到门","4":"门到港"}},"key":"value"}]百世物流(BESTQJT)
SVC-BESTQJT-DELIVERY-RECEIPT
[{"name":"回单方式","type":{"type":"enum","required":true,"desc":{"RECEIPT":"原单","PHOTO":"拍照"}},"key":"value"}]百世物流(BESTQJT)
SVC-BESTQJT-DELIVERY-SERVICE
百世配送类型增值服务
[{"name":"增值服务","type":{"type":"enum","required":true,"desc":{"UPSTAIRS":"上楼","WAREHOUSE":"进仓"}},"key":"value"}]百世物流(BESTQJT)
SVC-BESTQJT-COD
百世货到付款服务
[{"name":"金额","type":{"min":0,"type":"number","required":true},"key":"value"},{"name":"开户名","type":{"minLength":1,"type":"string","maxLength":128,"required":true},"key":"name"},{"name":"开户账户","type":{"minLength":0,"type":"string","maxLength":128,"required":true},"key":"account"},{"name":"退款方式","type":{"type":"enum","required":true,"desc":{"TODAY":"即日退","THREE-DAYS":"三日退"}},"key":"refunds"}]百世物流(BESTQJT)
SVC-BESTQJT-TRANSPORT-TYPE
百世运输类型服务
[{"name":"运输类型","type":{"type":"enum","required":true,"desc":{"ECOMMERCE":"电商"}},"key":"value"}]百世物流(BESTQJT)
SVC-BESTQJT-INSURE
[{"name":"保价金额","type":{"min":0,"type":"number","required":true},"key":"value"}]百世物流(BESTQJT)
SVC-BESTQJT-RECEIVER-PAY
百世到付
[{"name":"到付金额","type":{"min":0,"type":"number","required":true},"key":"value"}]百世物流(BESTQJT)
SVC-BESTQJT-DELIVERY-TYPE
百世配送类型服务
[{"name":"配送类型","type":{"type":"enum","required":true,"desc":{"SELF":"自提","SEND":"送货"}},"key":"value"}]德邦快运(CN7000001009020)
SVC-DELIVERY-RECEIPT
德邦签收回单
德邦签收回单服务
[{"name":"签收回单","type":{"type":"enum","required":true,"desc":{"BILL_SIGNED_FAX":"运单到达联传真返回","CUSTOMER_SIGNED_ORIGINAL":"签收单原件返回","CUSTOMER_SIGNED_FAX":"客户签收单传真返回","NO_RETURN_SIGNED":"无需返单"}},"key":"value"}]德邦快运(CN7000001009020)
TRANSPORT-TYPE
德邦运输类型服务
[{"name":"运输方式","type":{"type":"enum","required":true,"desc":{"SLOW-TRUCKS":"慢车","FAST-TRUCKS":"快车"}},"key":"value"}]德邦快运(CN7000001009020)
SVC-COD
德邦货到付款
[{"name":"金额","type":{"min":0,"type":"number","required":true},"key":"value"},{"name":"开户名","type":{"minLength":1,"type":"string","maxLength":128,"required":true},"key":"name"},{"name":"开户账户","type":{"minLength":1,"type":"string","maxLength":128,"required":true},"key":"account"},{"name":"退款方式","type":{"type":"enum","required":true,"desc":{"TODAY":"即日退","THREE-DAYS":"三日退"}},"key":"refunds"}]德邦快运(CN7000001009020)
[{"name":"保价金额","type":{"min":0,"type":"number","required":true},"key":"value"}]德邦快运(CN7000001009020)
PAYMENT-TYPE
德邦支付类型服务
[{"name":"支付类型","type":{"type":"enum","required":true,"desc":{"RECEIVER-PAY":"到付","MONTHLY":"月结","SENDER-PAY":"现付"}},"key":"value"}]德邦快运(CN7000001009020)
DELIVERY-TYPE
德邦配送类型服务
[{"name":"配送类型","type":{"type":"enum","required":true,"desc":{"UPSTAIRS":"上楼","SELF":"自提","SEND":"送货"}},"key":"value"}]速尔快递(SURE)
签收单
[{"name":"签收单的返单类型","type":{"type":"enum","required":true,"desc":{"BILL_SIGNED_FAX":"运单到达联传真返回","CUSTOMER_SIGNED_ORIGINAL":"签收单原件返回","CUSTOMER_SIGNED_FAX":"客户签收单传真返回","NO_RETURN_SIGNED":"无需返单"}},"key":"value"}]速尔快递(SURE)
SVC-TRANSPORT-TYPE
运输方式
[{"name":"运输方式","type":{"type":"enum","required":true,"desc":{"VEHICLE":"汽运","AIR":"空运"}},"key":"value"}]速尔快递(SURE)
保价
[{"name":"保价金额","type":{"min":0,"type":"number","required":true},"key":"value"}]速尔快递(SURE)
付款方式
[{"name":"付款方式","type":{"type":"enum","required":true,"desc":{"RECEIVER-PAY":"到付","SENDER-MONTHLY-PAY":"寄付月结","SENDER-PAY":"寄付"}},"key":"value"}]速尔快递(SURE)
SVC-DELIVERY-TYPE
交货方式
[{"name":"提货方式","type":{"type":"enum","required":true,"desc":{"SELF":"自提","SEND":"派送"}},"key":"value"}]中通快运(3108002701_1011)
SVC-ZTOKY-DELIVERY-RECEIPT
中通快运签收回单
[{"name":"签收回单","type":{"type":"enum","required":true,"desc":{"BILL_SIGNED_FAX":"运单到达联传真返回","CUSTOMER_SIGNED_ORIGINAL":"签收单原件返回","CUSTOMER_SIGNED_FAX":"客户签收单传真返回","NO_RETURN_SIGNED":"无需返单"}},"key":"value"}]中通快运(3108002701_1011)
SVC-ZTOKY-COD
中通快运代收货款
[{"name":"金额","type":{"min":0,"type":"number","required":true},"key":"value"},{"name":"开户名","type":{"minLength":1,"type":"string","maxLength":128,"required":true},"key":"name"},{"name":"开户账户","type":{"minLength":1,"type":"string","maxLength":128,"required":true},"key":"account"},{"name":"退款方式","type":{"type":"enum","required":true,"desc":{"TODAY":"即日退","THREE-DAYS":"三日退"}},"key":"refunds"}]中通快运(3108002701_1011)
SVC-ZTOKY-TRANSPORT-TYPE
中通快运运输类型
[{"name":"运输类型","type":{"type":"enum","required":true,"desc":{"STANDARD":"标准快运"}},"key":"value"}]中通快运(3108002701_1011)
[{"name":"保价金额","type":{"min":0,"type":"number","required":true},"key":"value"}]中通快运(3108002701_1011)
SVC-ZTOKY-PAYMENT-TYPE
中通快运付款方式
[{"name":"付款方式","type":{"type":"enum","required":true,"desc":{"RECEIVER-PAY":"到付","MONTHLY":"月结"}},"key":"value"}]中通快运(3108002701_1011)
SVC-ZTOKY-DELIVERY-TYPE
中通快运配送方式
[{"name":"配送方式","type":{"type":"enum","required":true,"desc":{"SELF":"自提","SEND":"派送"}},"key":"value"}]卡行天下快运(CP457538)
SVC-KX-DELIVERY-RECEIPT
[{"name":"回单类型","type":{"type":"enum","required":true,"desc":{"ELECTRONIC_RECEIPT":"电子回单","PAPER_RECEIPT":"纸质回单"}},"key":"value"}]卡行天下快运(CP457538)
SVC-KX-COD
卡行代收货款
[{"name":"代收货款金额","type":{"type":"number","required":true"min":0,},"key":"value"}]卡行天下快运(CP457538)
SVC-KX-INSURE
[{"name":"保价金额","type":{"type":"number","required":true"min":0,},"key":"value"}]卡行天下快运(CP457538)
SVC-KX-PAYMENT-TYPE
[{"name":"付款方式","type":{"type":"enum","required":true,"desc":{"SENDER-PAY":"现付","RECEIVER-PAY":"提付","SENDER-PAY-WITH-RECEIPT":"回付","SENDER-MONTHLY-PAY":"现付月结"}},"key":"value"}]卡行天下快运(CP457538)
SVC-KX-DELIVERY-TYPE
提货方式
[{"name":"提货方式","type":{"type":"enum","required":true,"desc":{"SEND":"派送","SELF":"自提"}},"key":"value"}]天地华宇(HOAU)
SVC-HOAU-DELIVERY-RECEIPT
用于定义签收单的返单类型,枚举值:无需返单、签收单原件返回、签收单传真返回、运单到达联传真返回
[{"name":"回单类型","type":{"type":"enum","required":true,"desc":{"CUSTOMER_SIGNED_ORIGINAL":"签收单原件返回","CUSTOMER_SIGNED_FAX":"客户签收单传真返回","NO_RETURN_SIGNED":"无需返单"}},"key":"value"}]天地华宇(HOAU)
SVC-HOAU-COD
代收货款
用于提供COD服务所需要的必要字段,如果cod金额大于0,则开户名,开户账户不能为空,如果退款类型为空,则默认三日退。其中退款类型枚举值:三日退、即日退
[{"name":"代收货款类型","type":{"type":"enum","required":true,"desc":{"1":"即日退","2":"三日退"}},"key":"value"}]天地华宇(HOAU)
SVC-HOAU-TRANSPORT-TYPE
用于定义运输方式,枚举值:快车、慢车
[{"name":"运输方式","type":{"type":"enum","required":true,"desc":{"10000000000000000001":"定日达","30000000000000000001":"经济快运"}},"key":"value"}]天地华宇(HOAU)
SVC-HOAU-INSURE
[{"name":"保价金额","type":{"type":"number","required":true,"min":0},"key":"value"}]天地华宇(HOAU)
SVC-HOAU-PAYMENT-TYPE
用于定义运费的付款方式,枚举值:到付、月结
[{"name":"付款方式","type":{"type":"enum","required":true,"desc":{"ARRIVAL_PAYMENT":"到货付清","CASH_PAYMENT":"发货付清","SHIPPER_SETTLEMENT":"发货结算"}},"key":"value"}]天地华宇(HOAU)
SVC-HOAU-DELIVERY-TYPE
用于定义收货客户的提货方式,枚举值:自提、派送
[{"name":"配送方式","type":{"type":"enum","required":true,"desc":{"PICKUPSELF":"自提","DELIVERY":"送货上门","BIGUPSTAIRS":"大件送货上楼","SMALLUPSTAIRS":"小件送货上楼"}},"key":"value"}]源之安达速运(LE04826230)
SVC-PAYMENT-TYPE
1、到付:运费由收件方支付;2、现金:运费由寄件方支付;3、月结:寄件方跟物流公司签署月结协议,运费月结。
[{"name":"付款方式","type":{"type":"enum","required":true,"desc":{"RECEIVER-PAY":"到付","ON-DELIVERY":"现金","MONTHLY":"月结"}},"key":"value"}]源之安达速运(LE04826230)
广东省内
[{"name":"代收货款金额","type":{"type":"enum","required":true,"desc":{"max":15000,"min":0}},"key":"value"}]顺心捷达(CP471906)
代收货款金额
[{"name":"代收货款金额","type":{"type":"number","required":true,"min":0},"key":"value"}]顺心捷达(CP471906)
保价金额
[{"name":"保价金额","type":{"type":"number","required":true,"min":0},"key":"value"}]顺心捷达(CP471906)
SVC-SIGN-TYPE
签单方式
用于定义收货客户的签单方式,枚举值:原件回单、电子回单
[{"name":"签单方式","type":{"type":"enum","required":true,"desc":{"ORIG_RECEIPT":"原件回单","ElEC_RECEIPT":"电子回单"}},"key":"value"}]顺心捷达(CP471906)
用于定义发货客户的付款方式,枚举值:到付、寄付、月付
[{"name":"付款方式","type":{"type":"enum","required":true,"desc":{"RECEIVER-PAY":"到付","ON-DELIVERY":"寄付","MONTHLY":"月结"}},"key":"value"}]顺心捷达(CP471906)
送货方式
用于定义收货客户的送货方式,枚举值:自提、送货上楼(无电梯)、送货上楼(有电梯)、送货(不含上楼)
[{"name":"送货方式","type":{"type":"enum","required":true,"desc":{"SELF":"自提","SEND_NO_ELEVATOR":"送货上楼(无电梯)","SEND_HAS_ELEVATOR":"送货上楼(有电梯)","SEND_NO_UPSTAIRS":"送货(不含上楼)"}},"key":"value"}]顺心捷达(CP471906)
SVC-RECEIVE-TYPE
接货方式
用于定义发货客户的提货方式,枚举值:上门接货、客户自送
[{"name":"接货方式","type":{"type":"enum","required":true,"desc":{"SEND":"上门接货","SELF":"客户自送"}},"key":"value"}]加运美快递(LE33128010)
JYM-SIX
签单返还
签单返还是针对B2B及B2C客户,提供让寄方在寄出托寄物时,可以要求使用签单返还服务,收派员将带有回寄文件服务的快件派送给收方,收方签收时,需要按照签单返还服务的要求提供文件回复寄方,提高客户服务体验。
[]加运美快递(LE33128010)
JYM-FIVE
付费方式
运费到付是针对全类客户群体,提供货物签收付款运费的服务。
[{"name":"付费方式","type":{"type":"enum","required":true,"desc":{"RECEIVER-PAY":"到付","ON-DELIVERY":"寄付","MONTHLY":"月结"}},"key":"value"}]加运美快递(LE33128010)
JYM-FOUR
代收货款是针对B2B及B2C客户,提供为企业用户处理从运送货件至收取货款的繁复程序,让客户资金调度更顺畅,提供客户服务体验,商家选择默认代收货款退款类型为T+3天
[{"name":"代收货款金额","type":{"type":"number","required":true,"min":0},"key":"value"}]加运美快递(LE33128010)
JYM-SEVEN
支持多种派送方式,客户可根据需要自行选择,其中送货上楼是针对全类客户群体,提供送货上楼的服务,极大提高客户服务体验。
[{"name":"派送方式","type":{"type":"enum","required":true,"desc":{"SELF":"自提","FLOOR":"送货上楼"}},"key":"value"}]加运美快递(LE33128010)
JYM-THRRE
保价理赔
保价理赔是针对高价值货物提供在运输过程中直接导致损坏甚至遗失,订单将不受运单条款内赔偿金额上限所约束,并且专人跟进理赔,让客户寄件轻松又安心。
[{"name":"保价金额","type":{"type":"number","required":true,"min":1000},"key":"value"}]中铁快运(ZTKY)
ZTKY-SERVICE
依托飞豹快运的网络覆盖体系,以城市共同配送为基础,提供专业、便捷、安全的综合物流服务
[{"name":"派送方式","type":{"type":"enum","required":true,"desc":{"SELF":"自提","SEND":"派送"}},"key":"value"}]中铁智慧物流(LE32538030)
送货是快运公司按照客户的需求,按照客户提供的地址进行货物送货上门服务。自提是快运公司按照客户的需求,货物到达终端网点时通知收货人去网点自提。
[{"name":"送货方式","type":{"type":"enum","required":true,"desc":{"1":"送货","2":"自提"}},"key":"value"}]中铁智慧物流(LE32538030)
[{"name":"付款方式","type":{"type":"enum","required":true,"desc":{"1":"现金","2":"月结","3":"到付"}},"key":"value"}]中铁智慧物流(LE32538030)
回单类型
[{"name":"回单类型","type":{"type":"enum","required":true,"desc":{"0":"无需返单","1":"签单","2":"复印件","3":"客户原单"}},"key":"value"}]中邮快运(FJZYWL)
[{"name":"保价","type":{"type":"number","required":false,"desc":{"max":99999,"min":0,}},"key":"value"}]速腾快递(CN7000001028572)
代签回单
代签回单针对所有客户,提供免费代签回单的服务,提升客户服务体验。
[{"name":"回单方式","type":{"type":"enum","required":true,"desc":{"0":"无回单","1":"原单返回"}},"key":"value"}]速腾快递(CN7000001028572)
保价针对所有客户,根据客户货物件数算费,每件0.1元。提供货物实际价值的保额,单件最多保价2500元。
[{"name":"保价金额","type":{"type":"number","required":false,"max":2500,"min":0},"key":"value"}]京东快运(LE38288910)
SVC-INSTALL
送装一体
无
SVC-ExamineGoods
开箱服务
"cantOpenCheck":"禁止开箱",
"openElectrify":"开箱通电",
"openCheck":"开箱验货"
SVC-WAREHOUSE
送货入仓
为数字金额
"written":"纸质",
"electronic":"电子",
"written-electronic":"纸质+电子"
SVC-PICKUPTIME
预约派送
SVC-WhDeliveryType
仓配标识
"E":"E仓",
"C":"C仓"
SVC-HeavyUpstair
重货上楼
快捷快物流(LE05872340)
1、到付:运费由收件方支付;2、现付:运费由寄件方支付;3、月结:寄件方跟物流公司签署月结协议,运费月结
{"desc":{"pay_arrival":"到付","pay_billing":"现付","pay_monthly":"月结"},"required":true,"type":"enum"}
{"max":10000,"min":0,"required":true,"type":"number"}
1、派送:物流公司送货上门。2、自提:收件客户自行到物流公司网点提货
{"desc":{"self_value":"自提","deliver_value":"送货"},"required":true,"type":"enum"}
SVC-BackSignBill-TYPE
物流公司将收货方签收确认后的送货单或者签收回单返还给发货方,为双方提供更全面的快递服务
无value值
以下是cainiao.waybill.ii.search接口返回的,关于服务部分的数据
当服务的属性"required":true时,表明该服务为必选服务,必选服务必须传入。
当service_attributes节点为空的时候,说明该服务不需要属性,可以传入空的属性
{"SVC-PRIOR-DELIVERY":{}}传值规范为
{"$service_code":{"$attribute_code":$attribute_value,...}}比如
{"SVC-ANE56-PRODUCT-TYPE":{"value":"24"}}云打印模板的选择ISV可以根据快运物流公司,使用云打印查询接口获取到对应的打印模板。