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

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

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

更新时间:2024/02/22 访问次数:89294

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

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

(1) 服务开通

image

image

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

(2) 服务审核

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

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

  • 商家取号时,ISV将服务值传给菜鸟电子面单系统:
  • 菜鸟电子面单系统判断服务是否已经订购成功(无需订购的服务不校验);
  • 取号后将服务信息在面单信息下发接口中下发给快递公司。

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

image

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

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” : “123456”}}} 签收确认
顺丰(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”: { } } 安装服务
顺丰(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”: { } } 宅配延伸
顺丰(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”:“123”} } 通电验机
顺丰(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-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-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”: {} } 韵达智橙网按时效精准送达,提供按需配送、电联、送货上门等便捷的快递服务
宅急送(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-SERVICE-TYPE 服务方式 不需要 不需要 需要属性 value { “SVC-COD”: { “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”: “123456” } } 送装一体是针对大件家具市场的B2C客户,提供货物配送和安装一体的服务,避免配送安装时间不统一而造成时间浪费的情况,提升客户服务体验。
苏宁快递(SNWL) SVC-DISMANTLE 拆卸 不需要 不需要 需要 { “SVC-DISMANTLE”: { “value”: “123456” } } 拆卸是针对大件家具市场的B2C客户,提供送货上门时同步拆除已安装的旧家具的服务,避免因等待拆除而浪费时间的情况,提升客户服务体验。
苏宁快递(SNWL) SVC-TAKEOLD 取旧 不需要 不需要 需要 { “SVC-TAKEOLD”: { “value”: “123456” } } 取旧是针对大件家具市场的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。

注意:
- 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) 对接问题答疑

请加入钉钉群,扫码入群:

image

FAQ

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