电子面单物流服务接入指南

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

电子面单物流服务接入指南

电子面单物流服务接入指南

随着业务的发展，各快递公司越来越注重差异化服务的提供，如COD服务、VIP服务、保价服务等。这些服务可能具备如下几个特点：
（1）某些服务需要商家在淘宝卖家中心中进行订购，快递公司审批后才能选择；
（2）某些服务的电子面单号段需要与普通号段区分开，例如：普通号段为77开头，COD服务需要66开头的号段。

1. 商家使用物流服务流程

(1) 服务开通

商家点击“开通”，即发送订购关系给到快递公司进行审核【无需订购的服务不在卖家中心进行展示，ISV支持商家进行选择即可】

(2) 服务审核

快递公司对商家订购的服务进行审核。审核通过、审核不通过的状态均会展示给商家；

(3) 获取带物流服务的面单号

商家取号时，ISV将服务值传给菜鸟电子面单系统：

菜鸟电子面单系统判断服务是否已经订购成功（无需订购的服务不校验）；

取号后将服务信息在面单信息下发接口中下发给快递公司。

2. 物流服务面单打印样式

备注：使用菜鸟云打印可直接打印出标准的服务承载样式，建议使用菜鸟云打印！若未使用菜鸟云打印，也请将服务按照菜鸟的样式进行打印，否则存在资损的风险，请一定注意！

3. 物流服务的规则

规则	说明
是否需要订购	需要订购的服务需要到淘宝卖家中心中订购。不需要订购的服务则不需要在淘宝卖家中心订购，可直接使用。
是否需要审核	需要审核的服务在订购后会由快递公司来审核，只有审核通过后才可使用该服务。不需要审核的服务需要在淘宝卖家中心订购，订购后自动审核通过。
是否需要属性	属性是一个定义了的常量，如value。属性有自己对应的取值。如货到付款服务，value值可取一个正数。不需要属性的服务传参时直接传服务的serviceCode即可，需要属性的服务在传参时需要带上属性值。

4. 目前平台提供的服务（前端展示请以查询接口返回的数据为准，下面的描述仅供参考）

快递公司	服务编码(serviceCode)	服务名称	是否需要订购	是否需要审核	是否需要属性	传参样例	value取值	服务描述
顺丰（cpcode：SF brand_code：SF）	COD	代收货款-IN01	不需要	不需要	需要	{“COD”:{“value”:“123”,“value1”:“456”}}	?	代收货款，value为货款，以原寄地所在区域币种为准，如中国内地为人民币，香港为港币，保留3位小数。value1为代收货款卡号
顺丰（cpcode：SF brand_code：SF）	IN03	签单返还-IN03	不需要	不需要	不需要	{ “IN03”: { } }	?	签单返还
顺丰（cpcode：SF brand_code：SF）	IN59	签收确认-IN59	不需要	不需要	需要	{“IN59”:{“value”:“1”,“value2”:“2”,“value3”:“1”,“value5”:{“credentiaNo” : “1213141516”}}}	?	签收确认
顺丰（cpcode：SF brand_code：SF）	NOTICE	定时派送（等通知）-IN04	不需要	不需要	不需要	{ “NOTICE”: { } }	?	定时派送（等通知）
顺丰（cpcode：SF brand_code：SF）	TDELIVERY	定时派送（指定时段）-IN26	不需要	不需要	需要	{“TDELIVERY”:{“value”:“2021-10-12”,“value1”:“2”}}	?	定时派送（指定时段）value为派送日期（格式：yyyy-MM-dd）；value1为派送时间段代码（传参1、2、3、4、5、6、7、8、9分别代表[09:00-11:00]、[11:00-13:00]、[13:00-15:00]、[15:00-17:00]、[17:00-19:00]、[19:00-21:00]、[09:00-12:00]、[12:00-15:00]、[15:00-18:00]）
顺丰（cpcode：SF brand_code：SF）	IN121	准时保-IN121	不需要	不需要	不需要	{ “IN121”: { } }	?	准时保
顺丰（cpcode：SF brand_code：SF）	INSURE	保价-IN02	不需要	不需要	需要	{ “INSURE”: {“value”: 2000} }	?	保价，value为声明价值以原寄地所在区域币种为准，如中国内地为人民币，香港为港币，保留3位小数。
顺丰（cpcode：SF brand_code：SF）	IN41	保鲜服务-IN41	不需要	不需要	不需要	{ “IN41”: { } }	?	保鲜服务
顺丰（cpcode：SF brand_code：FOP）	IN103	安装服务-IN103	不需要	不需要	不需要	{ “IN103”: { } }	需要按照顺丰开放平台传入https://open.sf-express.com/developSupport/734349?activeIndex=313317	安装服务
顺丰（cpcode：SF brand_code：FOP）	IN31	包装服务-IN31	不需要	不需要	不需要	{ “IN31”: { } }	?	包装服务
顺丰（cpcode：SF brand_code：FOP）	CARGOSAFEKEEPING	货物保管-IN46	不需要	不需要	不需要	{{ “CARGOSAFEKEEPING”: { } }	?	货物保管
顺丰（cpcode：SF brand_code：FOP）	IN114	押运服务-IN114	不需要	不需要	不需要	{ “IN114”: { } }	?	押运服务
顺丰（cpcode：SF brand_code：FOP）	IN116	宅配延伸-IN116	不需要	不需要	不需要	{ “IN116”: { } }	需要按照顺丰开放平台传入https://open.sf-express.com/developSupport/734349?activeIndex=313317	宅配延伸
顺丰（cpcode：SF brand_code：FOP）	IN60	展会撤展服务-IN60	不需要	不需要	不需要	{ “IN60”: { } }	?	展会撤展服务
顺丰（cpcode：SF brand_code：FOP）	IN123	展会参展服务-IN123	不需要	不需要	不需要	{ “IN123”: { } }	?	展会参展服务
顺丰（cpcode：SF brand_code：FOP）	IN117	通电验机-IN117	不需要	不需要	需要	{ “IN117”: {“value”:“123111”} }	?	通电验机
顺丰（cpcode：SF brand_code：FOP）	IN21	特安保价-IN21	不需要	不需要	需要	{ “IN21”: {“value”:50000} }	?	IN21是特安保价，声明价值在20000以上的保价
顺丰（cpcode：SF brand_code：FOP）	IN45	送货上楼	不需要	不需要	不需要	{ “IN45”: { } }	?	送货上楼
圆通（YTO）	SVC-COD	代收货款	需要	需要	需要属性 value(直接传代收金额)	{ “SVC-COD”: { “value”: 100.5 } }	货到付款金额	按照寄件方与收件方达成交易协议的要求，快递公司代寄件方客户向收件方客户收取货款，同时按照约定时间将货款返还给寄件方。
圆通（YTO）	SVC-YTTS	特色经济	需要	需要	不需要	{ “SVC-YTTS”: { } }	?	圆通特色经济产品
圆通（YTO）	SVC-TCTK	同城特快	需要	需要	不需要	{ “SVC-TCTK”: { } }	?	为客户提供寄上午寄当日达，下午寄次晨达且末端提供按需派送的同城服务
圆通（YTO）	SVC-CNHKJ	航空件	需要	需要	不需要	{ “SVC-CNHKJ”: { } }	?	按线路开通；使用该服务需满足特定线路，若不满足线路，会取号失败，具体支持线路网点会与商家线下联系
圆通（YTO）	SVC-YZDR	圆准达	需要	不需要	不需要	{ “SVC-YZDR”: { } }	?	圆通速递提供的中心优先中转服务以及按需配送服务。中心优先中转服务，即中心优先装卸，优先通道，独立建包服务。按需配送服务，即包裹派送前电话联系收件人并按照收件人意愿进行送货上门或放至其指定位置等服务。
圆通（YTO）	SVC-YZDY	圆准达（月结）	需要	不需要	不需要	{ “SVC-YZDY”: { } }	?	（月结）圆通对订购商家的订单进行送达日期计算，并进行时效承诺。线下报表、线下收费、线下赔付
圆通（YTO）	SVC-INTERNATIONAL	海外直送	需要	需要	不需要	{ “SVC-INTERNATIONAL”: { } }	?	海外直送，一单到底，优先转运，专网派送。
德邦（DBKD）	SVC-SIGN-TYPE	口令签收	不需要	不需要	不需要属性	{ “SVC-SIGN-TYPE”: { } }	?	一、为保障客户本人签收，我司派送时会发送一组4位数的签收口令给收货人，派件快递员需凭借口令签收二、发送短信优先级 ①收货人若已关注“德邦快递’”公众号，短信优先推送给公众号； ②未关注我司公众号，我司发短信至收件人手机； ③微信（公众号）/短信都未接收到口令，可选择电话播报； ④如以上三种渠道都无法获取口令时，可联系收入部门查询口令；
德邦（DBKD）	SVC-PRE	预售商品	不需要	不需要	不需要属性	{ “SVC-PRE”: { } }	?	该服务需线下联系德邦快递网点，开通预售服务的解锁功能才可以使用。
德邦（DBKD）	DPK-CNCY	德邦快递菜鸟橙运专用	不需要	不需要	不需要属性	{ “DPK-CNCY”: { } }	?	给德邦快递橙运项目使用
德邦（DBKD）	DELIVERY-HEAVY	大件快递3.60	不需要	不需要	不需要属性	{ “DELIVERY-HEAVY”: { } }	?	提供单件3kg-60kg大件的快递服务，首续重报价，包接包送，大小件齐发，件数和总重不限，40kg以下100%免费上楼。
德邦（DBKD）	paytype	付款方式	不需要	不需要	需要	{ “paytype”: {“type”: 1} }	“1”: “到付”,“2”: “月结”	付款服务
德邦（DBKD）	insurance	保价	不需要	不需要	需要	{ “insurance”: {“insuranceValue”: 1000} }	?	保价服务
德邦（DBKD）	COD	代收货款	不需要	不需要	需要	{“COD”:{“codvalue”:100,“codtype”:3}}	codtype：“1”: “即日退”,“3”: “三日退”	代收货款服务
德邦（DBKD）	NO-PICKUPSELF	不接受自提区域	需要	不需要	不需要属性	{ “NO-PICKUPSELF”: { } }	?	德邦快递针对商家时效、派送特殊需求提供定制化筛单服务：商家可勾选“不接受自提区域”在打单时拦截自提区域订单。
德邦（DBKD）	NO-OUT	不接受外发区域	需要	不需要	不需要属性	{ “NO-OUT”: { } }	?	德邦快递针对商家时效、派送特殊需求提供定制化筛单服务：商家可勾选“不接受外发区域”在打单时拦截外发区域订单。
德邦（DBKD）	NO-PARTNER	不接受合伙人区域	需要	不需要	不需要属性	{ “NO-PARTNER”: { } }	?	德邦快递针对商家时效、派送特殊需求提供定制化筛单服务：商家可勾选“不接受合伙人区域”在打单时拦截合伙人区域订单。
中通（ZTO）	SVC-VIP	中通标快	需要	需要	不需要属性	{ “SVC-VIP”:{} }	?	中通标快是推出的服务于VIP客户的全方位跟进处理快件售后的一种尊享服务，保障了快件100%有效跟踪、问题件100%有效处理、丢件100%及时处理等一系列权益，同时能有效提高客户满意度，提升客户与商家粘度。
中通（ZTO）	STAR-COLD	冷链	需要	需要	不需要	{ “STAR-COLD”: { } }	?	星联冷链是针对于生鲜水果以及需冷藏运输产品市场推出的陆运冷链运输服务，主要服务有全程温控，专属路由，优先中转，优先派送等
中通（ZTO）	SVC-STAR	星联	需要	需要	不需要	{ “SVC-STAR”: { } }	?	是一种满足中高端市场客户需求的时效产品，同时也支持代收到付等增值服务。
中通（ZTO）	STAR-CITY	同城	需要	需要	不需要	{ “STAR-CITY”: { } }	?	星联同城是针对中高端同城市场例如水果/生鲜/冻品/鲜花/图书/服装/医药/电子/汽车/商务等服务行业的B2C以及C2C客户，提供当日达、次晨达时效服务的高端同城快递服务产品，提升客户服务体验，提升中通同城市场占有率。
中通（ZTO）	STAR-FILE	文件	需要	需要	不需要	{ “STAR-FILE”: { } }	?	星联文件是针对中高端商务文件市场而推出的专属文件类寄递产品，该产品提供特殊优质包装、单独交接、优先中转、派前电联、主动售后等多项高质量服务。
中通（ZTO）	SVC-INSURE	保价	需要	需要	需要属性 value(直接传保价金额)	{ “SVC-INSURE”: {“value”: 100.5 } }	?	对货品价值进行保价，在运输中存在的遗失、破损根据实际情况进行理赔。需要模板有相应保价标识系统进行自动录单，同时需回传保价金额及物品类型等信息
中通（ZTO）	SVC-ZTO-INTERNATIONAL	菜鸟保税仓-国际电子面单服务	需要	需要	不需要	{ “SVC-ZTO-INTERNATIONAL”: { } }	?	菜鸟保税仓-国际电子面单服务
中通（ZTO）	SVC-TIMING-STANDARD	中通好快	需要	需要	不需要	{ “SVC-TIMING-STANDARD”: { } }	?	中通目前强大的网络及汽运资源，在指定服务范围和寄递时间内收寄，实行标准定价，提供次晨&隔晨、次日&隔日等时效承诺，加以“时效保障”、“标准服务”、“快速理赔”为支撑为客户提供“稳定、安全、可靠”的高品质、门到门快递服务。
中通（ZTO）	SVC-TIMING-HIGH	中通飞快	需要	需要	不需要	{ “SVC-TIMING-HIGH”: { } }	?	在指定服务范围和寄递时间内收寄，由总部统一配置可开通线路的航空资源，加以“时效保障”、“标准服务”、“快速理赔”为支撑，建立起针对中高端客户市场标准时效快递产品。
中通（ZTO）	PRO_CAINIAO_VIP	中通标快-对总	需要	不需要	不需要	{ “PRO_CAINIAO_VIP”: { } }	?	VIP品质寄递服务，提供末端派前电联和按需派送的差异化服务
申通（STO）	SVC-COD	代收货款	不需要	不需要	需要属性 value(直接传代收金额)	{ “SVC-COD”: { “value”: 100.5 } }	?	按照寄件方与收件方达成交易协议的要求，快递公司代寄件方客户向收件方客户收取货款，同时按照约定时间将货款返还给寄件方。
申通（STO）	SVC- AXPS	申咚咚	需要	需要	不需要	{ “SVC- AXPS”: { } }	?	申通的按需派送服务是由商家为自己的快递包裹单独购买的增值派送服务。申通会通过智能外呼/消费者收件习惯偏好等措施，搜集消费者的收件意愿，并根据其意愿进行派送。
申通（STO）	SVC-RECEIVER-PAY	到付	不需要	不需要	需要属性 value	{ “SVC-RECEIVER-PAY”: { “value”: 100.5 } }	到付金额	?
申通（STO）	SVC-INSURE	保价	不需要	不需要	需要属性 value	{ “SVC-INSURE”: { “value”: 100.5 } }	保价金额	用于定义声明价值,如某手机的保价金额为2000元
申通（STO）	SVC-FRESH	生鲜件	不需要	不需要	不需要	{ “SVC-FRESH”: { } }	?	针对生鲜件，采用不同的号段、相对独立的网内运转模式，保证生鲜件的时效和操作的特殊性
极兔（HTKY）	SVC-COD	代收货款	需要	需要	需要属性 value(直接传代收金额)	{ “SVC-COD”: { “value”: 100.5 } }	货到付款金额	为客户提供便捷货物寄递的同时，按照寄件客户与收件客户达成的交易协议，向收件客户收取货款并按约定时间转交至寄件客户的服务
极兔（HTKY）	SVC-INSURE	保价	需要	需要	需要属性 value(直接传保价金额)	{ “SVC-INSURE”: { “value”: 100.5 } }	保价金额	用于定义声明价值,如某手机的保价金额为2000元
极兔（HTKY）	SVC-RECEIVER-PAY	到付	不需要	不需要	需要属性 value	{ “SVC-RECEIVER-PAY”: { “value”: 100.5 } }	到付金额	到付
极兔（HTKY）	SVC-TYD	兔优达	需要	需要	不需要属性 value	{ “SVC-TYD”: { } }	?	基于强大的覆盖网络和运输资源，并在全流程上进行一些差异化操作，提供专属面单、绿色通道、派前电联、独立仲裁通道、专属客服等个性化服务，为客户提供高品质、门到门快递服务
EMS（EMS）	SVC-EMS-RECEIVER-PAY	EMS到付	需要	需要	需要属性 value	{ “SVC-EMS-RECEIVER-PAY”: { “value”: 100.5 } }	EMS到付金额	EMS到付
EMS（EMS）	SVC-INSURE	保价	不需要	不需要	不需要	{ “SVC-INSURE”: { } }	?	寄件人单件交寄物价值不超过5万元人民币，请对交寄物保价以保全物品价值。贵重物品或超过2000元人民币的交寄物应事先声明并请选择保价服务。承运人无审核交寄物价值的能力和义务，寄件人按交寄物声明价值保价，声明价值在300元（含）以内的，保价费按1元收取；声明价值超过300元的部分，保价费率为0.5%。
邮政国内小包（POSTB）	SVC-INSURE	保价	不需要	不需要	不需要	{ “SVC-INSURE”: { } }	?	POSTB:寄件人单件交寄物价值不超过2万元人民币，请对交寄物保价以保全物品价值。贵重物品或超过2000元人民币的交寄物应事先声明并请选择保价服务。承运人无审核交寄物价值的能力和义务，寄件人按交寄物声明价值保价，声明价值在300元（含）以内的，保价费按1元收取；声明价值超过300元的部分，保价费率为1%。
优速（UC）	SVC-INSURE	保价	不需要	不需要	需要属性 value(直接传保价金额)	{ “SVC-INSURE”: { “value”: 100.5 } }	保价金额	用于定义声明价值,如某手机的保价金额为2000元
优速（UC）	SVC-COD	代收货款	不需要	不需要	需要属性 value(直接传代收金额)	{ “SVC-COD”: { “value”: 100.5 } }	货到付款金额	按照寄件方与收件方达成交易协议的要求，快递公司代寄件方客户向收件方客户收取货款，同时按照约定时间将货款返还给寄件方。
韵达（YUNDA）	SVC-COD	代收货款	不需要	不需要	需要属性 value(直接传代收金额)	{ “SVC-COD”: { “value”: 100.5 } }	?	按照寄件方与收件方达成交易协议的要求，快递公司代寄件方客户向收件方客户收取货款，同时按照约定时间将货款返还给寄件方。
韵达（YUNDA）	SVC-RECEIVER-PAY	货到付款	不需要	不需要	需要属性 value(直接传付款金额)	{ “SVC-RECEIVER-PAY”: {“value”: 100.5 } }	?	用于定义到付金额
韵达（YUNDA）	SVC-INSURE	保价	需要	需要	需要属性 value(直接传保价金额)	{ “SVC-INSURE”: {“value”: 2000} }	?	用于定义声明价值,如某手机的保价金额为2000元
韵达（YUNDA）	SVC-TKZCW	韵达智橙网	需要	不需要	不需要	{ “SVC-TKZCW”: {} }	?	韵达智橙网按时效精准送达，提供按需配送、电联、送货上门等便捷的快递服务
韵达（YUNDA）	SVC-TKZCWY	韵达智橙网月结	需要	需要	不需要	{ “SVC-TKZCWY”: {} }	?	智橙网是为提升商家的物流效率和消费者的物流体验，集时效先行、服务先行为一体的韵达中高端快递产品。集中网络优势资源，提供末端派前电联和按需派送的差异化服务
韵达（YUNDA）	SVC-INTER-IMPORTS	海外直送	需要	需要	不需要属性 value	{ “SVC-INTER-IMPORTS”: {} }	?	韵达海外直送，一单到底，优先转运，专网派送。注：传该服务会取到为7743开头的特殊单号
宅急送（ZJS）	SVC-COD	代收货款	不需要	不需要	需要属性 value(直接传代收金额)	{ “SVC-COD”: { “value”: 100.5 } }	?	按照寄件方与收件方达成交易协议的要求，快递公司代寄件方客户向收件方客户收取货款，同时按照约定时间将货款返还给寄件方。
安能快递（2608021499_235）	SVC-INSURE	保价	不需要	不需要	需要属性 value	{ “SVC-INSURE”: { “value”: 100.5 } }	?	用于定义声明价值,如某手机的保价金额为2000元
跨越速运（CN7000001003751）	SVC-THIRD-PARTY-PAY	第三方付款	不需要	不需要	需要属性 value	{ “SVC-THIRD-PARTY-PAY”: { “value”: 100.5 } }	?	用于定义商家订单运费转第三方付款
跨越速运（CN7000001003751）	SVC-RECEIVER-PAY	到付	不需要	不需要	需要属性 value(直接传金额)	{ “SVC-RECEIVER-PAY”: {“value”: 100 } }	?	运费由收方付款
跨越速运（CN7000001003751）	SVC-DELIVERY-RECEIPT	跨越速运签回单	不需要	不需要	需要属性 value	{ “SVC-DELIVERY-RECEIPT”: {“value”: 1} }	?	跨越速运签回单
跨越速运（CN7000001003751）	SVC-INSURE	保价	不需要	不需要	需要属性 value	{ “SVC-INSURE”: { “value”: 100.5 } }	?	跨越速运保价服务
跨越速运（CN7000001003751）	SVC-COD	代收货款	不需要	不需要	需要属性 value	{ “SVC-COD”: { “value”: 100.5 } }	?	跨越速运代收货款
跨越速运（CN7000001003751）	SVC-PICKUPTIME	预约取件时间	不需要	不需要	需要属性 value	{ “SVC-PICKUPTIME”: { “value”: “2024-12-31 12:00” } }	该服务属性为时间格式: yyyy-MM-dd HH:mm	预约上门揽件的时间，根据实际情况填写要求物流上门揽件的时间。需注意：属性格式需要与样例完全一致且时间需晚于取号时间，否则取号失败！！！
跨越速运（CN7000001003751）	SVC-SERVICE-TYPE	服务方式	不需要	不需要	需要属性 value	{ “SVC-SERVICE-TYPE”: { “value”: “CODE_210” } }	“CODE_220”: “专运”, “CODE_210”: “空运”, “CODE_170”: “省内即日”, “CODE_160”: “省内次日”, “CODE_70”: “同城即日”, “CODE_50”: “同城次日”, “CODE_40”: “陆运件”, “CODE_30”: “隔日达”, “CODE_20”: “次日达”, “CODE_10”: “当天达”	根据与跨越合作的产品时效类型，选择对应的服务方式
信丰物流（XFWL）	SVC-COD	货到付款	不需要	不需要	需要	{ “SVC-COD”: {“value”: 100} }	?	货到付款
信丰物流（XFWL）	SVC-GOODS-MOENY	代收货款	需要	需要	需要	{ “SVC-GOODS-MOENY”: {“value”: 100} }	?	代收货款业务，用于将货物送达目的客户，并将货物的销售款项收回返给商家的一种服务；
信丰物流（XFWL）	SVC-PAYMENT-TYPE	到付	不需要	不需要	需要	{ “SVC-PAYMENT-TYPE”: {“value”: 100} }	?	到付业务，是用于寄方寄件不用支付运费，到达目的地后，由收货方支付运费给快递平台的服务。
信丰物流（XFWL）	SVC-INSURE	保价	需要	需要	需要	{ “SVC-INSURE”: {“value”: 100} }	?	保价业务，是用于为寄方物品保价服务。
京广速递（CP449455）	JGSD-PAYTYPE	付费方式	需要	需要	需要	{ “JGSD-PAYTYPE”: { “value”: “ON-DELIVERY” } }	RECEIVER-PAY到付,ON-DELIVERY寄付,MONTHLY月结	付费服务
京广速递（CP449455）	SVC-DELIVERY-TYPE	派送方式	需要	需要	需要	{ “SVC-DELIVERY-TYPE”: { “value”: “SELF” } }	SELF自提,FLOOR送货上楼	支持多种派送方式，客户可根据需要自行选择。
京广速递（CP449455）	SVC-SIGN-TYPE	签单返回	需要	需要	不需要	{ “SVC-SIGN-TYPE”: { } }	?	本服务默认为原单返回
京广速递（CP449455）	JGSD-COD	代收货款	需要	需要	需要	{ “JGSD-COD”: { “value”: 2000 } }	?	代收货款
京广速递（CP449455）	JGSD-DAOFU	到付	需要	需要	需要	{ “JGSD-DAOFU”: { “value”: 20 } }	?	到付
苏宁快递（SNWL）	SVC-INSURE	保价服务	不需要	不需要	需要	{ “SVC-INSURE”: { “value”: 200 } }	?	苏宁保价是针对全国市场例如家装家居等服务行业的B2C客户，提供基于销售商品价值的保价增值服务，提升用户体验
苏宁快递（SNWL）	SVC-INSTALL	送装一体	不需要	不需要	需要	{ “SVC-INSTALL”: { “value”: “1213141516” } }	?	送装一体是针对大件家具市场的B2C客户，提供货物配送和安装一体的服务，避免配送安装时间不统一而造成时间浪费的情况，提升客户服务体验。
苏宁快递（SNWL）	SVC-DISMANTLE	拆卸	不需要	不需要	需要	{ “SVC-DISMANTLE”: { “value”: “1213141516” } }	?	拆卸是针对大件家具市场的B2C客户，提供送货上门时同步拆除已安装的旧家具的服务，避免因等待拆除而浪费时间的情况，提升客户服务体验。
苏宁快递（SNWL）	SVC-TAKEOLD	取旧	不需要	不需要	需要	{ “SVC-TAKEOLD”: { “value”: “1213141516” } }	?	取旧是针对大件家具市场的B2C客户，提供送货上门时同步取走客户不需要旧家具的服务，提升客户服务体验。
山东D速（cp code:100007887）	SVC-COD	代收货款	不需要	不需要	需要	{ “SVC-COD”: { “value”: 1000 } }	?	代收货款业务是针对淘系B2C客户提供货到付款服务，提升客户服务体验。
中通冷链（LE14066700）	SVC-PRODUCT-TYPE	业务类型	不需要	不需要	需要属性 value	{ “SVC-PRODUCT-TYPE”: { “value”: “SINGLE” } }	SINGLE 特惠;LCL 零担	根据中通冷链现在所有覆盖的承运范围
中通冷链（LE14066700）	SVC-INSURE	保价	不需要	不需要	需要属性 value(直接传金额)	{ “SVC-INSURE”: { “value”: 1000 } }	?	即保价的金额，保费根据该值域已一定比例进行计算
中通冷链（LE14066700）	SVC-DELIVERY-TYPE	派送方式	不需要	不需要	需要属性 value	{ “SVC-DELIVERY-TYPE”: {“value”:“SEND” } }	SEND 派送; SELF 自提	派送即由物流公司送至收件客户处，自提即客户到指定网点处提货
中通冷链（LE14066700）	SVC-PAYMENT-TYPE	付款方式	不需要	不需要	需要属性 value	{ “SVC-PAYMENT-TYPE”: {“value”: “RECEIVER-PAY”} }	RECEIVER-PAY 到付 ; ON-DELIVERY 寄付 ; MONTHLY 月结	现金即发件人付运费，月结即发件人与寄件网点月度付运费，到付即收件人付运费
中通冷链（LE14066700）	SVC-SIGN-TYPE	签单方式	不需要	不需要	需要属性 value	{ “SVC-SIGN-TYPE”: { “value”: “PAPER_PAPER” } }	PAPER_PAPER 纸质/纸质 ; PAPER_ELECTRONIC 纸质/电子 ; ELECTRONIC_PAPER 电子/纸质 ; ELECTRONIC_ELECTRONIC 电子/电子	针对收发件客户需要签单业务场景，纸质/纸质即发件人/收件人都需提供纸质回单；纸质/电子即发件人提供纸质回单，收件人提供电子回单，电子/电子即收发件人均提供电子回单；电子/纸质即发件人提供电子回单，收件人提供纸质回单。
中通冷链（LE14066700）	SVC-CHILL	温区	不需要	不需要	需要属性 value	{ “SVC-CHILL”: { “value”: “COLD” } }	COLD 冷藏 ; FROZEN 冷冻	全程运输使用冷藏/冷冻车辆，分拨中转有相应温区的仓库暂存，适用温度区间冷藏2-8℃，冷冻-18℃
菜鸟速递（CP570969）	VALUE_INSURED	保价服务	需要	需要	需要	{ “VALUE_INSURED”: {“value”: 1000} }	?	菜鸟速递提供给商家的增值服务，保价金额限制为0-2w。
菜鸟速递（CP570969）	BOC-CITY	同城	需要	需要	需要	{ “BOC-CITY”: {“value”: HALF_DAY_ONLY} }	?	同城是针对同城市场例如商超/专业市场/医药等服务行业的B2C客户，提供半日达的服务，扩大门店的消费人群辐射范围，提高同城配送效率，提升客户服务体验。
联昊通（LTS）	SVC-PAYMENT-TYPE	付款方式	不需要	不需要	需要	{ “SVC-PAYMENT-TYPE”: {“value”: “RECEIVER-PAY”} }	“RECEIVER-PAY”: “到付”;“ON-DELIVER”: “寄付”; “MONTHLY”: “月结”	寄付现结：是在寄快递的时候由寄快递的这一方面进行付款，收件方直接收取快递就可以了。简单来说，寄付现结就是随即付款，由寄件人付款，收件人只需收件即可。寄付月结：是按月结算快递费用。到付：指寄件方不预先支付运费给快递公司，而是由收件人在确认签收的时候支付。
联昊通（LTS）	SVC-SIGN-TYPE	签回单	不需要	不需要	不需要	{ “SVC-SIGN-TYPE”: {} }	?	签回单是指签收回单，是寄件人在快速公司寄递快件货物后，快递公司将快件送达收件人处，收件人正常签收后，为提供原件签收单返还的服务
联昊通（LTS）	SVC-COD	代收货款	不需要	不需要	需要	{ “SVC-COD”: {“value”: 300} }	代收货款金额	代收货款业务是指受寄件人的委托，将快件送给收件人后，向收件人收取相应货款，并按约定时间将代收货款转交至寄件人的业务
联昊通（LTS）	SVC-INSURE	保价	不需要	不需要	需要	{ “SVC-INSURE”: {“value”: 500} }	保价金额	对快件价值进行保价，在运输中存在遗失、破损根据实际情况进行理赔。需要模板有相应保价标识，同时需回传保价金额及物品类型等信息
优希物流（LE31582450）	SVC-PAYMENT	到付	需要	需要	不需要	{ “SVC-PAYMENT”: { } }	?	指寄件方不预先支付运费给快递公司，而是由收件人在确认签收的时候支付
优希物流（LE31582450）	SVC-SIGN-TYPE	签单方式	需要	需要	需要	{ “SVC-SIGN-TYPE”: { “value”: “written” } }	“written”: “纸质”, “electronic”: “电子”	签单方式
优希物流（LE31582450）	SVC-INSURE	保价	需要	需要	需要	{ “SVC-INSURE”: { “value”: 2000} }	?	优希物流保价用于定义声明价值,如某手机的保价金额为2000元
平安达腾飞快递（CP446881）	SVC-RECEIVER-PAY	到付	不需要	不需要	需要	{ “SVC-RECEIVER-PAY”: { “value”: 100} }	?	平安达开通到付（到付运费），为客户提供到付服务，更好地满足客户的需求，提升客户的体验。
平安达腾飞快递（CP446881）	SVC-COD	代收货款	不需要	不需要	需要	{ “SVC-COD”: { “value”: 50} }	?	平安达开通代收货款（货物价值），为客户提供代收货款服务，更好地满足客户的需求，提升客户的体验。
平安达腾飞快递（CP446881）	SVC-INSTALLATION	干支装同城	不需要	不需要	不需要	{ “SVC-INSTALLATION”: {} }	?	平安达干支装、同城是针对线上商超家客户，提供送、装服务，提升客服服务体验。
京东快递（LE04284890）	SVC-WAREHOUSE	送货入仓	不需要	不需要	不需要	"services":{"SVC-COD":{"value":"100"},"SVC-SIGN-TYPE":{"value":"electronic"},"SVC-PICKUPTIME":{"value":"2024-09-30 19:19"},"SVC-WhDeliveryType":{"value":"C"},"SVC-INSURE":{"value":"100"},"SVC-WAREHOUSE"}，"SVC-PAYMENT":{"value":"100"}, "SVC-DOOR-TIME": {"value": "{"start": "2024-11-1813:00:00","end":"2024-11-20 12:00:00"}"}	无	"services":{"SVC-COD":{"value":"100"},"SVC-SIGN-TYPE":{"value":"electronic"},"SVC-PICKUPTIME":{"value":"2024-09-30 19:19"},"SVC-WhDeliveryType":{"value":"C"},"SVC-INSURE":{"value":"100"},"SVC-WAREHOUSE"}, "SVC-PAYMENT":{"value":"100"},"SVC-DOOR-TIME": {"value": "{"start": "2024-11-1813:00:00","end":"2024-11-20 12:00:00"}"}
	SVC-COD	代收货款	不需要	不需要	需要		为数字金额
	SVC-DOOR-TIME	预约取件时间	不需要	不需要	需要		value值格式为时间区间且取件时间不得早于取号时间： start：yyyy-MM-dd HH:mm:ss——end：yyyy-MM-dd HH:mm:ss
	SVC-SIGN-TYPE	签单返还	不需要	不需要	需要		"written": "纸质", "electronic": "电子" "written-electronic": "纸质+电子
	SVC-PICKUPTIME	预约派送	不需要	不需要	需要		派件时间格式（yyyy-MM-dd HH:mm）时间格式为固定格式
	SVC-INSURE	保价	不需要	不需要	需要		为数字金额
	SVC-WhDeliveryType	仓配标识	不需要	不需要	需要		"E": "E仓", "C": "C仓"

|
注意：
- brand_code品牌编码。顺丰目前品牌code如下
（
顺丰速运，SF
顺丰快运, FOP
），可从订购关系查询接口cainiao.waybill.ii.search 中获取品牌code，为了兼容原有逻辑，顺丰品牌code还会有default类型，用来表示本次接入前就存在的旧的顺丰订购关系，只有部分商家会存在这样的订
购关系，后面新增的商家不会有这样的订购关系。取号时传入brandCode传入default，会走老的菜鸟取号链路，而不是直连顺丰取号。
- SVC-COD 服务传入的代收金额应该与交易订单保持一致
- SVC-RECEIVER-PAY 到付金额需要支持商家自己填写
- 圆通SVC-COD， EMS的到付，EMS的SVC-COD均为独立单号规则（区别于目前普通面单的号段规则），不支持同时获取两种号段规则的订单在一个批次中批量获取单号。如，批量获取10个圆通的单号，在这10个订单中，不能既存在普通号段规则的订单，同时也存在SVC-COD规则的订单。

5. ISV物流服务接入流程

(1) 获取用户的可用的服务

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

service_desc 是该服务的描述，可以展示给前端

service_attributes是该服务支持的所有的属性

attribute_code是属性的key

attribute_name属性的名称

attribute_type属性的类型，可能值有 [number, string, enum]

type_desc枚举类型的枚举值，key为用户选中的需要传值的数据，value为对应的描述，可以作为前端的展示

以下是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":"{\"179\":\"送货上楼\",\"180\":\"送货上门\",\"285\":\"自提\"}"
               }
            ]
         },
         "service_desc":"安能物流产品类型"
      }
   ]
}

建议ISV在实现物流服务选择UI的时候，客户通过客户端缓存的数据，动态的渲染，不要写死，以便以后快递公司服务属性调整，ISV不需要感知。

注意:

在加盟型快递公司中，服务的订购是在网点下进行的，因此在同一个快递公司的不同网点下，可用的服务类型可能也是不同的。

在取号时如果传服务，则必须传search接口查询出来的可用的服务,否则会取号失败。

如果申请面单号时，传入物理服务，且物流服务为独立号段，则只能单个取号，不能使用批量接口。

拆单情况的话，要注意拆单时多次调用取号接口，传的物流服务的serviceCode必须完全一致。【特别注意：COD订单拆单金额请一定注意，多个包裹上的金额总和应等于实际需要代收的金额，谨防多收费用】

取号请求中如果带有物流服务的参数，建议每次调取号接口只取一个面单号，可通过并发调用来加快取号速度。

(2) 服务传参

在调用cainiao.waybill.ii.get 获取面单号时，可以通过以下方式来传入物流服务：

(3) 参数位置

param_waybill_cloud_print_apply_new_request -> trade_order_info_dtos -> logistics_services
该参数为String类型，是一个json格式的String。
举例：
需要value属性且给出了value的取值列表，则value值只能取列表中的一个值(比如：顺丰时效服务)：

"{\"TIMED-DELIVERY\": {\"value\": \"NEXT-MORNING\"}}"

需要value属性但是需要为value传一个数值，如金额(比如：顺丰代收货款服务)：

"{\"SVC-COD\": {\"value\": 100.5}}"

不需要属性(比如：中通优鲜送)：

"{ \"SVC-FRESH\":{}}"

(4) 对接问题答疑

请加入钉钉群，扫码入群：

FAQ

关于此文档暂时还没有FAQ

有用(3) 我要提问

电子面单对接知识库