新增一般賣場提案 #
更新新增一般賣場提案單 #
更新已建立的 新增一般賣場提案單
Endpoint URL: https://tw.supplier.yahoo.com/api/spa/v1/proposals
HTTP Method: PUT
Request Parameters #
id #
提案單號。
資料型態: Integer
必填: 是
Request Body #
applicant #
提案人。
資料型態: String
必填: 是
長度限制: 最長 10 個字
格式: 繁/簡體中文
subStationId #
提案當下的提案站別 ID。
資料型態: String
必填: 是
範例: sub1 (只允許供應商有簽約的子站)
type #
提案單類型。
資料型態: String
必填: 是
欄位說明: 請填寫 newListing
,詳情請參考 Proposal Type 提案類型
note #
備註。
資料型態: String
必填: 是
長度限制: 最長 200 個字
reviewStatus #
審核結果。
資料型態: String
必填: 是
欄位有效值:
- composing:當提案單審核狀態為
composing
時,可變更為composing
- draft:當提案單審核狀態為
composing
或draft
時,可變更為draft
- pendingReview:當提案單審核狀態為
composing
、draft
或pendingReview
時,可變更為pendingReview
欄位說明: 更新新建一般賣場提案單僅填寫以上狀態,其它狀態請參考 欄位定義表
listing #
賣場資訊。
catItemId deliveryType 欄位說明: reviewStatus 為 名詞定義: featureTitle price 欄位說明: reviewStatus 為 seoUrl preOrderExpectedShipDate 格式: ISO-8601 customizedOrderShipDateAfterPlaced onShelvedTs offShelvedTs purchaseQtyLimit cvsPurchaseQtyLimit isThresholdFreebie欄位說明
賣場目前的分類子類 ID。
資料型態: String
必填: 否
範例: catItem21704
欄位說明: reviewStatus 為 draft
以上時必填。若因分類變動導致無法以 catItemId 導回,則分類路徑 (區到子類) 資訊將不再回傳
交貨期限。
資料型態: String
必填: 否
欄位內容:
draft
以上時必填。限制如下:
電子票券
時,不論何種狀態皆為 normal快速到貨
: 依 安裝狀態
區分
是廢四機
: appointment非廢四機
: normal子站功能
區分
是直店配
: normal非直店配
: appointment, normal
若配送方式為
快速到貨
時不可自訂,將依上列規則自動指定。若為需要安裝或是屬於廢四機時,指定為 appointment
,否則指定為 normal
。
若配送方式為 電子票券
時不可自訂,將自動指定為 normal
。
特色標題。
資料型態: String
必填: 否
長度限制: 最長 20 個字
格式: 只接受繁/簡體中文、英文、數字、日文、注音符號、空格、 ,
、ˊ
、 ˇ
和 ˋ
欄位說明: reviewStatus 為 draft
以上時必填
購物中心售價
資料型態: String
必填: 否
範圍: 0-9999999
格式: 到小數點兩位
欄位規則:
draft
以上時必填。若 賣場毛利率 ((購物中心售價 - 成本) / 購物中心售價) < 子站毛利率
時,則有以下兩種狀況:
供應商啟用功能 包含
autoApproveListingOnOffShelve
即為有自動過審
賣場網址。
資料型態: String
必填: 否
長度限制: 最長 50 個字
格式: 只接受繁/簡體中文、英文、數字、-
,多個 -
會合併成一個,開頭不能是 -
欄位說明: reviewStatus 為 draft
以上時必填
預購型商品預定出貨日。
資料型態: String
必填: 否
範圍:
preOrder
: <= today+180
欄位說明: reviewStatus 為 draft
以上且 delieryType = preOrder
時必填
客製化商品完成訂單後出貨天數
資料型態: Integer
必填: 否
範圍: 3-90
欄位說明: reviewStatus 為 draft
以上且 delieryType = customized
時必填
開始時間。
資料型態: String
必填: 否
預設值: 現在時間
範圍: 不可大於結束時間
格式: ISO-8601
結束時間。
資料型態: String
必填: 否
預設值: 預設為開始時間 + 365 天
範圍: 不可小於開始時間
格式: ISO-8601
限購數量。
資料型態: Integer
必填: 否
預設值: 12
範圍: 1-99
超商取貨限購數量。
資料型態: Integer
必填: 否
預設值: 1
範圍: 1-32767
欄位說明: 僅 shipType.id = 800 (直店配) 時可更改,其餘只能為 1。最大值為 20000 / 購物中心售價
,取正整數。
是否為滿額贈贈品賣場。
資料型態: Boolean
必填: 否
預設值: false
欄位說明: 賣場限制如下:
雙層屬性賣場
預購型商品
、客製化商品
或客約送貨日
ESD
或電子票券
資料型態: ProposalListing
必填: 是
product #
商品資訊。
attributeDisplayMode attributes 規格種類: catItemId contentRating 欄位說明: cost isExpiringItem isInstallRequired isLargeVolumnProductGift isNeedRecycle isOutrightPurchase minPackingCount gameContents taxable models spec items videos images displayName 其中 spec 及 items 分別以賣場型態詳細說明: stock 欄位說明: 若 partNo barcode warehouseBarcode warehouseProductName isVisible stock 欄位說明: 若 partNo barcode warehouseBarcode warehouseProductName isVisible displayName spec msrp name partNo shipType shortDescription struDataAttrClusterId warranty copy brand brandId height length model preserveDays weight width eVoucherAttributes eVoucherType欄位說明
商品規格顯示方式。
資料型態: String
必填: 是
預設值: table
欄位內容:
商品規格表。
資料型態: Attribute[]
必填: 否
欄位說明: 在 ProposalProduct 的 models 中被選中的 Attribute,不可再填入此欄位。
其餘 structured data attribute cluster 定義的 必填欄位
(即 required 設為 ture) 則必須提供,
指的即是 GET v1/struDataAttrClusters
取回的內容 (即 StruDataAttrCluster 中的 attributes)。
自訂其他屬性
。
自訂屬性
名稱重複
商品目前的分類子類 ID。
資料型態: String
必填: 是
範例: catItem21704
欄位說明: 對應到的子站要跟供應商有簽約的子站有交集,若因分類變動導致無法以 catItemId 導回,則分類路徑 (區到子類) 資訊將不再回傳
內容級別。
資料型態: String
必填: 是
欄位內容:
subStationId=sub28
(電玩 / 遊戲),只允許 G, PG, PG12, PG15 and RsubStationId=sub566
,只允許 R and NC18
成本 (含稅+運費)。
資料型態: String
必填: 是
範圍: 0-9999999
格式: 到小數點兩位
欄位說明: 成本(含稅+運費) <= 購物中心售價 <= 廠商建議價
是否為即期品。
資料型態: Boolean
必填: 否
預設值: false
欄位說明: shipType.id = 61
(快速到貨) 且 preserveDays != null
(有效期商品) 時才能為 true
是否需要安裝。
資料型態: Boolean
必填: 否
預設值: false
欄位說明: shipType.id = 61
(快速到貨) 且有簽屬「家電增補附約」時才能為 true
是否為大型商品附屬贈品。
資料型態: Boolean
必填: 否
預設值: false
欄位說明: shipType.id = 61
(快速到貨) 且有簽屬「家電增補附約」時才能為 true
是否屬於廢四機。
資料型態: Boolean
必填: 否
預設值: false
欄位說明: 可填寫 true 需符合其中一項條件
是否為買斷商品。
資料型態: Boolean
必填: 否
預設值: false
欄位說明: shipType.id = 61
(快速到貨) 且有簽屬「買斷附約」時才能為 true
最小包裝數。
資料型態: Integer
必填: 否
預設值: 1
範圍: 1-32767
欄位說明: shipType.id = 61
(快速到貨) 時才能更改,其餘只能為 1
遊戲情節內容。
資料型態: String[]
必填: 否
欄位說明: 當 subStationId=sub28
時可填以下選項:
商品是否應稅。
資料型態: Boolean
必填: 否
預設值: true
欄位說明: 當提案子站為書籍 (subStationId=sub43
) 時才可以選擇 免稅
設為 false
商品型號(屬性)。
資料型態: ProposalModel[]
必填: 是
欄位說明: 每一個商品即為一筆 ProposalModel
商品屬性。
資料型態: Attribute[]
必填: 否
欄位說明: 無屬性賣場不需填寫
屬性內容。
資料型態: ProposalItem[]
必填: 否
欄位說明: 配送方式 shipType.id != 61 (快速到貨) 時必填
商品影片。
資料型態: ProductVideo[]
必填: 否
欄位說明: 商品影片 / 商品圖可透過 檔案上傳 取得上傳的圖片連結
商品圖。
資料型態: ProductImage[]
必填: 是
欄位說明: 商品影片 / 商品圖可透過 檔案上傳 取得上傳的圖片連結。規則如下:
賣場顯示名稱。
資料型態: String
必填: 否
格式: 不允許大小於符號和換行
預設值: 單層 / 雙層賣場預設為 spec.values[0]
,無屬性賣場為空
欄位說明: 單層 / 雙層賣場才可填寫
其他
,自訂內容存放於 displayName
{
"displayName": "白色系",
"spec": {
"name": "顏色",
"values": [
"白色系"
]
}
}
{
"displayName": "自訂白色系",
"spec": {
"name": "顏色",
"values": [
"其他"
]
}
}
{
"spec": {
"name": "自訂顏色",
"values": [
"其他"
]
},
"displayName": "自訂屬性白色系"
}
備貨數量。
資料型態: Integer
必填: 否
預設值: 0
範圍:
配送方式為 61 (快速到貨),則只能為 0
屬性商品供應商商品料號。
資料型態: String
必填: 否
格式: 不允許換行和 tab
長度限制: 最長 50 個字
實際國際條碼。
資料型態: String
必填: 否
長度限制: 限定為 12-14 碼
欄位說明: 若為下列 配送方式 時則可填寫
進倉用國際條碼。
資料型態: String
必填: 否
長度限制: 限定為 12-14 碼
欄位說明: 配送方式為 61: 快速到貨
時則可填寫,未填寫則由系統自動產生
進倉用商品名稱。
資料型態: String
必填: 否
長度限制: 最長 50 個字
預設值: {product.name}-{models[].displayName}-{models[].items[].displayName}
欄位說明: 配送方式為快速到貨
且預設值超過 50 個字才可填寫
屬性是否顯示於前台賣場。
資料型態: Boolean
必填: 否
預設值: true
雙層賣場中第 1 層屬性的 spec
其他
,自訂內容存放於 displayName
{
"displayName": "白色系",
"spec": {
"name": "顏色",
"values": [
"白色系"
]
}
}
{
"displayName": "自訂白色系",
"spec": {
"name": "顏色",
"values": [
"其他"
]
}
}
{
"displayName": "自訂項目白色系",
"spec": {
"name": "自訂顏色",
"values": [
"其他"
]
}
}
備貨數量。
資料型態: Integer
必填: 否
預設值: 0
範圍:
配送方式為 61 (快速到貨),則只能為 0
屬性商品供應商商品料號。
資料型態: String
必填: 否
格式: 不允許換行和 tab
長度限制: 最長 50 個字
實際國際條碼。
資料型態: String
必填: 否
長度限制: 限定為 12-14 碼
欄位說明: 若為下列 配送方式 時則可填寫
進倉用國際條碼。
資料型態: String
必填: 否
長度限制: 限定為 12-14 碼
欄位說明: 配送方式為 61: 快速到貨
時則可填寫,未填寫則由系統自動產生
進倉用商品名稱。
資料型態: String
必填: 否
長度限制: 最長 50 個字
預設值: {product.name}-{models[].displayName}-{models[].items[].displayName}
欄位說明: 配送方式為快速到貨
且預設值超過 50 個字才可填寫
屬性是否顯示於前台賣場。
資料型態: Boolean
必填: 否
預設值: true
賣場顯示名稱。
資料型態: String
必填: 否
預設值: spec.values[0]
格式: 不允許大小於符號和換行
欄位說明: 僅雙層賣場才可填寫,各個 model 間的 item.displayName
必須一致
雙層賣場第 2 層屬性的 spec。
資料型態: String
必填: 否
預設值: spec.values[0]
格式: 不允許大小於符號和換行
欄位說明: 僅雙層賣場才可填寫,各個 model 間的 item.spec.name
必須一致,規則如下:
其他
,自訂內容存放於 displayName
{
"displayName": "M",
"spec": {
"name": "商品尺寸",
"values": [
"M"
]
}
}
{
"displayName": "自訂S",
"spec": {
"name": "商品尺寸",
"values": [
"其他"
]
}
}
{
"displayName": "S",
"spec": {
"name": "自訂屬性尺寸",
"values": [
"其他"
]
}
}
廠商建議價 (manufacturer’s suggested retail price)。
資料型態: String
必填: 是
範圍: 0-9999999
格式: 到小數點兩位
欄位說明: 成本(含稅+運費) <= 購物中心售價 <= 廠商建議價
商品名稱。
資料型態: String
必填: 是
長度限制: 最長 100 個字
長度計算方式: {name}-{models[].displayName}-{models[].items[].displayName}
格式: 不允許大小於符號和換行
欄位說明: 若 shipType.id = 61
(快速到貨) 且為即期品,必須加上前綴 (即期品)
主件商品供應商商品料號。
資料型態: String
必填: 否
長度限制: 最長 50 個字
格式: 不允許換行和 tab
配送方式。
資料型態: ShipType
必填: 是
欄位內容: 若非電子票券
僅需填寫 id
欄位說明:
電子票券
時,賣場僅可設定為無屬性賣場
賣場簡短說明。
資料型態: String[]
必填: 是
長度限制: 每條最長 15 個字
格式: 不允許大小於符號和換行
欄位內容: 至少需填 1 條,最多 5 條
結構化資料屬性集 ID (Structured data attribute cluster ID)。
資料型態: String
必填: 是
商品保證。
資料型態: ProductWarranty
必填: 否
預設值: {“period”: “無保固”, “scope”: “無保固”, “handler”: “none”, "productStatus": "new"}
商品詳情 (文案),HTML content。
資料型態: String
必填: 是
欄位內容: 請參考 賣場/商品詳情(文案)限制
ESD 專用品牌。
資料型態: String
必填: 否
長度限制: 最長 20 個字
格式: 不允許大小於符號和換行
品牌 ID。
資料型態: String
必填: 是
欄位說明: 品牌 ID 可透過 品牌名稱關鍵字搜尋
brands[]
中會有多筆符合搜尋條件的品牌資料,選擇欲使用的品牌名稱 ex. Yahoo!,在提案內容 product.brandId
填寫相對應的 id
value 即可。
包裝完成後的商品高度,單位為 cm。
資料型態: Integer
必填: 否
格式: 需為正整數
欄位說明: 若配送方式 (shipType.id) 則為 61 快速到貨
或 800 直店配
必填。限制如下:
isInstallRequired
= true) 或有勾選「廢四機」(isNeedRecycle
= ture),則有以下限制:
包裝完成後的商品長度,單位為 cm。
資料型態: Integer
必填: 否
格式: 需為正整數
欄位說明: 若配送方式 (shipType.id) 則為 61 快速到貨
或 800 直店配
必填。限制如下:
isInstallRequired
= true) 或有勾選「廢四機」(isNeedRecycle
= ture),則有以下限制:
商品型號。
資料型態: String
必填: 否
長度限制: 最長 40 個字
格式: 不允許大小於符號和換行
商品保存期限,單位為天。
資料型態: Integer
必填: 否
範圍: 1-32767
格式: 需為正整數
欄位說明: 若為以下配送方式則可填,否則應為 null
快速到貨
電子票券
包裝完成後的商品重量,單位為 g。
資料型態: Integer
必填: 否
格式: 需為正整數
最大值: 2147483647
欄位說明: 若配送方式 (shipType.id) 則為 61 快速到貨
或 800 直店配
必填。限制如下:
isInstallRequired
= true) 或有勾選「廢四機」(isNeedRecycle
= ture) 才可大於 30,000g
包裝完成後的商品寬度,單位為 cm。
資料型態: Integer
必填: 否
格式: 需為正整數
欄位說明: 若配送方式 (shipType.id) 則為 61 快速到貨
或 800 直店配
必填。限制如下:
isInstallRequired
= true) 或有勾選「廢四機」(isNeedRecycle
= ture),則有以下限制:
電子票券資訊。
資料型態: VoucherAttribute[]
必填: 否
欄位說明: 若配送方式為 電子票券
(shipType.id=200 且 shipType.model=150) 必填。
電子票券類型。
資料型態: String
必填: 否
欄位說明:
電子票券
(shipType.id=200 且 shipType.model=150) 必填。
資料型態: ProposalProduct
必填: 否
reviewStatus 非 composing 時必填
Request/Response Syntax #
PUT /api/spa/v1/proposals
{
"applicant": string,
"product": {
"attributeDisplayMode": string,
"attributes": [
{
"name": string,
"values": [
string
]
}
],
"catItemId": string,
"contentRating": string,
"cost": string,
"eVoucherAttributes": [
{
"name": string,
"value": string
}
],
"eVoucherType": string,
"isExpiringItem": boolean,
"isInstallRequired": boolean,
"isLargeVolume": boolean,
"isLargeVolumnProductGift": boolean,
"isNeedRecycle": boolean,
"isOutrightPurchase": boolean,
"minPackingCount": number,
"models": [
{
"items": [
{
"partNo": string,
"barcode": string,
"warehouseBarcode": string,
"warehouseProductName": string,
"spec": {
"name": string,
"values": [
string,
]
},
"displayName": string
}
],
"videos": [
{
"url": string,
"order": number
}
],
"images": [
{
"url": string,
"order": number
}
],
"spec": {
"name": string,
"values": [
string
]
},
"displayName": string
}
],
"msrp": string,
"name": string,
"partNo": string,
"shipType": {
"id": number,
"model": number
},
"shortDescription": [
string,
string
],
"struDataAttrClusterId": string,
"warranty": {
"period": string,
"description": string,
"handler": string,
"scope": string,
"productStatus": string
},
"copy": string,
"brand": string,
"brandId": string,
"height": number,
"length": number,
"model": string,
"preserveDays": number,
"weight": number,
"width": number
},
"reviewStatus": string,
"subStationId": string,
"type": string,
"note": string,
"listing": {
"catItemId": string,
"deliveryType": string,
"featureTitle": string,
"price": string,
"seoUrl": string,
}
}
{
"applicant": string,
"contactWindow": string,
"createdTs": string,
"creator": string,
"executeStatus": string,
"expiredTs": string,
"id": number,
"listing": {
"applyLowGpm": boolean,
"catId": string,
"catItemId": string,
"catItemName": string,
"catName": string,
"cvsPurchaseQtyLimit": number,
"deliveryType": string,
"featureTitle": string,
"isDisplay": boolean,
"offShelvedTs": string,
"onShelvedTs": string,
"price": string,
"purchaseQtyLimit": number,
"seoUrl": string,
"subStationId": string,
"subStationName": string,
"zoneId": string,
"zoneName": string
},
"modifiedTimes": number,
"modifiedTs": string,
"modifier": string,
"note": string,
"product": {
"attributeDisplayMode": string,
"attributes": [
{
"name": string,
"values": [
string
]
}
],
"brand": string,
"brandId": string,
"brandName": string,
"catId": string,
"catItemId": string,
"catItemName": string,
"catName": string,
"contentRating": string,
"copy": string,
"cost": string,
"eVoucherAttributes": [
{
"dataType": string,
"name": string,
"value": string
}
],
"eVoucherType": string,
"height": number,
"isExpiringItem": boolean,
"isInstallRequired": boolean,
"isLargeVolume": boolean,
"isLargeVolumnProductGift": boolean,
"isNeedRecycle": boolean,
"isOutrightPurchase": boolean,
"length": string,
"minPackingCount": string,
"model": string,
"models": [
{
"displayName": string,
"images": [
{
"height": number,
"order": number,
"url": string,
"width": number
}
],
"items": [
{
"barcode": string,
"displayName": string,
"partNo": string,
"spec": {
"name": string,
"values": [
string
]
},
"stock": number,
"warehouseBarcode": string,
"warehouseProductName": string,
},
{
"displayName": string,
"partNo": "5567",
"spec": {
"name": string,
"values": [
string,
]
},
"stock": number,
"warehouseProductName": string,
}
],
"spec": {
"name": string,
"values": [
string
]
},
"videos": [
{
"order": number,
"url": string,
}
]
}
],
"msrp": string,
"name": string,
"partNo": string,
"preserveDays": number,
"safeStockQty": number,
"shareMediaBetweenModels": boolean,
"shipType": {
"id": number,
"model": number,
"name": string
},
"shortDescription": [
string,
string
],
"specs": [
{
"level": number,
"name": string
},
{
"level": number,
"name": string
}
],
"struDataAttrClusterId": string,
"struDataAttrClusterName": string,
"subStationId": string,
"subStationName": string,
"warranty": {
"description": string,
"handler": string,
"period": string,
"scope": string,
"productStatus": string
},
"weight": number,
"width": number,
"zoneId": string,
"zoneName": string
},
"reviewStatus": string,
"subStationId": string,
"subStationName": string,
"supplierId": number,
"supplierName": string,
"type": string,
}
Response Elements #
若操作成功,API 會回傳 HTTP 200 response。並以 JSON 格式回傳完整的 Proposal 物件。
id #
提案編號。
資料型態: Integer
applicant #
提案人。
資料型態: String
contactWindow #
提案對象。
資料型態: String
createdTs #
建檔時間。
資料型態: String
格式: ISO-8601
creator #
建檔者。
資料型態: String
executeStatus #
執行狀態。
資料型態: String
欄位內容: 詳見 執行狀態
expiredTs #
提案有效時間。
資料型態: String
格式: ISO-8601
modifiedTimes #
更新次數。
資料型態: Integer
modifiedTs #
更新時間。
資料型態: String
格式: ISO-8601
modifier #
更新者。
資料型態: String
note #
備註。
資料型態: String
reviewStatus #
審核狀態。
資料型態: String
有效值: 詳見 審核狀態
subStationId #
提案當下的提案站別 ID。
資料型態: String
subStationName #
提案當下的提案子站名稱。
資料型態: String
supplierId #
供應商編號。
資料型態: Integer
supplierName #
供應商名稱。
資料型態: String
type #
提案單類型。
資料型態: String
listing #
賣場資訊。
資料型態: ProposalListing
欄位說明
欄位名稱
資料型態
說明
applyLowGpm
Boolean
申請低毛利率賣場,預設: false
catId
String
賣場目前的分類父類 ID
catItemId
String
賣場目前的分類子類 ID
catItemName
String
賣場目前的分類子類名稱
catName
String
賣場目前的分類父類名稱
cvsPurchaseQtyLimit
Integer
超商取貨限購數量,預設: 1
deliveryType
String
交貨期限
featureTitle
String
特色標題
isDisplay
Boolean
賣場是否顯示,預設: true
offShelvedTs
String
結束時間,預設為
開始時間 +365 天
onShelvedTs
String
開始時間,預設現在時間,不可大於結束時間
price
String
購物中心售價,到小數點兩位
purchaseQtyLimit
Integer
限購數量,預設: 12
seoUrl
String
賣場網址
subStationId
String
賣場目前的分類子站 ID
subStationName
String
賣場目前的分類子站名稱
zoneId
String
賣場目前的分類區 ID
zoneName
String
賣場目前的分類區名稱
swCode
String
隱藏賣場 SW code
isThresholdFreebie
Boolean
是否為滿額贈贈品賣場,預設: false
product #
商品資訊。
資料型態: ProposalProduct
欄位說明
欄位名稱
資料型態
欄位說明
attributeDisplayMode
String
商品規格顯示方式,預設: table
attributes
Attribute[]
商品規格表
brand
String
ESD 專用品牌
brandId
String
品牌 ID
brandName
String
品牌名稱
catId
String
商品目前的分類父類 ID
catItemId
String
商品目前的分類子類 ID
catItemName
String
商品目前的分類子類名稱
catName
String
商品目前的分類父類名稱
contentRating
String
內容級別
copy
String
商品詳情 (文案),HTML content
cost
String
成本(含稅+運費)
height
Integer
包裝完成後的商品高度,單位為 cm
isExpiringItem
Boolean
是否為即期品,預設: false
isInstallRequired
Boolean
是否需要安裝,預設: false
isLargeVolume
Boolean
是否為大型商品,預設: false
isLargeVolumnProductGift
Boolean
是否為大型商品附屬贈品 ,預設: false
isNeedRecycle
Boolean
是否屬於廢四機,預設: false
isOutrightPurchase
Boolean
是否為買斷商品,預設: false
length
Integer
包裝完成後的商品長度,單位為 cm
minPackingCount
String
最小包裝數,預設: 1
model
String
商品型號
models
ProposalModel[]
商品型號(屬性)
msrp
String
廠商建議價
name
String
商品名稱
partNo
String
主件商品供應商商品料號
preserveDays
Integer
商品保存期限,單位為天
safeStockQty
Integer
安全庫存量,預設: 1
shareMediaBetweenModels
Boolean
是否共用同一組商品圖/影片,預設: false
shipType
ShipType
配送方式
shortDescription
String
賣場簡短說明
specs
ProposalProductSpec[]
商品屬性
struDataAttrClusterId
String
結構化資料屬性集 ID
struDataAttrClusterName
String
結構化資料屬性集名稱
subStationId
String
商品目前的分類子站 ID
subStationName
String
商品目前的分類子站名稱
warranty
ProductWarranty
商品保證
weight
Integer
包裝完成後的商品重量,單位為 g
width
Integer
包裝完成後的商品寬度,單位為 cm
zoneId
String
商品目前的分類區 ID
zoneName
String
商品目前的分類區名稱
gameContents
String[]
遊戲情節內容
taxable
Boolean
商品是否應稅,預設: true
eVoucherAttributes
VoucherAttribute[]
電子票券資訊
eVoucherType
String
電子票券類型,可選擇類型
Errors #
Bad Request #
輸入的參數不符合 API 定義的 Pattern。
HTTP Status Code: 400
Error
Error Code | Description |
---|---|
Invalid input | |
40000005 | Contains illegal character(s) |
40000010 | Multiple bad parameters |
40000011 | Invalid ISO-8601 format |
40000012 | Image could not be fetched |
40000015 | Invalid array size |
40000018 | Unexpected empty field |
40000019 | Cannot contains emoji |
40000020 | Cannot start/end with space |
40000025 | Invalid integer format |
40009000 | The gross profit margin is too low |
40009001 | The gross profit margin should be greater than or equal to 0 |
40009002 | No permission to apply for low gross profit margin listing |
40009003 | No permission to set listing is not display |
40009005 | Sub station not exist |
40009007 | Price cannot be greater than CVS’ limitation NT$20,000 |
40009008 | Missing or bad sub station ID |
40009009 | Cannot fetch the provided media resource(s) |
40009010 | Manufacturer’s suggested retail price cannot be 0 |
40009011 | Price cannot be 0 |
40009012 | Cost cannot be 0 |
40009013 | Price cannot be greater than Manufacturer’s suggested retail price |
40009014 | Cost cannot be greater than Manufacturer’s suggested retail price |
40009015 | Cost cannot be greater than price |
40009016 | Manufacturer’s suggested retail price cannot be empty when the review status isn’t composing |
40009017 | Price cannot be empty when the review status isn’t composing and the type is newListing |
40009018 | Cost cannot be empty when the review status isn’t composing |
40009019 | Duplicated proposal product/listing media order |
40009020 | Insufficient proposal product/listing main image |
40009021 | The main image dimension should be a square and greater than or equal to 1000x1000 pixels |
40009022 | The image dimension should be a square and greater than or equal to 400x400 pixels |
40009023 | The first proposal product/listing model must have images when the review status isn’t composing |
40009024 | Seems not sharing images between models, please provide images for each model |
40009025 | Invalid iframe URL in the proposal copy HTML |
40009026 | Invalid image URL in the proposal copy HTML |
40009027 | Invalid listing display order |
40009028 | Invalid content in the proposal copy HTML |
40009029 | Mismatch category ID |
40009030 | Invalid categoryItem ID |
40009035 | Product warranty cannot be empty when the review status isn’t composing |
40009036 | Product warranty scope cannot be empty when the review status isn’t composing and warranty period isn’t 無保固 |
40009037 | Invalid product warranty handler, empty or none when the review status isn’t composing or warranty period isn’t 無保固 |
40009038 | Invalid media URL in the proposal |
40009039 | Invalid barcode |
40009040 | Duplicated warehouse barcode |
40009041 | Cannot designate the product as an install required item |
40009042 | Cannot designate the product as a large volume item’s gift |
40009043 | Proposal expired time must within +3 and +15 days |
40009044 | Product content rating cannot be empty when the review status isn’t composing |
40009045 | Invalid product content rating |
40009046 | Invalid product safe stock quantity |
40009047 | Product length cannot be empty when the review status isn’t composing |
40009048 | Product width cannot be empty when the review status isn’t composing |
40009049 | Product height cannot be empty when the review status isn’t composing |
40009050 | Product weight cannot be empty when the review status isn’t composing |
40009051 | Product length + width + height must be less than or equals to 150 cm |
40009052 | Product weight must be less than or equals to 20000 gram |
40009053 | Invalid product preserve days |
40009054 | Product cannot be a expiring item |
40009055 | Invalid product name, too long after appended the attribute name |
40009056 | Invalid product minimum packing count |
40009057 | Product display mode cannot be empty when the review status isn’t composing |
40009058 | Product game contents must be empty |
40009059 | Product structure data attribute cluster ID cannot be empty when the review status isn’t composing |
40009060 | Duplicated product specification |
40009061 | Duplicated product/listing attribute |
40009062 | Duplicate attributes and specifications |
40009063 | Proposal model specification must be empty when there is no attribute in the proposal |
40009064 | Proposal model display name must be empty when there is no attribute in the proposal |
40009065 | Proposal model specification name must be equal to each other |
40009066 | Proposal item specification must be empty when there aren’t 2 attributes in the proposal |
40009067 | Proposal item display name must be empty when there aren’t 2 attributes in the proposal |
40009068 | Proposal item specification name must be equal between models |
40009069 | Invalid proposal item stock |
40009070 | Proposal item warehouse barcode must be empty |
40009071 | Proposal item barcode must be empty |
40009072 | Proposal model specification cannot be empty when there isn’t no attribute in the proposal |
40009073 | Proposal model specification values must have only one value and pre-defined in structured data |
40009074 | Proposal item specification cannot be empty when there are 2 attributes in the proposal |
40009075 | Proposal item specification values must have only one value, be equal between models and pre-defined in structured data |
40009076 | Proposal models cannot be empty when the review status isn’t composing |
40009077 | Category item ID cannot be empty when the review status isn’t composing |
40009078 | Listing URL cannot be empty when the review status isn’t composing |
40009079 | Product name must start with (即期品) |
40009080 | Listing URL only allow Chinese, English, numeric and dash (- ) |
40009081 | Invalid product short description, might be longer than 15 words or contains invalid character |
40009082 | Product short description must have at least one is not empty when the review status isn’t composing |
40009083 | Listing delivery type cannot be empty when the review status isn’t composing |
40009084 | Listing pre-order expected ship date cannot be empty when delivery type is pre-order |
40009085 | Listing customized order ship date after placed cannot be empty when delivery type is customized |
40009086 | Invalid listing pre-order expected ship date |
40009087 | Cannot sharing media between models for the proposal which isn’t with 1 layer attribute |
40009088 | Listing on shelved time cannot be greater than off shelved time |
40009089 | Product copy cannot be empty when the review status isn’t composing |
40009090 | Listing CVS purchase quantity limit must less than 20000 / price |
40009091 | Listing CVS purchase quantity limit must be empty |
40009092 | Cannot designate the product as a recyclable item |
40009093 | Cannot designate the product as an outright purchased item |
40009094 | The supplier hasn’t be granted the ship type permission |
40009095 | Invalid delivery type |
40009096 | Invalid structure data attribute cluster ID |
40009097 | Only the first model can assign images when sharing media between models |
40009098 | Only the first model can assign videos when sharing media between models |
40009100 | Unallowed discount tool |
40009101 | Unallowed discount target member |
40009102 | Unallowed discount site |
40009103 | Unallowed discount activity |
40009104 | Cannot PUT the proposal which review status isn’t composing and draft |
40009106 | Cannot create a non-composing proposal with empty warranty period |
40009107 | Proposal applicant cannot be empty when the review status isn’t composing |
40009108 | The order number must be sequential when the review status isn’t composing |
40009109 | The sub station doesn’t support the delivery type |
40009110 | Invalid ship type ID |
40009111 | Product name cannot be empty when the review status isn’t composing |
40009112 | Product/Listing attribute value cannot be empty |
40009113 | Product/Listing attribute value’s length does not meet the constraints |
40009114 | Too many customized product/listing attribute values |
40009115 | Missing required product/listing attribute |
40009116 | Product/Listing attributes values are duplicated |
40009117 | Too many product/listing attribute values |
40009119 | The image order cannot be empty |
40009120 | Duplicated game contents |
40009121 | Unallowed game contents |
40009122 | Invalid product is large volume |
40009124 | Duplicated display name |
40009127 | Invalid listing ID |
40009128 | Invalid listing copy |
40009131 | Video does not exist |
40009132 | Product length, width or height must be less than or equals to its limitation |
40009133 | The SKU doesn’t belong to the listing |
40009134 | Duplicated SKU in the proposal listing models , additionalPurchases , complimentaries or selectComplimentaries |
40009135 | The first model SKU must correspond to the listing if you share the media between models |
40009136 | The image dimension must be 1000, 400, 250, 135 or 80 |
40009137 | The image must be square and the dimension must greater than or equal to the specified pixels |
40009138 | The image URL doesn’t belong to the listing |
40009139 | The width doesn’t match the original image |
40009140 | The proposal listing images/videos must be empty when there are models in the listing |
40009141 | The proposal listing models must be empty when there is no model in the listing |
40009142 | The SKU belongs to a complimentary group, cannot be adjusted directly |
40009143 | Product name for warehouse entry must be less than 50 words |
40009144 | Product images must be synchronized when there are models in the listing |
40009145 | Duplicated warehouse product name |
40009146 | Invalid NCC certification code |
40009184 | The product in the specified sub station could not be tax-free |
40009186 | The threshold freebie listing must be invisible |
40009187 | Cannot be a threshold freebie listing when there are 2 attributes in the proposal |
40009188 | The sub station hasn’t be granted the ship type permission |
40009195 | Missing required E-Voucher attribute |
40009196 | E-Voucher attribute value’s length not match the constraints |
40009197 | Invalid E-Voucher attribute name |
40009198 | E-Voucher attributes cannot be empty |
40009199 | E-Voucher type cannot be empty |
40009200 | Cannot be an E-Voucher listing when there isn’t no attribute in the proposal |
40009212 | Invalid product warranty productStatus |
40009225 | Brand ID cannot be empty when the review status isn’t composing |
40009226 | Brand ID must be pre-defined in brand data |
Unauthorized #
身分認證不通過,請檢查您的 Cookie
或 wssid
。
HTTP Status Code: 401
Error Code | Description |
---|---|
40100001 | Missing or bad authentication |
40100002 | Invalid cookie |
40100003 | Missing or bad authentication |
40100004 | Check wssid failed |
40100006 | Cookie has expired |
Forbidden #
權限驗證不通過,請確認您有權操作更新賣場屬性調整提案,且為您所提案的賣場的擁有者。
HTTP Status Code: 403
Error Code | Description |
---|---|
40304001 | No permission |
40309000 | The supplier hasn’t signed the sub station contract |
Unprocessable Entity #
提案單狀態驗證不通過,請確認提案單狀態。
HTTP Status Code: 422
Error Code | Description |
---|---|
42200001 | Create resource by PUT method is unsupported |
42209000 | Supports POST/PUT newListing, newProduct, updateCopy, newListingByApi, updateVideo, updateImageV2 and updateListingAttribute proposal type only currently |
42209001 | Supports POST/PUT composing, draft and pendingReview proposal review status only currently |
42209002 | Invalid state flow of proposal review status |
Too Many Requests #
提案單修改次數過多。
HTTP Status Code: 429
Error Code | Description |
---|---|
42900001 | Reach the maximum number of modification times |
Internal Server Error #
API 端發生錯誤,若持續發生請洽您的業務窗口。
HTTP Status Code: 500
Examples #
更新提案單: 76527 的新增一般賣場且審核狀態更新為 pendingReview
PUT /api/spa/v1/proposals/76527 HTTP/1.1
HOST: tw.supplier.yahoo.com
Content-Type: application/json; charset=UTF-8
{
"applicant": "申請人",
"product": {
"attributeDisplayMode": "table",
"attributes": [
{
"name": "中央處理器品牌",
"values": [
"Intel"
]
},
{
"name": "中央處理器型號",
"values": [
"G870"
]
},
{
"name": "型號",
"values": [
"Trey-Super-PC"
]
},
{
"name": "晶片組",
"values": [
"B75"
]
},
{
"name": "硬碟機容量",
"values": [
"250GB"
]
},
{
"name": "硬碟機轉速",
"values": [
"5400轉"
]
},
{
"name": "固態硬碟",
"values": [
"無"
]
},
{
"name": "光碟機",
"values": [
"無"
]
},
{
"name": "作業系統",
"values": [
"無"
]
},
{
"name": "記憶體容量(GB)",
"values": [
"2G"
]
},
{
"name": "記憶體類型",
"values": [
"DDR2"
]
},
{
"name": "記憶體工作頻率(MHz)",
"values": [
"333"
]
},
{
"name": "記憶體插槽數",
"values": [
"1"
]
},
{
"name": "記憶體最高支援容量",
"values": [
"2G以下"
]
},
{
"name": "顯示卡類型",
"values": [
"獨立顯卡"
]
},
{
"name": "螢幕尺吋",
"values": [
"無"
]
},
{
"name": "觸控",
"values": [
"無"
]
},
{
"name": "顯示晶片型號",
"values": [
"3dfx-voodoo-1"
]
},
{
"name": "顯示卡記憶體類型",
"values": [
"高速記憶體"
]
},
{
"name": "顯示卡記憶體容量(GB)",
"values": [
"12MB"
]
},
{
"name": "尺寸(長x寬x高)(mm)",
"values": [
"2400x900x30000"
]
},
{
"name": "區域網路",
"values": [
"64kbps"
]
},
{
"name": "原廠保固",
"values": [
"none"
]
},
{
"name": "音效",
"values": [
"mono"
]
},
{
"name": "前面板連接埠",
"values": [
"極致簡約沒有任何連接埠"
]
},
{
"name": "後面板連接埠",
"values": [
"只有電源插孔"
]
},
{
"name": "後面板視訊埠",
"values": [
"HDMI"
]
},
{
"name": "電源供應器瓦數(W)",
"values": [
"150kW"
]
},
{
"name": "重量(kg)",
"values": [
"27t"
]
}
],
"brandId": "41166484",
"catItemId": "catItem10070",
"contentRating": "G",
"cost": "50.00",
"isExpiringItem": true,
"isInstallRequired": true,
"isLargeVolumnProductGift": true,
"isNeedRecycle": true,
"isOutrightPurchase": true,
"minPackingCount": 10,
"models": [
{
"items": [
{
"partNo": "5566",
"barcode": "725272730706",
"warehouseBarcode": "9785109946480",
"spec": {
"name": "顏色",
"values": [
"卡其"
]
},
"displayName": "卡其色"
},
{
"partNo": "5567",
"spec": {
"name": "顏色",
"values": [
"灰色系"
]
},
"displayName": "灰色"
}
],
"videos": [
{
"url": "https://s.yimg.com/bp/Files/374d9974ab2cbce382e42724fede7aa07313cae6.qt",
"order": 1
}
],
"images": [
{
"url": "https://s.yimg.com/bp/Files/ba0b8bf005bab4e7cc8821afea217e342a1dfca3.png",
"order": 1
},
{
"url": "https://s.yimg.com/bp/Files/3b0bc05cf3c5af7cd17b878edce05eab7d0b97d0.jpg",
"order": 2
}
],
"spec": {
"name": "品牌",
"values": [
"Dell戴爾"
]
},
"displayName": "極致簡約Dell2019"
},
{
"spec": {
"name": "品牌",
"values": [
"hp惠普"
]
},
"items": [
{
"partNo": "5568",
"spec": {
"name": "顏色",
"values": [
"卡其"
]
},
"displayName": "卡其色"
},
{
"partNo": "5569",
"spec": {
"name": "顏色",
"values": [
"灰色系"
]
},
"displayName": "灰色"
}
],
"videos": [
{
"url": "https://s.yimg.com/bp/Files/374d9974ab2cbce382e42724fede7aa07313cae6.qt",
"order": 1
}
],
"images": [
{
"url": "https://s.yimg.com/bp/Files/945b996a1bada1ccb966b8b0215875447024324c.jpg",
"order": 1
},
{
"url": "https://s.yimg.com/zp/MerchandiseImages/e886d26980-Gd-9413860.jpg",
"order": 2
}
],
"displayName": "低調奢華hp讚"
}
],
"msrp": "100.00",
"name": "(即期品)我是商品名稱",
"partNo": "12345",
"shipType": {
"id": 61
},
"shortDescription": [
"我是簡短說明",
"我是簡短說明2"
],
"struDataAttrClusterId": "000003326689",
"warranty": {
"period": "一個月",
"description": "保固說明文字",
"handler": "official",
"scope": "新品瑕疵",
"productStatus": "new"
},
"copy": "<table width=\"100%\"><tbody><tr><td><p style=\"color:#000000;font-size:12pt;text-align:left;font-weight:100\">我是第1段標題</p></td></tr><tr><td><div align=\"left\"><img src=\"https://s.yimg.com/bp/Files/438ca02c84501c17070f6a5de2f25a52c4ce0f61.jpg\" style=\"height: auto; width: 650px; max-width: 650px;\"></div></td></tr><tr><td><p style=\"color:#000000;font-size:12pt;text-align:left\">我是描述</p></td></tr></tbody></table>",
"brand": "我是品牌",
"height": 77,
"length": 55,
"model": "我是商品型號",
"preserveDays": 56,
"weight": 88,
"width": 66
},
"reviewStatus": "pendingReview",
"subStationId": "sub1",
"type": "newListing",
"note": "我是備註",
"listing": {
"catItemId": "catItem10070",
"deliveryType": "appointment",
"featureTitle": "我是特色標題",
"price": "100.00",
"seoUrl": "我是商品名稱"
}
}
{
"applicant": "申請人",
"appliedTs": "2019-03-05T15:37:56+08:00",
"contactWindow": "contact-windows-id",
"createdTs": "2019-03-05T15:34:58+08:00",
"creator": "creator-Id",
"executeStatus": "idle",
"expiredTs": "2019-03-20T00:00:00+08:00",
"id": 76527,
"listing": {
"applyLowGpm": false,
"catId": "cat430",
"catItemId": "catItem10070",
"catItemName": "新迅馳Sonoma",
"catName": "加值功能NB推薦",
"cvsPurchaseQtyLimit": 1,
"deliveryType": "appointment",
"featureTitle": "我是特色標題",
"isDisplay": true,
"offShelvedTs": "2020-03-04T15:37:56+08:00",
"onShelvedTs": "2019-03-05T15:37:56+08:00",
"price": "100.00",
"purchaseQtyLimit": 12,
"seoUrl": "我是商品名稱",
"subStationId": "sub1",
"subStationName": "筆記型電腦超過十一個字test",
"zoneId": "z3",
"zoneName": "電腦 / 週邊 / 軟體"
},
"modifiedTimes": 2,
"modifiedTs": "2019-03-05T15:37:56+08:00",
"modifier": "mwu02",
"note": "我是備註",
"product": {
"attributeDisplayMode": "table",
"attributes": [
{
"name": "中央處理器品牌",
"values": [
"Intel"
]
},
{
"name": "中央處理器型號",
"values": [
"G870"
]
},
{
"name": "型號",
"values": [
"Trey-Super-PC"
]
},
{
"name": "晶片組",
"values": [
"B75"
]
},
{
"name": "硬碟機容量",
"values": [
"250GB"
]
},
{
"name": "硬碟機轉速",
"values": [
"5400轉"
]
},
{
"name": "固態硬碟",
"values": [
"無"
]
},
{
"name": "光碟機",
"values": [
"無"
]
},
{
"name": "作業系統",
"values": [
"無"
]
},
{
"name": "記憶體容量(GB)",
"values": [
"2G"
]
},
{
"name": "記憶體類型",
"values": [
"DDR2"
]
},
{
"name": "記憶體工作頻率(MHz)",
"values": [
"333"
]
},
{
"name": "記憶體插槽數",
"values": [
"1"
]
},
{
"name": "記憶體最高支援容量",
"values": [
"2G以下"
]
},
{
"name": "顯示卡類型",
"values": [
"獨立顯卡"
]
},
{
"name": "螢幕尺吋",
"values": [
"無"
]
},
{
"name": "觸控",
"values": [
"無"
]
},
{
"name": "顯示晶片型號",
"values": [
"3dfx-voodoo-1"
]
},
{
"name": "顯示卡記憶體類型",
"values": [
"高速記憶體"
]
},
{
"name": "顯示卡記憶體容量(GB)",
"values": [
"12MB"
]
},
{
"name": "尺寸(長x寬x高)(mm)",
"values": [
"2400x900x30000"
]
},
{
"name": "區域網路",
"values": [
"64kbps"
]
},
{
"name": "原廠保固",
"values": [
"none"
]
},
{
"name": "音效",
"values": [
"mono"
]
},
{
"name": "前面板連接埠",
"values": [
"極致簡約沒有任何連接埠"
]
},
{
"name": "後面板連接埠",
"values": [
"只有電源插孔"
]
},
{
"name": "後面板視訊埠",
"values": [
"HDMI"
]
},
{
"name": "電源供應器瓦數(W)",
"values": [
"150kW"
]
},
{
"name": "重量(kg)",
"values": [
"27t"
]
}
],
"brand": "我是品牌",
"brandId": "41166484",
"brandName": "2M2",
"catId": "cat430",
"catItemId": "catItem10070",
"catItemName": "新迅馳Sonoma",
"catName": "加值功能NB推薦",
"contentRating": "G",
"copy": "<table width=\"100%\">\n <tbody>\n <tr>\n <td><p style=\"color:#000000;font-size:12pt;text-align:left;font-weight:100\">我是第1段標題</p></td>\n </tr>\n <tr>\n <td>\n <div align=\"left\">\n <img src=\"https://s.yimg.com/bp/Files/438ca02c84501c17070f6a5de2f25a52c4ce0f61.jpg\" style=\"height: auto; width: 650px; max-width: 650px;\">\n </div></td>\n </tr>\n <tr>\n <td><p style=\"color:#000000;font-size:12pt;text-align:left\">我是描述</p></td>\n </tr>\n </tbody>\n</table>",
"cost": "50.00",
"height": 77,
"isExpiringItem": true,
"isInstallRequired": true,
"isLargeVolumnProductGift": true,
"isNeedRecycle": true,
"isOutrightPurchase": true,
"length": 55,
"minPackingCount": 10,
"model": "我是商品型號",
"models": [
{
"displayName": "極致簡約Dell2019",
"images": [
{
"height": 1000,
"order": 1,
"url": "https://s.yimg.com/cl/api/res/1.2/kJ4Ky2.DoD4nLYOGFTqXTA--/YXBwaWQ9dHdzcG1hbGw7dz0xMDAwO2g9MTAwMA--/https://s.yimg.com/bp/Files/ba0b8bf005bab4e7cc8821afea217e342a1dfca3.png.cf.jpg",
"width": 1000
},
{
"height": 400,
"order": 1,
"url": "https://s.yimg.com/cl/api/res/1.2/2HOPhPCqFkyRlFFLB8CfPA--/YXBwaWQ9dHdzcG1hbGw7dz00MDA7aD00MDA-/https://s.yimg.com/bp/Files/ba0b8bf005bab4e7cc8821afea217e342a1dfca3.png.cf.jpg",
"width": 400
},
{
"height": 250,
"order": 1,
"url": "https://s.yimg.com/cl/api/res/1.2/E1bLiYjDz.y2HapecwWuuA--/YXBwaWQ9dHdzcG1hbGw7dz0yNTA7aD0yNTA-/https://s.yimg.com/bp/Files/ba0b8bf005bab4e7cc8821afea217e342a1dfca3.png.cf.jpg",
"width": 250
},
{
"height": 135,
"order": 1,
"url": "https://s.yimg.com/cl/api/res/1.2/hXTTZZzlR_4dZQzRes8jvA--/YXBwaWQ9dHdzcG1hbGw7dz0xMzU7aD0xMzU-/https://s.yimg.com/bp/Files/ba0b8bf005bab4e7cc8821afea217e342a1dfca3.png.cf.jpg",
"width": 135
},
{
"height": 80,
"order": 1,
"url": "https://s.yimg.com/cl/api/res/1.2/2sA9R61mn7u247ThP5oLZg--/YXBwaWQ9dHdzcG1hbGw7dz04MDtoPTgw/https://s.yimg.com/bp/Files/ba0b8bf005bab4e7cc8821afea217e342a1dfca3.png.cf.jpg",
"width": 80
},
{
"height": 1000,
"order": 2,
"url": "https://s.yimg.com/cl/api/res/1.2/Sbb2nlG7hogM7ZvZWLjeSg--/YXBwaWQ9dHdzcG1hbGw7dz0xMDAwO2g9MTAwMA--/https://s.yimg.com/bp/Files/3b0bc05cf3c5af7cd17b878edce05eab7d0b97d0.jpg.cf.jpg",
"width": 1000
},
{
"height": 400,
"order": 2,
"url": "https://s.yimg.com/cl/api/res/1.2/VoPZQZRgpO0r9QA14r.J3w--/YXBwaWQ9dHdzcG1hbGw7dz00MDA7aD00MDA-/https://s.yimg.com/bp/Files/3b0bc05cf3c5af7cd17b878edce05eab7d0b97d0.jpg.cf.jpg",
"width": 400
},
{
"height": 250,
"order": 2,
"url": "https://s.yimg.com/cl/api/res/1.2/TV3WuVDlY2mALfaRSG4gJg--/YXBwaWQ9dHdzcG1hbGw7dz0yNTA7aD0yNTA-/https://s.yimg.com/bp/Files/3b0bc05cf3c5af7cd17b878edce05eab7d0b97d0.jpg.cf.jpg",
"width": 250
},
{
"height": 135,
"order": 2,
"url": "https://s.yimg.com/cl/api/res/1.2/gMiKlCD0nMaVE7OWhXaC_w--/YXBwaWQ9dHdzcG1hbGw7dz0xMzU7aD0xMzU-/https://s.yimg.com/bp/Files/3b0bc05cf3c5af7cd17b878edce05eab7d0b97d0.jpg.cf.jpg",
"width": 135
},
{
"height": 80,
"order": 2,
"url": "https://s.yimg.com/cl/api/res/1.2/Z8J5QCrRyGe3vr.ZCTpS1g--/YXBwaWQ9dHdzcG1hbGw7dz04MDtoPTgw/https://s.yimg.com/bp/Files/3b0bc05cf3c5af7cd17b878edce05eab7d0b97d0.jpg.cf.jpg",
"width": 80
}
],
"items": [
{
"barcode": "725272730706",
"displayName": "卡其色",
"partNo": "5566",
"spec": {
"name": "顏色",
"values": [
"卡其"
]
},
"stock": 0,
"warehouseBarcode": "9785109946480",
"warehouseProductName": "(即期品)我是商品名稱-極致簡約Dell2019-卡其色"
},
{
"displayName": "灰色",
"partNo": "5567",
"spec": {
"name": "顏色",
"values": [
"灰色系"
]
},
"stock": 0,
"warehouseProductName": "(即期品)我是商品名稱-極致簡約Dell2019-灰色"
}
],
"spec": {
"name": "品牌",
"values": [
"Dell戴爾"
]
},
"videos": [
{
"order": 1,
"url": "https://s.yimg.com/bp/Files/374d9974ab2cbce382e42724fede7aa07313cae6.qt"
}
]
},
{
"displayName": "低調奢華hp讚",
"images": [
{
"height": 1000,
"order": 1,
"url": "https://s.yimg.com/cl/api/res/1.2/uya1s18B8jL0Dg7yN5C3xg--/YXBwaWQ9dHdzcG1hbGw7dz0xMDAwO2g9MTAwMA--/https://s.yimg.com/bp/Files/945b996a1bada1ccb966b8b0215875447024324c.jpg.cf.jpg",
"width": 1000
},
{
"height": 400,
"order": 1,
"url": "https://s.yimg.com/cl/api/res/1.2/1MoK56czcApqZcNIfPNCLw--/YXBwaWQ9dHdzcG1hbGw7dz00MDA7aD00MDA-/https://s.yimg.com/bp/Files/945b996a1bada1ccb966b8b0215875447024324c.jpg.cf.jpg",
"width": 400
},
{
"height": 250,
"order": 1,
"url": "https://s.yimg.com/cl/api/res/1.2/cKy9xhin4MKGqFIKEHp86Q--/YXBwaWQ9dHdzcG1hbGw7dz0yNTA7aD0yNTA-/https://s.yimg.com/bp/Files/945b996a1bada1ccb966b8b0215875447024324c.jpg.cf.jpg",
"width": 250
},
{
"height": 135,
"order": 1,
"url": "https://s.yimg.com/cl/api/res/1.2/7olgICbNuYEbDxp1GD8aIw--/YXBwaWQ9dHdzcG1hbGw7dz0xMzU7aD0xMzU-/https://s.yimg.com/bp/Files/945b996a1bada1ccb966b8b0215875447024324c.jpg.cf.jpg",
"width": 135
},
{
"height": 80,
"order": 1,
"url": "https://s.yimg.com/cl/api/res/1.2/4kce4XnvtfQsa4mtwLWJHg--/YXBwaWQ9dHdzcG1hbGw7dz04MDtoPTgw/https://s.yimg.com/bp/Files/945b996a1bada1ccb966b8b0215875447024324c.jpg.cf.jpg",
"width": 80
},
{
"height": 1000,
"order": 2,
"url": "https://s.yimg.com/cl/api/res/1.2/rn0UVm7EbURJfMwdhTAZzw--/YXBwaWQ9dHdzcG1hbGw7dz0xMDAwO2g9MTAwMA--/https://s.yimg.com/mm/Files/404603c25b19d075109b44255707b89d49b96347_1000x1000.jpg.cf.jpg",
"width": 1000
},
{
"height": 400,
"order": 2,
"url": "https://s.yimg.com/cl/api/res/1.2/oF0TcLQYzmhyasPmptwMJg--/YXBwaWQ9dHdzcG1hbGw7dz00MDA7aD00MDA-/https://s.yimg.com/mm/Files/404603c25b19d075109b44255707b89d49b96347_1000x1000.jpg.cf.jpg",
"width": 400
},
{
"height": 250,
"order": 2,
"url": "https://s.yimg.com/cl/api/res/1.2/.khlxRR.bvyubEJo2KztkQ--/YXBwaWQ9dHdzcG1hbGw7dz0yNTA7aD0yNTA-/https://s.yimg.com/mm/Files/404603c25b19d075109b44255707b89d49b96347_1000x1000.jpg.cf.jpg",
"width": 250
},
{
"height": 135,
"order": 2,
"url": "https://s.yimg.com/cl/api/res/1.2/F0BjdKuJZNCesGr6K9ySMA--/YXBwaWQ9dHdzcG1hbGw7dz0xMzU7aD0xMzU-/https://s.yimg.com/mm/Files/404603c25b19d075109b44255707b89d49b96347_1000x1000.jpg.cf.jpg",
"width": 135
},
{
"height": 80,
"order": 2,
"url": "https://s.yimg.com/cl/api/res/1.2/sPuDvt1rQAiW6SnQEH.WsQ--/YXBwaWQ9dHdzcG1hbGw7dz04MDtoPTgw/https://s.yimg.com/mm/Files/404603c25b19d075109b44255707b89d49b96347_1000x1000.jpg.cf.jpg",
"width": 80
}
],
"items": [
{
"displayName": "卡其色",
"partNo": "5568",
"spec": {
"name": "顏色",
"values": [
"卡其"
]
},
"stock": 0,
"warehouseProductName": "(即期品)我是商品名稱-低調奢華hp讚-卡其色"
},
{
"displayName": "灰色",
"partNo": "5569",
"spec": {
"name": "顏色",
"values": [
"灰色系"
]
},
"stock": 0,
"warehouseProductName": "(即期品)我是商品名稱-低調奢華hp讚-灰色"
}
],
"spec": {
"name": "品牌",
"values": [
"hp惠普"
]
},
"videos": [
{
"order": 1,
"url": "https://s.yimg.com/bp/Files/374d9974ab2cbce382e42724fede7aa07313cae6.qt"
}
]
}
],
"msrp": "100.00",
"name": "(即期品)我是商品名稱",
"partNo": "12345",
"preserveDays": 56,
"safeStockQty": 1,
"shareMediaBetweenModels": false,
"shipType": {
"id": 61,
"name": "Express24HR"
},
"shortDescription": [
"我是簡短說明",
"我是簡短說明2"
],
"specs": [
{
"level": 1,
"name": "品牌"
},
{
"level": 2,
"name": "顏色"
}
],
"struDataAttrClusterId": "000003326689",
"struDataAttrClusterName": "品牌桌上型電腦",
"subStationId": "sub1",
"subStationName": "筆記型電腦超過十一個字test",
"warranty": {
"description": "保固說明文字",
"handler": "official",
"period": "一個月",
"scope": "新品瑕疵",
"productStatus": "new"
},
"weight": 88,
"width": 66,
"zoneId": "z3",
"zoneName": "電腦 / 週邊 / 軟體"
},
"reviewStatus": "pendingReview",
"subStationId": "sub1",
"subStationName": "筆記型電腦超過十一個字test",
"supplierId": 99999,
"supplierName": "雅虎測試",
"type": "newListing"
}
更新提案單: 779042 的新增電子票券賣場且 eVoucherAttributes.OrderNumber 更新為 2
PUT /api/spa/v1/proposals/779042 HTTP/1.1
HOST: tw.supplier.yahoo.com
Content-Type: application/json; charset=UTF-8
{
"applicant": "申請人",
"listing": {
"catItemId": "catItem49297",
"featureTitle": "test2023",
"price": "500.00",
"seoUrl": "test2023"
},
"product": {
"eVoucherAttributes": [
{
"name": "OrderNumber",
"value": "2"
},
{
"name": "ProductCode",
"value": "2022-12-19T11:17:00Z"
},
{
"name": "MerchantCode",
"value": "文字測試"
}
],
"eVoucherType": "ticket",
"attributeDisplayMode": "list",
"attributes": [
{
"name": "品牌",
"values": [
"樂扣樂扣"
]
},
{
"name": "用途",
"values": [
"收納箱"
]
},
{
"name": "材質",
"values": [
"塑料"
]
},
{
"name": "防潮",
"values": [
"有"
]
},
{
"name": "收納方式",
"values": [
"裝箱"
]
},
{
"name": "適用地點",
"values": [
"廚房"
]
},
{
"name": "長(公分)",
"values": [
"10"
]
},
{
"name": "寬(公分)",
"values": [
"10"
]
},
{
"name": "高(公分)",
"values": [
"10"
]
},
{
"name": "重量",
"values": [
"10"
]
}
],
"brandId": "41166484",
"catItemId": "catItem49297",
"contentRating": "None",
"copy": "<p>10</p>",
"cost": "100.00",
"isNeedRecycle": false,
"models": [
{
"images": [
{
"order": 1,
"url": "https://s.yimg.com/cl/api/res/1.2/Q5jKWlqx3MCYNv3INuLpig--/YXBwaWQ9dHdzcG1hbGw7dz0xMDAwO2g9MTAwMA--/https://s.yimg.com/bp/Files/22e7359a4bd872db3e7c32d5e1ac1099a9ddf2b6_1000x1000.jpg.cf.jpg"
},
{
"order": 2,
"url": "https://s.yimg.com/cl/api/res/1.2/YFV9LsRbFGmMQLtE2oQ1Zw--/YXBwaWQ9dHdzcG1hbGw7dz0xMDAwO2g9MTAwMA--/https://s.yimg.com/bp/Files/52ee4bccf94091df06c9f37ad6fda7371565950e_1000x1000.jpg.cf.jpg"
}
],
"items": [
{
"stock": 0
}
]
}
],
"msrp": "800.00",
"name": "test2023",
"shipType": {
"id": 200,
"model": 150
},
"shortDescription": [
"test2023"
],
"struDataAttrClusterId": "000003326551",
"warranty": {
"handler": "none",
"period": "無保固",
"scope": "無保固",
"productStatus": "new"
}
},
"reviewStatus": "draft",
"subStationId": "sub1",
"type": "newListing"
}
{
"applicant": "申請人",
"applicantRole": "supplier",
"contactWindow": "jennylu11",
"createdTs": "2023-02-22T08:39:14Z",
"creator": "creator-Id",
"executeStatus": "idle",
"expiredTs": "2023-02-27T16:00:00Z",
"id": 779042,
"listing": {
"applyLowGpm": false,
"catId": "cat6052",
"catItemId": "catItem49297",
"catItemName": "測試子類",
"catName": "測試父類,請勿購買",
"cvsPurchaseQtyLimit": 1,
"deliveryType": "normal",
"discount": {
"activity": [
"actPromo",
"redeemFdbk",
"redGreen"
],
"site": [
"shopping",
"enterprise",
"app"
],
"targetMember": [
"general",
"enterprise",
"specific"
],
"tools": [
"redeemPoint",
"welfarePoint",
"rewardPoint",
"coupon"
]
},
"displayOrder": 1000,
"featureTitle": "test2023",
"isDisplay": true,
"isThresholdFreebie": false,
"offShelvedTs": "2024-01-09T06:51:59Z",
"onShelvedTs": "2023-01-09T06:51:00Z",
"price": "500.00",
"purchaseQtyLimit": 12,
"seoUrl": "test2023",
"shareMediaBetweenModels": false,
"subStationId": "sub1",
"subStationName": "筆記型電腦超過十一個字test2",
"syncProductImages": true,
"zoneId": "z3",
"zoneName": "電腦 / 週邊 / 軟體"
},
"modifiedTimes": 2,
"modifiedTs": "2023-02-22T08:39:50Z",
"modifier": "creator-Id",
"product": {
"eVoucherAttributes": [
{
"dataType": "integer",
"name": "OrderNumber",
"value": "2"
},
{
"dataType": "datetime",
"name": "ProductCode",
"value": "2022-12-19T11:17:00Z"
},
{
"dataType": "string",
"name": "MerchantCode",
"value": "文字測試"
}
],
"eVoucherType": "ticket",
"attributeDisplayMode": "list",
"attributes": [
{
"name": "品牌",
"values": [
"樂扣樂扣"
]
},
{
"name": "用途",
"values": [
"收納箱"
]
},
{
"name": "材質",
"values": [
"塑料"
]
},
{
"name": "防潮",
"values": [
"有"
]
},
{
"name": "收納方式",
"values": [
"裝箱"
]
},
{
"name": "適用地點",
"values": [
"廚房"
]
},
{
"name": "長(公分)",
"values": [
"10"
]
},
{
"name": "寬(公分)",
"values": [
"10"
]
},
{
"name": "高(公分)",
"values": [
"10"
]
},
{
"name": "重量",
"values": [
"10"
]
}
],
"autoReplenishment": true,
"brandId": "41166484",
"brandName": "2M2",
"catId": "cat6052",
"catItemId": "catItem49297",
"catItemName": "測試子類",
"catName": "測試父類,請勿購買",
"contentRating": "None",
"copy": "<p>10</p>",
"cost": "100.00",
"isExpiringItem": false,
"isInstallRequired": false,
"isLargeVolumnProductGift": false,
"isNeedRecycle": false,
"isOutrightPurchase": false,
"minPackingCount": 1,
"models": [
{
"images": [
{
"height": 1000,
"order": 1,
"url": "https://s.yimg.com/cl/api/res/1.2/Q5jKWlqx3MCYNv3INuLpig--/YXBwaWQ9dHdzcG1hbGw7dz0xMDAwO2g9MTAwMA--/https://s.yimg.com/bp/Files/22e7359a4bd872db3e7c32d5e1ac1099a9ddf2b6_1000x1000.jpg.cf.jpg",
"width": 1000
},
{
"height": 400,
"order": 1,
"url": "https://s.yimg.com/cl/api/res/1.2/7K3mjtfGuE7elvZrRRuEPA--/YXBwaWQ9dHdzcG1hbGw7dz00MDA7aD00MDA-/https://s.yimg.com/bp/Files/22e7359a4bd872db3e7c32d5e1ac1099a9ddf2b6_1000x1000.jpg.cf.jpg",
"width": 400
},
{
"height": 250,
"order": 1,
"url": "https://s.yimg.com/cl/api/res/1.2/I3L8MCu_X5JrJwZ3lrakiw--/YXBwaWQ9dHdzcG1hbGw7dz0yNTA7aD0yNTA-/https://s.yimg.com/bp/Files/22e7359a4bd872db3e7c32d5e1ac1099a9ddf2b6_1000x1000.jpg.cf.jpg",
"width": 250
},
{
"height": 135,
"order": 1,
"url": "https://s.yimg.com/cl/api/res/1.2/feSXFH.JpZk.32OVMu3PVA--/YXBwaWQ9dHdzcG1hbGw7dz0xMzU7aD0xMzU-/https://s.yimg.com/bp/Files/22e7359a4bd872db3e7c32d5e1ac1099a9ddf2b6_1000x1000.jpg.cf.jpg",
"width": 135
},
{
"height": 80,
"order": 1,
"url": "https://s.yimg.com/cl/api/res/1.2/1qM6Ux9TPfNBrJ9q3njFFw--/YXBwaWQ9dHdzcG1hbGw7dz04MDtoPTgw/https://s.yimg.com/bp/Files/22e7359a4bd872db3e7c32d5e1ac1099a9ddf2b6_1000x1000.jpg.cf.jpg",
"width": 80
},
{
"height": 1000,
"order": 2,
"url": "https://s.yimg.com/cl/api/res/1.2/YFV9LsRbFGmMQLtE2oQ1Zw--/YXBwaWQ9dHdzcG1hbGw7dz0xMDAwO2g9MTAwMA--/https://s.yimg.com/bp/Files/52ee4bccf94091df06c9f37ad6fda7371565950e_1000x1000.jpg.cf.jpg",
"width": 1000
},
{
"height": 400,
"order": 2,
"url": "ttps://s.yimg.com/cl/api/res/1.2/5f3GlF7sDbvNXcVWHIT2uA--/YXBwaWQ9dHdzcG1hbGw7dz00MDA7aD00MDA-/https://s.yimg.com/bp/Files/52ee4bccf94091df06c9f37ad6fda7371565950e_1000x1000.jpg.cf.jpg",
"width": 400
},
{
"height": 250,
"order": 2,
"url": "https://s.yimg.com/cl/api/res/1.2/FURStPI8vb9aUIql8weNMA--/YXBwaWQ9dHdzcG1hbGw7dz0yNTA7aD0yNTA-/https://s.yimg.com/bp/Files/52ee4bccf94091df06c9f37ad6fda7371565950e_1000x1000.jpg.cf.jpg",
"width": 250
},
{
"height": 135,
"order": 2,
"url": "https://s.yimg.com/cl/api/res/1.2/emqEjsumXfwxEZafPGJ2eQ--/YXBwaWQ9dHdzcG1hbGw7dz0xMzU7aD0xMzU-/https://s.yimg.com/bp/Files/52ee4bccf94091df06c9f37ad6fda7371565950e_1000x1000.jpg.cf.jpg",
"width": 135
},
{
"height": 80,
"order": 2,
"url": "https://s.yimg.com/cl/api/res/1.2/ysDS1cEcOf3t3dpgs_vLXQ--/YXBwaWQ9dHdzcG1hbGw7dz04MDtoPTgw/https://s.yimg.com/bp/Files/52ee4bccf94091df06c9f37ad6fda7371565950e_1000x1000.jpg.cf.jpg",
"width": 80
}
],
"items": [
{
"stock": 0,
"warehouseProductName": "test2023"
}
]
}
],
"msrp": "800.00",
"name": "test2023",
"safeStockQty": 1,
"shareMediaBetweenModels": false,
"shipType": {
"id": 200,
"model": 150,
"name": "EVoucher"
},
"shortDescription": [
"test2023"
],
"struDataAttrClusterId": "000003326551",
"struDataAttrClusterName": "收納",
"subStationId": "sub1",
"subStationName": "筆記型電腦超過十一個字test2",
"taxable": true,
"warranty": {
"handler": "none",
"period": "無保固",
"scope": "無保固",
"productStatus": "new"
},
"zoneId": "z3",
"zoneName": "電腦 / 週邊 / 軟體"
},
"reviewStatus": "draft",
"subStationId": "sub1",
"subStationName": "筆記型電腦超過十一個字test2",
"supplierId": 99999,
"supplierName": "興奇雅虎測試",
"type": "newListing",
"version": 2
}