随着业务的发展,各快递公司越来越注重差异化服务的提供,如COD服务、VIP服务、保价服务等。这些服务可能具备如下几个特点:
(1)某些服务需要商家在淘宝卖家中心中进行订购,快递公司审批后才能选择;
(2)某些服务的电子面单号段需要与普通号段区分开,例如:普通号段为77开头,COD服务需要66开头的号段。
商家点击“开通”,即发送订购关系给到快递公司进行审核【无需订购的服务不在卖家中心进行展示,ISV支持商家进行选择即可】
快递公司对商家订购的服务进行审核。审核通过、审核不通过的状态均会展示给商家;
备注:使用菜鸟云打印可直接打印出标准的服务承载样式,建议使用菜鸟云打印!若未使用菜鸟云打印,也请将服务按照菜鸟的样式进行打印,否则存在资损的风险,请一定注意!
规则 | 说明 |
---|---|
是否需要订购 | 需要订购的服务需要到淘宝卖家中心中订购。不需要订购的服务则不需要在淘宝卖家中心订购,可直接使用。 |
是否需要审核 | 需要审核的服务在订购后会由快递公司来审核,只有审核通过后才可使用该服务。不需要审核的服务需要在淘宝卖家中心订购,订购后自动审核通过。 |
是否需要属性 | 属性是一个定义了的常量,如value。属性有自己对应的取值。如货到付款服务,value值可取一个正数。不需要属性的服务传参时直接传服务的serviceCode即可,需要属性的服务在传参时需要带上属性值。 |
快递公司 | 服务编码(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规则的订单。
订购关系查询接口cainiao.waybill.ii.search 中新增服务属性相关数据,前端可以根据该服务属性实现服务选择界面
商家选择快递公司后,ISV需要给商家提供选择快运服务的能力,这个和之前的快递选择服务是一样的接口。
以下是部分的字段解释:
service_desc
是该服务的描述,可以展示给前端service_attributes
是该服务支持的所有的属性attribute_code
是属性的keyattribute_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不需要感知。
注意:
在调用cainiao.waybill.ii.get 获取面单号时,可以通过以下方式来传入物流服务:
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\":{}}"
请加入钉钉群,扫码入群: