Volume Discount Feed
Batch add/update/remove items for Volume Discount program.
Resource 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}
Note: Please make sure your request URL is all in lower case (except for Seller ID) and cannot contain any blank spaces or line breaks.
Parameters
| Name | Required? | Description |
| sellerid | Yes | Your seller ID on Newegg Marketplace |
| RequestType | Yes | Value: VOLUME_DISCOUNT_DATA |
Resource Information
| HTTP Method | Authentication? | Request Formats | Response Formats | Rate Limited? |
| POST | Required | XML, Json | XML, Json | 1000 request per hour |
Request Body
| Attribute | Required? | Format | Description |
| DocumentVersion | Yes | Decimal | Fixed value: 1.0 |
| MessageType | Yes | String | Fixed value: VolumeDiscount |
| SellerPartNumber | Yes | String | The item’s seller part number. It will be used to identify the item for opt-in/out of program. |
| NeweggItemNumber | No | String | Newegg’s unique identifier for an item |
| VolumeActivation | Yes | String | Available values:
|
| Priority | Yes | Integer | Set the tier for the volume discount |
| Quantity | Yes | Integer | Set the quantity for the tier’s volume discount |
| SellingPrice | Yes | Decimal | Set the unit price for the tier’s volume discount |
| EnableFreeShipping | Yes | Integer | Set a shipping method for the tier’s volume discount Available value:
|
Schema: VolumeDiscount.xsd
Example: 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>
Example: 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"
}
]
}
}
}
}
Response Body
| Attribute | Format | Description |
| IsSuccess | String | Get feed status operation:
|
| OperationType | String | Fixed value: SubmitFeedResponse |
| SellerID | String | Your seller ID |
| RequestType | String | Value: VOLUME_DISCOUNT_DATA |
| RequestDate | String | The date when the feed was submitted. (Pacific Standard Time) |
| RequestStatus | String | The status of the feed submission:
SUBMITTED |
| Memo | String | Additional Information |
Schema: SubmitFeedResponse.xsd
Example: 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>
Example: 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"
}
Request Failure Errors
For common HTTP error responses, please refer to Failed Response Error Code List.
| Error Code | Description |
| DF003 | The MaxCount (maximum request records) CANNOT be over 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. |
Example: 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>
Example: Json, Response
[
{
"Code": "DF003",
"Message": "The MaxCount (maximum request records) CANNOT be over 30000"
}
]
Last updated: October 15, 2018