這類動態饋給只能用來導入店面動態饋給合作夥伴計畫。
商品目錄動態饋給為指定零售商 (透過 target_customer_id
識別) 提供清單,當中列出了各家門市 (透過 store_code
識別) 販售的所有產品 (透過 id
識別)。建議你至少每天更新一次商品目錄動態饋給。
每次上傳商品目錄動態饋給之後,產品資訊都會以疊加的方式更新。你只需要填入上次更新後供應情形或價格發生變動的產品即可。
注意:如要加入本地動態饋給合作夥伴計畫,您必須上傳庫存清單動態饋給或銷售動態饋給。您也可以同時上傳這兩種動態饋給並搭配使用。
必填欄位 | 說明 | 類型 | 範例 |
target_customer_id [目標客戶 ID] |
這間零售商的商家 ID。 | 整數 | 112339909 |
store_code [商店代碼] |
專屬的商家 ID。這個值須區分大小寫。 請使用零售商商家檔案中列出的商家代碼,或是銷售點/商品目錄資料供應商的內部 ID。 注意:如果使用的是內部商家代碼,請在商店動態饋給中提供商店地址對應關係。 |
字串 | ‘465278’ |
id [ID] |
產品的專屬 ID。建議使用產品 SKU。 注意事項:如果零售商販售同款的全新產品和二手產品,則兩者的 ID 不得相同。 |
字串 <= 50 個字元 |
‘1029384’ |
gtin [全球交易品項識別碼] |
產品的全球交易品項識別碼。 |
字串 | ‘885787364684’ |
availability [供應情形] |
指明商品目錄狀態 (產品是否供應以及如何供應)。 注意:如未提供供應情形,系統會改為使用數量。 |
列舉:
|
In_stock |
price [價格] |
以當地幣別計算的產品價格。 | 字串 | ‘28.00 USD’ |
timestamp [時間戳記] |
在特定時區中記錄商品目錄資料的時間戳記,以 ISO 8601 標準的定義為準。 格式:yyyy-mm-ddThh:mm:ss + 時區 |
字串 | ‘2016-05-09T14:08:45+00:00’ |
選填欄位 | 說明 | 類型 | 範例 |
quantity [數量] |
商品目錄中的產品數量。 | 整數 >= 0 |
5 |
Pickup SLA [取貨服務水準協議] |
訂單預定可供取貨的日期 (相對於訂單成立時間)。 | 文字 (字串),系統只接受以下 8 個值:「same day」、「next day」、「2-day」、「3-day」、「4-day」、「5-day」、「6-day」或「multi-week」 | same day |
Pickup method [取貨方式] |
商品的取貨選項。 注意:自 2024 年 9 月 1 日起,不用提交取貨方式也能啟用取貨服務。 |
文字 (字串),系統只接受以下 4 個值: 「buy」、「reserve」、「ship to store」或「not supported」 |
buy |
注意:如果提交數量和供應情形,系統會採用最保守的值。範例:如果數量為「0」但供應情形為「有現貨」,系統會將供應情形變更為「缺貨中」。