唯品會開放平臺對接手冊

廣州市荔灣區(qū)花海街2（嗎

1luahaiKoadJiwanl>stric^Guang4ou唯品合

IdI?哈2a22330000

FaxI<86^20^22330111

唯品合

開放平臺

唯品會開放平臺對接手冊

廣州市荔灣區(qū)花海街2（嗎

201luahaiRoadJiwanDistrictyGuang4ou唯品合

TelI,哈2a22330000

FaxI<8^20^22330111

修訂記錄

序號日期作者標(biāo)題或簡單描述版本狀態(tài)

12015-03-18江振彥新建文檔V1.0新建

22015-09-07俞丹妮修改文檔V1.1修改

32016-10-27楊曉波修改文檔：商品部分V2.0修改

廣州市荔灣區(qū)花海街2（嗎

201luahaiRoadJiwanDistrictyGuang4ou唯品合

TelI,哈2a22330000

FaxI<8^20^22330111

目錄

1.簡介................................................................................5

1.1手冊目的..........................................................................5

1.2讀者對象..........................................................................5

1.3名詞解釋..........................................................................6

1.4參考資料..........................................................................6

2.系統(tǒng)簡述............................................................................7

2.1開放平臺簡介......................................................................7

2.2開放平臺接入......................................................................7

2.3接口調(diào)用請求.....................................................................12

2.4沙箱環(huán)境介紹.....................................................................16

2.5Oauth介紹.......................................................................17

3.開放接口...........................................................................17

3.1整體業(yè)務(wù)漏呈.....................................................................17

3.2品牌接口服務(wù).....................................................................18

3.3類目接口服務(wù).....................................................................19

3.4尺碼表接口服務(wù)...................................................................21

3.5供應(yīng)商商品接口服務(wù)...............................................................25

3.6門店業(yè)務(wù)接口&庫存信息接口服務(wù)....................................................41

3.7JIT配送接口服務(wù)..................................................................45

3.8退供單接口服務(wù)...................................................................51

3.9直發(fā)配送接口服務(wù).................................................................52

3.10地址庫接口服務(wù)...................................................................55

廣州市荔灣區(qū)花海街2（嗎

201luahaiRoadJiwanDistrictyGuang4ou唯品合

TelI,哈2a22330000

FaxI<8^20^22330111

3.11消息推送服務(wù)...................................................................56

4.結(jié)語57

廣州市荔灣區(qū)花海街2（阿

201luahaiRoadJiwanDistrictyGuang4ou唯品合

■吟2a22330000

?86^20^22330111

1.簡介

1.1手冊目的

伴隨著互聯(lián)網(wǎng)電子商務(wù)業(yè)務(wù)的不斷發(fā)展，越來越多的知名國內(nèi)外品牌代理商及廠家通過與唯品會

(VIP)的合作，向中國消費者提供低價優(yōu)質(zhì)、受歡迎的品牌正品。面對巨大業(yè)務(wù)數(shù)據(jù)，如何能與渠道、

供應(yīng)商、合作方高效實時共享信息、集成系統(tǒng)也成為了唯品會及其合作伙伴共同的目標(biāo)。

唯品會開放平臺(VIPOpenPlatform，或VOP)作為唯品會對外對接通道，為我們的合作伙伴提

供包括檔期、商品、類目、庫存、訂單等模塊接口。并期望通過接口對接，實現(xiàn)包括業(yè)務(wù)推廣、打通商

品資料及庫存、供應(yīng)商訂單管理等不同場景業(yè)務(wù)需求。同時進一步加快商品的周轉(zhuǎn)率、縮短配送時間，

實現(xiàn)對用戶體驗的重大提升，并為未來唯品會與合作伙伴之間深化合作構(gòu)建基礎(chǔ)，提供可行整體解決方

案，最終形成互利共贏局面。

本文檔作為唯品會開放平臺與合作方對接參考文檔，將著重就對接業(yè)務(wù)流程以及相關(guān)開放接口的使用

場景和進行說明。更多詳細(xì)信息同時可參考唯品會開放平臺。

1.2讀者對象

本文檔作為唯品會開放平臺與合作方對接參考文檔僅限唯品會內(nèi)部及授權(quán)合作用戶使用，不得用于其

他商業(yè)用途，違者將追究其法律責(zé)任。

考慮文檔限制，部分內(nèi)容詳情請通過鏈接方式，建議在網(wǎng)絡(luò)情況下查看。更多內(nèi)容也請訪問我們頁面

http:〃/獲取相關(guān)內(nèi)容。

如有疑問請直接與我們?nèi)〉寐?lián)系：

聯(lián)系郵箱,vcp@vipshcpcom

聯(lián)系地址：上海市閘北區(qū)四行天地4樓B區(qū)

廣州市荔灣區(qū)花海街2（阿

201luahaiRoadJiwanDistrictyGuang4ou唯品合

TelI■吟2a22330000

FaxI?86^20^22330111

13名詞解釋

名詞解釋

VIP唯品會

V0P唯品會開放平臺

JIT準(zhǔn)時制生產(chǎn)方式，供應(yīng)商在開售中根據(jù)訂單數(shù)量,將貨發(fā)到指定的

唯品會庫房，再由唯品會庫房發(fā)貨給用戶.

直發(fā)供應(yīng)商直接發(fā)貨給用戶

SO單SaleOrder,銷售單

P0單PurchaseOrder,入庫單/采購訂單

WMSWarehouseManagementSystem,倉儲管理系統(tǒng)

VISVendorInformationSystem，供應(yīng)商平臺

ERPEnterpriseResourcePlanning,系統(tǒng)是企業(yè)資源計劃

ISV獨立軟件報務(wù)商

Sandbox沙箱環(huán)境是一個為開放平臺開發(fā)人員提供斐口聯(lián)調(diào)測試的環(huán)境

1.4參考資料

?唯品會商品圖片質(zhì)量規(guī)范（請與我們聯(lián)系索取相關(guān)資料）

廣州市荔灣區(qū)花海街2（阿

201luahaiRoadJiwanDistrictyGuang4ou唯品合

TelI■吟2a22330000

FaxI?86^20^22330111-??n?W?KR?

2.系統(tǒng)簡述

2.1開放平臺簡介

唯品會開放平臺（VIPOpenPlatform，或VOP）是為唯品會合作伙伴提供服務(wù)的平臺，而開放平

臺開發(fā)接口則是提供服務(wù)的基礎(chǔ)，開發(fā)者在開放平臺網(wǎng)站中創(chuàng)建賬號、獲取接口權(quán)限后，可以通過VOP

提供接口實現(xiàn)各種場景需求。

基于穩(wěn)定的架構(gòu)系統(tǒng)開放平臺可向合作伙伴和用戶高效，安全地提供各類業(yè)務(wù)數(shù)據(jù)及服務(wù)，最終建

立起良好的開放電子商務(wù)生態(tài)圈例如：

?供應(yīng)商能夠通過VOP獲取各類唯品會功能服務(wù)，如商品類目服務(wù)、訂單服務(wù)、庫存服務(wù)、配送服務(wù)

等，并通過唯品ERP或第三方ERP實現(xiàn)供應(yīng)商和唯品會信息系統(tǒng)的對接。

?個人開發(fā)者或網(wǎng)站合作伙伴能夠在VOP上開發(fā)各類應(yīng)用以服務(wù)于用戶并通過收益分成模式獲取報酬。

?ISV可以基于唯品會開放服務(wù)為供應(yīng)商或用戶定制開發(fā)獨立軟件，并共享唯品會開放的數(shù)據(jù)資源。

2.2開放平臺接入

2.2.1接入流程

廣州市荔灣區(qū)花海街2（阿

201luahaiRoadJiwanDistric^Guang4ou唯品合

TelI■吟2a22330000

FaxI?86^20^22330111

2.2.2注冊成為開發(fā)者

1）打開http:〃,進入開放平臺的網(wǎng)站，并請使用畦品會賬戶進行登錄

苜頁AP!文檔中心支持校制臺|g曳錄

供應(yīng)商信息對接

供應(yīng)商能夠通過V0P荻取各類唯品會功能題務(wù).例如育品煲目

務(wù).訂單原務(wù).原書孤務(wù).配送服務(wù)等.并通過&BERP”三

萬tH產(chǎn)實說供網(wǎng)用和限胡會他圮殺我的對懶

2）選擇加入開放平臺

0接入流程

媒戶關(guān)于VOP關(guān)注麗

,3UMUJLM?VWgU?=Ft=WRat￡i??vurt^c41M.?aw?e

?API如?開發(fā)，ae及隊延?VOPi?

?文立—?應(yīng)順殂?常滅s?黑鶯與疏

?刑?R*R?

3）點擊注冊

個人中O

4）填寫基本信息。號為必填項）

?員>莊?陽

?

?電話

廣州市荔灣區(qū)花海街2（阿

201luahaiRoadJiwanDistric^Guang4ou唯品合

TelI■吟2a22330000

FaxI?86^20^22330111

5）注冊成功

唯品會開放平臺API文檔中出

?Q＞融陽

>田睨疥發(fā)畬5&?

WC.。耽atKA”上?.

WBE在可以MS網(wǎng)了，

司在現(xiàn)殳應(yīng)用硝Hiig個人

6）填寫開發(fā)者認(rèn)證信息（填寫了認(rèn)證信息才可以提交應(yīng)用審核）

曜尻合開放平臺苒頁API文號中。支持必臺15201W2964退出

?目＞^）0＞“還值重

認(rèn)if信息

可以透卬企業(yè)用戶或叁個人用戶

?開，:個人

IMAC

、二--■

?■北班萼0：

??滋執(zhí)照2??W

上愣￡隹又付《?珞徑另處》

?組W機分代碼：

m^ru9G??n：

2.2.3創(chuàng)建應(yīng)用

1）進入控制臺

廣州市荔灣區(qū)花海街2（阿

201luahaiRoadJiwanDistrictyGuang4ou唯品合

TelI■吟2a22330000

FaxI?86^20^22330111

2）創(chuàng)建應(yīng)用

05品會I開放平臺百頁API文檔中心支持校制臺1S2018二二：退出

?員》按■日

個人中i

尾戶名：15201W2W

.■：com

M：152O1M2MO

3）填寫應(yīng)用信息

目前VOP支持應(yīng)用包括類型，請根據(jù)合作類型填寫相應(yīng)資料

?買家無線應(yīng)用：為買家提供無線端唯品會商品導(dǎo)購服務(wù)（如市場管理中心等合作項目，請確定選

擇合作部門，保證應(yīng)用審核正常通過）

?買家網(wǎng)站應(yīng)用：和外部合作網(wǎng)站提供唯品會流量引入、商品導(dǎo)購、品牌推薦、活動推廣、海外業(yè)

務(wù)等服務(wù)，為買家提供在第三方平臺上運行的唯品會特賣商品查詢和搶購工具

?供應(yīng)商--自研應(yīng)：具有信息技術(shù)能力的供應(yīng)商直接和唯品會進行系統(tǒng)對接（供應(yīng)商ID請向?qū)?/p>

商務(wù)索?。?/p>

?供應(yīng)商--服務(wù)商應(yīng)用：ISV為供應(yīng)商提供應(yīng)用服務(wù)

廣州市荔灣區(qū)花海街2（阿

201luahaiRoadJiwanDistric^Guang4ou唯品合

TelI■吟2a22330000

FaxI?86^20^22330111-??n?W?KR?

*名稱：__________________________________|

*應(yīng)用標(biāo)簽：V目研談V（2）

描述：

*回調(diào)URL：例:www.vip.ccm

*供應(yīng)商ID：?

?供應(yīng)商名稱：]

姆：OJn■口酸

2.2.4審核授權(quán)

進入應(yīng)用詳情

■貢〉例歸

個人中心

用9名：15201W29M

如霜：wth??>Q9maicom工幽昂目

Ml：1520193旃

■?紂科創(chuàng)*網(wǎng)用?理應(yīng)用發(fā)表中。

點擊應(yīng)用列表中的應(yīng)用名稱.資看應(yīng)用詳情

除M關(guān)型征芍

■研nbietdB嚴(yán)*中

應(yīng)用提交審核前，必須先完善開發(fā)者認(rèn)證信息。提交審核后，審核期間的應(yīng)用基本信息不可以修改。審

核通過將獲得生產(chǎn)環(huán)境中接口調(diào)用權(quán)限（沙箱可直接使用）

廣州市荔灣區(qū)花海街2（阿

201luahaiRoadJiwanDistrictyGuang4ou唯品合

TelI■吟2a22330000

FaxI?86^20^22330111

?天>12用?弟>

應(yīng)用或兄

支用6工

?名稱：世圮住Q

應(yīng)用虹

1E2I?應(yīng)用鼻王：I買涼

理麻述：

2.2.5權(quán)限及流量說明

證書流量限定了一個應(yīng)用一天內(nèi)調(diào)用API次數(shù)。不同標(biāo)簽的應(yīng)用通過審核后會獲得相應(yīng)的基礎(chǔ)流量值，

開發(fā)者也可以根據(jù)自己的實際情況申請額外的流量包。更多流量權(quán)限規(guī)則請參考應(yīng)用流量權(quán)限。

2.3接口調(diào)用請求

2.3.1調(diào)用介紹

V0P作為唯品會開放平臺的數(shù)據(jù)出口，用戶只需要按照V0P的規(guī)范拼裝一個正確的請求URL,通過

HTTP請求到V0P,即能獲取到所需的數(shù)據(jù)。

2.3.2調(diào)用環(huán)境入口

環(huán)境入口釋義：調(diào)用API時，需要傳入如下地址，獲取相應(yīng)環(huán)境下的數(shù)據(jù)。

?沙箱環(huán)境入口地址：

?正式環(huán)境入口地址：http:〃師叩

4廣州市盆灣區(qū)花海街久瑪唯JH合

|201luahaiRoadJiwanDistric^Guang4iou”答UUI—>

TelI<862(X22330000Vlp.C0m

WFaxI.86-20-22330111-

2.3.3調(diào)用參數(shù)

調(diào)用API時，必須傳入系統(tǒng)級參數(shù)和對應(yīng)的應(yīng)用級參數(shù)。各個API的輸入應(yīng)用參數(shù)和返回結(jié)果詳見"開放

接口"章節(jié)。

系統(tǒng)級參數(shù)：

名稱類型是否必須描述

serviceString是服務(wù)名稱

methodString是方法名稱

versionString是版本號

timestampInteger是調(diào)用時間戳,Epoch格式，系統(tǒng)接受的時間差不超過10分鐘

formatString是報文格式xml/json

appKeyString是應(yīng)用ID,唯品會開放平臺分配給應(yīng)用的唯一標(biāo)識

signString是根據(jù)簽名算法的簽名運算結(jié)果

應(yīng)用級參數(shù)示例：

名稱類型是否必須示例值默認(rèn)值描述

idInteger是1234整數(shù)值

start_dateString是2014/5/8字符類型

warehouseWarehouse是Warehouse.VIP_NH枚舉類型

nav_category_id1List<String>否["123"]List類型

如下為VOP應(yīng)用級參數(shù)拼裝示例

描述示例

(

"url":"",

標(biāo)準(zhǔn)json

"start_time":"2014-06-1014:53:21",

類型

"hashcode":"abcdefg"

)

標(biāo)準(zhǔn)xml<request><url></url><start_time>2014-06-10

類型14:53:21</start_time><hashcode>abcdefg</hashcode></request>

廣州市霆灣區(qū)花海街，(厝

201luahaiRoadJiwanDistric^Guang4ou唯品合

TelI■吟2a22330000

FaxI?86^20^22330111

2.3.4API簽名

調(diào)用API時需要對請求參數(shù)進行簽名，VOP服務(wù)器端會驗證請求參數(shù)是否合法。

簽名算法：

第1步、對除appSecret外的所有系統(tǒng)級參數(shù)進行按照首字母先后順序排列為appKey,format,method,

service,timestamp,version

第2步、把排序后的結(jié)果按照參數(shù)名+參數(shù)值的方式拼接后再拼接上應(yīng)用級參數(shù)

例如：appKeyXXXXformatXXXXmethodXXXXserviceXXXXtimestampXXXXversionXXXXYYYY,Mct3

YYYY是應(yīng)用級參數(shù)

第3步、以appSecret作為秘鑰對拼裝好的字符串進行hmac-md5加密

例如：hmac-md5(appKeyXXXXformatXXXXmethodXXXXser\qceXXXXtimestampXXXXversionXX

XXYYYY,叩pSecret)

得到結(jié)果：2CA5D80723A40B59E095A4D675D46449

示例（以下示例只體現(xiàn)邏輯）

iDfficom.vip.ospserver.api.OtherService,假設(shè)appKey=yourappKey、appSecret=yourappSecret

1）系統(tǒng)級輸入?yún)?shù)：

service=com.vip.ospserver.api.OtherService

method=getPopReplaceIntoAfterSaleAddress

version=1.0.0

timestamp=1406851200

format=json

appSecret=yourappsecret

appKey=yourappkey

2）應(yīng)用級輸入?yún)?shù)：

，

廣州市荔灣區(qū)花海街2(阿

201luahaiRoadJiwanDistric^Guang4ou唯品合

TelI■吟2a22330000

FaxI?86^20^22330111

"start_time":"2014-06-1014:53:21",

"hashcode\-abcdefg"

)

3）把除appSecret外的所有系統(tǒng)級參數(shù)按照字母順序排列

appKey=1

format=json

method=getPopReplaceIntoAfterSaleAddress

service=com.vip.ospserver.api.OtherService

timestamp=1406851200

version=1.0.0

G把排序后的系統(tǒng)級參數(shù)按照參數(shù)名+參數(shù)值連接起來，并把應(yīng)用級參數(shù)值放在最后，形成最終的拼接

串:appKey1forma1jsonmethodgetPopReplaceIntoAfterSaleAddressservicecom.vip.osps

erver.api.OtherServicetimestampI406851200version1.0.0{"urr："","start_time":"

2014-06-1014:53:21","hashcode":"abcdefg'）

5）以appSecret作為秘鑰對上述拼裝好的字符串進行hmac-md5加密，得到簽名結(jié)果：2CA5D8072

3A40B59E095A4D675D46449

2.3.5拼裝HTTP請求

調(diào)用API時，將所有的系統(tǒng)級參數(shù)轉(zhuǎn)換成UTF-8編碼，以GET方式提交，應(yīng)用級參數(shù)以POST方式提

交，提交到正式（或沙箱）環(huán)境入口地址，就可以獲取接口返回的數(shù)據(jù)。

2.3.6API調(diào)用注意事項

?所有的API請求和響應(yīng)數(shù)據(jù)編碼皆為UTF-8格式，URL里的所有參數(shù)值請做urlencode編碼

?API請求的應(yīng)用級參數(shù)需要轉(zhuǎn)換成xml或json格式

?返回結(jié)果格式與你選擇的請求格式一致

?簽名方式為hmac-md5（params,appSecret）,其中params是按參數(shù)名字母順序排序后拼接而成的。

2.3.7API調(diào)用示例

參考示例請下載附件完整的參考示例

廣州市荔灣區(qū)花海街2（阿

201luahaiRoadJiwanDistrictyGuang4ou唯品合

TelI■吟2a22330000

FaxI?86^20^22330111

2.4沙箱環(huán)境介紹

沙箱環(huán)境(Sandbox)是一個為開放平臺開發(fā)人員提供接口聯(lián)調(diào)測試的環(huán)境，開發(fā)人員可以連接到

Sandbox進行API的開發(fā)、測試，等待相關(guān)的功能驗收通過后,再根據(jù)實際情況正式連接生產(chǎn)環(huán)境。

Sandbox具有如下特征：

?功能上，Sandbox可以理解為一整套的唯品會系統(tǒng)的克隆，包括B2C、VIS、PMS、TMS、WMS、

ODS、CIS、Payment.EBS等多個子系統(tǒng)及相關(guān)的數(shù)據(jù)庫系統(tǒng)，提供了與生產(chǎn)環(huán)境相一致的功能。

?Sandbox是一套提供給外部用戶聯(lián)調(diào)的測試系統(tǒng)，可以從公網(wǎng)進行訪問(回歸測試環(huán)境只能在內(nèi)網(wǎng)

訪問，而預(yù)發(fā)布環(huán)境實際上是一種生產(chǎn)環(huán)境)

?Sandbox與生產(chǎn)環(huán)境數(shù)據(jù)完全隔離，Sandbox中的接口不能通過內(nèi)網(wǎng)、或者公網(wǎng)的方式訪問生產(chǎn)

系統(tǒng)，反之亦然。這種隔離方式降低了沙箱在發(fā)生錯誤訪問的情況下對生產(chǎn)環(huán)境帶來的數(shù)據(jù)安全、

系統(tǒng)安全等問題的影響。

?Sandbox在網(wǎng)絡(luò)上盡可能物理隔離，即便對Sandbox進行攻擊，也不會影響到生產(chǎn)系統(tǒng)的網(wǎng)絡(luò)。

基于這樣的特性Sandbox可以提供給我們的合作伙伴一個安全，獨立的測試的環(huán)境以便允許用戶可

以在磷測試時可以在不影響生產(chǎn)環(huán)境數(shù)據(jù)同時完成從檔期創(chuàng)建，生成P。，訂單下發(fā)等整套業(yè)務(wù)流程。

為雙方完全系統(tǒng)對接提供技術(shù)支持和保證。

沙箱管理將作為VOP管理平臺的一部分。用戶創(chuàng)建應(yīng)用后，可在VOP平臺上統(tǒng)一管理其生產(chǎn)環(huán)境

及沙箱賬號及權(quán)限。并同時獲得沙箱使用相關(guān)說明。但2套的權(quán)限使用是完全獨立互不影響。

當(dāng)應(yīng)用建應(yīng)用后，系統(tǒng)自動分配所屬應(yīng)用在的沙箱環(huán)境的沙箱叩pkey和沙箱叩psecret。

?一個供應(yīng)商一個的應(yīng)用1個沙箱appkey和1個沙箱appsecret

?一個供應(yīng)商的多個應(yīng)用不允許對應(yīng)相同的沙箱appkey和沙箱appsecret

當(dāng)測試賬戶申請應(yīng)用上線時，平臺管理員審核通過后生效已分配生產(chǎn)環(huán)境appkey和appsecret.

更多詳情請參加沙箱環(huán)境操作手冊。

廣州市荔灣區(qū)花海街2（阿

201luahaiRoadJiwanDistrictyGuang4ou唯品合

TelI■吟2a22330000

FaxI?86^20^22330111

2.5Oauth介紹

為提供用戶安全、可靠的、一致的機制控制API接口對數(shù)據(jù)權(quán)限的管理，V0P同時支持Oauth2.0

孫議。通過使用該協(xié)議，資源所有者（用戶、供應(yīng)商、VIP官方等）實現(xiàn)所擁有數(shù)據(jù)授權(quán)的API服務(wù)。

如獨立軟件商或有開發(fā)能力的合作商和唯品會開放平臺對接后，需要獲取受保護的資源數(shù)據(jù)（如用戶訂

單、用戶收獲地址、供應(yīng)商訂單、CPS聯(lián)盟數(shù)據(jù)等），需要獲得資源所有者的授權(quán)，獲取頒發(fā)的訪問令

牌，通過提供頒發(fā)的訪問令牌訪問API服務(wù)。同時期望通過該機制在安全可靠的前提下，實現(xiàn)更多業(yè)務(wù)模

式上的拓展。

3.開放接口

3.1整體業(yè)務(wù)流程

廣州市荔灣區(qū)花海街2（阿

201luahaiRoadJiwanDistric^Guang4ou唯品合

TelI■吟2a22330000

FaxI?86^20^22330111

獲取雎品會類目佶

息

新建/更新尺碼表

3.2品牌接口服務(wù)

3.2.1主要實現(xiàn)功能

用戶可通過品牌名稱或ID獲取對應(yīng)品牌信息

廣州市荔灣區(qū)花海街2（阿

201luahaiRoadJiwanDistrictyGuang4ou唯品合

■吟2a22330000

?86^20^22330111

3.2.2應(yīng)用場景示例

示例1:某供應(yīng)商希望通過V0P接口錄入旗下某品牌商品資料，由于錄入時需要輸入其品牌在V1P上對

應(yīng)品牌ID。該供應(yīng)商可通過V0P接口根據(jù)關(guān)鍵字及關(guān)提字類型（中文、英文），快速獲取其品牌在VIP

上對應(yīng)品牌ID。

示例2:某渠道合作伙伴，在獲取檔期信息后，希望進一步獲取檔期內(nèi)對應(yīng)品牌信息以供其用戶參考。

該合作商可通過品牌ID獲取對應(yīng)品牌描述、圖標(biāo)、鏈接等信息用于展示。

3.2.3實現(xiàn)接口

編號方法名簡述

1getBrandlnfo通過品牌id獲取品牌信息

2multiGetBrand查詢品牌信息

3.2.4常見額問題及解答

Q:品牌信息包括哪些？

A:品牌id、品牌中文名、品牌英文名。在唯品會品牌庫中的品牌名，只允許錄入供應(yīng)商經(jīng)過國家有關(guān)

部門認(rèn)證的注冊品牌名（不管中英文），所以會出現(xiàn)有部分品牌在供應(yīng)商系統(tǒng)中是中文名（非官方注

毋），而在唯品會品牌庫里是英文名（官方注冊）的情況。所以供應(yīng)商或EV系統(tǒng)進行對接時獲取品牌

信息并展示時，建議將中英品牌名稱都展現(xiàn)出來，防止部分無中文名品牌展現(xiàn)為空的情況出現(xiàn)。

3.3類目接口服務(wù)

3.3.1主要實現(xiàn)功能

用戶可通過類目名稱，ID等信息獲取對應(yīng)唯品會商品分類信息及其屬性。

廣州市霆灣區(qū)花海街，（厝

201luahaiRoadJiwanDistrictyGuang4ou唯品合

TelI■吟2a22330000

FaxI?86^20^22330111

1級分類鞋

<<包含>>

2級分類女鞋男鞋

<V包含>>

3級分類男式靴子男式商務(wù)鞋

?包含》

分類屬性款式鞋底材料里材質(zhì)

分類屬性值橡膠底牛津底

3.3.2應(yīng)用場景示例

示例1:某供應(yīng)商希望通過V0P接口錄入鞋類商品資料，其中需要輸入該商品類目，及該類目對應(yīng)必填

必填屬性值（內(nèi)里，鞋底）。該供應(yīng)商可通過V0P接口模糊查詢對應(yīng)類目ID,在通過分類ID獲取該類

目對應(yīng)屬性，及屬性值已完成商品錄入工作。

示例2:某渠道合作伙伴，希望在其推廣平臺上展示目前唯品會所售商品類目信息。該合作商可通過分

類ID直接獲取指定分類下字節(jié)點信息（子分類）

3.3.3實現(xiàn)接口

編號方法名簡述

1qetCategoryAttributeListByld根據(jù)分類ID獲取類目節(jié)點屬性及屬性項列表

2qetCateqorvByld根據(jù)分類ID獲取類目信息

廣州市荔灣區(qū)花海街久瑪

201luahaiRoadJiwanDistric^Guang4ou唯品合

Td1,哈2a22330000

1Fax118^20^22330111

3qetCateqoryListByName通過分類名稱的模糊查詢獲取匹配類目信息

4getCategoryTreeByld根據(jù)分類ID獲取指定類目節(jié)點下的類目及子節(jié)點信息

5getUpdatedCategoryList獲取變更節(jié)點集合

供應(yīng)商上傳類目信息接口，供應(yīng)商可以上傳自定義的

類目和屬性信息到唯品會開放平臺，并做自定義和唯

品會標(biāo)準(zhǔn)的類目&屬性匹配，該匹配關(guān)系保存在唯品會

6uploadVendorCategory開放平臺。

用處：供應(yīng)商新建商品時，可以傳入自定義的類目和

屬性，唯品會開放平臺會根據(jù)匹配關(guān)系，自動轉(zhuǎn)換成

唯品會標(biāo)準(zhǔn)類目&屬性。

3.3.4常見問題及解答

Q：錄入商品資料時，如我方系統(tǒng)中某類目屬性值與唯品會屬性值不一致，如何處理？

A:VIP所錄入類目及其屬性參考市面商品類目標(biāo)準(zhǔn)，以便適配絕大多數(shù)商品。如遇特殊類目或?qū)傩约皩?/p>

性值不在VIP現(xiàn)有類目系統(tǒng)中，首先可考慮是否現(xiàn)有可替代類目、屬性及其屬性值。如無法滿足要求，

可向VOP提出添加需求。VIP會根據(jù)客戶需求，新建所需類目、屬性及其屬性值。

Q：在商品接口中，需要輸入唯品會類目ID，但是唯品會類目與供應(yīng)商類目不匹配，如何處理？

A:首先通過uploadVendorCategory接口上傳供應(yīng)商自己的類目信息，并登陸做供應(yīng)商

和唯品會之間的類目匹配。其次通過唯品會商品接口上傳商品資料即可。

3.4尺碼表接口服務(wù)

3.4.1主要實現(xiàn)功能

用戶可通過調(diào)用接口輸入商品尺碼表信息，并完成與對應(yīng)商品的綁定

3.4.2應(yīng)用場景示例

示例1:非標(biāo)尺碼表：某供應(yīng)商,希望在其商品資料信息上添加該商品的自定義尺碼表。該供應(yīng)商通過

調(diào)用接口新建自定義尺碼表（HTML格式）并完成與對應(yīng)商品的綁定最終實現(xiàn)下述效果。

廣州市荔灣區(qū)花海街2（阿

201luahaiRoadJiwanDistric^Guang4ou唯品合

TelI■吟2a22330000

FaxI?86^20^22330111-??n?W?KR?

TIPS:

1.選購時，請綜合參考尺碼表中告項參數(shù)，有助于你選擇到更合適的尺碼.

2.（只適用服裝）平鋪測量自己的合身服裝尺寸作參考，對比選購更準(zhǔn)確!

★請放，附噂尺碼，唯品7天退貨無憂替你保駕護航.

尺碼對照表：

尺碼363840424446

號型155/80A160/84A165/88A165/92A170/96A175/10CA

溫馨提示:A3R示F體型；模特的身高175,三圍:82-57-87,試分碼數(shù)3865,以上數(shù)據(jù)僅供參考，請您按照自身實際情

況選擇合適的尺碼.

示例2:標(biāo)準(zhǔn)尺碼表：某供應(yīng)商，希望在其商品資料信息上添加該商品的標(biāo)準(zhǔn)尺碼表。該供應(yīng)商通過調(diào)

用接口新建標(biāo)準(zhǔn)尺碼表和尺碼表明細(xì)信息，并完成與對應(yīng)商品和SKU的綁定最終實現(xiàn)下述效果。

。商品尺碼SIZE

TIPS:

1.選購時，清綜合參考尺碼表中各項參數(shù)，有助于你選擇到更合適的尺碼.

2.（只適用服裝）平鋪測量自己的合身服裝尺寸作參考，對比選購更準(zhǔn)確！

3.請放心糾蚣尺碼,唯SS7天退貨無憂昔你保駕護骯.

尺碼對照表:

尺碼胸圍衣長袖長

S944864

M985065

L1045266

XL1065467

示例3:獲取尺碼表字段模板：唯品會對于尺碼表格式有嚴(yán)格的要求，而且不同品類的尺碼表字段也不

相同。為了減少對于尺碼表樣式的溝通成本，供應(yīng)商可以通過接口獲取不同商品品類/尺碼表類的尺碼表

字段模板。

可以根據(jù)商品類目杳詢尺碼表字段模板：

尺碼號型后寬胸圍衣長袖長

廣州市荔灣區(qū)花海街2（阿

201luahaiRoadJiwanDistrictyGuang4ou唯品合

TelI■吟2a22330000

FaxI?86^20^22330111

也可以根據(jù)尺碼表類（成人鞋、鞋等）查詢尺碼表字段模板：

尺碼表類：成人輾，

雅科中國理跤冽碼美國科中長

示例4:尺碼表模板用法：某供應(yīng)商獲取了尺碼表字段模板，調(diào)用尺碼表模板接口，創(chuàng)建對應(yīng)的尺碼表

模板，新建商品時，綁定該尺碼表模板和商品（V0P會根據(jù)尺碼表模板復(fù)制一份尺碼表并和商品綁定），

顯示的效果如示例1和示例2。

注：供應(yīng)商可以根據(jù)實際需要選提直接創(chuàng)建尺碼表綁定商品或創(chuàng)建尺碼表模板綁定商品.

3.4.3實現(xiàn)接口

驪甘功能點方法名簡述

1尺碼表addSizeDetail新增尺碼表詳情

2