商品批量折扣的創建、更新及移除

商品批量折扣是基於訂單中某商品數量而做得一種價格調整。通過設置批量折扣。商家能夠給批量購買商品的客戶更多優惠。

新蛋商城的商品批量折扣可設置三個梯度。批量折扣的創建和調整只能根據下面規則來提交：

  • 購買數量：最小購買數量（如果有）≤ 第一階梯數量（tier-1）< 第二階梯數量（tier-2）< 第三階梯數量（tier-3）
  • 商品單價：常規售價 > 第一階梯價格（tier-1）> 第二階梯價格（tier-2）> 第三階梯價格（tier-3）
  • 運費設置：第一階梯價格（tier-1）≥ 第二階梯價格（tier-2）≥ 第三階梯價格（tier-3）

以下例子詳細說明了對於商品A進行的商品批量折扣的設置：

  • 購買數量為2-4個時，商品單價為$10.00。
  • 購買數量為 5-9 個時，商品單價$8.00。
  • 購買數量為 10個及以上時， 商品單價為$5.00。

商品批量折扣結構：

級數 數量 價格/商品 可接受的運費設置舉例 不可接受的運費設置舉例
1 2 $10.00 Default Default Default Free Default Free
2 5 $8.00 Default Default Free Default Free Default
3 10 $5.00 Default Free Free Default Default Free

註：

  • 如果正在進行的促銷價格低於第一階梯單價，那麼批量折扣設置將無效。
  • 只適用於運送目的地為美國的商品

相關URL

Newegg.com: https://api.newegg.com/marketplace/contentmgmt/item/volumediscount?sellerid={sellerid}
Neweggbusiness.com: https://api.newegg.com/marketplace/b2b/contentmgmt/item/volumediscount?sellerid={sellerid}
Newegg.ca: https://api.newegg.com/marketplace/can/contentmgmt/item/volumediscount?sellerid={sellerid}

註：請確保您的請求URL全都是小寫（除Seller ID）並且不能包含任何空格或者分行符號。

參數

名稱 是否必填？ 描述
sellerid 是 您在新蛋商城的商家編號

相關請求資訊

HTTP方式 是否需要認證？ 請求格式 回覆格式 頻率限制
POST 需要 XML,Json XML,Json 100 請求/小時

請求文件主體

屬性 是否必填？ 格式 描述
OperationType 是 String 固定值：SubmitVolumeDiscountRequest
SellerPartNumber 否 String Seller Part# 商家商品編號
NeweggItemNumber 否 String NE Item# 新蛋商品編號
VolumeActivation 否 String 有效值：

  • True：創建或者更新批量折扣
  • False：刪除批量折扣
Priority 是 Integer 為商品批量折扣設置階梯
Quantity 是 Integer 為當前階梯的商品批量折扣設置階梯數量
SellingPrice 是 Decimal 為當前階梯的商品批量折扣設置階梯單價
EnableFreeShipping 是 Integer 有效值：

  • 0：Default
  • 1：Free

Schema: SubmitVolumeDiscountRequest.xsd

示例：XML, Request

POST https://api.newegg.com/marketplace/can/contentmgmt/item/volumediscount?sellerid={SellerID}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml

<NeweggAPIRequest>
    <OperationType/>
    <RequestBody>
        <ItemVolumeDiscountInfo>
            <NeweggItemNumber>9SIA0010287920</NeweggItemNumber>
            <VolumeActivation>true</VolumeActivation>
            <DiscountSetting>
                <Tier>
                    <Priority>1</Priority>
                    <Quantity>12</Quantity>
                    <SellingPrice>110</SellingPrice>
                    <EnableFreeShipping>0</EnableFreeShipping>
                </Tier>
                <Tier>
                    <Priority>2</Priority>
                    <Quantity>20</Quantity>
                    <SellingPrice>105</SellingPrice>
                    <EnableFreeShipping>0</EnableFreeShipping>
                </Tier>
            </DiscountSetting>
        </ItemVolumeDiscountInfo>
    </RequestBody>
</NeweggAPIRequest>

示例：Json, Request

POST https://api.newegg.com/marketplace/can/contentmgmt/item/volumediscount?sellerid={SellerID}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json

{
    "OperationType": "",
    "RequestBody": {
        "ItemVolumeDiscountInfo": {
            "NeweggItemNumber": "9SIA0010287920",
            "VolumeActivation": "true",
            "DiscountSetting": {
                "Tier": [
                    {
                        "Priority": "1",
                        "Quantity": "12",
                        "SellingPrice": "110",
                        "EnableFreeShipping": "0"
                    },
                    {
                        "Priority": "2",
                        "Quantity": "20",
                        "SellingPrice": "105",
                        "EnableFreeShipping": "0"
                    }
                ]
            }
        }
    }
}

回覆文件主體

屬性 格式 描述
IsSuccess String 用於確認操作是否成功
固定值：True
SellerID String 您的商家編號
OperationType String 固定值： SubmitVolumeDiscountResponse
SellerPartNumber String Seller Part#
NeweggItemNumber String NE Item#
Priority Integer 為商品批量折扣設置階梯
Quantity Integer 為當前階梯的商品批量折扣設置階梯數量
SellingPrice Decimal 為當前階梯的商品批量折扣設置階梯單價
EnableFreeShipping Integer 為當前階梯的商品批量折扣設置運輸方式

Schema: SubmitVolumeDiscountResponse.xsd

示例: XML, Response

<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
    <IsSuccess>true</IsSuccess>
    <OperationType>SubmitVolumeDiscountResponse</OperationType>
    <SellerID>a001</SellerID>
    <ResponseBody>
        <ItemVolumeDiscountInfo>
            <SellerPartNumber>B0147001</SellerPartNumber>
            <NeweggItemNumber>9SIA0010287920</NeweggItemNumber>
            <DiscountSetting>
                <Tier>
                    <Priority>1</Priority>
                    <Quantity>12</Quantity>
                    <SellingPrice>110</SellingPrice>
                    <EnableFreeShipping>0</EnableFreeShipping>
                </Tier>
                <Tier>
                    <Priority>2</Priority>
                    <Quantity>20</Quantity>
                    <SellingPrice>105</SellingPrice>
                    <EnableFreeShipping>0</EnableFreeShipping>
                </Tier>
            </DiscountSetting>
        </ItemVolumeDiscountInfo>
    </ResponseBody>
</NeweggAPIResponse>

示例: Json, Response

{
  "NeweggAPIResponse": {
    "IsSuccess": "true",
    "OperationType": "SubmitVolumeDiscountResponse",
    "SellerID": "a001",
    "ResponseBody": {
      "ItemVolumeDiscountInfo": {
        "SellerPartNumber": "B0147001",
        "NeweggItemNumber": "9SIA0010287920",
        "DiscountSetting": {
          "Tier": [
            {
              "Priority": "1",
              "Quantity": "12",
              "SellingPrice": "110",
              "EnableFreeShipping": "0"
            },
            {
              "Priority": "2",
              "Quantity": "20",
              "SellingPrice": "105",
              "EnableFreeShipping": "0"
            }
          ]
        }
      }
    }
  }
}

請求失敗錯誤資訊

常規HTTP錯誤回應，請參考回覆失敗錯誤代碼清單。

錯誤代碼 描述
CT001 Invalid ItemNumber
無效的商品編號。
CT002 Invalid SellerPartNumber
無效的Seller Part#。
CT058 Invalid 1st tier quantity. Item has minimum quantity, the 1st tier quantity should be an integer and greater than or equal to minimum quantity [{0}] 無效的第 1 階梯數量。商品有最小數量時，第一級折扣時的購買數量應為一個整數，並且大於或等於最小 購買數量(minimum quantity)[{0}]。
CT059 Item number or seller part# is required.
商品編號或 Seller Part#必填。
CT060 Not found. The requested item does not have volume discount yet.
找不到相關資訊。請求中的商品當前沒有設置商品批量折扣。
CT061 The volume quantity must following this condition: 1 pc < 1st Qty < 2nd Qty < 3rd Qty {0}.
商品批量折扣階梯數量必須滿足：1 pc < 1st Qty < 2nd Qty < 3rd Qty {0}。
CT062 The volume price must following this condition: general selling price > 1st Price > 2nd Price > 3rd Price {0}.
商品批量折扣價格必須滿足：general selling price > 1st Price > 2nd Price > 3rd Price {0}。
CT063 Invalid shipping method on {0}.
無效的運輸方式。
CT064 The tiers of volume discount are fractured please set from tier 1 one by one.
商品批量折扣的分級有誤，請從第一級階梯一個一個開始設置。
CT066 Item had been restricted, you cannot add volume discount.
該商品是受限商品，不能添加商品批量折扣。

示例: XML, Response

<?xml version="1.0" encoding="utf-8"?>
<Errors>
    <Error>
        <Code>CT001</Code>
        <Message>Invalid ItemNumber</Message>
    </Error>
</Errors>

示例: Json, Response

[
    {
        "Code": "CT001",
        "Message": "Invalid ItemNumber"
    }
]

更新日期： 10/15/2018