賣場屬性調整提案 #
新增賣場屬性調整提案單 #
新增 賣場屬性調整提案單
。
Endpoint URL: https://tw.supplier.yahoo.com/api/spa/v1/proposal/updateListingModels
HTTP Method: POST
Request Body #
listing #
賣場資訊,賣場 ID 為必填。
資料型態: ProposalListing
必填: 是
models #
賣場屬性的內容,包含既有的屬性與更新的屬性,提案內容為賣場最後呈現的屬性內容
。models 的結構分別說明如下:
-
sku:第 1 層屬性的商品編號
- 調整的賣場結構為無屬性調整為單層賣場:若為新增商品時,此欄位不需填寫,反之需完整的填寫
sku
與spec
- 調整的賣場結構為單層屬性:若為新增商品時,此欄位不需填寫,反之需完整的填寫
sku
與spec
- 調整的賣場結構為雙層屬性:
- 若第 1 層屬性項目不存在原賣場中,輸入
spec
說明更新後的第 1 層屬性名稱與項目 - 若第 1 層屬性項目已既存於賣場中,由此欄位說明欲調整的屬性,API 將自動帶入該 SKU 的屬性名稱與項目
- 若第 1 層屬性項目不存在原賣場中,輸入
- 若為新增商品時,此欄將於提案執行完成後由 API 自動產生
- 調整的賣場結構為無屬性調整為單層賣場:若為新增商品時,此欄位不需填寫,反之需完整的填寫
-
spec:第 1 層屬性的名稱與項目
- 調整的賣場結構為無屬性調整為單層賣場:需完整的填寫
sku
與spec
- 調整的賣場結構為單層屬性:需完整的填寫
sku
與spec
- 調整的賣場結構為雙層屬性:
- 若第 1 層屬性項目不存在原賣場中,由此欄位說明屬性的名稱與項目
- 若第 1 層屬性項目已既存於賣場中,只需輸入
sku
說明欲調整的屬性,API 將自動帶入該 SKU 的屬性名稱與項目。若同時輸入sku
與spec
,將以提案輸入的spec
更新成該 SKU 的屬性名稱與項目
- 調整的賣場結構為無屬性調整為單層賣場:需完整的填寫
-
items:第 2 層屬性
- 若欲調整的賣場結構為雙層屬性,此欄需填寫第 2 層屬性
- 資料型態: ProposalItem[]
ProposalItem
-
id:第 2 層屬性的商品編號
- 若為新增商品時,此欄位不需填寫,反之需完整的填寫
sku
與spec
- 若為新增商品時,此欄將於提案執行完成後由 API 自動產生
- 若為新增商品時,此欄位不需填寫,反之需完整的填寫
-
spec:第 2 層屬性的名稱與項目
- 此欄位必填
-
isVisible:第 2 層屬性是否顯示於前台賣場
-
images:第 2 層屬性項目的商品圖
- 欲新增商品時,此欄可填
- 新增商品至既有的第 1 層屬性下:此欄位不需填寫,將由 API 自動帶入第 1 層屬性商品圖片
- 新增商品至新增的第 1 層屬性下:此欄位必填
- 欲新增商品時,此欄可填
-
attributes:第 2 層屬性項目的規格表屬性
- 僅供於調整雙層賣場
- 規格表項目僅需包含和屬性名稱相同之項目(即 ProposalModel 和 ProposalItem 之
spec.name
) values
內容需為 GET v1/struDataAttrClusters 取回的內容 (即 StruDataAttrCluster 中的 attributes)- 倘若需修改賣場頁顯示的屬性名稱,可透過
spec.selectedValue
做調整 - 若於調整屬性提案內新增商品,則此欄填寫商品規格表,且為必填
- 欲調整屬性項目規格表時,則此欄位填寫屬性項目規格表,若未填寫將由 API 自動帶入既有屬性項目規格表
-
barcode:第 2 層屬性項目的實際國際條碼
- 欲新增商品時,此欄可填
-
stock:第 2 層屬性項目的備貨數量
- 欲新增商品時,此欄可填
-
partNo:第 2 層屬性項目的商品料號
- 欲新增商品時,此欄可填
-
name:第 2 層屬性項目的商品名稱
- 僅供於調整雙層賣場
- 若於調整屬性提案內新增商品,若未填寫將由 API 自動建立屬性商品名稱
{賣場名稱}-{第一層屬性顯示名稱}-{第二層屬性顯示名稱}
- 欲調整屬性商品名稱時,則此欄位填寫屬性商品名稱,若未填寫將由 API 自動帶入既有屬性商品名稱
-
-
isVisible:第 1 層屬性是否顯示於前台賣場
-
images:第 1 層屬性項目的商品圖
- 欲新增商品時,此欄可填
- 共用商品圖賣場:此欄位不需填寫,將由 API 自動帶入賣場圖片
- 非共用商品圖賣場:此欄位必填
- 欲新增商品時,此欄可填
-
attributes:第 1 層屬性項目的規格表屬性
- 僅供於調整單層賣場
- 規格表項目僅需包含和屬性名稱相同之項目(即 ProposalModel 之
spec.name
) values
內容需為 GET v1/struDataAttrClusters 取回的內容 (即 StruDataAttrCluster 中的 attributes)- 倘若需修改賣場頁顯示的屬性名稱,可透過
spec.selectedValue
做調整 - 若於調整屬性提案內新增商品,則此欄填寫商品規格表,且為必填
- 欲調整屬性項目規格表時,則此欄位填寫屬性項目規格表,若未填寫將由 API 自動帶入既有屬性項目規格表
-
barcode:第 1 層屬性項目的實際國際條碼
- 欲新增商品時,此欄可填
-
stock:第 1 層屬性項目的備貨數量
- 欲新增商品時,此欄可填
-
partNo:第 1 層屬性項目的商品料號
- 欲新增商品時,此欄可填
-
name:第 1 層屬性項目的商品名稱
- 僅供於調整單層賣場
- 若於調整屬性提案內新增商品,若未填寫將由 API 自動建立屬性商品名稱
{賣場名稱}-{第一層屬性顯示名稱}
- 欲調整屬性商品名稱時,則此欄位填寫屬性商品名稱,若未填寫將由 API 自動帶入既有屬性商品名稱
資料型態: ProposalModel[]
必填: 是
applicant #
提案人。
資料型態: String
必填: 是
長度限制: 最長 10 個字
格式: 繁/簡體中文
complimentary #
- models
買就送贈品的內容。 贈品的結構可分為有屬性贈品
與無屬性贈品
,分別說明如下:- 無屬性贈品
- sku:贈品商品編號
- spec:
- name:贈品分類名稱。若原賣場存在既有買就送贈品分類,將由 API 自動帶入贈品分類名稱,反之將由 API 自動產生
- selectedValue:贈品顯示名稱
- shortTitle: 贈品短標題
- 有屬性贈品
- sku:贈品屬性商品編號。若為新增買就送贈品屬性時,此欄位不需填寫將由 API 自動產生,反之需填寫欲調整的賣場買就送贈品屬性商品編號
- spec:
- name:贈品分類名稱。若原賣場存在既有買就送贈品分類,將由 API 自動帶入贈品分類名稱,反之將由 API 自動產生
- selectedValue:贈品顯示名稱
- items:
- sku:贈品商品編號
- spec:
- name:贈品屬性項目名稱,此欄位由 API 自動產生
- selectedValue:贈品屬性項目顯示名稱
- shortTitle: 贈品短標題
- shortTitle:贈品短標題。此欄位不需填寫,將由 API 自動帶入第一個贈品屬性項目之短標題
- 無屬性贈品
資料型態: ProposalComplimentary
selectComplimentary #
- selectedMinQty:任選贈品的必選數量
- models
任選贈品的內容。 贈品的結構可分為有屬性贈品
與無屬性贈品
,分別說明如下:- 無屬性贈品
- sku:贈品商品編號
- spec:
- name:贈品分類名稱。若原賣場存在既有任選贈品分類,將由 API 自動帶入贈品分類名稱,反之將由 API 自動產生
- selectedValue:贈品顯示名稱
- shortTitle: 贈品短標題
- 有屬性贈品
- sku:贈品屬性商品編號。若為新增任選贈品屬性時,此欄位不需填寫將由 API 自動產生,反之需填寫欲調整的賣場任選贈品屬性商品編號
- spec:
- name:贈品分類名稱。若原賣場存在既有任選贈品分類,將由 API 自動帶入贈品分類名稱,反之將由 API 自動產生
- selectedValue:贈品顯示名稱
- items:
- sku:贈品商品編號
- spec:
- name:贈品屬性項目名稱,此欄位由 API 自動產生
- selectedValue:贈品屬性項目顯示名稱
- shortTitle: 贈品短標題
- shortTitle:贈品短標題。此欄位不需填寫,將由 API 自動帶入第一個贈品屬性項目之短標題
- 無屬性贈品
資料型態: ProposalComplimentary
additionalPurchases #
加價購的內容。
- sku:加價購商品編號
- spec:
- name:加價購分類名稱。若原賣場存在既有加價購分類,將由 API 自動帶入加價購分類名稱,反之將由 API 自動產生
- selectedValue:加價購顯示名稱
- price:加價購商品售價
資料型態: ProposalModel[]
Request/Response Syntax #
POST /api/spa/v1/proposal/updateListingModels
{
"applicant": string,
"listing": {
"id": number
},
"models": [
{
"spec": {
"name": string,
"selectedValue": string
},
"sku": number,
"items": [
{
"id": number,
"spec": {
"name": string,
"selectedValue": string
},
"isVisible": boolean,
"images": [
{
"order": number,
"url": string
}
],
"name": string,
"attributes": [
{
"name": string,
"values": [
string
]
}
],
"partNo": string,
"barcode": string,
"stock": number
}
],
"isVisible": boolean,
"images": [
{
"order": number,
"url": string
}
],
"name": string,
"attributes": [
{
"name": string,
"values": [
string
]
}
],
"partNo": string,
"barcode": string,
"stock": number
}
],
"complimentary": {
"models": [
{
"sku": number,
"spec": {
"selectedValue": string
},
"items": [
{
"sku": number,
"spec": {
"selectedValue": string
},
"shortTitle": string
}
],
"shortTitle": string
}
]
},
"selectComplimentary": {
"selectedMinQty": number,
"models": [
{
"sku": number,
"spec": {
"selectedValue": string
},
"items": [
{
"sku": number,
"spec": {
"selectedValue": string
},
"shortTitle": string
}
],
"shortTitle": string
}
]
},
"additionalPurchases": [
{
"sku": number,
"spec": {
"selectedValue": string
},
"price": string
}
]
}
{
"applicant": string,
"contactWindow": string,
"creator": string,
"createdTs": string,
"executeStatus": string,
"executedTs": string,
"expiredTs": string,
"modifiedTimes": number,
"modifiedTs": string,
"modifier": string,
"reviewStatus": string,
"supplierId": number,
"note": string,
"suggestion": string,
"id": number,
"listing": {
"id": number,
"origLayer": number
},
"models": [
{
"spec": {
"name": string,
"selectedValue": string
},
"sku": number,
"items": [
{
"id": number,
"sku": number,
"spec": {
"name": string,
"selectedValue": string
},
"isVisible": boolean,
"images": [
{
"order": number,
"url": string
}
],
"attributes": [
{
"name": string,
"values": [
string
]
}
],
"partNo": string,
"barcode": string,
"stock": number,
"name": string
}
],
"isVisible": boolean,
"images": [
{
"order": number,
"url": string
}
],
"attributes": [
{
"name": string,
"values": [
string
]
}
],
"partNo": string,
"barcode": string,
"stock": number,
"name": string
}
],
"complimentary": {
"models": [
{
"items": [
{
"id": number,
"sku": number,
"spec": {
"name": string,
"selectedValue": string
},
"shortTitle": string
}
],
"sku": number,
"spec": {
"name": string,
"selectedValue": string
},
"shortTitle": string
}
]
},
"selectComplimentary": {
"selectedMinQty": number,
"models": [
{
"items": [
{
"id": number,
"sku": number,
"spec": {
"name": string,
"selectedValue": string
},
"shortTitle": string
}
],
"sku": number,
"spec": {
"name": string,
"selectedValue": string
},
"shortTitle": string
}
]
},
"additionalPurchases": [
{
"sku": number,
"spec": {
"name": string,
"selectedValue": string
},
"price": string
}
],
"diff": {
"added": [
{
"spec": {
"name": string,
"selectedValue": string
},
"sku": number,
"items": [
{
"id": number,
"sku": number,
"spec": {
"name": string,
"selectedValue": string
},
"isVisible": boolean,
"images": [
{
"order": number,
"url": string
}
],
"attributes": [
{
"name": string,
"values": [
string
]
}
],
"partNo": string,
"barcode": string,
"stock": number,
"name": string
}
],
"isVisible": boolean,
"images": [
{
"order": number,
"url": string
}
],
"attributes": [
{
"name": string,
"values": [
string
]
}
],
"partNo": string,
"barcode": string,
"stock": number,
"name": string
}
],
"removed": [
{
"spec": {
"name": string,
"selectedValue": string
},
"sku": number,
"items": [
{
"sku": number,
"spec": {
"name": string,
"selectedValue": string
},
"isVisible": boolean,
"name": string,
"attributes": [
{
"name": string,
"values": [
string
]
}
]
}
],
"isVisible": boolean,
"name": string,
"attributes": [
{
"name": string,
"values": [
string
]
}
]
}
],
"updated": [
{
"origin": {
"spec": {
"name": string,
"selectedValue": string
},
"parentSku": number,
"name": string,
"attributes": [
{
"name": string,
"values": [
string
]
}
]
},
"sku": number,
"outcome": {
"spec": {
"name": string,
"selectedValue": string
},
"parentSpec": {
"name": string,
"selectedValue": string
},
"parentSku": number,
"name": string,
"attributes": [
{
"name": string,
"values": [
string
]
}
]
}
}
]
},
"complimentaryDiff": {
"added": [
{
"items": [
{
"id": number,
"sku": number,
"spec": {
"name": string,
"selectedValue": string
},
"shortTitle": string
}
],
"sku": number,
"spec": {
"name": string,
"selectedValue": string
},
"shortTitle": string
}
],
"updated": [
{
"origin": {
"spec": {
"name": string,
"selectedValue": string
},
"parentSku": number,
"shortTitle": string
},
"outcome": {
"spec": {
"name": string,
"selectedValue": string
},
"parentSku": number,
"shortTitle": string
},
"sku": number
}
],
"removed": [
{
"items": [
{
"sku": number,
"spec": {
"name": string,
"selectedValue": string
},
"shortTitle": string
}
],
"sku": number,
"spec": {
"name": string,
"selectedValue": string
},
"shortTitle": string
}
]
},
"complimentaryDiff": {
"added": [
{
"items": [
{
"id": number,
"sku": number,
"spec": {
"name": string,
"selectedValue": string
},
"shortTitle": string
}
],
"sku": number,
"spec": {
"name": string,
"selectedValue": string
},
"shortTitle": string
}
],
"updated": [
{
"origin": {
"spec": {
"name": string,
"selectedValue": string
},
"parentSku": number,
"shortTitle": string
},
"outcome": {
"spec": {
"name": string,
"selectedValue": string
},
"parentSku": number,
"shortTitle": string
},
"sku": number
}
],
"removed": [
{
"items": [
{
"sku": number,
"spec": {
"name": string,
"selectedValue": string
},
"shortTitle": string
}
],
"sku": number,
"spec": {
"name": string,
"selectedValue": string
},
"shortTitle": string
}
]
},
"selectComplimentaryDiff": {
"added": [
{
"items": [
{
"id": number,
"sku": number,
"spec": {
"name": string,
"selectedValue": string
},
"shortTitle": string
}
],
"sku": number,
"spec": {
"name": string,
"selectedValue": string
},
"shortTitle": string
}
],
"updated": [
{
"origin": {
"spec": {
"name": string,
"selectedValue": string
},
"parentSku": number,
"shortTitle": string
},
"outcome": {
"spec": {
"name": string,
"selectedValue": string
},
"parentSku": number,
"shortTitle": string
},
"sku": number
}
],
"removed": [
{
"items": [
{
"isVisible": boolean,
"sku": number,
"spec": {
"name": string,
"selectedValue": string
},
"shortTitle": string
}
],
"sku": number,
"spec": {
"name": string,
"selectedValue": string
},
"shortTitle": string
}
],
"updatedField": [
{
"field": string,
"origin": string,
"outcome": string
}
]
},
"additionalPurchasesDiff": {
"added": [
{
"sku": number,
"spec": {
"name": string,
"selectedValue": string
},
"price": string
}
],
"updated": [
{
"sku": number,
"origin": {
"spec": {
"name": string,
"selectedValue": string
},
"price": string
},
"outcome": {
"spec": {
"name": string,
"selectedValue": string
},
"price": string
}
}
],
"removed": [
{
"sku": number,
"spec": {
"name": string,
"selectedValue": string
}
}
]
},
"products": [
{
"id": number,
"sku": number,
"supplierId": number,
"name": string,
"cost": string,
"partNo": string,
"stock": number,
"availableCount": number,
"images": [
{
"url": string,
"width": number,
"height": number,
"order": number
}
],
"parentSpec": {
"name": string,
"selectedValue": string
},
"spec": {
"name": string,
"selectedValue": string
},
"structuredData": {
"attributes": [
{
"name": string,
"values": [
string
]
}
],
"struDataAttrClusterId": string
},
"isExpiringItem": boolean,
"isInstallRequired": boolean,
"isNeedRecycle": boolean,
"minPackingCount": number,
"taxable": boolean,
"msrp": string,
"brand": string,
"length": number,
"width": number,
"height": number,
"weight": number,
"preserveDays": number,
"catId": string,
"catItemId": string,
"isSoftGame": boolean,
"gameContents": [
string
],
"shipType": {
"id": number,
"type": string
}
}
]
}
Response Elements #
若操作成功,API 會回傳 HTTP 200 response。並以 JSON 格式回傳完整的 UpdateListingModelProposal 物件。
id #
提案編號。
資料型態: Integer
supplierId #
供應商編號。
資料型態: Integer
listing #
賣場資訊。
資料型態: ProposalListing
subStationId #
提案當下的提案子站編號, e.g. sub1
。
資料型態: String
subStationName #
提案當下的提案子站名稱。
資料型態: String
models #
賣場屬性商品的內容。models 的結構分別說明如下:
- sku:第 1 層屬性的商品編號
- spec:第 1 層屬性的名稱與項目
- items:若欲調整的賣場結構為雙層屬性,則此欄顯示為第 2 層屬性
- isVisible:第 1 層屬性是否顯示於前台賣場
- images:第 1 層屬性項目的商品圖
- attributes:第 1 層屬性項目的規格表屬性
- barcode:第 1 層屬性項目的實際國際條碼
- stock:第 1 層屬性項目的備貨數量
- partNo:第 1 層屬性項目的商品料號
- name:第 1 層屬性項目的商品名稱
資料型態: ProposalModel[]
diff #
儲存提案時賣場屬性與提案內容的差異。diff
的結構包含:
added
表示提案新增的賣場屬性及新增的商品資訊,結構請參考 ProposalModelremoved
表示移除的賣場既有屬性,結構請參考 ListingModelupdated
表示更新的賣場既有屬性
diff 會包含 added
與 removed
的第 1 層屬性,而 updated
會包含第 1 層屬性更新的屬性項目。
若為雙層屬性賣場的提案單 added
與 removed
會額外包含第 2 層屬性,而 updated
會額外包含第 2 層屬性更新的項目,以及第 2 層屬性是否有更換第 1 層屬性。
其中 updated 結構說明如下:
-
單層賣場:僅顯示更新的屬性項目
更新的屬性項目
{ "origin": { "spec": { "name": "商品尺寸", "selectedValue": "L號" }, "name": "商品L號", "attributes": [ { "name": "商品尺寸", "values": [ "L" ] } ] }, "outcome": { "spec": { "name": "商品尺寸", "selectedValue": "L" }, "name": "商品L號", "attributes": [ { "name": "商品尺寸", "values": [ "L" ] } ] }, "sku": 6645988 }
-
雙層賣場:顯示第 1 層或第 2 層屬性更新的屬性項目。若第 2 層屬性有更換第 1 層屬性會分成以下兩種狀況:
- 更新的第 1 層屬性已既存於賣場,則第 1 層屬性以
parentSku
呈現。 - 更新的第 1 層屬性不存在原賣場中,則既有的第 1 層屬性以
parentSku
呈現,更新後的屬性項目與名稱以parentSpec
呈現。
第 1 層屬性更新屬性項目
{ "origin": { "spec": { "name": "顏色", "selectedValue": "白色系" } }, "outcome": { "spec": { "name": "顏色", "selectedValue": "白色" } }, "sku": 6645993 }
第 2 層屬性僅更新屬性項目
{ "origin": { "spec": { "name": "商品尺寸", "selectedValue": "L號" }, "name": "商品L號", "attributes": [ { "name": "商品尺寸", "values": [ "L" ] } ] }, "outcome": { "spec": { "name": "商品尺寸", "selectedValue": "L" }, "name": "商品L號", "attributes": [ { "name": "商品尺寸", "values": [ "L" ] } ] }, "sku": 6645987 }
第 2 層屬性不更新屬性項目,僅第 1 層屬性更換成另一個已既存於賣場的第 1 層屬性
{ "origin": { "parentSku": 6645993 }, "outcome": { "parentSku": 6645994 }, "sku": 6645987 }
第 2 層屬性不更新屬性項目,僅第 1 層屬性更新成不存在原賣場中的第 1 層屬性
{ "origin": { "parentSku": 6645993 }, "outcome": { "parentSpec": { "name": "顏色", "selectedValue": "白色" } }, "sku": 6645987 }
第 2 層屬性更新屬性項目,且第 1 層屬性更新成不存在原賣場中的第 1 層屬性
{ "origin": { "spec": { "name": "商品尺寸", "selectedValue": "L號" }, "parentSku": 6645993, "name": "商品L號", "attributes": [ { "name": "商品尺寸", "values": [ "L" ] } ] }, "outcome": { "spec": { "name": "商品尺寸", "selectedValue": "L" }, "parentSpec": { "name": "顏色", "selectedValue": "黃色" }, "name": "商品L號", "attributes": [ { "name": "商品尺寸", "values": [ "L" ] } ] }, "sku": 6645987 }
第 2 層屬性商品編號
6645987
的屬性項目從L號
更新成L
,而第 1 層屬性從原賣場既有的第 1 層屬性6645993
更新成不存在原賣場的第 1 層屬性黃色
。 - 更新的第 1 層屬性已既存於賣場,則第 1 層屬性以
資料型態: ProposalSkuDiff[]
complimentary #
- models
買就送贈品的內容。 贈品的結構可分為有屬性贈品
與無屬性贈品
,分別說明如下:- 無屬性贈品
- sku:贈品商品編號
- spec:
- name:贈品分類名稱。若原賣場存在既有買就送贈品分類,將由 API 自動帶入贈品分類名稱,反之將由 API 自動產生
- selectedValue:贈品顯示名稱
- shortTitle: 贈品短標題
- 有屬性贈品
- sku:贈品屬性商品編號。若為新增買就送贈品屬性時,此欄位不需填寫將由 API 自動產生,反之需填寫欲調整的賣場買就送贈品屬性商品編號
- spec:
- name:贈品分類名稱。若原賣場存在既有買就送贈品分類,將由 API 自動帶入贈品分類名稱,反之將由 API 自動產生
- selectedValue:贈品顯示名稱
- items:
- sku:贈品商品編號
- spec:
- name:贈品屬性項目名稱,此欄位由 API 自動產生
- selectedValue:贈品屬性項目顯示名稱
- shortTitle: 贈品短標題
- shortTitle:贈品短標題。此欄位不需填寫,將由 API 自動帶入第一個贈品屬性項目之短標題
- 無屬性贈品
資料型態: ProposalComplimentary
complimentaryDiff #
儲存提案時賣場買就送贈品與提案買就送贈品內容的差異。
complimentaryDiff
的結構包含:
added
表示提案新增的買就送贈品資訊,結構請參考 ProposalModelremoved
表示移除的賣場既有買就送贈品,結構請參考 ListingModelupdated
表示更新的賣場既有買就送贈品,結構請參考 ProposalUpdatedSku
complimentaryDiff 會包含 added
與 removed
有屬性及無屬性的買就送贈品,而 updated
會記錄被更新的買就送贈品內容。
其中 updated 結構說明如下:
-
無屬性贈品:
更新無屬性贈品的贈品名稱及短標題
{ "origin": { "spec": { "name": "買就送贈品", "selectedValue": "贈品1" }, "shortTitle": "贈品1" }, "outcome": { "spec": { "name": "買就送贈品", "selectedValue": "贈品一" }, "shortTitle": "贈品一" }, "sku": 6875205 }
-
有屬性贈品:
更新賣場既有屬性贈品的贈品屬性項目顯示名稱及短標題
{ "origin": { "parentSku": 6875216, "spec": { "name": "配件屬性", "selectedValue": "贈品1" }, "shortTitle": "贈品1" }, "outcome": { "parentSku": 6875216, "spec": { "name": "配件屬性", "selectedValue": "贈品一" }, "shortTitle": "贈品一" }, "sku": 6875205 }
更新賣場既有屬性贈品的顯示名稱
{ "origin": { "spec": { "name": "贈品買就送", "selectedValue": "贈品1" } }, "outcome": { "spec": { "name": "贈品買就送", "selectedValue": "贈品一" } }, "sku": 6875205 }
資料型態: ProposalSkuDiff
selectComplimentary #
- selectedMinQty:任選贈品的必選數量
- models
任選贈品的內容。 贈品的結構可分為有屬性贈品
與無屬性贈品
,分別說明如下:- 無屬性贈品
- sku:贈品商品編號
- spec:
- name:贈品分類名稱。若原賣場存在既有任選贈品分類,將由 API 自動帶入贈品分類名稱,反之將由 API 自動產生
- selectedValue:贈品顯示名稱
- shortTitle: 贈品短標題
- 有屬性贈品
- sku:贈品屬性商品編號。若為新增任選贈品屬性時,此欄位不需填寫將由 API 自動產生,反之需填寫欲調整的賣場任選贈品屬性商品編號
- spec:
- name:贈品分類名稱。若原賣場存在既有任選贈品分類,將由 API 自動帶入贈品分類名稱,反之將由 API 自動產生
- selectedValue:贈品顯示名稱
- items:
- sku:贈品商品編號
- spec:
- name:贈品屬性項目名稱,此欄位由 API 自動產生
- selectedValue:贈品屬性項目顯示名稱
- shortTitle: 贈品短標題
- shortTitle:贈品短標題。此欄位不需填寫,將由 API 自動帶入第一個贈品屬性項目之短標題
- 無屬性贈品
資料型態: ProposalComplimentary
selectComplimentaryDiff #
儲存提案時賣場任選贈品與提案任選贈品內容的差異。
selectComplimentaryDiff
的結構包含:
added
表示提案新增的任選贈品資訊,結構請參考 ProposalModelremoved
表示移除的賣場既有任選贈品,結構請參考 ListingModelupdated
表示更新的賣場既有任選贈品,結構請參考 ProposalUpdatedSkuupdatedField
表示提案內容更新的任選贈品欄位,結構請參考 ProposalUpdatedField
selectComplimentaryDiff 會包含 added
與 removed
有屬性及無屬性的任選贈品, updated
會記錄被更新的任選贈品內容,而 updatedField
會紀錄被更新的任選贈品欄位。
其中 updatedField 結構說明如下:
- 贈品必選數量:
更新贈品必選數量
{ "updatedField": [ { "field": "selectedMinQty", "origin": "1", "outcome": "2" } ] }
其中 updated 結構說明如下:
-
無屬性贈品:
更新無屬性贈品的贈品名稱及短標題
{ "origin": { "spec": { "name": "任選贈品", "selectedValue": "贈品1" }, "shortTitle": "贈品1" }, "outcome": { "spec": { "name": "任選贈品", "selectedValue": "贈品一" }, "shortTitle": "贈品一" }, "sku": 6875205 }
-
有屬性贈品:
更新賣場既有屬性贈品的贈品屬性項目顯示名稱及短標題
{ "origin": { "parentSku": 6875216, "spec": { "name": "配件屬性", "selectedValue": "贈品1" }, "shortTitle": "贈品1" }, "outcome": { "parentSku": 6875216, "spec": { "name": "配件屬性", "selectedValue": "贈品一" }, "shortTitle": "贈品一" }, "sku": 6875205 }
更新賣場既有屬性贈品的顯示名稱
{ "origin": { "spec": { "name": "贈品任選", "selectedValue": "贈品1" } }, "outcome": { "spec": { "name": "贈品任選", "selectedValue": "贈品一" } }, "sku": 6875205 }
資料型態: ProposalSkuDiff
additionalPurchases #
加價購的內容。
- sku:加價購商品編號
- spec:
- name:加價購分類名稱。若原賣場存在既有加價購分類,將由 API 自動帶入加價購分類名稱,反之將由 API 自動產生
- selectedValue:加價購顯示名稱
- price:加價購商品售價
資料型態: ProposalModel[]
additionalPurchasesDiff #
儲存提案時賣場加價購與提案加價購內容的差異。
additionalPurchasesDiff
的結構包含:
added
表示提案新增的加價購商品資訊,結構請參考 ProposalModelremoved
表示移除的賣場既有加價購商品,結構請參考 ListingModelupdated
表示更新的賣場既有加價購商品,結構請參考 ProposalUpdatedSku
其中 updated 結構說明如下:
更新加價購商品
{
"origin": {
"spec": {
"name": "加價購商品",
"selectedValue": "加價購商品1"
},
"price": "1.00"
},
"outcome": {
"spec": {
"name": "加價購商品",
"selectedValue": "加價購商品一"
},
"price": "2.00"
},
"sku": 6875205
}
資料型態: ProposalSkuDiff
applicant #
提案人。
資料型態: String
appliedTs #
提案時間。
資料型態: String
格式: ISO-8601
expiredTs #
提案有效時間。
資料型態: String
格式: ISO-8601
contactWindow #
提案對象。
資料型態: String
createdTs #
建檔時間。
資料型態: String
格式: ISO-8601
creator #
建檔者。
資料型態: String
modifiedTimes #
更新次數。
資料型態: Integer
modifiedTs #
更新時間。
資料型態: String
格式: ISO-8601
modifier #
更新者。
資料型態: String
executeStatus #
執行狀態。
資料型態: String
有效值: 詳見 執行狀態
reviewStatus #
審核狀態。
資料型態: String
有效值: 詳見 審核狀態
products #
允許加入賣場的屬性商品詳細資訊。
資料型態: Product[]
欄位說明
欄位名稱 | 資料型態 | 欄位說明 |
---|---|---|
id | Integer | Product ID (SKU) |
name | String | 商品名稱 |
partNo | String | 商品貨號 |
sku | Integer | 商品 ID |
stock | Integer | 商品庫存 |
cost | String | 商品成本 |
images | ProductImage[] | 商品圖片 |
structuredData | StructuredData | 商品規格表 |
spec | Attribute | 單層屬性商品的屬性名稱與項目 / 雙層屬性商品的第 2 層屬性名稱與項目 |
parentSpec | Attribute | 雙層屬性商品的第 1 層屬性名稱與項目,單層及無屬性商品無此欄位。 |
isExpiringItem | Boolean | 是否為即期品 |
isInstallRequired | Boolean | 是否需要安裝 |
isNeedRecycle | Boolean | 是否屬於廢四機 |
minPackingCount | Int32 | 最小包裝數 |
taxable | Boolean | 商品是否應稅 |
msrp | String | 廠商建議價 |
brand | String | 品牌 |
length | Int32 | 包裝完成後的商品長度 |
width | Int32 | 包裝完成後的商品寬度 |
height | Int32 | 包裝完成後的商品高度 |
weight | Int32 | 包裝完成後的商品重量 |
preserveDays | Int32 | 商品保存期限 |
catId | String | 商品目前的分類父類 ID, e.g. cat1610 |
catItemId | String | 商品目前的分類子類 ID, e.g. catItem21704 |
isSoftGame | Boolean | 是否為遊戲軟體 |
gameContents | String[] | 遊戲情節內容,若 isSoftGame = false 則此欄位為空 |
shipType | ShipType | 配送方式 |
availableCount | Int32 | 商品可售數量 |
note #
備註。
資料型態: String
suggestion #
改善或建議。
資料型態: String
Errors #
Bad Request #
輸入的參數不符合 API 定義的 Pattern。
HTTP Status Code: 400
Error Code | Description |
---|---|
0 | Invalid input |
40000011 | Invalid ISO-8601 format |
40000010 | Multiple bad parameters |
40000013 | The field is unchangeable |
40000023 | Constraint violation validate error |
40009073 | Proposal model specification values must have only one value and pre-defined in structured data |
40009104 | Cannot PUT the proposal which review status isn’t composing and draft |
40009127 | Invalid listing ID |
40009147 | Invalid listing type |
40009148 | The listing does not allow to adjust the model |
40009149 | The product ID is invalid |
40009150 | The sku’s supplier ID is different from the listing’s |
40009151 | The sku’s cost is different from the listing’s |
40009152 | The sku’s ship type is different from the listing’s |
40009153 | The sku’s outright purchase status is different from the listing’s |
40009154 | The sku’s attribute spec name is different from the listing’s |
40009155 | The sku’s attribute item spec name is different from the listing’s |
40009156 | The sku’s sub station ID is different from the listing’s |
40009157 | The sku’s structure attribute cluster ID is different from the listing’s |
40009158 | The gift sku does not allow to be added to the listing model |
40009159 | Invalid product conditions |
40009160 | The sku hasn’t entered the warehouse |
40009161 | Invalid product conditions |
40009162 | Invalid sku abstract status |
40009163 | The listing with delivery type preOrder and customized could not be adjusted the model |
40009164 | The sku does not allow added in the normal delivery listing |
40009165 | The sku does not allow added in the appointment delivery listing |
40009166 | The sku does not allow added in the express delivery listing |
40009167 | Duplicate sku ID in listing |
40009168 | Mismatch product and listing attribute layer |
40009169 | The sku ID not in listing models |
40009170 | Duplicate spec value in listing models |
40009171 | Duplicate item spec value in listing models |
40009172 | Least contain one spec in listing models |
40009173 | Least contain one item spec in listing models |
40009174 | Mismatch proposal and listing attribute layer |
40009175 | Invalid model quantity |
40009176 | Invalid model’s item quantity |
40009177 | Duplicate sku ID in proposal |
40009178 | Invalid product conditions |
40009179 | Invalid product conditions |
40009180 | The model’s attribute spec name is different from the listing’s |
40009181 | The model’s attribute item spec name is different from the listing’s |
40009182 | The structure data attribute cluster ID inconsistent in listing |
40009183 | The structure data attribute cluster ID inconsistent in proposal |
40009185 | Must retain one visible model in a listing or item in a model |
40009201 | There are inconsistent spec name in the proposal |
40009202 | Duplicate SKU with the main product of the listing |
40009203 | The SKU not in listing complimentaries |
40009204 | Invalid gift cost |
40009205 | Invalid gift category |
40009206 | Cannot validate gift and additional purchase simultaneously |
40009207 | Invalid gift select minimum quantity |
40009208 | Invalid gift specification selected value length |
40009209 | Invalid listing attribute count |
40009210 | Invalid additional purchase cost |
40009211 | Invalid additional purchase price |
40009223 | Duplicate product name |
40009224 | Invalid proposal structure |
40009230 | The sku’s tax type is different from the listing’s |
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 |
Unprocessable Entity #
提案單狀態驗證不通過,請確認提案單狀態。
HTTP Status Code: 422
Error Code | Description |
---|---|
42209002 | Invalid state flow of proposal review status |
Internal Server Error #
API 端發生錯誤,若持續發生請洽您的業務窗口。
HTTP Status Code: 500
Examples #
新建賣場屬性調整提案單 - 單層賣場
- 移除既有屬性:紅色系 (6677911)
- 隱藏屬性:黑色系 (6677910)
- 新增屬性商品:芋頭紫。規格表內容選擇
紫色系
,但可使用spec.selectedValue
調整
賣場頁顯示的屬性名稱為芋頭紫
- 賣場頁顯示的屬性名稱 (
models[2].spec.selectedValue
):芋頭紫 - 屬性規格表內容 (
models[2].attributes[0].values[0]
):紫色系
- 賣場頁顯示的屬性名稱 (
POST /api/spa/v1/proposal/updateListingModels HTTP/1.1
HOST: tw.supplier.yahoo.com
Content-Type: application/json; charset=UTF-8
{
"applicant": "applicant-name",
"listing": {
"id": 3408438
},
"models": [
{
"sku": 6677909,
"spec": {
"name": "顏色",
"selectedValue": "白色系"
},
"isVisible": true,
"name": "單層宅配賣場-白色系",
"attributes": [
{
"name": "顏色",
"values": [
"白色系"
]
}
]
},
{
"sku": 6677910,
"spec": {
"name": "顏色",
"selectedValue": "黑色系"
},
"isVisible": false,
"name": "單層宅配賣場-黑色系",
"attributes": [
{
"name": "顏色",
"values": [
"黑色系"
]
}
]
},
{
"spec": {
"name": "顏色",
"selectedValue": "芋頭紫"
},
"attributes": [
{
"name": "顏色",
"values": [
"紫色系"
]
}
],
"isVisible": true,
"stock": 1,
"partNo": "商品料號",
"barcode": "725272730706",
"images": [
{
"url": "https://s.yimg.com/bp/Files/683ad340890cb1757794c7f7691cb2d93d4319ee_1000x1000.jpg",
"order": 1
},
{
"url": "https://s.yimg.com/bp/Files/021704884b14d4adaa9525e5ac65aa4874331d15_1000x1000.jpg",
"order": 2
}
]
}
]
}
欄位說明:
diff
可得知此賣場- 紅色系屬性
6677911
被移除 - 新增
芋頭紫
屬性商品,該商品 sku 將於提案執行完成後由 API 自動產生 - 其餘屬性為賣場既有屬性
- 紅色系屬性
product
可得到此提案賣場的 2 個屬性 - 白色系 (6677909) 與黑色系 (6677910) 與被移
除的紅色系屬性 (6677911) 的商品詳細資訊,芋頭紫
屬性商品則於提案執行完成後才會
顯示models
為賣場最後呈現的屬性內容,即此賣場有白色系、黑色系和芋頭紫屬性,但黑色系
屬性isVisible
被設為 false,所以賣場頁黑色系屬性將被隱藏起來,僅顯示白色系屬性
{
"applicant": "applicant-name",
"contactWindow": "contactWindow-name",
"createdTs": "2022-01-04T08:39:03Z",
"creator": "creator-id",
"diff": {
"added": [
{
"name": "賣場名稱-芋頭紫",
"spec": {
"name": "顏色",
"selectedValue": "芋頭紫"
},
"attributes": [
{
"name": "顏色",
"values": [
"紫色系"
]
}
],
"isVisible": true,
"stock": 1,
"partNo": "商品料號",
"barcode": "725272730706",
"images": [
{
"height": 1000,
"order": 1,
"url": "https://s.yimg.com/cl/api/res/1.2/..I0BCkmwpo1TbSb2C7ODA--/YXBwaWQ9dHdzcG1hbGw7dz0xMDAwO2g9MTAwMA--/https://s.yimg.com/bp/Files/683ad340890cb1757794c7f7691cb2d93d4319ee_1000x1000.jpg.cf.jpg",
"width": 1000
},
{
"height": 400,
"order": 1,
"url": "https://s.yimg.com/cl/api/res/1.2/p5RyNIIKNjom5AFwOgYO5w--/YXBwaWQ9dHdzcG1hbGw7dz00MDA7aD00MDA-/https://s.yimg.com/bp/Files/683ad340890cb1757794c7f7691cb2d93d4319ee_1000x1000.jpg.cf.jpg",
"width": 400
},
{
"height": 250,
"order": 1,
"url": "https://s.yimg.com/cl/api/res/1.2/F.VWuQkAJNptMAl6n8ygkg--/YXBwaWQ9dHdzcG1hbGw7dz0yNTA7aD0yNTA-/https://s.yimg.com/bp/Files/683ad340890cb1757794c7f7691cb2d93d4319ee_1000x1000.jpg.cf.jpg",
"width": 250
},
{
"height": 135,
"order": 1,
"url": "https://s.yimg.com/cl/api/res/1.2/8Dq6eqcjK8NQBzLwEd.QxQ--/YXBwaWQ9dHdzcG1hbGw7dz0xMzU7aD0xMzU-/https://s.yimg.com/bp/Files/683ad340890cb1757794c7f7691cb2d93d4319ee_1000x1000.jpg.cf.jpg",
"width": 135
},
{
"height": 80,
"order": 1,
"url": "https://s.yimg.com/cl/api/res/1.2/HJ67cnZZU618JFylVTV59A--/YXBwaWQ9dHdzcG1hbGw7dz04MDtoPTgw/https://s.yimg.com/bp/Files/683ad340890cb1757794c7f7691cb2d93d4319ee_1000x1000.jpg.cf.jpg",
"width": 80
},
{
"height": 1000,
"order": 2,
"url": "https://s.yimg.com/cl/api/res/1.2/J_lmLlBNY4nxJWUJrUJdgg--/YXBwaWQ9dHdzcG1hbGw7dz0xMDAwO2g9MTAwMA--/https://s.yimg.com/bp/Files/021704884b14d4adaa9525e5ac65aa4874331d15_1000x1000.jpg.cf.jpg",
"width": 1000
},
{
"height": 400,
"order": 2,
"url": "https://s.yimg.com/cl/api/res/1.2/f1IuNTzEjNcb7xvuTcRnFg--/YXBwaWQ9dHdzcG1hbGw7dz00MDA7aD00MDA-/https://s.yimg.com/bp/Files/021704884b14d4adaa9525e5ac65aa4874331d15_1000x1000.jpg.cf.jpg",
"width": 400
},
{
"height": 250,
"order": 2,
"url": "https://s.yimg.com/cl/api/res/1.2/Nk4FM51HzYAZVXVXj.WDIg--/YXBwaWQ9dHdzcG1hbGw7dz0yNTA7aD0yNTA-/https://s.yimg.com/bp/Files/021704884b14d4adaa9525e5ac65aa4874331d15_1000x1000.jpg.cf.jpg",
"width": 250
},
{
"height": 135,
"order": 2,
"url": "https://s.yimg.com/cl/api/res/1.2/aq6PYrMIMn5p7fMSBYxyeg--/YXBwaWQ9dHdzcG1hbGw7dz0xMzU7aD0xMzU-/https://s.yimg.com/bp/Files/021704884b14d4adaa9525e5ac65aa4874331d15_1000x1000.jpg.cf.jpg",
"width": 135
},
{
"height": 80,
"order": 2,
"url": "https://s.yimg.com/cl/api/res/1.2/N9iTLQ4yQRXywXJ7nZNpzQ--/YXBwaWQ9dHdzcG1hbGw7dz04MDtoPTgw/https://s.yimg.com/bp/Files/021704884b14d4adaa9525e5ac65aa4874331d15_1000x1000.jpg.cf.jpg",
"width": 80
}
]
}
],
"removed": [
{
"isVisible": true,
"sku": 6677911,
"spec": {
"name": "顏色",
"selectedValue": "紅色系"
},
"name": "單層宅配賣場-紅色系",
"attributes": [
{
"name": "顏色",
"values": [
"紅色系"
]
}
]
}
]
},
"executeStatus": "idle",
"expiredTs": "2022-01-18T16:00:00Z",
"id": 599375,
"listing": {
"applyLowGpm": false,
"id": 3408438,
"isThresholdFreebie": false,
"shareMediaBetweenModels": false,
"syncProductImages": true,
"origLayer": 1
},
"models": [
{
"isVisible": true,
"sku": 6677909,
"spec": {
"name": "顏色",
"selectedValue": "白色系"
},
"name": "單層宅配賣場-白色系",
"attributes": [
{
"name": "顏色",
"values": [
"白色系"
]
}
]
},
{
"isVisible": false,
"sku": 6677910,
"spec": {
"name": "顏色",
"selectedValue": "黑色系"
},
"name": "單層宅配賣場-黑色系",
"attributes": [
{
"name": "顏色",
"values": [
"黑色系"
]
}
]
},
{
"name": "賣場名稱-芋頭紫",
"spec": {
"name": "顏色",
"selectedValue": "芋頭紫"
},
"attributes": [
{
"name": "顏色",
"values": [
"紫色系"
]
}
],
"isVisible": true,
"stock": 1,
"partNo": "商品料號",
"barcode": "725272730706",
"images": [
{
"height": 1000,
"order": 1,
"url": "https://s.yimg.com/cl/api/res/1.2/..I0BCkmwpo1TbSb2C7ODA--/YXBwaWQ9dHdzcG1hbGw7dz0xMDAwO2g9MTAwMA--/https://s.yimg.com/bp/Files/683ad340890cb1757794c7f7691cb2d93d4319ee_1000x1000.jpg.cf.jpg",
"width": 1000
},
{
"height": 400,
"order": 1,
"url": "https://s.yimg.com/cl/api/res/1.2/p5RyNIIKNjom5AFwOgYO5w--/YXBwaWQ9dHdzcG1hbGw7dz00MDA7aD00MDA-/https://s.yimg.com/bp/Files/683ad340890cb1757794c7f7691cb2d93d4319ee_1000x1000.jpg.cf.jpg",
"width": 400
},
{
"height": 250,
"order": 1,
"url": "https://s.yimg.com/cl/api/res/1.2/F.VWuQkAJNptMAl6n8ygkg--/YXBwaWQ9dHdzcG1hbGw7dz0yNTA7aD0yNTA-/https://s.yimg.com/bp/Files/683ad340890cb1757794c7f7691cb2d93d4319ee_1000x1000.jpg.cf.jpg",
"width": 250
},
{
"height": 135,
"order": 1,
"url": "https://s.yimg.com/cl/api/res/1.2/8Dq6eqcjK8NQBzLwEd.QxQ--/YXBwaWQ9dHdzcG1hbGw7dz0xMzU7aD0xMzU-/https://s.yimg.com/bp/Files/683ad340890cb1757794c7f7691cb2d93d4319ee_1000x1000.jpg.cf.jpg",
"width": 135
},
{
"height": 80,
"order": 1,
"url": "https://s.yimg.com/cl/api/res/1.2/HJ67cnZZU618JFylVTV59A--/YXBwaWQ9dHdzcG1hbGw7dz04MDtoPTgw/https://s.yimg.com/bp/Files/683ad340890cb1757794c7f7691cb2d93d4319ee_1000x1000.jpg.cf.jpg",
"width": 80
},
{
"height": 1000,
"order": 2,
"url": "https://s.yimg.com/cl/api/res/1.2/J_lmLlBNY4nxJWUJrUJdgg--/YXBwaWQ9dHdzcG1hbGw7dz0xMDAwO2g9MTAwMA--/https://s.yimg.com/bp/Files/021704884b14d4adaa9525e5ac65aa4874331d15_1000x1000.jpg.cf.jpg",
"width": 1000
},
{
"height": 400,
"order": 2,
"url": "https://s.yimg.com/cl/api/res/1.2/f1IuNTzEjNcb7xvuTcRnFg--/YXBwaWQ9dHdzcG1hbGw7dz00MDA7aD00MDA-/https://s.yimg.com/bp/Files/021704884b14d4adaa9525e5ac65aa4874331d15_1000x1000.jpg.cf.jpg",
"width": 400
},
{
"height": 250,
"order": 2,
"url": "https://s.yimg.com/cl/api/res/1.2/Nk4FM51HzYAZVXVXj.WDIg--/YXBwaWQ9dHdzcG1hbGw7dz0yNTA7aD0yNTA-/https://s.yimg.com/bp/Files/021704884b14d4adaa9525e5ac65aa4874331d15_1000x1000.jpg.cf.jpg",
"width": 250
},
{
"height": 135,
"order": 2,
"url": "https://s.yimg.com/cl/api/res/1.2/aq6PYrMIMn5p7fMSBYxyeg--/YXBwaWQ9dHdzcG1hbGw7dz0xMzU7aD0xMzU-/https://s.yimg.com/bp/Files/021704884b14d4adaa9525e5ac65aa4874331d15_1000x1000.jpg.cf.jpg",
"width": 135
},
{
"height": 80,
"order": 2,
"url": "https://s.yimg.com/cl/api/res/1.2/N9iTLQ4yQRXywXJ7nZNpzQ--/YXBwaWQ9dHdzcG1hbGw7dz04MDtoPTgw/https://s.yimg.com/bp/Files/021704884b14d4adaa9525e5ac65aa4874331d15_1000x1000.jpg.cf.jpg",
"width": 80
}
]
}
],
"modifiedTs": "2022-01-04T08:39:03Z",
"modifier": "modifier-id",
"products": [
{
"cost": "80.00",
"id": 6677909,
"images": [
{
"height": 1000,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/876984D7CB-SP-484183.jpg",
"width": 1000
},
{
"height": 400,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/247B558373-SP-484183.jpg",
"width": 400
},
{
"height": 250,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/B6C4A9754D-SP-484183.jpg",
"width": 250
},
{
"height": 135,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/93D1DB3A3A-SP-484183.jpg",
"width": 135
},
{
"height": 80,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/9D119726D1-SP-484183.jpg",
"width": 80
},
{
"height": 1000,
"order": 2,
"url": "https://s.yimg.com/zo/MerchandiseImages/7D92C6556F-SP-484183.jpg",
"width": 1000
},
{
"height": 400,
"order": 2,
"url": "https://s.yimg.com/zo/MerchandiseImages/8D938FA040-SP-484183.jpg",
"width": 400
}
],
"name": "單層宅配賣場-白色系",
"sku": 6677909,
"spec": {
"name": "顏色",
"selectedValue": "白色系"
},
"stock": 10,
"availableCount": 10,
"structuredData": {
"attributes": [
{
"name": "商品品牌",
"values": [
"5th STREET"
]
},
{
"name": "顏色",
"values": [
"白色系"
]
},
{
"name": "商品尺寸",
"values": [
"2L"
]
}
],
"struDataAttrClusterId": "000003414671"
},
"isExpiringItem": false,
"isInstallRequired": false,
"isNeedRecycle": false,
"minPackingCount": 1,
"taxable": true,
"msrp": "100.00",
"brand": "品牌",
"catId": "cat430",
"catItemId": "catItem10070",
"isSoftGame": false,
"shipType": {
"id": 1,
"type": "Home"
}
},
{
"cost": "80.00",
"id": 6677910,
"images": [
{
"height": 1000,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/876984D7CB-SP-484183.jpg",
"width": 1000
},
{
"height": 400,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/247B558373-SP-484183.jpg",
"width": 400
},
{
"height": 250,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/B6C4A9754D-SP-484183.jpg",
"width": 250
},
{
"height": 135,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/93D1DB3A3A-SP-484183.jpg",
"width": 135
},
{
"height": 80,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/9D119726D1-SP-484183.jpg",
"width": 80
},
{
"height": 1000,
"order": 2,
"url": "https://s.yimg.com/zo/MerchandiseImages/7D92C6556F-SP-484183.jpg",
"width": 1000
},
{
"height": 400,
"order": 2,
"url": "https://s.yimg.com/zo/MerchandiseImages/8D938FA040-SP-484183.jpg",
"width": 400
}
],
"name": "單層宅配賣場-黑色系",
"sku": 6677910,
"spec": {
"name": "顏色",
"selectedValue": "黑色系"
},
"stock": 10,
"availableCount": 10,
"structuredData": {
"attributes": [
{
"name": "商品品牌",
"values": [
"5th STREET"
]
},
{
"name": "顏色",
"values": [
"黑色系"
]
},
{
"name": "商品尺寸",
"values": [
"693"
]
}
],
"struDataAttrClusterId": "000003414671"
},
"isExpiringItem": false,
"isInstallRequired": false,
"isNeedRecycle": false,
"minPackingCount": 1,
"taxable": true,
"msrp": "100.00",
"brand": "品牌",
"catId": "cat430",
"catItemId": "catItem10070",
"isSoftGame": false,
"shipType": {
"id": 1,
"type": "Home"
}
},
{
"cost": "80.00",
"id": 6677911,
"images": [
{
"height": 1000,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/ECC24EC118-SP-484183.jpg",
"width": 1000
},
{
"height": 400,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/3E57694544-SP-484183.jpg",
"width": 400
},
{
"height": 250,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/F4F663B8A8-SP-484183.jpg",
"width": 250
},
{
"height": 135,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/AB651ADB0A-SP-484183.jpg",
"width": 135
},
{
"height": 80,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/7B397A0C6C-SP-484183.jpg",
"width": 80
},
{
"height": 1000,
"order": 2,
"url": "https://s.yimg.com/zo/MerchandiseImages/3AE2CF332F-SP-484183.jpg",
"width": 1000
},
{
"height": 400,
"order": 2,
"url": "https://s.yimg.com/zo/MerchandiseImages/9645CDE9D5-SP-484183.jpg",
"width": 400
}
],
"name": "單層宅配賣場-紅色系",
"sku": 6677911,
"spec": {
"name": "顏色",
"selectedValue": "紅色系"
},
"stock": 10,
"availableCount": 10,
"structuredData": {
"attributes": [
{
"name": "商品品牌",
"values": [
"5th STREET"
]
},
{
"name": "顏色",
"values": [
"紅色系"
]
},
{
"name": "商品尺寸",
"values": [
"2L"
]
}
],
"struDataAttrClusterId": "000003414671"
},
"isExpiringItem": false,
"isInstallRequired": false,
"isNeedRecycle": false,
"minPackingCount": 1,
"taxable": true,
"msrp": "100.00",
"brand": "品牌",
"catId": "cat430",
"catItemId": "catItem10070",
"isSoftGame": false,
"shipType": {
"id": 1,
"type": "Home"
}
}
],
"reviewStatus": "draft",
"subStationId": "sub10",
"subStationName": "subStationName-name",
"supplierId": 99999
}
新建賣場屬性調整提案單 - 雙層賣場
賣場屬性白色系與黑色系皆為既有屬性,可僅填 sku
。倘若亦填寫 spec
則以賣場既有 sku
的
屬性項目為主。
ex. 屬性 6677909 名稱為白色系,但 request body 同時填寫 sku (6677909) 與 spec (屬性名稱: 白色), 則提案結果會以賣場既有屬性 (6677909) 的名稱
白色系
為主。
- 新增屬性項目:黑色系-3L (6677907)
- 同時更新屬性商品名稱為
米色系-3L
- 同時更新屬性項目規格表
商品尺寸
選項為3L
- 同時更新屬性商品名稱為
- 新增屬性商品至既有屬性:黑色系-XL
- 第 1 層屬性
- 屬性規格表內容選擇
黑色系
,但使用既有的賣場頁顯示的屬性名稱 (不調整spec.selectedValue
) - 屬性規格表內容 (
models[1].items[2].attributes[0].values[0]
):黑色系
- 屬性規格表內容選擇
- 第 2 層屬性
- 屬性規格表內容選擇
XL號
,但可使用spec.selectedValue
調整賣場頁顯示的屬性名稱為XL
- 賣場頁顯示的屬性名稱 (
models[1].items[2].spec.selectedValue
):XL - 屬性規格表內容 (
models[1].items[2].attributes[1].values[0]
):XL號
- 屬性規格表內容選擇
- 第 1 層屬性
- 新增屬性商品至新增的屬性:粉紅色-XL
- 第 1 層屬性
- 屬性規格表內容選擇
粉色系
,但可使用spec.selectedValue
調整賣場頁顯示的屬性名稱為粉紅色
- 賣場頁顯示的屬性名稱 (
models[2].spec.selectedValue
):粉紅色 - 屬性規格表內容 (
models[2].items[0].attributes[0].values[0]
):粉色系
- 屬性規格表內容選擇
- 第 2 層屬性
- 屬性規格表內容選擇
XL號
,但可使用spec.selectedValue
調整賣場頁顯示的屬性名稱為XL
- 賣場頁顯示的屬性名稱 (
models[2].items[0].spec.selectedValue
):XL - 屬性規格表內容 (
models[2].items[0].attributes[1].values[0]
):XL號
- 屬性規格表內容選擇
- 第 1 層屬性
POST /api/spa/v1/proposal/updateListingModels HTTP/1.1
HOST: tw.supplier.yahoo.com
Content-Type: application/json; charset=UTF-8
{
"applicant": "applicant-name",
"listing": {
"id": 3408438
},
"models": [
{
"sku": 6677909,
"spec": {
"name": "顏色",
"selectedValue": "白色"
},
"isVisible": true,
"items": [
{
"id": 6677904,
"spec": {
"name": "商品尺寸",
"selectedValue": "2L"
},
"isVisible": true,
"name": "雙層宅配賣場-白色系-2L",
"attributes": [
{
"name": "顏色",
"values": [
"白色系"
]
},
{
"name": "商品尺寸",
"values": [
"2L"
]
}
]
},
{
"id": 6677905,
"spec": {
"name": "商品尺寸",
"selectedValue": "3L"
},
"isVisible": true,
"name": "雙層宅配賣場-白色系-693",
"attributes": [
{
"name": "顏色",
"values": [
"白色系"
]
},
{
"name": "商品尺寸",
"values": [
"693"
]
}
]
}
]
},
{
"sku": 6677910,
"isVisible": true,
"items": [
{
"id": 6677906,
"spec": {
"name": "商品尺寸",
"selectedValue": "2L"
},
"isVisible": true,
"name": "雙層宅配賣場-米色系-2L",
"attributes": [
{
"name": "顏色",
"values": [
"米色系"
]
},
{
"name": "商品尺寸",
"values": [
"2L"
]
}
]
},
{
"id": 6677907,
"spec": {
"name": "商品尺寸",
"selectedValue": "3L"
},
"isVisible": true,
"name": "米色系-3L",
"attributes": [
{
"name": "顏色",
"values": [
"米色系"
]
},
{
"name": "商品尺寸",
"values": [
"3L"
]
}
]
},
{
"spec": {
"name": "商品尺寸",
"selectedValue": "XL"
},
"attributes": [
{
"name": "顏色",
"values": [
"黑色系"
]
},
{
"name": "商品尺寸",
"values": [
"XL號"
]
}
],
"isVisible": true,
"stock": 1,
"partNo": "商品料號",
"barcode": "725272730706"
}
]
},
{
"spec": {
"name": "顏色",
"selectedValue": "粉紅色"
},
"isVisible": true,
"items": [
{
"spec": {
"name": "商品尺寸",
"selectedValue": "XL"
},
"attributes": [
{
"name": "顏色",
"values": [
"粉色系"
]
},
{
"name": "商品尺寸",
"values": [
"XL號"
]
}
],
"isVisible": true,
"stock": 1,
"partNo": "商品料號",
"barcode": "725272730706",
"images": [
{
"url": "https://s.yimg.com/bp/Files/683ad340890cb1757794c7f7691cb2d93d4319ee_1000x1000.jpg",
"order": 1
},
{
"url": "https://s.yimg.com/bp/Files/021704884b14d4adaa9525e5ac65aa4874331d15_1000x1000.jpg",
"order": 2
}
]
}
]
}
]
}
欄位說明:
diff
可得知此賣場- 黑色系屬性新加入
6677907
屬性商品,屬性商品名稱為米色系-3L
,屬性項目規格表商品尺寸
選項為3L
- 黑色系屬性新增
XL
屬性商品,該商品 sku 將於提案執行完成後由 API 自動產生 - 新增粉紅色屬性,並新增
XL
屬性商品,該商品 sku 將於提案執行完成後由 API 自動產
生 - 其餘屬性為賣場既有屬性
- 黑色系屬性新加入
product
可得到此提案賣場的 4 個屬性商品詳細資訊 (即 6677904、6677905、6677906
、6677907)黑色系-XL
與粉紅色-XL
屬性商品於提案執行完成後才會顯示- 6677907 欲更新的屬性商品名稱及屬性項目規格表於提案執行完成後才會更新
models
為賣場最後呈現的屬性內容,即此賣場白色系屬性有 2L 與 3L 的屬性商品,而
黑色系屬性有 2L 、 3L 與 XL 的屬性商品
{
"applicant": "applicant-name",
"contactWindow": "contactWindow-name",
"createdTs": "2022-01-04T08:39:03Z",
"creator": "creator-id",
"diff": {
"added": [
{
"isVisible": true,
"items": [
{
"id": 6677907,
"isVisible": true,
"sku": 6677907,
"spec": {
"name": "商品尺寸",
"selectedValue": "3L"
},
"name": "米色系-3L",
"attributes": [
{
"name": "顏色",
"values": [
"米色系"
]
},
{
"name": "商品尺寸",
"values": [
"3L"
]
}
]
},
{
"name": "賣場名稱-黑色系-XL",
"spec": {
"name": "商品尺寸",
"selectedValue": "XL"
},
"attributes": [
{
"name": "顏色",
"values": [
"黑色系"
]
},
{
"name": "商品尺寸",
"values": [
"XL號"
]
}
],
"isVisible": true,
"stock": 1,
"partNo": "商品料號",
"barcode": "725272730706"
}
],
"sku": 6677910,
"spec": {
"name": "顏色",
"selectedValue": "黑色系"
}
},
{
"isVisible": true,
"items": [
{
"name": "賣場名稱-粉紅色-XL",
"spec": {
"name": "商品尺寸",
"selectedValue": "XL"
},
"attributes": [
{
"name": "顏色",
"values": [
"粉色系"
]
},
{
"name": "商品尺寸",
"values": [
"XL號"
]
}
],
"isVisible": true,
"stock": 1,
"partNo": "商品料號",
"barcode": "725272730706",
"images": [
{
"height": 1000,
"order": 1,
"url": "https://s.yimg.com/cl/api/res/1.2/..I0BCkmwpo1TbSb2C7ODA--/YXBwaWQ9dHdzcG1hbGw7dz0xMDAwO2g9MTAwMA--/https://s.yimg.com/bp/Files/683ad340890cb1757794c7f7691cb2d93d4319ee_1000x1000.jpg.cf.jpg",
"width": 1000
},
{
"height": 400,
"order": 1,
"url": "https://s.yimg.com/cl/api/res/1.2/p5RyNIIKNjom5AFwOgYO5w--/YXBwaWQ9dHdzcG1hbGw7dz00MDA7aD00MDA-/https://s.yimg.com/bp/Files/683ad340890cb1757794c7f7691cb2d93d4319ee_1000x1000.jpg.cf.jpg",
"width": 400
},
{
"height": 250,
"order": 1,
"url": "https://s.yimg.com/cl/api/res/1.2/F.VWuQkAJNptMAl6n8ygkg--/YXBwaWQ9dHdzcG1hbGw7dz0yNTA7aD0yNTA-/https://s.yimg.com/bp/Files/683ad340890cb1757794c7f7691cb2d93d4319ee_1000x1000.jpg.cf.jpg",
"width": 250
},
{
"height": 135,
"order": 1,
"url": "https://s.yimg.com/cl/api/res/1.2/8Dq6eqcjK8NQBzLwEd.QxQ--/YXBwaWQ9dHdzcG1hbGw7dz0xMzU7aD0xMzU-/https://s.yimg.com/bp/Files/683ad340890cb1757794c7f7691cb2d93d4319ee_1000x1000.jpg.cf.jpg",
"width": 135
},
{
"height": 80,
"order": 1,
"url": "https://s.yimg.com/cl/api/res/1.2/HJ67cnZZU618JFylVTV59A--/YXBwaWQ9dHdzcG1hbGw7dz04MDtoPTgw/https://s.yimg.com/bp/Files/683ad340890cb1757794c7f7691cb2d93d4319ee_1000x1000.jpg.cf.jpg",
"width": 80
},
{
"height": 1000,
"order": 2,
"url": "https://s.yimg.com/cl/api/res/1.2/J_lmLlBNY4nxJWUJrUJdgg--/YXBwaWQ9dHdzcG1hbGw7dz0xMDAwO2g9MTAwMA--/https://s.yimg.com/bp/Files/021704884b14d4adaa9525e5ac65aa4874331d15_1000x1000.jpg.cf.jpg",
"width": 1000
},
{
"height": 400,
"order": 2,
"url": "https://s.yimg.com/cl/api/res/1.2/f1IuNTzEjNcb7xvuTcRnFg--/YXBwaWQ9dHdzcG1hbGw7dz00MDA7aD00MDA-/https://s.yimg.com/bp/Files/021704884b14d4adaa9525e5ac65aa4874331d15_1000x1000.jpg.cf.jpg",
"width": 400
},
{
"height": 250,
"order": 2,
"url": "https://s.yimg.com/cl/api/res/1.2/Nk4FM51HzYAZVXVXj.WDIg--/YXBwaWQ9dHdzcG1hbGw7dz0yNTA7aD0yNTA-/https://s.yimg.com/bp/Files/021704884b14d4adaa9525e5ac65aa4874331d15_1000x1000.jpg.cf.jpg",
"width": 250
},
{
"height": 135,
"order": 2,
"url": "https://s.yimg.com/cl/api/res/1.2/aq6PYrMIMn5p7fMSBYxyeg--/YXBwaWQ9dHdzcG1hbGw7dz0xMzU7aD0xMzU-/https://s.yimg.com/bp/Files/021704884b14d4adaa9525e5ac65aa4874331d15_1000x1000.jpg.cf.jpg",
"width": 135
},
{
"height": 80,
"order": 2,
"url": "https://s.yimg.com/cl/api/res/1.2/N9iTLQ4yQRXywXJ7nZNpzQ--/YXBwaWQ9dHdzcG1hbGw7dz04MDtoPTgw/https://s.yimg.com/bp/Files/021704884b14d4adaa9525e5ac65aa4874331d15_1000x1000.jpg.cf.jpg",
"width": 80
}
]
}
],
"spec": {
"name": "顏色",
"selectedValue": "粉紅色"
}
}
]
},
"executeStatus": "idle",
"expiredTs": "2022-01-18T16:00:00Z",
"id": 599375,
"listing": {
"applyLowGpm": false,
"id": 3408438,
"isThresholdFreebie": false,
"shareMediaBetweenModels": false,
"syncProductImages": true,
"origLayer": 2
},
"models": [
{
"isVisible": true,
"items": [
{
"id": 6677904,
"isVisible": true,
"sku": 6677904,
"spec": {
"name": "商品尺寸",
"selectedValue": "2L"
},
"name": "雙層宅配賣場-白色系-2L",
"attributes": [
{
"name": "顏色",
"values": [
"白色系"
]
},
{
"name": "商品尺寸",
"values": [
"2L"
]
}
]
},
{
"id": 6677905,
"isVisible": true,
"sku": 6677905,
"spec": {
"name": "商品尺寸",
"selectedValue": "3L"
},
"name": "雙層宅配賣場-白色系-693",
"attributes": [
{
"name": "顏色",
"values": [
"白色系"
]
},
{
"name": "商品尺寸",
"values": [
"693"
]
}
]
}
],
"sku": 6677909,
"spec": {
"name": "顏色",
"selectedValue": "白色系"
}
},
{
"isVisible": true,
"items": [
{
"id": 6677906,
"isVisible": true,
"sku": 6677906,
"spec": {
"name": "商品尺寸",
"selectedValue": "2L"
},
"name": "雙層宅配賣場-米色系-2L",
"attributes": [
{
"name": "顏色",
"values": [
"米色系"
]
},
{
"name": "商品尺寸",
"values": [
"2L"
]
}
]
},
{
"id": 6677907,
"isVisible": true,
"sku": 6677907,
"spec": {
"name": "商品尺寸",
"selectedValue": "3L"
},
"name": "米色系-3L",
"attributes": [
{
"name": "顏色",
"values": [
"米色系"
]
},
{
"name": "商品尺寸",
"values": [
"3L"
]
}
]
},
{
"name": "賣場名稱-黑色系-XL",
"spec": {
"name": "商品尺寸",
"selectedValue": "XL"
},
"attributes": [
{
"name": "顏色",
"values": [
"黑色系"
]
},
{
"name": "商品尺寸",
"values": [
"XL號"
]
}
],
"isVisible": true,
"stock": 1,
"partNo": "商品料號",
"barcode": "725272730706"
}
],
"sku": 6677910,
"spec": {
"name": "顏色",
"selectedValue": "黑色系"
}
},
{
"isVisible": true,
"items": [
{
"name": "賣場名稱-粉紅色-XL",
"spec": {
"name": "商品尺寸",
"selectedValue": "XL"
},
"attributes": [
{
"name": "顏色",
"values": [
"粉色系"
]
},
{
"name": "商品尺寸",
"values": [
"XL號"
]
}
],
"isVisible": true,
"stock": 1,
"partNo": "商品料號",
"barcode": "725272730706",
"images": [
{
"height": 1000,
"order": 1,
"url": "https://s.yimg.com/cl/api/res/1.2/..I0BCkmwpo1TbSb2C7ODA--/YXBwaWQ9dHdzcG1hbGw7dz0xMDAwO2g9MTAwMA--/https://s.yimg.com/bp/Files/683ad340890cb1757794c7f7691cb2d93d4319ee_1000x1000.jpg.cf.jpg",
"width": 1000
},
{
"height": 400,
"order": 1,
"url": "https://s.yimg.com/cl/api/res/1.2/p5RyNIIKNjom5AFwOgYO5w--/YXBwaWQ9dHdzcG1hbGw7dz00MDA7aD00MDA-/https://s.yimg.com/bp/Files/683ad340890cb1757794c7f7691cb2d93d4319ee_1000x1000.jpg.cf.jpg",
"width": 400
},
{
"height": 250,
"order": 1,
"url": "https://s.yimg.com/cl/api/res/1.2/F.VWuQkAJNptMAl6n8ygkg--/YXBwaWQ9dHdzcG1hbGw7dz0yNTA7aD0yNTA-/https://s.yimg.com/bp/Files/683ad340890cb1757794c7f7691cb2d93d4319ee_1000x1000.jpg.cf.jpg",
"width": 250
},
{
"height": 135,
"order": 1,
"url": "https://s.yimg.com/cl/api/res/1.2/8Dq6eqcjK8NQBzLwEd.QxQ--/YXBwaWQ9dHdzcG1hbGw7dz0xMzU7aD0xMzU-/https://s.yimg.com/bp/Files/683ad340890cb1757794c7f7691cb2d93d4319ee_1000x1000.jpg.cf.jpg",
"width": 135
},
{
"height": 80,
"order": 1,
"url": "https://s.yimg.com/cl/api/res/1.2/HJ67cnZZU618JFylVTV59A--/YXBwaWQ9dHdzcG1hbGw7dz04MDtoPTgw/https://s.yimg.com/bp/Files/683ad340890cb1757794c7f7691cb2d93d4319ee_1000x1000.jpg.cf.jpg",
"width": 80
},
{
"height": 1000,
"order": 2,
"url": "https://s.yimg.com/cl/api/res/1.2/J_lmLlBNY4nxJWUJrUJdgg--/YXBwaWQ9dHdzcG1hbGw7dz0xMDAwO2g9MTAwMA--/https://s.yimg.com/bp/Files/021704884b14d4adaa9525e5ac65aa4874331d15_1000x1000.jpg.cf.jpg",
"width": 1000
},
{
"height": 400,
"order": 2,
"url": "https://s.yimg.com/cl/api/res/1.2/f1IuNTzEjNcb7xvuTcRnFg--/YXBwaWQ9dHdzcG1hbGw7dz00MDA7aD00MDA-/https://s.yimg.com/bp/Files/021704884b14d4adaa9525e5ac65aa4874331d15_1000x1000.jpg.cf.jpg",
"width": 400
},
{
"height": 250,
"order": 2,
"url": "https://s.yimg.com/cl/api/res/1.2/Nk4FM51HzYAZVXVXj.WDIg--/YXBwaWQ9dHdzcG1hbGw7dz0yNTA7aD0yNTA-/https://s.yimg.com/bp/Files/021704884b14d4adaa9525e5ac65aa4874331d15_1000x1000.jpg.cf.jpg",
"width": 250
},
{
"height": 135,
"order": 2,
"url": "https://s.yimg.com/cl/api/res/1.2/aq6PYrMIMn5p7fMSBYxyeg--/YXBwaWQ9dHdzcG1hbGw7dz0xMzU7aD0xMzU-/https://s.yimg.com/bp/Files/021704884b14d4adaa9525e5ac65aa4874331d15_1000x1000.jpg.cf.jpg",
"width": 135
},
{
"height": 80,
"order": 2,
"url": "https://s.yimg.com/cl/api/res/1.2/N9iTLQ4yQRXywXJ7nZNpzQ--/YXBwaWQ9dHdzcG1hbGw7dz04MDtoPTgw/https://s.yimg.com/bp/Files/021704884b14d4adaa9525e5ac65aa4874331d15_1000x1000.jpg.cf.jpg",
"width": 80
}
]
}
],
"spec": {
"name": "顏色",
"selectedValue": "粉紅色"
}
}
],
"modifiedTs": "2022-01-04T08:39:03Z",
"modifier": "modifier-id",
"products": [
{
"cost": "80.00",
"id": 6677904,
"images": [
{
"height": 1000,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/876984D7CB-SP-484183.jpg",
"width": 1000
},
{
"height": 400,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/247B558373-SP-484183.jpg",
"width": 400
},
{
"height": 250,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/B6C4A9754D-SP-484183.jpg",
"width": 250
},
{
"height": 135,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/93D1DB3A3A-SP-484183.jpg",
"width": 135
},
{
"height": 80,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/9D119726D1-SP-484183.jpg",
"width": 80
},
{
"height": 1000,
"order": 2,
"url": "https://s.yimg.com/zo/MerchandiseImages/7D92C6556F-SP-484183.jpg",
"width": 1000
},
{
"height": 400,
"order": 2,
"url": "https://s.yimg.com/zo/MerchandiseImages/8D938FA040-SP-484183.jpg",
"width": 400
}
],
"name": "雙層宅配賣場-白色系-2L",
"parentSpec": {
"name": "顏色",
"selectedValue": "白色系"
},
"sku": 6677904,
"spec": {
"name": "商品尺寸",
"selectedValue": "2L"
},
"stock": 10,
"availableCount": 10,
"structuredData": {
"attributes": [
{
"name": "商品品牌",
"values": [
"5th STREET"
]
},
{
"name": "顏色",
"values": [
"白色系"
]
},
{
"name": "商品尺寸",
"values": [
"2L"
]
}
],
"struDataAttrClusterId": "000003414671"
},
"isExpiringItem": false,
"isInstallRequired": false,
"isNeedRecycle": false,
"minPackingCount": 1,
"taxable": true,
"msrp": "100.00",
"brand": "品牌",
"catId": "cat430",
"catItemId": "catItem10070",
"isSoftGame": false,
"shipType": {
"id": 1,
"type": "Home"
}
},
{
"cost": "80.00",
"id": 6677905,
"images": [
{
"height": 1000,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/876984D7CB-SP-484183.jpg",
"width": 1000
},
{
"height": 400,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/247B558373-SP-484183.jpg",
"width": 400
},
{
"height": 250,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/B6C4A9754D-SP-484183.jpg",
"width": 250
},
{
"height": 135,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/93D1DB3A3A-SP-484183.jpg",
"width": 135
},
{
"height": 80,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/9D119726D1-SP-484183.jpg",
"width": 80
},
{
"height": 1000,
"order": 2,
"url": "https://s.yimg.com/zo/MerchandiseImages/7D92C6556F-SP-484183.jpg",
"width": 1000
},
{
"height": 400,
"order": 2,
"url": "https://s.yimg.com/zo/MerchandiseImages/8D938FA040-SP-484183.jpg",
"width": 400
}
],
"name": "雙層宅配賣場-白色系-693",
"parentSpec": {
"name": "顏色",
"selectedValue": "白色系"
},
"sku": 6677905,
"spec": {
"name": "商品尺寸",
"selectedValue": "693"
},
"stock": 10,
"availableCount": 10,
"structuredData": {
"attributes": [
{
"name": "商品品牌",
"values": [
"5th STREET"
]
},
{
"name": "顏色",
"values": [
"白色系"
]
},
{
"name": "商品尺寸",
"values": [
"693"
]
}
],
"struDataAttrClusterId": "000003414671"
},
"isExpiringItem": false,
"isInstallRequired": false,
"isNeedRecycle": false,
"minPackingCount": 1,
"taxable": true,
"msrp": "100.00",
"brand": "品牌",
"catId": "cat430",
"catItemId": "catItem10070",
"isSoftGame": false,
"shipType": {
"id": 1,
"type": "Home"
}
},
{
"cost": "80.00",
"id": 6677906,
"images": [
{
"height": 1000,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/ECC24EC118-SP-484183.jpg",
"width": 1000
},
{
"height": 400,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/3E57694544-SP-484183.jpg",
"width": 400
},
{
"height": 250,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/F4F663B8A8-SP-484183.jpg",
"width": 250
},
{
"height": 135,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/AB651ADB0A-SP-484183.jpg",
"width": 135
},
{
"height": 80,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/7B397A0C6C-SP-484183.jpg",
"width": 80
},
{
"height": 1000,
"order": 2,
"url": "https://s.yimg.com/zo/MerchandiseImages/3AE2CF332F-SP-484183.jpg",
"width": 1000
},
{
"height": 400,
"order": 2,
"url": "https://s.yimg.com/zo/MerchandiseImages/9645CDE9D5-SP-484183.jpg",
"width": 400
}
],
"name": "雙層宅配賣場-米色系-2L",
"parentSpec": {
"name": "顏色",
"selectedValue": "米色系"
},
"sku": 6677906,
"spec": {
"name": "商品尺寸",
"selectedValue": "2L"
},
"stock": 10,
"availableCount": 10,
"structuredData": {
"attributes": [
{
"name": "商品品牌",
"values": [
"5th STREET"
]
},
{
"name": "顏色",
"values": [
"米色系"
]
},
{
"name": "商品尺寸",
"values": [
"2L"
]
}
],
"struDataAttrClusterId": "000003414671"
},
"isExpiringItem": false,
"isInstallRequired": false,
"isNeedRecycle": false,
"minPackingCount": 1,
"taxable": true,
"msrp": "100.00",
"brand": "品牌",
"catId": "cat430",
"catItemId": "catItem10070",
"isSoftGame": false,
"shipType": {
"id": 1,
"type": "Home"
}
},
{
"cost": "80.00",
"id": 6677907,
"images": [
{
"height": 1000,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/ECC24EC118-SP-484183.jpg",
"width": 1000
},
{
"height": 400,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/3E57694544-SP-484183.jpg",
"width": 400
},
{
"height": 250,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/F4F663B8A8-SP-484183.jpg",
"width": 250
},
{
"height": 135,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/AB651ADB0A-SP-484183.jpg",
"width": 135
},
{
"height": 80,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/7B397A0C6C-SP-484183.jpg",
"width": 80
},
{
"height": 1000,
"order": 2,
"url": "https://s.yimg.com/zo/MerchandiseImages/3AE2CF332F-SP-484183.jpg",
"width": 1000
},
{
"height": 400,
"order": 2,
"url": "https://s.yimg.com/zo/MerchandiseImages/9645CDE9D5-SP-484183.jpg",
"width": 400
}
],
"name": "雙層宅配賣場-米色系-693",
"parentSpec": {
"name": "顏色",
"selectedValue": "米色系"
},
"sku": 6677907,
"spec": {
"name": "商品尺寸",
"selectedValue": "693"
},
"stock": 10,
"availableCount": 10,
"structuredData": {
"attributes": [
{
"name": "商品品牌",
"values": [
"5th STREET"
]
},
{
"name": "顏色",
"values": [
"米色系"
]
},
{
"name": "商品尺寸",
"values": [
"693"
]
}
],
"struDataAttrClusterId": "000003414671"
},
"isExpiringItem": false,
"isInstallRequired": false,
"isNeedRecycle": false,
"minPackingCount": 1,
"taxable": true,
"msrp": "100.00",
"brand": "品牌",
"catId": "cat430",
"catItemId": "catItem10070",
"isSoftGame": false,
"shipType": {
"id": 1,
"type": "Home"
}
}
],
"reviewStatus": "draft",
"subStationId": "sub10",
"subStationName": "subStationName-name",
"supplierId": 99999
}
新建賣場屬性調整提案單 - 無屬性調整為單層賣場
- 新增屬性商品:白色系 (6677909)
- 新增屬性商品:芋頭紫。規格表內容選擇
紫色系
,但可使用spec.selectedValue
調整
賣場頁顯示的屬性名稱為芋頭紫
- 賣場頁顯示的屬性名稱 (
models[1].spec.selectedValue
):芋頭紫 - 規格表內容 (
models[1].attributes[0].values[0]
):紫色系
- 賣場頁顯示的屬性名稱 (
POST /api/spa/v1/proposal/updateListingModels HTTP/1.1
HOST: tw.supplier.yahoo.com
Content-Type: application/json; charset=UTF-8
{
"applicant": "applicant-name",
"listing": {
"id": 3438380
},
"models": [
{
"sku": 6677909,
"spec": {
"name": "顏色",
"selectedValue": "白色系"
},
"isVisible": false,
"name": "單層宅配賣場-白色系",
"attributes": [
{
"name": "顏色",
"values": [
"白色系"
]
}
]
},
{
"spec": {
"name": "顏色",
"selectedValue": "芋頭紫"
},
"attributes": [
{
"name": "顏色",
"values": [
"紫色系"
]
}
],
"isVisible": true,
"stock": 1,
"partNo": "商品料號",
"barcode": "725272730706",
"images": [
{
"url": "https://s.yimg.com/bp/Files/683ad340890cb1757794c7f7691cb2d93d4319ee_1000x1000.jpg",
"order": 1
},
{
"url": "https://s.yimg.com/bp/Files/021704884b14d4adaa9525e5ac65aa4874331d15_1000x1000.jpg",
"order": 2
}
]
}
]
}
欄位說明:
diff
可得知此賣場- 新加入
6677909
屬性商品 - 新增
芋頭紫
屬性商品,該商品 sku 將於提案執行完成後由 API 自動產生
- 新加入
product
可得到此提案賣場的 1 個屬性 - 白色系 (6677909) 的商品詳細資訊,芋頭紫
屬
性商品則於提案執行完成後才會顯示models
為賣場最後呈現的屬性內容,即此賣場有白色系和芋頭紫屬性,但白色系屬性isVisible
被設為 false,所以賣場頁白色系屬性將被隱藏起來,僅顯示芋頭紫屬性
{
"applicant": "applicant-name",
"contactWindow": "contactWindow-name",
"createdTs": "2022-01-04T08:39:03Z",
"creator": "creator-id",
"diff": {
"added": [
{
"sku": 6677909,
"spec": {
"name": "顏色",
"selectedValue": "白色系"
},
"isVisible": false,
"name": "單層宅配賣場-白色系",
"attributes": [
{
"name": "顏色",
"values": [
"白色系"
]
}
]
},
{
"name": "賣場名稱-芋頭紫",
"spec": {
"name": "顏色",
"selectedValue": "芋頭紫"
},
"attributes": [
{
"name": "顏色",
"values": [
"紫色系"
]
}
],
"isVisible": true,
"stock": 1,
"partNo": "商品料號",
"barcode": "725272730706",
"images": [
{
"height": 1000,
"order": 1,
"url": "https://s.yimg.com/cl/api/res/1.2/..I0BCkmwpo1TbSb2C7ODA--/YXBwaWQ9dHdzcG1hbGw7dz0xMDAwO2g9MTAwMA--/https://s.yimg.com/bp/Files/683ad340890cb1757794c7f7691cb2d93d4319ee_1000x1000.jpg.cf.jpg",
"width": 1000
},
{
"height": 400,
"order": 1,
"url": "https://s.yimg.com/cl/api/res/1.2/p5RyNIIKNjom5AFwOgYO5w--/YXBwaWQ9dHdzcG1hbGw7dz00MDA7aD00MDA-/https://s.yimg.com/bp/Files/683ad340890cb1757794c7f7691cb2d93d4319ee_1000x1000.jpg.cf.jpg",
"width": 400
},
{
"height": 250,
"order": 1,
"url": "https://s.yimg.com/cl/api/res/1.2/F.VWuQkAJNptMAl6n8ygkg--/YXBwaWQ9dHdzcG1hbGw7dz0yNTA7aD0yNTA-/https://s.yimg.com/bp/Files/683ad340890cb1757794c7f7691cb2d93d4319ee_1000x1000.jpg.cf.jpg",
"width": 250
},
{
"height": 135,
"order": 1,
"url": "https://s.yimg.com/cl/api/res/1.2/8Dq6eqcjK8NQBzLwEd.QxQ--/YXBwaWQ9dHdzcG1hbGw7dz0xMzU7aD0xMzU-/https://s.yimg.com/bp/Files/683ad340890cb1757794c7f7691cb2d93d4319ee_1000x1000.jpg.cf.jpg",
"width": 135
},
{
"height": 80,
"order": 1,
"url": "https://s.yimg.com/cl/api/res/1.2/HJ67cnZZU618JFylVTV59A--/YXBwaWQ9dHdzcG1hbGw7dz04MDtoPTgw/https://s.yimg.com/bp/Files/683ad340890cb1757794c7f7691cb2d93d4319ee_1000x1000.jpg.cf.jpg",
"width": 80
},
{
"height": 1000,
"order": 2,
"url": "https://s.yimg.com/cl/api/res/1.2/J_lmLlBNY4nxJWUJrUJdgg--/YXBwaWQ9dHdzcG1hbGw7dz0xMDAwO2g9MTAwMA--/https://s.yimg.com/bp/Files/021704884b14d4adaa9525e5ac65aa4874331d15_1000x1000.jpg.cf.jpg",
"width": 1000
},
{
"height": 400,
"order": 2,
"url": "https://s.yimg.com/cl/api/res/1.2/f1IuNTzEjNcb7xvuTcRnFg--/YXBwaWQ9dHdzcG1hbGw7dz00MDA7aD00MDA-/https://s.yimg.com/bp/Files/021704884b14d4adaa9525e5ac65aa4874331d15_1000x1000.jpg.cf.jpg",
"width": 400
},
{
"height": 250,
"order": 2,
"url": "https://s.yimg.com/cl/api/res/1.2/Nk4FM51HzYAZVXVXj.WDIg--/YXBwaWQ9dHdzcG1hbGw7dz0yNTA7aD0yNTA-/https://s.yimg.com/bp/Files/021704884b14d4adaa9525e5ac65aa4874331d15_1000x1000.jpg.cf.jpg",
"width": 250
},
{
"height": 135,
"order": 2,
"url": "https://s.yimg.com/cl/api/res/1.2/aq6PYrMIMn5p7fMSBYxyeg--/YXBwaWQ9dHdzcG1hbGw7dz0xMzU7aD0xMzU-/https://s.yimg.com/bp/Files/021704884b14d4adaa9525e5ac65aa4874331d15_1000x1000.jpg.cf.jpg",
"width": 135
},
{
"height": 80,
"order": 2,
"url": "https://s.yimg.com/cl/api/res/1.2/N9iTLQ4yQRXywXJ7nZNpzQ--/YXBwaWQ9dHdzcG1hbGw7dz04MDtoPTgw/https://s.yimg.com/bp/Files/021704884b14d4adaa9525e5ac65aa4874331d15_1000x1000.jpg.cf.jpg",
"width": 80
}
]
}
]
},
"executeStatus": "idle",
"expiredTs": "2022-01-18T16:00:00Z",
"id": 599399,
"listing": {
"applyLowGpm": false,
"id": 3438380,
"isThresholdFreebie": false,
"shareMediaBetweenModels": false,
"syncProductImages": true,
"origLayer": 0
},
"models": [
{
"isVisible": false,
"sku": 6677909,
"spec": {
"name": "顏色",
"selectedValue": "白色系"
},
"name": "單層宅配賣場-白色系",
"attributes": [
{
"name": "顏色",
"values": [
"白色系"
]
}
]
},
{
"name": "賣場名稱-芋頭紫",
"spec": {
"name": "顏色",
"selectedValue": "芋頭紫"
},
"attributes": [
{
"name": "顏色",
"values": [
"紫色系"
]
}
],
"isVisible": true,
"stock": 1,
"partNo": "商品料號",
"barcode": "725272730706",
"images": [
{
"height": 1000,
"order": 1,
"url": "https://s.yimg.com/cl/api/res/1.2/..I0BCkmwpo1TbSb2C7ODA--/YXBwaWQ9dHdzcG1hbGw7dz0xMDAwO2g9MTAwMA--/https://s.yimg.com/bp/Files/683ad340890cb1757794c7f7691cb2d93d4319ee_1000x1000.jpg.cf.jpg",
"width": 1000
},
{
"height": 400,
"order": 1,
"url": "https://s.yimg.com/cl/api/res/1.2/p5RyNIIKNjom5AFwOgYO5w--/YXBwaWQ9dHdzcG1hbGw7dz00MDA7aD00MDA-/https://s.yimg.com/bp/Files/683ad340890cb1757794c7f7691cb2d93d4319ee_1000x1000.jpg.cf.jpg",
"width": 400
},
{
"height": 250,
"order": 1,
"url": "https://s.yimg.com/cl/api/res/1.2/F.VWuQkAJNptMAl6n8ygkg--/YXBwaWQ9dHdzcG1hbGw7dz0yNTA7aD0yNTA-/https://s.yimg.com/bp/Files/683ad340890cb1757794c7f7691cb2d93d4319ee_1000x1000.jpg.cf.jpg",
"width": 250
},
{
"height": 135,
"order": 1,
"url": "https://s.yimg.com/cl/api/res/1.2/8Dq6eqcjK8NQBzLwEd.QxQ--/YXBwaWQ9dHdzcG1hbGw7dz0xMzU7aD0xMzU-/https://s.yimg.com/bp/Files/683ad340890cb1757794c7f7691cb2d93d4319ee_1000x1000.jpg.cf.jpg",
"width": 135
},
{
"height": 80,
"order": 1,
"url": "https://s.yimg.com/cl/api/res/1.2/HJ67cnZZU618JFylVTV59A--/YXBwaWQ9dHdzcG1hbGw7dz04MDtoPTgw/https://s.yimg.com/bp/Files/683ad340890cb1757794c7f7691cb2d93d4319ee_1000x1000.jpg.cf.jpg",
"width": 80
},
{
"height": 1000,
"order": 2,
"url": "https://s.yimg.com/cl/api/res/1.2/J_lmLlBNY4nxJWUJrUJdgg--/YXBwaWQ9dHdzcG1hbGw7dz0xMDAwO2g9MTAwMA--/https://s.yimg.com/bp/Files/021704884b14d4adaa9525e5ac65aa4874331d15_1000x1000.jpg.cf.jpg",
"width": 1000
},
{
"height": 400,
"order": 2,
"url": "https://s.yimg.com/cl/api/res/1.2/f1IuNTzEjNcb7xvuTcRnFg--/YXBwaWQ9dHdzcG1hbGw7dz00MDA7aD00MDA-/https://s.yimg.com/bp/Files/021704884b14d4adaa9525e5ac65aa4874331d15_1000x1000.jpg.cf.jpg",
"width": 400
},
{
"height": 250,
"order": 2,
"url": "https://s.yimg.com/cl/api/res/1.2/Nk4FM51HzYAZVXVXj.WDIg--/YXBwaWQ9dHdzcG1hbGw7dz0yNTA7aD0yNTA-/https://s.yimg.com/bp/Files/021704884b14d4adaa9525e5ac65aa4874331d15_1000x1000.jpg.cf.jpg",
"width": 250
},
{
"height": 135,
"order": 2,
"url": "https://s.yimg.com/cl/api/res/1.2/aq6PYrMIMn5p7fMSBYxyeg--/YXBwaWQ9dHdzcG1hbGw7dz0xMzU7aD0xMzU-/https://s.yimg.com/bp/Files/021704884b14d4adaa9525e5ac65aa4874331d15_1000x1000.jpg.cf.jpg",
"width": 135
},
{
"height": 80,
"order": 2,
"url": "https://s.yimg.com/cl/api/res/1.2/N9iTLQ4yQRXywXJ7nZNpzQ--/YXBwaWQ9dHdzcG1hbGw7dz04MDtoPTgw/https://s.yimg.com/bp/Files/021704884b14d4adaa9525e5ac65aa4874331d15_1000x1000.jpg.cf.jpg",
"width": 80
}
]
}
],
"modifiedTs": "2022-01-04T08:39:03Z",
"modifier": "modifier-id",
"products": [
{
"cost": "80.00",
"id": 6677909,
"images": [
{
"height": 1000,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/876984D7CB-SP-484183.jpg",
"width": 1000
},
{
"height": 400,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/247B558373-SP-484183.jpg",
"width": 400
},
{
"height": 250,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/B6C4A9754D-SP-484183.jpg",
"width": 250
},
{
"height": 135,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/93D1DB3A3A-SP-484183.jpg",
"width": 135
},
{
"height": 80,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/9D119726D1-SP-484183.jpg",
"width": 80
},
{
"height": 1000,
"order": 2,
"url": "https://s.yimg.com/zo/MerchandiseImages/7D92C6556F-SP-484183.jpg",
"width": 1000
},
{
"height": 400,
"order": 2,
"url": "https://s.yimg.com/zo/MerchandiseImages/8D938FA040-SP-484183.jpg",
"width": 400
}
],
"name": "單層宅配賣場-白色系",
"sku": 6677909,
"spec": {
"name": "顏色",
"selectedValue": "白色系"
},
"stock": 10,
"availableCount": 10,
"structuredData": {
"attributes": [
{
"name": "商品品牌",
"values": [
"5th STREET"
]
},
{
"name": "顏色",
"values": [
"白色系"
]
},
{
"name": "商品尺寸",
"values": [
"2L"
]
}
],
"struDataAttrClusterId": "000003414671"
},
"isExpiringItem": false,
"isInstallRequired": false,
"isNeedRecycle": false,
"minPackingCount": 1,
"taxable": true,
"msrp": "100.00",
"brand": "品牌",
"catId": "cat430",
"catItemId": "catItem10070",
"isSoftGame": false,
"shipType": {
"id": 1,
"type": "Home"
}
}
],
"reviewStatus": "draft",
"subStationId": "sub10",
"subStationName": "subStationName-name",
"supplierId": 99999
}
新建賣場屬性調整提案單 - 修改買就送贈品/任選贈品/加價購商品
- 買就送贈品提案
- 原賣場不存在買就送贈品分類,將由 API 自動產生
complimentary.models[].spec.name
- 調整贈品:
- 有屬性贈品:
- 新增「新增的買就送贈品一」並且新增「新增的紅色」(SKU 1)
- 新增買就送贈品屬性
complimentary.models[0].sku
此欄位不需填寫將由 API 自動產生
- 新增買就送贈品屬性
- 新增「新增的買就送贈品一」並且新增「新增的紅色」(SKU 1)
- 無屬性贈品:
- 新增「新增的買就送贈品二」(SKU 1)
- 有屬性贈品:
- 原賣場不存在買就送贈品分類,將由 API 自動產生
- 任選贈品提案
- 原賣場存在既有任選贈品分類,
selectComplimentary.models[].spec.name
將由 API 自動帶入贈品分類名稱 - 調整賣場任選贈品必選數量為 2
- 調整贈品:
- 有屬性贈品:
- 任選贈品屬性「既有的買就送贈品一」 (SKU 12345)
- 新增「新增的紅色」 (SKU 1)、移除「既有的黑色」 (SKU 3)、調整「既有的深藍色」的顯示名稱為「調整的藍色」 (SKU 2)、調整「既有的深藍色」的短標題「贈品一深藍色」為「贈品一藍色」 (SKU 2)
- 新增贈品屬性「新增的任選贈品四」並且新增「新增的黃色」(SKU 4)
- 新增任選贈品屬性
selectComplimentary.models[3].sku
此欄位不需填寫將由 API 自動產生
- 新增任選贈品屬性
- 既有贈品屬性「既有的任選贈品五」 (SKU 12346)
- 移除「既有的黑色」(SKU 3)
- 任選贈品屬性「既有的買就送贈品一」 (SKU 12345)
- 無屬性贈品:
- 新增「新增的任選贈品二」(SKU 1)
- 移除「既有的任選贈品四」(SKU 3)
- 調整「既有的任選贈品3」(SKU 2) 的顯示名稱為「既有的任選贈品三」
- 調整「既有的任選贈品3」(SKU 2) 的短標題「贈品3」為「贈品三」
- 有屬性贈品:
- 原賣場存在既有任選贈品分類,
- 加價購提案
- 調整加價購商品 (無屬性概念)
- 新增「新增的加價購十一」(SKU 11)
- 移除「既有的加價購十二」(SKU 12)
- 調整「既有的加價購十一」(SKU 11) 的顯示名稱為 「既有的加價購11」,
並且售價由「120」調整為 「150」
- 調整加價購商品 (無屬性概念)
POST /api/spa/v1/proposal/updateListingModels HTTP/1.1
HOST: tw.supplier.yahoo.com
Content-Type: application/json; charset=UTF-8
{
"applicant": "測試",
"listing": {
"id": 3401834
},
"complimentary": {
"models": [
{
"spec": {
"selectedValue": "新增的買就送贈品一"
},
"items": [
{
"sku": 1,
"spec": {
"selectedValue": "新增的紅色"
},
"shortTitle": "贈品一紅色"
}
]
},
{
"sku": 1,
"spec": {
"selectedValue": "新增的買就送贈品二"
},
"shortTitle": "贈品二"
}
]
},
"selectComplimentary": {
"selectedMinQty": 2,
"models": [
{
"sku": 12345,
"spec": {
"selectedValue": "既有的任選贈品一"
},
"items": [
{
"sku": 1,
"spec": {
"selectedValue": "新增的紅色"
},
"shortTitle": "贈品一紅色"
},
{
"sku": 2,
"spec": {
"selectedValue": "既有的藍色"
},
"shortTitle": "贈品一藍色"
}
]
},
{
"sku": 1,
"spec": {
"selectedValue": "新增的任選贈品二"
},
"shortTitle": "贈品二"
},
{
"sku": 2,
"spec": {
"selectedValue": "既有的任選贈品三"
},
"shortTitle": "贈品三"
},
{
"spec": {
"selectedValue": "新增的任選贈品四"
},
"items": [
{
"sku": 4,
"spec": {
"selectedValue": "新增的黃色"
},
"shortTitle": "贈品四黃色"
}
]
}
]
},
"additionalPurchases": [
{
"sku": 11,
"spec": {
"selectedValue": "新增的加價購十一"
},
"price": "100.00"
},
{
"sku": 11,
"spec": {
"selectedValue": "既有的加價購11"
},
"price": "150.00"
}
]
}
- 買就送贈品:
complimentaryDiff
可得知此賣場欄位差異:- added
- 有屬性贈品:
- 新增「新增的買就送贈品一」並且新增「新增的紅色」(SKU 1)
- 無屬性贈品:
- 新增「新增的買就送贈品二」(SKU 1)
- 有屬性贈品:
- added
complimentary
為賣場最後呈現的買就送贈品內容
- 任選贈品:
selectComplimentaryDiff
可得知此賣場欄位差異:- added
- 有屬性贈品:
- 既有贈品屬性「既有的任選贈品一」(SKU 12345)
- 新增「新增的紅色」 (SKU 1)
- 新增贈品屬性「新增的任選贈品四」並且新增「新增的黃色」(SKU 4)
- 既有贈品屬性「既有的任選贈品一」(SKU 12345)
- 無屬性贈品:
- 新增「新增的任選贈品二」(SKU 1)
- 有屬性贈品:
- removed
- 有屬性贈品:
- 既有贈品屬性「既有的任選贈品一」(SKU 12345)
- 移除「既有的黑色」 (SKU 3)
- 既有贈品屬性「既有的任選贈品一」(SKU 12345)
- 無屬性贈品:
- 移除「既有的任選贈品四」(SKU 3)
- 有屬性贈品:
- updated
- 有屬性贈品:
- 既有贈品屬性「既有的任選贈品一」(SKU 12345)
- 調整「既有的深藍色」的顯示名稱為「調整的藍色」 (SKU 2)
- 調整「既有的深藍色」的短標題「贈品一深藍色」為「贈品一藍色」 (SKU 2)
- 既有贈品屬性「既有的任選贈品一」(SKU 12345)
- 無屬性贈品:
- 調整「既有的任選贈品3」(SKU 2) 的顯示名稱為「既有的任選贈品三」
- 調整「既有的任選贈品3」(SKU 2) 的短標題「贈品3」為「贈品三」
- 有屬性贈品:
- updatedField
- 調整賣場任選贈品必選數量為 2
- added
selectComplimentary
為賣場最後呈現的任選贈品內容
- 加價購商品:
additionalPurchasesDiff
可得知此賣場欄位差異:- added
- 新增「新增的加價購十一」(SKU 11)
- updated
- 調整「既有的加價購十一」(SKU 11) 的顯示名稱為 「既有的加價購11」,
並且售價由「120」調整為 「150」
- 調整「既有的加價購十一」(SKU 11) 的顯示名稱為 「既有的加價購11」,
- removed
- 移除「既有的加價購十二」(SKU 12)
- added
additionalPurchases
為賣場最後呈現的加價購商品內容
{
"id": 427984,
"supplierId": 4866,
"listing": {
"id": 3401834,
"shareMediaBetweenModels": false,
"origLayer": 1
},
"subStationId": "sub10",
"subStationName": "subName",
"complimentary": {
"models": [
{
"spec": {
"name": "贈品買就送",
"selectedValue": "新增的買就送贈品一"
},
"items": [
{
"sku": 1,
"spec": {
"name": "配件屬性",
"selectedValue": "新增的紅色"
},
"shortTitle": "贈品一紅色"
}
]
},
{
"sku": 1,
"spec": {
"name": "贈品買就送",
"selectedValue": "新增的買就送贈品二"
},
"shortTitle": "贈品二"
}
]
},
"selectComplimentary": {
"selectedMinQty": 2,
"models": [
{
"sku": 12345,
"spec": {
"name": "任選贈品分類名稱",
"selectedValue": "既有的任選贈品一"
},
"items": [
{
"sku": 1,
"spec": {
"name": "配件屬性",
"selectedValue": "新增的紅色"
},
"shortTitle": "贈品一紅色"
},
{
"sku": 2,
"spec": {
"name": "配件屬性",
"selectedValue": "既有的藍色"
},
"shortTitle": "贈品一藍色"
}
]
},
{
"sku": 1,
"spec": {
"name": "任選贈品分類名稱",
"selectedValue": "新增的任選贈品二"
},
"shortTitle": "贈品二"
},
{
"sku": 2,
"spec": {
"name": "任選贈品分類名稱",
"selectedValue": "既有的任選贈品三"
},
"shortTitle": "贈品三"
},
{
"spec": {
"name": "任選贈品分類名稱",
"selectedValue": "新增的任選贈品四"
},
"items": [
{
"sku": 4,
"spec": {
"name": "配件屬性",
"selectedValue": "新增的黃色"
},
"shortTitle": "贈品四黃色"
}
]
}
]
},
"additionalPurchases": [
{
"sku": 11,
"spec": {
"name": "超值加購",
"selectedValue": "新增的加價購十一"
},
"price": "100.00"
},
{
"sku": 11,
"spec": {
"name": "既有的加價購",
"selectedValue": "既有的加價購11"
},
"price": "150.00"
}
],
"applicant": "測試",
"applicantRole": "supplier",
"expiredTs": "2020-10-02T16:00:00Z",
"contactWindow": "polly888",
"createdTs": "2020-09-18T11:31:53Z",
"creator": "mwu02",
"modifiedTimes": 1,
"modifiedTs": "2020-09-18T11:32:00Z",
"modifier": "foo",
"executeStatus": "idle",
"reviewStatus": "draft",
"note": "我是備註",
"complimentaryDiff": {
"added": [
{
"spec": {
"name": "贈品買就送",
"selectedValue": "新增的買就送贈品一"
},
"items": [
{
"spec": {
"name": "配件屬性",
"selectedValue": "新增的紅色"
},
"sku": 1,
"shortTitle": "贈品一紅色"
}
]
},
{
"sku": 1,
"spec": {
"name": "贈品買就送",
"selectedValue": "新增的買就送贈品二"
},
"shortTitle": "贈品二"
}
]
},
"selectComplimentaryDiff": {
"added": [
{
"sku": 12345,
"spec": {
"name": "任選贈品分類名稱",
"selectedValue": "既有的任選贈品一"
},
"items": [
{
"spec": {
"name": "配件屬性",
"selectedValue": "新增的紅色"
},
"sku": 1,
"shortTitle": "贈品一紅色"
}
]
},
{
"sku": 1,
"spec": {
"name": "任選贈品分類名稱",
"selectedValue": "新增的任選贈品二"
},
"shortTitle": "贈品二"
},
{
"spec": {
"name": "任選贈品分類名稱",
"selectedValue": "新增的任選贈品四"
},
"items": [
{
"spec": {
"name": "配件屬性",
"selectedValue": "新增的黃色"
},
"sku": 4,
"shortTitle": "贈品四黃色"
}
]
}
],
"removed": [
{
"sku": 12345,
"spec": {
"name": "任選贈品分類名稱",
"selectedValue": "既有的任選贈品一"
},
"items": [
{
"sku": 3,
"spec": {
"name": "配件屬性",
"selectedValue": "既有的黑色"
},
"shortTitle": "贈品一黑色"
}
]
},
{
"sku": 3,
"spec": {
"name": "任選贈品分類名稱",
"selectedValue": "既有的任選贈品四"
},
"shortTitle": "贈品四"
},
{
"sku": 12346,
"spec": {
"name": "任選贈品分類名稱",
"selectedValue": "既有的任選贈品五"
},
"items": [
{
"sku": 3,
"spec": {
"name": "配件屬性",
"selectedValue": "既有的黑色"
},
"shortTitle": "贈品五黑色"
}
]
}
],
"updated": [
{
"sku": 2,
"origin": {
"spec": {
"name": "配件屬性",
"selectedValue": "既有的深藍色"
},
"parentSku": 12345,
"shortTitle": "贈品一深藍色"
},
"outcome": {
"spec": {
"name": "配件屬性",
"selectedValue": "調整的藍色"
},
"parentSku": 12345,
"shortTitle": "贈品一藍色"
}
},
{
"sku": 2,
"origin": {
"spec": {
"name": "任選贈品分類名稱",
"selectedValue": "既有的任選贈品3"
},
"shortTitle": "贈品"
},
"outcome": {
"spec": {
"name": "任選贈品分類名稱",
"selectedValue": "既有的任選贈品三"
},
"shortTitle": "贈品三"
}
}
],
"updatedField": [
{
"field": "selectedMinQty",
"origin": "1",
"outcome": "2"
}
]
},
"additionalPurchasesDiff": {
"added": [
{
"sku": 11,
"spec": {
"name": "超值加購",
"selectedValue": "新增的加價購十一"
},
"price": 100
}
],
"removed": [
{
"sku": 12,
"spec": {
"name": "既有的加價購",
"selectedValue": "既有的加價購十二"
}
}
],
"updated": [
{
"sku": 11,
"origin": {
"spec": {
"name": "既有的加價購",
"selectedValue": "既有的加價購十一"
},
"price": "120.00"
},
"outcome": {
"spec": {
"name": "既有的加價購",
"selectedValue": "既有的加價購11"
},
"price": "150.00"
}
}
]
},
"products": [
{
"sku": 1,
"name": "紅色",
"cost": "0.00",
"availableCount": 10,
"stock": 10,
"spec": {
"name": "顏色",
"selectedValue": "紅色"
},
"images": [
{
"height": 1000,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/9F87C829B5-SP-461416.jpg",
"width": 1000
},
{
"height": 400,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/A5D0648705-SP-461416.jpg",
"width": 400
},
{
"height": 250,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/5617007E8C-SP-461416.jpg",
"width": 250
},
{
"height": 135,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/5D4A126E16-SP-461416.jpg",
"width": 135
},
{
"height": 80,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/E643D566B5-SP-461416.jpg",
"width": 80
},
{
"height": 1000,
"order": 2,
"url": "https://s.yimg.com/zo/MerchandiseImages/DC76470F8B-SP-461416.jpg",
"width": 1000
},
{
"height": 400,
"order": 2,
"url": "https://s.yimg.com/zo/MerchandiseImages/CAA5D48015-SP-461416.jpg",
"width": 400
}
],
"structuredData": {
"attributes": [
{
"name": "顏色",
"values": [
"紅色"
]
},
{
"name": "商品尺寸",
"values": [
"M號"
]
},
{
"name": "產地",
"values": [
"中國"
]
}
],
"struDataAttrClusterId": "000003414671"
}
},
{
"sku": 2,
"name": "藍色",
"cost": "0.00",
"availableCount": 10,
"stock": 10,
"spec": {
"name": "顏色",
"selectedValue": "藍色"
},
"images": [
{
"height": 1000,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/9F87C829B5-SP-461416.jpg",
"width": 1000
},
{
"height": 400,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/A5D0648705-SP-461416.jpg",
"width": 400
},
{
"height": 250,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/5617007E8C-SP-461416.jpg",
"width": 250
},
{
"height": 135,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/5D4A126E16-SP-461416.jpg",
"width": 135
},
{
"height": 80,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/E643D566B5-SP-461416.jpg",
"width": 80
},
{
"height": 1000,
"order": 2,
"url": "https://s.yimg.com/zo/MerchandiseImages/DC76470F8B-SP-461416.jpg",
"width": 1000
},
{
"height": 400,
"order": 2,
"url": "https://s.yimg.com/zo/MerchandiseImages/CAA5D48015-SP-461416.jpg",
"width": 400
}
],
"structuredData": {
"attributes": [
{
"name": "顏色",
"values": [
"藍色"
]
},
{
"name": "產地",
"values": [
"中國"
]
},
{
"name": "商品尺寸",
"values": [
"L號"
]
}
],
"struDataAttrClusterId": "000003414671"
}
},
{
"sku": 3,
"name": "黑色",
"cost": "0.00",
"availableCount": 10,
"stock": 10,
"spec": {
"name": "顏色",
"selectedValue": "黑色"
},
"images": [
{
"height": 1000,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/9F87C829B5-SP-461416.jpg",
"width": 1000
},
{
"height": 400,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/A5D0648705-SP-461416.jpg",
"width": 400
},
{
"height": 250,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/5617007E8C-SP-461416.jpg",
"width": 250
},
{
"height": 135,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/5D4A126E16-SP-461416.jpg",
"width": 135
},
{
"height": 80,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/E643D566B5-SP-461416.jpg",
"width": 80
},
{
"height": 1000,
"order": 2,
"url": "https://s.yimg.com/zo/MerchandiseImages/DC76470F8B-SP-461416.jpg",
"width": 1000
},
{
"height": 400,
"order": 2,
"url": "https://s.yimg.com/zo/MerchandiseImages/CAA5D48015-SP-461416.jpg",
"width": 400
}
],
"structuredData": {
"attributes": [
{
"name": "顏色",
"values": [
"黑色"
]
},
{
"name": "產地",
"values": [
"中國"
]
},
{
"name": "商品尺寸",
"values": [
"L號"
]
}
],
"struDataAttrClusterId": "000003414671"
}
},
{
"sku": 4,
"name": "黃色",
"cost": "0.00",
"availableCount": 10,
"stock": 10,
"spec": {
"name": "顏色",
"selectedValue": "黃色"
},
"images": [
{
"height": 1000,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/9F87C829B5-SP-461416.jpg",
"width": 1000
},
{
"height": 400,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/A5D0648705-SP-461416.jpg",
"width": 400
},
{
"height": 250,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/5617007E8C-SP-461416.jpg",
"width": 250
},
{
"height": 135,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/5D4A126E16-SP-461416.jpg",
"width": 135
},
{
"height": 80,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/E643D566B5-SP-461416.jpg",
"width": 80
},
{
"height": 1000,
"order": 2,
"url": "https://s.yimg.com/zo/MerchandiseImages/DC76470F8B-SP-461416.jpg",
"width": 1000
},
{
"height": 400,
"order": 2,
"url": "https://s.yimg.com/zo/MerchandiseImages/CAA5D48015-SP-461416.jpg",
"width": 400
}
],
"structuredData": {
"attributes": [
{
"name": "顏色",
"values": [
"黃色"
]
},
{
"name": "產地",
"values": [
"中國"
]
},
{
"name": "商品尺寸",
"values": [
"L號"
]
}
],
"struDataAttrClusterId": "000003414671"
}
},
{
"sku": 11,
"name": "粉紅色",
"cost": "0.00",
"availableCount": 10,
"stock": 10,
"spec": {
"name": "顏色",
"selectedValue": "粉紅色"
},
"images": [
{
"height": 1000,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/9F87C829B5-SP-461416.jpg",
"width": 1000
},
{
"height": 400,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/A5D0648705-SP-461416.jpg",
"width": 400
},
{
"height": 250,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/5617007E8C-SP-461416.jpg",
"width": 250
},
{
"height": 135,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/5D4A126E16-SP-461416.jpg",
"width": 135
},
{
"height": 80,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/E643D566B5-SP-461416.jpg",
"width": 80
},
{
"height": 1000,
"order": 2,
"url": "https://s.yimg.com/zo/MerchandiseImages/DC76470F8B-SP-461416.jpg",
"width": 1000
},
{
"height": 400,
"order": 2,
"url": "https://s.yimg.com/zo/MerchandiseImages/CAA5D48015-SP-461416.jpg",
"width": 400
}
],
"structuredData": {
"attributes": [
{
"name": "顏色",
"values": [
"粉紅色"
]
},
{
"name": "產地",
"values": [
"中國"
]
},
{
"name": "商品尺寸",
"values": [
"L號"
]
}
],
"struDataAttrClusterId": "000003414671"
}
},
{
"sku": 12,
"name": "紫色",
"cost": "0.00",
"availableCount": 10,
"stock": 10,
"spec": {
"name": "顏色",
"selectedValue": "紫色"
},
"images": [
{
"height": 1000,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/9F87C829B5-SP-461416.jpg",
"width": 1000
},
{
"height": 400,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/A5D0648705-SP-461416.jpg",
"width": 400
},
{
"height": 250,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/5617007E8C-SP-461416.jpg",
"width": 250
},
{
"height": 135,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/5D4A126E16-SP-461416.jpg",
"width": 135
},
{
"height": 80,
"order": 1,
"url": "https://s.yimg.com/zo/MerchandiseImages/E643D566B5-SP-461416.jpg",
"width": 80
},
{
"height": 1000,
"order": 2,
"url": "https://s.yimg.com/zo/MerchandiseImages/DC76470F8B-SP-461416.jpg",
"width": 1000
},
{
"height": 400,
"order": 2,
"url": "https://s.yimg.com/zo/MerchandiseImages/CAA5D48015-SP-461416.jpg",
"width": 400
}
],
"structuredData": {
"attributes": [
{
"name": "顏色",
"values": [
"紫色"
]
},
{
"name": "產地",
"values": [
"中國"
]
},
{
"name": "商品尺寸",
"values": [
"L號"
]
}
],
"struDataAttrClusterId": "000003414671"
}
}
]
}