商品資訊修改

邏輯與規則

全量下載：

透過taobao.items.onsale.get（取得店舖出售中商品資訊）和taobao.items.inventory.get（取得店鋪倉庫中商品資訊）可取得店鋪中所有商品，#API 支援根據賣家暱稱、類別目、關鍵字等欄位來搜尋商品。

針對商品的下載：

對於已有統一管理商品資料（例如條碼）的賣家，可以透過商家編碼（供賣家自訂輸入的編碼）與淘寶商品/sku做對應關係。

如下圖：

對於有sku的商品，透過taobao.skus.custom.get（根據sku的商家編碼取商品sku）取得sku；無sku的商品，透過taobao .items.custom.get（根據商家編碼取商品）取得商品。

#更新數量：

當商品包含sku時，更新商品總量無效，總是等於各sku數量之和。

由於架上商品不能為0，要將無sku的商品數量或有sku商品的最後一個sku數量更新為0時，需要對商品先進行下架操作，可以透過taobao.item.update.delisting（商品下架）

更新價格：

搭配sku的商品，有一招和sku價格兩個價格，如下圖紅框標示：

基本規則：商品一口價必須介於有效sku的價格區間內。

有效sku：數量大於0的稱為有效sku.

以taobao .item.sku.update的呼叫為例：

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

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

#有效sku>=2時，商品價格介於有效sku之間，除必填參數外，還需傳入的參數為：price(sku價格), item_price(商品價格)，否則將會回傳「價格不在區間內的異常」

#新增銷售屬性：

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

當首次入庫時只有三個sku ：a,b,c，如果透過淘寶頁面發布商品，則係統會自動保存四個sku填充矩陣，如：d 數量預設為0，價格等於商品價格。

但是在本地系統中，可能只保存了a、b、c三個sku，再次入庫d時，會判斷為新入庫而執行sku新增的動作，這樣API將會傳回錯誤，重複加入sku屬性

#就這樣對這個情況，暫時給出三種解決方案

#方案一：

##############方案一：########

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

使用API發佈或修改商品不會有上述問題，但淘寶頁面編輯商品後，仍會填入矩陣。

新增sku前先比較淘寶上商品的sku數據，若有此sku則修改，不存在則新增。

##增量更新：

方案一：

使用訊息服務的方式，由淘寶主動推送商品庫存、價格等變更訊息，應用程式接收到訊息後，調用api做庫存或價格等更新

方案二：

####### 每條商品資訊有一個修改時間字段modified，透過接口taobao.items.onsale.get和taobao.items.inventory.get指定時間段（start_modified，end_modified），可以取得此時間段內有資訊變更的商品清單############## ##### ##################使用情境：################## 當在淘寶舖編輯商品資訊之後，以此方法取得被修改的商品訊息，同步到本地，保持商品資料的一致，類似增量API的功能。正常的商品交易過程導致的商品數量變化也會更新此修改時間。 ##########

FAQ

關於此文件暫時還沒有FAQ

API名稱	描述
taobao.items.onsale.get	#取得目前會話使用者出售中的商品清單
taobao.items.inventory.get	##得到目前會話使用者庫存中的商品清單
#taobao.items.custom.get	根據商家編碼取商品
taobao.skus.custom.get	#根據sku的商家編碼取商品sku
#taobao.increment.items.get	##取得商品變更通知資訊
#taobao.item.update	更新商品資訊
taobao.item.sku.update	#更新SKU資訊
taobao.item.update.delisting	商品下架
taobao.item.update.listing