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

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

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

  • 购买数量:最小购买数量(如果有)<= 第一阶梯数量(tier-1)<= 第二阶梯数量(tier-2) <= 第三阶梯数量(tier-3)
  • 商品单价:常规售价 > 第一阶梯价格 (tier-1)> 第二阶梯价格(tier-2) > 第三阶梯价格(tier-3)
  • 运费设置:第一阶梯价格 (tier-1)> =第二阶梯价格(tier-2) > =第三阶梯价格(tier-3)

以下例子详细说明了对于商品A进行的商品批量折扣的设置:

  • 购买数量为2-4个时,商品单价为$10
  • 购买数量为 5-9 个时,商品单价为$8
  • 购买数量为 10个及以上时, 商品单价为$5

商品批量折扣结构:

级数 数量 价格/商品 可接受的运费设置举例 不可接受的运费设置举例
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 固定值: SubmitVolumeDiscountRespons
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