网络型快运电子面单接入白皮书

更新时间：2024/11/18 访问次数：49922

网络型快运电子面单接入白皮书

网络型快运电子面单接入白皮书

为了提升商家发货效率、降低发货成本, 菜鸟电子面单开始逐步支持国内快运公司。该方案可以解决多环节打单、贴单的问题，实现一单到底，节省成本、提升效率。

本次接入的网络型快运公司有

快运公司	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服务商入口文档。

注意
子母单号生成递增序号是基于之前取到的序号之上的，如果并发来获取，可能会导致两个请求同时到达系统，会导致只有一个成功取到单号，因此大家对于子母单件必须是串行取号，前一个单号生成了再获取下个单号。

网络型快运公司电子面单接口变更

快运电子面单与之前的电子面单云打印接口为同一接口，所以接口的行为保持一致。每次传入一个包裹，返回一个子单号和对应的母单号。
子母件模式不支持批量取号。如果需要取得连续递增的子单号，每次需要在同一个sellerId下传入相同的订单id列表，不同的包裹id，如果订单列表相同，包裹id也相同，会触发幂等。
子件面单除子单号不同，其他信息完全相同。
入参新增包裹总件数字段 trade_order_info_dtos.package_info.total_packages_count，快运公司需要在面单上体现包裹的总件数，必填
入参新增包装类型字段 trade_order_info_dtos.package_info.packaging_description，选填
入参新增货品类型字段 trade_order_info_dtos.package_info.goods_description，选填
接口返回数据中包含子母件的子单号(waybillCode)和母单号(parentWaybillCode)
ISV需要注意，在快递模式下，返回的单号只有waybillCode，waybillCode是挂载物流详情和用来发货的单号，而在子母件中，这个对应的是parentWaybillCode，而waybillCode是子单号，不能用来发货。

ERP系统功能支持

ISV要支持用户填入获取快运子母件的必要参数，并且支持用户选择快递公司提供的物流服务。
当商家使用ERP系统填入需要获取的总件数，

重量体积等单位转换

电子面单cainiao.waybill.ii.get接口中接受的重量体积的单位分别是g, ml。目前ISV -> CAINIAO -> 物流公司之间的数据传输的单位都是以这个单位为准。但是对于快运大件场景，如果仍然让用户填入g, ml 显然会不合适。ISV给客户展示的单位需要展示为kg, m3，在取号时，再将数据转换成g, ml传入接口。数据的转换关系如下：
1 kg = 10 ^ 3 g
1 m3 = 10 ^ 6 ml

物流服务服务传值方式

请参考电子面单物流服务接入指南中的5. ISV物流服务接入流程。
目前快运公司的物流服务均不需要订购和审核，ISV只需要按照文档的规则进行传值。

快运公司支持的物流服务

以下给出的服务定义，仅供参考, 实际服务选择应该以接口返回的数据，动态来创建。

CP Code	Service Code	服务名称	服务描述	需要审核	需要订购	需要属性	需要必填	属性描述
安能快运(CN7000001000869)	SVC-INSURE	保价服务	保价服务	false	false	true	true	[ { "name":"保价金额", "type":{ "min":0, "type":"number", "required":true }, "key":"value" } ]
安能快运(CN7000001000869)	SVC-ANE56-PAYMENT-TYPE	安能物流产品支付类型服务	安能物流产品支付类型服务	false	false	true	true	[ { "name":"支付类型", "type":{ "type":"enum", "required":true, "desc":{ "102":"现金", "103":"到付", "104":"月结" } }, "key":"value" } ]
安能快运(CN7000001000869)	SVC-ANE56-DELIVERY-TYPE	安能物流配送类型服务	安能物流配送类型服务	false	false	true	true	[ { "name":"配送类型", "type":{ "type":"enum", "required":true, "desc":{ "179":"送货上楼", "180":"送货上门", "285":"自提" } }, "key":"value" } ]
安能快运(CN7000001000869)	SVC-ANE56-PRODUCT-TYPE	安能物流产品类型服务	安能物流产品类型	false	false	true	true	[ { "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	签收回单	签收回单	false	false	true	false	[ { "name":"签收回单", "type":{ "type":"enum", "required":true, "desc":{ "SIGNED":"签回单" } }, "key":"value" } ]
韵达快运(CN7000001021040)	SVC-YDKY-BIZ-TYPE	韵达快运业务类型	韵达快运业务类型	false	false	true	true	[ { "name":"业务类型", "type":{ "type":"enum", "required":true, "desc":{ "ECOMMERCE":"电商" } }, "key":"value" } ]
韵达快运(CN7000001021040)	SVC-YDKY-PRODUCT-TYPE	韵达快运产品类型	韵达快运产品类型	false	false	true	true	[ { "name":"产品类型", "type":{ "min":0, "type":"enum", "required":true, "desc":{ "YDKY-PROMISED-DELIVERY":"韵准达", "YDKY-168":"168大件", "YDKY-YUE-PROMISED-DELIVERY":"粤准达", "STANDARD_EXPRESS":"标准快运" } }, "key":"value" } ]
韵达快运(CN7000001021040)	SVC-INSURE	保价服务	用于定义保价金额	false	false	true	true	[ { "name":"保价金额", "type":{ "min":0, "type":"number", "required":true }, "key":"value" } ]
韵达快运(CN7000001021040)	SVC-YDKY-PAYMENT-TYPE	韵达支付类型服务	用于定义运费的付款方式	false	false	true	true	[ { "name":"付款方式", "type":{ "type":"enum", "required":true, "desc":{ "RECEIVER-PAY":"到付", "MONTHLY-PAY":"月结", "CASH":"现金" } }, "key":"value" } ]
韵达快运(CN7000001021040)	SVC-YDKY-DELIVERY-TYPE	派送方式	派送方式	false	false	true	true	[ { "name":"派送方式", "type":{ "type":"enum", "required":true, "desc":{ "FLOOR":"送货上楼", "SELF":"自提", "SEND":"派送" } }, "key":"value" } ]
壹米滴答快运(2744832184_543)	SVC-YMDD-TIMED-DELIVERY	壹米滴答时效服务	壹米滴答时效服务	false	false	true	true	[ { "name":"运输方式", "type":{ "type":"enum", "required":true, "desc":{ "1":"标准件", "2":"次日达", "3":"次晨达", "4":"优运件", "5":"内部件" } }, "key":"value" } ]
壹米滴答快运(2744832184_543)	SVC-YMDD-PAYMENT-TYPE	壹米滴答支付类型服务	壹米滴答支付类型服务	false	false	true	true	[ { "name":"付款方式", "type":{ "type":"enum", "required":true, "desc":{ "1":"寄付", "2":"到付", "3":"月结" } }, "key":"value" } ]
壹米滴答快运(2744832184_543)	SVC-YMDD-DELIVERY-TYPE	壹米滴答配送类型服务	用于定义收货客户的提货方式	false	false	true	true	[ { "name":"提货方式", "type":{ "type":"enum", "required":true, "desc":{ "1":"港到门", "2":"港到港", "3":"门到门", "4":"门到港" } }, "key":"value" } ]
百世物流(BESTQJT)	SVC-BESTQJT-DELIVERY-RECEIPT	签收回单	签收回单	false	false	true	false	[ { "name":"回单方式", "type":{ "type":"enum", "required":true, "desc":{ "RECEIPT":"原单", "PHOTO":"拍照" } }, "key":"value" } ]
百世物流(BESTQJT)	SVC-BESTQJT-DELIVERY-SERVICE	百世配送类型增值服务	百世配送类型增值服务	false	false	true	false	[ { "name":"增值服务", "type":{ "type":"enum", "required":true, "desc":{ "UPSTAIRS":"上楼", "WAREHOUSE":"进仓" } }, "key":"value" } ]
百世物流(BESTQJT)	SVC-BESTQJT-COD	百世货到付款服务	百世货到付款服务	false	false	true	false	[ { "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	百世运输类型服务	百世运输类型服务	false	false	true	true	[ { "name":"运输类型", "type":{ "type":"enum", "required":true, "desc":{ "ECOMMERCE":"电商" } }, "key":"value" } ]
百世物流(BESTQJT)	SVC-BESTQJT-INSURE	保价服务	保价服务	false	false	true	true	[ { "name":"保价金额", "type":{ "min":0, "type":"number", "required":true }, "key":"value" } ]
百世物流(BESTQJT)	SVC-BESTQJT-RECEIVER-PAY	百世到付	百世到付	false	false	true	false	[ { "name":"到付金额", "type":{ "min":0, "type":"number", "required":true }, "key":"value" } ]
百世物流(BESTQJT)	SVC-BESTQJT-DELIVERY-TYPE	百世配送类型服务	百世配送类型服务	false	false	true	true	[ { "name":"配送类型", "type":{ "type":"enum", "required":true, "desc":{ "SELF":"自提", "SEND":"送货" } }, "key":"value" } ]
德邦快运(CN7000001009020)	SVC-DELIVERY-RECEIPT	德邦签收回单	德邦签收回单服务	false	false	true	false	[ { "name":"签收回单", "type":{ "type":"enum", "required":true, "desc":{ "BILL_SIGNED_FAX":"运单到达联传真返回", "CUSTOMER_SIGNED_ORIGINAL":"签收单原件返回", "CUSTOMER_SIGNED_FAX":"客户签收单传真返回", "NO_RETURN_SIGNED":"无需返单" } }, "key":"value" } ]
德邦快运(CN7000001009020)	TRANSPORT-TYPE	德邦运输类型服务	德邦运输类型服务	false	false	true	true	[ { "name":"运输方式", "type":{ "type":"enum", "required":true, "desc":{ "SLOW-TRUCKS":"慢车", "FAST-TRUCKS":"快车" } }, "key":"value" } ]
德邦快运(CN7000001009020)	SVC-COD	德邦货到付款	德邦货到付款	false	false	true	false	[ { "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)	SVC-INSURE	保价服务	保价服务	false	false	true	true	[ { "name":"保价金额", "type":{ "min":0, "type":"number", "required":true }, "key":"value" } ]
德邦快运(CN7000001009020)	PAYMENT-TYPE	德邦支付类型服务	德邦支付类型服务	false	false	true	true	[ { "name":"支付类型", "type":{ "type":"enum", "required":true, "desc":{ "RECEIVER-PAY":"到付", "MONTHLY":"月结", "SENDER-PAY":"现付" } }, "key":"value" } ]
德邦快运(CN7000001009020)	DELIVERY-TYPE	德邦配送类型服务	德邦配送类型服务	false	false	true	true	[ { "name":"配送类型", "type":{ "type":"enum", "required":true, "desc":{ "UPSTAIRS":"上楼", "SELF":"自提", "SEND":"送货" } }, "key":"value" } ]
速尔快递(SURE)	SVC-DELIVERY-RECEIPT	签收单	签收单	false	false	true	false	[ { "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	运输方式	运输方式	false	false	true	true	[ { "name":"运输方式", "type":{ "type":"enum", "required":true, "desc":{ "VEHICLE":"汽运", "AIR":"空运" } }, "key":"value" } ]
速尔快递(SURE)	SVC-INSURE	保价	保价	false	false	true	false	[ { "name":"保价金额", "type":{ "min":0, "type":"number", "required":true }, "key":"value" } ]
速尔快递(SURE)	PAYMENT-TYPE	付款方式	付款方式	false	false	true	true	[ { "name":"付款方式", "type":{ "type":"enum", "required":true, "desc":{ "RECEIVER-PAY":"到付", "SENDER-MONTHLY-PAY":"寄付月结", "SENDER-PAY":"寄付" } }, "key":"value" } ]
速尔快递(SURE)	SVC-DELIVERY-TYPE	交货方式	交货方式	false	false	true	false	[ { "name":"提货方式", "type":{ "type":"enum", "required":true, "desc":{ "SELF":"自提", "SEND":"派送" } }, "key":"value" } ]
中通快运(3108002701_1011)	SVC-ZTOKY-DELIVERY-RECEIPT	中通快运签收回单	中通快运签收回单	false	false	true	false	[ { "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	中通快运代收货款	中通快运代收货款	false	false	true	false	[ { "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	中通快运运输类型	中通快运运输类型	false	false	true	true	[ { "name":"运输类型", "type":{ "type":"enum", "required":true, "desc":{ "STANDARD":"标准快运" } }, "key":"value" } ]
中通快运(3108002701_1011)	SVC-INSURE	保价服务	保价服务	false	false	true	false	[ { "name":"保价金额", "type":{ "min":0, "type":"number", "required":true }, "key":"value" } ]
中通快运(3108002701_1011)	SVC-ZTOKY-PAYMENT-TYPE	中通快运付款方式	中通快运付款方式	false	false	true	true	[ { "name":"付款方式", "type":{ "type":"enum", "required":true, "desc":{ "RECEIVER-PAY":"到付", "MONTHLY":"月结" } }, "key":"value" } ]
中通快运(3108002701_1011)	SVC-ZTOKY-DELIVERY-TYPE	中通快运配送方式	中通快运配送方式	false	false	true	true	[ { "name":"配送方式", "type":{ "type":"enum", "required":true, "desc":{ "SELF":"自提", "SEND":"派送" } }, "key":"value" } ]
卡行天下快运(CP457538)	SVC-KX-DELIVERY-RECEIPT	签收回单	签收回单	false	false	true	false	[ { "name":"回单类型", "type":{ "type":"enum", "required":true, "desc":{ "ELECTRONIC_RECEIPT":"电子回单", "PAPER_RECEIPT":"纸质回单" } }, "key":"value" } ]
卡行天下快运(CP457538)	SVC-KX-COD	卡行代收货款	卡行代收货款	false	false	true	false	[ { "name":"代收货款金额", "type":{ "type":"number", "required":true "min": 0, }, "key":"value" } ]
卡行天下快运(CP457538)	SVC-KX-INSURE	保价	保价	false	false	true	false	[ { "name":"保价金额", "type":{ "type":"number", "required":true "min": 0, }, "key":"value" } ]
卡行天下快运(CP457538)	SVC-KX-PAYMENT-TYPE	付款方式	付款方式	false	false	true	true	[ { "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	提货方式	提货方式	false	false	true	true	[ { "name":"提货方式", "type":{ "type":"enum", "required":true, "desc":{ "SEND": "派送", "SELF": "自提" } }, "key":"value" } ]
天地华宇(HOAU)	SVC-HOAU-DELIVERY-RECEIPT	签收单	用于定义签收单的返单类型，枚举值：无需返单、签收单原件返回、签收单传真返回、运单到达联传真返回	false	false	true	true	[ { "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，则开户名，开户账户不能为空，如果退款类型为空，则默认三日退。其中退款类型枚举值：三日退、即日退	false	false	true	false	[ { "name":"代收货款类型", "type":{ "type":"enum", "required":true, "desc":{ "1": "即日退", "2": "三日退" } }, "key":"value" } ]
天地华宇(HOAU)	SVC-HOAU-TRANSPORT-TYPE	运输方式	用于定义运输方式，枚举值：快车、慢车	false	false	true	true	[ { "name":"运输方式", "type":{ "type":"enum", "required":true, "desc":{ "10000000000000000001": "定日达", "30000000000000000001": "经济快运" } }, "key":"value" } ]
天地华宇(HOAU)	SVC-HOAU-INSURE	保价	用于定义保价金额	false	false	true	true	[ { "name":"保价金额", "type":{ "type":"number", "required":true, "min": 0 }, "key":"value" } ]
天地华宇(HOAU)	SVC-HOAU-PAYMENT-TYPE	付款方式	用于定义运费的付款方式，枚举值：到付、月结	false	false	true	true	[ { "name":"付款方式", "type":{ "type":"enum", "required":true, "desc":{ "ARRIVAL_PAYMENT": "到货付清", "CASH_PAYMENT": "发货付清", "SHIPPER_SETTLEMENT": "发货结算" } }, "key":"value" } ]
天地华宇(HOAU)	SVC-HOAU-DELIVERY-TYPE	交货方式	用于定义收货客户的提货方式，枚举值：自提、派送	false	false	true	true	[ { "name":"配送方式", "type":{ "type":"enum", "required":true, "desc":{ "PICKUPSELF": "自提", "DELIVERY": "送货上门", "BIGUPSTAIRS": "大件送货上楼", "SMALLUPSTAIRS": "小件送货上楼" } }, "key":"value" } ]
源之安达速运（LE04826230）	SVC-PAYMENT-TYPE	付款方式	1、到付：运费由收件方支付； 2、现金：运费由寄件方支付； 3、月结：寄件方跟物流公司签署月结协议，运费月结。	false	false	true	true	[ { "name":"付款方式", "type":{ "type":"enum", "required":true, "desc":{ "RECEIVER-PAY": "到付", "ON-DELIVERY": "现金", "MONTHLY": "月结" } }, "key":"value" } ]
源之安达速运（LE04826230）	SVC-COD	代收货款	广东省内	true	true	true	false	[ { "name":"代收货款金额", "type":{ "type":"enum", "required":true, "desc":{ "max": 15000, "min": 0 } }, "key":"value" } ]
顺心捷达(CP471906)	SVC-COD	代收货款金额	代收货款金额	false	false	true	false	[ { "name":"代收货款金额", "type":{ "type":"number", "required":true, "min": 0 }, "key":"value" } ]
顺心捷达(CP471906)	SVC-INSURE	保价金额	保价金额	false	false	true	false	[ { "name":"保价金额", "type":{ "type":"number", "required":true, "min": 0 }, "key":"value" } ]
顺心捷达(CP471906)	SVC-SIGN-TYPE	签单方式	用于定义收货客户的签单方式，枚举值：原件回单、电子回单	false	false	true	false	[ { "name":"签单方式", "type":{ "type":"enum", "required":true, "desc":{ "ORIG_RECEIPT": "原件回单", "ElEC_RECEIPT": "电子回单" } }, "key":"value" } ]
顺心捷达(CP471906)	SVC-PAYMENT-TYPE	付款方式	用于定义发货客户的付款方式，枚举值：到付、寄付、月付	false	false	true	false	[ { "name":"付款方式", "type":{ "type":"enum", "required":true, "desc":{ "RECEIVER-PAY": "到付", "ON-DELIVERY": "寄付", "MONTHLY": "月结" } }, "key":"value" } ]
顺心捷达(CP471906)	SVC-DELIVERY-TYPE	送货方式	用于定义收货客户的送货方式，枚举值：自提、送货上楼（无电梯）、送货上楼（有电梯）、送货（不含上楼）	false	false	true	true	[ { "name":"送货方式", "type":{ "type":"enum", "required":true, "desc":{ "SELF": "自提", "SEND_NO_ELEVATOR": "送货上楼（无电梯）", "SEND_HAS_ELEVATOR": "送货上楼（有电梯）", "SEND_NO_UPSTAIRS": "送货（不含上楼）" } }, "key":"value" } ]
顺心捷达(CP471906)	SVC-RECEIVE-TYPE	接货方式	用于定义发货客户的提货方式，枚举值：上门接货、客户自送	false	false	true	false	[ { "name":"接货方式", "type":{ "type":"enum", "required":true, "desc":{ "SEND": "上门接货", "SELF": "客户自送" } }, "key":"value" } ]
加运美快递(LE33128010)	JYM-SIX	签单返还	签单返还是针对B2B及B2C客户，提供让寄方在寄出托寄物时，可以要求使用签单返还服务，收派员将带有回寄文件服务的快件派送给收方，收方签收时，需要按照签单返还服务的要求提供文件回复寄方，提高客户服务体验。	false	false	false	false	[ ]
加运美快递(LE33128010)	JYM-FIVE	付费方式	运费到付是针对全类客户群体，提供货物签收付款运费的服务。	false	false	true	false	[ { "name":"付费方式", "type":{ "type":"enum", "required":true, "desc":{ "RECEIVER-PAY": "到付", "ON-DELIVERY": "寄付", "MONTHLY": "月结" } }, "key":"value" } ]
加运美快递(LE33128010)	JYM-FOUR	代收货款	代收货款是针对B2B及B2C客户，提供为企业用户处理从运送货件至收取货款的繁复程序,让客户资金调度更顺畅,提供客户服务体验,商家选择默认代收货款退款类型为T+3天	true	true	true	false	[ { "name":"代收货款金额", "type":{ "type":"number", "required":true, "min":0 }, "key":"value" } ]
加运美快递(LE33128010)	JYM-SEVEN	派送方式	支持多种派送方式，客户可根据需要自行选择，其中送货上楼是针对全类客户群体，提供送货上楼的服务，极大提高客户服务体验。	false	false	true	true	[ { "name":"派送方式", "type":{ "type":"enum", "required":true, "desc":{ "SELF": "自提", "FLOOR": "送货上楼" } }, "key":"value" } ]
加运美快递(LE33128010)	JYM-THRRE	保价理赔	保价理赔是针对高价值货物提供在运输过程中直接导致损坏甚至遗失，订单将不受运单条款内赔偿金额上限所约束，并且专人跟进理赔，让客户寄件轻松又安心。	true	true	true	false	[ { "name":"保价金额", "type":{ "type":"number", "required":true, "min":1000 }, "key":"value" } ]
中铁快运(ZTKY)	ZTKY-SERVICE	派送方式	依托飞豹快运的网络覆盖体系，以城市共同配送为基础，提供专业、便捷、安全的综合物流服务	false	false	true	true	[ { "name":"派送方式", "type":{ "type":"enum", "required":true, "desc":{ "SELF": "自提", "SEND": "派送" } }, "key":"value" } ]
中铁智慧物流(LE32538030)	SVC-DELIVERY-TYPE	送货方式	送货是快运公司按照客户的需求，按照客户提供的地址进行货物送货上门服务。自提是快运公司按照客户的需求，货物到达终端网点时通知收货人去网点自提。	false	false	true	false	[ { "name":"送货方式", "type":{ "type":"enum", "required":true, "desc":{ "1": "送货", "2": "自提" } }, "key":"value" } ]
中铁智慧物流(LE32538030)	SVC-PAYMENT-TYPE	付款方式	快运公司对商家的订单进行揽收开始到送达日期计算，按协议约定的付款方式进行结算。如现金：在交易开始前由发货人支付；月结是在交易协议约定时间内结算；到付是交易后收货方支付的方式。	false	false	true	false	[ { "name":"付款方式", "type":{ "type":"enum", "required":true, "desc":{ "1": "现金", "2": "月结", "3": "到付" } }, "key":"value" } ]
中铁智慧物流(LE32538030)	SVC-SIGN-TYPE	回单类型	发货人的货品送抵指定的收货人，回单上面的签字作为签收单据的证据，按回单类型在规定的时间内返回发货人。	false	false	true	false	[ { "name":"回单类型", "type":{ "type":"enum", "required":true, "desc":{ "0": "无需返单", "1": "签单", "2": "复印件", "3": "客户原单" } }, "key":"value" } ]
中邮快运(FJZYWL)	SVC-INSURE	保价	保价用于定义声明价值,如某手机的保价金额为2000元	false	false	true	false	[ { "name":"保价", "type":{ "type":"number", "required":false, "desc":{ "max": 99999, "min": 0, } }, "key":"value" } ]
速腾快递(CN7000001028572)	SVC-SIGN-TYPE	代签回单	代签回单针对所有客户，提供免费代签回单的服务，提升客户服务体验。	false	false	true	true	[ { "name":"回单方式", "type":{ "type":"enum", "required":true, "desc":{ "0": "无回单", "1": "原单返回" } }, "key":"value" } ]
速腾快递(CN7000001028572)	SVC-INSURE	保价	保价针对所有客户，根据客户货物件数算费，每件0.1元。提供货物实际价值的保额，单件最多保价2500元。	false	false	true	true	[ { "name":"保价金额", "type":{ "type":"number", "required":false, "max": 2500, "min": 0 }, "key":"value" } ]
京东快运(LE38288910)	SVC-INSTALL	送装一体		false	false	false	false	无
	SVC-ExamineGoods	开箱服务		false	false	true	false	"cantOpenCheck": "禁止开箱", "openElectrify": "开箱通电", "openCheck": "开箱验货"
	SVC-WAREHOUSE	送货入仓		false	false	false	false	无
	SVC-COD	代收货款		false	false	true	false	为数字金额
	SVC-SIGN-TYPE	签单返还		false	false	true	false	"written": "纸质", "electronic": "电子", "written-electronic": "纸质+电子"
	SVC-PICKUPTIME	预约派送		false	false	true	false	派件时间格式（yyyy-MM-dd HH:mm）时间格式为固定格式
	SVC-INSURE	保价		false	false	true	false	为数字金额
	SVC-WhDeliveryType	仓配标识		false	false	true	false	"E": "E仓", "C": "C仓"
	SVC-HeavyUpstair	重货上楼		false	false	false	false	无
快捷快物流（LE05872340）	SVC-PAYMENT-TYPE	付款方式	1、到付：运费由收件方支付； 2、现付：运费由寄件方支付; 3、月结：寄件方跟物流公司签署月结协议，运费月结	false	false	true	true	{ "desc": { "pay_arrival": "到付", "pay_billing": "现付", "pay_monthly": "月结" }, "required": true, "type": "enum" }
	SVC-COD	代收货款	按照寄件方与收件方达成交易协议的要求，快递公司代寄件方客户向收件方客户收取货款，同时按照约定时间将货款返还给寄件方	true	true	true	false	{ "max": 10000, "min": 0, "required": true, "type": "number" }
	SVC-DELIVERY-TYPE	送货方式	1、派送：物流公司送货上门。 2、自提：收件客户自行到物流公司网点提货	false	false	true	false	{ "desc": { "self_value": "自提", "deliver_value": "送货" }, "required": true, "type": "enum" }
	SVC-BackSignBill-TYPE	代签回单	物流公司将收货方签收确认后的送货单或者签收回单返还给发货方,为双方提供更全面的快递服务	false	false	false	false	无value值

服务选择

本次订购关系查询接口cainiao.waybill.ii.search中新增服务属性相关数据，前端可以根据该服务属性实现服务选择界面
商家选择快运的快递公司后，需要给商家提供选择快运服务的能力，这个和之前的快递选择服务是一样的接口。

service_desc 是该服务的描述，可以展示给前端
service_attributes是该服务支持的所有的属性
attribute_code是属性的key
attribute_name属性的名称
attribute_type属性的类型，可能值有 [number, string, enum, boolean]
type_desc枚举类型的枚举值，key为用户选中的需要传值的数据，value为对应的描述，可以作为前端的展示, type为enum类型的渲染成下拉选择框，其它的type可以渲染成输入框，一个可能作为参考的UI如下

以下是cainiao.waybill.ii.search接口返回的，关于服务部分的数据

"service_info_cols":{
                                    "service_info_dto":[
                                        {
                                            "service_name":"物流产品类型服务",
                                            "service_code":"SVC-ANE56-PRODUCT-TYPE",
                                            "service_attributes":{
                                                "service_attribute_dto":[
                                                    {
                                                        "attribute_code":"value",
                                                        "attribute_name":"产品类型",
                                                        "attribute_type":"enum",
                                                        "type_desc":"{\"type\":\"enum\",\"desc\":{\"95\":\"MINI大件, 重量>70KG\",\"23\":\"定时达, 重量>70KG\",\"270\":\"普惠达, 重量>1000KG\",\"211\":\"易碎品（标准快运）, 重量>70KG\",\"212\":\"易碎品（定时达）,重量>70KG\",\"213\":\"易碎品（mini小包）,重量<=70KG\"}}"
                                                    }
                                                ]
                                            },
                                            "service_desc":"安能物流产品类型",
                                            "required":true
                                        }
                                    ]
                                }

ISV在实现物流服务选择界面时，可以考虑通过客户端缓存的数据，动态的渲染，不要讲服务相关数据写死，以便以后快递公司服务属性调整。当物流服务变更时，ISV不需要感知。

在电子面单的取号接口cainiao.waybill.ii.get中
trade_order_info_dtos.logistics_services 字段中传入用户选择的物流服务。

当服务的属性 "required":true 时，表明该服务为必选服务，必选服务必须传入。

当service_attributes节点为空的时候，说明该服务不需要属性，可以传入空的属性

{ "SVC-PRIOR-DELIVERY": {} }

传值规范为

{"$service_code" : {"$attribute_code": $attribute_value, ...}}

比如

{ "SVC-ANE56-PRODUCT-TYPE": { "value": "24" } }

云打印模板的选择

ISV可以根据快运物流公司，使用云打印查询接口获取到对应的打印模板。

子母件取消接口行为

不能取消子件
取消母件则取消所有子件

子母件更新接口行为

子母件不允许更新

云打印报文加密

返回的报文将对非客户相关信息进行加密，客户端可以获取到子母件的子单号和母单号。

FAQ

关于此文档暂时还没有FAQ

有用(0) 我要提问

电子面单对接知识库