《云栈电子面单(易单宝)isv白皮书v0.4》由会员分享，可在线阅读，更多相关《云栈电子面单(易单宝)isv白皮书v0.4（25页珍藏版）》请在金锄头文库上搜索。
1、云栈电子面单(易单宝)ISV白皮书V0.4DateVersionDescriptionAuthor2014.03.130.1全部章节新编写卓陵2014.03.260.21. 增加了CP编码；2. 获取面单号接口增加了division_id；3. 商家更新单号接口中trade_order_info_cols对象内容修正；4. 增加了API调用地址；5. 增加了Q&A卓陵2014.04.160.31. 增加了筛单接口：判断物流地址是否可达；2. 更新了部分物流公司模板3. 更新了面单二维码部分，扫码跳转到物流评价页4. 更新了部分API参数(详见各API)5. 更新了部分FAQ卓陵2014.04.
2、240.41. 增加了快递公司条码生成规则(四.电子面单模板第3部分)卓陵一、前言51. 业务背景52. 名词解释63. 重要说明63.1 云栈易单宝平台所用到编码参考规范63.2 商家开通使用易单宝条件7二、电子面单方案71. 时间计划72. 云栈易单宝平台业务模型73. 商家业务流程83.1 商家的核心业务环节83.2 服务开通申请9三. 核心接口111. 获取电子面单号111.1 应用场景111.2 规则111.3 API内容112. 更新电子面单号142.1 应用场景142.2 规则142.3 API介绍143. 获取发货地&CP开通状态&面单号余额153.1 应用场景153.2规则1
3、63.3 API介绍164. 筛单接口1：判断收件地址是否可达174.1 应用场景174.2规则174.3 API介绍175. 筛单接口2：查询支持起始地到目的地的物流公司185.1 应用场景185.2规则185.3 API介绍18四、电子面单模板181. 通用电子面单模板182. 各快递公司电子面单模板20五、电子面单二维码21六、FAQ22一、前言1. 业务背景随着电子商务平台和物流服务信息化飞速发展，面单号(或称之为运单号)成为物流服务商串联快递单、订单、商家、商品等各种信息的枢纽。相比之下，传统纸质面单价格高、信息录入效率低、信息安全隐患等方面的劣势已愈发凸显。近一年来，电子面单的普及
4、已是大势所趋。究其原因，是因为电子面单具备的独特优势：a. 效率更高n 打印效率比纸质面单提升60%-90%，每小时可打印数千张；n 对于商家，运单和拣货单可选用一张热敏纸，提高拣选效率；商家甚至在打包完成后的确认环节再去实时打印面单，高速打印确保订单能快速准确完成。b. 成本更低n 面单成本比传统纸质面单降低5倍以上；n 降低快递公司作业成本（例：据顺丰反馈，一个50人的揽收团队，使用电子面单后可降低至10人，人力成本降低5倍以上）；n 可去掉快递录单过程、提高分拨中心的分拣效率，大大提升快递处理效率，使自动分拣等技术含量高的设备投入使用成为可能，为产业升级提供技术基础；n 电商增值业务支持
5、，无需人肉绑定面单（例如：货到付款，预约配送）。c. 消费者隐私信息安全n 通过二维码隐藏收件人的隐私信息，避免消费者个人隐私泄露。2. 名词解释1云栈云栈是菜鸟和聚石塔、开放平台合作推出的一系列物流云服务。包含电子面单，智能筛单，物流推荐，安全物流云环境等，希望能通过云计算和大数据技术，不断提高商家和物流服务商效率、降低成本，提升消费者购物体验。2易单宝易单宝是云栈平台的重要服务，即电子面单服务平台。3电子面单一种新型的快递面单。材料为热敏纸，有成本低、打印快、单号方便获取、管理等特点。4电子面单二维码将收件人的隐私信息隐藏在二维码中，派件员通过可通过手持设备扫码解密；消费者可以扫码进行物流
6、评价。5TMSTransportation Management System 物流管理系统。6WMSWarehouse Management System 仓库管理系统。7TP淘拍档，即优质电子商务服务提供商。他们的产品及服务质量经过淘宝网审核，被授予“淘拍档”称号，拥有“淘拍档”授牌。淘拍档类别包含了工具软件类、运营服务类、研究咨询类等。8CP菜鸟合作伙伴，主要指物流服务商。包括顺丰，EMS，宅急送，三通一达等。3. 重要说明3.1 云栈易单宝平台所用到编码参考规范a. 物流服务商(cp_code) : 顺丰(SF)、EMS(标准快递：EMS；经济快件：EYB)、宅急送(ZJS)、圆通(Y
7、TO)、中通(ZTO)、百世汇通(HTKY)、优速(UC)b. 订单来源：订单产生的电商平台淘宝(TB)、天猫(TM)、京东(JD)、当当(DD)、拍拍(PP)、易讯(YX)、ebay(EBAY)、QQ网购(QQ)、亚马逊(AMAZON)、苏宁(SN)、国美(GM)、唯品会(WPH)、聚美(JM)、乐蜂(LF)、蘑菇街(MGJ)、聚尚(JS)、拍鞋(PX)、银泰(YT)、1号店(YHD)、凡客(VANCL)、邮乐(YL)、优购(YG)、其他(OTHERS)3.2 商家开通使用易单宝条件 商家要在ERP中使用电子面单服务，必须保证登录到ERP连接TOP session的user_id，和在卖家中
8、心开通服务的账号的user_id一致。二、电子面单方案1. 时间计划 一期于2014年4月中下旬上线.支持直营模式物流服务商：顺丰、EMS、宅急送；加盟物流服务商：百世汇通，优速。 二期计划2014年5月上线。预计支持物流服务商：中通，圆通，韵达，申通。2. 云栈易单宝平台业务模型易单宝将对接各物流服务商，统一向ISV提供包括电子面单在内的一系列服务。除了本期接入的几家物流服务商，未来还会逐步接入更多服务商，而ISV则无需任何改造即可平滑过渡。接入模式如下：3. 商家业务流程3.1 商家的核心业务环节a. 商家申请开通。在卖家中心完成；b. 物流服务商审核。申请后，物流服务商将进行审核，审核结
9、果可以在卖家中心查看；c. 商家使用。审核通过后，商家即可在支持易单宝的ERP或WMS中使用电子面单服务。3.2 服务开通申请商家需要在下图所示的路径开通电子面单服务。特别注意：商家登陆卖家中心后台申请开通电子面单服务的卖家user_id，必须与在ERP中执行申请电子面单等数据交互过程session中的user_id保持一致。开通直营物流服务商(下图以顺丰为例)；需要填入顺丰的月结账号，如果没有可以不填。开通加盟物流服务商，至少填入一个网点信息。三. 核心接口1. 获取电子面单号1.1 应用场景商家根据订单信息，实时、批量获取指定物流服务商的电子面单号。1.2 规则a. 支持淘系和非淘系订单；
10、b. 商家调用API session中的user_id要和卖家中心里开通服务的user_id保持一致；c. 支持批量获取，每次最多获取50个面单号；d. 同一订单号可以重复请求，如果面单号已存在，则返回已分配面单号；如果面单号已回收，则生成新面单号。1.3 API内容基本信息：API地址 taobao.wlb.waybill.get功能描述商家获取物流服务商电子面单号服务调用方TOP输入参数：名称类型是否必填示例值默认值描述cp_codeNumberYesSF物流服务商Codeshipping_addressprovince 非空cityareatown division_id address
11、_detail 非空ObjectYes见下发货地(一次请求只能传同一个发货地)省和详细地址必填；市、区、街道选填。division_id是发货地最细粒度地址IDtrade_order_info_colsprovince 非空cityareatownaddress_detail 非空 consign_name 非空 consign_phone 非空 trade_order_list 非空 order_channels_type 非空 item_name 非空ObjectYes见下订单信息对象。包括：收件人姓名、地址、联系方式，订单来源，店铺名，商品，订单号。trade_order_info_co
12、ls对象参数解析：consign_name，收件人姓名consignPhone，收件人联系方式tradeOrderList，订单id 可以合单(合单时建议传所有子订单号，至少传一个子订单号)，orderChannelsType，订单来源itemName，商品名称示例值：shipping_address：province:浙江省,city:杭州市,area:余杭区,division_id:330110,address_detail:文一西路969号trade_order_info_cols: consignee_address: address_detail: 朝阳路高井，财满街，财经中心9号楼
13、21单元6013, area: 朝阳区, area_code: 0, city: 北京市, city_code: 0, division_id: 0, province: 北京, province_code: 0, town_code: 0 , consignee_name: 我亮, consignee_phone: 12312312311, item_name: 沙箱测试:集市商品同步测试0001, order_channels_type: TB, trade_order_list: SW-20140403-00654 返回结果：名称类型是否必须示例值描述waybill_apply_newcolswaybill_codeshort_addressfeaturetrade_order_listorder_channels_typeObjectYes见下面单号集合waybill_apply_newcols对象字段解析：waybill_code，面单号；short_address，大头笔信息；feature，预留可扩展字段示例值：w
