Proposal

API Resources #

Proposal #

Proposal 提案 #

Column Name Type RW/RO Required [註1]
Note
 For Proposal Type
id Int32 RO 提案編號
  • newProduct
  • newListing
  • newListingByApi
  • updateCopy
  • updateVideo
  • updateImageV2
  • updateListingAttribute
seqNo Int32 RO 申請單號
  • newProduct
  • newListing
  • newListingByApi
  • updateCopy
  • updateVideo
  • updateImageV2
  • updateListingAttribute
supplierId Int32 RO 供應商編號
  • newProduct
  • newListing
  • newListingByApi
  • updateCopy
  • updateVideo
  • updateImageV2
  • updateListingAttribute
supplierName String RO 供應商名稱
  • newProduct
  • newListing
  • newListingByApi
  • updateCopy
  • updateVideo
  • updateImageV2
  • updateListingAttribute
creator String RO 建檔者，將由 Cookie 自動截取
  • newProduct
  • newListing
  • newListingByApi
  • updateCopy
  • updateVideo
  • updateImageV2
  • updateListingAttribute
contactWindow String RO 提案對象，將由指定的 subStationId 自動指定
  • newProduct
  • newListing
  • newListingByApi
  • updateCopy
  • updateVideo
  • updateImageV2
  • updateListingAttribute
type String RW POST: Y
PUT: Y		 提案單類型，定義表
  • newProduct
  • newListing
  • newListingByApi
  • updateCopy
  • updateVideo
  • updateImageV2
  • updateListingAttribute
applicant String RW POST: ?
PUT: ?		 提案人，限 10 個中文字
  • newProduct
  • newListing
  • newListingByApi
  • updateCopy
  • updateVideo
  • updateImageV2
  • updateListingAttribute
subStationId String RW POST: Y
PUT: Y		 提案當下的提案站別 ID, e.g. sub1
只允許供應商有簽約的子站
  • newProduct
  • newListing
  • newListingByApi
subStationName String RO 提案當下的提案站別名稱
  • newProduct
  • newListing
  • newListingByApi
  • updateCopy
  • updateVideo
  • updateImageV2
  • updateListingAttribute
expiredTs String RW POST: N
PUT: N		 審核提案有效期限，預設 +15 天，不得少於提案日+3天，最多可設定提案日+15天
  • newProduct
  • newListing
  • newListingByApi
  • updateCopy
  • updateVideo
  • updateImageV2
  • updateListingAttribute
product ProposalProduct RW POST: ?
PUT: ?		 商品資訊
reviewStatus 非 composing 時必填
  • newProduct
  • newListing
  • newListingByApi
listing ProposalListing RW POST: Y
PUT: Y		 賣場資訊
  • newListing
  • newListingByApi
  • updateCopy
  • updateVideo
  • updateImageV2
  • updateListingAttribute
createdTs String RO 建檔時間
  • newProduct
  • newListing
  • newListingByApi
  • updateCopy
  • updateVideo
  • updateImageV2
  • updateListingAttribute
appliedTs String RO 提案時間
  • newProduct
  • newListing
  • newListingByApi
  • updateCopy
  • updateVideo
  • updateImageV2
  • updateListingAttribute
reviewer String RO 審核者
  • newProduct
  • newListing
  • newListingByApi
  • updateCopy
  • updateVideo
  • updateImageV2
  • updateListingAttribute
reviewStatus String RW POST: N
PUT: N		 審核結果，定義表
Default: composing
  • newProduct
  • newListing
  • newListingByApi
  • updateCopy
  • updateVideo
  • updateImageV2
  • updateListingAttribute
reviewedTs String RO 審核時間
  • newProduct
  • newListing
  • newListingByApi
  • updateCopy
  • updateVideo
  • updateImageV2
  • updateListingAttribute
declineReason String[] RO 審核不通過原因，定義表
  • newProduct
  • newListing
  • newListingByApi
  • updateCopy
  • updateVideo
  • updateImageV2
  • updateListingAttribute
declineDetail String RO 審核不通過其它原因描述
  • newProduct
  • newListing
  • newListingByApi
  • updateCopy
  • updateVideo
  • updateImageV2
  • updateListingAttribute
executeStatus String RO 執行結果，定義表
  • newProduct
  • newListing
  • newListingByApi
  • updateCopy
  • updateVideo
  • updateImageV2
  • updateListingAttribute
executedTs String RO 執行時間
  • newProduct
  • newListing
  • newListingByApi
  • updateCopy
  • updateVideo
  • updateImageV2
  • updateListingAttribute
executeResult String RO 執行失敗原因
  • newProduct
  • newListing
  • newListingByApi
  • updateCopy
  • updateVideo
  • updateImageV2
  • updateListingAttribute
modifiedTimes Int32 RO 更新次數
  • newProduct
  • newListing
  • newListingByApi
  • updateCopy
  • updateVideo
  • updateImageV2
  • updateListingAttribute
modifier String RO 更新者
  • newProduct
  • newListing
  • newListingByApi
  • updateCopy
  • updateVideo
  • updateImageV2
  • updateListingAttribute
modifiedTs String RO 更新時間
  • newProduct
  • newListing
  • newListingByApi
  • updateCopy
  • updateVideo
  • updateImageV2
  • updateListingAttribute
note String RW POST: N
PUT: N		 備註，限 200 個字
  • newProduct
  • newListing
  • newListingByApi
  • updateCopy
  • updateVideo
  • updateImageV2
  • updateListingAttribute
suggestion String RO 改善或建議
  • newProduct
  • newListing
  • newListingByApi
  • updateCopy
  • updateVideo
  • updateImageV2
  • updateListingAttribute
parent ParentProposal RO 母提案單號
若此提案單不為「修改賣場資訊提案單」(UpdateListing) 之子提案，則此欄位為空
  • updateCopy
  • updateVideo
  • updateImageV2
  • updateListingAttribute
batch BatchProposalInfo RW POST: N
PUT: N		 批次提案資訊
若此提案單不為批次提案之細項，則此欄位為空
  • updateImageV2

BatchProposalInfo 批次提案資訊 #

Column name Type RW/RO Required Note
id Int32 RW POST: Y
PUT: Y		 批次提案編號
type String RW POST: Y
PUT: Y		 批次提案類型
Options:
  • execute
  • revert

ParentProposal 母提案資訊 #

Column name Type RW/RO Required Note
id Int32 RO 母提案單號
type String RO 母提案單類型，定義表

ProposalProduct 提案商品資訊 #

Column Name Type RW/RO Required [註1] Note
id Int32 RO Product ID
name String RW POST: Y
PUT: Y		 商品名稱，不允許大小於符號和換行長度總計: {name}-{models[].displayName}-{models[].items[].displayName}
  • 新增一般賣場 (newListing): 不可超過 100 個字
  • 新增贈品/配件/屬性 (newProduct): 不可超過 50 個字

若 shipType.id = 61 (快速到貨) 且為即期品，必須加上前綴(即期品)
shortDescription String[] RW POST: Y
PUT: Y		 賣場簡短說明
最多 5 條，每條最長 15 個字，不允許大小於符號和換行
至少需填 1 條
shareMediaBetweenModels Boolean RW POST: N
PUT: N		 是否共用同一組商品圖/影片
只有 1 層屬性時可為 true
若為 true ，則 models 只有第一個 model 可以有圖/影片 (models[0].images / models[0].videos)
Default: false
models ProposalModel[] RW POST: Y
PUT: Y		 商品型號(屬性)
brand String RW POST: N
PUT: N		 ESD 專用品牌，最長 20 個字，不允許大小於符號和換行
brandId String RW POST: Y
PUT: Y		 品牌 ID
brandName String RO 品牌名稱
model String RW POST: N
PUT: N		 商品型號，最長 40 個字，不允許大小於符號和換行
shipType ShipType RW POST: Y
PUT: Y		 配送方式，可選擇規則
contentRating String RW POST: Y
PUT: Y		 內容級別，可選擇級別
若 subStationId=sub28 (電玩 / 遊戲)，只允許 G, PG, PG12, PG15 and R
若 subStationId=sub566，只允許 R and NC18
其他子站不能選 PG15
zoneId String RO 商品目前的分類區 ID, e.g. z1
若因分類變動導致無法以 catItemId 導回，則分類路徑 (區到子類) 資訊將不再回傳
zoneName String RO 商品目前的分類區名
若因分類變動導致無法以 catItemId 導回，則分類路徑 (區到子類) 資訊將不再回傳
subStationId String RO 商品目前的分類子站 ID, e.g. sub1
若因分類變動導致無法以 catItemId 導回，則分類路徑 (區到子類) 資訊將不再回傳
subStationName String RO 商品目前的分類子站名
若因分類變動導致無法以 catItemId 導回，則分類路徑 (區到子類) 資訊將不再回傳
catId String RO 商品目前的分類父類 ID, e.g. cat1610
若因分類變動導致無法以 catItemId 導回，則分類路徑 (區到子類) 資訊將不再回傳
catName String RO 商品目前的分類父類名
若因分類變動導致無法以 catItemId 導回，則分類路徑 (區到子類) 資訊將不再回傳
catItemId String RW POST: Y
PUT: Y		 商品目前的分類子類 ID, e.g. catItem21704
對應到的子站要跟供應商有簽約的子站有交集
如果是 PM 登入，還要跟 PM 的負責子站有交集
若因分類變動導致無法以 catItemId 導回，則分類路徑 (區到子類) 資訊將不再回傳
catItemName String RO 商品目前的分類子類名
若因分類變動導致無法以 catItemId 導回，則分類路徑 (區到子類) 資訊將不再回傳
msrp String RW POST: Y
PUT: Y		 廠商建議價 (manufacturer’s suggested retail price)，到小數點兩位
Range: [0-9999999]
成本(含稅+運費) <= 購物中心售價 <= 廠商建議價
cost String RW POST: Y
PUT: Y		 成本(含稅+運費)，到小數點兩位
Range: [0-9999999]
成本(含稅+運費) <= 購物中心售價 <= 廠商建議價
safeStockQty Int32 RW POST: N
PUT: N		 安全庫存量
Range: [1-99]
若 Proposal.type = newProduct (新增屬性商品) 且 shipType.Id = 61 (快速到貨)，則只能為 1
Default: 1
length Int32 RW POST: ?
PUT: ?		 包裝完成後的商品長度，單位為 cm，需為正整數
若為下列配送方式 (shipType.id) 則為必填
  • 61: 快速到貨
  • 800: 直店配
限制
  • 若配送方式 (shipType.id) 為 800 (直店配) 則無限制
  • 若有簽屬「家電增補附約」且勾選「需安裝」(isInstallRequired = true)或有勾選「廢四機」(isNeedRecycle = ture)
    • 長度限制為 200cm
    • 長寬高三邊總合限制為 500cm
  • 否則
    • 長度限制為 150cm
      長寬高三邊總合限制為 270cm
width Int32 RW POST: ?
PUT: ?		 包裝完成後的商品寬度，單位為 cm，需為正整數
若為下列配送方式 (shipType.id) 則為必填
  • 61: 快速到貨
  • 800: 直店配
限制
  • 若配送方式 (shipType.id) 為 800 (直店配) 則無限制
  • 若有簽屬「家電增補附約」且勾選「需安裝」(isInstallRequired = true)或有勾選「廢四機」(isNeedRecycle = ture)
    • 寬度限制為 200cm
    • 長寬高三邊總合限制為 500cm
  • 否則
    • 寬度限制為 150cm
      長寬高三邊總合限制為 270cm
height Int32 RW POST: ?
PUT: ?		 包裝完成後的商品高度，單位為 cm，需為正整數
若為下列配送方式 (shipType.id) 則為必填
  • 61: 快速到貨
  • 800: 直店配
限制
  • 若配送方式 (shipType.id) 為 800 (直店配) 則無限制
  • 若有簽屬「家電增補附約」且勾選「需安裝」(isInstallRequired = true)或有勾選「廢四機」(isNeedRecycle = ture)
    • 高度限制為 220cm
    • 長寬高三邊總合限制為 500cm
  • 否則
    • 高度限制為 150cm
      長寬高三邊總合限制為 270cm
weight Int32 RW POST: ?
PUT: ?		 包裝完成後的商品重量，單位為 g，需為正整數
若為下列配送方式 (shipType.id) 則為必填
  • 61: 快速到貨
  • 800: 直店配
限制
  • 若配送方式 (shipType.id) 為 800 (直店配) 則無限制
  • 若有簽屬「家電增補附約」且勾選「需安裝」(isInstallRequired = true)或有勾選「廢四機」(isNeedRecycle = ture)才可大於 30,000g
Max: 2147483647
isInstallRequired Boolean RW POST: N
PUT: N		 是否需要安裝
shipType.id = 61 (快速到貨) 且有簽屬「家電增補附約」時可填
Default: false
isLargeVolumnProductGift Boolean RW POST: N
PUT: N		 是否為大型商品附屬贈品
shipType.id = 61 (快速到貨) 且有簽屬「家電增補附約」時可填
Default: false
isNeedRecycle Boolean RW POST: N
PUT: N		 是否屬於廢四機
限制Default: false
preserveDays Int32 RW POST: N
PUT: N		 商品保存期限，單位為天
Range: [1-32767]
若為以下配送方式則可填，否則應為 null
  • (shipType.id=61) 快速到貨
  • (shipType.id=200 且 shipType.model=150) 電子票卷
isOutrightPurchase Boolean RW POST: N
PUT: N		 是否為買斷商品
shipType.id = 61 (快速到貨) 有簽屬「買斷附約」時可填
Default: false
isExpiringItem Boolean RW POST: N
PUT: N		 是否為即期品
Default: false
shipType.id = 61 (快速到貨) 且 preserveDays != null (有效期商品) 時才能為 true
minPackingCount Int32 RW POST: N
PUT: N		 最小包裝數
Range: [1-32767]
shipType.id = 61 (快速到貨) 時才能更改，其餘只能為 1
Default: 1
copy String RW POST: Y
PUT: Y		 商品詳情 (文案)，HTML content
See rules
warranty ProductWarranty RW POST: N
PUT: N		 商品保證
Default: {“period”: “無保固”, “scope”: “無保固”, “handler”: “none”}
specs ProposalProductSpec[] RO 商品屬性
attributeDisplayMode String RW POST: N
PUT: N		 商品規格顯示方式
  • table
  • list
Default: table
struDataAttrClusterId String RW POST: Y
PUT: Y		 Structured data attribute cluster ID
結構化資料屬性集 ID
struDataAttrClusterName String RO Structured data attribute cluster name
結構化資料屬性集名稱
attributes Attribute[] RW POST: ?
PUT: ?		 商品規格表
在 ProposalModel 中被選中的 Attribute，不可再填入此欄位
其餘 structured data attribute cluster 定義的必填欄位則必須提供
若規格為 structured data 中的選項
  • values 需符合 structured data constraint 限制 (radiobox/checkbox)
  • 只能有一個 自訂其他屬性
若規格為 自訂
  • values 只能有一個值
  • 不允許重複 自訂規格 名稱
  • 自訂規格 名稱不允許與 structured data 中的選項重複
  • 自訂規格 名稱不允許與 自訂屬性 名稱重複
gameContents String[] RW POST: N
PUT: N		 遊戲情節內容
Options:
  • 性
  • 暴力
  • 恐怖
  • 菸酒
  • 毒品
  • 不當言語
  • 反社會性
  • 棋牌益知及娛樂
  • 促使使用者虛擬戀愛或結婚
當 subStationId=sub28 時可填
partNo String RW POST: N
PUT: N		 主件商品供應商商品料號，最長 50 個字
不允許換行和 tab
taxable Boolean RW POST: N
PUT: N		 商品是否應稅，當提案子站為書籍 (subStationId=sub43) 時才可以選擇免稅
Default: true
eVoucherAttributes VoucherAttribute[] RW POST: ?
PUT: ?		 電子票券資訊
若配送方式為 電子票券 則此欄位必填
eVoucherType String RW POST: ?
PUT: ?		 電子票券類型，可選擇類型
若配送方式為 電子票券 則此欄位必填

ProposalModel #

Column Name Type RW/RO Required [註1] Note For Proposal Type
sku Int32 RW POST: ?
PUT: ?		 型號 ID
用於指定賣場規格/贈品/加價購商品編號
當使用 updateVideo/updateImageV2/updateListing 時為必填
  • updateVideo
  • updateImageV2
  • updateListingModel
spec Attribute RW POST: ?
PUT: ?		 第 1 層屬性的 spec
第 0 個 model 的 spec name 將用於表示 level 1 product spec
若為無屬性商品時為空, 有 1 層及以上屬性時必填

若 spec name 是從 structured data 中挑選，且 constraint type 為 radiobox 或 checkbox 時
  • values 一定要包含在 constraint 選項中
  • 若為自訂時，values 需填入其他，自訂內容存放於 displayName
若 spec name 為自訂或 constraint type 為 text 時
  • values 需填入其他，自訂內容存放於 displayName
  • newProduct
  • newListing
  • newListingByApi
  • updateListingModel
  • updateListing
items ProposalItem[] RW POST: ?
PUT: ?		 屬性內容，shipType.id != 61 (快速到貨) 時必填
  • newProduct
  • newListing
  • newListingByApi
  • updateListingModel
  • updateListing
videos ProductVideo[] RW POST: N
PUT: N		 商品影片
  • newProduct
  • newListing
  • newListingByApi
  • updateVideo
  • updateListing
images ProductImage[] RW POST: ?
PUT: ?		 商品圖
當使用 newListing/newProduct/updateListingModel新增商品 時為必填
  • newListing/newProduct/updateListingModel
    • 最多 10 張，需要為正方形，尺寸大於 1000^2 pixels 會被縮至 1000^2, 400^2, 250^2, 135^2 及 80^2 pixels、大於 400^2 pixels 會被縮至 400^2, 250^2, 135^2 及 80^2 pixels
    • 至少需要兩張主圖 (1000^2 pixels)，可增加 8 張副圖 (1000^2 or 400^2 pixels)
  • updateImageV2
    • order = 1 時，可於各尺寸指定小圖 URL，未指定寬高的維度會由 1000x1000 圖檔自動縮圖
當使用 updateListingModel新增商品 時，修改對象為單層屬性賣場時才可提供
  • newProduct
  • newListing
  • newListingByApi
  • updateImageV2
  • updateListing
  • updateListingModel
displayName String RW POST: N
PUT: N		 賣場顯示名稱，不允許大小於符號和換行，預設為 spec.values[0]
若為無屬性商品時為空, 有 1 層及以上屬性時可填
  • newProduct
  • newListing
  • newListingByApi
isVisible Boolean RW POST: N
PUT: N		 屬性是否顯示於前台賣場
Default: true
  • updateListingModel
name String RW POST: ?
PUT: ?		 屬性商品名稱
修改對象為單層屬性賣場時才可提供
  • updateListingModel
  • updateListing
partNo String RW POST: N
PUT: N		 屬性商品料號，最長 50 個字
不允許換行和 tab
修改對象為單層屬性賣場時才可提供
  • updateListing
  • updateListingModel
barcode String RW POST: N
PUT: N		 實際國際條碼，限定為 12-14 碼
若為下列配送方式時則可填寫
  • 1: 宅配
  • 61: 快速到貨
  • 800: 直店配
修改對象為單層屬性賣場時才可提供
  • updateListingModel
stock Int32 RW POST: N
PUT: N		 備貨數量
Default: 0
Range:
  • 成本 >= 5萬: 0-15
  • 成本 >= 3萬: 0-50
  • 成本 >= 1萬: 0-100
  • 成本 >= 5千: 0-300
  • 成本 >= 3千: 0-500
  • 成本 >= 0: 0-1000
修改對象為單層屬性賣場時才可提供
  • updateListingModel
attributes Attribute[] RW POST: ?
PUT: ?		 商品規格表，內容包含和屬性名稱相同之規格
修改對象為單層屬性賣場時才可提供
  • updateListingModel
price String RW POST: ?
PUT: ?		 商品售價
當使用 updateListingModel調整加價購商品 時為必填
  • updateListingModel
shortTitle String RW POST: ?
PUT: ?		 商品短標題
當使用 updateListingModel調整贈品商品 時為必填
  • updateListingModel

ProposalItem #

Column Name Type RW/RO Required [註1] Note For Proposal Type
id Int32 RO Item ID
  • newProduct
  • newListing
sku Int32 RW POST: ?
PUT: ?		 Item ID
當使用 newListing/newProduct 時不須填寫
當使用 updateListing 時為必填
  • newProduct
  • newListing
  • updateListing
  • updateListingModel
stock Int32 RW POST: N
PUT: N		 備貨數量
若 配送方式 為 61，則只能為 0
Default: 0
Range:
  • 成本 >= 5萬: 0-15
  • 成本 >= 3萬: 0-50
  • 成本 >= 1萬: 0-100
  • 成本 >= 5千: 0-300
  • 成本 >= 3千: 0-500
  • 成本 >= 0: 0-1000
當使用 updateListingModel新增商品 時，修改對象為雙層屬性賣場時才可提供
  • newProduct
  • newListing
  • updateListingModel
partNo String RW POST: N
PUT: N		 屬性商品供應商商品料號，最長 50 個字
不允許換行和 tab
當使用 updateListing/updateListingModel新增商品 時，修改對象為雙層屬性賣場時才可提供
  • newProduct
  • newListing
  • updateListing
  • updateListingModel
barcode String RW POST: N
PUT: N		 實際國際條碼，限定為 12-14 碼
若為下列 配送方式 時則可填寫
  • 1: 宅配
  • 61: 快速到貨
  • 800: 直店配
當使用 updateListingModel新增商品 時，修改對象為雙層屬性賣場時才可提供
  • newProduct
  • newListing
  • updateListingModel
warehouseBarcode String RW POST: N
PUT: N		 進倉用國際條碼，限定為 12-14 碼
配送方式 為 61 時可填，未填寫則由系統自動產生
  • newProduct
  • newListing
spec Attribute RW POST: ?
PUT: ?		 第 2 層屬性的 spec
第 0 個 item 的 spec name 將用於表示 level 2 product spec
若為無屬性與 1 層屬性商品時為空，為 2 層屬性商品時為必填，且各個 model 間的 item spec name 必須一致

若 spec name 是從 structured data 中挑選，且 constraint type 為 radiobox 或 checkbox 時
  • values 一定要包含在 constraint 選項中
  • 若為自訂時，values 需填入 其他，自訂內容存放於 displayName
若 spec name 為自訂或 constraint type 為 text 時
  • values 需填入 其他，自訂內容存放於 displayName
  • newProduct
  • newListing
  • updateListing
displayName String RW POST: N
PUT: N		 賣場顯示名稱，不允許大小於符號和換行，預設為 spec.values[0]
若為無屬性與 1 層屬性商品時為空，為 2 層屬性商品時可填，且各個 model 間的 item display name 必須一致
  • newProduct
  • newListing
warehouseProductName String RW POST: N
PUT: N		 進倉用商品名稱
配送方式為快速到貨且預設值超過 50 個字才可填寫，最長 50 個字
Default: {product.name}-{models[].displayName}-{models[].items[].displayName}
  • newProduct
  • newListing
isVisible Boolean RW POST: N
PUT: N		 屬性是否顯示於前台賣場
Default: true
  • updateListingModel
name String RW POST: ?
PUT: ?		 屬性商品名稱
修改對象為雙層屬性賣場時才可提供
  • updateListingModel
  • updateListing
images ProductImage[] RW POST: ?
PUT: ?		 商品圖
當使用 updateListingModel新增商品 時為必填
修改對象為雙層屬性賣場時才可提供
  • updateListingModel
    • 最多 10 張，需要為正方形，尺寸大於 1000^2 pixels 會被縮至 1000^2, 400^2, 250^2, 135^2 及 80^2 pixels、大於 400^2 pixels 會被縮至 400^2, 250^2, 135^2 及 80^2 pixels
    • 至少需要兩張主圖 (1000^2 pixels)，可增加 8 張副圖 (1000^2 or 400^2 pixels)
  • updateListingModel
attributes Attribute[] RW POST: ?
PUT: ?		 商品規格表，內容包含和屬性名稱相同之規格
修改對象為雙層屬性賣場時才可提供
  • updateListingModel
shortTitle String RW POST: ?
PUT: ?		 商品短標題
當使用 updateListingModel調整贈品商品 時為必填
  • updateListingModel

ProposalProductSpec 商品屬性 #

Column Name Type RW/RO Required Note
level Int32 RO 屬性層級: [1-2]
name String RO 屬性名稱
  • Level 1 名稱為 proposal.product.models[0].spec.name
  • Level 2 名稱為 proposal.product.models[0].items[0].spec.name

ProposalListing #

Column Name Type RW/RO Required [註1] Note For Proposal Type
id Int32 RW POST: Y
PUT: Y		 賣場 ID
  • updateCopy
  • updateVideo
  • updateImageV2
  • updateListingAttribute
  • updateListingModel
  • updateListing
zoneId String RO 賣場目前的分類區 ID, e.g. z1
若因分類變動導致無法以 catItemId 導回，則分類路徑 (區到子類) 資訊將不再回傳
  • newListing
  • newListingByApi
zoneName String RO 賣場目前的分類區名
若因分類變動導致無法以 catItemId 導回，則分類路徑 (區到子類) 資訊將不再回傳
  • newListing
  • newListingByApi
subStationId String RO 賣場目前的分類子站 ID, e.g. sub1
若因分類變動導致無法以 catItemId 導回，則分類路徑 (區到子類) 資訊將不再回傳
  • newListing
  • newListingByApi
subStationName String RO 賣場目前的分類子站名
若因分類變動導致無法以 catItemId 導回，則分類路徑 (區到子類) 資訊將不再回傳
  • newListing
  • newListingByApi
catId String RO 賣場目前的分類父類 ID, e.g. cat1610
若因分類變動導致無法以 catItemId 導回，則分類路徑 (區到子類) 資訊將不再回傳
  • newListing
  • newListingByApi
catName String RO 賣場目前的分類父類名
若因分類變動導致無法以 catItemId 導回，則分類路徑 (區到子類) 資訊將不再回傳
  • newListing
  • newListingByApi
catItemId String RW POST: ?
PUT: ?		 賣場目前的分類子類 ID, e.g. catItem21704
reviewStatus 為 draft 以上時必填
若因分類變動導致無法以 catItemId 導回，則分類路徑 (區到子類) 資訊將不再回傳
  • newListing
  • newListingByApi
catItemName String RO 賣場目前的分類子類名
若因分類變動導致無法以 catItemId 導回，則分類路徑 (區到子類) 資訊將不再回傳
  • newListing
  • newListingByApi
seoUrl String RW POST: ?
PUT: ?		 賣場網址，最長 50 個字
只接受繁/簡體中文、英文、數字、-，多個 - 會合併成一個，開頭不能是 -
reviewStatus 為 draft 以上時必填
  • newListing
  • newListingByApi
featureTitle String RW POST: ?
PUT: ?		 特色標題，最長 20 個字
只接受繁/簡體中文、英文、數字、日文、注音符號、空格、 , 、ˊ 、 ˇ 和 ˋ
reviewStatus 為 draft 以上時必填
  • newListing
  • newListingByApi
  • updateListing
deliveryType String RW POST: N
PUT: N		 交貨期限
Options:
  • normal: 正常交貨期
  • preOrder: 預購型商品
  • customized: 客製化商品
  • appointment: 客約送貨日
名詞定義
  • 子站功能: proposal.subStationId 對應到的 GET v1/categories 回傳之 category.functions 內容
  • 快速到貨: proposal.product.shpiType.id 為 61
  • 直店配: proposal.product.shpiType.id 為 800
  • 電子票券: proposal.product.shpiType.id 為 200 且 proposal.product.shpiType.model 為 150
  • 是否需要安裝: proposal.product.isInstallRequired
  • 是否屬於廢四機: proposal.product.isNeedRecycle
若配送方式為快速到貨時不可自訂，將依下列規則自動指定
  • 若為需要安裝或是屬於廢四機時，指定為 appointment
  • 否則指定為 normal
若配送方式為 電子票券 時不可自訂，將自動指定為 normal

限制
  • 快速到貨
    • 需安裝: appointment
    • 不需安裝
      • 是廢四機: appointment
      • 非廢四機: normal
  • 電子票券: normal
  • 非快速到貨(不需安裝)
    • 子站功能包含 preOrderDelivery: preOrder, normal
    • 子站功能包含 customizedDelivery: customized, normal
    • 子站功能包含 appointmentDelivery
      • 直店配: normal
      • 非直店配: appointment, normal
    • 子站功能不包含 preOrderDelivery, customizedDelivery, appointmentDelivery: normal
reviewStatus 為 draft 以上時必填
    • newListing
    • newListingByApi
    preOrderExpectedShipDate String RW POST: ?
    PUT: ?    		 預購型商品預定出貨日
    Range:
    reviewStatus 為 draft 以上且 delieryType = preOrder 時必填
    • newListing
    • newListingByApi
    customizedOrderShipDateAfterPlaced Int32 RW POST: ?
    PUT: ?    		 客製化商品完成訂單後出貨天數
    Range: [3-90]
    reviewStatus 為 draft 以上且 delieryType = customized 時必填
    • newListing
    • newListingByApi
    onShelvedTs String RW POST: N
    PUT: N    		 開始時間，預設現在時間，不可大於結束時間
    • newListing
    • newListingByApi
    offShelvedTs String RW POST: N
    PUT: N    		 結束時間，預設為開始時間 + 365 天，不可小於開始時間
    • newListing
    • newListingByApi
    price String RW POST: ?
    PUT: ?    		 購物中心售價，到小數點兩位
    Range: [0-9999999]
    Rules:
    • cost (成本(含稅+運費)) <= price (購物中心售價) <= msrp (廠商建議價)
    • shipType.id = 800 (直店配) 時需 <= 20000
    reviewStatus 為 draft 以上時必填

    若"賣場毛利率 ((購物中心售價 - 成本) / 購物中心售價) < 子站毛利率"時，則
    • 若有自動過審 (供應商啟用功能包含 autoApproveListingOnOffShelve)時，API 會阻擋該 request
    • 若無自動過審，僅檢查賣場毛利率需 >= 0
    • newListing
    • newListingByApi
    purchaseQtyLimit Int32 RW POST: N
    PUT: N    		 限購數量
    Default: 12
    Range: [1-99]
    • newListing
    • newListingByApi
    cvsPurchaseQtyLimit Int32 RW POST: N
    PUT: N    		 超商取貨限購數量
    Range: [1-32767]
    僅 shipType.id = 800 (直店配) 時可更改，其餘只能為 1
    最大值為 20000 / 購物中心售價，取正整數
    Default: 1
    • newListing
    • newListingByApi
    copy String RW POST: ?
    PUT: ?    		 商品詳情 (文案)，HTML content
    當使用 updateCopy 時為必填
    See rules
    • updateCopy
    • updateListing
    swCode String RO 隱藏賣場 SW code
    • newListing
    • newListingByApi
    models ProposalModel[] RW POST: N
    PUT: N    		 屬性商品型號
    修改對象為有屬性賣場時才可提供
    若只修改部分屬性商品，則只需提供有修改的 model
    • updateVideo
    • updateImageV2
    • updateListing
    videos ProductVideo[] RW POST: N
    PUT: N    		 賣場影片
    為無屬性賣場時才可提供
    • updateVideo
    • updateListing
    images ProductImage[] RW POST: N
    PUT: N    		 賣場圖片
    為無屬性賣場時才可提供
    • updateImageV2
    • updateListing
    additionalPurchases ProposalModel[] RW POST: N
    PUT: N    		 加價購內容
    • updateImageV2
    complimentaries ProposalModel[] RW POST: N
    PUT: N    		 買就送贈品內容
    • updateImageV2
    selectComplimentaries ProposalModel[] RW POST: N
    PUT: N    		 任選贈品內容
    • updateImageV2
    shareMediaBetweenModels Boolean RW POST: N
    PUT: N    		 是否共用同一組商品圖/影片
    只有 1 層屬性時可為 true
    若為 true ，則 models 只能有 0 (「不共用」改為「共用」，未變更主商品圖片/影片) 或 1 個 model，且 SKU 需和原賣場第一個 model 相同 (model[0].sku)
    Default: false
    • updateVideo
    • updateImageV2
    • updateListing
    attributeDisplayMode String RW POST: ?
    PUT: ?    		 商品規格顯示方式
    當使用 updateListingAttribute 時為必填
    Options:
    • table
    • list
    • updateListingAttribute
    • updateListing
    struDataAttrClusterId String RW POST: ?
    PUT: ?    		 Structured data attribute cluster ID
    當使用 updateListingAttribute 時為必填
    • updateListingAttribute
    • updateListing
    attributes Attribute[] RW POST: ?
    PUT: ?    		 商品規格表
    當使用 updateListingAttribute 時為必填
    • updateListingAttribute
    • updateListing
    syncProductImages Boolean RW POST: N
    PUT: N    		 是否同時修改無屬性賣場之商品圖片
    Default: true
    • updateImageV2
    • updateListing
    isThresholdFreebie Boolean RW POST: N
    PUT: N    		 是否為滿額贈贈品賣場
    Default: false
    限制
    • 賣場不可設定為雙層屬性賣場
    • 賣場交貨期限不可為客約送貨日
    • 賣場配送方式不可為ESD或電子票券
    • newListing
    • newListingByApi
    warranty ProductWarranty RW POST: N
    PUT: N    		 商品保證
    • updateCopy
    • updateListing
    partNo String RW POST: N
    PUT: N    		 賣場主件供應商商品料號，最長 50 個字
    不允許換行和 tab
    • updateListing
    name String RW POST: Y
    PUT: Y    		 賣場名稱
    • updateListing
    productName String RW POST: N
    PUT: N    		 賣場主件商品名稱
    修改對象為無屬性賣場時才可提供
    Default: {name}
    • updateListing
    shortDescription String[] RW POST: Y
    PUT: Y    		 賣場商品特色
    最多 5 條，每條最長 15 個字，不允許大小於符號和換行
    至少需填 1 條
    • updateListing
    origLayer Int32 RO 提案更新前的賣場屬性
    Options:
    • 0: 無屬性賣場
    • 1: 單層屬性賣場
    • 2: 雙層屬性賣場
    • updateListingModel
    brandId String RW POST: ?
    PUT: ?    		 品牌 ID
    使用 updateListing 時為必填
    • updateListing
    brandName String RO 品牌名稱
    • updateListing

    Proposals #

    Column Name Type RW/RO Required Note
    proposals Proposal[] RO Proposal list
    pagination Pagination RO Pagination

    Update Listing Model Proposal #

    UpdateListingModelProposal #

    Column name Type RW/RO Required [註1]
    Note
    id Int32 RO 提案編號
    supplierId Int32 RO 供應商編號
    listing ProposalListing RW POST: Y
    PUT: Y    		 賣場資訊，賣場 ID 為必填
    subStationId String RO 提案當下的提案子站編號, e.g. sub1
    subStationName String RO 提案當下的提案子站名稱
    skuCandidates Int32[] RW POST: ?
    PUT: N/A    		 dryrun 模式下，輸入需要驗證的屬性/贈品/加價購商品，填寫多筆sku做驗證
    allowedSkuList Int32[] RO dryrun 模式下，回傳驗證成功的商品 ID
    products Product[] RO 屬性/贈品/加價購商品的內容
    models ProposalModel[] RW POST: ?
    PUT: ?    		 賣場屬性商品的內容，正式提案時需填寫完整資訊
    不調整屬性內容時，此欄位可不填
    complimentary ProposalComplimentary RW POST: ?
    PUT: ?    		 賣場買就送贈品的內容，正式提案時需填寫完整資訊
    不調整贈品內容時，此欄位可不填
    selectComplimentary ProposalComplimentary RW POST: ?
    PUT: ?    		 賣場任選贈品的內容，正式提案時需填寫完整資訊
    不調整贈品內容時，此欄位可不填
    additionalPurchases ProposalModel[] RW POST: ?
    PUT: ?    		 賣場加價購的內容，正式提案時需填寫完整資訊
    不調整加價購內容時，此欄位可不填
    applicant String RW POST: Y
    PUT: Y    		 提案人，最長 10 個字，只接受繁/簡體中文
    appliedTs String RO 提案時間
    expiredTs String RO 提案有效時間，預設 15 天後
    contactWindow String RO 提案對象
    createdTs String RO 建檔時間
    creator String RO 建檔者
    modifiedTimes Int32 RO 更新次數
    modifiedTs String RO 更新時間
    modifier String RO 更新者
    executeStatus String RO 執行狀態
    executedTs String RO 執行時間
    executeResult String RO 執行失敗原因
    reviewStatus String RW POST: N
    PUT: N    		 審核狀態
    reviewedTs String RO 審核時間
    reviewer String RO 審核者
    declineReason String RO 不通過原因
    declineDetail String RO 不通過其它原因描述
    note String RW POST: N
    PUT: N    		 提案備註，限 200 個字
    suggestion String RO 改善或建議
    errors ErrorDetail[] RO DryRun 模式為 true 時，會顯示詳細錯誤內容
    diff ProposalSkuDiff RO 儲存提案時，賣場屬性與提案內容的差異
    complimentaryDiff ProposalSkuDiff RO 儲存提案時，賣場買就送贈品與提案內容的差異
    selectComplimentaryDiff ProposalSkuDiff RO 儲存提案時，賣場任選贈品與提案內容的差異
    additionalPurchasesDiff ProposalSkuDiff RO 儲存提案時，賣場加價購與提案內容的差異

    UpdateListingModelProposals #

    Column name Type RW/RO Required Note
    proposals UpdateListingModelProposal[] RO UpdateListingModelProposal list
    pagination Pagination RO Pagination

    ProposalSkuDiff #

    Column Name Type RW/RO Required
    Note
    added ProposalModel[] RO 提案內容新增的賣場屬性/贈品/加價購
    removed ListingModel[] RO 提案內容移除的賣場屬性/贈品/加價購
    updated ProposalUpdatedSku[] RO 提案內容更新的賣場屬性/贈品/加價購
    updatedField ProposalUpdatedField[] RO 提案內容更新的屬性/贈品/加價購欄位

    ProposalUpdatedSku #

    Column Name Type RW/RO Required
    Note
    sku Int32 RO 第 1 層或第 2 層屬性商品 ID
    origin ProposalUpdatedSkuDetail RO 提案內容更新前的屬性項目
    outcome ProposalUpdatedSkuDetail RO 提案內容更新後的屬性項目

    ProposalUpdatedSkuDetail #

    Column Name Type RW/RO Required Note
    spec Attribute RO 第 1 層或第 2 層的屬性名稱與項目
    parentSku Int32 RO 雙層屬性商品的第 1 層屬性商品 ID，單層及無屬性商品無此欄位。當更換的第 1 層屬性已既存於賣場，則第 1 層屬性以此欄位呈現。
    parentSpec Attribute RO 雙層屬性商品的第 1 層屬性名稱與項目，單層及無屬性商品無此欄位。當更新的第 1 層屬性不存在原賣場中，則第 1 層屬性以此欄位呈現。
    price String RO 商品售價
    shortTitle String RO 商品短標題
    name String RO 第 1 層屬性的商品名稱 / 第 2 層屬性項目的商品名稱
    attributes Attribute[] RO 商品規格表，內容包含和屬性名稱相同之規格

    ProposalUpdatedField #

    Column Name Type RW/RO Required Note
    field String RO 欄位名稱
    origin String RO 提案內容更新的既有欄位內容
    outcome String RO 提案內容更新的欄位內容

    ProposalComplimentary #

    Column Name Type RW/RO Required Note
    selectedMinQty Int32 RW POST: ?
    PUT: ?    		 贈品必選數量，調整任選贈品時此欄位必填
    models ProposalModel[] RW POST: Y
    PUT: Y    		 賣場贈品的內容，正式提案時需填寫完整資訊

    Update Listing Proposal #

    UpdateListingProposal #

    Column name Type RW/RO Required [註1] Note
    id Int32 RO 提案編號
    supplierId Int32 RO 供應商編號
    subStationId String RO 提案當下的提案子站編號, e.g. sub1
    subStationName String RO 提案當下的提案子站名稱
    listing ProposalListing RW POST: Y
    PUT: Y    		 賣場資訊，賣場 ID 為必填
    creator String RO 建檔者
    createdTs String RO 建檔時間
    applicant String RW POST: Y
    PUT: Y    		 提案人，最長 10 個字，只接受繁/簡體中文
    contactWindow String RO 提案對象
    appliedTs String RO 提案時間
    expiredTs String RO 提案有效時間，預設 15 天後
    reviewer String RO 審核者
    reviewStatus String RW POST: N
    PUT: N    		 審核狀態
    reviewedTs String RO 審核時間
    declineReason String RO 不通過原因
    declineDetail String RO 不通過其它原因描述
    executeStatus String RO 執行狀態
    executedTs String RO 執行時間
    executeResult String RO 執行失敗原因
    modifiedTimes Int32 RO 更新次數
    modifier String RO 更新者
    modifiedTs String RO 更新時間
    note String RW POST: N
    PUT: N    		 提案備註，限 200 個字
    suggestion String RO 改善或建議
    subProposals SubProposal[] RW POST: Y
    PUT: Y    		 子提案資訊

    UpdateListingProposals #

    Column name Type RW/RO Required Note
    proposals UpdateListingProposal[] RO UpdateListingProposal list
    pagination Pagination RO Pagination

    SubProposal #

    Column Name Type RW/RO Required Note
    id Int32 RW POST: N/A
    PUT: ?    		 子提案單號
    若此欄位為空，則建立新子提案單
    type String RW POST: Y
    PUT: Y    		 子提案申請類型，定義表
    Options:
    • updateImageV2
    • updateVideo
    • updateCopy
    • updateListingAttribute
    errors ErrorDetail[] RO 子提案單建立錯誤時，會顯示詳細錯誤內容

    Batch Proposal #

    BatchProposals #

    Column name Type RW/RO Required Note
    proposals BatchProposal[] RO BatchProposal list
    pagination Pagination RO Pagination

    BatchProposal #

    Column name Type RW/RO
    Required [註1]
    Note
    id Int32 RO 批次提案編號
    supplierId Int32 RO 供應商編號
    proposalType String RW POST: Y
    PATCH: N/A    		 提案類型，定義表
    目前僅支援 updateImageV2
    Options:
    • updateImageV2
    batchSource String RW POST: Y
    PATCH: N/A    		 批次提案來源，詳見 定義表。
    Options:
    • excel
    • page
    • api
    instantExecute Boolean RW POST: N
    PATCH: N/A    		 是否為立刻執行的批次提案。設定為 true 時則不需填寫 executeTs，系統將自動帶入 executeTs = now, executeStatus = finished，並且不進行預約執行
    Default: false
    details BatchProposalDetail[] RW POST: N/A
    PATCH: N    		 提案明細
    此欄位僅提供 PATCH 批次提案時寫入，其餘 method 僅供呈現
    executeTs String RW POST: N
    PATCH: N    		 執行時間
    ISO-8601 format
    executeStatus String RW POST: N/A
    PATCH: N    		 執行狀態，定義表
    Options:
    • idle
    • canceled
    executor String RO 執行預約提案者
    Options:
    • Scheduler: 系統執行
    • 手動執行者 ID
    executeDetail String RO 執行提案的詳情
    revertTs String RW POST: N
    PATCH: N    		 回檔時間
    ISO-8601 format
    revertStatus String RW POST: N/A
    PATCH: N    		 回檔狀態，定義表
    Options:
    • idle
    • canceled
    reverter String RO 執行回檔提案者
    Options:
    • Scheduler: 系統執行
    • 手動執行者 ID
    revertDetail String RO 執行回檔提案的詳情
    creator String RO 建檔者
    createdTs String RO 建檔時間
    modifier String RO 更新者
    modifiedTs String RO 更新時間

    BatchProposalDetail #

    Column name Type RW/RO
    Required [註1]
    		 Note
    listingId Int32 RW POST: N/A
    PATCH: Y    		 賣場編號
    executeProposalId Int32 RW POST: N/A
    PATCH: Y    		 執行提案編號
    revertProposalId Int32 RW POST: N/A
    PATCH: N    		 回檔提案編號