新增賣場屬性調整提案單

賣場屬性調整提案 #

新增賣場屬性調整提案單 #

新增 賣場屬性調整提案單。

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 的屬性名稱與項目
    • 若為新增商品時，此欄將於提案執行完成後由 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 表示提案新增的賣場屬性及新增的商品資訊，結構請參考 ProposalModel
  • removed 表示移除的賣場既有屬性，結構請參考 ListingModel
  • updated 表示更新的賣場既有屬性

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 層屬性已既存於賣場，則第 1 層屬性以 parentSku 呈現。
    2. 更新的第 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 層屬性 黃色。

資料型態: 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 表示提案新增的買就送贈品資訊，結構請參考 ProposalModel
  • removed 表示移除的賣場既有買就送贈品，結構請參考 ListingModel
  • updated 表示更新的賣場既有買就送贈品，結構請參考 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 表示提案新增的任選贈品資訊，結構請參考 ProposalModel
  • removed 表示移除的賣場既有任選贈品，結構請參考 ListingModel
  • updated 表示更新的賣場既有任選贈品，結構請參考 ProposalUpdatedSku
  • updatedField 表示提案內容更新的任選贈品欄位，結構請參考 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 表示提案新增的加價購商品資訊，結構請參考 ProposalModel
  • removed 表示移除的賣場既有加價購商品，結構請參考 ListingModel
  • updated 表示更新的賣場既有加價購商品，結構請參考 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號
  • 新增屬性商品至新增的屬性：粉紅色-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號
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)
  • 任選贈品提案
    • 原賣場存在既有任選贈品分類，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 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)
    • complimentary 為賣場最後呈現的買就送贈品內容
  • 任選贈品:
    • selectComplimentaryDiff 可得知此賣場欄位差異:
      • added
        • 有屬性贈品:
          • 既有贈品屬性「既有的任選贈品一」(SKU 12345)
            • 新增「新增的紅色」 (SKU 1)
          • 新增贈品屬性「新增的任選贈品四」並且新增「新增的黃色」(SKU 4)
        • 無屬性贈品:
          • 新增「新增的任選贈品二」(SKU 1)
      • removed
        • 有屬性贈品:
          • 既有贈品屬性「既有的任選贈品一」(SKU 12345)
            • 移除「既有的黑色」 (SKU 3)
        • 無屬性贈品:
          • 移除「既有的任選贈品四」(SKU 3)
      • updated
        • 有屬性贈品:
          • 既有贈品屬性「既有的任選贈品一」(SKU 12345)
            • 調整「既有的深藍色」的顯示名稱為「調整的藍色」 (SKU 2)
            • 調整「既有的深藍色」的短標題「贈品一深藍色」為「贈品一藍色」 (SKU 2)
        • 無屬性贈品:
          • 調整「既有的任選贈品3」(SKU 2) 的顯示名稱為「既有的任選贈品三」
          • 調整「既有的任選贈品3」(SKU 2) 的短標題「贈品3」為「贈品三」
      • updatedField
        • 調整賣場任選贈品必選數量為 2
    • selectComplimentary 為賣場最後呈現的任選贈品內容
  • 加價購商品:
    • additionalPurchasesDiff 可得知此賣場欄位差異:
      • added
        • 新增「新增的加價購十一」(SKU 11)
      • updated
        • 調整「既有的加價購十一」(SKU 11) 的顯示名稱為 「既有的加價購11」，
          並且售價由「120」調整為 「150」
      • removed
        • 移除「既有的加價購十二」(SKU 12)
    • 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"
      }
    }
  ]
}