批量折扣商品管理
批量添加/更新/删除参加批量折扣活动的商品。
相关URL
Newegg.com: https://api.newegg.com/marketplace/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype={RequestType}
Neweggbusiness.com: https://api.newegg.com/marketplace/b2b/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype={RequestType}
Newegg.ca: https://api.newegg.com/marketplace/can/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype={RequestType}
注:请确保您的请求URL全都是小写(除Seller ID)并且不能包含任何空格或者换行符。
参数
| 名称 | 是否必填? | 描述 |
| sellerid | 是 | 您在新蛋商城的商家编号 |
| RequestType | 是 | 值:VOLUME_DISCOUNT_DATA |
相关请求信息
| HTTP方式 | 是否需要认证? | 请求格式 | 回复格式 | 频率限制 |
| POST | 需要 | XML,Json | XML,Json | 1000 请求/小时 |
请求文件主体
| 属性 | 是否必填? | 格式 | 描述 |
| DocumentVersion | 是 | Decimal | 固定值:1.0 |
| MessageType | 是 | String | 固定值:VolumeDiscount |
| SellerPartNumber | 是 | String | 商品的seller part#。它将用于标识该商品加入/退出该项目。 |
| NeweggItemNumber | 否 | String | 新蛋分配给每个商品的唯一标识符 |
| VolumeActivation | 是 | String | 有效值: True:添加批量折扣项目的商品或者更新项目中已存在的商品。 False:从批量折扣项目中移除商品 |
| Priority | 是 | Integer | 为批量折扣设置阶梯 |
| Quantity | 是 | Integer | 为当前阶梯的批量折扣设置商品订购数量 |
| SellingPrice | 是 | Decimal | 为当前阶梯的批量折扣设置商品单价 |
| EnableFreeShipping | 是 | Integer | 为当前阶梯的批量折扣设置运输方式。 有效值: 0:Default shipping 默认运费 1:Free shipping 免运费 |
Schema: VolumeDiscount.xsd
示例:XML,Request
POST https://api.newegg.com/marketplace/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype=VOLUME_DISCOUNT_DATA
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggEnvelope>
<Header>
<DocumentVersion>1.0</DocumentVersion>
</Header>
<MessageType>VolumeDiscount</MessageType>
<Message>
<VolumeDiscountList>
<ItemVolumeDiscountInfo>
<SellerPartNumber>Lisa123</SellerPartNumber>
<NeweggItemNumber>9SIA0060004762</NeweggItemNumber>
<VolumeActivation>True</VolumeActivation>
<DiscountSetting>
<Tier>
<Priority>1</Priority>
<Quantity>10</Quantity>
<SellingPrice>9999.99</SellingPrice>
<EnableFreeShipping>0</EnableFreeShipping>
</Tier>
<Tier>
<Priority>2</Priority>
<Quantity>20</Quantity>
<SellingPrice>8888.99</SellingPrice>
<EnableFreeShipping>0</EnableFreeShipping>
</Tier>
<Tier>
<Priority>3</Priority>
<Quantity>30</Quantity>
<SellingPrice>7777.99</SellingPrice>
<EnableFreeShipping>0</EnableFreeShipping>
</Tier>
</DiscountSetting>
</ItemVolumeDiscountInfo>
<ItemVolumeDiscountInfo>
<SellerPartNumber>789</SellerPartNumber>
<NeweggItemNumber>012</NeweggItemNumber>
<VolumeActivation>True</VolumeActivation>
<DiscountSetting>
<Tier>
<Priority>1</Priority>
<Quantity>10</Quantity>
<SellingPrice>9999.99</SellingPrice>
<EnableFreeShipping>0</EnableFreeShipping>
</Tier>
</DiscountSetting>
</ItemVolumeDiscountInfo>
<ItemVolumeDiscountInfo>
<SellerPartNumber>123</SellerPartNumber>
<VolumeActivation>True</VolumeActivation>
<DiscountSetting>
<Tier>
<Priority>1</Priority>
<Quantity>10</Quantity>
<SellingPrice>9999.99</SellingPrice>
<EnableFreeShipping>1</EnableFreeShipping>
</Tier>
</DiscountSetting>
</ItemVolumeDiscountInfo>
<ItemVolumeDiscountInfo>
<NeweggItemNumber>456</NeweggItemNumber>
<VolumeActivation>True</VolumeActivation>
<DiscountSetting>
<Tier>
<Priority>1</Priority>
<Quantity>10</Quantity>
<SellingPrice>9999.99</SellingPrice>
<EnableFreeShipping>0</EnableFreeShipping>
</Tier>
</DiscountSetting>
</ItemVolumeDiscountInfo>
<ItemVolumeDiscountInfo>
<SellerPartNumber>B0369008</SellerPartNumber>
<NeweggItemNumber>9SIA0060002417</NeweggItemNumber>
<VolumeActivation>False</VolumeActivation>
</ItemVolumeDiscountInfo>
<ItemVolumeDiscountInfo>
<SellerPartNumber>B0369008</SellerPartNumber>
<VolumeActivation>False</VolumeActivation>
</ItemVolumeDiscountInfo>
<ItemVolumeDiscountInfo>
<NeweggItemNumber>9SIA0060002417</NeweggItemNumber>
<VolumeActivation>False</VolumeActivation>
</ItemVolumeDiscountInfo>
<ItemVolumeDiscountInfo>
<SellerPartNumber>345</SellerPartNumber>
<VolumeActivation>False</VolumeActivation>
</ItemVolumeDiscountInfo>
<ItemVolumeDiscountInfo>
<NeweggItemNumber>678</NeweggItemNumber>
<VolumeActivation>False</VolumeActivation>
</ItemVolumeDiscountInfo>
</VolumeDiscountList>
</Message>
</NeweggEnvelope>
示例:Json,Request
POST https://api.newegg.com/marketplace/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype=VOLUME_DISCOUNT_DATA
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application
{
"NeweggEnvelope": {
"Header": {
"DocumentVersion": "1.0"
},
"MessageType": "VolumeDiscount",
"Message": {
"VolumeDiscountList": {
"ItemVolumeDiscountInfo": [
{
"SellerPartNumber": "Lisa123",
"NeweggItemNumber": "9SIA0060004762",
"VolumeActivation": "True",
"DiscountSetting": {
"Tier": [
{
"Priority": "1",
"Quantity": "10",
"SellingPrice": "9999.99",
"EnableFreeShipping": "0"
},
{
"Priority": "2",
"Quantity": "20",
"SellingPrice": "8888.99",
"EnableFreeShipping": "0"
},
{
"Priority": "3",
"Quantity": "30",
"SellingPrice": "7777.99",
"EnableFreeShipping": "0"
}
]
}
},
{
"SellerPartNumber": "789",
"NeweggItemNumber": "012",
"VolumeActivation": "True",
"DiscountSetting": {
"Tier": {
"Priority": "1",
"Quantity": "10",
"SellingPrice": "9999.99",
"EnableFreeShipping": "0"
}
}
},
{
"SellerPartNumber": "123",
"VolumeActivation": "True",
"DiscountSetting": {
"Tier": {
"Priority": "1",
"Quantity": "10",
"SellingPrice": "9999.99",
"EnableFreeShipping": "1"
}
}
},
{
"NeweggItemNumber": "456",
"VolumeActivation": "True",
"DiscountSetting": {
"Tier": {
"Priority": "1",
"Quantity": "10",
"SellingPrice": "9999.99",
"EnableFreeShipping": "0"
}
}
},
{
"SellerPartNumber": "B0369008",
"NeweggItemNumber": "9SIA0060002417",
"VolumeActivation": "False"
},
{
"SellerPartNumber": "B0369008",
"VolumeActivation": "False"
},
{
"NeweggItemNumber": "9SIA0060002417",
"VolumeActivation": "False"
},
{
"SellerPartNumber": "345",
"VolumeActivation": "False"
},
{
"NeweggItemNumber": "678",
"VolumeActivation": "False"
}
]
}
}
}
}
回复文件主体
| 属性 | 格式 | 描述 |
| IsSuccess | String | 获取文件状态操作: True: 成功 False: 失败 |
| OperationType | String | 固定值:SubmitFeedResponse |
| SellerID | String | 商家编号 |
| RequestType | String | 值:VOLUME_DISCOUNT_DATA |
| RequestDate | String | 文件提交的时间(太平洋标准时间) |
| RequestStatus | String | 文件提交的状态:
SUBMITTED 已提交 |
| Memo | String | 附加信息 |
Schema: SubmitFeedResponse.xsd
示例:XML,Response
<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<OperationType>SubmitFeedResponse</OperationType>
<SellerID>A006</SellerID>
<ResponseBody>
<ResponseList>
<ResponseInfo>
<RequestId>2291326430</RequestId>
<RequestType>VOLUME_DISCOUNT_DATA</RequestType>
<RequestDate>2/16/2012 12:29:19</RequestDate>
<RequestStatus>SUBMITTED</RequestStatus>
</ResponseInfo>
</ResponseList>
</ResponseBody>
<Memo />
</NeweggAPIResponse>
示例:Json,Response
{
"IsSuccess": true,
"OperationType": "SubmitFeedResponse",
"ResponseBody": {
"ResponseList": [
{
"RequestDate": "2/22/2012 17:24:35",
"RequestId": "2PQCX3CMQ82MK",
"RequestStatus": "SUBMITTED",
"RequestType": "VOLUME_DISCOUNT_DATA"
}
]
},
"SellerID": "A006"
}
请求失败错误信息
常规HTTP错误回复,请参考回复失败错误代码列表。
| 错误代码 | 描述 |
| DF003 | The MaxCount (maximum request records) CANNOT be over 30000.
最大请求数记录不能超过30000 |
| DF004 | Unfortunately, we are unable to process your request at this time. We apologize for the inconvenience. Please try again later.
很抱歉,目前我们无法处理您的请求。请您稍后再试。 |
| DF011 | Your data feed request will not be processed during the scheduled data feed processing restriction from [{begin timestamp: hh:mm:ss, MM/DD/YYYY}] to [{end timestamp: hh:mm:ss, MM/DD/YYYY}]). Please contact datafeeds@newegg.com if you have any question or concern. Thank you for your patience.
在已定的数据文件处理限制期内,从[{begin timestamp: hh:mm:ss, MM/DD/YYYY}] 到 [{end timestamp: hh:mm:ss, MM/DD/YYYY}],您的数据请求将无法被处理。如您有任何问题或者疑问,请联系datafeeds@newegg.com。 感谢您的耐心等待。 |
示例:XML,Response
<?xml version="1.0" encoding="utf-8"?>
<Errors>
<Error>
<Code>DF003</Code>
<Message>The MaxCount (maximum request records) CANNOT be over 30000</Message>
</Error>
</Errors>
示例:Json,Response
[
{
"Code": "DF003",
"Message": "The MaxCount (maximum request records) CANNOT be over 30000"
}
]
更新日期:10/15/2018