API Resources #
Proposal #
Proposal 提案 #
Column Name | Type | RW/RO | Required [註1] | Note |
For Proposal Type |
---|---|---|---|---|---|
id | Int32 | RO | 提案編號 |
|
|
seqNo | Int32 | RO | 申請單號 |
|
|
supplierId | Int32 | RO | 供應商編號 |
|
|
supplierName | String | RO | 供應商名稱 |
|
|
creator | String | RO | 建檔者,將由 Cookie 自動截取 |
|
|
contactWindow | String | RO | 提案對象,將由指定的 subStationId 自動指定 |
|
|
type | String | RW | POST: Y PUT: Y |
提案單類型,定義表 |
|
applicant | String | RW | POST: ? PUT: ? |
提案人,限 10 個中文字 |
|
subStationId | String | RW | POST: Y PUT: Y |
提案當下的提案站別 ID, e.g. sub1 只允許供應商有簽約的子站 |
|
subStationName | String | RO | 提案當下的提案站別名稱 |
|
|
expiredTs | String | RW | POST: N PUT: N |
審核提案有效期限,預設 +15 天,不得少於提案日+3天,最多可設定提案日+15天 |
|
product | ProposalProduct | RW | POST: ? PUT: ? |
商品資訊reviewStatus 非 composing 時必填 |
|
listing | ProposalListing | RW | POST: Y PUT: Y |
賣場資訊 |
|
createdTs | String | RO | 建檔時間 |
|
|
appliedTs | String | RO | 提案時間 |
|
|
reviewer | String | RO | 審核者 |
|
|
reviewStatus | String | RW | POST: N PUT: N |
審核結果,定義表 Default: composing |
|
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 | 改善或建議 |
|
|
parent | ParentProposal | RO | 母提案單號 若此提案單不為「修改賣場資訊提案單」( UpdateListing ) 之子提案,則此欄位為空 |
|
|
batch | BatchProposalInfo | RW | POST: N PUT: N |
批次提案資訊 若此提案單不為批次提案之細項,則此欄位為空 |
|
BatchProposalInfo 批次提案資訊 #
Column name | Type | RW/RO | Required | Note |
---|---|---|---|---|
id | Int32 | RW | POST: Y PUT: Y |
批次提案編號 |
type | String | RW | POST: Y PUT: Y |
批次提案類型 Options:
|
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}
若 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 (快速到貨),則只能為 1Default: 1 |
length | Int32 | RW | POST: ? PUT: ? |
包裝完成後的商品長度,單位為 cm,需為正整數 若為下列配送方式 ( shipType.id ) 則為必填
|
width | Int32 | RW | POST: ? PUT: ? |
包裝完成後的商品寬度,單位為 cm,需為正整數 若為下列配送方式 ( shipType.id ) 則為必填
|
height | Int32 | RW | POST: ? PUT: ? |
包裝完成後的商品高度,單位為 cm,需為正整數 若為下列配送方式 ( shipType.id ) 則為必填
|
weight | Int32 | RW | POST: ? PUT: ? |
包裝完成後的商品重量,單位為 g,需為正整數 若為下列配送方式 ( shipType.id ) 則為必填
|
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
|
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 (快速到貨) 時才能更改,其餘只能為 1Default: 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 |
商品規格顯示方式
|
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 中的選項
自訂
|
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 時為必填 |
|
spec | Attribute | RW | POST: ? PUT: ? |
第 1 層屬性的 spec 第 0 個 model 的 spec name 將用於表示 level 1 product spec 若為無屬性商品時為空, 有 1 層及以上屬性時必填 若 spec name 是從 structured data 中挑選,且 constraint type 為 radiobox 或 checkbox 時
|
|
items | ProposalItem[] | RW | POST: ? PUT: ? |
屬性內容,shipType.id != 61 (快速到貨) 時必填 |
|
videos | ProductVideo[] | RW | POST: N PUT: N |
商品影片 |
|
images | ProductImage[] | RW | POST: ? PUT: ? |
商品圖 當使用 newListing/newProduct/ updateListingModel新增商品 時為必填
updateListingModel新增商品 時,修改對象為單層屬性賣場時才可提供 |
|
displayName | String | RW | POST: N PUT: N |
賣場顯示名稱,不允許大小於符號和換行,預設為 spec.values[0] 若為無屬性商品時為空, 有 1 層及以上屬性時可填 |
|
isVisible | Boolean | RW | POST: N PUT: N |
屬性是否顯示於前台賣場 Default: true |
|
name | String | RW | POST: ? PUT: ? |
屬性商品名稱 修改對象為單層屬性賣場時才可提供 |
|
partNo | String | RW | POST: N PUT: N |
屬性商品料號,最長 50 個字 不允許換行和 tab 修改對象為單層屬性賣場時才可提供 |
|
barcode | String | RW | POST: N PUT: N |
實際國際條碼,限定為 12-14 碼 若為下列配送方式時則可填寫
|
|
stock | Int32 | RW | POST: N PUT: N |
備貨數量 Default: 0 Range:
|
|
attributes | Attribute[] | RW | POST: ? PUT: ? |
商品規格表,內容包含和屬性名稱相同之規格 修改對象為單層屬性賣場時才可提供 |
|
price | String | RW | POST: ? PUT: ? |
商品售價 當使用 updateListingModel調整加價購商品 時為必填 |
|
shortTitle | String | RW | POST: ? PUT: ? |
商品短標題 當使用 updateListingModel調整贈品商品 時為必填 |
|
ProposalItem #
Column Name | Type | RW/RO | Required [註1] | Note | For Proposal Type |
---|---|---|---|---|---|
id | Int32 | RO | Item ID |
|
|
sku | Int32 | RW | POST: ? PUT: ? |
Item ID 當使用 newListing/newProduct 時不須填寫 當使用 updateListing 時為必填 |
|
stock | Int32 | RW | POST: N PUT: N |
備貨數量 若 配送方式 為 61 ,則只能為 0 Default: 0 Range:
updateListingModel新增商品 時,修改對象為雙層屬性賣場時才可提供 |
|
partNo | String | RW | POST: N PUT: N |
屬性商品供應商商品料號,最長 50 個字 不允許換行和 tab 當使用 updateListing/ updateListingModel新增商品 時,修改對象為雙層屬性賣場時才可提供 |
|
barcode | String | RW | POST: N PUT: N |
實際國際條碼,限定為 12-14 碼 若為下列 配送方式 時則可填寫
updateListingModel新增商品 時,修改對象為雙層屬性賣場時才可提供 |
|
warehouseBarcode | String | RW | POST: N PUT: N |
進倉用國際條碼,限定為 12-14 碼 配送方式 為 61 時可填,未填寫則由系統自動產生 |
|
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 時
|
|
displayName | String | RW | POST: N PUT: N |
賣場顯示名稱,不允許大小於符號和換行,預設為 spec.values[0] 若為無屬性與 1 層屬性商品時為空,為 2 層屬性商品時可填,且各個 model 間的 item display name 必須一致 |
|
warehouseProductName | String | RW | POST: N PUT: N |
進倉用商品名稱 配送方式為快速到貨且預設值超過 50 個字才可填寫,最長 50 個字 Default: {product.name}-{models[].displayName}-{models[].items[].displayName} |
|
isVisible | Boolean | RW | POST: N PUT: N |
屬性是否顯示於前台賣場 Default: true |
|
name | String | RW | POST: ? PUT: ? |
屬性商品名稱 修改對象為雙層屬性賣場時才可提供 |
|
images | ProductImage[] | RW | POST: ? PUT: ? |
商品圖 當使用 updateListingModel新增商品 時為必填修改對象為雙層屬性賣場時才可提供
|
|
attributes | Attribute[] | RW | POST: ? PUT: ? |
商品規格表,內容包含和屬性名稱相同之規格 修改對象為雙層屬性賣場時才可提供 |
|
shortTitle | String | RW | POST: ? PUT: ? |
商品短標題 當使用 updateListingModel調整贈品商品 時為必填 |
|
ProposalProductSpec 商品屬性 #
Column Name | Type | RW/RO | Required | Note |
---|---|---|---|---|
level | Int32 | RO | 屬性層級: [1-2] | |
name | String | RO | 屬性名稱
|
ProposalListing #
Column Name | Type | RW/RO | Required [註1] | Note | For Proposal Type |
---|---|---|---|---|---|
id | Int32 | RW | POST: Y PUT: Y |
賣場 ID |
|
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: ? PUT: ? |
賣場目前的分類子類 ID, e.g. catItem21704reviewStatus 為 draft 以上時必填若因分類變動導致無法以 catItemId 導回,則分類路徑 (區到子類) 資訊將不再回傳 |
|
catItemName | String | RO | 賣場目前的分類子類名 若因分類變動導致無法以 catItemId 導回,則分類路徑 (區到子類) 資訊將不再回傳 |
|
|
seoUrl | String | RW | POST: ? PUT: ? |
賣場網址,最長 50 個字 只接受繁/簡體中文、英文、數字、 - ,多個 - 會合併成一個,開頭不能是 - reviewStatus 為 draft 以上時必填 |
|
featureTitle | String | RW | POST: ? PUT: ? |
特色標題,最長 20 個字 只接受繁/簡體中文、英文、數字、日文、注音符號、空格、 , 、ˊ 、 ˇ 和 ˋ reviewStatus 為 draft 以上時必填 |
|
deliveryType | String | RW | POST: N PUT: N |
交貨期限 Options:
快速到貨 時不可自訂,將依下列規則自動指定
電子票券 時不可自訂,將自動指定為 normal 限制
|
|
preOrderExpectedShipDate | String | RW | POST: ? PUT: ? |
預購型商品預定出貨日 Range:
|
|
customizedOrderShipDateAfterPlaced | Int32 | RW | POST: ? PUT: ? |
客製化商品完成訂單後出貨天數 Range: [3-90] reviewStatus 為 draft 以上且 delieryType = customized 時必填 |
|
onShelvedTs | String | RW | POST: N PUT: N |
開始時間,預設現在時間,不可大於結束時間 |
|
offShelvedTs | String | RW | POST: N PUT: N |
結束時間,預設為開始時間 + 365 天,不可小於開始時間 |
|
price | String | RW | POST: ? PUT: ? |
購物中心售價,到小數點兩位 Range: [0-9999999] Rules:
reviewStatus 為 draft 以上時必填若"賣場毛利率 ((購物中心售價 - 成本) / 購物中心售價) < 子站毛利率"時,則
|
|
purchaseQtyLimit | Int32 | RW | POST: N PUT: N |
限購數量 Default: 12 Range: [1-99] |
|
cvsPurchaseQtyLimit | Int32 | RW | POST: N PUT: N |
超商取貨限購數量 Range: [1-32767] 僅 shipType.id = 800 (直店配) 時可更改,其餘只能為 1最大值為 20000 / 購物中心售價 ,取正整數Default: 1 |
|
copy | String | RW | POST: ? PUT: ? |
商品詳情 (文案),HTML content 當使用 updateCopy 時為必填 See rules |
|
swCode | String | RO | 隱藏賣場 SW code |
|
|
models | ProposalModel[] | RW | POST: N PUT: N |
屬性商品型號 修改對象為有屬性賣場時才可提供 若只修改部分屬性商品,則只需提供有修改的 model |
|
videos | ProductVideo[] | RW | POST: N PUT: N |
賣場影片 為無屬性賣場時才可提供 |
|
images | ProductImage[] | RW | POST: N PUT: N |
賣場圖片 為無屬性賣場時才可提供 |
|
additionalPurchases | ProposalModel[] | RW | POST: N PUT: N |
加價購內容 |
|
complimentaries | ProposalModel[] | RW | POST: N PUT: N |
買就送贈品內容 |
|
selectComplimentaries | ProposalModel[] | RW | POST: N PUT: N |
任選贈品內容 |
|
shareMediaBetweenModels | Boolean | RW | POST: N PUT: N |
是否共用同一組商品圖/影片 只有 1 層屬性時可為 true 若為 true ,則 models 只能有 0 (「不共用」改為「共用」,未變更主商品圖片/影片) 或 1 個 model,且 SKU 需和原賣場第一個 model 相同 ( model[0].sku )Default: false |
|
attributeDisplayMode | String | RW | POST: ? PUT: ? |
商品規格顯示方式 當使用 updateListingAttribute 時為必填 Options:
|
|
struDataAttrClusterId | String | RW | POST: ? PUT: ? |
Structured data attribute cluster ID 當使用 updateListingAttribute 時為必填 |
|
attributes | Attribute[] | RW | POST: ? PUT: ? |
商品規格表 當使用 updateListingAttribute 時為必填 |
|
syncProductImages | Boolean | RW | POST: N PUT: N |
是否同時修改無屬性賣場之商品圖片 Default: true |
|
isThresholdFreebie | Boolean | RW | POST: N PUT: N |
是否為滿額贈贈品賣場 Default: false 限制
|
|
warranty | ProductWarranty | RW | POST: N PUT: N |
商品保證 |
|
partNo | String | RW | POST: N PUT: N |
賣場主件供應商商品料號,最長 50 個字 不允許換行和 tab |
|
name | String | RW | POST: Y PUT: Y |
賣場名稱 |
|
productName | String | RW | POST: N PUT: N |
賣場主件商品名稱 修改對象為無屬性賣場時才可提供 Default: {name} |
|
shortDescription | String[] | RW | POST: Y PUT: Y |
賣場商品特色 最多 5 條,每條最長 15 個字,不允許大小於符號和換行 至少需填 1 條 |
|
origLayer | Int32 | RO | 提案更新前的賣場屬性 Options:
|
|
|
brandId | String | RW | POST: ? PUT: ? |
品牌 ID 使用 updateListing 時為必填 |
|
brandName | String | RO | 品牌名稱 |
|
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:
|
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:
|
batchSource | String | RW | POST: Y PATCH: N/A |
批次提案來源,詳見 定義表。 Options:
|
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:
|
executor | String | RO | 執行預約提案者 Options:
|
|
executeDetail | String | RO | 執行提案的詳情 | |
revertTs | String | RW | POST: N PATCH: N |
回檔時間 ISO-8601 format |
revertStatus | String | RW | POST: N/A PATCH: N |
回檔狀態,定義表 Options:
|
reverter | String | RO | 執行回檔提案者 Options:
|
|
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 |
回檔提案編號 |