取得賣場屬性調整提案單

取得賣場屬性調整提案 #

取得賣場屬性調整提案單 #

取得已建立的 賣場屬性調整提案單

Endpoint URL: https://tw.supplier.yahoo.com/api/spa/v1/proposal/updateListingModels/{id}
HTTP Method: GET

Request Parameters #

id #

提案單號。
資料型態: Integer
必填: 是

fields #

於查詢時同時要求回傳附加欄位,目前支援的欄位包括:

  • +products 回傳欄位 xxx, yyy 中相關的商品資訊

資料型態: String
必填: 否

Response Syntax #

{
  "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,
  "id": number,
  "listing": {
    "id": number,
    "origLayer": number
  },
  "models": [
    {
      "spec": {
        "name": string,
        "selectedValue": string
      },
      "sku": number,
      "items": [
        {
          "id": 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
      }
    ]
  },
  "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
      }
    ]
  },
  "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
      }
    ]
  },
  "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": [
          {
            "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
      }
    ]
  },
  "additionalPurchases": [
    {
      "sku": number,
      "spec": {
        "name": string,
        "selectedValue": string
      },
      "price": 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
        }
      }
    ]
  },
  "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": [
      {
        "sku": number,
        "spec": {
          "name": string,
          "selectedValue": string
        },
        "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
              ]
            }
          ]
        }
      }
    ]
  },
  "products": [
    {
      "id": number,
      "sku": number,
      "supplierId": number,
      "name": string,
      "cost": string,
      "stock": number,
      "availableCount": number,
      "images": [
        {
          "url": string,
          "width": number,
          "height": number,
          "order": number
        }
      ],
      "structuredData": {
        "attributes": [
          {
            "name": string,
            "values": [
              string
            ]
          }
        ],
        "struDataAttrClusterId": string
      },
      "spec": {
        "name": string,
        "selectedValue": string
      },
      "parentSpec": {
        "name": string,
        "selectedValue": 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 層屬性項目的商品名稱
  • attributes:第 1 層屬性項目的規格表屬性

資料型態: ProposalModel[]

diff #

儲存提案時賣場屬性與提案內容的差異。diff 的結構包含:

  • added 表示提案新增的賣場屬性及新增的商品資訊,結構請參考 ProposalModel
  • removed 表示移除的賣場既有屬性,結構請參考 ListingModel
  • updated 表示更新的賣場既有屬性

資料型態: 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

取得未提供短標題修改功能時所產生之提案,shortTitle 將為空

complimentaryDiff #

儲存提案時賣場買就送贈品與提案買就送贈品內容的差異。詳情請參考 欄位說明
complimentaryDiff 的結構包含:

  • added 表示提案新增的買就送贈品資訊,結構請參考 ProposalModel
  • removed 表示移除的賣場既有買就送贈品,結構請參考 ListingModel
  • updated 表示更新的賣場既有買就送贈品,結構請參考 ProposalUpdatedSku

資料型態: 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

取得未提供短標題修改功能時所產生之提案,shortTitle 將為空

selectComplimentaryDiff #

儲存提案時賣場任選贈品與提案任選贈品內容的差異。詳情請參考 欄位說明
selectComplimentaryDiff 的結構包含:

  • added 表示提案新增的任選贈品資訊,結構請參考 ProposalModel
  • removed 表示移除的賣場既有任選贈品,結構請參考 ListingModel
  • updated 表示更新的賣場既有任選贈品,結構請參考 ProposalUpdatedSku
  • updatedField 表示提案內容更新的任選贈品欄位,結構請參考 ProposalUpdatedField

資料型態: ProposalSkuDiff

additionalPurchases #

加價購的內容。

  • sku:加價購商品編號
  • spec:
    • name:加價購分類名稱。若原賣場存在既有加價購分類,將由 API 自動帶入加價購分類名稱,反之將由 API 自動產生
    • selectedValue:加價購顯示名稱
  • price:加價購商品售價

資料型態: ProposalModel[]

additionalPurchasesDiff #

儲存提案時賣場加價購與提案加價購內容的差異。詳情請參考 欄位說明
additionalPurchasesDiff 的結構包含:

  • added 表示提案新增的加價購商品資訊,結構請參考 ProposalModel
  • removed 表示移除的賣場既有加價購商品,結構請參考 ListingModel
  • updated 表示更新的賣場既有加價購商品,結構請參考 ProposalUpdatedSku

資料型態: 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
有效值: 詳見 審核狀態

note #

備註。
資料型態: String

suggestion #

改善或建議。
資料型態: 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 商品可售數量

Errors #

Bad Request #

輸入的參數不符合 API 定義的 Pattern。
HTTP Status Code: 400

Error Code Description
0 Invalid input
40000005 Contains illegal character(s)

Unauthorized #

身分認證不通過,請檢查您的 Cookiewssid
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

Not Found #

找不到提案單內容。
HTTP Status Code: 404

Error Code Description
40409000 Proposal not found

Internal Server Error #

API 端發生錯誤,若持續發生請洽您的業務窗口。

Examples #

取得提案單號為 427984 的提案單
GET /api/spa/v1/proposal/updateListingModels/427984 HTTP/1.1
HOST: tw.supplier.yahoo.com
Content-Type: application/json; charset=UTF-8
{
  "applicant": "applicant-name",
  "contactWindow": "contact-windows-id",
  "creator": "creator-id",
  "createdTs": "2020-09-18T11:31:53Z",
  "executeStatus": "idle",
  "executedTs": "2020-09-18T11:32:00Z",
  "expiredTs": "2020-10-02T16:00:00Z",
  "modifiedTimes": 1,
  "modifiedTs": "2020-09-18T11:32:00Z",
  "modifier": "modifier-id",
  "reviewStatus": "draft",
  "supplierId": 99999,
  "note": "proposal-note",
  "id": 427984,
  "listing": {
    "id": 3401834,
    "origLayer": 1
  },
  "models": [
    {
      "sku": 6645988,
      "spec": {
        "name": "商品尺寸",
        "selectedValue": "S號"
      },
      "isVisible": true,
      "name": "product-S",
      "attributes": [
        {
          "name": "商品尺寸",
          "values": [
              "S"
          ]
        }
      ]
    },
    {
      "sku": 6645989,
      "spec": {
        "name": "商品尺寸",
        "selectedValue": "M號"
      },
      "isVisible": true,
      "name": "product-M",
      "attributes": [
        {
          "name": "商品尺寸",
          "values": [
            "M"
          ]
        }
      ]
    },
    {
      "sku": 6645990,
      "spec": {
        "name": "商品尺寸",
        "selectedValue": "L號"
      },
      "isVisible": true,
      "name": "product-L",
      "attributes": [
        {
          "name": "商品尺寸",
          "values": [
            "L"
          ]
        }
      ]
    },
    {
      "name": "賣場名稱-F",
      "spec": {
        "name": "商品尺寸",
        "selectedValue": "F"
      },
      "attributes": [
        {
          "name": "商品尺寸",
          "values": [
            "Free Size"
          ]
        }
      ],
      "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
        }
      ]
    }
  ],
  "diff": {
    "added": [
      {
        "name": "賣場名稱-F",
        "spec": {
          "name": "商品尺寸",
          "selectedValue": "F"
        },
        "attributes": [
          {
            "name": "商品尺寸",
            "values": [
              "Free Size"
            ]
          }
        ],
        "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": [
      {
        "sku": 6645991,
        "spec": {
          "name": "商品尺寸",
          "selectedValue": "XL號"
        },
        "isVisible": true,
        "name": "product-XL",
        "attributes": [
          {
            "name": "商品尺寸",
            "values": [
              "XL"
            ]
          }
        ]
      }
    ]
  }
}
取得提案單號為 427987 的提案單,並且取得提案單的額外欄位 products
GET /api/spa/v1/proposal/updateListingModels/427987?fields=%2Bproducts HTTP/1.1
HOST: tw.supplier.yahoo.com
Content-Type: application/json; charset=UTF-8
{
  "applicant": "applicant-name",
  "contactWindow": "contact-windows-id",
  "creator": "creator-id",
  "createdTs": "2020-09-18T11:31:53Z",
  "executeStatus": "idle",
  "executedTs": "2020-09-18T11:32:00Z",
  "expiredTs": "2020-10-02T16:00:00Z",
  "modifiedTimes": 1,
  "modifiedTs": "2020-09-18T11:32:00Z",
  "modifier": "modifier-id",
  "reviewStatus": "draft",
  "supplierId": 99999,
  "note": "proposal-note",
  "id": 427987,
  "listing": {
    "id": 3401834,
    "origLayer": 1
  },
  "models": [
    {
      "sku": 6645988,
      "spec": {
        "name": "商品尺寸",
        "selectedValue": "S號"
      },
      "isVisible": true,
      "name": "product-name",
      "attributes": [
        {
          "name": "商品尺寸",
          "values": [
            "S"
          ]
        }
      ]
    }
  ],
  "diff": {
    "removed": [
      {
        "sku": 6645991,
        "spec": {
          "name": "商品尺寸",
          "selectedValue": "XL號"
        },
        "isVisible": true,
        "name": "product-name",
        "attributes": [
          {
            "name": "商品尺寸",
            "values": [
              "XL號"
            ]
          }
        ]
      }
    ]
  },
  "products": [
    {
      "cost": "10.00",
      "id": 6645988,
      "images": [
        {
          "height": 1000,
          "order": 1,
          "url": "https://s.yimg.com/zo/MerchandiseImages/9f87c829b5-Product-6677150.jpg",
          "width": 1000
        },
        {
          "height": 400,
          "order": 1,
          "url": "https://s.yimg.com/zo/MerchandiseImages/a5d0648705-Product-6677150.jpg",
          "width": 400
        },
        {
          "height": 250,
          "order": 1,
          "url": "https://s.yimg.com/zo/MerchandiseImages/5617007e8c-Product-6677150.jpg",
          "width": 250
        },
        {
          "height": 135,
          "order": 1,
          "url": "https://s.yimg.com/zo/MerchandiseImages/5d4a126e16-Product-6677150.jpg",
          "width": 135
        },
        {
          "height": 80,
          "order": 1,
          "url": "https://s.yimg.com/zo/MerchandiseImages/e643d566b5-Product-6677150.jpg",
          "width": 80
        },
        {
          "height": 1000,
          "order": 2,
          "url": "https://s.yimg.com/zo/MerchandiseImages/dc76470f8b-Product-6677150.jpg",
          "width": 1000
        },
        {
          "height": 400,
          "order": 2,
          "url": "https://s.yimg.com/zo/MerchandiseImages/caa5d48015-Product-6677150.jpg",
          "width": 400
        }
      ],
      "name": "product-name",
      "sku": 6645988,
      "spec": {
        "name": "商品尺寸",
        "selectedValue": "S號"
      },
      "stock": 10,
      "availableCount": 10,
      "structuredData": {
        "attributes": [
          {
            "name": "顏色",
            "values": [
              "白色系"
            ]
          },
          {
            "name": "產地",
            "values": [
              "台灣"
            ]
          },
          {
            "name": "商品尺寸",
            "values": [
              "S"
            ]
          }
        ],
        "struDataAttrClusterId": "000003414671"
      },
      "isExpiringItem": false,
      "isInstallRequired": true,
      "isNeedRecycle": true,
      "minPackingCount": 1,
      "taxable": true,
      "msrp": "100.00",
      "brand": "品牌",
      "length": 55,
      "width": 66,
      "height": 77,
      "weight": 88,
      "preserveDays": 56,
      "catId": "cat430",
      "catItemId": "catItem10070",
      "isSoftGame": false,
      "shipType": {
        "id": 61,
        "type": "Express24HR"
      }
    },
    {
      "cost": "10.00",
      "id": 6645991,
      "images": [
        {
          "height": 1000,
          "order": 1,
          "url": "https://s.yimg.com/zo/MerchandiseImages/52CE0DA2A8-SP-481564.jpg",
          "width": 1000
        },
        {
          "height": 400,
          "order": 1,
          "url": "https://s.yimg.com/zo/MerchandiseImages/4CD8E44971-SP-481564.jpg",
          "width": 400
        },
        {
          "height": 250,
          "order": 1,
          "url": "https://s.yimg.com/zo/MerchandiseImages/DDBBF0A9E2-SP-481564.jpg",
          "width": 250
        },
        {
          "height": 135,
          "order": 1,
          "url": "https://s.yimg.com/zo/MerchandiseImages/CFD4959487-SP-481564.jpg",
          "width": 135
        },
        {
          "height": 80,
          "order": 1,
          "url": "https://s.yimg.com/zo/MerchandiseImages/8A0FB65D9C-SP-481564.jpg",
          "width": 80
        },
        {
          "height": 1000,
          "order": 2,
          "url": "https://s.yimg.com/zo/MerchandiseImages/AD48DF0C11-SP-481564.jpg",
          "width": 1000
        },
        {
          "height": 400,
          "order": 2,
          "url": "https://s.yimg.com/zo/MerchandiseImages/95A9155AFD-SP-481564.jpg",
          "width": 400
        }
      ],
      "name": "product-name",
      "sku": 6645991,
      "spec": {
        "name": "商品尺寸",
        "selectedValue": "XL號"
      },
      "stock": 10,
      "availableCount": 10,
      "structuredData": {
        "attributes": [
          {
            "name": "顏色",
            "values": [
              "灰色系"
            ]
          },
          {
            "name": "產地",
            "values": [
              "台灣"
            ]
          },
          {
            "name": "商品尺寸",
            "values": [
              "XL號"
            ]
          }
        ],
        "struDataAttrClusterId": "000003414671"
      },
      "isExpiringItem": false,
      "isInstallRequired": true,
      "isNeedRecycle": true,
      "minPackingCount": 1,
      "taxable": true,
      "msrp": "100.00",
      "brand": "品牌",
      "length": 55,
      "width": 66,
      "height": 77,
      "weight": 88,
      "preserveDays": 56,
      "catId": "cat430",
      "catItemId": "catItem10070",
      "isSoftGame": false,
      "shipType": {
        "id": 61,
        "type": "Express24HR"
      }
    }
  ]
}