相關(guān)API

邏輯與規(guī)則

全量下載：

通過taobao.items.onsale.get（獲取店鋪出售中商品信息）和 taobao.items.inventory.get（獲取店鋪倉庫中商品信息）可獲取店鋪中所有商品，API 支持根據(jù)賣家昵稱、類目、關(guān)鍵字等字段來搜索商品。

針對商品的下載：

對于已有統(tǒng)一管理商品數(shù)據(jù)（例如條形碼）的賣家，可以通過商家編碼（供賣家自定義輸入的編碼）與淘寶商品/sku做對應(yīng)關(guān)系。

如下圖：

對于有sku的商品，通過taobao.skus.custom.get（根據(jù)sku的商家編碼取商品sku）獲取sku；無sku的商品，通過taobao.items.custom.get（根據(jù)商家編碼取商品）獲取商品。

更新數(shù)量：

當(dāng)商品包含sku時，更新商品總量無效，始終等于各sku數(shù)量之和。

由于架上商品不能為0，要將無sku的商品數(shù)量或者有sku商品的最后一個sku數(shù)量更新為0時，需要對商品先進(jìn)行下架操作，可以通過taobao.item.update.delisting（商品下架）

更新價格：

帶sku的商品，有一口價和sku價格兩個價格，如下圖紅框標(biāo)識：

基本規(guī)則：商品一口價必須介于有效sku的價格區(qū)間內(nèi)。

有效sku：數(shù)量大于0的稱為有效sku.

以taobao.item.sku.update的調(diào)用為例：

有效sku = 0時，更新sku的價格不受限制，除必填參數(shù)外，還需傳入的參數(shù)為：price(sku價格)

有效sku = 1時，商品價格必須等于sku價格，這種情況，淘寶系統(tǒng)會自動更新商品價格，除必填參數(shù)外，還需傳入的參數(shù)為：price(sku價格)

有效sku>=2時，商品價格介于有效sku之間，除必填參數(shù)外，還需傳入的參數(shù)為：price(sku價格), item_price(商品價格)，否則將會返回“價格不在區(qū)間內(nèi)的異常”

新增銷售屬性：

在淘寶頁面發(fā)布或者編輯商品時，會根據(jù)商品的銷售屬性自動組合出完整的sku,如圖：

當(dāng)首次入庫時只有三個sku ：a,b,c，如果通過淘寶頁面發(fā)布商品， 則系統(tǒng)會自動保存四個sku填充矩陣，如：d  數(shù)量默認(rèn)為0，價格等于商品價格。

但是在本地系統(tǒng)中，可能只保存了a、b、c三個sku，再次入庫d時，會判斷為新入庫而執(zhí)行sku新增的操作，這樣API將返回錯誤，重復(fù)添加sku屬性

針對這種情況，暫給出三種解決方案

方案一：

       采用與淘寶相同的邏輯，在入庫時只要有存在的銷售屬性自動完成矩陣。

方案二：

       使用API發(fā)布或者修改商品不會出現(xiàn)上述問題，但是在淘寶頁面編輯商品后，依然會填充矩陣。

方案三：

       新增sku前先對比淘寶上商品的sku數(shù)據(jù)，如果存在此sku則修改，不存在則添加。

增量更新：

方案一：

       使用 消息服務(wù) 的方式，由淘寶主動推送商品庫存、價格等變更消息，應(yīng)用程序接收到消息后，調(diào)用api做庫存或價格等更新

方案二：

       每條商品信息有一個修改時間字段modified，通過接口taobao.items.onsale.get和taobao.items.inventory.get指定時間段（start_modified，end_modified），可以獲取此時間段內(nèi)有信息更改過的商品列表

使用場景：

       當(dāng)在淘寶店鋪編輯商品信息之后，以此方法獲取被修改的商品信息，同步到本地，保持商品數(shù)據(jù)的一致，類似于增量API的功能。正常的商品交易過程導(dǎo)致的商品數(shù)量變化也會更新此修改時間。

FAQ

• 關(guān)于此文檔暫時還沒有FAQ