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

商品批量折扣是基于订单中某商品数量而做得一种价格调整。通过设置批量折扣，商家能够给批量购买商品的客户更多优惠。

新蛋商城的商品批量折扣可设置三个梯度。批量折扣的创建和调整只能根据下面规则来提交：

  • 购买数量：最小购买数量（如果有）≤ 第一阶梯数量（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