云棧電子面單(易單寶)ISV白皮書-v0.4

1、電子面單ISV接入白皮書云棧電子面單(易單寶)ISV白皮書V0.4DateVersionDescriptionAuthor2014.03.130.1全部章節(jié)新編寫卓陵2014.03.260.21. 增加了CP編碼；2. 獲取面單號接口增加了division_id；3. 商家更新單號接口中trade_order_info_cols對象內(nèi)容修正；4. 增加了API調(diào)用地址；5. 增加了Q&A卓陵2014.04.160.31. 增加了篩單接口：判斷物流地址是否可達(dá)；2. 更新了部分物流公司模板3. 更新了面單二維碼部分，掃碼跳轉(zhuǎn)到物流評價頁4. 更新了部分API參數(shù)(詳見各API)5. 更新了部分F

2、AQ卓陵2014.04.240.41. 增加了快遞公司條碼生成規(guī)則(四.電子面單模板第3部分)卓陵一、前言51. 業(yè)務(wù)背景52. 名詞解釋63. 重要說明63.1 云棧易單寶平臺所用到編碼參考規(guī)范63.2 商家開通使用易單寶條件7二、電子面單方案71. 時間計劃72. 云棧易單寶平臺業(yè)務(wù)模型73. 商家業(yè)務(wù)流程83.1 商家的核心業(yè)務(wù)環(huán)節(jié)83.2 服務(wù)開通申請9三. 核心接口111. 獲取電子面單號111.1 應(yīng)用場景111.2 規(guī)則111.3 API內(nèi)容112. 更新電子面單號142.1 應(yīng)用場景142.2 規(guī)則142.3 API介紹143. 獲取發(fā)貨地&CP開通狀態(tài)&面單號余額153.1

3、應(yīng)用場景153.2規(guī)則163.3 API介紹164. 篩單接口1：判斷收件地址是否可達(dá)174.1 應(yīng)用場景174.2規(guī)則174.3 API介紹175. 篩單接口2：查詢支持起始地到目的地的物流公司185.1 應(yīng)用場景185.2規(guī)則185.3 API介紹18四、電子面單模板181. 通用電子面單模板182. 各快遞公司電子面單模板20五、電子面單二維碼21六、FAQ22一、前言1. 業(yè)務(wù)背景隨著電子商務(wù)平臺和物流服務(wù)信息化飛速發(fā)展，面單號(或稱之為運(yùn)單號)成為物流服務(wù)商串聯(lián)快遞單、訂單、商家、商品等各種信息的樞紐。相比之下，傳統(tǒng)紙質(zhì)面單價格高、信息錄入效率低、信息安全隱患等方面的劣勢已愈發(fā)凸顯。

4、近一年來，電子面單的普及已是大勢所趨。究其原因，是因為電子面單具備的獨(dú)特優(yōu)勢：a. 效率更高n 打印效率比紙質(zhì)面單提升60%-90%，每小時可打印數(shù)千張；n 對于商家，運(yùn)單和揀貨單可選用一張熱敏紙，提高揀選效率；商家甚至在打包完成后的確認(rèn)環(huán)節(jié)再去實(shí)時打印面單，高速打印確保訂單能快速準(zhǔn)確完成。b. 成本更低n 面單成本比傳統(tǒng)紙質(zhì)面單降低5倍以上；n 降低快遞公司作業(yè)成本（例：據(jù)順豐反饋，一個50人的攬收團(tuán)隊，使用電子面單后可降低至10人，人力成本降低5倍以上）；n 可去掉快遞錄單過程、提高分撥中心的分揀效率，大大提升快遞處理效率，使自動分揀等技術(shù)含量高的設(shè)備投入使用成為可能，為產(chǎn)業(yè)升級提供技術(shù)基

5、礎(chǔ)；n 電商增值業(yè)務(wù)支持，無需人肉綁定面單（例如：貨到付款，預(yù)約配送）。c. 消費(fèi)者隱私信息安全n 通過二維碼隱藏收件人的隱私信息，避免消費(fèi)者個人隱私泄露。2. 名詞解釋1云棧云棧是菜鳥和聚石塔、開放平臺合作推出的一系列物流云服務(wù)。包含電子面單，智能篩單，物流推薦，安全物流云環(huán)境等，希望能通過云計算和大數(shù)據(jù)技術(shù)，不斷提高商家和物流服務(wù)商效率、降低成本，提升消費(fèi)者購物體驗。2易單寶易單寶是云棧平臺的重要服務(wù)，即電子面單服務(wù)平臺。3電子面單一種新型的快遞面單。材料為熱敏紙，有成本低、打印快、單號方便獲取、管理等特點(diǎn)。4電子面單二維碼將收件人的隱私信息隱藏在二維碼中，派件員通過可通過手持設(shè)備掃碼解密

6、；消費(fèi)者可以掃碼進(jìn)行物流評價。5TMSTransportation Management System 物流管理系統(tǒng)。6WMSWarehouse Management System 倉庫管理系統(tǒng)。7TP淘拍檔，即優(yōu)質(zhì)電子商務(wù)服務(wù)提供商。他們的產(chǎn)品及服務(wù)質(zhì)量經(jīng)過淘寶網(wǎng)審核，被授予“淘拍檔”稱號，擁有“淘拍檔”授牌。淘拍檔類別包含了工具軟件類、運(yùn)營服務(wù)類、研究咨詢類等。8CP菜鳥合作伙伴，主要指物流服務(wù)商。包括順豐，EMS，宅急送，三通一達(dá)等。3. 重要說明3.1 云棧易單寶平臺所用到編碼參考規(guī)范a. 物流服務(wù)商(cp_code) : 順豐(SF)、EMS(標(biāo)準(zhǔn)快遞：EMS；經(jīng)濟(jì)快件：EYB)、宅

7、急送(ZJS)、圓通(YTO)、中通(ZTO)、百世匯通(HTKY)、優(yōu)速(UC)b. 訂單來源：訂單產(chǎn)生的電商平臺淘寶(TB)、天貓(TM)、京東(JD)、當(dāng)當(dāng)(DD)、拍拍(PP)、易訊(YX)、ebay(EBAY)、QQ網(wǎng)購(QQ)、亞馬遜(AMAZON)、蘇寧(SN)、國美(GM)、唯品會(WPH)、聚美(JM)、樂蜂(LF)、蘑菇街(MGJ)、聚尚(JS)、拍鞋(PX)、銀泰(YT)、1號店(YHD)、凡客(VANCL)、郵樂(YL)、優(yōu)購(YG)、其他(OTHERS)3.2 商家開通使用易單寶條件 商家要在ERP中使用電子面單服務(wù)，必須保證登錄到ERP連接TOP session的u

8、ser_id，和在賣家中心開通服務(wù)的賬號的user_id一致。二、電子面單方案1. 時間計劃 一期于2014年4月中下旬上線.支持直營模式物流服務(wù)商：順豐、EMS、宅急送；加盟物流服務(wù)商：百世匯通，優(yōu)速。 二期計劃2014年5月上線。預(yù)計支持物流服務(wù)商：中通，圓通，韻達(dá)，申通。2. 云棧易單寶平臺業(yè)務(wù)模型易單寶將對接各物流服務(wù)商，統(tǒng)一向ISV提供包括電子面單在內(nèi)的一系列服務(wù)。除了本期接入的幾家物流服務(wù)商，未來還會逐步接入更多服務(wù)商，而ISV則無需任何改造即可平滑過渡。接入模式如下：3. 商家業(yè)務(wù)流程3.1 商家的核心業(yè)務(wù)環(huán)節(jié)a. 商家申請開通。在賣家中心完成；b. 物流服務(wù)商審核。申請后，物流

9、服務(wù)商將進(jìn)行審核，審核結(jié)果可以在賣家中心查看；c. 商家使用。審核通過后，商家即可在支持易單寶的ERP或WMS中使用電子面單服務(wù)。3.2 服務(wù)開通申請商家需要在下圖所示的路徑開通電子面單服務(wù)。特別注意：商家登陸賣家中心后臺申請開通電子面單服務(wù)的賣家user_id，必須與在ERP中執(zhí)行申請電子面單等數(shù)據(jù)交互過程session中的user_id保持一致。開通直營物流服務(wù)商(下圖以順豐為例)；需要填入順豐的月結(jié)賬號，如果沒有可以不填。開通加盟物流服務(wù)商，至少填入一個網(wǎng)點(diǎn)信息。三. 核心接口1. 獲取電子面單號1.1 應(yīng)用場景商家根據(jù)訂單信息，實(shí)時、批量獲取指定物流服務(wù)商的電子面單號。1.2 規(guī)則a.

10、 支持淘系和非淘系訂單；b. 商家調(diào)用API session中的user_id要和賣家中心里開通服務(wù)的user_id保持一致；c. 支持批量獲取，每次最多獲取50個面單號；d. 同一訂單號可以重復(fù)請求，如果面單號已存在，則返回已分配面單號；如果面單號已回收，則生成新面單號。1.3 API內(nèi)容基本信息：API地址 taobao.wlb.waybill.get功能描述商家獲取物流服務(wù)商電子面單號服務(wù)調(diào)用方TOP輸入?yún)?shù)：名稱類型是否必填示例值默認(rèn)值描述cp_codeNumberYesSF物流服務(wù)商Codeshipping_addressprovince 非空cityareatown divisio

11、n_id address_detail 非空ObjectYes見下發(fā)貨地(一次請求只能傳同一個發(fā)貨地)省和詳細(xì)地址必填；市、區(qū)、街道選填。division_id是發(fā)貨地最細(xì)粒度地址IDtrade_order_info_colsprovince 非空cityareatownaddress_detail 非空 consign_name 非空 consign_phone 非空 trade_order_list 非空 order_channels_type 非空 item_name 非空ObjectYes見下訂單信息對象。包括：收件人姓名、地址、聯(lián)系方式，訂單來源，店鋪名，商品，訂單號。trade_o

12、rder_info_cols對象參數(shù)解析：consign_name，收件人姓名consignPhone，收件人聯(lián)系方式tradeOrderList，訂單id 可以合單(合單時建議傳所有子訂單號，至少傳一個子訂單號)，orderChannelsType，訂單來源itemName，商品名稱示例值：shipping_address：province:浙江省,city:杭州市,area:余杭區(qū),division_id:330110,address_detail:文一西路969號trade_order_info_cols: consignee_address: address_detail: 朝陽路高井

13、，財滿街，財經(jīng)中心9號樓21單元6013, area: 朝陽區(qū), 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 返回結(jié)果：名稱類型是否必須示例值描述waybil

14、l_apply_newcolswaybill_codeshort_addressfeaturetrade_order_listorder_channels_typeObjectYes見下面單號集合waybill_apply_newcols對象字段解析：waybill_code，面單號；short_address，大頭筆信息；feature，預(yù)留可擴(kuò)展字段示例值：waybill_code 222short_address 浙江杭州feature key1:value2;key2:value2trade_order_list 111，112order_channels_type TB2. 更新電子

15、面單號2.1 應(yīng)用場景商家更新電子面單號對應(yīng)的訂單信息。2.2 規(guī)則a. 支持淘系、非淘系訂單；b. 如果是加盟物流服務(wù)商，不能更新為發(fā)貨地為另外一個網(wǎng)點(diǎn)的訂單。2.3 API介紹基本信息：API名稱taobao.wlb.waybill.update功能描述商家可更新單號的訂單綁定關(guān)系服務(wù)調(diào)用方TOP輸入?yún)?shù)：名稱類型是否必填示例值默認(rèn)值描述cp_codeNumberYes物流服務(wù)商Codewaybill_codeNumberYes需要更新的面單號trade_order_info_cols province 非空cityareatown address_detail 非空 consign_na

16、me非空 consign_phone非空 tradeOrderList 非空 order_channels_type 非空 item_name非空ObjectYes參見獲取面單號接口訂單信息對象。包括：收件人姓名、地址、聯(lián)系方式，訂單來源，店鋪名，商品，訂單號。trade_order_info_cols入?yún)⑹纠篶onsignee_address:address_detail:文三西路100號,area:一區(qū),city:寧波市,division_id:330112,province:浙江省,consignee_name:ykz,consignee_phone:123442311,item_na

17、me:洗衣機(jī),order_channels_type:TB,waybill_code:8000000034013,trade_order_list:1234返回結(jié)果：名稱類型是否必須示例值描述trade_order_info_cols對象參數(shù)解析：見“商家獲取面單號”API3. 獲取發(fā)貨地&CP開通狀態(tài)&面單號余額3.1 應(yīng)用場景商家可以查詢已開通電子面單的物流服務(wù)商的面單號余額，以及網(wǎng)點(diǎn)開通狀態(tài)。3.2規(guī)則a. 已開通的加盟型物流公司返回發(fā)貨地、網(wǎng)點(diǎn)和面單余額，直營型物流公司返回發(fā)貨地；b. 未開通物流服務(wù)商返回失敗。3.3 API介紹基本信息：API名稱taobao.wlb.waybill

18、.search功能描述商家查詢物流服務(wù)商的可用單號服務(wù)調(diào)用方TOP輸入?yún)?shù)：名稱類型是否必填示例值默認(rèn)值描述seller_idStringYes100000申請開通易單寶的sellerIDcp_codeNumberYes12345物流服務(wù)商Code返回結(jié)果：名稱類型示例值描述Subscribtionsprovincecityareatownaddress_detail branch_code quantity unshipped_quantityObject見下返回的發(fā)貨地址、網(wǎng)點(diǎn)以及面單余額；直營快遞無單號余額限制，但是易單寶會在服務(wù)端控制以避免惡意獲取。Subscribtions對象參數(shù)解

19、析：branch_code 網(wǎng)點(diǎn)編碼；branch_name 網(wǎng)點(diǎn)名稱；quantity賬戶余額；unshipped_quantity 未確認(rèn)發(fā)貨的數(shù)量。4. 篩單接口1：判斷收件地址是否可達(dá)(推薦使用)將整合所有物流公司精確到4級的派送能力數(shù)據(jù)，結(jié)合高德的地址解析技術(shù)以及物流公司的進(jìn)一步精準(zhǔn)判斷能力，為商家提供最有效的是否可達(dá)服務(wù)。優(yōu)化后的接口，篩單精準(zhǔn)度會從現(xiàn)有的76%提升至90%以上（預(yù)計5月底完成）。4.1 應(yīng)用場景根據(jù)輸入的目的地地址和選擇的物流公司，判斷服務(wù)是否可達(dá)。(支持EMS、匯通、順豐、天天、圓通、宅急送、中通)4.2規(guī)則暫無4.3 API介紹基本信息：API名稱taobao

20、.logistics.address.reachable功能描述查詢目的地是否可達(dá)服務(wù)調(diào)用方TOP詳見TOP頁面：5. 篩單接口2：查詢支持起始地到目的地的物流公司將整合所有物流公司精確到4級的派送能力數(shù)據(jù)，結(jié)合高德的地址解析技術(shù)以及物流公司的進(jìn)一步精準(zhǔn)判斷能力，為商家提供最有效的是否可達(dá)服務(wù)。接口優(yōu)化后，篩單精準(zhǔn)度較將從現(xiàn)在的76%提升至90%以上（預(yù)計6月初上線）。5.1 應(yīng)用場景根據(jù)輸入的發(fā)貨地和目的地，判斷有哪些物流公司可達(dá)。5.2規(guī)則暫無5.3 API介紹基本信息：API名稱taobao.logistics.partners.get功能描述查詢目的地是否可達(dá)的物流公司服務(wù)調(diào)用方TOP

21、詳見TOP頁面：四、電子面單模板1. 各快遞公司電子面單模板商家需要使用快遞公司提供的模板打印、發(fā)貨，否則快遞公司可能會拒絕攬收。目前提供電子面單模板的包括：順豐，EMS，宅急送，圓通，百世匯通，優(yōu)速。下載地址：提取碼：BuEqSt2. 通用電子面單模板對于沒有提供電子面單模板的快遞公司，可以使用空白熱敏紙打印標(biāo)準(zhǔn)模板替代，替換不同快遞公司LOGO即可。易單寶聯(lián)合本期接入的多家物流服務(wù)商，共同推出基礎(chǔ)的電子面單模板。ISV可遵循以下模板規(guī)范提供給商家打印使用。模板樣式(以順豐為例，各快遞公司模板將持續(xù)更新) 尺寸規(guī)范：為保持打印機(jī)耗材一致，紙張尺寸要求寬度確定，長度可適當(dāng)調(diào)整：寬度確保在10c

22、m；長度建議15cm，可根據(jù)需要自行確定。(12-15用下面15號的字體) 內(nèi)容規(guī)范：每家快遞物流服務(wù)商對面單內(nèi)容有個性化要求，易單寶電子面單規(guī)范里加入了2個新內(nèi)容選項：2)，物流服務(wù)表達(dá)；16)，電子面單二維碼?！菊f明：2，物流服務(wù)表達(dá)：包含物流服務(wù)名稱和服務(wù)描述。如模板中的：“次日必達(dá)”，“2014/3/13，上午必達(dá)”】3. 各快遞公司面單號生成條碼的規(guī)則CODE各快遞公司的單號生成條碼要用128碼方式生成，具體CODE規(guī)則如下：序號快遞公司名稱面單碼CODE1順豐128C2宅急送128A3EMS128A4百世匯通128C5中通128B6優(yōu)速128C必須嚴(yán)格按照此條碼生成規(guī)則生成條碼，否

23、則快遞公司巴槍可能無法掃描。五、電子面單二維碼說明：物流評價功能還在開發(fā)中，預(yù)計5月底-6月初發(fā)布，電子面單二維碼位置建議先留空；物流評價上線后再更新。消費(fèi)者收到包裹后，可以掃碼電子面單上的二維碼可以進(jìn)行物流評價。未來，電子面單可能會隱藏收件人部分個人隱私信息，物流服務(wù)商的派件員掃碼驗證后才能獲取，最大限度的保證消費(fèi)者隱私安全。二維碼打印在電子面單的指定區(qū)域，具體詳見電子面單模板設(shè)計。 二維碼尺寸長*寬：25mm*25mm 電子面單二維碼文案二維碼下方顯示文字提示用戶進(jìn)行操作，建議文案：“掃碼評價” 二維碼內(nèi)容二維碼完整內(nèi)容：由一個固定URL(黃色URL部分還需要調(diào)整)和3個參數(shù)組成： cpC

24、ode =SF&sellerID=0123456& waybillCode=88917679009- URL和參數(shù)說明：名稱是否必填示例值描述Yes100000固定URL。用于消費(fèi)者掃碼后，根據(jù) cp_code 跳轉(zhuǎn)到物流評價頁面cp_codeYesSF物流服務(wù)商CodesellerIDYes0010222訂單對應(yīng)店鋪的sellerIDwaybillCodeYes8891面單號 掃碼后的頁面物流評價頁面：六、FAQQ: 商家如何才能使用電子面單服務(wù)？A: 商家需要登錄：淘寶-賣家中心-物流服務(wù)-易單寶，選擇物流服務(wù)商，申請開通服務(wù)。申請通過后即可在ERP中使用(ERP已對接云棧的電子面單平臺。)Q: 現(xiàn)在開通了哪些