Newegg Marketplace APIDeveloper Guide V3.07

User Manual:

Open the PDF directly: View PDF PDF.
Page Count: 515 [warning: Documents this large are best viewed by clicking the View PDF Link!]

1
Newegg Marketplace API Developer Guide
Version 3.07, September 2018
2
Contents
Change History ........................................................................................................................................................................................... 4
Newegg Marketplace API ........................................................................................................................................................................... 6
1. Registering To Use API Services ................................................................................................................................................. 6
2. Newegg Marketplace API Authentication ................................................................................................................................. 7
2.1. Authentication Failure Errors ...................................................................................................................................... 8
2.2. Authorization for Third-party Developer ..................................................................................................................... 9
3. TLS Requirements for Inbound Connections ........................................................................................................................... 10
4. URL Case-sensitive................................................................................................................................................................... 10
5. Pacific Standard Time Requirement ........................................................................................................................................ 11
6. Throttling ................................................................................................................................................................................. 12
6.1. Per Seller ................................................................................................................................................................... 12
6.2. Rate Limit .................................................................................................................................................................. 12
6.3. Datafeed Limit ........................................................................................................................................................... 12
6.4. HTTP Headers and Response Codes .......................................................................................................................... 13
7. Create Your Own Client Library ............................................................................................................................................... 14
7.1. Request Format ......................................................................................................................................................... 14
7.2. Create a HTTP Request .............................................................................................................................................. 14
7.3. Bad Request ............................................................................................................................................................... 15
7.4. Code Examples .......................................................................................................................................................... 17
8. Service Status .......................................................................................................................................................................... 34
8.1. Get Service Status ...................................................................................................................................................... 34
8.2. Failover Endpoints for API Service ............................................................................................................................. 38
9. Item Management ................................................................................................................................................................... 39
9.1. Manufacturer Lookup ................................................................................................................................................ 39
9.2. Manufacturer Lookup for international country ....................................................................................................... 46
9.3. Submit Manufacturer Request .................................................................................................................................. 53
9.4. Get Manufacturer Request Status ............................................................................................................................. 58
9.5. Volume Discount Creation/Update/Removal ............................................................................................................ 62
9.6. Get Volume Discount Request Result ........................................................................................................................ 69
9.7. Get Item Inventory .................................................................................................................................................... 73
9.8. Get Item Price ............................................................................................................................................................ 79
9.9. Update Item Inventory .............................................................................................................................................. 85
9.10. Update Item Price ................................................................................................................................................. 90
9.11. Submit Item Warranty Request ........................................................................................................................... 100
10. Order Management.......................................................................................................................................................... 108
10.1. Get Order Status ................................................................................................................................................. 108
10.2. Update Order Status ........................................................................................................................................... 111
10.3. Order Confirmation ............................................................................................................................................. 121
10.4. Remove Item(s) ................................................................................................................................................... 125
3
10.5. Get Order Info ..................................................................................................................................................... 130
10.6. Get SBN (Shipped by Newegg) Order Cancellation Request Result .................................................................... 146
10.7. Get Additional Order Information ....................................................................................................................... 149
11. Newegg Shipping Label Service ........................................................................................................................................ 157
11.1. Submit Shipping Request .................................................................................................................................... 157
11.2. Get Request Detail .............................................................................................................................................. 168
11.3. Confirm Shipping Request ................................................................................................................................... 181
11.4. Void Shipping Request ........................................................................................................................................ 185
11.5. Get Package List .................................................................................................................................................. 189
11.6. Get Shipping Labels ............................................................................................................................................. 193
12. DataFeed Management .................................................................................................................................................... 198
12.1. Submit Feed ............................................................................................................................................................. 199
12.2. Get Feed Status ....................................................................................................................................................... 277
12.3. Get Feed Result ....................................................................................................................................................... 283
13. RMA Management ........................................................................................................................................................... 309
13.1. Submit RMA............................................................................................................................................................. 309
13.2. Update RMA ............................................................................................................................................................ 323
13.3. Get RMA Info ....................................................................................................................................................... 338
13.4. Issue Courtesy Refund ......................................................................................................................................... 351
13.5. Get Courtesy Refund Request Status .................................................................................................................. 355
13.6. Get Courtesy Refund Info .................................................................................................................................... 362
14. Report Management ........................................................................................................................................................ 369
14.1. Submit Report Request ....................................................................................................................................... 369
14.2. Get Report Status ................................................................................................................................................ 392
14.3. Get Report Result ................................................................................................................................................ 397
15. Seller Management .......................................................................................................................................................... 440
15.1. Get Industry List ...................................................................................................................................................... 440
15.2. Get Subcategory Status ........................................................................................................................................... 443
15.3. Get Subcategory Status for international country ................................................................................................... 448
15.4. Download Feed Schema .......................................................................................................................................... 453
15.5. Get Subcategory Properties..................................................................................................................................... 456
15.6. Get Subcategory Property Values ............................................................................................................................ 461
15.7. Seller Status Check .................................................................................................................................................. 466
16. SBN (Shipped by Newegg) Management ......................................................................................................................... 470
16.1. Get Inbound Shipment Plan Suggestion .................................................................................................................. 470
16.2. Submit Inbound Shipment Request ......................................................................................................................... 478
16.3. Get Inbound Shipment Status Request ................................................................................................................... 489
16.4. Get Inbound Shipment Request Result ................................................................................................................... 493
16.5. Get Inbound Shipment List ...................................................................................................................................... 500
16.6. Get Warehouse List ................................................................................................................................................. 507
Appendix ................................................................................................................................................................................................ 513
4
1. Common Request Headers .................................................................................................................................................... 513
2. Failed Response Error Code List ............................................................................................................................................ 513
2.1. General HTTP error code ......................................................................................................................................... 513
2.2. Common Error Response ......................................................................................................................................... 514
3. Acceptable Date Format ........................................................................................................................................................ 515
Change History
Version
Change Date
Description
09/15/2018
New API call
DataFeed Management
ITEM_CHINATAXSETTING_DATA is available to set tax type for items enabled for China,
Section 12.
Report Management
Tax setting report is available for Items Enabled for China, Section 14.
V3.07
07/24/2018
New API call
DataFeed Management
ITEM_CAPROP65_DATA is available to set the California’s Proposition 65 (“Prop 65”)
warning for items, Section 12.
Report Management
California’s Proposition 65 Warning Report is available for requesting the report for the
California’s Proposition 65 (“Prop 65”) warning for items, Section 14.
Updated API calls
Report Management
Version 310 is available for compressing multiple files into a zip formatted single package for the
following reports:
Daily Inventory Report
Daily Price Report
V3.07
06/11/2018
Updated API calls
Order Management
Additional value was added to the element of SalesChannel to identify the RMA Replacement
Order. Related functions:
Get Order Status, Section 10.1.
Get Order Info, Section 10.5.
Report Management > Get Report Result > Order List Report, section 14.3.
RMA Management
Additional element: ReplacementOrderNuber was added to identify the RMA
Replacement Order. Related functions:
5
Get RMA Info, section 13.3.
Report Management > Get Report Result > RMA List Report, section
14.3.
Additional Version 309 was added to reference the replacement order numbers for
existing return requests. Related functions:
Get RMA Info, section 13.3.
Report Management > Get Report Result > RMA List Report, section
14.3.
Report Management
Version update for Get Report Result call, section 14.3:
304 was removed.
305 was replaced by 306.
Note for existing users. API calls with antiquated version will not receve errors.
V3.07
03/19/2018
New API calls
Order Management
Get Additional Order Information. API guide > Section 10.7. This is designed for the
following:
Additional order requirement for certain countries.
The original recipient information for orders shipped by NISP service.
The original recipient information inputted by international customers.
API Request Throttling
The API request throttling for item price and inventory update has been updated. Details can be
reviewd at:
Datafeed Management. API guide > section 12.1.
6
Newegg Marketplace API
Newegg Marketplace API is a set of API services that enable sellers to manage items, orders, accounts and reports.
Please go through the following before you start:
1. Registering To User API Service
2. Newegg Marketplace API Authentication
3. SSL Requirements for Inbound Connections
4. URL Case-sensitive
5. Pacific Standard Time Requirement
6. Throttling
7. Create Your Own Client Library
The following sections define all available services in details to serve different business operations:
8. Service Status
9. Item Management
10. Order Management
11. Newegg Shipping Label Service
12. DataFeed Management
13. RMA Management
14. Reports Management
15. Seller Management
16. SBN (Shipped by Newegg) Management
1. Registering To Use API Services
If you would like to use Newegg Marketplace API services, please contact your Newegg Marketplace seller account
manager to obtain your Newegg API credentials.
Obtain your API account API Key & Secret Key once your API account request has been approved and created,
Newegg Marketplace integration team will assign and send a pair of API key and secret key to you. You must provide the
API key and the secret key per function as authentication in order to access Newegg Marketplace API services.
Authorize the access rights to 3rd party developer if you want to allow your 3rd party developer(s) to access the
Newegg Marketplace API services, with your authorization, we can assign an additional pair of API key and secret key to
the developer(s). The 3rd party developer(s) must present the additionally assigned API key and secret key in order to
access Newegg Marketplace API services on your behalf.
7
*Note: We highly recommend that you do not let any unauthorized personnel or 3rd party developers have access to
your original pair of API key and secret key. Anyone with this information can access Newegg Marketplace API services
as you. As stated before, we can issue additional API key and secret key to your 3rd party developers, but you should
keep your original key information to yourself.
2. Newegg Marketplace API Authentication
To access Newegg Marketplace API services, you must provide authentication information listed below:
Name
Required?
Description
Authorization
Yes
Format: Authorization:{authorization}
API key: the unique API Key which Newegg Marketplace integration team
assigned to you
Secretkey
Yes
Format: Secretkey:{secretkey}
Secret key: the unique Secret Key which Newegg Marketplace integration
team assigned to you
Example: XML, Request
POST https://api.newegg.com/marketplace/contentmgmt/item/inventory?sellerid=A006
Authorization: 727ddc067f4d115bd544aff46bc15634
SecretKey: 1B6B1383-01D1-4A1E-BA53-05DECE9BD765
Content-Type: application/xml
Accept: application/xml
Example: Json, Request
POST https://api.newegg.com/marketplace/contentmgmt/item/inventory?sellerid=A006
Authorization: 727ddc067f4d115bd544aff46bc15634
SecretKey: 1B6B1383-01D1-4A1E-BA53-05DECE9BD765
Content-Type: application/json
Accept: application/json
8
2.1. Authentication Failure Errors
API key authentication failure:
Description
The provided consumer key is incorrect or invalid
Example: XML, Response
<?xml version="1.0" encoding="utf-8"?>
<Errors>
<Error>
<Code>InvalidConsumerKey</Code>
<Message>The provided consumer key is incorrect or invalid.</Message>
</Error>
</Errors>
Example: Json, Response
{
"Code": "InvalidConsumerKey",
"Message": "The provided consumer key is malformed or otherwise invalid."
}
Secret Key authentication failure:
Error Code
Description
InvalidToken
SellerID is null
InvalidToken
Secret Key is null
InvalidToken
Invalid Secret Key
AccessDenied
The specified seller ID is invalid or you do not have authorization from this seller
AccessDenied
The API services for this seller account has been deactivated
Example: XML, Response
<?xml version="1.0" encoding="utf-8"?>
<Errors>
<Error>
<Code>InvalidToken</Code>
<Message>Secret Key is null.</Message>
9
</Error>
</Errors>
Example: Json, Response
{
"Code": "InvalidToken",
"Message": "The provided secret key is null."
}
2.2. Authorization for Third-party Developer
If you are a third-party developer/integration partner who wants to access and utilize Newegg Marketplace API services
for a seller, you must:
Get one API key from our Newegg Marketplace Integration Team (Datafeeds@Newegg.com)
Get the Seller ID and Secret key from the seller/Newegg that authorized the Newegg Marketplace API services
access to you, for each seller you are integrating for. (Seller and 3rd party developer can contact Newegg
Marketplace for this information)
Attach the API key and Secret key in the http header, and specify the Seller ID in the URL, and please make sure
the Secret Key is for the correct seller.
For the below example, the Secret Key must be the one corresponding to seller ID A001.
Example: XML, Request
POST https://api.newegg.com/marketplace/contentmgmt/item/inventory?sellerid=A001
Authorization: 727ddc067f4d115bd544aff46bc15634
SecretKey: 1B6B1383-01D1-4A1E-BA53-05DECE9BD765
Content-Type: application/xml
Accept: application/xml
Example: Json, Request
POST https://api.newegg.com/marketplace/contentmgmt/item/inventory?sellerid=A001
Authorization: 727ddc067f4d115bd544aff46bc15634
SecretKey: 1B6B1383-01D1-4A1E-BA53-05DECE9BD765
Content-Type: application/json
10
Accept: application/json
Otherwise the system will respond with below error message due to invalid secret key.
Example: XML, Response
<?xml version="1.0" encoding="utf-8"?>
<Errors>
<Error>
<Code>InvalidToken</Code>
<Message>Invalid secret key.</Message>
</Error>
</Errors>
Example: Json, Response
{
"Code": "InvalidToken",
"Message": "Invalid secret key."
}
3. TLS Requirements for Inbound Connections
Inbound connections to Newegg Marketplace API endpoints require TLS version 1.0 or higher.
4. URL Case-sensitive
Newegg Marketplace API URL’s are case-sensitive. Please make sure your request URL (excluding Seller ID) is all in
lower case. And the URL cannot contain any blank space or line break. Seller ID is an exception, and can be capitalized.
Example:
https://api.newegg.com/marketplace/contentmgmt/item
https://api.newegg.com/marketplace/contentmgmt/item/inventory?sellerid={sellerid}
https://api.newegg.com/marketplace/contentmgmt/item/price?sellerid={sellerid}
https://api.newegg.com/marketplace/contentmgmt/item/inventoryandprice?sellerid={sellerid}
https://api.newegg.com/marketplace/ordermgmt/orderstatus
11
https://api.newegg.com/marketplace/ordermgmt/orderstatus/orders/{ordernumber}?sellerid={sellerid}
5. Pacific Standard Time Requirement
Newegg Marketplace API requires the datetime field to be in Pacific Standard Time in all request and response content.
Please ensure in all your files and requests, the datetime field are specified in Pacific Standard Time.
The C# code example as following demonstrates how to convert your local time to a Pacific Standard Time.
Example: C#
//Your local time
System.DateTime localTimeNow = System.DateTime.Now;
//Get the PST time zone info
System.TimeZoneInfo pstTimeZoneInfo =
TimeZoneInfo.FindSystemTimeZoneById("Pacific Standard Time");
//Convert your local time to PST time
DateTime pstTime = ResolveAmbiguousOrInvalidTime(localTimeNow);
//Resolve Ambiguous or invalid time issue between PDT and PST exchange
private static DateTime ResolveAmbiguousOrInvalidTime(DateTime ambiguousOrInvalidTime)
{
TimeZoneInfo timeZoneInfo = TimeZoneInfo.FindSystemTimeZoneById("Pacific Standard
Time");
if(timeZoneInfo.IsInvalidTime(ambiguousOrInvalidTime) ||
timeZoneInfo.IsAmbiguousTime(ambiguousOrInvalidTime))
{
//DateTime utcTime = ambiguousOrInvalidTime.ToUniversalTime();
DateTime utcTime = DateTime.SpecifyKind(ambiguousOrInvalidTime -
TimeZoneInfo.Local.BaseUtcOffset,DateTimeKind.Utc);
return TimeZoneInfo.ConvertTime(utcTime, timeZoneInfo);
}
return ambiguousOrInvalidTime;
}
12
6. Throttling
Newegg Marketplace API supports large variety of application and process millions of API requests daily. To maintain stable
service with a high level of availability, Newegg Marketplace limits the API usage.
6.1. Per Seller
Rate limiting of each API request is based on per-seller basis.
6.2. Rate Limit
Rate limits are divided into minute intervals. This means you have a maximum number of requests you can submit to a
specific function in a one-minute period.
6.3. Datafeed Limit
Certain datafeed related functions have the hourly limitation of request and the maximum size of each request. This means
you have a maximum allowance of requests you can submit to a specific function in a one-hour period. And each request
cannot exceed the maximum size limitation.
Below is the response if you exceed the limit:
Example: XML, Response
<?xml version="1.0" encoding="utf-8"?>
<Errors>
<Error>
<Code>DF012</Code>
<Message>Your feed with request ID: 2291326430 exceeded the hourly allowance and cannot be
processed. Please submit your feed again after 2016-12-16 11:05:00.</Message>
</Error>
</Errors>
Example: Json, Response
{
"Code": "DF012",
13
"Message": "Your feed with request ID: 2291326430 exceeded the hourly allowance and cannot be
processed. Please submit your feed again after 2016-12-16 11:05:00."
}
6.4. HTTP Headers and Response Codes
The following elements in HTTP headers can be used for diagnosing a given rate limit for the API service endpoint.
X-RateLimit-Limit:Request limit per defined time window
X-RateLimit-Remaining: The number of requests left for the time window.
X-RateLimit-ResetTime: the time for resetting the remaining records.
X-RecordCount-Limit: the max record seller can upload.
X-RecordCount-Remaining: the # of record count left for the time window
X-RecordCount-ResetTime: the time for resetting the remaining records.
The API will return a HTTP 429 “Too Many Requests” response code, and the following error will be returned in the response
body:
Example: XML, Response
<?xml version="1.0" encoding="utf-8"?>
<Errors xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-
instance">
<Error>
<Code>429</Code>
<Message>Too many request.</Message>
</Error>
</Errors>
Example: Json, Response
[
{
"Code": "429",
"Message": "Too many request."
}
]
14
7. Create Your Own Client Library
You can create your own client library to use with the Newegg Marketplace API. Your code should construct and sign a
request in the format expected by the Newegg Marketplace API, and then you can parse the XML response.
You can access the Newegg Marketplace API by following steps:
1. Determine the correct Newegg Marketplace API URL to use.
3. Specify the parameter value in the request URL.
4. Specify the correct HTTP request method and the xml/Json content types that are accepted.
5. Attach your API Key and the Secret Key in requests (refer to authentication examples above).
5. Construct the request body as required. Submit the HTTP request.
6. Parse the response.
7.1. Request Format
Newegg Marketplace API supports query/update requests for calling Restful service actions. Query requests are simple
HTTP requests, using the GET or POST method with query parameters in the URL or HTTP body respectively. Update
requests using the PUT or DELETE method with updated parameters in the URL or HTTP body respectively.
Newegg Marketplace API requires the use of HTTPS in order to prevent third-party eavesdropping on your
communication with Newegg.
7.2. Create a HTTP Request
To create a Newegg Marketplace API query/update request, you need to first construct a correctly formatted request
URL. You can refer to the URL template of the API services you want to use (please refer to the API reference section).
Below are the possible value lists in your HTTP request:
Name
Required?
Description
Request URL
Yes
The Newegg Marketplace API service endpoint you are using
Request Method
Yes
The GET/POST or PUT/DELETE method of the API service required
Body Content-type
No
The XML/Json format of the content in the request body. The default is
XML.
Response Content-type
No
The XML/Json format of the content in the response. The default is XML.
Authentication header
Yes
Format: Authorization:{api-key}
The API key of the authorized API developer
SecretKey header
Yes
Format: Secretkey:{secretkey}
15
The secret key of an authorized API developer
RAW body
No
Pass parameters by the request body. The format of the content should
conform to the specification of the API service.
Note: The API reference section includes the important information for each API function for your reference.
Example:
GET
Https://api.newegg.com/marketplace/ordermgmt/orderstatus/orders/{ordernumber}?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
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
OrderNumber
Yes
The order number
URL Resource Information:
HTTP Method
Authentication?
Request Formats
Response Formats
Rate Limited?
GET
Required
XML, Json
XML, Json
1000 per min per client
HTTP method specifies which request method.
Authentication -- indicates this service needs an authentication to use.
Request Formats the request parameters format in the request body.
Response Formats the supported format of the response content.
Rate Limited API Request Limit
Request Parameters:
URL Parameters the required parameters in the request URL.
Request Parameters some specific parameters in the request body. The format shall be XML or Json; you can get the
supported type from the “request format” in the URL Resource Information section above.
7.3. Bad Request
Newegg Marketplace API will return a bad request (HTTP status code = 400) if you submitted an inappropriate request
in the following types:
16
Illegal request body. Such as not well-formatted XML or incorrect tag or data type.
Example: XML, Response
<?xml version="1.0" encoding="utf-8"?>
<Errors xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-
instance">
<Error>
<Code>CE003</Code>
<Message>XML parsing error. The 'NeweggAPIRequest1' start tag on line 1 position 2 does not
match the end tag of 'NeweggAPIRequest'. Line 1, position 451.</Message>
</Error>
</Errors>
Example: Json, Response
{
"Code":"CE003",
"Message":"XML parsing error. The 'NeweggAPIRequest1' start tag on line 1 position 2 does not
match the end tag of 'NeweggAPIRequest'. Line 1, position 451."
}
Business validation failure. Invalid data request or fail to match business requirement. For the detail error code
and message please refer to the Request Failure Errors part at the end of every service definition.
Example: XML, Response
<?xml version="1.0" encoding="utf-8" ?>
<Errors>
<Error>
<Code>SO011</Code>
<Message>Only unshipped orders can be shipped. The order status is currently Closed</Message>
</Error>
</Errors>
Example: Json, Response
{
"Code": "SO011",
"Message": "Only unshipped orders can be shipped. The order status is currently Closed"
}
In order to parse error messages in your own programs correctly, please refer to Exception Handling for Bad Request in
the Code Examples section.
17
7.4. Code Examples
* Please note that these examples are provided to you with the simple purpose of demonstrating how you can use
Newegg Marketplace API functions and resources. The examples do not take in consideration of extra requirements such
as authentication/security required by each programming language.
C# Example
The code example below demonstrates how to query the inventory quantity of the specified Newegg Item
9SIA00600000023for the seller “A006in .NET C#
1. Create a new class to de-serialize the response:
Example: C#, Inventory response entity
public class InventoryResult
{
public string SellerID { get; set; }
public string ItemNumber { get; set; }
public int AvailableQuantity { get; set; }
public string Active { get; set; }
public string SellerPartNumber { get; set; }
public string ShipByNewegg { get; set; }
}
2. Get the inventory available quantity:
Example: C#, Get Item Inventory
Console.WriteLine(string.Format("Newegg Marketplace API - Get Inventory request at:{0}",
DateTime.Now.ToString()));
Console.WriteLine("");
Console.WriteLine("*********************************************************************");
Console.WriteLine("");
try
{
InventoryResult inventoryResult = null;
//Determine the correct Newegg Marketplace API endpoint to use.
18
// Please make sure your request URL is all in lower case
string endpoint =
@"https://api.newegg.com/marketplace/contentmgmt/item/inventory?sellerid={0}";
endpoint = String.Format(endpoint, "A006");
//Create an HttpWebRequest
System.Net.HttpWebRequest request =
System.Net.WebRequest.Create(endpoint) as HttpWebRequest;
//Remove proxy
request.Proxy = null;
//Specify the request method
request.Method = "POST";
//Specify the xml/Json request and response content types.
request.ContentType = "application/xml";
request.Accept = "application/xml";
//Attach authorization information
request.Headers.Add("Authorization", "your API-key here");
request.Headers.Add("Secretkey", "your secretkey here");
//Construct the query criteria in the request body
string requestBody = @"
<ContentQueryCriteria>
<Type>1</Type>
<Value>A006ZX-35833</Value>
</ContentQueryCriteria>";
byte[] byteStr = Encoding.UTF8.GetBytes(requestBody);
request.ContentLength = byteStr.Length;
using (Stream stream = request.GetRequestStream())
{
stream.Write(byteStr, 0, byteStr.Length);
}
//Parse the response
using (HttpWebResponse response = request.GetResponse() as HttpWebResponse)
{
19
if (response.StatusCode != HttpStatusCode.OK)
{
Console.WriteLine(String.Format("Code:{0}.Error:{1}",
response.StatusCode.ToString(), response.StatusDescription));
return;
}
using (Stream responseStream = response.GetResponseStream())
{
XmlSerializer serializer =
new XmlSerializer(typeof(InventoryResult));
inventoryResult =
serializer.Deserialize(responseStream) as InventoryResult;
}
}
string sellerID = inventoryResult.SellerID;
string itemNumber = inventoryResult.ItemNumber;
int availableQuantity = inventoryResult.AvailableQuantity;
string message = String.Format("SellerID:{0} ItemNumber:{1} Availble Quantity:{2} \r\n
Active:{3} SellerPartNumber:{4} ShipByNewegg:{5}",
inventoryResult.SellerID,
inventoryResult.ItemNumber,
inventoryResult.AvailableQuantity,
inventoryResult.Active,
inventoryResult.SellerPartNumber,
inventoryResult.ShipByNewegg);
Console.WriteLine(message);
}
catch (WebException we)//Error Handling for Bad Request
{
if (((WebException)we).Status == WebExceptionStatus.ProtocolError)
{
WebResponse errResp = ((WebException)we).Response;
using (Stream respStream = errResp.GetResponseStream())
{
StreamReader reader = new StreamReader(respStream);
Console.WriteLine(String.Format("{0}", reader.ReadToEnd()));
20
}
}
}
catch (Exception ex)//unhandle error
{
Console.WriteLine(string.Format("exception: at time:{0}", DateTime.Now.ToString()));
Console.WriteLine(ex.Message + "---->");
Console.WriteLine(ex.StackTrace.ToString());
}
Console.WriteLine("");
Console.WriteLine("*********************************************************************");
Console.WriteLine("");
Console.WriteLine("Please input any key to exit……");
Console.ReadLine();
Error Handling for Bad Request (Status Code = 400)
try
{
//Your code here
}
catch (WebException we)//Error Handling for Bad Request
{
if (((WebException)we).Status == WebExceptionStatus.ProtocolError)
{
WebResponse errResp = ((WebException)we).Response;
using (Stream respStream = errResp.GetResponseStream())
{
StreamReader reader = new StreamReader(respStream);
Console.WriteLine(String.Format("{0}", reader.ReadToEnd()));
}
}
}
Java Example
The following example demonstrates how to retrieve order information through Newegg Marketplace API in Java.
21
/*
* To change this template, choose Tools | Templates
* And open the template in the editor.
*/
package marketplaceapi_java_demo;
import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.io.OutputStream;
import java.net.MalformedURLException;
import java.net.URL;
import java.security.cert.X509Certificate;
import java.util.Calendar;
import javax.net.ssl.HostnameVerifier;
import javax.net.ssl.HttpsURLConnection;
import javax.net.ssl.SSLContext;
import javax.net.ssl.SSLSession;
import javax.net.ssl.TrustManager;
import javax.net.ssl.X509TrustManager;
public class MarketplaceAPI_Java_Demo {
/**
* @param args the command line arguments
*/
public static void main(String[] args) throws Exception{
GetOrderInfo();
}
private static void GetOrderInfo() throws Exception{
System.out.println("[" + Calendar.getInstance().getTime() + "]Newegg Marketplace API -
GetOrderInfo:");
System.out.println("-----------------------------------");
String requestUrl =
"https://api.newegg.com/marketplace/ordermgmt/order/orderinfo?sellerid=A006";
try {
// Create a trust manager that does not validate certificate chains
22
TrustManager[] trustAllCerts = new TrustManager[] {new X509TrustManager() {
public java.security.cert.X509Certificate[] getAcceptedIssuers() {
return null;
}
public void checkClientTrusted(X509Certificate[] certs, String authType) {
}
public void checkServerTrusted(X509Certificate[] certs, String authType) {
}
}
};
// Install the all-trusting trust manager
SSLContext sc = SSLContext.getInstance("SSL");
sc.init(null, trustAllCerts, new java.security.SecureRandom());
HttpsURLConnection.setDefaultSSLSocketFactory(sc.getSocketFactory());
// Create all-trusting host name verifier
HostnameVerifier allHostsValid = new HostnameVerifier() {
public boolean verify(String hostname, SSLSession session) {
return true;
}
};
// Install the all-trusting host verifier
HttpsURLConnection.setDefaultHostnameVerifier(allHostsValid);
URL url = new URL(requestUrl);
HttpsURLConnection httpsConnection = (HttpsURLConnection)url.openConnection();
//javax.net.ssl. = false;
//Set accepted format in response message:application/xml|application/json
httpsConnection.setRequestProperty("Accept", "application/xml");
//Set the accepted format in request body:application/xml|application/json
httpsConnection.setRequestProperty("content-type", "application/xml");
//Set the request method:GET|PUT|POST
httpsConnection.setRequestMethod("PUT");
//Set authorization key
23
httpsConnection.setRequestProperty("Authorization",
"720ddc067f4d115bd544aff46bc75634");
//Set secret-key
httpsConnection.setRequestProperty("SecretKey", "21EC2020-3AEA-1069-A2DD-
08002B30309D");
httpsConnection.setDoInput(true);
httpsConnection.setDoOutput(true);
String requestStr = "<NeweggAPIRequest>"
+ "<OperationType>GetOrderInfoRequest</OperationType>"
+ "<RequestBody>"
+ "<PageIndex>1</PageIndex>"
+ "<PageSize>10</PageSize>"
+ "<RequestCriteria>"
+ "<OrderNumberList>"
+ "<OrderNumber>159243598</OrderNumber>"
+ "<OrderNumber>41473642</OrderNumber>"
+ "</OrderNumberList>"
+ "<Status>1</Status>"
+ "<Type>1</Type>"
+ "<OrderDateFrom>2011-01-01 09:30:47</OrderDateFrom>"
+ "<OrderDateTo>2011-12-17 09:30:47</OrderDateTo>"
+ "<OrderDownloaded>0</OrderDownloaded>"
+ "</RequestCriteria>"
+ "</RequestBody>"
+ "</NeweggAPIRequest>";
byte[] requestBody = requestStr.getBytes();
//Set content-length
httpsConnection.setRequestProperty("Content-Length",
String.valueOf(requestBody.length));
OutputStream outStream = httpsConnection.getOutputStream();
outStream.write(requestBody);
outStream.close();
InputStreamReader inputReader = new
InputStreamReader(httpsConnection.getInputStream());
BufferedReader reader = new BufferedReader(inputReader);
24
String responseBody = "";
while(reader.ready()){
responseBody += reader.readLine();
}
reader.close();
inputReader.close();
System.out.println("[" + Calendar.getInstance().getTime() + "]Response Message:");
System.out.println("-----------------------------------");
System.out.println(responseBody);
} catch (MalformedURLException ex) {
System.out.println("Illegal request URI:" + ex.getMessage());
}
catch(Exception e){
System.out.println("Exception:" + e.getMessage());
//Error Handling for Bad Request
InputStreamReader errorReader = new
InputStreamReader(httpsConnection.getErrorStream());
BufferedReader bufferReader = new BufferedReader(errorReader);
String errorMsg = "";
while(bufferReader.ready()){
errorMsg += bufferReader.readLine();
}
bufferReader.close();
errorReader.close();
System.out.println(errorMsg);
}
}
}
25
Error Handling for Bad Request (Status Code = 400)
try
{
//Your code here
}
catch(Exception e){
System.out.println("Exception:" + e.getMessage());
//Error Handling for Bad Request
InputStreamReader errorReader = new InputStreamReader(httpsConnection.getErrorStream());
BufferedReader bufferReader = new BufferedReader(errorReader);
String errorMsg = "";
while(bufferReader.ready()){
errorMsg += bufferReader.readLine();
}
bufferReader.close();
errorReader.close();
System.out.println(errorMsg);
}
PHP Example
The code example below demonstrates how to access Newegg API with PHP curl extension under windows operation
system.
1. Download php_curl.dll
2. Edit php.ini and apply the extension:
Extension=php_curl.dll
3. Restart the apache server
Example:PHP, Get order status
GET:
<?php
// Request Newegg API! REST Web Service using
26
// HTTP POST with curl. PHP4/PHP5
// Allows retrieval of HTTP status code for error reporting
error_reporting(E_ALL);
$SellerID = 'A006';
// The POST URL and parameters
// Please make sure your request URL is all in lower case
$request =
'https://api.newegg.com/marketplace/ordermgmt/orderstatus/orders/12345678?sellerid='.$SellerID;
$header_array =array('Content-Type:application/xml',
'Accept:application/xml',
'Authorization: your API-key here',
'SecretKey: your secretkey here');
try
{
// Get the curl session object
$session = curl_init($request);
// Set the POST options.
curl_setopt($session, CURLOPT_HEADER, 1);
curl_setopt($session,CURLOPT_HTTPHEADER,$header_array);
curl_setopt($session, CURLOPT_HEADER, false);
curl_setopt($session, CURLOPT_RETURNTRANSFER, true);
curl_setopt($session, CURLOPT_SSL_VERIFYPEER, 0);
// Do the POST and then close the session
$response = curl_exec($session);
curl_close($session);
print $response;
}
catch (InvalidArgumentException $e)
{
curl_close($session);
throw $e;
}
catch (Exception $e)
{
27
curl_close($session);
throw $e;
}
?>
Example:PHP, Get item inventory
POST:
<?php
// Request Newegg API! REST Web Service using
// HTTP POST with curl. PHP4/PHP5
// Allows retrieval of HTTP status code for error reporting
error_reporting(E_ALL);
$SellerID = 'A006';
// The POST URL and parameters
// Please make sure your request URL is all in lower case
$request = 'https://api.newegg.com/marketplace/contentmgmt/item/inventory?sellerid='.$SellerID;
$body = '<ContentQueryCriteria>
<Type>0</Type>
<Value>9SIA08I0492622</Value>
</ContentQueryCriteria>';
$header_array =array('Content-Type:application/xml',
'Accept:application/xml',
'Authorization: your API-key here',
'SecretKey: your secretkey here');
try
{
// Get the curl session object
$session = curl_init($request);
$putString = stripslashes($body);
$putData = tmpfile();
fwrite($putData, $putString);
fseek($putData, 0);
28
// Set the POST options.
curl_setopt($session, CURLOPT_HEADER, 1);
curl_setopt($session,CURLOPT_HTTPHEADER,$header_array);
curl_setopt($session, CURLOPT_POST, true);
curl_setopt($session, CURLOPT_HEADER, false);
curl_setopt($session, CURLOPT_RETURNTRANSFER, true);
curl_setopt($session, CURLOPT_POSTFIELDS, $body);
curl_setopt($session, CURLOPT_SSL_VERIFYPEER, 0);
curl_setopt($session, CURLOPT_INFILE, $putData);
curl_setopt($session, CURLOPT_INFILESIZE, strlen($putString));
// Do the POST and then close the session
$response = curl_exec($session);
curl_close($session);
print $response;
}
catch (InvalidArgumentException $e)
{
curl_close($session);
throw $e;
}
catch (Exception $e)
{
curl_close($session);
throw $e;
}
?>
Example:PHP, Update inventory and price
PUT:
<?php
// Request Newegg API! REST Web Service using
// HTTP POST with curl. PHP4/PHP5
// Allows retrieval of HTTP status code for error reporting
error_reporting(E_ALL);
29
$SellerID = 'A006';
// The POST URL and parameters
// Please make sure your request URL is all in lower case
$request =
'https://api.newegg.com/marketplace/contentmgmt/item/inventoryandprice?sellerid='.$SellerID;
$body = '<ItemInventoryAndPriceInfo>
<Type>1</Type>
<Value>A006testitem201201021459</Value>
<Condition>1</Condition>
<Inventory>200</Inventory>
<MSRP>34.98</MSRP>
<SellingPrice>29.92</SellingPrice>
<EnableFreeShipping>1</EnableFreeShipping>
<Active>0</Active>
</ItemInventoryAndPriceInfo>';
$header_array =array('Content-Type:application/xml',
'Accept:application/xml',
'Authorization: your API-key here',
'SecretKey: your secretkey here');
try
{
// Get the curl session object
$session = curl_init($request);
$putString = stripslashes($body);
$putData = tmpfile();
fwrite($putData, $putString);
fseek($putData, 0);
// Set the POST options.
curl_setopt($session, CURLOPT_HEADER, 1);
curl_setopt($session,CURLOPT_HTTPHEADER,$header_array);
curl_setopt($session, CURLOPT_PUT, true);
curl_setopt($session, CURLOPT_HEADER, false);
curl_setopt($session, CURLOPT_RETURNTRANSFER, true);
curl_setopt($session, CURLOPT_POSTFIELDS, $body);
curl_setopt($session, CURLOPT_SSL_VERIFYPEER, 0);
curl_setopt($session, CURLOPT_INFILE, $putData);
curl_setopt($session, CURLOPT_INFILESIZE, strlen($putString));
30
// Do the POST and then close the session
$response = curl_exec($session);
curl_close($session);
print $response;
}
catch (InvalidArgumentException $e)
{
curl_close($session);
throw $e;
}
catch (Exception $e)
{
curl_close($session);
throw $e;
}
?>
The code example below demonstrates how to access Newegg API with pecl http request extension under LINUX system.
1. Download pecl_http extension from http://pecl.php.net/package/pecl_http, get the latest stable version such as 1.7.1
2. Install the extension( refer to :
http://www.zipservers.com/community/showthread.php?59-How-to-install-PECL-Modules-on-Linux)
[root@server ]# cd /root/ ; wget http://pecl.php.net/get/pecl_http-1.6.5.tgz
[root@server ]# tar -zxvf pecl_http-1.6.5.tgz
[root@server ]# cd pecl_http-1.6.5
[root@server ]# phpize
[root@server ]# ./configure
[root@server ]# make
[root@server ]# make test
[root@server ]# make install
[root@server ]# php -i | grep “Configuration File”
Configuration File (php.ini) Path => /usr/local/lib
Loaded Configuration File => /usr/local/lib/php.ini
3. Switch on the extension in the php.ini
[root@server ]# vi /usr/local/lib/php.ini
And add extension=http.so
31
4. Restart the apache serve
Example: PHP, Get Item Inventory
<?php
//request url
// Please make sure your request URL is all in lower case
$url =
" https://api.newegg.com/marketplace/contentmgmt/item/inventory?sellerid=A006";
//set the api-key & secret-key
$header_array = array('Authorization' => '{your API-key here}',
'Secretkey' => '{your secret-key here}');
//set the body if necessary
$body = "<ContentQueryCriteria>
<Condition>1</Condition>
<Type>0</Type>
<Value>9SIA0B992342342</Value>
</ContentQueryCriteria>";
$options = array(headers => $header_array);
//create the httprequest object
//specfiy the request method:HTTP_METH_GET|HTTP_METH_POST|HTTP_METH_PUT
$httpRequest_OBJ = new httpRequest($url, HTTP_METH_POST, $options);
//add the content type
$httpRequest_OBJ->setContentType = 'Content-Type: text/xml';
//add the raw post data
//$httpRequest_OBJ->setRawPostData ($body);
$httpRequest_OBJ->setBody ($body);
try
{
//send the http request
$result = $httpRequest_OBJ->send();
}catch(HttpException $ex)
{
if (isset($ex->innerException)){
echo $ex->innerException->getMessage();
32
exit;
} else {
echo $ex;
exit;
}
}
$response_code = $httpRequest_OBJ->getResponseCode();
if($response_code == "200")
{
//reqeust success
echo $response_code;
echo $httpRequest_OBJ->getResponseBody();
}
else
{
//failure
echo $response_code;
echo $httpRequest_OBJ->getResponseBody();
}
?>
Error Handling for Bad Request (Status Code = 400)
// Do the POST and then close the session
$response = curl_exec($session);
curl_close($session);
//The error message will be stored in this variable if its a bad request
print $response;
Python Example
The code example below demonstrates how to access Newegg API in Python.
Example: Python, Get Item Price
import httplib2
#import pyodbc
import string
33
all_items_location_id=521799450
# whether to print item data retrieved from database
print_item_data=True
# items data retrieved from database
items=[]
def _put_call(url, xmlfeed):
h = httplib2.Http(".cache",disable_ssl_certificate_validation=True)
resp, content = h.request(url, "POST", body=xmlfeed, headers={'content-
type':'application/xml','Authorization': 'your API-key here', 'Secretkey':'your secretkey here' }
)
print "response header from Newegg:", resp
print "response body from Newegg:", content
def get_price():
header = '<?xml version="1.0" encoding="UTF-8"?>'
xmlfeed=[]
xmlfeed.append(header)
xmlfeed.append('<ContentQueryCriteria>')
xmlfeed.append('<Type>1</Type>')
xmlfeed.append('<Value>TCR8996</Value>')
xmlfeed.append('</ContentQueryCriteria>')
xmlfeed=string.join(xmlfeed,'')
print "Get item price:"
put_call_url = 'https://api.newegg.com/marketplace/contentmgmt/item/price?sellerid=A006'
_put_call(put_call_url,xmlfeed)
get_price()
34
Error Handling for Bad Request (Status Code = 400)
def _put_call(url, xmlfeed):
h = httplib2.Http(".cache",disable_ssl_certificate_validation=True)
resp, content = h.request(url, "POST", body=xmlfeed, headers={'content-
type':'application/xml','Authorization': 'your API-key here', 'Secretkey':'your secretkey here' }
)
print "response header from Newegg:", resp
#The error message will be stored in this variable if its a bad request
print "response body from Newegg:", content
8. Service Status
Newegg Marketplace API provides an interface in every major service group to allow you to check whether the service you
are invoking is available or not. Each major service group is listed in the Parameters section, domain field description.
8.1. Get Service Status
Return each major service groups availability.
8.1.1. Resource URL & Information
Resource URL
https://api.newegg.com/marketplace/{domain}/servicestatus?sellerid={sellerid}
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
domain
Yes
Major Service Groups Options:
- contentmgmt
- ordermgmt
- datafeedmgmt
- servicemgmt
- reportmgmt
- sellermgmt
- sbnmgmt
- shippingservice
35
Sellerid
Yes
Your seller ID on Newegg Marketplace
Resource Information
HTTP Method
Authentication?
Request Formats
Response Formats
Rate Limited?
GET
Required
XML, Json
XML, Json
1000 per min per client
8.1.2. Request Body
Example: XML, Request
GET https://api.newegg.com/marketplace/contentmgmt/servicestatus?sellerid={SellerID}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
Example: Json, Request
GET https://api.newegg.com/marketplace/contentmgmt/servicestatus?sellerid={SellerID}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
8.1.3. Response Body
Attribute
Format
Description
NeweggAPIResponse
IsSuccess
String
Used to identify whether the requested service is successful or not. Returns true
or false.
OperationType
String
Fixed value: GetServiceStatus
SellerID
String
Your Seller ID
Response Body
Status
Integer
0. Service unavailable
1. Service available
Timestamp
String
Request date time (Pacific Standard Time)
Message
String
When service is unavailable (status = 0), this field will provide a detailed
explanation.
36
Example: XML, Service Available Response
XSD
API Schema > SellerMgmt > SellerStatusCheck > GetSellerAccountStatusResponse.xsd
<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<OperationType>GetServiceStatus</OperationType>
<SellerID>A006</SellerID>
<ResponseBody>
<Status>1</Status>
<Timestamp>2/14/2012 9:42:46</Timestamp>
</ResponseBody>
</NeweggAPIResponse>
Example: Json, Service Available Response
{
"IsSuccess": "true",
"OperationType": "GetServiceStatus",
"SellerID": "A006",
"ResponseBody": {
"Status": "1",
"Timestamp": "2/14/2012 9:42:46"
}
}
Example: XML, Service Unavailable Response
XSD
API Schema > SellerMgmt > SellerStatusCheck > GetSellerAccountStatusResponse.xsd
<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<OperationType>GetServiceStatus</OperationType>
<SellerID>A006</SellerID>
<ResponseBody>
<Status>0</Status>
37
<Timestamp>2/15/2012 14:50:38</Timestamp>
<Message>The service is unavailable or experiencing extremely high error rates.</Message>
</ResponseBody>
</NeweggAPIResponse>
Example: Json, Service Unavailable Response
{
"NeweggAPIResponse": {
"IsSuccess": "true",
"OperationType": "GetServiceStatus",
"SellerID": "A006",
"ResponseBody": {
"Status": "0",
"Timestamp": "2/15/2012 2:50:38",
"Message": "The service is unavailable or experiencing extremely high error rates."
}
}
}
8.1.4. Request Failure Errors
For common HTTP error responses, please refer to Common Error Responses
Example: XML, Response
<?xml version="1.0" encoding="utf-8"?>
<Errors>
<Error>
<Code>CE001</Code>
<Message>SellerID cannot be null or empty</Message>
</Error>
</Errors>
Example: Json, Response
{
"Code": "CE001",
38
"Message": "SellerID cannot be null or empty"
}
8.2. Failover Endpoints for API Service
To avoid any downtime caused by network, failover endpoints are available for accessing Newegg API services:
https://api.newegg.com (Primary)
https://api01.newegg.com
https://api02.newegg.com
The first listed endpoint should be configured as the primary and all other endpoints are treated as backups. Please
configuring your requests always sent only to the primary endpoint: http://api.newegg.com. If the primary endpoint fails,
please redirect your requests to the next active endpoint. For best performance, you should always switches back to the
primary endpoint as soon as it becomes available.
To check the current status of all available endpoints, please visit: http://www.newegg.com/sellers/EndpointTest.html
39
9. Item Management
The Item Management service group contains functions that will allow you to perform simple item related updates such as Update Item
Inventory, Price, Shipping and Status.
For item creation / information update (creating an item listing for the seller, updating item listing for the seller such as item description,
item title, item detailed properties and values), please refer to DataFeed Management section and refer to ITEM_DATA attribute type.
9.1. Manufacturer Lookup
Query available manufacturer list from Newegg.
9.1.1. Resource URL & Information
Resource URL
https://api.newegg.com/marketplace/contentmgmt/manufacturer/manufacturerinfo?sellerid={sellerid}
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
Resource Information
HTTP Method
Authentication?
Request Formats
Response Formats
Rate Limited?
PUT
Required
XML, Json
XML, Json
1000 per min per client
9.1.2. Request Body
Attribute
Required?
Format
Description
NeweggAPIRequest
OperationType
Yes
String
Fixed value: GetManufacturerRequest
RequestBody
PageIndex
No
Integer
Current page index
If left blank, will use 1 as default.
PageSize
No
Integer
Return records count in one page.
(Max is 100 per page)
If left blank, will use 100 as default.
40
RequestCriteria
CreatedDateFrom
No
String
Filter the manufacturers created after the date.
Please refer to the Acceptable Date Format
CreatedDateTo
No
String
Filter the manufacturers created before the date
Please refer to the Acceptable Date Format
ManufacturerName
No
String
Manufacturer name.
If left blank, will return all manufacturer names.
Example: XML, Request
XSD
API Schema > ContentMgmt > GetManufacturer > GetManufacturerRequest.xsd
PUT
https://api.newegg.com/marketplace/contentmgmt/manufacturer/manufacturerinfo?sellerid={SellerID}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggAPIRequest >
<OperationType>GetManufacturerRequest</OperationType>
<RequestBody>
<PageIndex>1</PageIndex>
<PageSize>10</PageSize>
<RequestCriteria>
<CreatedDateFrom>2013-08-30 14:20:00</CreatedDateFrom>
<CreatedDateTo>2013-08-30 18:20:00</CreatedDateTo>
<ManufacturerName><![CDATA[sony & wonder]]></ManufacturerName>
</RequestCriteria>
</RequestBody>
</NeweggAPIRequest>
Example: Json, Request
{
"IsSuccess": "true",
"SellerID": "A006",
"OperationType": "GetManufacturerResponse",
41
"ResponseDate": "2/22/2012 16:51:03",
"ResponseBody": {
"PageInfo": {
"TotalCount": "1",
"TotalPageCount": "1",
"PageSize": "10",
"PageIndex": "1"
},
"ManufacturerList": {
"Manufacturer": [{
"Name": "sony & wonder",
"IsRestricted": "0",
"MappedNameList": {
"MappedName": "wonder"
}
}, {
"Name": "newegg",
"IsRestricted": "1",
"RestrictedSubcategoryList": {
"Subcategory": [{
"SubcategoryID": "1508",
"SubcategoryName": "Belts & Suspenders"
}, {
"SubcategoryID": "153",
"SubcategoryName": "Buckles"
}]
},
"MappedNameList": {
"MappedName": "test_newegg"
}
}]
}
}
}
9.1.3. Response Body
42
Attribute
Format
Description
NeweggAPIResponse
IsSuccess
String
Used to identify the operation of Manufacturer
lookup is successful
Fixed value: True
SellerID
String
Your seller ID
OperationType
String
Fixed value: GetManufacturerResponse
ResponseDate
String
Response date
Memo
String
Additional messages
ResponseByody
PageInfo
TotalCount
Integer
Total number of records
TotalPageCount
Integer
Total page count
PageIndex
Integer
Current page index
PageSize
Integer
How many records in a page.
ManufacturerList
Manufacturer
Name
String
Manufacturer Name
IsRestricted
Integer
To identify the manufacturer is restricted or not.
0: No
1: Yes
RestrictedSubcategoryList
Subcategory
SubcategoryID
Integer
The subcategory ID which the restricted
manufacturer applies on.
This will be empty if the manufacturer restricts
for all subcategories.
SubcategoryName
String
The subcategory name which the restricted
manufacturer applies on.
This will be empty if the manufacturer restricts
for all subcategories.
43
MappedNameList
MappedName
String
Mapped manufacturer name.
If you use this mapped name to create a new
item, Newegg will map it to the existing
manufacturer accordingly.
For example:
Manufacturer Name: SONY
Mapped name:
Sony Ericsson Mobile, Sony Audio/Video, Sony
PlayStation, Sony Creative Software, Sony
Creative Software, Inc
If you use one of the Mapped name to create a
new item, the manufacturer will be replaced with
SONY.
Example: XML, Response
XSD
API Schema > ContentMgmt > GetManufacturer > GetManufacturerResponse.xsd
<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<SellerID>A006</SellerID>
<OperationType>GetManufacturerResponse</OperationType>
<ResponseDate>2/22/2012 16:51:03</ResponseDate>
<Memo />
<ResponseBody>
<PageInfo>
<TotalCount>1</TotalCount>
<TotalPageCount>1</TotalPageCount>
<PageSize>10</PageSize>
<PageIndex>1</PageIndex>
</PageInfo>
<ManufacturerList>
<Manufacturer>
<Name><![CDATA[sony & wonder]]></Name>
<IsRestricted>0</IsRestricted>
<RestrictedSubcategoryList/>
44
<MappedNameList>
<MappedName>wonder</MappedName>
</MappedNameList>
</Manufacturer>
<Manufacturer>
<Name><![CDATA[newegg]]></Name>
<IsRestricted>1</IsRestricted>
<RestrictedSubcategoryList>
<Subcategory>
<SubcategoryID>1508</SubcategoryID>
<SubcategoryName><![CDATA[Belts & Suspenders]]></SubcategoryName>
</Subcategory>
<Subcategory>
<SubcategoryID>153</SubcategoryID>
<SubcategoryName><![CDATA[Buckles]]></SubcategoryName>
</Subcategory>
</RestrictedSubcategoryList>
<MappedNameList>
<MappedName>test_newegg</MappedName>
</MappedNameList>
</Manufacturer>
</ManufacturerList>
</ResponseBody>
</NeweggAPIResponse>
Example: Json, Response
{
"IsSuccess": "true",
"SellerID": "A006",
"OperationType": "GetManufacturerResponse",
"ResponseBody": {
"PageInfo": {
"TotalCount": "1",
"TotalPageCount": "1",
"PageSize": "10",
"PageIndex": "1"
},
"ManufacturerList": {
"Manufacturer": [
45
{
"Name": "sony & wonder",
"IsRestricted": "0"
},
"MappedNameList": [
"sony & wonder inc."
] {
"Name": "newegg",
"IsRestricted": "1",
"RestrictedSubcategoryList": {
"Subcategory": [
{
"SubcategoryID": "1508",
"SubcategoryName": "Belts & Suspenders"
},
{
"SubcategoryID": "153",
"SubcategoryName": "Buckles"
}
]
}
}
]
}
},
"ResponseDate": "2/22/2012 16:51:03"
"Memo": ""
}
9.1.4. Request Failure Errors
For common HTTP error responses, please refer to Common Error Responses
Error Code
Description
CT033
Invalid manufacturer name :{0}.
Example: XML, Response
<?xml version="1.0" encoding="utf-8"?>
46
<Errors>
<Error>
<Code>CT033</Code>
<Message>Invalid manufacturer name: Joe Machine</Message>
</Error>
</Errors>
Example: Json, Response
{
"Code": "CT033",
"Message": "Invalid manufacturer name: Joe Machine"
}
9.2. Manufacturer Lookup for international country
Query available manufacturer list on international country from Newegg.
9.2.1. Resource URL & Information
Resource URL
https://api.newegg.com/marketplace/contentmgmt/manufacturer/manufacturerinfo/V2?sellerid={sellerid}
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
Resource Information
HTTP Method
Authentication?
Request Formats
Response Formats
Rate Limited?
PUT
Required
XML, Json
XML, Json
1000 per min per client
9.2.2. Request Body
47
Attribute
Requir
ed?
Format
Description
NeweggAPIRequest
OperationType
Yes
String
Fixed value: GetManufacturerRequest
RequestBody
PageIndex
No
Integer
Current page index
If left blank, will use 1 as default.
PageSize
No
Integer
Return records count in one page.
(Max is 100 per page)
If left blank, will use 100 as default.
RestrictedCountryC
ode
Yes
String
The country where the manufacturer is being restricted to sell
Note: only the ISO standard 3-digit codes are accepted.
To review the complete list of available values, please download the
following:
https://promotions.newegg.com/Marketplace/Sellers/resourceLibrary/
International%20Country%20Guide.pdf
RequestCriteria
CreatedDateF
rom
No
String
Filter the manufacturers created after the date.
Please refer to the Acceptable Date Format
CreatedDateT
o
No
String
Filter the manufacturers created before the date
Please refer to the Acceptable Date Format
Manufacturer
Name
No
String
Manufacturer name.
If left blank, will return all manufacturer names.
Example: XML, Request
XSD
API Schema > ContentMgmt > GetManufacturer > GetManufacturerRequestV2.xsd
PUT
https://api.newegg.com/marketplace/contentmgmt/manufacturer/manufacturerinfo/v2?sellerid={SellerI
D}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
48
Content-Type: application/xml
Accept: application/xml
<NeweggAPIRequest >
<OperationType>GetManufacturerRequest</OperationType>
<RequestBody>
<PageIndex>1</PageIndex>
<PageSize>10</PageSize>
<RestrictedCountryCode>USA</RestrictedCountryCode>
<RequestCriteria>
<CreatedDateFrom>2013-08-30 14:20:00</CreatedDateFrom>
<CreatedDateTo>2013-08-30 18:20:00</CreatedDateTo>
<ManufacturerName><![CDATA[sony & wonder]]></ManufacturerName>
</RequestCriteria>
</RequestBody>
</NeweggAPIRequest>
Example: Json, Request
PUT
https://api.newegg.com/marketplace/contentmgmt/manufacturer/manufacturerinfo/v2?sellerid={SellerI
D}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"OperationType": "GetManufacturerRequest",
"RequestBody": {
"PageIndex": "1",
"PageSize": "10",
RestrictedCountryCode”:”USA”,
"RequestCriteria": {
"CreatedDateFrom": "2013-08-30 14:20:00",
"CreatedDateTo": "2013-08-30 18:20:00",
"ManufacturerName": "sony & wonder"
}
}
}
49
9.2.3. Response Body
Attribute
Format
Description
NeweggAPIResponse
IsSuccess
String
Used to identify the operation of Manufacturer
lookup is successful
Fixed value: True
SellerID
String
Your seller ID
OperationType
String
Fixed value: GetManufacturerResponse
ResponseDate
String
Response date
Memo
String
Additional messages
ResponseByody
PageInfo
TotalCount
Integer
Total number of records
TotalPageCount
Integer
Total page count
PageIndex
Integer
Current page index
PageSize
Integer
How many records in a page.
ManufacturerList
Manufacturer
Name
String
Manufacturer Name
IsRestricted
Integer
To identify the manufacturer is restricted or not.
0: No
1: Yes
CountryCode
String
The country where the manufacturer restriction is
being applied to.
To review the complete list of available values,
please download the following:
https://promotions.newegg.com/Marketplace/Sel
lers/resourceLibrary/International%20Country%2
0Guide.pdf
RestrictedSubca
tegoryList
Subcategory
SubcategoryID
Integer
The subcategory ID which the restricted
manufacturer applies on.
This will be empty if the manufacturer restricts
for all subcategories.
50
SubcategoryName
String
The subcategory name which the restricted
manufacturer applies on.
This will be empty if the manufacturer restricts
for all subcategories.
MappedNameList
MappedName
String
Mapped manufacturer name.
If you use this mapped name to create a new
item, Newegg will map it to the existing
manufacturer accordingly.
For example:
Manufacturer Name: SONY
Mapped name:
Sony Ericsson Mobile, Sony Audio/Video, Sony
PlayStation, Sony Creative Software, Sony
Creative Software, Inc
If you use one of the Mapped name to create a
new item, the manufacturer will be replaced with
SONY.
Example: XML, Response
XSD
API Schema > ContentMgmt > GetManufacturer > GetManufacturerResponse.xsd
<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<SellerID>A006</SellerID>
<OperationType>GetManufacturerResponse</OperationType>
<ResponseDate>2/22/2012 16:51:03</ResponseDate>
<Memo />
<ResponseBody>
<PageInfo>
<TotalCount>1</TotalCount>
<TotalPageCount>1</TotalPageCount>
<PageSize>10</PageSize>
<PageIndex>1</PageIndex>
</PageInfo>
51
<ManufacturerList>
<Manufacturer>
<Name><![CDATA[sony & wonder]]></Name>
<IsRestricted>0</IsRestricted>
<CountryCode>USA</CountryCode>
<RestrictedSubcategoryList/>
<MappedNameList>
<MappedName>wonder</MappedName>
</MappedNameList>
</Manufacturer>
<Manufacturer>
<Name><![CDATA[newegg]]></Name>
<IsRestricted>1</IsRestricted>
<CountryCode>USA</CountryCode>
<RestrictedSubcategoryList>
<Subcategory>
<SubcategoryID>1508</SubcategoryID>
<SubcategoryName><![CDATA[Belts & Suspenders]]></SubcategoryName>
</Subcategory>
<Subcategory>
<SubcategoryID>153</SubcategoryID>
<SubcategoryName><![CDATA[Buckles]]></SubcategoryName>
</Subcategory>
</RestrictedSubcategoryList>
<MappedNameList>
<MappedName>test_newegg</MappedName>
</MappedNameList>
</Manufacturer>
</ManufacturerList>
</ResponseBody>
</NeweggAPIResponse>
Example: Json, Response
{
"IsSuccess": "true",
"SellerID": "A006",
"OperationType": "GetManufacturerResponse",
"ResponseDate": "2/22/2012 16:51:03",
52
"ResponseBody": {
"PageInfo": {
"TotalCount": "1",
"TotalPageCount": "1",
"PageSize": "10",
"PageIndex": "1"
},
"ManufacturerList": {
"Manufacturer": [{
"Name": "sony & wonder",
"IsRestricted": "0",
CountryCode”:”USA“,
"MappedNameList": {
"MappedName": "wonder"
}
}, {
"Name": "newegg",
"IsRestricted": "1",
CountryCode”:”USA“,
"RestrictedSubcategoryList": {
"Subcategory": [{
"SubcategoryID": "1508",
"SubcategoryName": "Belts & Suspenders"
}, {
"SubcategoryID": "153",
"SubcategoryName": "Buckles"
}]
},
"MappedNameList": {
"MappedName": "test_newegg"
}
}]
}
}
}
9.2.4. Request Failure Errors
For common HTTP error responses, please refer to Common Error Responses
53
Error Code
Description
CT033
Invalid manufacturer name :{0}.
Example: XML, Response
<?xml version="1.0" encoding="utf-8"?>
<Errors>
<Error>
<Code>CT033</Code>
<Message>Invalid manufacturer name: Joe Machine</Message>
</Error>
</Errors>
Example: Json, Response
{
"Code": "CT033",
"Message": "Invalid manufacturer name: Joe Machine"
}
9.3. Submit Manufacturer Request
Manufacturer is one of the required information for creating new items in Newegg Marketplace. Only pre-defined values
from our system can be used. A complete manufacturer list can be retrieved using Manufacturer Lookup, section 9.4. If the
manufacturer(s) for your items are not available from our system, you can submit new manufacturer creation request to
Newegg Marketplace.
54
9.3.1. Resource URL & Information
Resource URL
https://api.newegg.com/marketplace/contentmgmt/manufacturer/creationrequest?sellerid={sellerid}
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
Resource Information
HTTP Method
Authentication?
Request Formats
Response Formats
Rate Limited?
POST
Required
XML, Json
XML, Json
100 per min per client
9.3.2. Request Body
Attribute
Required?
Format
Description
NeweggAPIRequest
IssueUser
No
String
The request issuer’s registered Seller Portal email address.
System will only accept Seller’s registered Seller Portal email
addresses. If left blank, default value will be Seller ID.
OperationType
Yes
String
Fixed value: SubmitManufacturerRequest
RequestBody
ManufacturerRequest
Name
Yes
String
Manufacturer name.
URL
No
String
Manufacturer website address.
Example: http://www.domain.com
SupportEmail
No
String
Manufacturer support email address.
SupportPhone
No
String
Manufacturer support phone number.
SupportURL
No
String
Manufacturer support website address
Example: http://support.domain.com
Example: XML, Request
XSD
API Schema > ContentMgmt > AddManufacturer > AddManufacturerRequest.xsd
55
POST https://api.newegg.com/marketplace/contentmgmt/manufacturer/creationrequest?sellerid={SellerID}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggAPIRequest>
<OperationType>SubmitManufacturerRequest</OperationType>
<RequestBody>
<ManufacturerRequest>
<Name><![CDATA[sony & wonder]]></Name>
<URL>www.sonywonder.com</URL>
<SupportEmail></SupportEmail>
<SupportPhone></SupportPhone>
<SupportURL></SupportURL>
</ManufacturerRequest>
</RequestBody>
</NeweggAPIRequest>
Example: Json, Request
POST https://api.newegg.com/marketplace/contentmgmt/manufacturer/creationrequest?sellerid={SellerID}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"OperationType": "SubmitManufacturerRequest",
"RequestBody": {
"ManufacturerRequest": {
"Name": "sony & wonder",
"URL": "www.sonywonder.com"
}
}
}
9.3.3. Response Body
56
Attribute
Format
Description
NeweggAPIResponse
IsSuccess
String
Identify the operation of Manufacturer requests
successful
Fixed value: True
SellerID
String
Your seller ID
OperationType
String
Fixed value: SubmitManufacturerResponse
ResponseDate
String
The response date
RequestBody
ManufacturerRequest
Name
String
Manufacturer Name
RequestDate
String
The submit date.
Example: XML, Response
XSD
API Schema > ContentMgmt > AddManufacturer > AddManufacturerResponse.xsd
<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<SellerID>A006</SellerID>
<OperationType>SubmitManufacturerResponse</OperationType>
<ResponseBody>
<ManufacturerRequest>
<Name><![CDATA[sony & wonder]]></Name>
<RequestDate>2/22/2012 16:50:03</RequestDate>
</ManufacturerRequest>
</ResponseBody>
<ResponseDate>2/22/2012 16:51:03</ResponseDate>
</NeweggAPIResponse>
Example: Json, Response
{
"IsSuccess": "true",
57
"SellerID": "A006",
"OperationType": "SubmitManufacturerResponse",
"ResponseBody": {
"ManufacturerRequest": {
"Name": "sony & wonder",
"RequestDate": "2/22/2012 16:50:03"
}
},
"ResponseDate": "2/22/2012 16:51:03"
}
9.3.4. Request Failure Errors
For common HTTP error responses, please refer to Common Error Responses
Error Code
Description
CT034
[MfrName] Error: This Manufacturer is existing! Please use correct manufacturer name "{0}" for your reference.
CT035
[MfrName] Error: The manufacturer "{0} already exists.
CT036
Require {manufacturer name|manufacturer URL}.
CT037
[MfrSupportPhone] Error: Format Error. Examples: Domestic 222-222-2222-2222. International 0086-
12345678EXT1234.
CT038
[MfrName] Error: The manufacturer {0} already declined.Please try another manufacturer name.
CT039
[MfrURL] Error:Format Error,For example:http://www.example.com
CT041
[MfrName] Error: The manufacturer "{0}" already existed in another pending request.
CT042
[SupportEmail] Error:Format Error,For example:123@newegg.com
Example: XML, Response
<?xml version="1.0" encoding="utf-8"?>
<Errors>
<Error>
<Code>CT035</Code>
<Message>Sony Error: The manufacturer Sony already exists.</Message>
</Error>
</Errors>
Example: Json, Response
{
"Code": "CT035",
58
"Message": "Sony Error: The manufacturer Sony already exists."
}
9.4. Get Manufacturer Request Status
Check the status for the manufacturer request submitted previously.
9.4.1. Resource URL & Information
Resource URL
https://api.newegg.com/marketplace/contentmgmt/manufacturer/creationrequeststatus?sellerid={sellerid}
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
Resource Information
HTTP Method
Authentication?
Request Formats
Response Formats
Rate Limited?
PUT
Required
XML, Json
XML, Json
1000 per min per client
9.4.2. Request Body
Attribute
Required?
Format
Description
NeweggAPIRequest
OperationType
Yes
String
Fixed value: GetManufacturerStatusRequest
RequestBody
ManufacturerList
ManufacturerName
Yes
String
Manufacturer name.
Example: XML, Request
XSD
API Schema > ContentMgmt > GetManufacturerProcessStatus > GetManufacturerProcessStatusRequest.xsd
59
PUT https://api.newegg.com/marketplace/contentmgmt/manufacturer/creationrequeststatus?sellerid={SellerID}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggAPIRequest>
<OperationType>GetManufacturerStatusRequest</OperationType>
<RequestBody>
<ManufacturerList>
<ManufacturerName><![CDATA[sony & wonder]]></ManufacturerName>
<ManufacturerName><![CDATA[AWG]]></ManufacturerName>
</ManufacturerList>
</RequestBody>
</NeweggAPIRequest>
Example: Json, Request
PUT https://api.newegg.com/marketplace/contentmgmt/manufacturer/creationrequeststatus?sellerid={SellerID}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"OperationType": "GetManufacturerStatusRequest",
"RequestBody": {
"ManufacturerList": {
"ManufacturerName": [
"sony & wonder",
"AWG"
]
}
}
}
9.4.3. Response Body
60
Attribute
Format
Description
NeweggAPIResponse
IsSuccess
String
Used to identify the operation of Manufacturer
lookup is successful
Fixed value: True
SellerID
String
Your seller ID
OperationType
String
Fixed value: GetManufacturerStatusResponse
ResponseDate
String
The response time.
ResponseBody
ManufacturerList
Manufacturer
RequestName
String
Original request manufacturer Name
ApprovedName
String
Approved manufacturer name that should be
used in your request.
RequestDate
String
The request date.
Status
String
The manufacturer status.
Available values:
Processing
Approved
Mapped
Declined
ProcessDate
String
Processed date.
DeclineReason
String
The decline reason.
Available when Status = Declined.
Example: XML, Response
XSD
API Schema > ContentMgmt > GetManufacturerProcessStatus > GetManufacturerProcessStatusResponse.xsd
<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<SellerID>A006</SellerID>
<OperationType>GetManufacturerStatusResponse</OperationType>
<ResponseDate>2/22/2012 16:51:03</ResponseDate>
<ResponseBody>
<ManufacturerList>
<Manufacturer>
<RequestName><![CDATA[AWG]]></RequestName>
<ApprovedName />
61
<Status>Processing</Status>
<RequestDate>2/21/2012 16:51:03</RequestDate>
<ProcessDate></ProcessDate>
<DeclineReason/>
</Manufacturer>
<Manufacturer>
<RequestName><![CDATA[sony & wonder]]></RequestName>
<ApprovedName>sony</ApprovedName>
<Status>Approved</Status>
<RequestDate>2/21/2012 15:51:03</RequestDate>
<ProcessDate>2/21/2012 16:51:03</ProcessDate>
<DeclineReason/>
</Manufacturer>
<Manufacturer>
<RequestName><![CDATA[Sony vario]]></RequestName>
<ApprovedName />
<Status>Declined</Status>
<RequestDate>2/21/2012 12:51:03</RequestDate>
<ProcessDate>2/21/2012 16:51:03</ProcessDate>
<DeclineReason><![CDATA[please provide manufacturer URL]]></DeclineReason>
</Manufacturer>
</ManufacturerList>
</ResponseBody>
</NeweggAPIResponse>
Example: Json, Response
{
"IsSuccess": "true",
"SellerID": "A006",
"OperationType": "GetManufacturerStatusResponse",
"ResponseDate": "2/22/2012 16:51:03",
"ResponseBody": {
"ManufacturerList": [
{
"RequestName": "AWG",
"Status": "Processing",
"RequestDate": "2/21/2012 16:51:03"
"ProcessDate": "",
"DeclineReason": ""
62
},
{
"RequestName": "sony & wonder",
"ApprovedName":"sony",
"Status": "Approved",
"RequestDate": "2/21/2012 15:51:03",
"ProcessDate": "2/21/2012 16:51:03",
"DeclineReason": ""
},
{
"RequestName": "Sony vario",
"Status": "Declined",
"RequestDate": "2/21/2012 12:51:03",
"ProcessDate": "2/21/2012 16:51:03",
"DeclineReason": "please provide manufacturer URL"
}
]
}
}
9.4.4. Request Failure Errors
For common HTTP error responses, please refer to Common Error Responses
9.5. Volume Discount Creation/Update/Removal
A volume discount is an adjustment to the price of a product based on the quantity of that product in an order. By offering
volume discounts, sellers are able to reward those who purchase a multiple quantity of goods.
Newegg Marketplace volume discount is designed as a 3-tier calculation. Volume discount creation/adjustment can only be
submitted with the following rules:
Purchase Quantity: Minimum Purchase Quantity (If any) tier-1 < tier-2 < tier-3
Price per Product: Regular Selling Price > tier-1 > tier-2 > tier-3
Shipping setting: tier-1 tier-2 tier-3
To specify volume discount for item A as following:
Purchase quantity from 2 to 4 units, the unit price is $10
Purchase quantity from 5 to 9, the unit price is $8
Purchase quantity from 10 and above, the unit price is $5.
63
Volume Discount Structure:
Tier
Quantity
Price/ Product
Examples of
Acceptable Shipping Setting
Examples of
Unacceptable Shipping Setting
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
NOTE:
Volume discount setting will not be available for customers if an ongoing promotion price is less than the
1st -tier unit price.
Only available for shipping destination as United States.
9.5.1. Resource URL & Information
Resource URL
https://api.newegg.com/marketplace/contentmgmt/item/volumediscount?sellerid={sellerid}
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
Resource Information
HTTP Method
Authentication?
Request Formats
Response Formats
Rate Limited?
POST
Required
XML, Json
XML, Json
100 per min per client
9.5.2. Request Body
Attribute
Required?
Format
Description
NeweggAPIRequest
OperationType
Yes
String
Fixed value:
SubmitVolumeDiscountReques
t
RequestBody
ItemVolumeDiscoun
tInfo
SellerPartNumber
No, if
NeweggItemNumber
is provided.
String
Seller Part#
NeweggItemNumber
No, if
SellerPartNumber is
provided.
String
NE Item#
64
VolumeActivation
Yes
String
Two action values are available:
True: Add / Update
False: Remove.
The default setting is "True".
You may set it to "False" if you
wish to remove the existing
volume discount.
DiscountSetting
Tier
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. The
acceptable shipping method:
0: Default
1: Free
Example: XML, Request
XSD
API Schema > ContentMgmt > SubmitVolumeDiscount > SubmitVolumeDiscountRequest.xsd
POST https://api.newegg.com/marketplace/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>
65
<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>
Example: Json, Request
POST https://api.newegg.com/marketplace/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"
66
}
]
}
}
}
}
9.5.3. Response Body
Attribute
Format
Description
NeweggAPIResponse
IsSuccess
String
Identify the operation of
Manufacturer requests
successful
Fixed value: True
SellerID
String
Your seller ID
OperationType
Fixed value:
SubmitVolumeDiscountRespons
OperationType
RequestBody
ItemVolumeDiscountInfo
SellerPartNumber
String
Seller Part#
NeweggItemNumber
String
NE Item#
DiscountSetting
Tier
Priority
Integer
The tier for the volume discount.
Quantity
Integer
The quantity for the tier's volume
discount.
SellingPrice
decimal
The unit price for the tier's
volume discount.
EnableFreeShipping
Integer
The shipping method for the
tier's volume discount.
Example: XML, Response
XSD
API Schema > ContentMgmt > SubmitVolumeDiscount > SubmitVolumeDiscountResponse.xsd
<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<OperationType>SubmitVolumeDiscountResponse</OperationType>
<SellerID>a001</SellerID>
67
<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>
Example: Json, Response
{
"IsSuccess": "true",
"OperationType": "SubmitVolumeDiscountResponse",
"SellerID": "a001",
"ResponseBody": {
"ItemVolumeDiscountInfo": {
"SellerPartNumber": "B0147001",
"NeweggItemNumber": "9SIA0010287920",
"DiscountSetting": {
"Tier": {
"Priority": "1",
"Quantity": "12",
"SellingPrice": "110",
"EnableFreeShipping": "0"
},
"Tier": {
"Priority": "2",
68
"Quantity": "20",
"SellingPrice": "105",
"EnableFreeShipping": "0"
}
}
}
}
}
9.5.4. Request Failure Errors
For common HTTP error responses, please refer to Common Error Responses
Error Code
Description
CT001
Invalid ItemNumber
CT002
Invalid SellerPartNumber
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}]
CT059
Item number or seller part# is required.
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}.
CT062
The volume price must following this condition: 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.
Example: XML, Response
<?xml version="1.0" encoding="utf-8"?>
<Errors>
<Error>
<Code>CT001</Code>
<Message>Invalid ItemNumber</Message>
</Error>
</Errors>
Example: Json, Response
{
69
"Code": "CT001",
"Message": "Invalid ItemNumber"
}
9.6. Get Volume Discount Request Result
9.6.1. Resource URL & Information
Resource URL
https://api.newegg.com/marketplace/contentmgmt/item/volumediscount?sellerid={sellerid}
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
Resource Information
HTTP Method
Authentication?
Request Formats
Response Formats
Rate Limited?
PUT
Required
XML, Json
XML, Json
100 per min per client
9.6.2. Request Body
Attribute
Required?
Format
Description
NeweggAPIRequest
OperationType
Yes
String
Fixed value: GetVolumeDiscountRequest
RequestBody
SellerPartNumber
No, if NeweggItemNumber is
provided.
String
Seller Part#
NeweggItemNumber
No, if SellerPartNumber is provided.
String
NE Item#
Example: XML, Request
XSD
API Schema > ContentMgmt > GetVolumeDiscount > GetVolumeDiscountRequest.xsd
PUT https://api.newegg.com/marketplace/contentmgmt/item/volumediscount?sellerid={SellerID}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
70
Content-Type: application/xml
Accept: application/xml
<NeweggAPIRequest >
<OperationType>GetVolumeDiscountRequest</OperationType>
<RequestBody>
<NeweggItemNumber>9SIA0010287920</NeweggItemNumber>
</RequestBody>
</NeweggAPIRequest>
Example: Json, Request
POST https://api.newegg.com/marketplace/contentmgmt/item/volumediscount?sellerid={SellerID}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"OperationType": "GetVolumeDiscountRequest",
"RequestBody": {
"NeweggItemNumber": "9SIA0010287920"
}
}
9.6.3. Response Body
Attribute
Format
Description
NeweggAPIResponse
IsSuccess
String
Identify the operation of
Manufacturer request is successful
Fixed value: True
SellerID
String
Your seller ID
OperationType
Fixed value:
GetVolumeDiscountResponse
OperationType
RequestBody
ItemVolumeDisco
untInfo
SellerPartNumber
String
Seller Part#
NeweggItemNumber
String
NE Item#
Discount
Setting
Tier
Priority
Integer
The tier for the volume discount.
Quantity
Integer
The quantity for the tier's volume
discount.
71
SellingPrice
decimal
The unit price for the tier's volume
discount.
EnableFreeShipping
Integer
The shipping method for the tier's
volume discount.
Example: XML, Response
XSD
API Schema > ContentMgmt > GetVolumeDiscount > GetVolumeDiscountResponse.xsd
<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<OperationType>GetVolumeDiscountResponse</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>
Example: Json, Response
72
{
"IsSuccess": "true",
"OperationType": "GetVolumeDiscountResponse",
"SellerID": "a001",
"ResponseBody": {
"ItemVolumeDiscountInfo": {
"SellerPartNumber": "B0147001",
"NeweggItemNumber": "9SIA0010287920",
"DiscountSetting": {
"Tier": {
"Priority": "1",
"Quantity": "12",
"SellingPrice": "110",
"EnableFreeShipping": "0"
},
"Tier": {
"Priority": "2",
"Quantity": "20",
"SellingPrice": "105",
"EnableFreeShipping": "0"
}
}
}
}
}
9.6.4. Request Failure Errors
For common HTTP error responses, please refer to Common Error Responses
Error Code
Description
CT001
Invalid ItemNumber
CT002
Invalid SellerPartNumber
CT059
Item number or seller part# is required.
CT060
Not found. The requested item does not have volume discount yet.
Example: XML, Response
<?xml version="1.0" encoding="utf-8"?>
<Errors>
73
<Error>
<Code>CT001</Code>
<Message>Invalid ItemNumber</Message>
</Error>
</Errors>
Example: Json, Response
{
"Code": "CT001",
"Message": "Invalid ItemNumber"
}
9.7. Get Item Inventory
Tracking the inventory quantity of items in all registered warehouses around the world, including the United States.
9.7.1. Resource URL & Information
Resource URL
https://api.newegg.com/marketplace/contentmgmt/item/international/inventory?sellerid={sellerid}
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
Resource Information
HTTP Method
Authentication?
Request Formats
Response Formats
Rate Limited?
PUT
Required
XML, Json
XML, Json
1000 per min per client
9.7.2. Request Body
Attribute
Required?
Format
Description
ContentQuery
Criteria
Condition
No
Integer
Available values:
1: New
2: Refurbished
3: Used Like New
74
4: Used Very Good
5: Used Good
6: Used Acceptable
Only applies if type = [2-UPC code]. If type does not = [2-UPC code],
then this column will be disregarded.
If left blank, default value will be New.
Type
Yes
Integer
0: NE Item#
1: Seller Part#
2: UPC Code
Value
Yes
String
A string according to the specified value of Type
WarehouseList
WarehouseLocation
No
String
The ISO standard 3-digit codes of the country where your warehouse is
located. Please download the following to review details:
http://promotions.newegg.com/marketplace/sellers/resourceLibrary/I
nternational%20Country%20Guide.pdf
If left blank, default value will be All.
Example: XML, Request
XSD
API Schema > ContentMgmt > GetInventory > GetInventoryRequest.xsd
PUT
https://api.newegg.com/marketplace/contentmgmt/item/international/inventory?sellerid={SellerID}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<ContentQueryCriteria>
<Type>1</Type>
<Value>A006testitem201201021459</Value>
<WarehouseList>
<WarehouseLocation>USA</WarehouseLocation>
<WarehouseLocation>AUS</WarehouseLocation>
</WarehouseList>
</ContentQueryCriteria>
75
Example: Json, Request
PUT
https://api.newegg.com/marketplace/contentmgmt/item/international/inventory?sellerid={SellerID}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"Type": "1",
"Value": "A006testitem201201021459",
"WarehouseList": {
"WarehouseLocation": [
"USA",
"AUS"
]
}
}
9.7.3. Response Body
Attribute
Format
Description
InventoryResult
SellerId
String
Your seller ID
ItemNumber
String
Newegg item number
SellerPartNumber
String
Seller part number
InventoryAllocation
Inventory
WarehouseLocation
String
The ISO standard 3-digit codes of the country where your
warehouse is located. Please download the following to review
details:
http://promotions.newegg.com/marketplace/sellers/resourceLibr
ary/International%20Country%20Guide.pdf
FulfillmentOption
String
Available values:
0: ShipBySeller
1: ShipByNewegg
AvailableQuantity
Integer
Current available inventory in this warehouse.
76
WarehouseAllocation
Warehouse
WarehouseCode
String
Indicates the inventory is currently stored in which Newegg
warehouse.
Available values:
06: Tennessee Bulk Warehouse
07: California Small Warehouse
08: California Bulk Item Warehouse
10: New Jersey Bulk Warehouse
12: Tennessee Small Warehouse
14: New Jersey Small Warehouse
Note: this information will be returned only when the inventory
is currently stored in Newegg’s warehouse.
Quantity
Integer
Current available inventory in this Newegg warehouse.
Note: this information will be returned only when the inventory
is currently stored in Newegg’s warehouse.
Example: XML, Response
XSD
API Schema > ContentMgmt > GetInternationalInventory > GetInventoryResponse.xsd
<?xml version="1.0" encoding="utf-8"?>
<InventoryResult>
<SellerID>A006</SellerID>
<ItemNumber>9SIA0060884598</ItemNumber>
<SellerPartNumber>A006testitem201201021459</SellerPartNumber>
<InventoryAllocation>
<Inventory>
<WarehouseLocation>USA</WarehouseLocation>
<FulfillmentOption>0</FulfillmentOption>
<AvailableQuantity>107</AvailableQuantity>
</Inventory>
<Inventory>
<WarehouseLocation>USA</WarehouseLocation>
<FulfillmentOption>1</FulfillmentOption>
<AvailableQuantity>40</AvailableQuantity>
<WarehouseAllocation>
<Warehouse>
77
<WarehouseCode>07</WarehouseCode>
<Quantity>3</Quantity>
</Warehouse>
<Warehouse>
<WarehouseCode>12</WarehouseCode>
<Quantity>37</Quantity>
</Warehouse>
</WarehouseAllocation>
</Inventory>
<Inventory>
<WarehouseLocation>AUS</WarehouseLocation>
<FulfillmentOption>0</FulfillmentOption>
<AvailableQuantity>0</AvailableQuantity>
</Inventory>
</InventoryAllocation>
</InventoryResult>
Example: Json, Response
{
"SellerID": "A006",
"ItemNumber": "9SIA0060884598",
"SellerPartNumber": "A006testitem201201021459",
"InventoryAllocation": {
"Inventory": [
{
"WarehouseLocation": "USA",
"FulfillmentOption": "0",
"AvailableQuantity": "107"
},
{
"WarehouseLocation": "USA",
"FulfillmentOption": "1",
"AvailableQuantity": "40",
"WarehouseAllocation": {
"Warehouse": [
{
"WarehouseCode": "07",
"Quantity": "3"
},
78
{
"WarehouseCode": "12",
"Quantity": "37"
}
]
}
},
{
"WarehouseLocation": "AUS",
"FulfillmentOption": "0",
"AvailableQuantity": "0"
}
]
}
}
9.7.4. Request Failure Errors
For common HTTP error responses, please refer to Common Error Responses
Error Code
Description
CT001
Invalid ItemNumber
CT002
Invalid SellerPartNumber
CT003
Invalid UPCCode
CT005
Invalid Action Type. We only support: 0 NE Item#, 1 -- Seller Parts#, 2 -- UPC Code
CT010
Cannot find item with specified item condition.
CT026
No data found
Example: XML, Response
<?xml version="1.0" encoding="utf-8"?>
<Errors>
<Error>
<Code>CT002</Code>
<Message>Invalid SellerPartNumber</Message>
</Error>
</Errors>
79
Example: Json, Response
{
"Code": "CT002",
"Message": "Invalid SellerPartNumber"
}
9.8. Get Item Price
Tracking the price related information of items for destination countries, including the United States.
9.8.1. Resource URL & Information
Resource URL
https://api.newegg.com/marketplace/contentmgmt/item/international/price?sellerid={sellerid}
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
Resource Information
HTTP Method
Authentication?
Request Formats
Response Formats
Rate Limited?
PUT
Required
XML, Json
XML, Json
1000 per min per client
9.8.2. Request Body
Attribute
Required?
Format
Description
ContentQueryCriteria
Type
Yes
Integer
0: NE Item#
1: Seller Part#
2: UPC Code
Value
Yes
String
A string according to a given inquiry type
Condition
No
Integer
Available values:
1: new
2: Refurbished
3: Used Like New
4: Used Very Good
5: Used Good
6: Used Acceptable
80
Only applies if type = [2-UPC code]. If type does not = [2-UPC
code], then this column will be disregarded.
If left blank, default value will be 1: New.
CountryList
CountryCode
No
String
The ISO standard 3-digit codes of the country where your
warehouse is located. Please download the following to review
details:
http://promotions.newegg.com/marketplace/sellers/resourceLi
brary/International%20Country%20Guide.pdf
If left blank, default value will be All.
Example: XML, Request
XSD
API Schema > ContentMgmt > GetPrice > GetPriceRequest.xsd
PUT https://api.newegg.com/marketplace/contentmgmt/item/international/price?sellerid={SellerID}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<ContentQueryCriteria>
<Type>1</Type>
<Value>A006testitem201201021459</Value>
<CountryList>
<CountryCode>USA</CountryCode>
<CountryCode>AUS</CountryCode>
</CountryList>
</ContentQueryCriteria>
Example: Json, Request
PUT https://api.newegg.com/marketplace/contentmgmt/item/international/price?sellerid={SellerID}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
81
{
"Type": "1",
"Value": "A006testitem201201021459",
"CountryList": {
"CountryCode": [
"USA",
"AUS"
]
}
}
9.8.3. Response Body
Attribute
Format
Description
PriceResult
SellerId
String
Your seller ID
ItemNumber
String
Newegg item number
SellerPartNumber
String
Seller part number
PriceList
Price
CountryCode
String
The ISO standard 3-digit codes of the country where your warehouse is
located. Please download the following to review details:
http://promotions.newegg.com/marketplace/sellers/resourceLibrary/Intern
ational%20Country%20Guide.pdf
Currency
String
The currency is to identify the Selling Price, MSRP, MAP for the target
country you will be selling your items to. Only the ISO standard 3-digit codes
are accepted. The default value will be USD if left blank. To review the
complete list of available values, please download the following:
http://promotions.newegg.com/marketplace/sellers/resourceLibrary/Intern
ational%20Country%20Guide.pdf
Active
Integer
0: Inactive
1: Active
MSRP
Decimal
The manufacturer’s suggested retail price
MAP
Decimal
Minimum Advertised Price. If the Selling Price is below the defined MAP,
website will ask customer to add item to shopping cart to see the item's
price.
82
CheckoutMAP
Integer
0: False
1: True
If Checkout MAP is marked as True, then the website will ask customer to
add item to shopping cart AND go to checkout page to see the item's price.
The MAP value will not be considered. Another words, if this field is marked
as true, it doesn't matter if the selling price is above or below MAP, the
customer will always need to add item to cart and go to checkout to see
item's price.
If MAP is greater than 0.00 and CheckoutMAP is left blank, by default
CheckoutMAP will equal False.
SellingPrice
Decimal
The actual selling price
EnableFreeShipping
Integer
0: Default
1: Free Shipping
On promotion
Integer,
separated
by comma
0: No active Promotion
1: Active promotion with Price Lock
2: Active Promotion with Promotion Code
3: Active promotion with Auto Add To Cart
4: Active Promotion with Combo
5: Active Promotion with Volume Discount
Example: XML, Response
XSD
API Schema > ContentMgmt > GetPrice > GetPriceResponse.xsd
<?xml version="1.0" encoding="utf-8"?>
<PriceResult>
<SellerID>A006</SellerID>
<ItemNumber>9SIA0060884598</ItemNumber>
<SellerPartNumber>A006testitem201201021459</SellerPartNumber>
<PriceList>
<Price>
<CountryCode>USA</CountryCode>
<Currency>USD</Currency>
<Active>0</Active>
<MSRP>30.98</MSRP>
<MAP>25.99</MAP>
<CheckoutMAP>0</CheckoutMAP>
<SellingPrice>20.92</SellingPrice>
<EnableFreeShipping>1</EnableFreeShipping>
83
<OnPromotion>1,5</OnPromotion>
</Price>
<Price>
<CountryCode>IND</CountryCode>
<Currency>INR</Currency>
<Active>1</Active>
<MSRP>459.98</MSRP>
<MAP>25.99</MAP>
<CheckoutMAP>0</CheckoutMAP>
<SellingPrice>389.92</SellingPrice>
<EnableFreeShipping>0</EnableFreeShipping>
<OnPromotion>1,5</OnPromotion>
</Price>
<Price>
<CountryCode>IRL</CountryCode>
<Currency>EUR</Currency>
<Active>0</Active>
<MSRP>30.98</MSRP>
<MAP>25.99</MAP>
<CheckoutMAP>0</CheckoutMAP>
<SellingPrice>19.92</SellingPrice>
<EnableFreeShipping>0</EnableFreeShipping>
<OnPromotion/>
</Price>
</PriceList>
</PriceResult>
Example: Json, Response
{
"SellerID": "A006",
"ItemNumber": "9SIA0060884598",
"SellerPartNumber": "A006testitem201201021459",
"PriceList": {
"Price": [
{
"CountryCode": "USA",
"Currency": "USD",
"Active": "0",
84
"MSRP": "30.98",
"MAP": "25.99",
"CheckoutMAP": "0",
"SellingPrice": "20.92",
"EnableFreeShipping": "1",
"OnPromotion": "1,5"
},
{
"CountryCode": "IND",
"Currency": "INR",
"Active": "1",
"MSRP": "459.98",
"MAP": "25.99",
"CheckoutMAP": "0",
"SellingPrice": "389.92",
"EnableFreeShipping": "0",
"OnPromotion": "1,5"
},
{
"CountryCode": "IRL",
"Currency": "EUR",
"Active": "0",
"MSRP": "30.98",
"MAP": "25.99",
"CheckoutMAP": "0",
"SellingPrice": "19.92",
"EnableFreeShipping": "0"
}
]
}
}
9.8.4. Request Failure Errors
For common HTTP error responses, please refer to Common Error Responses
Error Code
Description
CT001
Invalid ItemNumber
CT002
Invalid SellerPartNumber
85
CT003
Invalid UPCCode
CT005
Invalid Action Type. We only support: 0 - NE Item#, 1 - Seller Parts#, 2 - UPC Code
CT010
Cannot find item with specified item condition.
CT026
No data found
Example: XML, Response
<?xml version="1.0" encoding="utf-8"?>
<Errors>
<Error>
<Code>CT002</Code>
<Message>Invalid SellerPartNumber</Message>
</Error>
</Errors>
Example: Json, Response
{
"Code": "CT002",
"Message": "Invalid SellerPartNumber"
}
9.9. Update Item Inventory
Maintaining the inventory quantity of items in all registered warehouses around the world, including the United States.
9.9.1. Resource URL & Information
Resource URL
https://api.newegg.com/marketplace/contentmgmt/item/international/inventory?sellerid={sellerid}
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
Resource Information
HTTP Method
Authentication?
Request Formats
Response Formats
Rate Limited?
POST
Required
XML, Json
XML, Json
300 per min per client
86
9.9.2. Request Body
Attribute
Required?
Format
Description
ItemInventoryInfo
Type
Yes
Integer
Available values:
0: NE Item #
1: Seller Part #
2: UPC
Value
Yes
String
A string according to inquiry type
Condition
No
Integer
Available values:
1: New (default)
2: Refurbished
3: Used Like New
4: Used Very Good
5: Used Good
6: Used Acceptable
Only applies if type = [2-UPC code]. If type does not = [2-UPC code],
then this column will be disregarded.
InventoryList
Inventory
WarehouseLocation
Yes
String
The ISO standard 3-digit codes of the country where your
warehouse is located. Please download the following to review
details:
http://promotions.newegg.com/marketplace/sellers/resourceLibra
ry/International%20Country%20Guide.pdf
NOTE: Submissions with incorrect values will error-out.
AvailableQuantity
Yes
Integer
Current available inventory in this warehouse.
Example: XML, Request
XSD
API Schema > ContentMgmt > UpdateInventory > UpdateInventoryRequest.xsd
POST
https://api.newegg.com/marketplace/contentmgmt/item/international/inventory?sellerid={SellerID}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Accept: application/xml
Content-Type: application/xml
<ItemInventoryInfo>
87
<Type>1</Type>
<Value>A006BSP3</Value>
<InventoryList>
<Inventory>
<WarehouseLocation>USA</WarehouseLocation>
<AvailableQuantity>107</AvailableQuantity>
</Inventory>
<Inventory>
<WarehouseLocation>AUS</WarehouseLocation>
<AvailableQuantity>0</AvailableQuantity>
</Inventory>
</InventoryList>
</ItemInventoryInfo>
Example: Json, Request
POST
https://api.newegg.com/marketplace/contentmgmt/item/international/inventory?sellerid={SellerID}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Accept: application/json
Content-Type: application/json
{
"Type": "1",
"Value": "A006BSP3",
"InventoryList": {
"Inventory": [
{
"WarehouseLocation": "USA",
"AvailableQuantity": "107"
},
{
"WarehouseLocation": "AUS",
"AvailableQuantity": "0"
}
]
}
}
88
9.9.3. Response Body
Attribute
Format
Description
UpdateInventoryResult
SellerID
String
Your seller ID
ItemNumber
String
Newegg item number
SellerPartNumber
String
Seller Part Number
InventoryList
Inventory
WarehouseLocation
String
The ISO standard 3-digit codes of the country where your warehouse is
located. copy link to your browser to review details:
http://promotions.newegg.com/marketplace/sellers/resourceLibrary/In
ternational%20Country%20Guide.pdf
AvailableQuantity
Integer
Current available inventory in this warehouse.
Example: XML, Response
XSD
API Schema > ContentMgmt > UpdateInventory > UpdateInventoryResponse.xsd
<?xml version="1.0" encoding="utf-8"?>
<UpdateInventoryResult>
<SellerID>A006</SellerID>
<ItemNumber>9SIA00607Y6476</ItemNumber>
<SellerPartNumber>A006BSP3</SellerPartNumber>
<InventoryList>
<Inventory>
<WarehouseLocation>USA</WarehouseLocation>
<AvailableQuantity>107</AvailableQuantity>
</Inventory>
<Inventory>
<WarehouseLocation>AUS</WarehouseLocation>
<AvailableQuantity>0</AvailableQuantity>
</Inventory>
</InventoryList>
</UpdateInventoryResult>
Example: Json, Response
{
"SellerID": "A006",
89
"ItemNumber": "9SIA00607Y6476",
"SellerPartNumber": "A006BSP3",
"InventoryList": {
"Inventory": [
{
"WarehouseLocation": "USA",
"AvailableQuantity": "107"
},
{
"WarehouseLocation": "AUS",
"AvailableQuantity": "0"
}
]
}
}
9.9.4. Request Failure Errors
For common HTTP error responses, please refer to Common Error Responses
Error Code
Description
CT001
Invalid ItemNumber
CT002
Invalid SellerPartNumber
CT003
Invalid UPCCode
CT005
Invalid Action Type. We only support: 0 - NE Item#, 1 - Seller Parts#, 2 - UPC Code
CT010
Cannot find item with specified item condition.
CT014
SellerItemNumber or SellerPartNumber does not exist
CT015
Item does not belong to this seller
CT023
Inventory value must be between 0 and 999999
CT025
This item is an approved promotion and its minimum inventory cannot be lower than {0}
CT055
This is a duplicated request for Seller Part #: [seller part #]. This item does not exist in Newegg so we are not able
to process your request. We will resume the process of price and inventory update for this item 8 hours after [last
failed timestamp].
CT073
The request for item: { SellerPart#} has been processed with error.Country: [country1,country2] Failed reason: The
specified warehouse location has not been setup yet. Please set up your warehouse(s) then submit your request
again,
Example: XML, Response
90
<?xml version="1.0" encoding="utf-8"?>
<Errors>
<Error>
<Code>CE003</Code>
<Message> The 'Type' element is invalid - The value 'a' is invalid according to its
datatype 'Int' - The string 'a' is not a valid Int32 value.</Message>
</Error>
</Errors>
Example: Json, Response
{
"Code": "CT002",
"Message": "Invalid SellerPartNumber"
}
9.10. Update Item Price
Maintaining the price of items in all eligible countries, including the United States.
9.10.1. Resource URL & Information
Resource URL
https://api.newegg.com/marketplace/contentmgmt/item/international/price?sellerid={sellerid}
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
Resource Information
HTTP Method
Authentication?
Request Formats
Response Formats
Rate Limited?
POST
Required
XML, Json
XML, Json
300 per min per client
91
9.10.2. Request Body
Attribute
Required?
Format
Description
ItemPriceInfo
Type
Yes
Integer
Available values:
0: NE Item #
1: Seller Part #
2: UPC
Value
Yes
String
A string according to inquiry type
Condition
No
Integer
Available values:
1: New (default)
2: Refurbished
3: Used Like New
4: Used Very Good
5: Used Good
6: Used Acceptable
Only applies if type = [2-UPC code]. If type does not = [2-UPC code],
then this column will be disregarded.
PriceList
Price
CountryCode
Yes
String
The target country you will be selling your items to. Only the ISO
standard 3-digit codes are accepted.
To review the complete list of available values, please download
the following:
https://promotions.newegg.com/Marketplace/Sellers/resourceLib
rary/International%20Country%20Guide.pdf
NOTE: Item price must be submitted with the correct currency
code based on ship-to destination country code. Submissions with
incorrect combinations will error-out.
Currency
Yes
String
The currency is to identify the Selling Price, MSRP, MAP for the
target country you will be selling your items to. Only the ISO
standard 3-digit codes are accepted.
To review the complete list of available values, please download the
following:
https://promotions.newegg.com/Marketplace/Sellers/resourceLib
rary/International%20Country%20Guide.pdf
NOTE: Correct currency code must be submitted based on ship-to
destination country code. Submissions with incorrect combinations
will error-out.
92
Active
No
Integer
Available values:
1: Activate item
0: Deactivate item
Null = Ignore this action, no change to current item
active/deactivate setting
MSRP
No
Decimal
The manufacturer’s suggested retail price
MAP
No
Decimal
Minimum Advertised Price. If the Selling Price is below the defined
MAP, website will ask customer to add item to shopping cart to
see the item's price.
CheckoutMAP
No
Integer
Available values:
0: False
1: True
If Checkout MAP is marked as True, then the website will ask
customer to add item to shopping cart AND go to checkout page
to see the item's price. The MAP value will not be considered.
Another words, if this field is marked as true, it doesn't matter if
the selling price is above or below MAP, the customer will always
need to add item to cart and go to checkout to see item's price.
If MAP is greater than 0.00 and CheckoutMAP is left blank, by
default CheckoutMAP will equal False.
SellingPrice
No
Decimal
The actual selling price
EnableFreeShipping
No
Integer
Available values:
0: Default
1: Free Shipping
Example: XML, Request
XSD
API Schema > ContentMgmt > UpdatePrice > UpdatePriceRequest.xsd
POST https://api.newegg.com/marketplace/contentmgmt/item/international/price?sellerid={SellerID}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Accept: application/xml
Content-Type: application/xml
<ItemPriceInfo>
93
<Type>1</Type>
<Value>A006BSP3</Value>
<PriceList>
<Price>
<CountryCode>USA</CountryCode>
<Currency>USD</Currency>
<Active>0</Active>
<MSRP>30.98</MSRP>
<MAP>25.99</MAP>
<CheckoutMAP>0</CheckoutMAP>
<SellingPrice>20.92</SellingPrice>
<EnableFreeShipping>1</EnableFreeShipping>
</Price>
<Price>
<CountryCode>IND</CountryCode>
<Currency>INR</Currency>
<Active>1</Active>
<MSRP>459.98</MSRP>
<MAP>25.99</MAP>
<CheckoutMAP>0</CheckoutMAP>
<SellingPrice>389.92</SellingPrice>
<EnableFreeShipping>0</EnableFreeShipping>
</Price>
<Price>
<CountryCode>IRL</CountryCode>
<Currency>EUR</Currency>
<Active>0</Active>
<MSRP>30.98</MSRP>
<MAP>25.99</MAP>
<CheckoutMAP>0</CheckoutMAP>
<SellingPrice>19.92</SellingPrice>
<EnableFreeShipping>0</EnableFreeShipping>
</Price>
</PriceList>
</ItemPriceInfo>
Example: Json, Request
POST
https://api.newegg.com/marketplace/contentmgmt/item/inventoryandprice?sellerid={SellerID}&version
=304
94
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Accept: application/json
Content-Type: application/json
{
"Type": "1",
"Value": "A006BSP3",
"PriceList": {
"Price": [
{
"CountryCode": "USA",
"Currency": "USD",
"Active": "0",
"MSRP": "30.98",
"MAP": "25.99",
"CheckoutMAP": "0",
"SellingPrice": "20.92",
"EnableFreeShipping": "1"
},
{
"CountryCode": "IND",
"Currency": "INR",
"Active": "1",
"MSRP": "459.98",
"MAP": "25.99",
"CheckoutMAP": "0",
"SellingPrice": "389.92",
"EnableFreeShipping": "0"
},
{
"CountryCode": "IRL",
"Currency": "EUR",
"Active": "0",
"MSRP": "30.98",
"MAP": "25.99",
"CheckoutMAP": "0",
"SellingPrice": "19.92",
"EnableFreeShipping": "0"
}
]
95
}
}
9.10.3. Response Body
Attribute
Format
Description
UpdatePriceResult
SellerID
String
Your seller ID
ItemNumber
String
Newegg item number
SellerPartNumber
String
Seller Part Number
PriceList
Price
CountryCode
String
The target country you will be selling your items to. Newegg will return
the value in ISO standard 3-digit codes.
To review the complete list of available values, please download the
following:
https://promotions.newegg.com/Marketplace/Sellers/resourceLibrary/Int
ernational%20Country%20Guide.pdf
Currency
String
The currency is to identify the Selling Price, MSRP, MAP for the target
country you will be selling your items to. Newegg will return the value in
ISO standard 3-digit codes.
To review the complete list of available values, please download the
following:
https://promotions.newegg.com/Marketplace/Sellers/resourceLibrary/Int
ernational%20Country%20Guide.pdf
Active
Integer
Available values:
0: Inactive
1: Active
MSRP
Decimal
The manufacturer’s suggested retail price
MAP
Decimal
Minimum Advertised Price. If the Selling Price is below the defined MAP,
website will ask customer to add item to shopping cart to see the item's
price.
CheckoutMAP
Integer
Available values:
0: False
1: True
If Checkout MAP is marked as True, then the website will ask customer to
add item to shopping cart AND go to checkout page to see the item's
price. The MAP value will not be considered. Another words, if this field is
marked as true, it doesn't matter if the selling price is above or below
96
MAP, the customer will always need to add item to cart and go to
checkout to see item's price.
If MAP is greater than 0.00 and CheckoutMAP is left blank, by default
CheckoutMAP will equal False.
SellingPrice
Decimal
The actual selling price
EnableFreeShipping
Integer
Available values:
0: Default
1: Free Shipping
Example: XML, Response
XSD
API Schema > ContentMgmt > UpdatePrice > UpdatePriceResponse.xsd
<?xml version="1.0" encoding="utf-8"?>
<UpdatePriceResult>
<SellerID>A006</SellerID>
<ItemNumber>9SIA00607Y6476</ItemNumber>
<SellerPartNumber>A006BSP3</SellerPartNumber>
<PriceList>
<Price>
<CountryCode>USA</CountryCode>
<Currency>USD</Currency>
<Active>0</Active>
<MSRP>30.98</MSRP>
<MAP>25.99</MAP>
<CheckoutMAP>0</CheckoutMAP>
<SellingPrice>20.92</SellingPrice>
<EnableFreeShipping>1</EnableFreeShipping>
</Price>
<Price>
<CountryCode>IND</CountryCode>
<Currency>INR</Currency>
<Active>1</Active>
<MSRP>459.98</MSRP>
<MAP>25.99</MAP>
<CheckoutMAP>0</CheckoutMAP>
<SellingPrice>389.92</SellingPrice>
<EnableFreeShipping>0</EnableFreeShipping>
97
</Price>
<Price>
<CountryCode>IRL</CountryCode>
<Currency>EUR</Currency>
<Active>0</Active>
<MSRP>30.98</MSRP>
<MAP>25.99</MAP>
<CheckoutMAP>0</CheckoutMAP>
<SellingPrice>19.92</SellingPrice>
<EnableFreeShipping>0</EnableFreeShipping>
</Price>
</PriceList>
</UpdatePriceResult>
Example: Json, Response
{
"SellerID": "A006",
"ItemNumber": "9SIA00607Y6476",
"SellerPartNumber": "A006BSP3",
"PriceList": {
"Price": [
{
"CountryCode": "USA",
"Currency": "USD",
"Active": "0",
"MSRP": "30.98",
"MAP": "25.99",
"CheckoutMAP": "0",
"SellingPrice": "20.92",
"EnableFreeShipping": "1"
},
{
"CountryCode": "IND",
"Currency": "INR",
"Active": "1",
"MSRP": "459.98",
"MAP": "25.99",
"CheckoutMAP": "0",
"SellingPrice": "389.92",
"EnableFreeShipping": "0"
98
},
{
"CountryCode": "IRL",
"Currency": "EUR",
"Active": "0",
"MSRP": "30.98",
"MAP": "25.99",
"CheckoutMAP": "0",
"SellingPrice": "19.92",
"EnableFreeShipping": "0"
}
]
}
}
9.10.4. Request Failure Errors
For common HTTP error responses, please refer to Common Error Responses
Error Code
Description
CT001
Invalid ItemNumber
CT002
Invalid SellerPartNumber
CT003
Invalid UPCCode
CT005
Invalid Action Type. We only support: 0 - NE Item#, 1 - Seller Parts#, 2 - UPC Code
CT004
Item under review, you cannot activate.
CT006
Invalid MSRP. The range should be between 0-99999.99
CT007
Invalid Selling Price. The range should be between 0-99999.99
CT008
Invalid Shipping type. We only support: 0 - default, 1 - free shipping
CT009
Cannot activate item by restricted manufacturer - {0}[({1}){2}].
CT010
Cannot find item with specified item condition.
CT014
SellerItemNumber or SellerPartNumber does not exist
CT015
Item does not belong to this seller
CT016
The item: [SellerPart#] is locked for an on-going/upcoming promotion. CANNOT update the Shipping. Please
note: the inventory or minimum purchase quantity update will NOT be affected.
CT019
The item: [SellerPart#] is locked for an on-going/upcoming promotion. CANNOT update the Selling Price. Please
note: the inventory or minimum purchase quantity update will NOT be affected.
CT028
Invalid Active Mark. We only support: 0 - deactivate item, 1 - activate item
CT029
The selling price {selling price} cannot be greater than MSRP {MSRP}.
CT030
MAP price should be decimal with 2 digitals. The range should be between 0-99999.99.
99
CT031
Invalid CheckoutMAP value. We only support: 0 - False, 1 True.
CT032
The selling price cannot be 0.
CT043
The item cannot be active because of one of the following reasons:1.Does not exist 2.Breaks the price rule 3.No
image
CT044
The item cannot be deactivated because of an on-going/upcoming promotion that is locked by Newegg. Please
note: the inventory or minimum purchase quantity update will NOT be affected.
CT045
Item was automatically deactivated due to 7 days out of stock and cannot be reactivated with 0 inventory.
CT050
Item Activation Failed. Strict MAP enforced: ${0} Selling Price must be greater than or equal to strict MAP. Please
contact your account manager for more information.
CT052
This item cannot be activate because of the subcategory had been disabled for your account.
CT053
This item now matches a restricted item and cannot be activated. All other updates will be processed.
CT055
This is a duplicated request for Seller Part #: [seller part #]. This item does not exist in Newegg so we are not able
to process your request. We will resume the process of price and inventory update for this item 8 hours after [last
failed timestamp].
CT065
Invalid Selling Price. The Selling Price should be greater than the existing 1st tier volume discount unit price: [{0}]
CT067
The item: [SellerPart#] is regulated by a Newegg existing MAP (Minimum Advertised Pricing) setting: MAP =
[amount], Checkout MAP = [status]. When MAP amount is great than 0 or Checkout MAP = True, the attempt to
change either MAP or Checkout MAP is restricted. All other requests have been processed.
CT071
The Inventory update for item: [SellerPart#] cannot be processed because of the warehouse: [warehouselocation]
has not been created.
CT075
Price update failed. Invalid currency code. The currency code received: [code] does not match the specified country:
[code].
CT076
Item cannot be activated for specified country: [code]. Please activate the country, then submit your request again.
CT092
The request for item: {Seller Part #} has been processed with error. Error: You have reached the maximum allowance
of listing: [limit #] items. To list more, please optimize your listings. To increase the allowance, please upgrade your
service. Country(s): [code1, code 2, ….code #]
CT096
FREE SHIPPING is not available for NISP (Newegg International Shipping Program). For free domestic shipping,
please update your shipping settings in Seller Portal.
CT097
Item shipping dimensions do not meet the limits of NISP (Newegg International Shipping Program).
Example: XML, Response
<?xml version="1.0" encoding="utf-8"?>
<Errors>
<Error>
<Code>CE003</Code>
100
<Message> The 'Type' element is invalid - The value 'a' is invalid according to its
datatype 'Int' - The string 'a' is not a valid Int32 value.</Message>
</Error>
</Errors>
Example: Json, Response
{
"Code": "CT002",
"Message": "Invalid SellerPartNumber"
}
9.11. Submit Item Warranty Request
Specifying warranty services on refurbished items selling on Newegg Marketplace.
9.11.1. Resource URL & Information
Resource URL
https://api.newegg.com/marketplace/contentmgmt/item/warranty?sellerid={sellerid}
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
Resource Information
HTTP Method
Authentication?
Request Formats
Response Formats
Rate Limited?
POST
Required
XML, Json
XML, Json
300 per min per client
9.11.2. Request Body
Attribute
Required?
Format
Description
Newegg
APIRequ
est
OperationType
Yes
String
Fixed value:
SubmitItemWarrantyRequest
ActionType
Yes
Integer
Available values:
101
0: Create Warranty
1: Update Warranty
2: Delete Warranty
RequestBody
ItemWarrantyList
ItemWarranty
ItemManufacturerWarrantyID
No
Integer
Warranty ID. When updating and
deleting warranty, if warranty id is 0, we
will find the warranty by
SellerPartNumber and CountryCode.
SellerPartNumber
Yes
String
Seller Part #
PartsDay
No
Integer
Parts Day, 0-99999. You can set Parts Days
as "99999" to indicate a lifetime
warranty.
LaborDay
No
Integer
Labor Day, 0-99999. You can set Labor
Days as "99999" to indicate a lifetime
warranty.
ServiceProvider
Yes
String
Service Provider Name
ProviderSupportEmail
Yes
String
Warranty support email address.
ProviderSupportURL
No
String
Warranty support URL
ProviderCustomerServicePhone
Yes
String
Warranty Customer Service phone
number. Please use NANP phone number
format.
Example: 234-235-5678.
CountryCode
Yes
String
Ship to country. Fixed Value: USA
ApplyToAllCountryCode
Yes
Boolean
Fixed value: false.
Example: XML, Request
XSD
API Schema > ContentMgmt > ItemWarranty > ItemWarrantyRequest.xsd
POST https://api.newegg.com/marketplace/contentmgmt/item/warranty?sellerid={SellerID}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Accept: application/xml
Content-Type: application/xml
<NeweggAPIRequest>
102
<OperationType>SubmitItemWarrantyRequest</OperationType>
<ActionType>0</ActionType>
<RequestBody>
<ItemWarrantyList>
<ItemWarranty>
<ItemManufacturerWarrantyID>0</ItemManufacturerWarrantyID>
<SellerPartNumber>bg9h2016042003</SellerPartNumber>
<PartsDay>10</PartsDay>
<LaborDay>10</LaborDay>
<ServiceProvider>Test</ServiceProvider>
<ProviderSupportEmail>test@newegg.com</ProviderSupportEmail>
<ProviderSupportURL>http://www.sohnen.com/CustomerSupport.aspx</ProviderSupportUR
L>
<ProviderCustomerServicePhone>562-946-3531</ProviderCustomerServicePhone>
<CountryCode>USA</CountryCode>
<ApplyToAllCountryCode>false</ApplyToAllCountryCode>
</ItemWarranty>
<ItemWarranty>
<ItemManufacturerWarrantyID>0</ItemManufacturerWarrantyID>
<SellerPartNumber>bg9h2016042001</SellerPartNumber>
<PartsDay>10</PartsDay>
<LaborDay>10</LaborDay>
<ServiceProvider>Test</ServiceProvider>
<ProviderSupportEmail>test@newegg.com</ProviderSupportEmail>
<ProviderSupportURL></ProviderSupportURL>
<ProviderCustomerServicePhone>562-946-3531</ProviderCustomerServicePhone>
<CountryCode>USA</CountryCode>
<ApplyToAllCountryCode>false</ApplyToAllCountryCode>
</ItemWarranty>
</ItemWarrantyList>
</RequestBody>
</NeweggAPIRequest>
Example: Json, Request
POST https://api.newegg.com/marketplace/contentmgmt/item/warranty?sellerid={SellerID}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Accept: application/json
Content-Type: application/json
103
{
"OperationType": "SubmitItemWarrantyRequest",
"ActionType": 0,
"RequestBody": {
"ItemWarrantyList": [
{
"ItemWarranty": [
{
"ItemManufacturerWarrantyID": 0,
"SellerPartNumber": "bg9h2016042003",
"PartsDay": 10,
"LaborDay": 10,
"ServiceProvider": "Test",
"ProviderSupportEmail": "test@newegg.com",
"ProviderSupportURL": "http://www.sohnen.com/CustomerSupport.aspx",
"ProviderCustomerServicePhone": "562-946-3531",
"CountryCode": "USA",
"ApplyToAllCountryCode": "false"
},
{
"ItemManufacturerWarrantyID": 0,
"SellerPartNumber": "bg9h2016042001",
"PartsDay": 10,
"LaborDay": 10,
"ServiceProvider": "Test",
"ProviderSupportEmail": "test@newegg.com",
"ProviderSupportURL": null,
"ProviderCustomerServicePhone": "562-946-3531",
"CountryCode": "USA",
"ApplyToAllCountryCode": "false"
}
]
}
]
}
}
9.11.3. Response Body
104
Attribute
Format
Description
NewegAPIResponse
IsSuccess
Boolean
Used to identify the operation is successful. Always returns
true.
OperationType
String
Fixed value: SubmitItemWarrantyResponse.
SellerID
String
Your seller ID.
ResponseBody
ItemWarrantyList
ItemWarranty
IsSuccess
Boolean
Used to identify the warranty is processed successful.
ErrorList
Error
ErrorCode
String
Error Code.
ErrorMessage
String
The description of the error code.
ResponseDate
String
The response time.
ResponseMessage
String
If all warranty settings processed successfully, return fixed
value:
"You have successfully submitted third-party warranty
settings. It may take up to 10 minutes for your settings to
propagate to all systems."
Example: XML, Response
<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<OperationType>SubmitItemWarrantyResponse</OperationType>
<SellerID>BG9H</SellerID>
<ResponseBody>
<ItemWarrantyList>
<ItemWarranty>
<IsSuccess>true</IsSuccess>
</ItemWarranty>
<ItemWarranty>
<IsSuccess>false</IsSuccess>
<ErrorList>
<Error>
<ErrorCode>CT507</ErrorCode>
<ErrorMessage>'Provider Support URL' is not in the correct
format.</ErrorMessage>
</Error>
</ErrorList>
</ItemWarranty>
</ItemWarrantyList>
105
</ResponseBody>
<ResponseDate>04/28/2016 02:48:29</ResponseDate>
</NeweggAPIResponse>
Example: Json, Response
{
"ResponseDate": "05/03/2016 15:48:09",
"IsSuccess": true,
"OperationType": "SubmitItemWarrantyResponse",
"SellerID": "BG8U",
"ResponseBody": {
"ItemWarrantyList": [
{
"IsSuccess": true,
},
{
"IsSuccess": false,
"ErrorList": [
{
"ErrorCode": "CT508",
"ErrorMessage": "SellerPartNumber: bg9h2016042001 does not exist or it is not
refurbished."
}
]
}
]
}
}
9.11.4. Request Failure Errors
For common HTTP error responses, please refer to Common Error Responses
Error Code
Description
CT001
Invalid ItemNumber
CT002
Invalid SellerPartNumber
CT003
Invalid UPCCode
CT005
Invalid Action Type. We only support: 0 - NE Item#, 1 - Seller Parts#, 2 - UPC Code
CT004
Item under review, you cannot activate.
106
CT006
Invalid MSRP. The range should be between 0-99999.99
CT007
Invalid Selling Price. The range should be between 0-99999.99
CT008
Invalid Shipping type. We only support: 0 - default, 1 - free shipping
CT009
Cannot activate item by restricted manufacturer - {0}[({1}){2}].
CT010
Cannot find item with specified item condition.
CT014
SellerItemNumber or SellerPartNumber does not exist
CT015
Can't find this item in the system, please create it first
CT016
The item: [SellerPart#] is locked for an on-going/upcoming promotion. CANNOT update the Shipping. Please
note: the inventory or minimum purchase quantity update will NOT be affected.
CT019
The item: [SellerPart#] is locked for an on-going/upcoming promotion. CANNOT update the Selling Price. Please
note: the inventory or minimum purchase quantity update will NOT be affected.
CT028
Invalid Active Mark. We only support: 0 - deactivate item, 1 - activate item
CT029
The selling price {selling price} cannot be greater than MSRP {MSRP}.
CT030
MAP price should be decimal with 2 digitals. The range should be between 0-99999.99.
CT031
Invalid CheckoutMAP value. We only support: 0 - False, 1 True.
CT032
The selling price cannot be 0.
CT043
Item with no image cannot be activated. Please update your item with valid image then try again.
CT044
The item cannot be deactivated because of an on-going/upcoming promotion that is locked by Newegg. Please
note: the inventory or minimum purchase quantity update will NOT be affected.
CT045
Item was automatically deactivated due to 7 days out of stock and cannot be reactivated with 0 inventory.
CT050
Item Activation Failed. Strict MAP enforced: ${0} Selling Price must be greater than or equal to strict MAP. Please
contact your account manager for more information.
CT052
This item cannot be activate because of the subcategory had been disabled for your account.
CT053
This item now matches a restricted item and cannot be activated. All other updates will be processed.
CT055
This is a duplicated request for Seller Part #: [seller part #]. This item does not exist in Newegg so we are not able
to process your request. We will resume the process of price and inventory update for this item 8 hours after [last
failed timestamp].
CT065
Invalid Selling Price. The Selling Price should be greater than the existing 1st tier volume discount unit price: [{0}]
CT067
The item: [SellerPart#] is regulated by a Newegg existing MAP (Minimum Advertised Pricing) setting: MAP =
[amount], Checkout MAP = [status]. When MAP amount is great than 0 or Checkout MAP = True, the attempt to
change either MAP or Checkout MAP is restricted. All other requests have been processed.
CT071
The Inventory update for item: [SellerPart#] cannot be processed because of the warehouse: [warehouselocation]
has not been created.
CT075
Price update failed. Invalid currency code. The currency code received: [code] does not match the specified country:
[code].
CT076
Item cannot be activated for specified country: [code]. Please activate the country, then submit your request again.
CT501
'Seller Part Number' is required.
107
CT502
'Service Provider' is required.
CT504
'Parts Day' and 'Labor Day' should not be equal to 0 at the same time.
CT505
'Provider Support Email' is required.
CT506
'Provider Support Email' is not in the correct format.
CT507
'Provider Support URL' is not in the correct format.
CT508
SellerPartNumber: xxx does not exist.
CT509
"Warranty does not exist in CountryCode: xxx, SellerPartNumber: xxx." Or "Warranty does not exist in CountryCode:
xxx, SellerPartNumber: xxx, ItemManufacturerWarrantyID: xxx."
CT511
'Provider Customer Service Phone' is not in the correct format.
CT512
SellerPartNumber: xxx is not refurbished or used item.
CT513
'Provider Customer Service Phone' is required.
CT514
Warranty exists in CountryCode: xxx, SellerPartNumber: xxx.
Example: XML, Response
<?xml version="1.0" encoding="utf-8"?>
<Errors>
<Error>
<Code>CE003</Code>
<Message> The 'Type' element is invalid - The value 'a' is invalid according to its
datatype 'Int' - The string 'a' is not a valid Int32 value.</Message>
</Error>
</Errors>
Example: Json, Response
{
"Code": "CT002",
"Message": "Invalid SellerPartNumber"
}
108
10. Order Management
The Order Management service group contains functions that will allow you to perform order related operations such as
get order info, status, update order status, remove items, confirm orders… etc.
10.1. Get Order Status
Get the order status by specified the order number of existing order.
10.1.1. Resource URL & Information
Resource URL
https://api.newegg.com/marketplace/ordermgmt/orderstatus/orders/{ordernumber}?sellerid={sellerid}&version={versionno}
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
{ordernumber}
Yes
The order number
version
No
Available version numbers:304
Resource Information
HTTP Method
Authentication?
Request Formats
Response Formats
Rate Limited?
GET
Required
XML, Json
XML, Json
1000 per min per client
10.1.2. Request Body
Example: XML, Rquest
GET
https://api.newegg.com/marketplace/ordermgmt/orderstatus/orders/{ordernumber}?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
109
Example: Json, Request
GET
https://api.newegg.com/marketplace/ordermgmt/orderstatus/orders/{ordernumber}?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
10.1.3. Response Body
Attribute
Format
Description
Available Ver.#
QueryOrderStatusInfo
OrderNumber
String
The order number that qualified for your search
All
OrderStatusCode
Integer
The available values of the order status
0: Unshipped
1: PartiallyShipped
2: Shipped
3: Invoiced
4: Void
All
OrderStatusName
String
The description of the status
Unshipped for status code: 0
PartiallyShipped for status code: 1
Shipped for status code: 2
Invoiced for status code: 3
Void for status code: 4
All
SellerID
String
Your seller ID
All
OrderDownloaded
String
False: Order has not been downloaded yet.
True: Order downloaded already.
When order is shipped, this field will automatically
become “True”.
All
SalesChannel
Integer
Order sales channel:
0: Newegg order
1: Multi-channel order
2: Replacement order
304
FulfillmentOption
Integer
Order fulfillment option:
0: Ship by Seller
1: Ship by Newegg
304
110
Example: XML, Response
XSD
API Schema > OrderMgmt > GetOrderStatus > GetOrderStatusResponse.xsd
<?xml version="1.0" encoding="utf-8"?>
<QueryOrderStatusInfo>
<OrderNumber>159243598</OrderNumber>
<SellerID>A006</SellerID>
<OrderStatusCode>1</OrderStatusCode>
<OrderStatusName>PartiallyShipped</OrderStatusName>
<OrderDownloaded>true</OrderDownloaded>
<SalesChannel>0</SalesChannel>
<FulfillmentOption>0</FulfillmentOption>
</QueryOrderStatusInfo>
Example: Json, Response
{
"OrderDownloaded": true,
"OrderNumber": "159243598",
"OrderStatusCode": 1,
"OrderStatusName": "PartiallyShipped",
"SellerID": "A006",
SalesChannel:0,
FulfillmentOption:0
}
10.1.4. Request Failure Errors
For common HTTP error responses, please refer to Common Error Responses
Error Code
Description
SO002
Order Number should be an integer (ranging from 1 to 2147483647)
SO003
No data found or this order does not belong to this seller
111
Example: XML, Response
<?xml version="1.0" encoding="utf-8"?>
<Errors>
<Error>
<Code>SO002</Code>
<Message>Order Number should be an integer (ranging from 1 to 2147483647)</Message>
</Error>
</Errors>
Example: Json, Response
{
"Code": "SO002",
"Message": "Order Number should be an integer (ranging from 1 to 2147483647)"
}
10.2. Update Order Status
Update order status by specific order number. Currently support cancel or ship a single order.
10.2.1. Resource URL & Information
Resource URL
https://api.newegg.com/marketplace/ordermgmt/orderstatus/orders/{ordernumber}?sellerid={sellerid}&version={versionno}
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
{ordernumber}
Yes
The order number for the operation
version
Yes
Available version numbers:304
Resource Information
HTTP Method
Authentication?
Request Formats
Response Formats
Rate Limited?
PUT
Required
XML, Json
XML, Json
1000 per min per client
112
10.2.2. Request Body
Cancel Order
Attribute
Required?
Format
Description
UpdateOrderStatus
Action
Yes
Integer
1: Cancel Order
Note: SBN order might not be cancelled if the order is
been processing by Newegg Warehouse. Please use
Get SBN Order Cancellation Request Result, section
10.6 to check the status.
Value
Yes
Integer
The cancel reason code:
24: OutOfStock
72: Customer Requested to Cancel
73: PriceError
74: Unable to Fulfill Order
Example: XML, Request (Cancel Order Request Example)
XSD
API Schema > OrderMgmt > UpdateOrder > CancelRequest.xsd
PUT
https://api.newegg.com/marketplace/ordermgmt/orderstatus/orders/{ordernumber}?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept:application/xml
<UpdateOrderStatus>
<Action>1</Action>
<Value>24</Value>
</UpdateOrderStatus>
Example: Json, Request
PUT
https://api.newegg.com/marketplace/ordermgmt/orderstatus/orders/{ordernumber}?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
113
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"Action": "1",
"Value": "24"
}
Ship Order
Ship Order function allows you to update shipment of one or all items in an order. When an order has been completely
fulfilled, mean that all the items are fulfilled, the order process is completed.
Please review the following example and the possible shipment options you can assign for each request:
Order XYZ has item A (5 units) and item B (1 unit)
Single package contains 5 units of item A and 1 unit of item B with one tracking number.
Single package contains either 5 units of item A or 1 unit of item B with one tracking number.
Multiple packages: one package contains 5 units of item A with one tracking number. The other package contains
1 unit of item B with another tracking number.
Multiple packages: one package contains 2 units of item A with one tracking number. Another package contains 3
units of item A with another tracking number. The other package contains 1 unit of item B with another tracking
number.
Multiple packages: one package contains 2 units of item A with one tracking number. The other package contains
3 units of item A and one unit of item B with another tracking number.
You cannot submit a request for partial shipment as following: Single package contains 2 units of item A with
one tracking number.
Attribute
Required?
Format
Description
UpdateOrderStatus
Action
Yes
Integer
2: Ship Order
Value
Shipment
Header
SellerID
Yes
String
Your Seller ID
SONumber
Yes
Integer
Sales order number
Pack
ageL
ist
Pack
age
TrackingNumber
Yes
String
Tracking number for the shipped
package.
114
ShipCarrier
Yes
String
Shipping carrier type, choose from:
UPS
UPS MI
FedEX
DHL
USPS
NOTE: Please specify the ship carrier
name other than above. Please refer
to the following XML formatted
example.
ShipService
Yes
String
Shipping service type, such as air,
ground, etc. Please reference your
shipping carrier directly
ItemList
Item
SellerPartNumber
Yes
String
The Seller Part # of the item(s)
NeweggItemNumber
No
String
Newegg Item Number of the item
ShippedQty
Yes
Integer
Shipped quantity of items. Must be
larger than 0
Example: XML, Request
XSD
API Schema > OrderMgmt > UpdateOrder > ShipmentRequest.xsd
PLEASE NOTE <VALUE> MUST BE ENCLOSED BY <![CDATA[]]>, See Example for Detail.
PUT
https://api.newegg.com/marketplace/ordermgmt/orderstatus/orders/{ordernumber}?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<UpdateOrderStatus>
<Action>2</Action>
<Value>
<![CDATA[
<Shipment>
<Header>
<SellerID>A006</SellerID>
<SONumber>159243598</SONumber>
</Header>
115
<PackageList>
<Package>
<TrackingNumber>lztestA0060001</TrackingNumber>
<ShipCarrier>Other Carrier</ShipCarrier>
<ShipService>Other Service</ShipService>
<ItemList>
<Item>
<SellerPartNumber>A006ZX-35833</SellerPartNumber>
<ShippedQty>1</ShippedQty>
</Item>
</ItemList>
</Package>
</PackageList>
</Shipment>
]]>
</Value>
</UpdateOrderStatus>
Example: Json, Request
PUT
https://api.newegg.com/marketplace/ordermgmt/orderstatus/orders/{ordernumber}?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/Json
Accept: application/Json
{
"Action": "2",
"Value": {
"Shipment": {
"Header": {
"SellerID": "A006",
"SONumber": "159243598"
},
"PackageList": {
"Package": [
{
"TrackingNumber": "alistestonly1",
"ShipCarrier": "Purolator",
"ShipService": "3-5",
116
"ItemList": {
"Item": {
"SellerPartNumber": "A3WG11002378965412586",
"ShippedQty": "1"}
}
},
{
"TrackingNumber": "alistestonly2",
"ShipCarrier": "Purolator",
"ShipService": "3-5",
"ItemList": {
"Item": [{
"SellerPartNumber": "A3WG11002378965412583",
"ShippedQty": "1"},
{
"SellerPartNumber": "A3WG11002378965412584",
"ShippedQty": "1"}]
}
}]
}
}
}
}
10.2.3. Response Body
Cancel Order
Attribute
Format
Description
UpdateOrderStatu
sInfo
IsSuccess
String
Used to identify the operation of order update is successful
Returns true or false.
Result
OrderNumber
Integer
The order number
SellerID
String
Your Seller ID
117
OrderStatus
String
The order status. The following values are available:
Void Void successfully.
Processing Cancellation request has been received and under
processing. This status is ONLY available for the cancellation
request of SBN orders. The final processing result can be
checked using 10.6 Check SBN Order Cancellation Result.
Example: XML, Response
XSD
API Schema > OrderMgmt > UpdateOrder > CancelOrderResponse.xsd
<?xml version="1.0" encoding="utf-8"?>
<UpdateOrderStatusInfo>
<IsSuccess>true</IsSuccess>
<Result>
<OrderNumber>159243598</OrderNumber>
<SellerID>A006</SellerID>
<OrderStatus>Void</OrderStatus>
</Result>
</UpdateOrderStatusInfo>
Example: Json, Response
{
"IsSuccess": "true",
"Result": {
"OrderNumber": "159243598",
"SellerID": "A006",
"OrderStatus": "Void"
}
}
Ship Order
Attribute
Format
Description
UpdateOr
derStatusI
nfo
IsSuccess
String
Used to identify the operation of order update
is successful. Always returns true.
Pa
ck
ag
eP
ro
ce
ssi
ng
Su
m
m
ar
y
TotalPackageCount
Integer
package(s) count
118
SuccessCount
Integer
package(s) processed successfully
FailCount
Integer
package(s) failed to process
Result
OrderNumber
Integer
The order number for the operation
SellerID
String
Your Seller ID
OrderStatus
String
The new order status:
Shipped
PartiallyShipped
Shipment
PackageList
Package
TrackingNumber
String
Tracking number for the shipped package
ShipDate
String
Ship date(Pacific Standard Time)
ProcessStatus
String
True or False. True stands for package have
been successfully processed. False stands for
package that failed to process.
ProcessResult
String
Success or fail. If fail, detailed error description
displayed here.
ItemList
ItemDes
SellerPartNumber
String
The Seller Part # of the item(s)
NeweggItemNumber
String
Newegg Item Number of the item
ShippedQty
Integer
Shipped quantity of items.
Example: XML, Response
XSD
API Schema > OrderMgmt > UpdateOrder > ShipmentResponse.xsd
<?xml version="1.0" encoding="utf-8"?>
<UpdateOrderStatusInfo>
<IsSuccess>true</IsSuccess>
<PackageProcessingSummary>
<TotalPackageCount>1</TotalPackageCount>
<SuccessCount>1</SuccessCount>
<FailCount>0</FailCount>
</PackageProcessingSummary>
<Result>
<OrderNumber>159243598</OrderNumber>
<SellerID>A006</SellerID>
<OrderStatus>Shipped</OrderStatus>
119
<Shipment>
<PackageList>
<Package>
<TrackingNumber>lztestA0060001</TrackingNumber>
<ShipDate>2012-02-10T15:30:01</ShipDate>
<ProcessStatus>true</ProcessStatus>
<ProcessResult>Success</ProcessResult>
<ItemList>
<ItemDes>
<NeweggItemNumber>9SIA0060845543</NeweggItemNumber>
<SellerPartNumber>A006ZX-35833</SellerPartNumber>
<ShippedQty>1</ShippedQty>
</ItemDes>
</ItemList>
</Package>
</PackageList>
</Shipment>
</Result>
</UpdateOrderStatusInfo>
Example: Json, Response
{
"IsSuccess": true,
"PackageProcessingSummary": {
"FailCount": 0,
"SuccessCount": 1,
"TotalPackageCount": 1
},
"Result": {
"OrderNumber": "159243598",
"OrderStatus": "Shipped",
"SellerID": "A006",
"Shipment": {
"PackageList": [{
"ItemList": [{
"NeweggItemNumber": "9SIA0060845543",
"SellerPartNumber": "A006ZX-35833",
"ShippedQty": 1
}],
"ProcessResult": "Success",
120
"ProcessStatus": true,
"ShipDate": "2012-02-10T15:30:01",
"TrackingNumber": "lztestA0060001"
}]
}
}
}
10.2.4. Request Failure Errors
For common HTTP error responses, please refer to Common Error Responses
Error Code
Description
SO001
Seller ID cannot be null or empty
SO002
Order Number should be an integer (ranging from 1 to 2147483647)
SO003
No data found or this order does not belong to this seller
SO004
This is a replacement SO with a RMA number. It cannot be voided
SO005
Cannot remove item because this is a Shipped by Newegg order. order is Shipped by Newegg
SO006
Only unshipped orders can be voided. The order status is currently {0}
SO007
Cannot get the order status info
SO008
This order has already been voided
SO009
Order number cannot be null or empty
SO010
Invalid order. No item exists
SO011
Only unshipped orders can be shipped. The order status is currently {0}
SO012
Only shipped by seller orders can be supported currently
SO014
The action should be [ Canceled = 1 | Shipped = 2]
SO015
The Argument '{0}' cannot be null
SO016
This order has not been downloaded onto seller portal yet. Please re-submit your request after two hours.
SO017
Reason code should be [24 -- OutOfStock,72 -- Customer Requested to Cancel,73 -- PriceError,74 -- Unable to
Fulfill the Order]
SO020
There is a package or packages without shipping information in this shipment.
SO025
Some items in the shipment have already been shipped.
SO027
This order has already been shipped.
SO030
There is a format error in shipment segment of this XML request.
SO036
The order’s shipping method is null. Please contact System Admin.
SO037
The action should be [1 - Cancelled, 2 - Shipped]
SO040
The Order number or Seller ID provided is not the same as in the URL.
SO056
Your request cannot be processed. Order: [order #] is a Newegg Premier order and can only be shipped using
Newegg Shipping Label Service.
121
Example: XML, Response
<?xml version=1.0 encoding=utf-8?>
<Errors>
<Error>
<Code>SO002</Code>
<Message>Order Number should be an integer (ranging from 1 to 2147483647)</Message>
</Error>
</Errors>
Example: Json, Response
{
Code: SO002,
Message: Order Number should be an integer (ranging from 1 to 2147483647)
}
10.3. Order Confirmation
Notify Newegg to mark the orders you have downloaded. You will be able to exclude these downloaded orders in the Get
Order Info API’s through OrderDownloaded filter.
10.3.1. Resource URL & Information
Resource URL
https://api.newegg.com/marketplace/ordermgmt/orderstatus/orders/confirmation?sellerid={sellerid}
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
Resource Information
HTTP Method
Authentication?
Request Formats
Response Formats
Rate Limited?
POST
Required
XML, Json
XML, Json
1000 per min per client
122
10.3.2. Request Body
Attribute
Required?
Format
Description
NeweggAPIRequest
IssueUser
No
String
Specify your eligible seller account (email address)
here.
OperationType
Yes
String
Fixed value: OrderConfirmationRequest
RequestBody
DownloadedOrderList
OrderNumber
Yes
Integer
The order(s) you want to mark as downloaded
already.
Example: XML, Request
XSD
API Schema > OrderMgmt > OrderConfirm > OrderConfirmRequest.xsd
POST
https://api.newegg.com/marketplace/ordermgmt/orderstatus/orders/confirmation?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggAPIRequest >
<OperationType>OrderConfirmationRequest</OperationType>
<RequestBody>
<DownloadedOrderList>
<OrderNumber>159243598</OrderNumber>
</DownloadedOrderList>
</RequestBody>
</NeweggAPIRequest>
Example: Json, Request
123
POST
https://api.newegg.com/marketplace/ordermgmt/orderstatus/orders/confirmation?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Accept: application/json
Content-Type: application/json
{
OperationType: OrderConfirmationRequest,
RequestBody: {
DownloadedOrderList: {
OrderNumber: [
159243598
]
}
}
}
10.3.3. Response Body
Attribute
Format
Description
NeweggAPIResponse
IsSuccess
String
Used to identify the operation of order confirmation is successful
Response: true or false
OperationType
String
Fixed value: OrderConfirmationResponse
SellerID
String
Your Seller ID
ResponseDate
String
The date time of response (Pacific Standard Time)
ResponseBody
RequestDate
String
The date time of request (Pacific Standard Time)
DownloadedOrderList
OrderNumber
Integer
The order(s) you want to mark as downloaded already.
Memo
String
Additional Information. Currently will return null.
124
Example: XML, Response
XSD
API Schema > OrderMgmt > OrderConfirm > OrderConfirmResponse.xsd
<?xml version=1.0 encoding=utf-8?>
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<OperationType>OrderConfirmationResponse</OperationType>
<SellerID>A006</SellerID>
<ResponseDate>2/22/2012 16:37:20</ResponseDate>
<ResponseBody>
<RequestDate>2/22/2012 16:37:20</RequestDate>
<DownloadedOrderList>
<OrderNumber>159243598</OrderNumber>
</DownloadedOrderList>
</ResponseBody>
</NeweggAPIResponse>
Example: Json, Response
{
NeweggAPIResponse: {
IsSuccess: true,
OperationType: OrderConfirmationResponse,
SellerID: A006,
ResponseDate: 2/22/2012 16:38:53,
ResponseBody: {
RequestDate: 2/22/2012 16:38:53,
DownloadedOrderList: {
OrderNumber: 159243598
}
}
}
}
125
10.3.4. Request Failure Errors
For common HTTP error responses, please refer to Common Error Responses
Example: XML, Response
<?xml version=1.0 encoding=utf-8?>
<Errors>
<Error>
<Code>CE001</Code>
<Message>SellerID cannot be null or empty</Message>
</Error>
</Errors>
Example: Json, Response
{
Code: CE001,
Message: SellerID cannot be null or empty
}
10.4. Remove Item(s)
Remove item(s) from specified order. If all items removed from an order, order status becomes void. Please note:but only supports
order(s) that is fulfilled by seller.
10.4.1. Resource URL & Information
Resource URL
https://api.newegg.com/marketplace/ordermgmt/killitem/orders/{ordernumber}?sellerid={sellerid}
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
{ordernumber}
Yes
The order number for the operation
126
Resource Information
HTTP Method
Authentication?
Request Formats
Response Formats
Rate Limited?
PUT
Required
XML, Json
XML, Json
1000 per min per client
10.4.2. Request Body
Attribute
Required?
Format
Description
NeweggAPIRequest
IssueUser
No
String
Specify your eligible seller account (email
address) here.
OperationType
Yes
String
Fixed value: KillItemRequest
RequestBody
KillItem
Order
ItemLis
Item
SellerPartNumber
Yes
String
The Seller Part # of the item(s).Note: Items
cannot be removed with SBN orders
Memo
No
String
Example: XML, Request
XSD
API Schema > OrderMgmt > RemoveItem > RemoveItemRequest.xsd
PUT
https://api.newegg.com/marketplace/ordermgmt/killitem/orders/{ordernumber}?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggAPIRequest>
<OperationType>KillItemRequest</OperationType>
<RequestBody>
<KillItem>
<Order>
<ItemList>
<Item>
<SellerPartNumber>AWHZ3434</SellerPartNumber>
</Item>
<Item>
127
<SellerPartNumber>AWHZ3435</SellerPartNumber>
</Item>
</ItemList>
</Order>
</KillItem>
</RequestBody>
</NeweggAPIRequest>
Example: Json, Request
PUT
https://api.newegg.com/marketplace/ordermgmt/killitem/orders/{ordernumber}?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
OperationType: KillItemRequest,
RequestBody: {
KillItem: {
Order: {
ItemList: {
Item: [
{ SellerPartNumber: AWHZ3434 },
{ SellerPartNumber: AWHZ3435 }
]
}
}
}
}
}
128
10.4.3. Response Body
Attribute
Format
Description
NeweggAPIResponse
IsSuccess
String
Used to identify the operation of removing item(s)
from order is successful. Returns true or false
OperationType
String
Fixed value: KillItemResponse
SellerID
String
Your seller ID
ResponseDate
String
The DateTime of a request(Pacific Standard Time)
ResponseByody
Orders
OrderNumber
Integer
The order number
Result
ItemList
Item
SellerPartNumber
String
The Seller Part # of the item(s).
RequestDate
String
The DateTime of a request(Pacific Standard Time)
Memo
String
When operation false, this field will contain
detailed error description.
Example: XML, Response
XSD
API Schema > OrderMgmt > RemoveItem > RemoveItemResponse.xsd
<?xml version=1.0 encoding=utf-8?>
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<OperationType>KillItemResponse</OperationType>
<SellerID>A006</SellerID>
<Memo />
<ResponseBody>
<RequestDate>2012-02-22 16:42:10</RequestDate>
<Orders>
<OrderNumber>88237462</OrderNumber>
<Result>
<ItemList>
<Item>
<SellerPartNumber>AWHZ3434</SellerPartNumber>
</Item>
</ItemList>
129
</Result>
</Orders>
</ResponseBody>
<ResponseDate>2012-02-22 16:42:10</ResponseDate>
</NeweggAPIResponse>
Example: Json, Response
{
IsSuccess: true,
Memo: null,
OperationType: KillItemResponse,
SellerID: A006,
ResponseBody: {
Orders: {
OrderNumber: 88237462,
Result: {
ItemList: [{
SellerPartNumber: AWHZ3434
}]
}
},
RequestDate: 2012-02-22 16:42:10
},
ResponseDate: 2012-02-22 16:42:10
}
10.4.4. Request Failure Errors
For common HTTP error responses, please refer to Common Error Responses
Error Code
Description
SO002
Order number should be integer (ranging from 1 to 2147483647)
SO003
No data found or this order does not belong to this seller
SO005
Cannot remove item because the order is Ship By Newegg.
SO006
Only unshipped orders can be voided. The order status is currently {0}.
SO008
This order has already been voided.
SO009
Order number CANNOT be null
SO041
CANNOT find SONumber: {0}
130
SO042
Application exception occurred during calling EC Interface. SONumber: {0}, ItemNumber: {1}. Please Contact
Newegg Marketplace.
SO043
Business exception occurred during calling EC Interface(3 invoice,4 void,1 shipped). SONumber: {0}, ItemNumber:
{1}. Please Contact Newegg Marketplace.
SO045
Failed to get customer information! The customer number is {0}.
SO046
CANNOT find item in Newegg_SOTransaction, SONumber: {0}, ItemNumber: {1}
SO047
CANNOT get item detail information (sub category), ItemNumber: {0}
SO049
The '{0}' is required.
SO050
The SellerPartNumber '{0}' is invalid.
SO051
This '{0}' has already been canceled in Newegg System
SO052
CANNOT find out item by ordernumber ='{0}' and sellerid='{1}'.
SO053
Cannot get the ordernumber='{0}' status.
SO054
The ordernumber= '{0}' is Replacement SO. CANNOT be voided.
SO055
The seller part# = ‘{0}’ is repeated.
Example: XML, Response
<?xml version="1.0" encoding="utf-8"?>
<Errors>
<Error>
<Code>SO008</Code>
<Message>This order has already been voided</Message>
</Error>
</Errors>
Example: Json, Response
{
"Code": "SO008",
"Message": " This order has already been voided"
}
10.5. Get Order Info
Retrieve order info by specified order number.
10.5.1. Resource URL & Information
131
Resource URL
https://api.newegg.com/marketplace/ordermgmt/order/orderinfo?sellerid={sellerid}&version={versionno}
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
version
Yes
Available version numbers:
304
305
306
307
Resource Information
HTTP Method
Authentication?
Request Formats
Response Formats
Rate Limited?
PUT
Required
XML, Json
XML, Json
1000 per min per client
10.5.2. Request Body
Attribute
Req
uire
d?
For
mat
Description
Available
Ver.#
NeweggAPIRequest
IssueUser
No
Strin
g
Specify your eligible seller account (email address) here.
All
OperationType
Yes
Strin
g
Fixed value: GetOrderInfoRequest
All
RequestBody
PageIndex
No
Inte
ger
Current page index
If left blank, will use 1 as default.
All
PageSize
No
Inte
ger
Return records count in one page.
(Max is 100 per page)
If left blank, will use 100 as default.
All
RequestCriteria
OrderNumberList
OrderNu
mber
No
Inte
ger
The order number
Ignore other search conditions (request criteria) if order number specified this field.
All
132
SellerOrderNumber
List
SellerOr
derNum
ber
No
Stri
ng
The seller order number.
This is available for sellers using SBN (Shipped by Newegg) to fulfill multi-
channel orders.
If not specify Newegg order number in field “OrderNumber, ignore other
search conditions (request criteria) and only apply the query result on seller
order numbers specified in this field.
307
Status
No
Inte
ger
0: Unshipped
1: Partially Shipped
2: Shipped
3: Invoiced
4: Voided
If left blank, will return orders in all order status
All
OrderDownl
oaded
No
Inte
ger
0: False(Default): include downloaded orders
1: True: do not include downloaded orders
All
Type
No
Inte
ger
0: All (Default)
1: SBN (Shipped by Newegg)
2: SBS (Shipped by Seller)
3: Multi-Channel
All
VoidSoon
No
Inte
ger
The order will be auto voided after 24 or 48 hours.
Available values:
24
48
All
OrderDateFr
om
No
Strin
g
Order Date From (Pacific Standard Time)
Please refer to the Acceptable Date Format
All
OrderDateTo
No
Strin
g
Order Date To (Pacific Standard Time)
Please refer to the Acceptable Date Format
All
CountryCode
No
Strin
g
The country for your orders. Only the ISO standard 3-digit codes are accepted.
To review the complete list of available values, please download the following:
https://promotions.newegg.com/Marketplace/Sellers/resourceLibrary/Intern
ational%20Country%20Guide.pdf
All
PremierOrde
r
No
Inte
ger
0: All (Default)
1: Premier Order Only
2: No Premier Order
All
Example: XML, Request
XSD
API Schema > OrderMgmt > GetOrderInfo > GetOrderInfoRequest.xsd
133
PUT https://api.newegg.com/marketplace/ordermgmt/order/orderinfo?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggAPIRequest>
<OperationType>GetOrderInfoRequest</OperationType>
<RequestBody>
<PageIndex>1</PageIndex>
<PageSize>10</PageSize>
<RequestCriteria>
<OrderNumberList>
<OrderNumber>159243598</OrderNumber>
<OrderNumber>41473642</OrderNumber>
</OrderNumberList>
<SellerOrderNumberList>
<SellerOrderNumber>SO159243598</SellerOrderNumber>
<SellerOrderNumber>SO41473642</SellerOrderNumber>
</SellerOrderNumberList>
<Status>1</Status>
<Type>1</Type>
<OrderDateFrom>2011-01-01 09:30:47</OrderDateFrom>
<OrderDateTo>2011-12-17 09:30:47</OrderDateTo>
<OrderDownloaded>0</OrderDownloaded>
<CountryCode>USA</CountryCode>
<PremierOrder>1</PremierOrder>
</RequestCriteria>
</RequestBody>
</NeweggAPIRequest>
Example: Json, Response
PUT https://api.newegg.com/marketplace/ordermgmt/order/orderinfo?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"OperationType": "GetOrderInfoRequest",
134
"RequestBody": {
"PageIndex": "1",
"PageSize": "10",
"RequestCriteria": {
"OrderNumberList": {
"OrderNumber": [
"159243598",
"41473642"
]
},
"SellerOrderNumberList": {
"SellerOrderNumber": [
"SO159243598",
"SO41473642"
]
},
"Status": "1",
"Type": "1",
"OrderDateFrom": "2011-01-01 09:30:47",
"OrderDateTo": "2011-12-17 09:30:47",
"OrderDownloaded": 0,
"CountryCode":"USA",
"PremierOrder":"1"
}
}
}
10.5.3. Response Body
Attribute
Format
Description
Availa
ble
Ver.#
NeweggAPIResp
onse
IsSuccess
String
Used to identify the operation of Get Order Info is
successful
True or False
All
SellerID
String
Your seller ID
All
OperationType
String
Fixed value: GetOrderInfoResponse
All
135
ResponseByody
PageInfo
TotalCount
Integer
Total number of records
All
TotalPageCount
Integer
Total page count
All
PageSize
Integer
How many records in a page.
All
PageIndex
Integer
Current page index
All
OrderInfoList
OrderInfo
SellerID
String
Seller ID
All
OrderNumber
Integer
Newegg Order number
All
SellerOrderNumber
String
Order number, assigned by seller.
This is available for sellers using SBN (Shipped by
Newegg) to fulfill multi-channel orders.
307
InvoiceNumber
Integer
The Invoice Number
All
OrderDownloaded
String
False: Order has not been downloaded yet.
True: Order downloaded already.
When order is shipped, this field will automatically
become “True”.
All
OrderDate
String
Create date
All
OrderStatus
Integer
The Order Status:
0: Unshipped
1: Partially Shipped
2: Shipped
3: Invoiced
4: Voided
All
OrderStatusDescription
String
The Order Status Description
(Unshipped|PartiallyShipped|Shipped|Invoiced|Voi
d)
Unshipped for order status code: 0
Partially Shipped for order status code: 1
Shipped for order status code: 2
Invoiced for order status code: 3
Voided for order status code: 4
All
CustomerName
String
The order’s customer name.
All
CustomerPhoneNumber
String
The order’s shipping phone number
All
CustomerEmailAddress
String
The masked customer email address, you can reach
to the customer through this email address.
For example:
gdv6l0viwo4l7j1d@marketplace.newegg.com
All
ShipToAddress1
String
The order will be shipped to address
All
ShipToAddress2
String
The order will be shipped to address line 2
All
ShipToCityName
String
The order will be shipped to city name
All
ShipToStateCode
String
The order will be shipped to state
All
136
ShipToZipCode
String
The order will be shipped to zip code
All
ShipToCountryCode
String
The country for your orders. i.e. United Kingdom
All
ShipService
String
The order’s shipping service:
Shipped By Newegg
APO/FPO Military ONLY
Super Saver(7-14 business days)
Standard Shipping (5-7 business days)
Expedited Shipping (3-5 business days)
Two-Day Shipping(2 business days)
One-Day Shipping(Next day)
International Expedited Shipping(3-5 business days)
International Two-Day Shipping(2 business days)
International Economy Shipping(8-15 business days)
International Standard Shipping(5-7 business days)
Newegg Premier 3 Days
Newegg Premier 2 Days
Newegg Premier Next Day
Please note that the following shipping services are
for indicating Newegg Premier orders, you should
ship the order as soon as the service required.
Please contact Datafeeds@Newegg.com for more
detail regarding Premier Seller Enrollment Program.
Newegg Premier 3 Days
Newegg Premier 2 Days
Newegg Premier Next Day
All
ShipToFirstName
String
The ship to First Name
All
ShipToLastName
String
The ship to Last Name
All
ShipToCompany
String
The order’s ship to company
All
OrderItemAmount
Decimal
The order’s item(s) total amount
NOTE: All amounts are set in U.S. Dollars (USD).
All
ShippingAmount
Decimal
The order’s shipping Amount
NOTE: All amounts are set in U.S. Dollars (USD).
All
DiscountAmount
Decimal
The order’s total discount amount
NOTE: All amounts are set in U.S. Dollars (USD).
All
OrderQty
Integer
Order’s total item quantity.
All
137
RefundAmount
Decimal
The order’s refund amount.
NOTE: All amounts are set in U.S. Dollars (USD).
All
SalesTax
Decimal
The order’s sales tax.
NOTE: All amounts are set in U.S. Dollars (USD).
305,
306
VATTotal
Decimal
International Value Additional Tax Total.
NOTE: All amounts are set in U.S. Dollars (USD).
306
DutyTotal
Decimal
International Duty Total
NOTE: All amounts are set in U.S. Dollars (USD).
306
OrderTotalAmount
Decimal
The order’s total amount
NOTE: All amounts are set in U.S. Dollars (USD).
All
IsAutoVoid
String
If an order was auto voided by Newegg system, then
the value is true. Otherwise, value is false.
All
SalesChannel
Integer
Order sales channel:
0: Newegg order
1: Multi-channel order
2: Replacement order
All
FulfillmentOption
Integer
Order fulfillment option:
0: Ship by seller
1: Ship by Newegg
All
ItemInfoList
ItemInfo
SellerPartNumber
String
The item’s seller part number
All
NeweggItemNumber
String
The item’s newegg item number
All
MfrPartNumber
String
The item’s manufacture part number
All
UPCCode
String
The item’s upc
All
Description
String
The item’s web title description
All
OrderedQty
Integer
Item’s Ordered Quantity.
All
ShippedQty
Integer
Item’s Shipped Quantity.
All
UnitPrice
Decimal
The final price per unit of the item appearing in
customer's shopping cart
NOTE: All amounts are set in U.S. Dollars (USD).
All
ExtendUnitPrice
Decimal
Item's total charge (Item Unit Price x Quantity
Ordered)
NOTE: All amounts are set in U.S. Dollars (USD).
All
ExtendShippingCharg
e
Decimal
Item's total shipping charge (Item Unit Shipping
Price x Quantity Ordered)
NOTE: All amounts are set in U.S. Dollars (USD).
All
138
ExtendSalesTax
Decimal
Item’s total sales tax charge.
NOTE: All amounts are set in U.S. Dollars (USD).
305,
306
ExtendVAT
Decimal
Item’s total Value Additional Tax charge
NOTE: All amounts are set in U.S. Dollars (USD).
306
ExtendDuty
Decimal
Item’s total Duty charge
NOTE: All amounts are set in U.S. Dollars (USD).
306
Status
Integer
1: Unshipped
2: Shipped
3: Cancelled
All
StatusDescription
String
Unshipped for status code: 1
Shipped for status code: 2
Cancelled for status code: 3
All
PackageInfoList
PackageInfo
PackageType
String
The package type. Shipped | Unshipped
All
ShipCarrier
String
The package’s actual ship Carrier
All
ShipService
String
The package’s actual ship Service
All
TrackingNumber
String
The package’s tracking number.
All
ShipDate
String
The package’s ship date. (Pacific Standard Time)
All
ItemInfoList
Item Info
SellerPartN
umber
String
The item’s seller part number
All
MfrPartNu
mber
String
The item’s manufacture part number
All
ShippedQt
y
Integer
Item’s Shipped Quantity.
All
Memo
String
Other information.
All
ResponseDate
String
The response date
All
Example: XML, Response
XSD
API Schema > OrderMgmt > GetOrderInfo > GetOrderInfoResponse.xsd
<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<SellerID>A006</SellerID>
<OperationType>GetOrderInfoResponse</OperationType>
139
<ResponseBody>
<PageInfo>
<TotalCount>2</TotalCount>
<TotalPageCount>1</TotalPageCount>
<PageSize>10</PageSize>
<PageIndex>1</PageIndex>
</PageInfo>
<OrderInfoList>
<OrderInfo>
<SellerID>A006</SellerID>
<OrderNumber>41473642</OrderNumber>
<SellerOrderNumber>2153930</SellerOrderNumber>
<InvoiceNumber>0</InvoiceNumber>
<OrderDownloaded>true</OrderDownloaded>
<OrderDate>1/23/2012 7:33:05</OrderDate>
<OrderStatus>4</OrderStatus>
<OrderStatusDescription>Voided</OrderStatusDescription>
<CustomerName>WY SD</CustomerName>
<CustomerPhoneNumber>123-223-3223</CustomerPhoneNumber>
<CustomerEmailAddress>gdv6l0viwo4l7j1d@marketplace.newegg.com</CustomerEmailAddress>
<ShipToAddress1>149 Kenwood Dr</ShipToAddress1>
<ShipToAddress2 />
<ShipToCityName>Newcastle</ShipToCityName>
<ShipToStateCode>WY</ShipToStateCode>
<ShipToZipCode>82701</ShipToZipCode>
<ShipToCountryCode>UNITED STATES</ShipToCountryCode>
<ShipService>Media Mail (7-14 business days)</ShipService>
<ShipToFirstName>WY</ShipToFirstName>
<ShipToLastName>SD</ShipToLastName>
<ShipToCompany />
<OrderItemAmount>0</OrderItemAmount>
<ShippingAmount>0.00</ShippingAmount>
<DiscountAmount>0.00</DiscountAmount>
<RefundAmount>0</RefundAmount>
<SalesTax />
<VATTotal />
<DutyTotal />
<OrderTotalAmount>0.00</OrderTotalAmount>
<OrderQty>1</OrderQty>
<IsAutoVoid>true</IsAutoVoid>
<SalesChannel>0</SalesChannel>
140
<FulfillmentOption>1</FulfillmentOption>
<ItemInfoList>
<ItemInfo>
<SellerPartNumber>A00655467241</SellerPartNumber>
<NeweggItemNumber>9SIA0060823129</NeweggItemNumber>
<MfrPartNumber>55467241</MfrPartNumber>
<UPCCode />
<Description>test creation test item</Description>
<OrderedQty>1</OrderedQty>
<ShippedQty>0</ShippedQty>
<UnitPrice>1.00</UnitPrice>
<ExtendUnitPrice>1.03</ExtendUnitPrice>
<ExtendShippingCharge>1.03</ExtendShippingCharge>
<ExtendSalesTax />
<ExtendVAT />
<ExtendDuty />
<Status>3</Status>
<StatusDescription>Canceled</StatusDescription>
</ItemInfo>
</ItemInfoList>
<PackageInfoList />
</OrderInfo>
<OrderInfo>
<SellerID>A006</SellerID>
<OrderNumber>159243598</OrderNumber>
<SellerOrderNumber>2153930</SellerOrderNumber>
<InvoiceNumber>82961992</InvoiceNumber>
<OrderDownloaded>true</OrderDownloaded>
<OrderDate>1/18/2012 1:05:18</OrderDate>
<OrderStatus>3</OrderStatus>
<OrderStatusDescription>Invoiced</OrderStatusDescription>
<CustomerName>WY SD</CustomerName>
<CustomerPhoneNumber>123-223-3223</CustomerPhoneNumber>
<CustomerEmailAddress>gdv6l0viwo4l7j1d@marketplace.newegg.com</CustomerEmailAddress>
<ShipToAddress1>149 Kenwood Dr</ShipToAddress1>
<ShipToAddress2 />
<ShipToCityName>Newcastle</ShipToCityName>
<ShipToStateCode>WY</ShipToStateCode>
<ShipToZipCode>82701</ShipToZipCode>
<ShipToCountryCode>UNITED STATES</ShipToCountryCode>
<ShipService>Media Mail (7-14 business days)</ShipService>
141
<ShipToFirstName>WY</ShipToFirstName>
<ShipToLastName>SD</ShipToLastName>
<ShipToCompany />
<OrderItemAmount>2.00</OrderItemAmount>
<ShippingAmount>10.00</ShippingAmount>
<DiscountAmount>1.00</DiscountAmount>
<RefundAmount>0</RefundAmount>
<SalesTax />
<VATTotal />
<DutyTotal />
<OrderTotalAmount>11.00</OrderTotalAmount>
<OrderQty>2</OrderQty>
<IsAutoVoid>false</IsAutoVoid>
<SalesChannel>0</SalesChannel>
<FulfillmentOption>1</FulfillmentOption>
<ItemInfoList>
<ItemInfo>
<SellerPartNumber>A006ZX-35833</SellerPartNumber>
<NeweggItemNumber>9SIA0060845543</NeweggItemNumber>
<MfrPartNumber>ZX-35833</MfrPartNumber>
<UPCCode>431573000287</UPCCode>
<Description>GYRO Huge Metal Goliath 3.5CH Electric RTF RC
Helicopter</Description>
<OrderedQty>2</OrderedQty>
<ShippedQty>2</ShippedQty>
<UnitPrice>1.00</UnitPrice>
<Status>2</Status>
<StatusDescription>Shipped</StatusDescription>
<ExtendUnitPrice>1.03</ExtendUnitPrice>
<ExtendShippingCharge>1.03</ExtendShippingCharge>
<ExtendSalesTax />
<ExtendVAT />
<ExtendDuty /> </ItemInfo>
</ItemInfoList>
<PackageInfoList>
<PackageInfo>
<PackageType>Shipped</PackageType>
<ShipCarrier>UPS</ShipCarrier>
<ShipService>342</ShipService>
<TrackingNumber>2342424</TrackingNumber>
<ShipDate>1/18/2012 16:59:15</ShipDate>
142
<ItemInfoList>
<ItemInfo>
<SellerPartNumber>A006ZX-35833</SellerPartNumber>
<MfrPartNumber>ZX-35833</MfrPartNumber>
<ShippedQty>2</ShippedQty>
</ItemInfo>
</ItemInfoList>
</PackageInfo>
</PackageInfoList>
</OrderInfo>
</OrderInfoList>
</ResponseBody>
<Memo />
<ResponseDate>2/22/2012 16:51:03</ResponseDate>
</NeweggAPIResponse>
Example: Json, Response
{
"IsSuccess": "true",
"SellerID": "A006",
"OperationType": "GetOrderInfoResponse",
"ResponseBody": {
"PageInfo": {
"TotalCount": "2",
"TotalPageCount": "1",
"PageSize": "10",
"PageIndex": "1"
},
"OrderInfoList": {
"OrderInfo": [{
"SellerID": "A006 ",
"OrderNumber": "41473642",
"SellerOrderNumber": "2153930",
"InvoiceNumber": "0",
"OrderDownloaded": "true",
"OrderDate": "1/23/2012 7:33:05",
"OrderStatus": "4",
"OrderStatusDescription": "Voided",
"CustomerName": "WY SD",
"CustomerPhoneNumber": "123-223-3223",
143
"ShipToAddress1": "149 Kenwood Dr",
"ShipToAddress2": null,
"ShipToCityName": "Newcastle",
"ShipToStateCode": "WY",
"ShipToZipCode": "82701",
"ShipToCountryCode": "UNITED STATES",
"ShipService": "Media Mail (7-14 business days)",
"ShipToFirstName": "WY",
"ShipToLastName": "SD",
"ShipToCompany": null,
"OrderItemAmount": "0",
"ShippingAmount": "0.00",
"DiscountAmount": "0.00",
"RefundAmount": "0",
“SalesTax”:”0.00”,
“VATTotal”:”0.00”,
“DutyTotal”:”0.00”,
"OrderTotalAmount": "0.00",
"OrderQty": "1",
"IsAutoVoid": "true",
SalesChannel:0,
FulfillmentOption:1,
"ItemInfoList": {
"ItemInfo": {
"SellerPartNumber": "A00655467241",
"NeweggItemNumber": "9SIA0060823129",
"MfrPartNumber": "55467241",
"UPCCode": null,
"Description": "test creation test item”,
"OrderedQty": "1",
"ShippedQty": "0",
"UnitPrice": "1.00",
"ExtendUnitPrice": "1.03",
"ExtendShippingCharge": "1.03",
“ExtendSalesTax”:”0.00”,
“ExtendVATTotal”:”0.00”,
“ExtendDutyTotal”:”0.00”,
"Status": "3",
"StatusDescription": "Canceled"
}
},
144
"PackageInfoList": null
}, {
"SellerID": "A006 ",
"OrderNumber": "159243598",
"SellerOrderNumber": "2153930",
"InvoiceNumber": "82961992",
"OrderDownloaded": "true",
"OrderDate": "1/18/2012 1:05:18",
"OrderStatus": "3",
"OrderStatusDescription": "Invoiced",
"CustomerName": "WY SD",
"CustomerPhoneNumber": "123-223-3223",
"CustomerEmailAddress”:gdv6l0viwo4l7j1d@marketplace.newegg.com",
"ShipToAddress1": "149 Kenwood Dr",
"ShipToAddress2": null,
"ShipToCityName": "Newcastle",
"ShipToStateCode": "WY",
"ShipToZipCode": "82701",
"ShipToCountryCode": "UNITED STATES",
"ShipService": "Media Mail (7-14 business days)",
"ShipToFirstName": "WY",
"ShipToLastName": "SD",
"ShipToCompany": null,
"OrderItemAmount": "2.00",
"ShippingAmount": "10.00",
"DiscountAmount": "1.00",
"RefundAmount": "0",
“SalesTax”:”0.00”,
“VATTotal”:”0.00”,
“DutyTotal”:”0.00”,
"OrderTotalAmount": "11.00",
"OrderQty": "2",
"IsAutoVoid": "false",
SalesChannel:0,
FulfillmentOption:1,
"ItemInfoList": {
"ItemInfo": {
"SellerPartNumber": "A006ZX-35833",
"NeweggItemNumber": "9SIA0060845543",
"MfrPartNumber": "ZX-35833",
"UPCCode": "431573000287",
145
"Description": "GYRO Huge Metal Goliath 3.5CH Electric RTF RC Helicopter
",
"OrderedQty": "2",
"ShippedQty": "2",
"UnitPrice": "1.00",
"ExtendUnitPrice": "1.03",
"ExtendShippingCharge": "1.03",
“ExtendSalesTax”:”0.00”,
“ExtendVATTotal”:”0.00”,
“ExtendDutyTotal”:”0.00”, "Status": "2",
"StatusDescription": "Shipped"
}
},
"PackageInfoList": {
"PackageInfo": {
"PackageType": "Shipped",
"ShipCarrier": "UPS",
"ShipService": "342",
"TrackingNumber": "2342424",
"ShipDate": "1/18/2012 16:59:15",
"ItemInfoList": {
"ItemInfo": {
"SellerPartNumber": "A006ZX-35833",
"MfrPartNumber": "ZX-35833",
"ShippedQty": "2"
}
}
}
}
}]
}
},
"Memo": null,
"ResponseDate": "2/22/2012 16:53:26"
}
10.5.4. Request Failure Errors
For common HTTP error responses, please refer to Common Error Responses
146
Example: XML, Response
<?xml version="1.0" encoding="utf-8"?>
<Errors>
<Error>
<Code>CE001</Code>
<Message>SellerID cannot be null or empty</Message>
</Error>
</Errors>
Example: Json, Response
{
"Code": "CE001",
"Message": "SellerID cannot be null or empty"
}
10.6. Get SBN (Shipped by Newegg) Order Cancellation Request Result
Get the status of specified SBN (Shipped by Newegg) cancellation request. Resource URL & Information
Resource URL
https://api.newegg.com/marketplace/ordermgmt/sbnorder/cancellationresult/{ordernumber}?sellerid={sellerid}
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
{ordernumber}
Yes
The order number
Resource Information
HTTP Method
Authentication?
Request Formats
Response Formats
Rate Limited?
GET
Required
XML, Json
XML, Json
1000 per min per client
10.6.1. Request Body
Example: XML, Request
147
GET
https://api.newegg.com/marketplace/ordermgmt/sbnorder/cancellationresult/{ordernumber}?sellerid={
sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
Example: Json, Request
GET
https://api.newegg.com/marketplace/ordermgmt/sbnorder/cancellationresult/{ordernumber}?sellerid={
sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
10.6.2. Response Body
Attribute
Format
Description
NeweggAPIResponse
IsSuccess
String
Used to identify the operation of order confirmation is successful
Response: true or false
SellerID
String
Your Seller ID
OperationType
String
Fixed value: GetSBNOrderCancellationResultResponse
ResponseDate
String
The date time of response (Pacific Standard Time)
ResponseBody
RequestDate
String
The date time of request (Pacific Standard Time)
OrderNumber
Integer
The order number.
Result
String
Available values:
Success
Failed
Processing
ErrorMessage
String
The error message if the request was failed.
Example: XML, Response
148
XSD
API Schema > OrderMgmt > GetSBNOrderCancellationResponse > GetSBNOrderCancellationResponse.xsd
<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<OperationType>GetSBNOrderCancellationResultResponse</OperationType>
<SellerID>A006</SellerID>
<ResponseDate>2/22/2012 16:37:20</ResponseDate>
<ResponseBody>
<RequestDate>2/22/2012 15:37:20</RequestDate>
<OrderNumber>159243598</OrderNumber>
<Result>Failed</Result>
<ErrorMessage>Order void was not successful due to technical issues / order already
shipped.</ErrorMessage>
</ResponseBody>
</NeweggAPIResponse>
Example: Json, Response
{
"IsSuccess": "true",
"OperationType": "GetSBNOrderCancellationResultResponse",
"SellerID": "A006",
"ResponseDate": "2/22/2012 16:37:20",
"ResponseBody": {
"RequestDate": "2/22/2012 15:37:20",
"OrderNumber": "159243598",
"Result": "Failed",
"ErrorMessage": "Order void was not successful due to technical issues / order already
shipped."
}
}
10.6.3. Request Failure Errors
For common HTTP error responses, please refer to Common Error Responses
Error Code
Description
149
SO057
The order #: [order#] is not a valid Shipped by Newegg order. Please verify the order # then submit your request
again.
SO058
No void request found for order #:{order#}.
Example: XML, Response
<?xml version="1.0" encoding="utf-8"?>
<Errors>
<Error>
<Code>SO002</Code>
<Message>Order Number should be an integer (ranging from 1 to 2147483647)</Message>
</Error>
</Errors>
Example: Json, Response
{
"Code": "SO002",
"Message": "Order Number should be an integer (ranging from 1 to 2147483647)"
}
10.7. Get Additional Order Information
Retrieve the additional info for Newegg Global order including:
Additional order requirement for certain countries.
The original recipient information for orders shipped by NISP service.
The original recipient information inputted by international customers.
10.7.1. Resource URL & Information
Resource URL
https://api.newegg.com/marketplace/ordermgmt/order/addorderinfo?sellerid={sellerid}
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
Resource Information
150
HTTP Method
Authentication?
Request Formats
Response Formats
Rate Limited?
POST
Required
XML, Json
XML, Json
1000 per min per client
10.7.2. Request Body
Attribute
Required?
Format
Description
NeweggAPIRequest
IssueUser
No
String
Specify your eligible seller account (email address) here.
OperationType
Yes
String
Fixed value: GetAddOrderInfoRequest
RequestBody
PageIndex
No
Integer
Current page index
If left blank, will use 1 as default.
PageSize
No
Integer
Return records count in one page.
(Max is 100 per page)
If left blank, will use 100 as default.
RequestCriteria
OrderNumberList
OrderNumber
No
Integer
The order number you would like to query.
Ignore other search conditions (request criteria) if order number is specified.
Status
No
Integer
0: Unshipped
1: Partially Shipped
2: Shipped
3: Invoiced
4: Voided
5: All
If left blank, will return orders in Unshipped status
OrderDownloaded
No
Integer
0: False(Default): include downloaded orders
1: True: do not include downloaded orders
Type
No
Integer
0: All (Default)
1: SBN (Shipped by Newegg)
2: SBS (Shipped by Seller)
3: NISP
VoidSoon
No
Integer
The order will be auto voided after 24 or 48 hours.
Available values:
24
48
OrderDateFrom
No
String
Order Date From (Pacific Standard Time)
Please refer to the Acceptable Date Format
OrderDateTo
No
String
Order Date To (Pacific Standard Time)
Please refer to the Acceptable Date Format
CountryCode
No
String
The country for your orders. Only the ISO standard 3-digit codes are accepted.
To review the complete list of available values, please download the following:
https://promotions.newegg.com/Marketplace/Sellers/resourceLibrary/Interna
tional%20Country%20Guide.pdf
Example: XML, Request
XSD
151
API Schema > OrderMgmt > GetAddOrderInfo > GetAddOrderInfoRequest.xsd
POST https://api.newegg.com/marketplace/ordermgmt/order/addorderinfo?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggAPIRequest>
<OperationType>GetAddOrderInfoRequest</OperationType>
<RequestBody>
<PageIndex>1</PageIndex>
<PageSize>10</PageSize>
<RequestCriteria>
<OrderNumberList>
<OrderNumber>159243598</OrderNumber>
<OrderNumber>41473642</OrderNumber>
</OrderNumberList>
<Status>0</Status>
<Type>1</Type>
<OrderDateFrom>2017-01-01 09:30:47</OrderDateFrom>
<OrderDateTo>2017-12-17 09:30:47</OrderDateTo>
<OrderDownloaded>0</OrderDownloaded>
<CountryCode>BRA</CountryCode>
</RequestCriteria>
</RequestBody>
</NeweggAPIRequest>
Example: Json, Response
POST https://api.newegg.com/marketplace/ordermgmt/order/addorderinfo?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"OperationType": "GetAddOrderInfoRequest",
"RequestBody": {
"PageIndex": "1",
"PageSize": "10",
152
"RequestCriteria": {
"OrderNumberList": {
"OrderNumber": [
"159243598",
"41473642"
]
},
"Status": "1",
"Type": "1",
"OrderDateFrom": "2017-01-01 09:30:47",
"OrderDateTo": "2017-12-17 09:30:47",
"OrderDownloaded": 0,
"CountryCode":"BRA"
}
}
}
10.7.3. Response Body
Attribute
Format
Description
NeweggAPIResponse
IsSuccess
String
Used to identify the operation of Get Additional Order Info is
successful
True or False
SellerID
String
Your seller ID
OperationType
String
Fixed value: GetAddOrderInfoResponse
ResponseByody
PageInfo
TotalCount
Integer
Total number of records
TotalPageCount
Integer
Total page count
PageSize
Integer
How many records in a page.
PageIndex
Integer
Current page index
AddOrderInfoList
AddOrderInfo
OrderNumber
Integer
Newegg Order number
RecipientIDType
String
A personal identity document that provided by customer. This
document may be used for customs clearance for certain countries.
Currently available values: CPF, CNPJ, Passport. It is required for
orders from Brazil.
RecipientIDNumber
string
The value of the ID associated with the document identified under
"ID Type"
NISP
Origi
nalInf
o
NISPOriFirstName
String
The First Name of the original recipient
153
NISPOriLastName
String
The Last Name of the original recipient
NISPOriCompanyName
String
The company name of the original recipient
NISPOriAddress1
String
The address line 1 of the original recipient
NISPOriAddress2
String
The address line 2 of the original recipient
NISPOriCity
String
The City of the original recipient
NISPOriState
String
The State of the original recipient
NISPOriZipCode
String
The Zipcode of the original recipient
NISPOriCountryCode
String
The destination country of the original recipient
NISPOriPhoneNumber
String
the contact phone number of the original recipient
OriginalInputInfo
OriginalFirstName
String
The First Name of the recipient, in the original format inputted by
customer
OriginalLastName
String
The Last Name of the recipient, in the original format inputted by
customer
OriginalCompanyName
String
The company name of the recipient, in the original format inputted
by customer
OriginalAddress1
String
The address line 1 of the recipient, in the original format inputted by
customer
OriginalAddress2
String
The address line 2 of the recipient, in the original format inputted
by customer
OriginalCity
String
The City of the recipient, in the original format inputted by
customer
OriginalState
String
The State of the recipient, in the original format inputted by
customer
OriginalZipCode
String
The Zipcode of the recipient, in the original format inputted by
customer
OriginalCountryCode
String
The destination country of the recipient, in the original format
inputted by customer
OriginalPhoneNumber
String
the contact phone number of the recipient, in the original format
inputted by customer
AddInfo1
String
Additional information may include further information related to
Newegg Global orders or data that may providing additional
information that are beneficial to your operation in Newegg
Marketplace. It is optional and currently no data is available. We
will notify sellers once they are available.
AddInfo2
String
AddInfo3
String
Memo
String
Other information.
ResponseDate
String
The response date
154
Example: XML, Response
XSD
API Schema > OrderMgmt > GetOrderInfo > GetAddOrderInfoResponse.xsd
<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<SellerID>A006</SellerID>
<OperationType>GetAddOrderInfoResponse</OperationType>
<ResponseBody>
<PageInfo>
<TotalCount>2</TotalCount>
<TotalPageCount>1</TotalPageCount>
<PageSize>10</PageSize>
<PageIndex>1</PageIndex>
</PageInfo>
<AddOrderInfoList>
<AddOrderInfo>
<OrderNumber>41473642</OrderNumber>
<RecipientIDType>ID</RecipientIDType>
<RecipientIDNumber>511522198812036655</RecipientIDNumber>
<NISPOriginalInfo>
<NISPOriFirstName>Guang</NISPOriFirstName>
<NISPOriLastName>Li</NISPOriLastName>
<NISPOriCompanyName />
<NISPOriAddress1>149 Tianfu Blvd</NISPOriAddress1>
<NISPOriAddress2 />
<NISPOriCity>Chengdu</NISPOriCity>
<NISPOriState>Sichuan</NISPOriState>
<NISPOriZipCode>64410</NISPOriZipCode>
<NISPOriCountryCode>CHINA</NISPOriCountryCode>
<NISPOriPhoneNumber>13812345678</NISPOriPhoneNumber>
</NISPOriginalInfo>
<OriginalInputInfo>
<OriginalFirstName>广</OriginalFirstName>
<OriginalLastName></OriginalLastName>
<OriginalCompanyName />
155
<OriginalAddress1>天府大道 149 </OriginalAddress1>
<OriginalAddress2 />
<OriginalCity>成都</OriginalCity>
<OriginalState>四川</OriginalState>
<OriginalZipCode>64410</OriginalZipCode>
<OriginalCountryCode>CHINA</OriginalCountryCode>
<OriginalPhoneNumber>13812345678</OriginalPhoneNumber>
</OriginalInputInfo>
<AddInfo1/>
<AddInfo2/>
<AddInfo3/>
</AddOrderInfo>
</AddOrderInfoList>
</ResponseBody>
<Memo />
<ResponseDate>09/01/2018 16:51:03</ResponseDate>
</NeweggAPIResponse>
Example: Json, Response
{
"IsSuccess": "true",
"SellerID": "A006",
"OperationType": "GetAddOrderInfoResponse",
"ResponseBody": {
"PageInfo": {
"TotalCount": "2",
"TotalPageCount": "1",
"PageSize": "10",
"PageIndex": "1"
},
"AddOrderInfoList": {
"AddOrderInfo": {
"OrderNumber": "41473642",
"RecipientIDType": "ID",
"RecipientIDNumber": "511522198812036655",
"NISPOriginalInfo": {
"NISPOriFirstName": "Guang",
"NISPOriLastName": "Li",
"NISPOriCompanyName": [],
"NISPOriAddress1": "149 Tianfu Blvd",
156
"NISPOriAddress2": [],
"NISPOriCity": "Chengdu",
"NISPOriState": "Sichuan",
"NISPOriZipCode": "64410",
"NISPOriCountryCode": "CHINA",
"NISPOriPhoneNumber": "13812345678"
},
"OriginalInputInfo": {
"OriginalFirstName": "广",
"OriginalLastName": "",
"OriginalCompanyName": [],
"OriginalAddress1": "天府大道 149 ",
"OriginalAddress2": [],
"OriginalCity": "成都",
"OriginalState": "四川",
"OriginalZipCode": "64410",
"OriginalCountryCode": "CHINA",
"OriginalPhoneNumber": "13812345678"
},
"AddInfo1": [],
"AddInfo2": [],
"AddInfo3": []
}
}
},
"Memo": [],
"ResponseDate": "9/01/2018 16:51:03"
}
10.7.4. Request Failure Errors
For common HTTP error responses, please refer to Common Error Responses
Example: XML, Response
<?xml version="1.0" encoding="utf-8"?>
<Errors>
<Error>
<Code>CE001</Code>
<Message>SellerID cannot be null or empty</Message>
157
</Error>
</Errors>
Example: Json, Response
{
"Code": "CE001",
"Message": "SellerID cannot be null or empty"
}
11. Newegg Shipping Label Service
Newegg marketplace sellers can take advantage of discounted shipping rates by using the Newegg Shipping Label
Service for Newegg Marketplace orders.
To use Newegg Shipping Label Service:
1. Submit a shipping request
2. Retrieve the result of submitted shipping request
3. Confirm a shipping request
4. Void a shipping request (Optional)
5. Request a packing list
6. Request a shipping label
11.1. Submit Shipping Request
Submit the shipping request for your Newegg order to receive the estimation of shipping cost using Newegg Shipping
Label Service.
Please note that any unconfirmed shipping request will be void automatically within 15 days after submitting the request.
11.1.1. Resource URL & Information
Resource URL
https://api.newegg.com/marketplace/shippingservice/shippinglabel/shippingrequest?sellerid={sellerid}
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
158
sellerid
Yes
Your seller ID on Newegg Marketplace
Resource Information
HTTP Method
Authentication?
Request Formats
Response Formats
Rate Limited?
POST
Required
XML, Json
XML, Json
10 per min per client
11.1.2. Request Body
Attribute
Required
?
Forma
t
Description
NeweggAPIRequest
RequestBody
OperationType
Yes
String
Fixed value: SubmitShippingRequest
Shipment
OrderNumber
Yes
Intege
r
The order number
ShippingCarrierCode
Yes
Intege
r
Shipping carrier.
Available shipping carrier code:
100 Newegg Partnered Carrier (UPS).
For more information, please refer to section 11.1.5:
Newegg Partnered Carrier- UPS.
200 Newegg Partnered Carrier (FedEx).
For more information, please refer to section 11.1.6:
Newegg Partnered Carrier- FedEx.
159
ShippingServiceCode
No
Intege
r
Available shipping service code:
If ShippingCarrierCode = 100:
101 UPS Ground
102 UPS 3 Day Select
103 UPS 2nd Day Air
104 UPS Next Day Air Saver
105 - UPS Next Day Air
106 - UPS Worldwide Saver
If ShippingCarrierCode = 200:
201 FedEx Ground
202 FedEx Home Delivery
203 FedEx Priority Overnight
204 FedEx Express Saver
205 FedEx 2Day
206 FedEx Standard Overnight
207 FedEx International Economy
Note: if left this blank, a default shipping service will be assigned
according to the shipping service that the customer purchased
on this order. The default shipping service mapping as below:
If ShippingCarrierCode = 100:
Newegg Order
Shipping Method
Default Mapped Service
Standard Shipping (5-
7 business days)
UPS Ground
Expedited Shipping (3-
5 business days)
UPS 3 Day Select
Two-Day Shipping
UPS 2nd Day Air
One-Day Shipping
UPS Next Day Air Saver
If ShippingCarrierCode = 200:
Newegg Order
Shipping Method
Default Mapped Service
Standard Shipping
(5-7 business days)
FedEx Ground
Expedited Shipping
(3-5 business days)
FedEx Express Saver
Two-Day Shipping
FedEx 2Day
One-Day Shipping
FedEx Standard Overnight
Note: For Newegg Premier orders, this field cannot be specified.
The default Service will be assigned automatically based on the
shipping service selected by customer while placing orders.
160
ShipFromFirstName
Yes
String
Contact person first name
ShipFromLastName
Yes
String
Contact person last name
ShipFromPhoneNumber
Yes
String
Contact person contact phone number
ShipFromAddress1
Yes
String
Ship from address
* Shipping cost is calculated based on Ship from address. Please
fill in the correct information.
ShipFromAddress2
No
String
Ship from address 2nd line if any
* Shipping cost is calculated based on Ship from address. Please
fill in the correct information.
ShipFromCityName
Yes
String
Ship from city
* Shipping cost is calculated based on Ship from address. Please
fill in the correct information.
ShipFromStateCode
Yes
String
Ship from state, such as CA, FL, etc.
* Shipping cost is calculated based on Ship from address. Please
fill in the correct information.
ShpFromZipCode
Yes
String
Ship from zipcode, such as 91748, 91773, etc.
* Shipping cost is calculated based on Ship from address. Please
fill in the correct information.
ShipFromCountryCode
Yes
String
Ship from country code in 3-digit fromat
* Currenlty only USA is available.
* Shipping cost is calculated based on Ship from address. Please
fill in the correct information.
PackageList
Package
PackageWeight
Yes
Decim
al
Package weight, default unit: lb.
See Shipments Weight and Size Limitations for more
details.
PackageLength
Yes
Decim
al
Package length, default unit: inch
See Shipments Weight and Size Limitations for more
details.
PackageHeight
Yes
Decim
al
Package height, default unit: inch
See Shipments Weight and Size Limitations for more
details.
PackageWidth
Yes
Decim
al
Package width, default unit: inch
See Shipments Weight and Size Limitations for more
details.
ItemLis
t
Item
SellerPart
Number
Yes
String
Seller part number.
161
Quantity
Yes
Intege
r
Item quantity
Example: XML, Request
XSD
API Schema > ShippingLabel > SubmitShippingRequest > ShippingSubmitRequest.xsd
POST
https://api.newegg.com/marketplace/shippingservice/shippinglabel/shippingrequest?sellerid={seller
id}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggAPIRequest>
<OperationType>SubmitShippingRequest</OperationType>
<RequestBody>
<Shipment>
<OrderNumber>2135751360</OrderNumber>
<ShippingCarrierCode>100</ShippingCarrierCode>
<ShippingServiceCode>101</ShippingServiceCode>
<ShipFromFirstName>John</ShipFromFirstName>
<ShipFromLastName>Doe</ShipFromLastName>
<ShipFromPhoneNumber>6266171420</ShipFromPhoneNumber>
<ShipFromAddress1>18045 Rowland Street</ShipFromAddress1>
<ShipFromAddress2/>
<ShipFromCityName>City Of Industry</ShipFromCityName>
<ShipFromStateCode>CA</ShipFromStateCode>
<ShipFromZipCode>91748</ShipFromZipCode>
<ShipFromCountryCode>USA</ShipFromCountryCode>
<PackageList>
<Package>
<PackageWeight>5</PackageWeight>
<PackageLength>5.00</PackageLength>
<PackageHeight>4.00</PackageHeight>
<PackageWidth>3.00</PackageWidth>
<ItemList>
<Item>
162
<SellerPartNumber>201307220000101</SellerPartNumber>
<Quantity>4</Quantity>
</Item>
<Item>
<SellerPartNumber>SARATEST0118</SellerPartNumber>
<Quantity>1</Quantity>
</Item>
</ItemList>
</Package>
<Package>
<PackageWeight>1.5</PackageWeight>
<PackageLength>2.00</PackageLength>
<PackageHeight>3.00</PackageHeight>
<PackageWidth>4.00</PackageWidth>
<ItemList>
<Item>
<SellerPartNumber>201307220000102</SellerPartNumber>
<Quantity>3</Quantity>
</Item>
</ItemList>
</Package>
</PackageList>
</Shipment>
</RequestBody>
</NeweggAPIRequest>
Example: Json, Request
POST
https://api.newegg.com/marketplace/shippingservice/shippinglabel/shippingrequest?sellerid={seller
id}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"OperationType": "SubmitShippingRequest",
"RequestBody": {
"Shipment": {
"OrderNumber": "2135751360",
163
"ShippingCarrierCode": "100",
"ShippingServiceCode": "101",
"ShipFromFirstName": "Jon",
"ShipFromLastName": "Doe",
"ShipFromPhoneNumber": "6266171420",
"ShipFromAddress1": "18045 Rowland Street",
"ShipFromCityName": "City Of Industry",
"ShipFromStateCode": "CA",
"ShipFromZipCode": "91748",
"ShipFromCountryCode": "USA",
"PackageList": {
"Package": [
{
"PackageWeight": "5",
"PackageLength": "5.00",
"PackageHeight": "4.00",
"PackageWidth": "3.00",
"ItemList": {
"Item": [
{
"SellerPartNumber": "201307220000101",
"Quantity": "4"
},
{
"SellerPartNumber": "SARATEST0118",
"Quantity": "1"
}
]
}
},
{
"PackageWeight": "1.5",
"PackageLength": "2.00",
"PackageHeight": "3.00",
"PackageWidth": "4.00",
"ItemList": {
"Item": {
"SellerPartNumber": "201307220000102",
"Quantity": "3"
}
}
164
}
]
}
}
}
}
11.1.3. Response Body
Attribute
Format
Description
NeweggAPIResponse
IsSuccess
String
Used to identify the operation of Get feed status is successful
True or False
OperationType
String
Fixed value: SubmitShippingResponse
SellerID
String
Your seller ID
ResponseBody
RequestID
String
The Identifier of a submission
RequestDate
String
Request date.
RequestStatus
String
The status of the request submission.
ESTIMATING
Example: XML, Response
XSD
API Schema > ShippingLabel > SubmitShippingRequest > ShippingSubmitResponse.xsd
<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<OperationType>SubmitShippingResponse</OperationType>
<SellerID>A006</SellerID>
<ResponseBody>
<RequestID>2PQCX3SPZ3QBF</RequestID>
<RequestDate>12/06/2015 10:21:00</RequestDate>
<RequestStatus>ESTIMATING</RequestStatus>
</ResponseBody>
</NeweggAPIResponse>
Example: Json, Response
165
{
"IsSuccess": "true",
"OperationType": "SubmitShippingResponse",
"SellerID": "A006",
"ResponseBody": {
"RequestID": "2PQCX3SPZ3QBF",
"RequestDate": "12/06/2015 10:21:00",
"RequestStatus": "ESTIMATING"
}
}
11.1.4. Request Failure Errors
For common HTTP error responses, please refer to Common Error Responses
Error Code
Description
SL001
Your request cannot be processed. The tem(s):{0} in order: [Order #] has been shipped or voided
SL002
No data found or this order does not belong to this seller
SL003
Only unshipped orders can submit a shipping request. The order status is currently {order status}
SL004
Only shipped by seller orders can submit a shipping request.
SL005
Seller Part #: {sellerpart#} must be shipped for its entire quantity on the order.
SL006
The field: [PackageWeight or PackageLength or PackageHeight or PackageWidth] is required when using Newegg
Partnered Carrier service (ShippingCarrierCode: 100).For more detail, please review Newegg API Development
Guide.
SL007
The value in the field: PackageWeight cannot exceed {Maximum package weight limit by Newegg Partnered
Carrier} lbs. ({Maximum package weight limit by Newegg Partnered Carrier}kg) when using Newegg Partnered
Carrier service (ShippingCarrierCode: {ShippingCarrierCode}). For more detail, please review Newegg API
Development Guide.
SL008
The value in the field: PackageLength cannot exceed {Maximum package length limit by Newegg Partnered
Carrier} inches ({Maximum package length limit by Newegg Partnered Carrier} cm) when using Newegg Partnered
Carrier service (ShippingCarrierCode: {ShippingCarrierCode}). For more detail, please review Newegg API
Development Guide.
SL009
Package size cannot exceed {Maximum package cubic size limit by Newegg Partnered Carrier}inches ({Maximum
package cubic size limit by Newegg Partnered Carrier} cm) in (Package Length + 2x Package Width + 2x Package
Height) when using Newegg Partnered Carrier service (ShippingCarrierCode: {ShippingCarrierCode}). For more
detail, please review Newegg API Development Guide.
SL010
Cannot submit the request because seller part number(s):{sellerpart#} does NOT belong to this order.
SL015
Cannot submit the request because currently only supports USA domestic transportation.Please revise the Ship
From or Ship To information and try again.
166
SL027
Invalid request. You are not able to use Newegg Shipping Label Service before sign up. Please visit Newegg Seller
Portal > Add-on Services > Newegg Shipping Label Service to sign up.
SL030
Invalid request. The ShippingServiceCode :{ shipping service code} you specified is not a recognized value for
ShippingCarrierCode :{ shipping carrier code}. Please review Newegg API Development Guide or schema for
correct information.
Example: XML, Response
<?xml version="1.0" encoding="utf-8"?>
<Errors>
<Error>
<Code>SL001</Code>
<Message>Order Number should be an integer (ranging from 1 to 2147483647)</Message>
</Error>
</Errors>
Example: Json, Response
{
"Code": "SL001",
"Message": "Order Number should be an integer (ranging from 1 to 2147483647)"
}
11.1.5. Newegg Partnered Carrier- UPS
Newegg partnered carriers offer deeply discounted rates, and the cost is billed to your account as a “Newegg Shipping
Label”. We will provide a shipping label that you can print and use with our partnered carriers. The rates apply to
shipments originating from the continental 50 U.S. states only (does not include Puerto Rico or APO/FPO addressed).
Please note this service is currently not available for International Sellers.
Shipment Measurement Guidelines
- Shipments Weight and Size Limitations.*
Packages can be up to 150 lbs. (70 kg).
Packages can be up to 165 inches (419 cm) in (Length + 2x Width + 2x Height).
Packages can be up to 108 inches (270 cm) in Length.
*Packages with a large size-to-weight ratio require special pricing and dimensional weight calculations.
Example: A box measuring 34" x 34" x 34" exceeds the maximum dimensions. The length (34") plus 2x width (2 x 34")
and 2x height (2 x 34") equals 170".
167
- Large Package
If packages Length plus 2x Width plus 2x Height exceeds 130 inches (330 cm), UPS applies a Large Package Surcharge.
Example: A box measuring 36” x 26” x 26” the length (36”) plus 2x width (2 x 26”) and 2x height (2 x 26”) equals 140”.
UPS will accept the box, but they may apply a Large Package Surcharge.
- Dimensional Weight
If a package's volume is more than 5,184 cubic inches (3 cubic feet), UPS compares the dimensional weight (cubic inches
divided by 166) with the actual weight. If the dimensional weight is greater than actual weight, UPS uses the package's
dimensional weight as the billable weight.
Example: A package measuring 26" x 16" x 16" has a volume of 6,656 cubic inches. The dimensional weight equals 6,656
divided by 166 or 41 lbs. If the package's actual weight is 24 lbs., the dimensional weight may be used for the billable
weight.
- Billable Weight
For large packages, UPS determines the billable weight by taking the package dimensions into account. For large
packages, if the dimensional weight is greater than the actual weight, UPS may use the dimensional weight instead of the
actual weight.
11.1.6. Newegg Partnered Carrier- FedEx
Newegg partnered carriers offer deeply discounted rates, and the cost is billed to your account as a “Newegg Shipping
Label Fee”. We will provide a shipping label that you can print and use with our partnered carriers. The rates apply to
shipments originating from the continental 50 U.S. states only (does not include Puerto Rico or APO/FPO addressed).
Please note this service is currently not available for International Sellers.
Shipment Measurement Guidelines
- Shipments Weight and Size Limitations.*
Packages can be up to 150 lbs. (70 kg).
Packages can be up to 165 inches (419 cm) in (Length + 2x Width + 2x Height).
Packages with a large size-to-weight ratio require special pricing and dimensional weight
calculations.*Packages with a large size-to-weight ratio require special pricing and dimensional weight
calculations.
*: Packages that exceed weight and size limits may be refused by FedEx or at FedEx’s discretion of shipment and apply
an oversize surcharge.
Example: A box measuring 34" x 34" x 34" exceeds the maximum dimensions. The length (34") plus 2x width (2 x 34")
and 2x height (2 x 34") equals 170".
168
- Large Package
If packages Length plus 2x Width plus 2x Height exceeds 130 inches (330 cm), FedEx applies an Oversize Surcharge.
Example: A box measuring 36” x 26” x 26” the length (36”) plus 2x width (2 x 26”) and 2x height (2 x 26”) equals 140”.
FedEx will accept the box, but they may apply an Oversize Surcharge.
- Dimensional Weight
If the dimensional weight is greater than actual weight, FedEx uses the package's dimensional weight as the billable
weight.
Example: A package measuring 26" x 16" x 16" has a volume of 6,656 cubic inches. The dimensional weight equals
6,656 divided by 166 or 41 lbs. If the package's actual weight is 24 lbs, the dimensional weight may be used for the
billable weight.
- Billable Weight
For large packages, FedEx determines the billable weight by taking the package dimensions into account. For large
packages, if the dimensional weight is greater than the actual weight, FedEx may use the dimensional weight instead of
the actual weight.
11.2. Get Request Detail
Retrieving the processing result including Shipping Request (section 11.1), Confirm Shipping Request (section 11.3), and
Void Shipping Request (section 11.4).
11.2.1. Resource URL & Information
Resource URL
https://api.newegg.com/marketplace/shippingservice/shippinglabel/shippingdetail?sellerid={sellerid}
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
Resource Information
HTTP Method
Authentication?
Request Formats
Response Formats
Rate Limited?
PUT
Required
XML, Json
XML, Json
10 per min per client
11.2.2. Request Body
169
Attribute
Required?
Format
Description
NeweggAPIRequest
IssueUser
No
String
Specify your eligible seller account (email address) here
OperationType
Yes
String
Fixed values:
GetShippingDetailRequest
RequestBody
RequestID
YES if no
RequestID
is not
available
String
The request ID
* This service does NOT support querying multiple request IDs.
OrderNumber
YES if no
RequestID
is not
available
String
The order number
Example: XML, Request
XSD
API Schema > ShippingLabel > GetShippingRequest > ShippingDetailRequest.xsd
PUT
https://api.newegg.com/marketplace/shippingservice/shippinglabel/shippingdetail?sellerid={selleri
d}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggAPIRequest>
<OperationType>GetShippingDetailRequest</OperationType>
<RequestBody>
<RequestID>2PQBYWH4V68ZP</RequestID>
<OrderNumber>423423678</OrderNumber>
</RequestBody>
</NeweggAPIRequest>
Example: Json, Request
PUT
https://api.newegg.com/marketplace/shippingservice/shippinglabel/shippingdetail?sellerid={selleri
d}
Authorization: 720ddc067f4d115bd544aff46bc75634
170
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"OperationType": "GetShippingDetailRequest",
"RequestBody": {
"RequestID": "2PQBYWH4V68ZP",
"OrderNumber": "423423678"
}
}
11.2.3. Response Body
Attribute
Format
Description
NeweggAPIResponse
IsSuccess
String
Used to identify the operation is successful
True or False
SellerID
String
Your seller ID
OperationType
String
Fixed value: GetShippingDetailResponse
ResponseBody
OrderNumber
Integer
Related order number
RequestList
Request
RequestID
String
Shipping request ID
RequestDate
String
The date the shipping request was submitted
CustomerName
String
The orders customer name.
CustomerPhoneNumber
String
The orders shipping phone number
CustomerEmailAddress
String
The masked customer email address, you can reach to the customer
through this email address.
For example: gdv6l0viwo4l7j1d@marketplace.newegg.com
ShipToAddress1
String
The order will be shipped to address
ShipToAddress2
String
The order will be shipped to address line 2
ShipToCityName
String
The order will be shipped to city name
ShipToStateCode
String
The order will be shipped to state
ShipToZipCode
String
The order will be shipped to zip code
ShipToCountryCode
String
The order will be shipped to country.
Default values:
United States
171
ShippingCarrierCode
Integer
Shipping carrier.
Available shipping carrier code:
100 Newegg Partnered Carrier (UPS). For more information,
please refer to section 11.1.5: Newegg Partnered Carrier- UPS.
200 Newegg Partnered Carrier (FedEx). For more information,
please refer to section 11.1.6: Newegg Partnered Carrier- FedEx.
172
ShippingServiceCode
Integer
Available shipping service code:
If ShippingCarrierCode = 100:
101 UPS Ground
102 UPS 3 Day Select
103 UPS 2nd Day Air
104 UPS Next Day Air Saver
105 - UPS Next Day Air
106 - UPS Worldwide Saver
If ShippingCarrierCode = 200:
201 FedEx Ground
202 FedEx Home Delivery
203 FedEx Priority Overnight
204 FedEx Express Saver
205 FedEx 2Day
206 FedEx Standard Overnight
207 FedEx International Economy
Note: if left this blank, a default shipping service will be assigned according
to the shipping service that the customer purchased on this order. The
default shipping service mapping as below:
If ShippingCarrierCode = 100:
Newegg Order
Shipping Method
Default Mapped Service
Standard Shipping (5-
7 business days)
UPS Ground
Expedited Shipping (3-
5 business days)
UPS 3 Day Select
Two-Day Shipping
UPS 2nd Day Air
One-Day Shipping
UPS Next Day Air Saver
If ShippingCarrierCode = 200:
Newegg Order
Shipping Method
Default Mapped Service
Standard Shipping
(5-7 business days)
FedEx Ground
Expedited Shipping
(3-5 business days)
FedEx Express Saver
Two-Day Shipping
FedEx 2Day
One-Day Shipping
FedEx Standard Overnight
NOTE: If the shipping request is for a Newegg Premier order, this field is
not able to specify and a cheapest shipping service will be assigned
173
automatically in terms of the shipping service that the customer purchased
on the order.
ShipmentStatus
String
Available shipment status:
ESTIMATING you have successfully sent a request to estimate the
shipping cost but Newegg partnered carrier is in the process of the
estimation.
ESTIMATED Newegg partnered carrier has completed shipping cost
estimation. You are able to confirm to ship the request.
ERROR_ESIMATING An error encountered in the process of the
estimation.
CONFIRMING you have successfully sent a request to confirm the
shipment but the confirmation process is not yet complete.
CONFIRMED Your shipping has been confirmed. Note: You cannot void
the shipping request anymore.
ERROR_CONFIRMING An error encountered in the process of confirming.
VOIDING You have successfully sent a request to void a shipping request
but the voiding process has not yet complete.
VOIDED The shipping request has confirmed to void, your account will
not be charged for the shipping cost.
ShipDate
String
The date when the shipping request confirmed
ErrorMessage
String
An error encountered in the process of the request.
Only has value when the ShipmentStatus = ERROR_ESTIMATING or
ERROR_CONFIRMING
PartneredEstimate
BillableWeight
Decima
l
The weight that the Newegg partnered carrier will bill to the shipment.
EstimatedDeliveryDay
String
The date that the Newegg partnered carrier will delivery the shipment.
EstimatedChargeAmoun
t
Decima
l
The amount that the Newegg partnered carrier will charge to the
shipment.
ShipFromFirstName
String
Contact person first name
ShipFromLastName
String
Contact person last name
ShipFromPhoneNumber
String
Contact person contact phone number
ShipFromAddress1
String
Ship from address
ShipFromAddress2
String
Ship from address 2nd line if any
ShipFromCityName
String
Ship from city
ShipFromStateCode
String
Ship from state
ShpFromZipCode
String
Ship from zipcode
ShipFromCountryCode
String
Ship from country code in 3-digit fromat
* Currenlty the default value is USA.
174
PackageList
Package
TrackingNumber
String
Tracking number
ItemList
Item
SellerPart
Number
String
Seller part number.
Quantity
Integer
Item quantity
Example: XML, Response
XSD
API Schema > ShippingLabel > GetShippingRequest > ShippingDetailResponse.xsd
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<OperationType>GetShippingDetailResponse</OperationType>
<SellerID>A006</SellerID>
<ResponseBody>
<OrderNumber>2135751360</OrderNumber>
<RequestList>
<Request>
<RequestID>2PQBYWH4V68ZP</RequestID>
<RequestDate>12/10/2015 14:38:17</RequestDate>
<Shipment>
<CustomerName>WY SD</CustomerName>
<CustomerPhoneNumber>123-223-3223</CustomerPhoneNumber>
<CustomerEmailAddress>gdv6l0viwo4l7j1d@marketplace.newegg.com</CustomerEmailAddress>
<ShipToAddress1>149 Kenwood Dr</ShipToAddress1>
<ShipToAddress2/>
<ShipToCityName>Newcastle</ShipToCityName>
<ShipToStateCode>WY</ShipToStateCode>
<ShipToZipCode>82701</ShipToZipCode>
<ShipToCountryCode>UNITED STATES</ShipToCountryCode>
<ShippingCarrierCode>100</ShippingCarrierCode>
<ShippingServiceCode>101</ShippingServiceCode>
<ShipmentStatus>CONFIRMED</ShipmentStatus>
<ErrorMessage/>
<ShipDate>12/25/2015</ShipDate>
<PartneredEstimate>
<BillableWeight>6.5</BillableWeight>
<EstimatedDeliveryDay>12/29/2015</EstimatedDeliveryDay>
<EstimatedChargeAmount>21.94</EstimatedChargeAmount>
175
</PartneredEstimate>
<ShipFromFirstName>Jon</ShipFromFirstName>
<ShipFromLastName>Doe</ShipFromLastName>
<ShipFromPhoneNumber>6266171420</ShipFromPhoneNumber>
<ShipFromAddress1>18045 Rowland Street</ShipFromAddress1>
<ShipFromAddress2/>
<ShipFromCityName>City Of Industry</ShipFromCityName>
<ShipFromStateCode>CA</ShipFromStateCode>
<ShipFromZipCode>91748</ShipFromZipCode>
<ShipFromCountryCode>USA</ShipFromCountryCode>
<PackageList>
<Package>
<TrackingNumber>1Z8V016A0377769652</TrackingNumber>
<ItemList>
<Item>
<SellerPartNumber>201307220000101</SellerPartNumber>
<Quantity>4</Quantity>
</Item>
<Item>
<SellerPartNumber>SARATEST0118</SellerPartNumber>
<Quantity>1</Quantity>
</Item>
</ItemList>
</Package>
<Package>
<TrackingNumber>1Z8V016A0360430477</TrackingNumber>
<ItemList>
<Item>
<SellerPartNumber>201307220000102</SellerPartNumber>
<Quantity>3</Quantity>
</Item>
</ItemList>
</Package>
</PackageList>
</Shipment>
</Request>
<Request>
<RequestID>2PQBYWH4V68ZP</RequestID>
<RequestDate>12/10/2015 14:38:17</RequestDate>
<Shipment>
<CustomerName>WY SD</CustomerName>
176
<CustomerPhoneNumber>123-223-3223</CustomerPhoneNumber>
<CustomerEmailAddress>gdv6l0viwo4l7j1d@marketplace.newegg.com</CustomerEmailAddress>
<ShipToAddress1>149 Kenwood Dr</ShipToAddress1>
<ShipToAddress2/>
<ShipToCityName>Newcastle</ShipToCityName>
<ShipToStateCode>WY</ShipToStateCode>
<ShipToZipCode>82701</ShipToZipCode>
<ShipToCountryCode>UNITED STATES</ShipToCountryCode>
<ShippingCarrierCode>100</ShippingCarrierCode>
<ShippingServiceCode>101</ShippingServiceCode>
<ShipmentStatus>CONFIRMED</ShipmentStatus>
<ErrorMessage/>
<ShipDate>12/25/2015</ShipDate>
<PartneredEstimate>
<BillableWeight>6.5</BillableWeight>
<EstimatedDeliveryDay>12/29/2015</EstimatedDeliveryDay>
<EstimatedChargeAmount>21.94</EstimatedChargeAmount>
</PartneredEstimate>
<ShipFromFirstName>Jon</ShipFromFirstName>
<ShipFromLastName>Doe</ShipFromLastName>
<ShipFromPhoneNumber>6266171420</ShipFromPhoneNumber>
<ShipFromAddress1>18045 Rowland Street</ShipFromAddress1>
<ShipFromAddress2/>
<ShipFromCityName>City Of Industry</ShipFromCityName>
<ShipFromStateCode>CA</ShipFromStateCode>
<ShipFromZipCode>91748</ShipFromZipCode>
<ShipFromCountryCode>USA</ShipFromCountryCode>
<PackageList>
<Package>
<TrackingNumber>1Z8V016A0377769652</TrackingNumber>
<ItemList>
<Item>
<SellerPartNumber>201307220000101</SellerPartNumber>
<Quantity>4</Quantity>
</Item>
<Item>
<SellerPartNumber>SARATEST0118</SellerPartNumber>
<Quantity>1</Quantity>
</Item>
</ItemList>
177
</Package>
<Package>
<TrackingNumber>1Z8V016A0360430477</TrackingNumber>
<ItemList>
<Item>
<SellerPartNumber>201307220000102</SellerPartNumber>
<Quantity>3</Quantity>
</Item>
</ItemList>
</Package>
</PackageList>
</Shipment>
</Request>
</RequestList>
</ResponseBody>
</NeweggAPIResponse>
Example: Json, Response
{
"IsSuccess": "true",
"OperationType": "GetShippingDetailResponse",
"SellerID": "A006",
"ResponseBody": {
"OrderNumber": "2135751360",
"RequestList": {
"Request": [
{
"RequestID": "2PQBYWH4V68ZP",
"RequestDate": "12/10/2015 14:38:17",
"Shipment": {
"CustomerName": "WY SD",
"CustomerPhoneNumber": "123-223-3223",
"CustomerEmailAddress": "gdv6l0viwo4l7j1d@marketplace.newegg.com",
"ShipToAddress1": "149 Kenwood Dr",
"ShipToCityName": "Newcastle",
"ShipToStateCode": "WY",
"ShipToZipCode": "82701",
"ShipToCountryCode": "UNITED STATES",
"ShippingCarrierCode": "100",
"ShippingServiceCode": "101",
178
"ShipmentStatus": "CONFIRMED",
"ShipDate": "12/25/2015",
"PartneredEstimate": {
"BillableWeight": "6.5",
"EstimatedDeliveryDay": "12/29/2015",
"EstimatedChargeAmount": "21.94"
},
"ShipFromFirstName": "Jon",
"ShipFromLastName": "Doe",
"ShipFromPhoneNumber": "6266171420",
"ShipFromAddress1": "18045 Rowland Street",
"ShipFromCityName": "City Of Industry",
"ShipFromStateCode": "CA",
"ShipFromZipCode": "91748",
"ShipFromCountryCode": "USA",
"PackageList": {
"Package": [
{
"TrackingNumber": "1Z8V016A0377769652",
"ItemList": {
"Item": [
{
"SellerPartNumber": "201307220000101",
"Quantity": "4"
},
{
"SellerPartNumber": "SARATEST0118",
"Quantity": "1"
}
]
}
},
{
"TrackingNumber": "1Z8V016A0360430477",
"ItemList": {
"Item": {
"SellerPartNumber": "201307220000102",
"Quantity": "3"
}
}
}
179
]
}
}
},
{
"RequestID": "2PQBYWH4V68ZP",
"RequestDate": "12/10/2015 14:38:17",
"Shipment": {
"CustomerName": "WY SD",
"CustomerPhoneNumber": "123-223-3223",
"CustomerEmailAddress": "gdv6l0viwo4l7j1d@marketplace.newegg.com",
"ShipToAddress1": "149 Kenwood Dr",
"ShipToCityName": "Newcastle",
"ShipToStateCode": "WY",
"ShipToZipCode": "82701",
"ShipToCountryCode": "UNITED STATES",
"ShippingCarrierCode": "100",
"ShippingServiceCode": "101",
"ShipmentStatus": "CONFIRMED",
"ShipDate": "12/25/2015",
"PartneredEstimate": {
"BillableWeight": "6.5",
"EstimatedDeliveryDay": "12/29/2015",
"EstimatedChargeAmount": "21.94"
},
"ShipFromFirstName": "Jon",
"ShipFromLastName": "Doe",
"ShipFromPhoneNumber": "6266171420",
"ShipFromAddress1": "18045 Rowland Street",
"ShipFromCityName": "City Of Industry",
"ShipFromStateCode": "CA",
"ShipFromZipCode": "91748",
"ShipFromCountryCode": "USA",
"PackageList": {
"Package": [
{
"TrackingNumber": "1Z8V016A0377769652",
"ItemList": {
"Item": [
{
"SellerPartNumber": "201307220000101",
180
"Quantity": "4"
},
{
"SellerPartNumber": "SARATEST0118",
"Quantity": "1"
}
]
}
},
{
"TrackingNumber": "1Z8V016A0360430477",
"ItemList": {
"Item": {
"SellerPartNumber": "201307220000102",
"Quantity": "3"
}
}
}
]
}
}
}
]
}
}
}
11.2.4. Request Failure Errors
For common HTTP error responses, please refer to Common Error Responses
Error Code
Description
SL013
Cannot find shipping request:{[request ID]}
Example: XML, Response
<?xml version="1.0" encoding="utf-8"?>
<Errors>
<Error>
<Code>SL001</Code>
181
<Message>Order Number should be an integer (ranging from 1 to 2147483647)</Message>
</Error>
</Errors>
Example: Json, Response
{
"Code": "SL001",
"Message": "Order Number should be an integer (ranging from 1 to 2147483647)"
}
11.3. Confirm Shipping Request
Once a shipping estimate is avaiable, you must confirm it when you are ready to ship.
Please note: once a shipping request is confirmed, Newegg will continue to process the order and the status of order will
soon become “Shipped”. Also, the shipping information will be displayed in Order Detail under the customer’s My Account
section, and Newegg also send the customer an email notification with all of the shipping information.
Once a shipping request is confirmed, the revoke of the operation is not available.
11.3.1. Resource URL & Information
Resource URL
https://api.newegg.com/marketplace/shippingservice/shippinglabel/confirmshippingrequest?sellerid={sellerid}
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
Resource Information
HTTP Method
Authentication?
Request Formats
Response Formats
Rate Limited?
POST
Required
XML, Json
XML, Json
10 per min per client
11.3.2. Request Body
Attribute
Required?
Format
Description
N
e
w
e
g
g
A
P
I
R
e
q
u
e
s
t
OperationType
Yes
String
Fixed values:
182
ConfirmShippingRequest
RequestBody
RequestIDList
RequestID
Yes
String
The shipping request ID
Example: XML, Request
XSD
API Schema > ShippingLabel > ConfirmShippingRequest > ShippingComfirmRequest.xsd
POST
https://api.newegg.com/marketplace/shippingservice/shippinglabel/confirmshippingrequest?sellerid=
{sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggAPIRequest>
<OperationType>ConfirmShippingRequest</OperationType>
<RequestBody>
<RequestIDList>
<RequestID>2PQBYWH4V68ZP</RequestID>
<RequestID>2PQCX3SPZ3QBF</RequestID>
</RequestIDList>
</RequestBody>
</NeweggAPIRequest>
Example: Json, Request
POST
https://api.newegg.com/marketplace/shippingservice/shippinglabel/shippingrequest?sellerid={seller
id}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
183
"OperationType": "ConfirmShippingRequest",
"RequestBody": {
"RequestIDList":{
"RequestID": [
"2PQBYWH4V68ZP",
"2PQCX3SPZ3QBF"
]
}
}
}
11.3.3. Response Body
Attribute
Format
Description
NeweggAPIResponse
IsSuccess
String
Used to identify the operation of Get feed status is successful
True or False
OperationType
String
Fixed value: ConfirmShippingResponse
SellerID
String
Your seller ID
ResponseBody
RequestIDList
RequestID
String
The Identifier of a submission
RequestDate
String
Request date.
RequestStatus
String
The status of the request submission.
CONFIRMING
Example: XML, Response
XSD
API Schema > ShippingLabel > ConfirmShippingRequest > ShippingComfirmResponse.xsd
<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<OperationType>ConfirmShippingResponse</OperationType>
<SellerID>A006</SellerID>
<ResponseBody>
<RequestIDList>
<RequestID>2PQBYWH4V68ZP</RequestID>
<RequestID>2PQCX3SPZ3QBF</RequestID>
</RequestIDList>
184
<RequestDate>12/06/2015 10:21:00</RequestDate>
<RequestStatus>CONFIRMING</RequestStatus>
</ResponseBody>
</NeweggAPIResponse>
Example: Json, Response
{
"IsSuccess": "true",
"OperationType": "ConfirmShippingResponse",
"SellerID": "A006",
"ResponseBody": {
"RequestIDList": {
"RequestID": [
"2PQBYWH4V68ZP",
"2PQCX3SPZ3QBF"
]
},
"RequestDate": "12/06/2015 10:21:00",
"RequestStatus": "CONFIRMING"
}
}
11.3.4. Request Failure Errors
For common HTTP error responses, please refer to Common Error Responses
Error Code
Description
SL014
This shpping request cannot be confirmed. The shipping request has not estimated, Please submit estimate
shipping cost request first.
SL017
Request {request ID} cannot be submitted because the shipping request has {confirmed | voided}. Please revise
the request list and submit again.
SL024
Invalid Request ID
Example: XML, Response
<?xml version="1.0" encoding="utf-8"?>
<Errors>
<Error>
185
<Code>SL001</Code>
<Message>Order Number should be an integer (ranging from 1 to 2147483647)</Message>
</Error>
</Errors>
Example: Json, Response
{
"Code": "SL001",
"Message": "Order Number should be an integer (ranging from 1 to 2147483647)"
}
11.4. Void Shipping Request
An unconfirmed shipping request can be void using this function.
11.4.1. Resource URL & Information
Resource URL
https://api.newegg.com/marketplace/shippingservice/shippinglabel/voidshippingrequest?sellerid={sellerid}
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
Resource Information
HTTP Method
Authentication?
Request Formats
Response Formats
Rate Limited?
POST
Required
XML, Json
XML, Json
10 per min per client
11.4.2. Request Body
Attribute
Required?
Format
Description
New
egg
APIR
equ
est
OperationType
Yes
String
Fixed values:
VoidShippingRequest
186
RequestBody
RequestIDList
RequestID
Yes
String
Shipping request ID
Example: XML, Request
XSD
API Schema > ShippingLabel > VoidShippingRequest > ShippingVoidRequest.xsd
POST
https://api.newegg.com/marketplace/shippingservice/shippinglabel/voidshippingrequest?sellerid={se
llerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggAPIRequest>
<OperationType>VoidShippingRequest</OperationType>
<RequestBody>
<RequestIDList>
<RequestID>2PQBYWH4V68ZP</RequestID>
<RequestID>2PQCX3SPZ3QBF</RequestID>
</RequestIDList>
</RequestBody>
</NeweggAPIRequest>
Example: Json, Response
https://api.newegg.com/marketplace/shippingservice/shippinglabel/voidshippingrequest?sellerid={se
llerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"OperationType": "VoidShippingRequest",
"RequestBody": {
"RequestIDList": {
187
"RequestID": [
"2PQBYWH4V68ZP",
"2PQCX3SPZ3QBF"
]
}
}
}
11.4.3. Response Body
Attribute
Format
Description
NeweggAPIResponse
IsSuccess
String
Used to identify the operation of Get feed status is successful
True or False
OperationType
String
Fixed value: ConfirmShippingResponse
SellerID
String
Your seller ID
ResponseBody
RequestIDList
RequestID
String
The Identifier of a submission
RequestDate
String
Request date.
RequestStatus
String
The status of the request submission.
VOIDING
Example: XML, Response
XSD
API Schema > ShippingLabel > VoidShippingRequest > ShippingVoidResponse.xsd
<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<OperationType>VoidShippingResponse</OperationType>
<SellerID>A006</SellerID>
<ResponseBody>
<RequestIDList>
<RequestID>2PQBYWH4V68ZP</RequestID>
<RequestID>2PQCX3SPZ3QBF</RequestID>
</RequestIDList>
<RequestDate>12/06/2015 10:21:00</RequestDate>
<RequestStatus>VOIDING</RequestStatus>
</ResponseBody>
</NeweggAPIResponse>
188
Example: Json, Response
{
"IsSuccess": "true",
"OperationType": "VoidShippingResponse",
"SellerID": "A006",
"ResponseBody": {
"RequestIDList": {
"RequestID": [
"2PQBYWH4V68ZP",
"2PQCX3SPZ3QBF"
]
},
"RequestDate": "12/06/2015 10:21:00",
"RequestStatus": "CONFIRMING"
}
}
11.4.4. Request Failure Errors
For common HTTP error responses, please refer to Common Error Responses
Error Code
Description
SL017
Request {request ID} cannot be submitted because the shipping request has {confirmed | voided}. Please revise
the request list and submit again.
Example: XML, Response
<?xml version="1.0" encoding="utf-8"?>
<Errors>
<Error>
<Code>SL001</Code>
<Message>Order Number should be an integer (ranging from 1 to 2147483647)</Message>
</Error>
</Errors>
189
Example: Json, Response
{
"Code": "SL001",
"Message": "Order Number should be an integer (ranging from 1 to 2147483647)"
}
11.5. Get Package List
When you are ready to ship an order, you can request a packge list using this function.
11.5.1. Resource URL & Information
Resource URL
https://api.newegg.com/marketplace/shippingservice/shippinglabel/packagelist?sellerid={sellerid}
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
Resource Information
HTTP Method
Authentication?
Request Formats
Response Formats
Rate Limited?
PUT
Required
XML, Json
XML, Json
10 per min per client
11.5.2. Request Body
Attribute
Required?
Format
Description
NeweggAPIRequest
OperationType
Yes
String
Fixed values:
GetPackageListRequest
RequestBod
y
RequestID
YES if OrderNumber
is not available
String
The shipping request ID
OrderNumber
YES if no RequestID
is not available
String
The order number.
190
Example: XML, Request
XSD
API Schema > ShippingLabel > GetPackageList > GetPackageListRequest.xsd
PUT
https://api.newegg.com/marketplace/shippingservice/shippinglabel/packagelist?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggAPIRequest>
<OperationType>GetPackageListRequest</OperationType>
<RequestBody>
<RequestID>2PQCX3SPZ3QBF</RequestID>
</RequestBody>
</NeweggAPIRequest>
Example: Json, Request
PUT
https://api.newegg.com/marketplace/shippingservice/shippinglabel/packagelist?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"OperationType": "GetPackageListRequest",
"RequestBody": {
"RequestID": "2PQCX3SPZ3QBF"
}
}
11.5.3. Response Body
Attribute
Format
Description
New
egg
APIR
espo
nse
IsSuccess
String
Used to identify the operation of Get feed status is successful
True or False
191
OperationType
String
Fixed value: GetPackageListResponse
SellerID
String
Your seller ID
ResponseBody
OrderNumber
String
Related order number
RquestList
Request
RequestID
String
The Identifier of a submission
pdfFileList
File
String
The PDF document URL for package list
Example: XML, Response
XSD
API Schema > ShippingLabel > GetPackageList > GetPackageListResponse.xsd
<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<OperationType>GetPackageListResponse</OperationType>
<SellerID>A006</SellerID>
<ResponseBody>
<OrderNumber>423423678</OrderNumber>
<RequestList>
<Request>
<RequestID>2PQBYWH4V68ZP</RequestID>
<PdfFileList>
<File>http://images10.newegg.com/SBNInbound/UPSShippingLabel/dc395051-a1ba-
4c7e-99c9-94025bc7577e.pdf</File>
<File>http://images10.newegg.com/SBNInbound/UPSShippingLabel/dc395051-a1ba-
4c7e-99c9-94025bc7577e.pdf</File>
</PdfFileList>
</Request>
<Request>
<RequestID>2PQBYWH4V68ZP</RequestID>
<PdfFileList>
<File>http://images10.newegg.com/SBNInbound/UPSShippingLabel/dc395051-a1ba-
4c7e-99c9-94025bc7577e.pdf</File>
<File>http://images10.newegg.com/SBNInbound/UPSShippingLabel/dc395051-a1ba-
4c7e-99c9-94025bc7577e.pdf</File>
</PdfFileList>
</Request>
192
</RequestList>
</ResponseBody>
</NeweggAPIResponse>
Example: Json, Response
{
"IsSuccess": "true",
"OperationType": "GetPackageListResponse",
"SellerID": "A006",
"ResponseBody": {
"OrderNumber": "423423678",
"RequestList": {
"Request": [
{
"RequestID": "2PQBYWH4V68ZP",
"PdfFileList": {
"File": [
"http://images10.newegg.com/SBNInbound/UPSShippingLabel/dc395051-a1ba-4c7e-99c9-
94025bc7577e.pdf",
"http://images10.newegg.com/SBNInbound/UPSShippingLabel/dc395051-a1ba-4c7e-99c9-
94025bc7577e.pdf"
]
}
},
{
"RequestID": "2PQBYWH4V68ZP",
"PdfFileList": {
"File": [
"http://images10.newegg.com/SBNInbound/UPSShippingLabel/dc395051-a1ba-4c7e-99c9-
94025bc7577e.pdf",
"http://images10.newegg.com/SBNInbound/UPSShippingLabel/dc395051-a1ba-4c7e-99c9-
94025bc7577e.pdf"
]
}
}
]
}
}
}
193
11.5.4. Request Failure Errors
For common HTTP error responses, please refer to Common Error Responses
Error Code
Description
SL018
Invalid request. OrderNumber or RequestId is required.
Example: XML, Response
<?xml version="1.0" encoding="utf-8"?>
<Errors>
<Error>
<Code>SL001</Code>
<Message>Order Number should be an integer (ranging from 1 to 2147483647)</Message>
</Error>
</Errors>
Example: Json, Response
{
"Code": "SL001",
"Message": "Order Number should be an integer (ranging from 1 to 2147483647)"
}
11.6. Get Shipping Labels
When you are ready to ship an order, you can request a shipping label for a confirmed shipping request.
11.6.1. Resource URL & Information
Resource URL
https://api.newegg.com/marketplace/shippingservice/shippinglabel/shippinglabels?sellerid={sellerid}
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
194
Resource Information
HTTP Method
Authentication?
Request Formats
Response Formats
Rate Limited?
PUT
Required
XML, Json
XML, Json
10 per min per client
11.6.2. Request Body
Attribute
Required?
Format
Description
NeweggAPIRequest
OperationType
Yes
String
Fixed values:
GetShippingLabelRequest
RequestBod
y
RequestID
YES if OrderNumber is
not available
String
The shipping request ID
OrderNumber
YES if no RequestID is
not available
String
The order number.
Example: XML, Request
XSD
API Schema > ShippingLabel > GetShippingLabels > GetShippingLabelRequest.xsd
PUT
https://api.newegg.com/marketplace/shippingservice/shippinglabel/shippinglabels?sellerid={selleri
d}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggAPIRequest>
<OperationType>GetShippingLabelRequest</OperationType>
<RequestBody>
<RequestID>2PQCX3SPZ3QBF</RequestID>
</RequestBody>
</NeweggAPIRequest>
Example: Json, Request
PUT
https://api.newegg.com/marketplace/shippingservice/shippinglabel/shippinglabels?sellerid={selleri
d}
Authorization: 720ddc067f4d115bd544aff46bc75634
195
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"OperationType": "GetShippingLabelRequest",
"RequestBody": {
"RequestID": "2PQCX3SPZ3QBF" }
}
11.6.3. Response Body
Attribute
Format
Description
NeweggAPIResponse
IsSuccess
String
Used to identify the operation of Get feed status is successful
True or False
OperationType
String
Fixed value: GetShippingLabelResponse
SellerID
String
Your seller ID
ResponseBody
OrderNumber
String
Related order number.
RquestList
Request
RequestID
String
The Identifier of a submission
pdfFileList
File
String
The PDF document URL for printing package or shipping labels.
Example: XML, Response
XSD
API Schema > ShippingLabel > GetShippingLabels > GetShippingLabelResponse.xsd
<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<OperationType>GetShippingLabelResponse</OperationType>
<SellerID>A006</SellerID>
<ResponseBody>
<OrderNumber>423423678</OrderNumber>
<RequestList>
<Request>
196
<RequestID>2PQBYWH4V68ZP</RequestID>
<PdfFileList>
<File>http://images10.newegg.com/SBNInbound/UPSShippingLabel/dc395051-a1ba-
4c7e-99c9-94025bc7577e.pdf</File>
<File>http://images10.newegg.com/SBNInbound/UPSShippingLabel/dc395051-a1ba-
4c7e-99c9-94025bc7577e.pdf</File>
</PdfFileList>
</Request>
<Request>
<RequestID>2PQBYWH4V68ZP</RequestID>
<PdfFileList>
<File>http://images10.newegg.com/SBNInbound/UPSShippingLabel/dc395051-a1ba-
4c7e-99c9-94025bc7577e.pdf</File>
<File>http://images10.newegg.com/SBNInbound/UPSShippingLabel/dc395051-a1ba-
4c7e-99c9-94025bc7577e.pdf</File>
</PdfFileList>
</Request>
</RequestList>
</ResponseBody>
</NeweggAPIResponse>
Example: Json, Response
{
"IsSuccess": "true",
"OperationType": "GetShippingLabelResponse",
"SellerID": "A006",
"ResponseBody": {
"OrderNumber": "423423678",
"RequestList": {
"Request": [
{
"RequestID": "2PQBYWH4V68ZP",
"PdfFileList": {
"File": [
"http://images10.newegg.com/SBNInbound/UPSShippingLabel/dc395051-a1ba-4c7e-99c9-
94025bc7577e.pdf",
"http://images10.newegg.com/SBNInbound/UPSShippingLabel/dc395051-a1ba-4c7e-99c9-
94025bc7577e.pdf"
]
}
197
},
{
"RequestID": "2PQBYWH4V68ZP",
"PdfFileList": {
"File": [
"http://images10.newegg.com/SBNInbound/UPSShippingLabel/dc395051-a1ba-4c7e-99c9-
94025bc7577e.pdf",
"http://images10.newegg.com/SBNInbound/UPSShippingLabel/dc395051-a1ba-4c7e-99c9-
94025bc7577e.pdf"
]
}
}
]
}
}
}
11.6.4. Request Failure Errors
For common HTTP error responses, please refer to Common Error Responses
Error Code
Description
SL018
Invalid request. OrderNumber or RequestId is required.
Example: XML, Response
<?xml version="1.0" encoding="utf-8"?>
<Errors>
<Error>
<Code>SL001</Code>
<Message>Order Number should be an integer (ranging from 1 to 2147483647)</Message>
</Error>
</Errors>
Example: Json, Response
{
"Code": "SL001",
"Message": "Order Number should be an integer (ranging from 1 to 2147483647)"
}
198
12. DataFeed Management
The Newegg DataFeed API lets you uploading item creation/update, item inventory and order ship notice to Newegg
Systems and return result in XML/Json format. You can also use the Newegg DataFeed API to get processing status
and report(s).
The process for submitting feeds is as follows:
1. Submit an XML request using the SubmitFeed operation along with all required metadata, including a value from the
FeedType list. Current available data feed types:
Creating item list or updating existing item information.
Updating inventory
Updating price
Updating order shipping information.
Create orders with other platforms other than Newegg Marketplace. This is only available for SBN (Shipped by
Newegg) sellers.
Batch submit/update Subscribe & Save items.
Submit/update volume discount items in batch.
Batch deal submission requests.
Batch mark Newegg Premier Items.
Adding warranty services for refurbished and used items.
Update CA Prop. 65 warning for items in batch.
Setting up tax type for items enabled for China in batch.
2. As with all submissions to Newegg Marketplace API, you must also include authentication information. The
SubmitFeed operation returns a RequestID, which you can use to periodically check the status of the feed using the
GetFeedsStatus operation.
3. If Newegg Marketplace API is still processing a request, the RequestStatus element of theGetFeedsStatus operation
returns a status of IN_PROGRESS. If the processing is complete, a status of FINISHED is returned.
4. When the feed processing is complete, you can use the GetFeedResult operation to receive a processing report that
describes which records in the feed were successful and which records generated errors.
5. Analyze the processing report, correct any errors in the transmission, and resubmit the feed using the SubmitFeed
operation. Repeat the process until there are no errors in the processing report to complete your updates.
6. Please download the XSD’s and XML sample files for different feed types from
https://sellerportal.newegg.com/Guideline/Newegg_Marketplace_API_DeveloperGuide.zip. You can also contact
Newegg Marketplace Integration team: Datafeeds@newegg.com for assistance.
199
12.1. Submit Feed
12.1.1. Resource URL & Information
Resource URL
https://api.newegg.com/marketplace/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype={RequestType}
Note: Please make sure your request URL is all in lower case (except for Seller ID and Request Type) and cannot contain any blank
spaces or line breaks.
Parameters
Name
Required?
Description
sellerId
Yes
Your seller ID on Newegg Marketplace
requesttype
Yes
The feed type which you want to submit to our system, which determines
the action you want to perform through datafeed systems.
Current support following types:
ITEM_DATA
- Batch creating item / update item / replace or append item image(s)
based on specified subcategories.
- Batch item creation by matching the existing items in Newegg
catalog. The main intent of this approach is to let sellers listing an item
using ISBN, UPC, Manufacturer Part Number, or Newegg Item Number
without specifying sub-category related information. This helps sellers
creating the items more quickly.
- Batch updating basic information for items without having to specify
item subcategory. This template can only be used to update common
item fields such as “Website Short Title”, Product Description”, “Item
Images”, etc. Complete list of common fields listed in section 11.1.2
INVENTORY_DATA - Through this type you can batch update inventory for
Newegg International program.
PRICE_DATA - Through this type you can batch update price for additional
countries for Newegg International program.
ORDER_SHIP_NOTICE_DATA - Through this type you can batch ship order.
200
MULTICHANNEL_ORDER_DATA Through this type you can batch creating
multi-channel orders that are not placed on Newegg.com, orders that will
be SBN (Shipped by Newegg).
ITEM_SUBSCRIPTION Through this type you can batch adding or
removing Subscription & Save items.
VOLUME_DISCOUNT_DATA - Through this type you can batch
create/update/delete volume discount.
ITEM_PROMOTION_DATA - Through this type you can batch create item
promotion requests.
ITEM_PREMIER_MARK_DATA Through this type you can batch add /
remove items for Newegg Premier Program
ITEM_WARRANTY_DATA Adding Warranty Services for Items
ITEM_CAPROP65_DATA Adding California’s Proposition 65 (“Prop
65”)Warnings for Items
ITEM_CHINATAXSETTING_DATA Setting up tax type for items enabled for
China in batch.
Resource Information
HTTP Method
Authentication?
Request Formats
Response Formats
POST
Required
XML, Json
XML, Json
Request Type
Rate Limited
Maximum Size of Request
ITEM_DATA
Max. 10 requests per min per
client
Max. 30,000 records per file and each file cannot exceed
20MB. Limit 30,000 records per hour.
INVENTORY_DATA
Max. 10 requests per min per
client
Max. 10,000 records per file. Limit 100,000 records per
hour.
PRICE_DATA
ITEM_CHINATAXSETTING_DAT
A
ORDER_SHIP_NOTICE_DATA
Max. 100 requests per min per
client
Max. 10,000 records per file. Limit 30,000 records per hour.
MULTICHANNEL_ORDER_DATA
ITEM_SUBSCRIPTION
VOLUME_DISCOUNT_DATA
ITEM_PROMOTION_DATA
201
ITEM_PREMIER_MARK_DATA
ITEM_WARRANTY_DATA
ITEM_CAPROP65_DATA
12.1.2. Request Body
ITEM_DATA (Create, Update Item Info)
There are several options available:
1. Batch creating item / update item / replace or append image to item(s) based on different sub-categories. For each
subcategory, there’s a category structure schema that needs to be followed (different subcategory requires different property
input per item). You can download these schemas by logging into Seller Portal and select Manage Items -> Batch Item
Creation/Update -> The tab of Download File Template Batch -> Select “Batch Item Creation” from the drop-down options of
Action-> Select Extensible Markup Language (.XML) file format-> select the industry from the drop-down list.
2. Batch item creation by matching the existing items in Newegg catalog. The main intent of this approach is to let sellers listing
an item using ISBN, UPC, Manufacturer Part Number, or Newegg Item Number without specifying sub-category related
information. This helps sellers creating the items more quickly.
3. Batch updating the basic information for items without specifying item subcategory. This template can only be used to update
common fields (not subcategory specific fields).
CANNOT exceed 7,000 items or total file size cannot exceed 10 MB per request.
The following information provides element definitions. You can also contact Newegg Marketplace Integration team:
Datafeeds@newegg.com for assistance.
The following information provides Attribute Definitions and the corresponding XML example.
Batch creating item / update item / replace or append image to item(s) based on different sub-categories
Attribute
Format
Description
Required
DocumentVersion
Decimal
The identifier for the version of current
datafeed; assigned by Newegg
Y
MessageType
String
BatchItemCreation
Y
Messag
e
Itemfee
d
SubCategoryID
String
Identify the category specification. There is
only one category can be used for any single
item.
Y
202
NOTE: Once an item is created, this
information cannot be updated.
Item
Action
String
Specify the action you would like to perform.
- Enter "Create Item" if you want to list a
new product that is not currently in your
item list.
- Enter "Update Item" to update the
information of a product already in your
item list (does not include updating of
pricing fields: Currency, MSRP, MAP,
Selling Price, Shipping, Inventory and
Activation Mark)
- Enter "Update/Append Image" to
upload additional image(s) of the
product or overwrite existing image(s).
- Enter "Replace Image" to replace all of
your existing images with the image
URL's provided in this file. When this
action is selected, the system will only
process the Item Images field and
Activation Mark; all other information,
including Selling Price, will be ignored.
If no value was entered for this field, by
default the system will do the following:
- If item currently does not exist in your
item list, we will treat it as if you
entered “Create Item.
N
BasicInfo
SellerPartNumber
String
A seller-defined unique identifier for an item.
An alphanumeric string, max 40 characters
including space.
NOTE: Once an item is created, this
information cannot be updated.
Y
Manufacturer
String
The manufacturer name for the item. You
must use a pre-defined value from our system
or request the addition of a new value from
the Content Team at
mktp.content@newegg.com.
NOTE: Once an item is created, this
information cannot be updated.
Y
203
ManufacturerPartNumberOrISBN
String
Manufacturer defined unique identifier for an
item. An alphanumeric string, max 20
characters including space.
NOTE: Once an item is created, this
information cannot be updated.
Required
if item
UPC code
is not
provided
UPC
String
A unique Universal Product Code (UPC) (12
characters only) or European Article Number
(EAN)(13 characters only) for an item. A
numeric string, max 40 characters.
NOTE: Once an item is created, this
information cannot be updated.
Required
if item
Manufact
urer Part
# / ISBN
is not
provided
RelatedSellerPartNumber
String
If the item is a variant of another ("related")
item with its own seller part #, list the related
item's seller part # here. This is required for
the variant item to display under a single
product page. An alphanumeric string, max
20 characters including space.
NOTE: Once an item is created, this
information cannot be updated.
N
WebsiteShortTitle
String
The short, easily identifiable item name for
this item. It will be used as the main name for
your product on all store pages, Sales Orders
and receipts, so should not contain variables.
Maximum characters: 200.
Y
BulletDescription
String
Enter concise descriptions of selected
product features or functions which will be
listed by bullet point below the website
short/long title on the product page.
Use separator ^^” to separate different
points. Maximum characters: 200, including
spaces and separators. NO HTML is allowed.
N
ProductDescription
String
The detailed description to be featured on
the item page. This description should state
the features and functions of the product.
Should be the same for all items in product
family. (4000 character limit.)
Accepted HTML for Product Description
fields. Only <ol>,<ul>, <li>,<br>, <p>,
<b>, <i>, <u>, <em>, <strong>, <sub>,
<sup> are allowed.
Y
204
ItemDimension
ItemLength
Decimal
Individual unit shipping length in inches
N
ItemWidth
Decimal
Individual unit shipping width in inches
N
ItemHeight
Decimal
Individual unit shipping height in inches
N
ItemWeight
Decimal
Individual unit shipping weight in lb.
Y
ItemCondition
String
Available values for Item Condition:
New: This means the product will ship as
received by the manufacturer, sealed, with all
advertised components, and with the
manufacturer warranty.
Refurbished: This means the product was
tested and repaired as required to meet the
standards of the refurbisher, which may or
may not be the original manufacturer. Any
exceptions to the condition of the item
outside the manufacturer’s information
should be provided in the listing, up to and
including warranty details.
The following values are only apply to U.S.
Marketplace:
UsedLikeNew: This means that the product
has been opened, possibly used but is in
perfect factory condition with no signs of
cosmetic or functional defect. Product
includes warranty, and accessories found
with the original product. Product may or
may not be in the original packaging.
Returned items with minor packaging defects
fall under this category.
UsedVeryGood: This means that the
product has been opened, may show slight
signs of use and cosmetic blemish, and may
be missing minor accessories, but remain in
excellent condition. Product does not come
with warranty unless stated otherwise in
product description.
UsedGood: This means that the product has
been used, may show clear signs of use and
may be missing minor accessories, but
N
205
remain in good condition. Product does not
come with warranty unless stated otherwise
in product description.
UsedAcceptable: This means that the
product shows clear signs of use, cosmetic
defect, and may be missing minor accessories
and manual, but remain in working condition.
Product does not come with warranty unless
stated otherwise in product description.
Functionality issues beyond signs of use
should be disclosed in product description.
NOTE: Once an item is created, this
information cannot be updated.
PacksOrSets
Integer
Identify the package count of this product. All
products in a pack or set will have matching
item and condition.
NOTE: Once an item is created, this
information cannot be updated.
Y
ItemPackage
String
Available value to identify the package of
product
N
ShippingRestriction
String
Identify if there is any shipping restriction for
product
Y
Currency
String
The form of money for all price related
elements. Default value: USD
N
MSRP
Decimal
The default anufacturer's suggested retail
price for the product for the United States.
If you want to remove MSRP, input “0.00” or
‘0’ in this field. If null, no change to current
setting.
N
MAP
Decimal
The default Minimum advertised price for the
United States.
If the Selling Price is below the defined MAP,
the website will ask customer to add item to
shopping cart to see the item's price.
If you want to remove MAP, input “0.00” or
‘0’ in this field. If null, no change to current
setting.
N
CheckoutMAP
String
Regardless the Selling Price and the value
inputted in MAP field, if the Checkout MAP is
marked as True, then the website will ask
customer to add item to shopping cart AND
N
206
go to checkout page to see the item's price.
This is the default setting of the United of
states.
SellingPrice
Decimal
The default selling price for the United States.
Y
Shipping
String
The default shipping charge setting for this
item for the United States.
Y
Inventory
Integer
The inventory quantity available for the only
warehouse location.
NOTE: If multiple warehouses are available,
Please submit International Program- Update
Inventory requests/feeds to manage
inventory.
Y
ActivationMark
String
The ActivationMark's default setting is "True"
on all uploaded products for United States. All
products must be activated to be visible on
Newegg.com United States. You may set it to
"False" if you wish to deactivate your product.
N
ItemImages
Image
ImageUrl
String
Enter the URL for this item's product images.
All URLs must be a direct link to the actual
image. Image file must be (.jpg or .jpeg). An
alphanumeric string; 2000 characters
maximum in length.
Minimum image size: 640 pixels width and
480 pixels height.
The maximum file size for each image is 5MB.
All files larger than the 5MB limit will fail to
process.
Y
IsPrimary
Boolean
The identifier to specify the default image, if
multiple images will be uploaded.
N
ConditionDetails
String
Information related to the condition, not
including New or Refurbished, of the product
can be described here to help customer
understanding the product.
NOTE: This information only apply to U.S.
Marketplace
N
207
UsedItemImages
Image
ImageUrl
String
Item images of your item to better describe
the characteristics of used condition. This
image(s) should not be images of a new item.
Enter the URL for the USED item's specified
product images. All URLs must be a direct link
to the actual image. Image file must be (.jpg
or .jpeg)
Minimum image size: 640 pixels width and
480 pixels height.
The maximum file size for each image is 5MB.
All files larger than the 5MB limit will fail to
process.
NOTE: This information only apply to U.S.
Marketplace
N
IsPrimary
Boolean
The identifier to specify the default image, if
multiple images will be uploaded.
NOTE: This information only apply to U.S.
Marketplace
N
Warning
Prop65
String
Used if the product is subject to prop 65
regulations in California.
N
Prop65Motherboard
String
Used if the product is motherboard related
subject to prop 65 regulations in California.
N
CountryOfOrigin
String
Country of Origin is the country of
manufacture/ production of your items.
Newegg only accept ISO standard three-letter
codes for the various countries of the world.
For complete list, please refer to the
following:
http://en.wikipedia.org/wiki/ISO_3166-
1_alpha-3
Please note: this value is required if you
intend to sell your items globally through
Newegg.
N
OverAge18Verification
String
Used if the product contains graphics or adult
content that is inappropriate for person
under 18 years old.
N
208
ChokingHazard
String
Choking Hazard Warning Requirements for
Children's Toys and Games
You may select up to four of these six
warnings. You should never need to choose
more than four warnings, as a warning that a
product "contains" a small ball or marble
should not apply simultaneously with the
corresponding warning that a product "is" a
small ball or marble.
Please refer to Consumer product Safety
Improvement Act of 2008 (CPSIA) for more
information.
N
SubCategoryProperty
Vary
Section containing category-specific
information such as properties. Reference the
following XSDs to complete the Product Data
section (only one category can be used for a
given item).
Y
Example: XML, Request
XSD
API Schema > DataFeedMgmt > DataFeedSchema > Itemfeed.xsd and sub-category.xsd
POST
https://api.newegg.com/marketplace/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype=ITEM_DATA
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggEnvelope>
<Header>
<DocumentVersion>1.0</DocumentVersion>
</Header>
<MessageType>BatchItemCreation</MessageType>
<Message>
<Itemfeed>
<SummaryInfo>
<SubCategoryID>13905</SubCategoryID>
</SummaryInfo>
<Item>
209
<Action>Create Item</Action>
<BasicInfo>
<SellerPartNumber>JACKETEST0921001002</SellerPartNumber>
<Manufacturer>AMD</Manufacturer>
<ManufacturerPartNumberOrISBN>JACKETEST0921001002</ManufacturerPartNumberOrISBN>
<UPC></UPC>
<ManufacturerItemURL></ManufacturerItemURL>
<RelatedSellerPartNumber></RelatedSellerPartNumber>
<WebsiteShortTitle>Sick1111111</WebsiteShortTitle>
<ProductDescription>hello222222</ProductDescription>
<ItemDimension>
<ItemLength>4</ItemLength>
<ItemWidth>5</ItemWidth>
<ItemHeight>6</ItemHeight>
</ItemDimension>
<ItemWeight>3</ItemWeight>
<PacksOrSets>1</PacksOrSets>
<ItemCondition>New</ItemCondition>
<ItemPackage>OEM</ItemPackage>
<ShippingRestriction>Yes</ShippingRestriction>
<Currency>USD</Currency>
<MSRP>500</MSRP>
<SellingPrice>100</SellingPrice>
<Shipping>Free</Shipping>
<Inventory>100</Inventory>
<ActivationMark>True</ActivationMark>
<ItemImages>
<Image>
<ImageUrl>http://10.1.24.143:4567/images/20.gif</ImageUrl>
</Image>
</ItemImages>
<Warning>
<Prop65>No</Prop65>
<Prop65Motherboard>Yes</Prop65Motherboard>
<OverAge18Verification>Yes</OverAge18Verification>
<ChokingHazard>
<SmallParts>Yes</SmallParts>
<SmallBall>Is a small ball</SmallBall>
<Balloons>Yes</Balloons>
<Marble>Is a marble</Marble>
</ChokingHazard>
210
</Warning>
</BasicInfo>
<SubCategoryProperty>
<CostumeAccessories>
<CostumeAccBrand>String</CostumeAccBrand>
<CostumeAccModel>String</CostumeAccModel>
<CostumeAccGender>Male</CostumeAccGender>
<CostumeAccAge>Adult</CostumeAccAge>
<CostumeAccType>Blood &amp; Gore</CostumeAccType>
<CostumeAccTheme>Animals &amp; Insects</CostumeAccTheme>
<CostumeAccOccasion>1st Birthday</CostumeAccOccasion>
<CostumeAccSize>#10</CostumeAccSize>
<CostumeAccColor>String</CostumeAccColor>
<CostumeAccMaterial>String</CostumeAccMaterial>
<CostumeAccCareInstructions>String</CostumeAccCareInstructions>
</CostumeAccessories>
</SubCategoryProperty>
</Item>
<Item>
<Action>Create Item</Action>
<BasicInfo>
<SellerPartNumber>JACKETEST0921001003</SellerPartNumber>
<Manufacturer>AMD</Manufacturer>
<ManufacturerPartNumberOrISBN>JACKETEST0921001003</ManufacturerPartNumberOrISBN>
<UPC></UPC>
<ManufacturerItemURL></ManufacturerItemURL>
<RelatedSellerPartNumber></RelatedSellerPartNumber>
<WebsiteShortTitle>Sick1111111</WebsiteShortTitle>
<ProductDescription>hello222222</ProductDescription>
<ItemDimension>
<ItemLength>4</ItemLength>
<ItemWidth>5</ItemWidth>
<ItemHeight>6</ItemHeight>
</ItemDimension>
<ItemWeight>5</ItemWeight>
<PacksOrSets>1</PacksOrSets>
<ItemCondition>UsedGood</ItemCondition>
<ItemPackage>OEM</ItemPackage>
<ShippingRestriction>Yes</ShippingRestriction>
<Currency>USD</Currency>
<MSRP>500</MSRP>
211
<SellingPrice>100</SellingPrice>
<Shipping>Free</Shipping>
<Inventory>100</Inventory>
<ActivationMark>True</ActivationMark>
<ItemImages>
<Image>
<ImageUrl>http://10.1.24.143:4567/images/20.gif</ImageUrl>
</Image>
</ItemImages>
<ConditionDetails>Works fine, almost like new, missing original plastics
cover.</ConditionDetails>
<UsedItemImages>
<Image>
<ImageUrl>http://10.1.24.143:4567/images/Used.gif</ImageUrl>
</Image>
</UsedItemImages>
<Warning>
<Prop65>No</Prop65>
<Prop65Motherboard>Yes</Prop65Motherboard>
<OverAge18Verification>Yes</OverAge18Verification>
<ChokingHazard>
<SmallParts>Yes</SmallParts>
<SmallBall>Is a small ball</SmallBall>
<Balloons>Yes</Balloons>
<Marble>Is a marble</Marble>
</ChokingHazard>
</Warning>
</BasicInfo>
<SubCategoryProperty>
<CostumeAccessories>
<CostumeAccBrand>String</CostumeAccBrand>
<CostumeAccModel>String</CostumeAccModel>
<CostumeAccGender>Male</CostumeAccGender>
<CostumeAccAge>Adult</CostumeAccAge>
<CostumeAccType>Blood &amp; Gore</CostumeAccType>
<CostumeAccTheme>Animals &amp; Insects</CostumeAccTheme>
<CostumeAccOccasion>1st Birthday</CostumeAccOccasion>
<CostumeAccSize>#10</CostumeAccSize>
<CostumeAccColor>String</CostumeAccColor>
<CostumeAccMaterial>String</CostumeAccMaterial>
<CostumeAccCareInstructions>String</CostumeAccCareInstructions>
212
</CostumeAccessories>
</SubCategoryProperty>
</Item>
<Item>
<Action>Create Item</Action>
<BasicInfo>
<SellerPartNumber>JACKETEST0921001004</SellerPartNumber>
<Manufacturer>AMD</Manufacturer>
<ManufacturerPartNumberOrISBN>JACKETEST0921001004</ManufacturerPartNumberOrISBN>
<UPC></UPC>
<ManufacturerItemURL></ManufacturerItemURL>
<RelatedSellerPartNumber></RelatedSellerPartNumber>
<WebsiteShortTitle>Sick1111111</WebsiteShortTitle>
<ProductDescription>hello222222</ProductDescription>
<ItemDimension>
<ItemLength>4</ItemLength>
<ItemWidth>5</ItemWidth>
<ItemHeight>6</ItemHeight>
</ItemDimension>
<ItemWeight>3</ItemWeight>
<PacksOrSets>1</PacksOrSets>
<ItemCondition>New</ItemCondition>
<ItemPackage>OEM</ItemPackage>
<ShippingRestriction>Yes</ShippingRestriction>
<Currency>USD</Currency>
<MSRP>500</MSRP>
<SellingPrice>100</SellingPrice>
<Shipping>Free</Shipping>
<Inventory>100</Inventory>
<ActivationMark>True</ActivationMark>
<ItemImages>
<Image>
<ImageUrl>http://10.1.24.143:4567/images/20.gif</ImageUrl>
</Image>
</ItemImages>
<Warning>
<Prop65>No</Prop65>
<Prop65Motherboard>Yes</Prop65Motherboard>
<CountryOfOrigin>USA</CountryOfOrigin>
<OverAge18Verification>Yes</OverAge18Verification>
<ChokingHazard>
213
<SmallParts>Yes</SmallParts>
<SmallBall>Is a small ball</SmallBall>
<Balloons>Yes</Balloons>
<Marble>Is a marble</Marble>
</ChokingHazard>
</Warning>
</BasicInfo>
<SubCategoryProperty>
<CostumeAccessories>
<CostumeAccBrand>String</CostumeAccBrand>
<CostumeAccModel>String</CostumeAccModel>
<CostumeAccGender>Male</CostumeAccGender>
<CostumeAccAge>Adult</CostumeAccAge>
<CostumeAccType>Blood &amp; Gore</CostumeAccType>
<CostumeAccTheme>Animals &amp; Insects</CostumeAccTheme>
<CostumeAccOccasion>1st Birthday</CostumeAccOccasion>
<CostumeAccSize>#10</CostumeAccSize>
<CostumeAccColor>String</CostumeAccColor>
<CostumeAccMaterial>String</CostumeAccMaterial>
<CostumeAccCareInstructions>String</CostumeAccCareInstructions>
</CostumeAccessories>
</SubCategoryProperty>
</Item>
</Itemfeed>
</Message>
</NeweggEnvelope>
Example: Json, Request
POST
https://api.newegg.com/marketplace/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype=ITEM_DATA
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"NeweggEnvelope": {
"Header": { "DocumentVersion": "1.0" },
"MessageType": "BatchItemCreation",
214
"Message": {
"Itemfeed": {
"SummaryInfo": { "SubCategoryID": "13905" },
"Item": [
{
"Action": "Create Item",
"BasicInfo": {
"SellerPartNumber": "JACKETEST0921001002",
"Manufacturer": "AMD",
"ManufacturerPartNumberOrISBN": "JACKETEST0921001002",
"WebsiteShortTitle": "Sick1111111",
"ProductDescription": "hello222222",
"ItemDimension": {
"ItemLength": "4",
"ItemWidth": "5",
"ItemHeight": "6"
},
"ItemWeight": "3",
"PacksOrSets": "1",
"ItemCondition": "New",
"ItemPackage": "OEM",
"ShippingRestriction": "Yes",
"Currency": "USD",
"MSRP": "500",
"SellingPrice": "100",
"Shipping": "Free",
"Inventory": "100",
"ActivationMark": "True",
"ItemImages": {
"Image": { "ImageUrl": "http://10.1.24.143:4567/images/20.gif" }
},
"Warning": {
"Prop65": "No",
"Prop65Motherboard": "Yes",
"OverAge18Verification": "Yes",
"ChokingHazard": {
"SmallParts": "Yes",
"SmallBall": "Is a small ball",
"Balloons": "Yes",
"Marble": "Is a marble"
}
215
}
},
"SubCategoryProperty": {
"CostumeAccessories": {
"CostumeAccBrand": "String",
"CostumeAccModel": "String",
"CostumeAccGender": "Male",
"CostumeAccAge": "Adult",
"CostumeAccType": "Blood & Gore",
"CostumeAccTheme": "Animals & Insects",
"CostumeAccOccasion": "1st Birthday",
"CostumeAccSize": "#10",
"CostumeAccColor": "String",
"CostumeAccMaterial": "String",
"CostumeAccCareInstructions": "String"
}
}
},
{
"Action": "Create Item",
"BasicInfo": {
"SellerPartNumber": "JACKETEST0921001003",
"Manufacturer": "AMD",
"ManufacturerPartNumberOrISBN": "JACKETEST0921001003",
"WebsiteShortTitle": "Sick1111111",
"ProductDescription": "hello222222",
"ItemDimension": {
"ItemLength": "4",
"ItemWidth": "5",
"ItemHeight": "6"
},
"ItemWeight": "5",
"PacksOrSets": "1",
"ItemCondition": "UsedGood",
"ItemPackage": "OEM",
"ShippingRestriction": "Yes",
"Currency": "USD",
"MSRP": "500",
"SellingPrice": "100",
"Shipping": "Free",
"Inventory": "100",
216
"ActivationMark": "True",
"ItemImages": {
"Image": { "ImageUrl": "http://10.1.24.143:4567/images/20.gif" }
},
"ConditionDetails": "Works fine, almost like new, missing original plastics cover.",
"UsedItemImages": {
"Image": { "ImageUrl": "http://10.1.24.143:4567/images/Used.gif" }
},
"Warning": {
"Prop65": "No",
"Prop65Motherboard": "Yes",
"OverAge18Verification": "Yes",
"ChokingHazard": {
"SmallParts": "Yes",
"SmallBall": "Is a small ball",
"Balloons": "Yes",
"Marble": "Is a marble"
}
}
},
"SubCategoryProperty": {
"CostumeAccessories": {
"CostumeAccBrand": "String",
"CostumeAccModel": "String",
"CostumeAccGender": "Male",
"CostumeAccAge": "Adult",
"CostumeAccType": "Blood & Gore",
"CostumeAccTheme": "Animals & Insects",
"CostumeAccOccasion": "1st Birthday",
"CostumeAccSize": "#10",
"CostumeAccColor": "String",
"CostumeAccMaterial": "String",
"CostumeAccCareInstructions": "String"
}
}
},
{
"Action": "Create Item",
"BasicInfo": {
"SellerPartNumber": "JACKETEST0921001004",
"Manufacturer": "AMD",
217
"ManufacturerPartNumberOrISBN": "JACKETEST0921001004",
"WebsiteShortTitle": "Sick1111111",
"ProductDescription": "hello222222",
"ItemDimension": {
"ItemLength": "4",
"ItemWidth": "5",
"ItemHeight": "6"
},
"ItemWeight": "3",
"PacksOrSets": "1",
"ItemCondition": "New",
"ItemPackage": "OEM",
"ShippingRestriction": "Yes",
"Currency": "USD",
"MSRP": "500",
"SellingPrice": "100",
"Shipping": "Free",
"Inventory": "100",
"ActivationMark": "True",
"ItemImages": {
"Image": { "ImageUrl": "http://10.1.24.143:4567/images/20.gif" }
},
"Warning": {
"Prop65": "No",
"Prop65Motherboard": "Yes",
"CountryOfOrigin": "USA",
"OverAge18Verification": "Yes",
"ChokingHazard": {
"SmallParts": "Yes",
"SmallBall": "Is a small ball",
"Balloons": "Yes",
"Marble": "Is a marble"
}
}
},
"SubCategoryProperty": {
"CostumeAccessories": {
"CostumeAccBrand": "String",
"CostumeAccModel": "String",
"CostumeAccGender": "Male",
"CostumeAccAge": "Adult",
218
"CostumeAccType": "Blood & Gore",
"CostumeAccTheme": "Animals & Insects",
"CostumeAccOccasion": "1st Birthday",
"CostumeAccSize": "#10",
"CostumeAccColor": "String",
"CostumeAccMaterial": "String",
"CostumeAccCareInstructions": "String"
}
}
}
]
}
}
}
}
Batch item creation by matching the existing items in Newegg catalog
Attribute
Format
Description
Required
DocumentVersion
Decimal
The identifier for the version of
current datafeed; assigned by
Newegg
Y
MessageType
String
BatchItemCreation
Y
Message
Itemfeed
Item
BasicInfo
SellerPartNumber
String
A seller-defined unique identifier
for an item. An alphanumeric
string, max 40 characters
including space
NOTE: Once an item is created,
this information cannot be
updated.
Y
Manufacturer
String
The manufacturer name for the
item. You must use a pre-defined
value from our system or request
the addition of a new value from
the Content Team at
mktp.content@newegg.com.
NOTE: Once an item is created,
this information cannot be
Y
219
updated.
ManufacturerPartNumberOrISBN
String
Manufacturer defined unique
identifier for an item. An
alphanumeric string, max 20
characters including space.
NOTE: Once an item is created,
this information cannot be
updated.
Required if
item UPC is
not provided
UPC
String
A unique Universal Product Code
(UPC) (12 characters only) or
European Article Number
(EAN)(13 characters only) for an
item. A numeric string, max 40
characters.
NOTE: Once an item is created,
this information cannot be
updated.
Required if
item
Manufacturer
Part # / ISBN
is not
provided
NeweggItemNumber
String
Neweggs unique identifier for an
item
Required if
neither UPC
or item
Manufacturer
Part # / ISBN
is not
provided
Currency
String
The form of money for all price
related elements. Default value:
USD
N
MSRP
Decimal
The default anufacturer's
suggested retail price for the
product for the United States.
If you want to remove MSRP,
input 0.00” or ‘0’ in this field. If
null, no change to current setting.
N
MAP
Decimal
The default Minimum advertised
price for the United States.
If the Selling Price is below the
defined MAP, the website will ask
customer to add item to shopping
cart to see the item's price.
If you want to remove MAP, input
“0.00” or ‘0’ in this field. If null, no
N
220
change to current setting. If the
Selling Price is below the defined
MAP, the website will ask
customer to add item to shopping
cart to see the item's price.
CheckoutMAP
String
Regardless the Selling Price and
the value inputted in MAP field, if
the Checkout MAP is marked as
True, then the website will ask
customer to add item to shopping
cart AND go to checkout page to
see the item's price. This is the
default setting of the United of
states.
N
SellingPrice
Decimal
The default selling price for the
United States.
Y
Shipping
String
The default shipping charge
setting for this item for the United
States.
Y
Inventory
Integer
The inventory quantity available
for the only warehouse location.
NOTE: If multiple warehouses are
available, Please submit
International Program- Update
Inventory requests/feeds to
manage inventory.
Y
ItemCondition
String
Available values for Item
Condition:
New: This means the product
will ship as received by the
manufacturer, sealed, with all
advertised components, and with
the manufacturer warranty.
Refurbished: This means the
product was tested and repaired
as required to meet the standards
of the refurbisher, which may or
may not be the original
manufacturer. Any exceptions to
the condition of the item outside
the manufacturers information
Y
221
should be provided in the listing,
up to and including warranty
details.
The following values are only
apply to U.S. Marketplace:
UsedLikeNew: This means that
the product has been opened,
possibly used but is in perfect
factory condition with no signs of
cosmetic or functional defect.
Product includes warranty, and
accessories found with the
original product. Product may or
may not be in the original
packaging. Returned items with
minor packaging defects fall
under this category.
UsedVeryGood: This means
that the product has been
opened, may show slight signs of
use and cosmetic blemish, and
may be missing minor
accessories, but remain in
excellent condition. Product does
not come with warranty unless
stated otherwise in product
description.
UsedGood: This means that the
product has been used, may show
clear signs of use and may be
missing minor accessories, but
remain in good condition.
Product does not come with
warranty unless stated otherwise
in product description.
UsedAcceptable: This means
that the product shows clear
signs of use, cosmetic defect, and
may be missing minor accessories
and manual, but remain in
222
working condition. Product does
not come with warranty unless
stated otherwise in product
description. Functionality issues
beyond signs of use should be
disclosed in product description.
NOTE: Once an item is created,
this information cannot be
updated.
PacksOrSets
Integer
Identify the package count of this
product. All products in a pack or
set will have matching item and
condition.
NOTE: Once an item is created,
this information cannot be
updated.
Y
ActivationMark
String
The ActivationMark's default
setting is "True" on all uploaded
products because all products
must be activated to be visible on
Newegg websites. You may set it
to "False" if you wish to hide your
product.
N
ConditionDetails
String
Information related to the
condition, not including New or
Refurbished, of the product can
be described here to help
customer understanding the
product.
NOTE: This information only
apply to U.S. Marketplace
N
UsedItemImages
Image
ImageUrl
String
Item images of your item to
better describe the
characteristics of used condition.
This image(s) should not be
images of a new item.
Enter the URL for the USED item's
specified product images. All
URLs must be a direct link to the
actual image. Image file must be
(.jpg or .jpeg)
N
223
Minimum image size: 640 pixels
width and 480 pixels height.
The maximum file size for each
image is 5MB. All files larger than
the 5MB limit will fail to process.
NOTE: This information only
apply to U.S. Marketplace
IsPrimary
Boolean
The identifier to specify the
default image, if multiple images
will be uploaded.
NOTE: This information only
apply to U.S. Marketplace
N
Example: XML, Request
XSD
API Schema > DataFeedMgmt > DataFeedSchema > ExistingFeed.xsd
POST
https://api.newegg.com/marketplace/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype=
ITEM_DATA
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggEnvelope>
<Header>
<DocumentVersion>2.0</DocumentVersion>
</Header>
<MessageType>BatchItemCreation</MessageType>
<Message>
<Itemfeed>
<SummaryInfo/>
<Item>
<BasicInfo>
<SellerPartNumber>a006-test-008</SellerPartNumber>
<Manufacturer>Newegg</Manufacturer>
<ManufacturerPartNumberOrISBN>manu-008</ManufacturerPartNumberOrISBN>
<UPC>123456789012</UPC>
<NeweggItemNumber>9SIAWE50389435</NeweggItemNumber>
<Currency>USD</Currency>
224
<MSRP>99.99</MSRP>
<MAP>5.00</MAP>
<CheckoutMAP>True</CheckoutMAP>
<SellingPrice>9.99</SellingPrice>
<Shipping>Default</Shipping>
<Inventory>99</Inventory>
<ItemCondition>UsedGood</ItemCondition>
<PacksOrSets>1</PacksOrSets>
<ActivationMark>True</ActivationMark>
<ConditionDetails> Works fine, almost like new, missing original plastics
cover </ConditionDetails>
<UsedItemImages>
<Image>
<ImageUrl>http://10.1.24.143:4567/images/Used.gif</ImageUrl>
</Image>
</UsedItemImages>
</BasicInfo>
</Item>
<Item>
<BasicInfo>
<SellerPartNumber>a006-test-009</SellerPartNumber>
<Manufacturer>Newegg</Manufacturer>
<ManufacturerPartNumberOrISBN>manu-009</ManufacturerPartNumberOrISBN>
<UPC>123456789012</UPC>
<NeweggItemNumber>9SIAWE50389434</NeweggItemNumber>
<Currency>USD</Currency>
<MSRP>99.99</MSRP>
<MAP>5.00</MAP>
<SellingPrice>9.99</SellingPrice>
<Shipping>Default</Shipping>
<Inventory>99</Inventory>
<ItemCondition>New</ItemCondition>
<PacksOrSets>1</PacksOrSets>
<ActivationMark>True</ActivationMark>
</BasicInfo>
</Item>
</Itemfeed>
<Itemfeed>
<SummaryInfo/>
<Item>
<BasicInfo>
225
<SellerPartNumber>a006-test-010</SellerPartNumber>
<Manufacturer>Newegg</Manufacturer>
<ManufacturerPartNumberOrISBN>manu-010</ManufacturerPartNumberOrISBN>
<UPC>123456789012</UPC>
<NeweggItemNumber>9SIAWE50389432</NeweggItemNumber>
<Currency>USD</Currency>
<MSRP>99.99</MSRP>
<MAP>5.00</MAP>
<SellingPrice>9.99</SellingPrice>
<Shipping>Default</Shipping>
<Inventory>99</Inventory>
<ItemCondition>New</ItemCondition>
<ActivationMark>True</ActivationMark>
<PacksOrSets>1</PacksOrSets>
</BasicInfo>
</Item>
</Itemfeed>
</Message>
</NeweggEnvelope>
Example: Json, Request
POST
https://api.newegg.com/marketplace/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype=ITEM_DATA
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"NeweggEnvelope": {
"Header": { "DocumentVersion": "2.0" },
"MessageType": "BatchItemCreation",
"Message": {
"Itemfeed": [
{
"Item": [
{
"BasicInfo": {
"SellerPartNumber": "a006-test-008",
"Manufacturer": "Newegg",
226
"ManufacturerPartNumberOrISBN": "manu-008",
"UPC": "123456789012",
"NeweggItemNumber": "9SIAWE50389435",
"Currency": "USD",
"MSRP": "99.99",
"MAP": "5.00",
"CheckoutMAP": "True",
"SellingPrice": "9.99",
"Shipping": "Default",
"Inventory": "99",
"ItemCondition": "UsedGood",
"PacksOrSets": "1",
"ActivationMark": "True",
"ConditionDetails": " Works fine, almost like new, missing original plastics cover
",
"UsedItemImages": {
"Image": { "ImageUrl": "http://10.1.24.143:4567/images/Used.gif" }
}
}
},
{
"BasicInfo": {
"SellerPartNumber": "a006-test-009",
"Manufacturer": "Newegg",
"ManufacturerPartNumberOrISBN": "manu-009",
"UPC": "123456789012",
"NeweggItemNumber": "9SIAWE50389434",
"Currency": "USD",
"MSRP": "99.99",
"MAP": "5.00",
"SellingPrice": "9.99",
"Shipping": "Default",
"Inventory": "99",
"ItemCondition": "New",
"PacksOrSets": "1",
"ActivationMark": "True"
}
}
]
},
{
227
"Item": {
"BasicInfo": {
"SellerPartNumber": "a006-test-010",
"Manufacturer": "Newegg",
"ManufacturerPartNumberOrISBN": "manu-010",
"UPC": "123456789012",
"NeweggItemNumber": "9SIAWE50389432",
"Currency": "USD",
"MSRP": "99.99",
"MAP": "5.00",
"SellingPrice": "9.99",
"Shipping": "Default",
"Inventory": "99",
"ItemCondition": "New",
"ActivationMark": "True",
"PacksOrSets": "1"
}
}
}
]
}
}
}
Batch updating the basic information for items without specifying item subcategory
Attribute
Format
Description
Require
d
DocumentVersion
Decimal
The identifier for the version of current datafeed;
assigned by Newegg
Y
MessageType
String
BatchItemCreation
Y
Message
Itemfeed
Item
Action
String
Specify the action you would like to perform.
- Enter "Update Item" to update the
information of a product already in your item
list (does not include updating of pricing fields:
Currency, MSRP, MAP, Selling Price, Shipping,
Inventory and Activation Mark)
Y
228
- Enter "Update/Append Image" to upload
additional image(s) of the product or overwrite
existing image(s).
- Enter "Replace Image" to replace all of your
existing images with the image URL's provided
in this file. When this action is selected, the
system will only process the Item Images field
and Activation Mark; all other information,
including Selling Price, will be ignored.
BasicInfo
SellerPartNumber
String
A seller-defined unique identifier for an item. An
alphanumeric string, max 40 characters including
space
Y
WebsiteShortTitle
String
The short, easily identifiable item name for this
item. It will be used as the main name for your
product on all store pages, Sales Orders and
receipts, so should not contain variables. Maximum
characters: 200.
N
BulletDescription
String
Enter concise descriptions of selected product
features or functions which will be listed by bullet
point below the website short/long title on the
product page.
An alphanumeric string. Use separator “^^” to
separate different points. Maximum characters:
200, including spaces and separators. NO HTML is
allowed.
N
ProductDescription
String
The detailed description to be featured on the item
page. This description should state the features and
functions of the product. Should be the same for all
items in product family. (4000 character limit.)
Accepted HTML for Product Description fields.
Only <ol>,<ul>, <li>,<br>, <p>, <b>, <i>, <u>,
<em>, <strong>, <sub>, <sup> are allowed.
N
ItemDimension
ItemLength
Decimal
Individual unit shipping length in inches
N
ItemWidth
Decimal
Individual unit shipping width in inches
N
ItemHeight
Decimal
Individual unit shipping height in inches
N
ItemWeight
Decimal
Individual unit shipping weight in lb.
Y
ActivationMark
String
The ActivationMark's default setting is "True" on all
uploaded products because all products must be
activated to be visible on Newegg websites. You may
N
229
set it to "False" if you wish to deactivate your
product.
ItemImages
Image
ImageUrl
String
Enter the URL for this item's product images. All
URLs must be a direct link to the actual image. Image
file must be (.jpg or .jpeg). An alphanumeric string;
2000 characters maximum in length.
Minimum image size: 640 pixels width and 480
pixels height.
The maximum file size for each image is 5MB. All
files larger than the 5MB limit will fail to process.
N
IsPrimary
Boolean
The identifier to specify the default image, if
multiple images will be uploaded.
N
ConditionDetails
String
Information related to the condition, not including
New or Refurbished, of the product can be
described here to help customer understanding the
product.
NOTE: This information only apply to U.S.
Marketplace
N
UsedItemImages
Image
ImageUrl
String
Item images of your item to better describe the
characteristics of used condition. This image(s)
should not be images of a new item.
Enter the URL for the USED item's specified product
images. All URLs must be a direct link to the actual
image. Image file must be (.jpg or .jpeg)
Minimum image size: 640 pixels width and 480
pixels height.
The maximum file size for each image is 5MB. All
files larger than the 5MB limit will fail to process.
NOTE: This information only apply to U.S.
Marketplace
N
IsPrimary
Boolean
The identifier to specify the default image, if
multiple images will be uploaded.
NOTE: This information only apply to U.S.
Marketplace
N
Warning
Prop65
String
Used if the product is subject to prop 65 regulations
in California.
N
Prop65Motherboard
String
Used if the product is motherboard related subject
to prop 65 regulations in California.
N
CountryOfOrigin
String
Country of Origin is the country of manufacture/
production of your items. Newegg only accept ISO
N
230
standard three-letter codes for the various countries
of the world. For complete list, please refer to the
following: http://en.wikipedia.org/wiki/ISO_3166-
1_alpha-3
Please note: this value is required if you intend to
sell your items globally through Newegg.
OverAge18Verification
String
Used if the product contains graphics or adult
content that is inappropriate for person under 18
years old.
N
ChokingHazard
String
Choking Hazard Warning Requirements for
Children's Toys and Games
You may select up to four of these six warnings. You
should never need to choose more than four
warnings, as a warning that a product "contains" a
small ball or marble should not apply
simultaneously with the corresponding warning
that a product "is" a small ball or marble.
Please refer to Consumer product Safety
Improvement Act of 2008 (CPSIA) for more
information.
N
Example: XML, Request
XSD
API Schema > DataFeedMgmt > DataFeedSchema > ItemUpdate.xsd
POST
https://api.newegg.com/marketplace/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype=
ITEM_DATA
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggEnvelope>
<Header>
<DocumentVersion>3.0</DocumentVersion>
</Header>
<MessageType>BatchItemCreation</MessageType>
<Message>
<Itemfeed>
<Item>
231
<Action>Update Item</Action>
<BasicInfo>
<SellerPartNumber>A006Leon_Test_001</SellerPartNumber>
<WebsiteShortTitle>Test for Leon</WebsiteShortTitle>
<WebsiteLongTitle/>
<ProductDescription>Test for Leon</ProductDescription>
<ItemDimension>
<ItemLength>2.0</ItemLength>
<ItemWidth>2.0</ItemWidth>
<ItemHeight>2.0</ItemHeight>
</ItemDimension>
<ItemWeight>2.0</ItemWeight>
<ActivationMark>False</ActivationMark>
<ItemImages>
<Image>
<ImageUrl>url</ImageUrl>
<IsPrimary>True</IsPrimary>
</Image>
</ItemImages>
<ConditionDetails>Works fine, almost like new, missing original plastics cover
</ConditionDetails>
<UsedItemImages>
<Image>
<ImageUrl>http://10.1.24.143:4567/images/Used.gif</ImageUrl>
</Image>
</UsedItemImages>
<Warning>
<Prop65>No</Prop65>
<Prop65Motherboard>Yes</Prop65Motherboard>
<CountryOfOrigin>USA</CountryOfOrigin>
<OverAge18Verification>No</OverAge18Verification>
<ChokingHazard>
<SmallParts>Yes</SmallParts>
<SmallBall>Is a small ball</SmallBall>
<Balloons>Yes</Balloons>
<Marble>Contains a marble</Marble>
</ChokingHazard>
</Warning>
</BasicInfo>
</Item>
<Item>
232
<Action>Update Item</Action>
<BasicInfo>
<SellerPartNumber>A006Leon_Test_002</SellerPartNumber>
<WebsiteShortTitle>Test for Leon</WebsiteShortTitle>
<WebsiteLongTitle/>
<ProductDescription>Test for Leon</ProductDescription>
<ItemDimension>
<ItemLength>2.0</ItemLength>
<ItemWidth>2.0</ItemWidth>
<ItemHeight>2.0</ItemHeight>
</ItemDimension>
<ItemWeight>2.0</ItemWeight>
<ActivationMark>False</ActivationMark>
<ItemImages>
<Image>
<ImageUrl>url</ImageUrl>
<IsPrimary>True</IsPrimary>
</Image>
</ItemImages>
<Warning>
<Prop65>No</Prop65>
<Prop65Motherboard>Yes</Prop65Motherboard>
<OverAge18Verification>No</OverAge18Verification>
<ChokingHazard>
<SmallParts>Yes</SmallParts>
<SmallBall>Is a small ball</SmallBall>
<Balloons>Yes</Balloons>
<Marble>Contains a marble</Marble>
</ChokingHazard>
</Warning>
</BasicInfo>
</Item>
<Item>
<Action>Update Item</Action>
<BasicInfo>
<SellerPartNumber>A006Leon_Test_003</SellerPartNumber>
<WebsiteShortTitle>Test for Leon</WebsiteShortTitle>
<WebsiteLongTitle/>
<ProductDescription>Test for Leon</ProductDescription>
<ItemDimension>
<ItemLength>2.0</ItemLength>
233
<ItemWidth>2.0</ItemWidth>
<ItemHeight>2.0</ItemHeight>
</ItemDimension>
<ItemWeight>2.0</ItemWeight>
<ActivationMark>False</ActivationMark>
<ItemImages>
<Image>
<ImageUrl>url</ImageUrl>
<IsPrimary>True</IsPrimary>
</Image>
</ItemImages>
<Warning>
<Prop65>No</Prop65>
<Prop65Motherboard>Yes</Prop65Motherboard>
<OverAge18Verification>No</OverAge18Verification>
<ChokingHazard>
<SmallParts>Yes</SmallParts>
<SmallBall>Is a small ball</SmallBall>
<Balloons>Yes</Balloons>
<Marble>Contains a marble</Marble>
</ChokingHazard>
</Warning>
</BasicInfo>
</Item>
</Itemfeed>
</Message>
</NeweggEnvelope>
Example: Json, Request
POST
https://api.newegg.com/marketplace/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype=
ITEM_DATA
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"NeweggEnvelope": {
"Header": { "DocumentVersion": "3.0" },
234
"MessageType": "BatchItemCreation",
"Message": {
"Itemfeed": {
"Item": [
{
"Action": "Update Item",
"BasicInfo": {
"SellerPartNumber": "A006Leon_Test_001",
"WebsiteShortTitle": "Test for Leon",
"ProductDescription": "Test for Leon",
"ItemDimension": {
"ItemLength": "2.0",
"ItemWidth": "2.0",
"ItemHeight": "2.0"
},
"ItemWeight": "2.0",
"ActivationMark": "False",
"ItemImages": {
"Image": {
"ImageUrl": "url",
"IsPrimary": "True"
}
},
"ConditionDetails": "Works fine, almost like new, missing original plastics cover ",
"UsedItemImages": {
"Image": { "ImageUrl": "http://10.1.24.143:4567/images/Used.gif" }
},
"Warning": {
"Prop65": "No",
"Prop65Motherboard": "Yes",
"CountryOfOrigin": "USA",
"OverAge18Verification": "No",
"ChokingHazard": {
"SmallParts": "Yes",
"SmallBall": "Is a small ball",
"Balloons": "Yes",
"Marble": "Contains a marble"
}
}
}
},
235
{
"Action": "Update Item",
"BasicInfo": {
"SellerPartNumber": "A006Leon_Test_002",
"WebsiteShortTitle": "Test for Leon",
"ProductDescription": "Test for Leon",
"ItemDimension": {
"ItemLength": "2.0",
"ItemWidth": "2.0",
"ItemHeight": "2.0"
},
"ItemWeight": "2.0",
"ActivationMark": "False",
"ItemImages": {
"Image": {
"ImageUrl": "url",
"IsPrimary": "True"
}
},
"Warning": {
"Prop65": "No",
"Prop65Motherboard": "Yes",
"OverAge18Verification": "No",
"ChokingHazard": {
"SmallParts": "Yes",
"SmallBall": "Is a small ball",
"Balloons": "Yes",
"Marble": "Contains a marble"
}
}
}
},
{
"Action": "Update Item",
"BasicInfo": {
"SellerPartNumber": "A006Leon_Test_003",
"WebsiteShortTitle": "Test for Leon",
"ProductDescription": "Test for Leon",
"ItemDimension": {
"ItemLength": "2.0",
"ItemWidth": "2.0",
236
"ItemHeight": "2.0"
},
"ItemWeight": "2.0",
"ActivationMark": "False",
"ItemImages": {
"Image": {
"ImageUrl": "url",
"IsPrimary": "True"
}
},
"Warning": {
"Prop65": "No",
"Prop65Motherboard": "Yes",
"OverAge18Verification": "No",
"ChokingHazard": {
"SmallParts": "Yes",
"SmallBall": "Is a small ball",
"Balloons": "Yes",
"Marble": "Contains a marble"
}
}
}
}
]
}
}
}
}
INVENTORY_DATA
For schema, please download the XSD’s and XML sample files from
https://sellerportal.newegg.com/Guideline/Newegg_Marketplace_API_DeveloperGuide.zip
The following information provides element definitions. You can also contact Newegg Marketplace Integration team:
Datafeeds@newegg.com for assistance.
Attribute
Format
Description
Required
DocumentVersion
Decimal
2.0
Y
MessageType
String
Inventory
Y
237
Message
Inventory
Item
SellerPartNumber
String
A seller-defined unique identifier for an item. An alphanumeric
string, max 40 characters including space
Y
NeweggItemNumber
String
Neweggs unique identifier for an item
N
WarehouseLocation
String
The ISO standard 3-digit codes of the country where your
warehouse is located. Please download the following to review
details:
http://promotions.newegg.com/marketplace/sellers/resourceLibra
ry/International%20Country%20Guide.pdf
NOTE: Submissions with incorrect values will error-out.
Y
FulfillmentOption
String
Available value:
Seller
N
Inventory
Integer
Inventory quantity in sellers warehouse.
Y
Example: XML, Request
XSD
API Schema > DataFeedMgmt > DataFeedSchema > InventoryUpdate.xsd
POST https://api.newegg.com/marketplace/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype=INVENTORY_DATA
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<?xml version="1.0" encoding="UTF-8"?>
<NeweggEnvelope xsi:noNamespaceSchemaLocation="BatchInventoryUpdate.xsd"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Header>
<DocumentVersion>2.0</DocumentVersion>
<!--The identifier for the very of current feed; assigned by Newegg-->
</Header>
<MessageType>Inventory</MessageType>
<Message>
<Inventory>
<Item>
<SellerPartNumber>a006-test-001</SellerPartNumber>
<!--A seller-defined unique identifier for an item. An alphanumeric string, max 40
characters including space-->
<NeweggItemNumber>9SIAWE50008504</NeweggItemNumber>
<!Neweggs unique identifier for an item-->
<WarehouseLocation>USA</WarehouseLocation>
238
<!--The ISO standard 3-digit codes of the country where your warehouse is located.
If left blank, default value will be All. -->
<FulfillmentOption>Seller</FulfillmentOption>
<!--The shipped by seller inventory in your [xxx] warehouse. -->
<Inventory>200</Inventory>
<!--The inventory in seller’s warehouse. -->
</Item>
</Inventory>
</Message>
</NeweggEnvelope>
Example: Json, Request
POST https://api.newegg.com/marketplace/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype=INVENTORY_DATA
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"NeweggEnvelope": {
"-xmlns:xsi": "http://www.w3.org/2001/XMLSchema-instance",
"-xsi:noNamespaceSchemaLocation": "BatchInventoryUpdate.xsd",
"Header": { "DocumentVersion": "2.0" },
"MessageType": "Inventory",
"Message": {
"Inventory": {
"Item": {
"SellerPartNumber": "a006-test-001",
"NeweggItemNumber": "9SIAWE50008504",
"WarehouseLocation": "USA",
"FulfillmentOption": "Seller",
"Inventory": "200"
}
}
}
}
}
239
PRICE_DATA
For schema, please download the XSD’s and XML sample files from
https://sellerportal.newegg.com/Guideline/Newegg_Marketplace_API_DeveloperGuide.zip
The following information provides element definitions. You can also contact Newegg Marketplace Integration team:
Datafeeds@newegg.com for assistance.
Attribute
Format
Description
Required
DocumentVersion
Decimal
2.0
Y
MessageType
String
Price
Y
Message
Inventory
Item
SellerPartNumb
er
String
A seller-defined unique identifier for an item. An alphanumeric
string, max 40 characters including space
Y
NeweggItemNu
mber
String
Neweggs unique identifier for an item
N
CountryCode
String
The target country you will be selling your items to. Only the ISO
standard 3-digit codes are accepted.
To review the complete list of available values, please download
the following:
https://promotions.newegg.com/Marketplace/Sellers/resourceLibr
ary/International%20Country%20Guide.pdf
NOTE: Item price must be submitted with the correct currency code
based on ship-to destination country code. Submissions with
incorrect combinations will error-out.
Y
Currency
String
The currency is to identify the Selling Price, MSRP, MAP for the
target country you will be selling your items to. Only the ISO
standard 3-digit codes are accepted. The default value will be USD
if left blank. To review the complete list of available values, please
download the following:
https://promotions.newegg.com/Marketplace/Sellers/resourceLib
rary/International%20Country%20Guide.pdf
NOTE: Correct currency code must be submitted based on ship-to
destination country code. Submissions with incorrect combinations
will error-out.
Y
240
MSRP
Decimal
Manufacturer's suggested retail price for the product.
If you want to remove MSRP, input “0.00” or ‘0’ in this field. If null,
no change to current setting.
N
MAP
Decimal
Minimum advertised price.
If the Selling Price is below the defined MAP, the website will ask
customer to add item to shopping cart to see the item's price.
If you want to remove MAP, input “0.00” or ‘0’ in this field. If null,
no change to current setting.
N
CheckoutMAP
String
Regardless the Selling Price and the value inputted in MAP field, if
the Checkout MAP is marked as True, then the website will ask
customer to add item to shopping cart AND go to checkout page to
see the item's price.
N
SellingPrice
Decimal
The selling price
N
Shipping
String
The shipping charge setting for this item.
N
ActivationMark
String
True: Activate item
False: Deactivate item
Null = Ignore this action, no change to current item
active/deactivate setting
N
Example: XML, Request
XSD
API Schema > DataFeedMgmt > DataFeedSchema > PriceUpdate.xsd
POST https://api.newegg.com/marketplace/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype=PRICE_DATA
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<?xml version="1.0" encoding="UTF-8"?>
<NeweggEnvelope xsi:noNamespaceSchemaLocation="NeweggEnvelop.xsd"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Header>
<DocumentVersion>2.0</DocumentVersion>
<!--The identifier for the very of current feed; assigned by Newegg-->
</Header>
<MessageType>Price</MessageType>
<Message>
<Price>
<Item>
241
<SellerPartNumber>a006-test-001</SellerPartNumber>
<!--A seller-defined unique identifier for an item. An alphanumeric string, max 40
characters including space-->
<NeweggItemNumber>9SIAWE50008504</NeweggItemNumber>
<!--Newegg’s unique identifier for an item-->
<CountryCode>USA</CountryCode>
<Currency>USD</Currency>
<!--The form of money for all price related elements. -->
<MSRP>100.00</MSRP>
<!--Manufacturer's suggested retail price for the product. -->
<MAP>9.99</MAP>
<CheckoutMAP>True</CheckoutMAP>
<SellingPrice>100.00</SellingPrice>
<Shipping>default</Shipping>
<!--The shipping charge setting for this item. -->
<ActivationMark>True</ActivationMark>
<!--The ActivationMark's default setting is True on all uploaded products because
all products must be activated to be visible on Newegg websites. -->
</Item>
</Price>
</Message>
</NeweggEnvelope>
Example: Json, Request
POST https://api.newegg.com/marketplace/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype=PRICE_DATA
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"NeweggEnvelope": {
"-xmlns:xsi": "http://www.w3.org/2001/XMLSchema-instance",
"-xsi:noNamespaceSchemaLocation": "NeweggEnvelop.xsd",
"Header": { "DocumentVersion": "2.0" },
"MessageType": "Price",
"Message": {
"Price": {
"Item": {
"SellerPartNumber": "a006-test-001",
242
"NeweggItemNumber": "9SIAWE50008504",
"CountryCode": "USA",
"Currency": "USD",
"MSRP": "100.00",
"MAP": "9.99",
"CheckoutMAP": "True",
"SellingPrice": "100.00",
"Shipping": "default",
"ActivationMark": "True"
}
}
}
}
}
ORDER_SHIP_NOTICE_DATA
ORDER_SHIP_NOTICE_DATA feed allows you to update shipment of one or all items in an order. When an order has been
completely fulfilled, mean that all the items are fulfilled, the order process is completed.
Please review the following example and the possible shipment options you can assign for each feed:
Order XYZ has item A (5 units) and item B (1 unit)
Single package contains 5 units of item A and 1 unit of item B with one tracking number.
Single package contains either 5 units of item A or 1 unit of item B with one tracking number.
Mutile packages: one package contains 5 units of item A with one tracking number. The other package contains 1
unit of item B with another tracking number.
Multiple package: one package contains 2 units of item A with one tracking number. Another package contains 3
units of item A with another tracking number. The other package contains 1 unit of item B with another tracking
number.
Multiple package, 1 package contains 2 units of item A with one tracking number. The other package contains 3
units of item A and 1 unit of item B with another tracking number.
You cannot submit a request for partial shipment as following: Single package contains 2 units of item A with
one tracking number.
For schema, please download the XSD’s and XML sample files from
https://sellerportal.newegg.com/Guideline/Newegg_Marketplace_API_DeveloperGuide.zip.
The following information provides element definitions. You can also contact Newegg Marketplace Integration team:
Datafeeds@newegg.com for assistance.
243
Example: XML, Request
XSD
API Schema > DataFeedMgmt > DataFeedSchema > ShipNotice.xsd
POST
https://api.newegg.com/marketplace/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype=ORDER_SHIP_NOTICE_DATA
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggEnvelope>
<Header>
<DocumentVersion>1.0</DocumentVersion>
</Header>
<MessageType>ShipNotice</MessageType>
<Message>
<ShipNotice>
Attribute
Format
Description
Required
DocumentVersion
Decimal
The identifier for the version of current datafeed;
assigned by Newegg
Y
MessageType
String
ShipNotice
Y
Message
ShipNotice
Package
OrderNumber
String
Neweggs unique identifier for an order
Y
ItemInform
ation
Item
SellerPartNumber
String
A seller-defined unique identifier for an item.
Y
NeweggItemNumber
String
Neweggs unique identifier for an item
N
ShippedQuantity
Integer
Number of units the item was shipped
Y
ActualShippingCarrier
String
The shipping carrier of this package when seller
ships the package.
Acceptable values:
UPS
UPS MI
FedEx
USPS
DHL
Other
Y
ActualShippingMethod
String
The shipping method of this package when seller
ships the package. Example: UPS Ground
Y
TrackingNumber
String
The tracking number of this package
Y
244
<Package>
<OrderNumber>11006035</OrderNumber>
<ItemInformation>
<Item>
<SellerPartNumber>data_MP_329_00976</SellerPartNumber>
<NeweggItemNumber>9SIAWES000CY64</NeweggItemNumber>
<ShippedQuantity>1</ShippedQuantity>
</Item>
<Item>
<SellerPartNumber>data_MP_329_00975</SellerPartNumber>
<NeweggItemNumber>9SIAWES000CY58</NeweggItemNumber>
<ShippedQuantity>2</ShippedQuantity>
</Item>
<Item>
<SellerPartNumber>data_MP_329_00974</SellerPartNumber>
<NeweggItemNumber>9SIAWES000CY53</NeweggItemNumber>
<ShippedQuantity>1</ShippedQuantity>
</Item>
<Item>
<SellerPartNumber>data_MP_32900973</SellerPartNumber>
<NeweggItemNumber>9SIAWES000CY49</NeweggItemNumber>
<ShippedQuantity>1</ShippedQuantity>
</Item>
<Item>
<SellerPartNumber>data_MP_32900972</SellerPartNumber>
<NeweggItemNumber>9SIAWES000CY45</NeweggItemNumber>
<ShippedQuantity>2</ShippedQuantity>
</Item>
</ItemInformation>
<ActualShippingCarrier>UPS</ActualShippingCarrier>
<ActualShippingMethod>UPS Ground</ActualShippingMethod>
<TrackingNumber>20110922002</TrackingNumber>
</Package>
</ShipNotice>
</Message>
</NeweggEnvelope>
Example: Json, Request
POST https://api.newegg.com/marketplace/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype=ORDER_SHIP_NOTICE_DATA
245
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"NeweggEnvelope": {
"Header": { "DocumentVersion": "1.0" },
"MessageType": "ShipNotice",
"Message": {
"ShipNotice": {
"Package": {
"OrderNumber": "11006035",
"ItemInformation": {
"Item": [
{
"SellerPartNumber": "data_MP_329_00976",
"NeweggItemNumber": "9SIAWES000CY64",
"ShippedQuantity": "1"
},
{
"SellerPartNumber": "data_MP_329_00975",
"NeweggItemNumber": "9SIAWES000CY58",
"ShippedQuantity": "2"
},
{
"SellerPartNumber": "data_MP_329_00974",
"NeweggItemNumber": "9SIAWES000CY53",
"ShippedQuantity": "1"
},
{
"SellerPartNumber": "data_MP_32900973",
"NeweggItemNumber": "9SIAWES000CY49",
"ShippedQuantity": "1"
},
{
"SellerPartNumber": "data_MP_32900972",
"NeweggItemNumber": "9SIAWES000CY45",
"ShippedQuantity": "2"
}
]
246
},
"ActualShippingCarrier": "UPS",
"ActualShippingMethod": "UPS Ground",
"TrackingNumber": "20110922002"
}
}
}
}
}
MULTICHANNEL_ORDER_DATA
For schema, please download the XSD’s and XML sample files from
https://sellerportal.newegg.com/Guideline/Newegg_Marketplace_API_DeveloperGuide.zip
The following information provides element definitions. You can also contact Newegg Marketplace Integration team:
Datafeeds@newegg.com for assistance.
Element Name
Description
Required
OrderDate
The date when the order was placed
Y
SalesChannel
A label assigned by the seller to identify the sales channel.
This helps to distinguish orders with identical Order ID but from different sales
channels.
Y
SellerOrderID
An identifier for the order, assigned by the seller
Y
ShippingMethod
Order's shipping method
Y
ShipToFirstName
Ship to recipient's First Name
Y
ShipToLastName
Ship to recipient's Last Name
Y
ShipToCompany
Ship to company name
N
ShipToAddressLine1
Ship to address line 1
NOTE: SBN (Shipped by Newegg) service will only accept shipments to a valid
street address. We do not deliver to P.O. Box.
Y
ShipToAddressLine2
Ship to address line 2
NOTE: SBN (Shipped by Newegg) service will only accept shipments to a valid
street address. We do not deliver to P.O. Box.
N
ShipToCity
Ship to City
Y
ShipToState
Ship to State
Y
ShipToPostalCode
Ship to Zip code
Y
247
ShipToCountry
Ship to Country - For now, Newegg Marketplace is only limited to United States. If
left blank will default to USA
N
ShipToPhoneNumber
Ship to Person's phone number
Y
SellerPartNumber
The seller part # that was assigned to this item.
Y
NeweggItemNumber
The Newegg Item # for this item
N
Quantity
The number of units for the particular item in the order.
Y
Example: XML, Request
XSD
API Schema > DataFeedMgmt > DataFeedSchema > MultiChannelOrder.xsd
POST
https://api.newegg.com/marketplace/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype=MULTICHANNEL_ORDER_DATA
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggEnvelope>
<Header>
<DocumentVersion>1.0</DocumentVersion>
</Header>
<MessageType>MultiChannelOrderCreation</MessageType>
<Message>
<MultiChannelOrder>
<Order>
<OrderDate>05/30/2013</OrderDate>
<SalesChannel>3rd channel</SalesChannel>
<SellerOrderID>2153930</SellerOrderID>
<ShippingMethod>Expedited Shipping (3-5 business days)</ShippingMethod>
<ShipToFirstName>Carol</ShipToFirstName>
<ShipToLastName>Chaste</ShipToLastName>
<ShipToCompany/>
<ShipToAddressLine1>248 River Trace Ct</ShipToAddressLine1>
<ShipToAddressLine2/>
<ShipToCity>McDonough</ShipToCity>
<ShipToState>GA</ShipToState>
<ShipToPostalCode>30253</ShipToPostalCode>
<ShipToCountry>USA</ShipToCountry>
248
<ShipToPhoneNumber>770-898-1921</ShipToPhoneNumber>
<ItemList>
<Item>
<SellerPartNumber>PTV3000-100NAS</SellerPartNumber>
<NeweggItemNumber/>
<Quantity>10</Quantity>
</Item>
<Item>
<SellerPartNumber>CTB-212312S</SellerPartNumber>
<NeweggItemNumber/>
<Quantity>20</Quantity>
</Item>
</ItemList>
</Order>
</MultiChannelOrder>
</Message>
</NeweggEnvelope>
Example: Json, Request
POST
https://api.newegg.com/marketplace/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype=MultiChannel_Order_DATA
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"-xmlns:xsi": "http://www.w3.org/2001/XMLSchema-instance",
"Header": { "DocumentVersion": "1.0" },
"MessageType": "MultiChannelOrderCreation",
"Message": {
"MultiChannelOrder": {
"Order": {
"OrderDate": "05/30/2013",
"SalesChannel": "3rd channel",
"SellerOrderID": "2153930",
"ShippingMethod": "Expedited Shipping (3-5 business days)",
"ShipToFirstName": "Carol",
"ShipToLastName": "Chaste",
"ShipToAddressLine1": "248 River Trace Ct",
249
"ShipToCity": "McDonough",
"ShipToState": "GA",
"ShipToPostalCode": "30253",
"ShipToCountry": "USA",
"ShipToPhoneNumber": "770-898-1921",
"ItemList": {
"Item": [
{
"SellerPartNumber": "PTV3000-100NAS",
"Quantity": "10"
},
{
"SellerPartNumber": "CTB-212312S",
"Quantity": "20"
}
]
}
}
}
}
}
ITEM_SUBSCRIPTION
Subscribe and Save is Newegg’s subscription service. It is available for most items in different categories. This program
allows customers to subscribe to certain items for repeat uses and have them shipped every few months with certain
percentage of discount.
Note: by submitting your item list, all listed items will be automatically join/leave all the ongoing Newegg
subscription programs.
For schema, please download the XSD’s and XML sample files from
https://sellerportal.newegg.com/Guideline/Newegg_Marketplace_API_DeveloperGuide.zip
The following information provides element definitions. You can also contact Newegg Marketplace Integration team:
Datafeeds@newegg.com for assistance.
Attribute
Format
Description
Required
DocumentVersion
Decimal
The identifier for the version of current
datafeed; assigned by Newegg
Y
MessageType
String
Subscription
Y
Mes
sage
Item
SellerPartNumber
String
Identify the category specification. There
is only one category can be used for any
Y
250
single item.
Action
String
Specify the action you would like to
perform.
- Enter "Add" if you want to add the
item as a subscription & save
product.
- Enter "Remove" to change the item
from a Subscription & Save item to a
normal product.
If no value was entered for this field, by
default the system will treat it as “Add”.
Y
Example: XML, Request
XSD
API Schema > DataFeedMgmt > DataFeedSchema > ItemSubscription.xsd
POST https://api.newegg.com/marketplace/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype=ITEM_SUBSCRIPTION
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggEnvelope>
<Header>
<DocumentVersion>1.0</DocumentVersion>
</Header>
<MessageType>Subscription</MessageType>
<Message>
<Item>
<SellerPartNumber>JACKETEST0921001004</SellerPartNumber>
<Action>Add</Action>
</Item>
<Item>
<SellerPartNumber>JACKETEST0921001003</SellerPartNumber>
<Action>Remove</Action>
</Item>
</Message>
</NeweggEnvelope>
251
Example: Json, Request
POST https://api.newegg.com/marketplace/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype= ITEM_SUBSCRIPTION
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"NeweggEnvelope": {
"Header": { "DocumentVersion": "1.0" },
"MessageType": "Subscription",
"Message": {
"Item": [
{
"SellerPartNumber": "JACKETEST0921001004",
"Action": "Add"
},
{
"SellerPartNumber": "JACKETEST0921001003",
"Action": "Remove"
}
]
}
}
}
VOLUME_DISCOUNT_DATA (Create, Update, Delete Volume Discount)
For schema, please download the XSD’s and XML sample files from
https://sellerportal.newegg.com/Guideline/Newegg_Marketplace_API_DeveloperGuide.zip
The following information provides element definitions. You can also contact Newegg Marketplace Integration team:
Datafeeds@newegg.com for assistance.
Attribute
Format
Description
Require
252
d
DocumentVersion
Decimal
The identifier for the version of current
datafeed; assigned by Newegg
Y
MessageType
String
VolumeDiscount
Y
Message
VolumeDiscountList
ItemVolumeDiscountInfo
SellerPartNumber
String
A seller-defined unique identifier for an item. An
alphanumeric string, max 40 characters
including space
Y
NeweggItemNumber
String
Neweggs unique identifier for an item
N
VolumeActivation
String
Two actions are available:
True: Add / Update
False: Remove.
The default setting is "True". You may set it to
"False" if you wish to remove the existing
volume discount.
Y
DiscountSetting
Tier
Priority
int
Set the tier for the volume discount.
Y
Quantity
int
Set the quantity for the tier's volume discount.
Y
SellingPrice
Decimal
Set the unit price for the tier's volume discount.
Y
EnableFreeShipping
Decimal
Set a shipping method for the tier's volume
discount. The acceptable shipping method:
0:Default
1:Free.
Y
Example: XML, Request
XSD
API Schema > DataFeedMgmt > DataFeedSchema > VolumeDiscount.xsd
POST
https://api.newegg.com/marketplace/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype=VOLUME_DISCOU
NT_DATA
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggEnvelope>
<Header>
<DocumentVersion/>
</Header>
<MessageType/>
<Message>
253
<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>
254
<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>
255
<VolumeActivation>False</VolumeActivation>
</ItemVolumeDiscountInfo>
</VolumeDiscountList>
</Message>
</NeweggEnvelope>
Example: Json, Request
POST
https://api.newegg.com/marketplace/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype=VOLUME_DISCOU
NT_DATA
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"NeweggEnvelope": {
"Header": {
"DocumentVersion": ""
},
"MessageType": "",
"Message": {
"VolumeDiscountList": {
"ItemVolumeDiscountInfo": [
{
"SellerPartNumber": "Lisa123",
"NeweggItemNumber": "9SIA0060004762",
"VolumeActivation": "True",
"DiscountSetting": {
"Tier": [
{
"Priority": "1",
"Quantity": "10",
"SellingPrice": "9999.99",
"EnableFreeShipping": "0"
},
{
"Priority": "2",
"Quantity": "20",
256
"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": {
257
"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"
}
]
}
}
}
}
ITEM_PROMOTION_DATA
Newegg marketplace offers a lot of promotion strategies to help sellers increase their sales, in order to better organize the deals,
seller is able to batch submit the requests to our deal center. Our promotion team will review the request and find the best place
where the promotion could be seen by customers.
258
For schema, please download the XSD’s and XML sample files from
https://sellerportal.newegg.com/Guideline/Newegg_Marketplace_API_DeveloperGuide.zip
The following information provides element definitions. You can also contact Newegg Marketplace Integration team:
Datafeeds@newegg.com for assistance.
Attribute
Format
Description
Required
DocumentVersion
Decimal
The identifier for the version of current
datafeed; assigned by Newegg
Y
MessageType
String
ItemPromotion
Y
Message
Item
TabID
Integer
This Tab ID is NOT required. If you left this
empty all requests will go to "Marketplace Deal
Center"(You can see this tab on Seller Portal ->
Manage Promotion -> Submit Deals page) . Our
promotion team will review the request and
once the request gets approved, will assign an
appropriate promotion vehicle for the item.
If you already know the Tab ID, you can specify
it here and the request will be added in the tab
group on Newegg marketplace hot deals page
(http://www.newegg.com/marketplace/deals).
Also you can find the Tab's information on
Seller Portal -> Manage Promotion -> Submit
Deals page.
N
SellerPartNumber
String
The seller part # is the SKU number assigned to
this item by seller.
Y
NeweggItemNumber
String
The Newegg Item # for this item
N (Yes if
SellerPartNumber
is not provided)
PromoMSRP
Decimal
The manufacturers suggested retail price
(MSRP) or list price for the item during the
promotion.
N
PromoSellingPrice
Decimal
The actual price at which the item is offered for
the promotion.
Y
PromoShipping
String
The shipping setting for the item during the
promotion, the available two options are
default and free
Y
PromoStartDate
Datetime
The date when the promotion will be starting.
Format: mm/dd/yyyy. The default time is
12:00:00 AM.
Y
259
PromoEndDate
Datetime
The date when the promotion will be end.
Format: mm/dd/yyyy. The default time is
11:59:00 PM
Y
LimitQty
Integer
The maximum quantity this item can be
purchased by a customer
within a 48 hour time period.
If left empty, there will be no quantity
limitation.
N
MaxQty
Integer
The maximum quantity that can be sold for this
item during this promotion period. Please note
that once the promotion schedule has started,
this value cannot be updated.
If left empty, there will be no quantity
limitation.
N
MinInventory
Integer
The minimum inventory level. The level below
which inventory can never drop 24 hours prior
to promotion start time. The inventory updates
via datafeeds / API / seller portal will not be
processed if the updates are less than this
value. You can freely update inventory 24 hours
after promotion start time. For urgent
inventory adjustment please contact Newegg
Marketplace Integration team:
Datafeeds@newegg.com for assistance.
The default value is 0. This field is usable only
when "Inventory Locked" = true.
N
Inventory Locked
String
If set with Yes, any inventory update via
datafeeds / API / seller portal will not be
processed if request to update inventory less
than the value in "Min Inventory. For urgent
inventory adjustment please contact Newegg
Marketplace Integration team:
Datafeeds@newegg.com for assistance.
The default is No.
N
Note
String
The additional message or memo you want to
create with this request. 200 characters limit.
N
260
Example: XML, Request
XSD
API Schema > DataFeedMgmt > DataFeedSchema > ItemPromotion.xsd
POST https://api.newegg.com/marketplace/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype=ITEM_PROMOTION_DATA
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggEnvelope>
<Header>
<DocumentVersion>1.0</DocumentVersion>
</Header>
<MessageType>ItemPromotion</MessageType>
<Message>
<Item>
<SellerPartNumber>1234567</SellerPartNumber>
<NeweggItemNumber>9SI600185746359</NeweggItemNumber>
<PromoMSRP>290.99</PromoMSRP>
<PromoSellingPrice>190.99</PromoSellingPrice>
<PromoShipping>Free</PromoShipping>
<PromoStartDate>07/27/2014</PromoStartDate>
<PromoEndDate>08/01/2014</PromoEndDate>
<LimitQty>20</LimitQty>
<MaxQty>1000</MaxQty>
<MinInventory>0</MinInventory>
<InventoryLocked>No</InventoryLocked>
<Note>This is a promotion for Back to School</Note>
</Item>
<Item>
<SellerPartNumber>1234567</SellerPartNumber>
<NeweggItemNumber>9SI600185746359</NeweggItemNumber>
<PromoMSRP>290.99</PromoMSRP>
<PromoSellingPrice>190.99</PromoSellingPrice>
<PromoShipping>Free</PromoShipping>
<PromoStartDate>07/27/2014</PromoStartDate>
<PromoEndDate>08/10/2014</PromoEndDate>
<LimitQty>20</LimitQty>
261
<MaxQty>1000</MaxQty>
<MinInventory>0</MinInventory>
<InventoryLocked>No</InventoryLocked>
<Note/>
</Item>
</Message>
</NeweggEnvelope>
Example: Json, Request
POST https://api.newegg.com/marketplace/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype=ITEM_PROMOTION_DATA
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"NeweggEnvelope": {
"Header": { "DocumentVersion": "1.0" },
"MessageType": "ItemPromotion",
"Message": {
"Item": [
{
"SellerPartNumber": "1234567",
"NeweggItemNumber": "9SI600185746359",
"PromoMSRP": "290.99",
"PromoSellingPrice": "190.99",
"PromoShipping": "Free",
"PromoStartDate": "07/27/2014",
"PromoEndDate": "08/01/2014",
"LimitQty": "20",
"MaxQty": "1000",
"MinInventory": "0",
"InventoryLocked": "No",
"Note": "This is a promotion for Back to School"
},
{
"SellerPartNumber": "1234567",
"NeweggItemNumber": "9SI600185746359",
"PromoMSRP": "290.99",
"PromoSellingPrice": "190.99",
262
"PromoShipping": "Free",
"PromoStartDate": "07/27/2014",
"PromoEndDate": "08/10/2014",
"LimitQty": "20",
"MaxQty": "1000",
"MinInventory": "0",
"InventoryLocked": "No"
}
]
}
}
}
ITEM_PREMIER_MARK_DATA
Sellers who are qualified to participate in the program of Newegg Premier Order Fulfilled by Seller will be able to identify qualified
products using this function.
For schema, please download the XSD’s and XML sample files from
https://sellerportal.newegg.com/Guideline/Newegg_Marketplace_API_DeveloperGuide.zip
The following information provides element definitions. You can also contact Newegg Marketplace Integration team:
Datafeeds@newegg.com for assistance.
Attribute
Format
Description
Required
DocumentVersion
Decimal
The identifier for the version of current
datafeed; assigned by Newegg
Y
MessageType
String
BatchPremierMarkUpdate
Y
Message
Item
SellerPartNumber
String
A seller-defined unique identifier for an
item.
Y
PremierMark
String
TRUE Enroll this item in Newegg
Premier Program.
FALSE Remove this item from Newegg
Premier Program
Y
Example: XML, Request
XSD
API Schema > DataFeedMgmt > DataFeedSchema > PremierItemMark.xsd
POST https://api.newegg.com/marketplace/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype=ITEM_PREMIER_MARK_DATA
263
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggEnvelope>
<Header>
<DocumentVersion>1.0</DocumentVersion>
</Header>
<MessageType>BatchPremierMarkUpdate</MessageType>
<Message>
<Item>
<SellerPartNumber>JACKETEST0921001004</SellerPartNumber>
<PremierMark>FALSE</PremierMark>
</Item>
<Item>
<SellerPartNumber>JACKETEST0921001003</SellerPartNumber>
<PremierMark>TRUE</PremierMark>
</Item>
</Message>
</NeweggEnvelope>
Example: Json, Request
POST https://api.newegg.com/marketplace/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype=
ITEM_PREMIER_MARK_DATA
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"NeweggEnvelope": {
"Header": { "DocumentVersion": "1.0" },
"MessageType": "BatchPremierMarkUpdate",
"Message": {
"Item": [
{
"SellerPartNumber": "JACKETEST0921001004",
"PremierMark": "FALSE"
},
264
{
"SellerPartNumber": "JACKETEST0921001003",
"PremierMark": "TRUE"
}
]
}
}
}
ITEM_WARRANTY_DATA
Specifying warranty services on both refurbished and used items selling on Newegg Marketplace.
By submitting this template, you will be able to specify certain time period, 90 days for example, for the warranties on Parts and
Labor.
For schema, please download the XSD’s and XML sample files from
https://sellerportal.newegg.com/Guideline/Newegg_Marketplace_API_DeveloperGuide.zip
The following information provides element definitions. You can also contact Newegg Marketplace Integration team:
Datafeeds@newegg.com for assistance.
Attribute
Format
Description
Required
DocumentVersion
Decimal
The identifier for the version of current
datafeed; assigned by Newegg
Y
MessageType
String
BatchThirdPartyWarrantyUpdate
Y
Message
Item
SellerPartNumber
String
A seller-defined unique identifier for an
item.
Y
NeweggItemNumber
String
Neweggs unique identifier for an item
N
CountryCode
String
• ISO standard 3-digit codes of the
countries for Newegg international
program. Currently available values for
Newegg.com:
USA (Default)
AUS - Australia
GBR - United Kingdom
IND - India
IRL - Ireland
NLD - Netherlands
NZL - New Zealand
POL - Poland
N
265
SGP - Singapore
• Newegg.ca: CAN (Default)
• Neweggbusiness.com: USB (Default)
WarrantyDayCountParts
Integer
The period of day is available for the
warranty coverage of parts.
Any existing value can be removed by
using 0.
Y
WarrantyDayCountLabor
Integer
The period of day is available for the
warranty coverage of service labor.
Any existing value can be removed by
using 0.
Y
WarrantyProvidedBy
String
The name of warranty service provider.
Maximum characters: 200.
Y
SupportPhone
String
Service phone # of warranty service provider
Maximum characters: 40.
Y
SupportEmail
String
Email address of warranty service provider
Maximum characters: 100.
Y
SupportURL
String
Support URL of warranty service provider if
available.
Maximum characters: 250.
N
Example: XML, Request
XSD
API Schema > DataFeedMgmt > DataFeedSchema > ThirdPartyWarranty.xsd
POST https://api.newegg.com/marketplace/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype=ITEM_WARRANTY_DATA
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggEnvelope>
<Header>
<DocumentVersion>1.0</DocumentVersion>
</Header>
<MessageType>BatchThirdPartyWarrantyUpdate</MessageType>
<Message>
<Item>
<SellerPartNumber>321321654</SellerPartNumber>
<NeweggItemNumber>SIA00F3427624</NeweggItemNumber>
266
<CountryCode>USA</CountryCode>
<WarrantyDayCountParts>30</WarrantyDayCountParts>
<WarrantyDayCountLabor>30</WarrantyDayCountLabor>
<WarrantyProvidedBy>Newegg</WarrantyProvidedBy>
<SupportPhone>626-100-1000</SupportPhone>
<SupportEmail>example@newegg.com</SupportEmail>
<SupportURL>http://www.newegg.com</SupportURL>
</Item>
<Item>
<SellerPartNumber>321321655</SellerPartNumber>
<NeweggItemNumber>SIA00F3427625</NeweggItemNumber>
<CountryCode>USA</CountryCode>
<WarrantyDayCountParts>30</WarrantyDayCountParts>
<WarrantyDayCountLabor>30</WarrantyDayCountLabor>
<WarrantyProvidedBy>Newegg</WarrantyProvidedBy>
<SupportPhone>626-100-1000</SupportPhone>
<SupportEmail>example@newegg.com</SupportEmail>
<SupportURL>http://www.newegg.com</SupportURL>
</Item>
</Message>
</NeweggEnvelope>
Example: Json, Request
POST https://api.newegg.com/marketplace/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype=
ITEM_PREMIER_MARK_DATA
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"NeweggEnvelope": {
"Header": { "DocumentVersion": "1.0" },
"MessageType": "BatchThirdPartyWarrantyUpdate",
"Message": {
"Item": [
{
"SellerPartNumber": "321321654",
"NeweggItemNumber": "SIA00F3427624",
"CountryCode": "USA",
267
"WarrantyDayCountParts": "30",
"WarrantyDayCountLabor": "30",
"WarrantyProvidedBy": "Newegg",
"SupportPhone": "626-100-1000",
"SupportEmail": "example@newegg.com",
"SupportURL": "http://www.newegg.com"
},
{
"SellerPartNumber": "321321655",
"NeweggItemNumber": "SIA00F3427625",
"CountryCode": "USA",
"WarrantyDayCountParts": "30",
"WarrantyDayCountLabor": "30",
"WarrantyProvidedBy": "Newegg",
"SupportPhone": "626-100-1000",
"SupportEmail": "example@newegg.com",
"SupportURL": "http://www.newegg.com"
}
]
}
}
}
ITEM_CAPROP65_DATA
By submitting this template, you will be able to set the California’s Proposition 65 (“Prop 65”) warning for the items sold on Newegg
Marketplace.
For schema, please download the XSD’s and XML sample files from
https://sellerportal.newegg.com/Guideline/Newegg_Marketplace_API_DeveloperGuide.zip
The following information provides element definitions. You can also contact Newegg Marketplace Integration team:
datafeeds@newegg.com for assistance.
Attribute
Format
Description
Required
DocumentVersion
Decimal
The identifier for the version of current
datafeed; assigned by Newegg
Y
MessageType
String
AddingCAProp65
Y
Messag
e
ItemFee
d
Item
SellerPartNumber
String
A seller-defined unique identifier for an
item.
Y if
NeweggItemNumber
not provided.
268
NeweggItemNumber
String
Neweggs unique identifier for an item
Y if
SellerPartNumber
not provided.
WarningType_ID
String
Available values are from 103 to 119.
Please review the Side-by-side mapping
list of the Proposition 65 Warning Type
and Newegg Warning Code for the
deteails of each Warning Type and
related Warng Type ID.
Y
ChemicalName_Carcinogen
String
List the chemical name(s) the product
include to cause cancer.
Multiple values separated by commas.
Max Length : 600
Visit:
https://oehha.ca.gov/proposition-65 for
more information.
N
ChemicalName_ReproductiveToxic
ant
String
List the chemical name(s) the product
include to cause birth defects or other
reproductive harm.
Multiple values separated by commas.
Max Length : 600
Visit: https://oehha.ca.gov/proposition-
65 for more information.
N
ChemicalName_Both
String
List the chemical name(s) the product
include to cause both cancer and birth
defects or other reproductive harm.
Multiple values separated by commas.
Max Length : 600
Visit: https://oehha.ca.gov/proposition-
65 for more information.
N
Side-by-side mapping list of the Proposition 65 Warning Type and Newegg Warning Code
Proposition 65
Warning Type
Newegg
Warning
Type ID
Warning Will Be Displayed
CONSUMER PRODUCTS
(For exposures to listed
carcinogens - Long-Form)
103
WARNING: This product can expose you to chemicals including [name of one or more
chemicals], which is/are known to the State of California to cause cancer. For more
information go to www.P65Warnings.ca.gov .
269
CONSUMER PRODUCTS
(For exposures to listed
carcinogens - Short-Form)
104
WARNING: Cancer - www.P65Warnings.ca.gov .
CONSUMER PRODUCTS
(For exposures to listed
reproductive toxicants -
Long-Form)
105
WARNING: This product can expose you to chemicals including [name of one or more
chemicals], which is/are known to the State of California to cause birth defects or other
reproductive harm. For more information go to www.P65Warnings.ca.gov.
CONSUMER PRODUCTS
(For exposures to listed
reproductive toxicants -
Short-Form)
106
WARNING: Reproductive Harm - www.P65Warnings.ca.gov .
CONSUMER PRODUCTS
(For exposures to both
listed carcinogens and
reproductive toxicants -
Long-Form)
107
WARNING: This product can expose you to chemicals including [name of one or more
chemicals], which is/are known to the State of California to cause cancer, and [name of
one or more chemicals], which is/are known to the State of California to cause birth
defects or other reproductive harm. For more information go to
www.P65Warnings.ca.gov
CONSUMER PRODUCTS
(For exposures to both
listed carcinogens and
reproductive toxicants -
Short-Form)
108
WARNING: Cancer and Reproductive Harm - www.P65Warnings.ca.gov .
CONSUMER PRODUCTS
(For exposures to a
chemical that is listed as
both a carcinogen and a
reproductive toxicant -
Long-Form)
109
WARNING: This product can expose you to chemicals including [name of one or more
chemicals], which is/are known to the State of California to cause cancer and birth defects
or other reproductive harm. For more information go to
www.P65Warnings.ca.gov
FOOD
(For exposure to a listed
carcinogen)
110
WARNING: Consuming this product can expose you to chemicals including [name of
one or more chemicals], which is/are known to the State of California to cause cancer. For
more information go to www.P65Warnings.ca.gov/food .
FOOD
(For exposure to a listed
reproductive toxicant)
111
WARNING: Consuming this product can expose you to chemicals including [name of
one or more chemicals], which is/are known to the State of California to cause birth
defects or other reproductive harm. For more information go to
www.P65Warnings.ca.gov/food .
FOOD
(For exposure to both listed
carcinogens and
reproductive toxicants)
112
WARNING: Consuming this product can expose you to chemicals including [name of
one or more chemicals], which is/are known to the State of California to cause cancer and
[name of one or more chemicals], which is/are known to the State of California to cause
birth defects or other reproductive harm. For more information go to
www.P65Warnings.ca.gov/food .
270
FOOD
(For exposure to a chemical
that is listed as both a
carcinogen and a
reproductive toxicant)
113
WARNING: Consuming this product can expose you to chemicals including [name of
one or more chemicals], which is/are known to the State of California to cause cancer and
birth defects or other reproductive harm. For more information go to
www.P65Warnings.ca.gov/food .
ALCOHOLIC BEVERAGES
114
WARNING: Drinking distilled spirits, beer, coolers, wine and other alcoholic
beverages may increase cancer risk, and, during pregnancy, can cause birth defects. For
more information go to www.p65warnings.ca.gov/products/alcoholic-beverages
DIESEL ENGINES
115
WARNING: Breathing diesel engine exhaust exposes you to chemicals known to the
State of California to cause cancer and birth defects or other reproductive harm.
• Always start and operate the engine in a well-ventilated area.
• If in an enclosed area, vent the exhaust to the outside.
• Do not modify or tamper with the exhaust system.
• Do not idle the engine except as necessary.
For more information, go to www.p65warnings.ca.gov/products/diesel .
FURNITURE
116
WARNING: This product can expose you to chemicals including [name of one or more
chemicals], which is/are known to the State of California to cause cancer or birth defects
or other reproductive harm. For more information go to
www.P65Warnings.ca.gov/furniture .
RECREATIONAL MARINE
VESSELS
117
WARNING: Operating, servicing and maintaining a recreational marine vessel can
expose you to chemicals including engine exhaust, carbon monoxide, phthalates, and
lead, which are known to the State of California to cause cancer and birth defects or other
reproductive harm. To minimize exposure, avoid breathing exhaust, service your vessel in
a well-ventilated area and wear gloves or wash your hands frequently when servicing this
vessel. For more information go to www.P65warnings.ca.gov/marine .
VEHICLES
118
WARNING: Operating, servicing and maintaining a passenger vehicle or off-highway
motor vehicle can expose you to chemicals including engine exhaust, carbon monoxide,
phthalates, and lead, which are known to the State of California to cause cancer and birth
defects or other reproductive harm. To minimize exposure, avoid breathing exhaust, do
not idle the engine except as necessary, service your vehicle in a well-ventilated area and
wear gloves or wash your hands frequently when servicing your vehicle. For more
information go to www.P65Warnings.ca.gov/passenger-vehicle .
WOOD DUST (TOOLS)
119
WARNING: Drilling, sawing, sanding or machining wood products can expose you to
wood dust, a substance known to the State of California to cause cancer. Avoid inhaling
wood dust or use a dust mask or other safeguards for personal protection. For more
information go to www.P65Warnings.ca.gov/wood .
For the background on the Proposition 65 warnings: https://www.p65warnings.ca.gov/new-proposition-65-warnings
For information about Proposition 65 and businesses: https://oehha.ca.gov/proposition-65/businesses-and-proposition-65
For information about chemicals listed under Proposition 65: https://oehha.ca.gov/proposition-65/chemicals
271
Example: XML, Request
XSD
API Schema > DataFeedMgmt > DataFeedSchema > AddingCA_Prop65.xsd
POST https://api.newegg.com/marketplace/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype=ITEM_CAPROP65_DATA
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggEnvelope>
<Header>
<DocumentVersion>4.0</DocumentVersion>
</Header>
<MessageType>AddingCAProp65</MessageType>
<Message>
<Itemfeed>
<Item>
<SellerPartNumber>a006-test-001</SellerPartNumber>
<NeweggItemNumber>9SIAWE50008504</NeweggItemNumber>
<WarningType_ID>103</WarningType_ID>
<ChemicalName_Carcinogen><![CDATA[Acetaldehyde, Acetamide]]></ChemicalName_Carcinogen>
<ChemicalName_ReproductiveToxicant/>
<ChemicalName_Both/>
</Item>
</Itemfeed>
</Message>
</NeweggEnvelope>
Example: Json, Request
POST https://api.newegg.com/marketplace/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype= ITEM_CAPROP65_DATA
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"NeweggEnvelope": {
"Header": { "DocumentVersion": "4.0" },
272
"MessageType": "AddingCAProp65",
"Message": {
"Itemfeed": {
"Item": {
"SellerPartNumber": "a006-test-001",
"NeweggItemNumber": "9SIAWE50008504",
"WarningType_ID": "103",
"ChemicalName_Carcinogen": "Acetaldehyde, Acetamide"
}
}
}
}
}
ITEM_CHINATAXSETTING_DATA
By submitting this template, you will be able to set the tax type for the items sold for China.
For schema, please download the XSD’s and XML sample files from
https://sellerportal.newegg.com/Guideline/Newegg_Marketplace_API_DeveloperGuide.zip
The following information provides element definitions. You can also contact Newegg Marketplace Integration team:
datafeeds@newegg.com for assistance.
Attribute
Format
Description
Required
DocumentVersion
Decimal
1.0
Y
MessageType
String
BatchItemChinaTaxSetting
Y
Message
ChinaTaxSetting
Item
SellerPartNumber
String
A seller-defined unique identifier for an
item.
Y if
NeweggItemNumber
not provided.
NeweggItemNumber
String
Neweggs unique identifier for an item
Y if
SellerPartNumber
not provided.
TaxDutyType
String
Identify the tax and duty rules for items
shipped to China by seller directly. Available
values:
Default: Follow the account
level setting
DDU: Deliver Duties Unpaid. No
duty or tax will be added to orders.
Y
273
Customers are responsible for
additional duties and taxes during
the customs clearance.
DDP: Deliver Duties Paid. Duties
and taxes will be collected while
customers placing orders. Sellers
are responsible to pay all duties
and taxes directly. Collected
amount will be remit to sellers
along with regular payment
transactions.
ATI: All tax included. All duties and
taxes are included in item’s selling
price. No duty or tax will be added
to orders. Sellers are responsible
to pay all duties and taxes directly.
ImportType
String
Identify the order import type for calculating
the correct tax amount for items shipping to
China by Seller (SBS). Available values:
Default: Follow the account
level setting
EE: Taxes will be calculated as
personal shipments. Recipient’s
photo ID number and the copy of
ID will be provided for processing
orders.
EEP: Taxes will be calculated as
business to customer direct
shipments, known as Cross-Border
e-Commerce. Payment holder’s
photo ID number will be provided
for processing orders.
Y
Example: XML, Request
XSD
API Schema > DataFeedMgmt > DataFeedSchema > ItemChinaTaxSetting.xsd
274
POST
https://api.newegg.com/marketplace/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype=ITEM_CHINATAXSETTING_DATA
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<?xml version="1.0" encoding="UTF-8"?>
<NeweggEnvelope xsi:noNamespaceSchemaLocation="NeweggEnvelope.xsd"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Header>
<DocumentVersion>1.0</DocumentVersion>
<!--The identifier for the very of current feed; assigned by Newegg-->
</Header>
<MessageType>ItemChinaTaxSetting</MessageType>
<Message>
<ChinaTaxSetting>
<Item>
<SellerPartNumber>a006-test-001</SellerPartNumber>
<!--A seller-defined unique identifier for an item. An alphanumeric string, max 40
characters including space-->
<NeweggItemNumber>9SIAWE50008504</NeweggItemNumber>
<!--Newegg’s unique identifier for an item-->
<TaxDutyType>Default</TaxDutyType>
<ImportType>EEP</ImportType>
</Item>
</ChinaTaxSetting>
</Message>
</NeweggEnvelope>
Example: Json, Request
POST https://api.newegg.com/marketplace/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype=PRICE_DATA
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"NeweggEnvelope": {
"-xmlns:xsi": "http://www.w3.org/2001/XMLSchema-instance",
275
"-xsi:noNamespaceSchemaLocation": "NeweggEnvelop.xsd",
"Header": { "DocumentVersion": "1.0" },
"MessageType": "ItemChinaTaxSetting",
"Message": {
"ChinaTaxSetting": {
"Item": {
"SellerPartNumber": "a006-test-001",
"NeweggItemNumber": "9SIAWE50008504",
"TaxDutyType": "Default",
"ImportType": "EEP"
}
}
}
}
}
12.1.3. Response Body
Attribute
Format
Description
NeweggAPIResponse
IsSuccess
String
Used to identify the operation of submitting
datafeed is successful
True or False
OperationType
String
Fixed value: SubmitFeedResponse
SellerID
String
Your seller ID
ResponseBody
ResponseList
ResponseInfo
RequestId
String
The Identifier of a request
RequestType
String
ITEM_DATA
INVENTORY_AND_PRICE_DATA
INVENTORY_DATA
PRICE_DATA
ITEM_COUNTRY_RESTRICTION_DATA
ORDER_SHIP_NOTICE_DATA
MULTICHANNEL_ORDER_DATA
ITEM_SUBSCRIPTION
VOLUME_DISCOUNT_DATA
ITEM_PROMOTION_DATA
ITEM_PREMIER_MARK_DATA
ITEM_WARRANTY_DATA
ITEM_CAPROP65_DATA
ITEM_CHINATAXSETTING_DATA
276
RequestDate
String
The date when the feed was submitted. (Pacific
Standard Time)
RequestStatus
String
The status of the feed submission.
SUBMITTED
IN_PROGRESS
FINISHED
CANCELLED
Memo
String
Additional Information
Example: XML, Response
XSD
API Schema > DataFeedMgmt > DataFeedSchema > SubmitFeedResponse.xsd
<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<OperationType>SubmitFeedResponse</OperationType>
<SellerID>A006</SellerID>
<ResponseBody>
<ResponseList>
<ResponseInfo>
<RequestId>2291326430</RequestId>
<RequestType>ITEM_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": [{
277
"RequestDate": "2\/22\/2012 17:24:35",
"RequestId": "2PQCX3CMQ82MK",
"RequestStatus": "SUBMITTED",
"RequestType": "ITEM_DATA"
}]
},
"SellerID": "A006"
}
12.1.4. Request Failure Errors
For common HTTP error responses, please refer to Common Error Responses
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"
}
12.2. Get Feed Status
278
Get the status of specified feed request by specified query conditions.
12.2.1. Resource URL & Information
Resource URL
https://api.newegg.com/marketplace/datafeedmgmt/feeds/status?sellerid={sellerid}
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
Resource Information
HTTP Method
Authentication?
Request Formats
Response Formats
Rate Limited?
PUT
Required
XML, Json
XML, Json
1000 per min per client
12.2.2. Request Body
Attribute
Required?
Format
Description
NeweggAPIRequest
IssueUser
No
String
Specify your eligible seller account (email address) here.
OperationType
Yes
String
Fixed value: GetFeedStatusRequest
RequestBody
GetRequestStatus
RequestIDList
RequestID
No
String
A list of feed Task ID, other condition will be ignored if specify
an ID in the list
RequestTypeList
RequestType
No
String
ITEM_DATA
INVENTORY_AND_PRICE_DATA
INVENTORY_DATA
PRICE_DATA
ITEM_COUNTRY_RESTRICTION_DATA
ORDER_SHIP_NOTICE_DATA
MULTICHANNEL_ORDER_DATA
ITEM_SUBSCRIPTION
VOLUME_DISCOUNT_DATA
ITEM_PROMOTION_DATA
ITEM_PREMIER_MARK_DATA
ITEM_WARRANTY_DATA
ITEM_CAPROP65_DATA
ITEM_CHINATAXSETTING_DATA
279
MaxCount
No
Integer
The maximum return records. Default is 100. If you specified
over than 100, the system still return 100 records.
RequestStatus
No
String
The status of the feed submission.
Available values:
ALL (Default)
SUBMITTED
IN_PROGRESS
FINISHED
CANCELLED
RequestDateFrom
No
DateTime
Search by request date range. (Pacific Standard Time)
Please refer to the Acceptable Date Format
RequestDateTo
No
DateTime
Search by request date range. (Pacific Standard Time)
Please refer to the Acceptable Date Format
Example: XML, Request
XSD
API Schema > DataFeedMgmt > GetFeedStatus > GetFeedStatusRequest.xsd
PUT https://api.newegg.com/marketplace/datafeedmgmt/feeds/status?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggAPIRequest>
<OperationType>GetFeedStatusRequest</OperationType>
<RequestBody>
<GetRequestStatus>
<RequestIDList>
<RequestID>2PQCX3SPZ3QBF</RequestID>
</RequestIDList>
<MaxCount>100</MaxCount>
<RequestStatus>ALL</RequestStatus>
<RequestDateFrom/>
<RequestDateTo/>
</GetRequestStatus>
</RequestBody>
</NeweggAPIRequest>
Example: Json, Request
280
PUT https://api.newegg.com/marketplace/datafeedmgmt/feeds/status?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"OperationType": "GetFeedStatusRequest",
"RequestBody": {
"GetRequestStatus": {
"RequestIDList": { "RequestID": "2PQCX3SPZ3QBF" },
"MaxCount": "100",
"RequestStatus": "ALL"
}
}
}
12.2.3. Response Body
Attribute
Format
Description
NeweggAPIResponse
IsSuccess
String
Used to identify the operation of Get feed status is
successful
True or False
OperationType
String
Fixed value: GetFeedStatusResponse
SellerID
String
Your seller ID
R
e
s
p
o
n
s
e
B
o
d
y
R
e
s
p
o
n
s
e
L
i
s
t
R
e
s
p
o
n
s
e
I
n
f
o
RequestId
String
The Identifier of a request
281
RequestType
String
ITEM_DATA
INVENTORY_AND_PRICE_DATA
INVENTORY_DATA
PRICE_DATA
ITEM_COUNTRY_RESTRICTION_DATA
ORDER_SHIP_NOTICE_DATA
MULTICHANNEL_ORDER_DATA
ITEM_SUBSCRIPTION
VOLUME_DISCOUNT_DATA
ITEM_PROMOTION_DATA
ITEM_PREMIER_MARK_DATA
ITEM_WARRANTY_DATA
ITEM_CAPROP65_DATA
ITEM_CHINATAXSETTING_DATA
RequestDate
String
The date when the feed was submitted. (Pacific Standard
Time)
RequestStatus
String
The status of the feed submission.
Available values:
SUBMITTED
IN_PROGRESS
FINISHED
CANCELLED
Memo
String
Detailed error information
Example: XML, Response
XSD
API Schema > DataFeedMgmt > GetFeedStatus > GetFeedStatusResponse.xsd
<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<OperationType>GetFeedStatusResponse</OperationType>
<SellerID>A006</SellerID>
<ResponseBody>
<ResponseList>
<ResponseInfo>
<RequestId>2PQCX3SPZ3QBF</RequestId>
<RequestType>ITEM_DATA</RequestType>
<RequestDate>2/22/2012 17:25:10</RequestDate>
<RequestStatus>FINISHED</RequestStatus>
282
</ResponseInfo>
</ResponseList>
</ResponseBody>
</NeweggAPIResponse>
Example: Json, Response
{
"IsSuccess": true,
"OperationType": "GetFeedStatusResponse",
"ResponseBody": {
"ResponseList": [{
"RequestDate": "2\/22\/2012 17:25:10",
"RequestId": "2PQCX3SPZ3QBF",
"RequestStatus": "FINISHED",
"RequestType": "ITEM_DATA"
}]
},
"SellerID": "A006"
}
12.2.4. Request Failure Errors
For common HTTP error responses, please refer to Common Error Responses
Example: XML, Response
<?xml version="1.0" encoding="utf-8"?>
<Errors>
<Error>
<Code>CE001</Code>
<Message>SellerID cannot be null or empty</Message>
</Error>
</Errors>
Example: Json, Response
{
283
"Code": "CE001",
"Message": "SellerID cannot be null or empty"
}
12.3. Get Feed Result
When your datafeed status is finished, you can use this interface to get the processing report.
12.3.1. Resource URL & Information
Resource URL
https://api.newegg.com/marketplace/datafeedmgmt/feeds/result/{Requestid}?sellerid={sellerid}
Note: Please make sure your request URL is all in lower case (except for Seller ID and Request ID) and cannot contain any blank spaces
or line breaks.
Parameters
Name
Required?
Description
sellerId
Yes
Your seller ID on Newegg Marketplace
{Requestid}
Yes
The request ID of the submitted feed request
Resource Information
HTTP Method
Authentication?
Request Formats
Response Formats
Rate Limited?
GET
Required
XML, Json
XML, Json
1000 per min per client
12.3.2. Request Body
Example: XML, Request
GET https://api.newegg.com/marketplace/datafeedmgmt/feeds/result/{Requestid}?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
Example: Json, Request
GET https://api.newegg.com/marketplace/datafeedmgmt/feeds/result/{Requestid}?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
284
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
12.3.3. Response Body
The following information provides element definitions for processing report
Attribute
Description
Required
DocumentVersion
The identifier for the version of current datafeed; assigned
by Newegg
Y
MessageType
ProcessingReport
Y
Message
ProcessingReport
OrginalMessageName
Available value to identify processed message
Y
OriginalMessageType
Available value to identify processed message
Y
ProcessedStamp
The time stamp for processed message. Time format:
8/12/2010 9:32:33 PM
Y
StatusCode
Available value to identify message processing status
Y
ProcessedCount
Identify the total processed records.
N
SuccessCount
Identify the total successfully processed records.
N
WithErrorCount
Identify the total error processed records.
N
Result
AdditionalInfo
Error and warning information, available as the following
components:
SellerPartNumber
ManufacturePartNumber
NeweggItemNumber
UPC
OrderNumber
TrackingNumber
N
ErrorList
ErrorDescription
Identify the reason of an error
N
ITEM_DATA
Example: XML, Response
XSD
API Schema > DataFeedMgmt > DataFeedSchema > ProcessingReport.xsd
285
<?xml version="1.0" encoding="utf-8"?>
<NeweggEnvelope>
<Header>
<DocumentVersion>1.0</DocumentVersion>
</Header>
<MessageType>ProcessingReport</MessageType>
<Message>
<ProcessingReport>
<OriginalMessageName>APIAutoFile.xml</OriginalMessageName> <!-- please ignore this element -
->
<StatusCode>ProcessReport</StatusCode>
<ProcessingSummary>
<ProcessedCount>3</ProcessedCount>
<SuccessCount>1</SuccessCount>
<WithErrorCount>2</WithErrorCount>
</ProcessingSummary>
<Result>
<AdditionalInfo>
<SubCategoryID>1648</SubCategoryID>
<SellerPartNumber>sellerparttest001</SellerPartNumber>
<ManufacturerPartNumberOrISBN>mftparttest001</ManufacturerPartNumberOrISBN>
<UPC />
</AdditionalInfo>
<ErrorList>
<ErrorDescription>Error(s). Item not created.</ErrorDescription>
<ErrorDescription>Manufacturer - The manufacturer does not exist in our system. Please
contact Marketplace Support for more information.</ErrorDescription>
</ErrorList>
</Result>
<Result>
<AdditionalInfo>
<SubCategoryID>1648</SubCategoryID>
<SellerPartNumber>sellerparttest002</SellerPartNumber>
<ManufacturerPartNumberOrISBN>mftparttest002</ManufacturerPartNumberOrISBN>
<UPC>null</UPC>
</AdditionalInfo>
<ErrorList>
<ErrorDescription>Error(s). Item not created.</ErrorDescription>
<ErrorDescription>UPC - Format Error: UPC must be an numeric string of at least 12
digits.</ErrorDescription>
286
</ErrorList>
</Result>
</ProcessingReport>
</Message>
</NeweggEnvelope>
Example: Json, Response
{
"NeweggEnvelope": {
"Header": {
"DocumentVersion": "1.0"
},
"MessageType": "ProcessingReport",
"Message": {
"ProcessingReport": {
"OriginalMessageName": "APIAutoFile.xml",
"StatusCode": "ProcessReport",
"ProcessingSummary": {
"ProcessedCount": "3",
"SuccessCount": "1",
"WithErrorCount": "2"
},
"Result": [
{
"AdditionalInfo": {
"SubCategoryID": "1648",
"SellerPartNumber": "sellerparttest001",
"ManufacturerPartNumberOrISBN": "mftparttest001"
},
"ErrorList": {
"ErrorDescription": [
"Error(s). Item not created.",
"Manufacturer - The manufacturer does not exist in our system.
Please contact Marketplace Support for more information."
]
}
},
{
"AdditionalInfo": {
"SubCategoryID": "1648",
287
"SellerPartNumber": "sellerparttest002",
"ManufacturerPartNumberOrISBN": "mftparttest002",
"UPC": "null"
},
"ErrorList": {
"ErrorDescription": [
"Error(s). Item not created.",
"UPC - Format Error: UPC must be an numeric string of at least 12
digits."
]
}
}
]
}
}
}
}
INVENTORY_AND_PRICE_DATA
Example: XML, Response
XSD
API Schema > DataFeedMgmt > DataFeedSchema > ProcessingReport.xsd
<?xml version="1.0" encoding="utf-8"?>
<NeweggEnvelope>
<Header>
<DocumentVersion>1.0</DocumentVersion>
</Header>
<MessageType>ProcessingReport</MessageType>
<Message>
<ProcessingReport>
<OriginalMessageName>APIAutoFile.xml</OriginalMessageName>
<StatusCode>ProcessReport</StatusCode>
<OriginalMessageType>Inventory</OriginalMessageType>
<ProcessedStamp>2/7/2012 5:10:00 AM,PST</ProcessedStamp>
<ProcessingSummary>
<ProcessedCount>7</ProcessedCount>
288
<SuccessCount>7</SuccessCount>
<WithErrorCount>0</WithErrorCount>
</ProcessingSummary>
</ProcessingReport>
</Message>
</NeweggEnvelope>
Example: Json, Response
{
"NeweggEnvelope": {
"Header": { "DocumentVersion": "1.0" },
"MessageType": "ProcessingReport",
"Message": {
"ProcessingReport": {
"OriginalMessageName": "APIAutoFile.xml",
"StatusCode": "ProcessReport",
"OriginalMessageType": "Inventory",
"ProcessedStamp": "2/7/2012 5:10:00 AM,PST",
"ProcessingSummary": {
"ProcessedCount": "7",
"SuccessCount": "7",
"WithErrorCount": "0"
}
}
}
}
}
INVENTORY_DATA
Example: XML, Response
XSD
API Schema > DataFeedMgmt > DataFeedSchema > ProcessingReport.xsd
<?xml version="1.0" encoding="utf-8"?>
<NeweggEnvelope>
<Header>
<DocumentVersion>1.0</DocumentVersion>
289
</Header>
<MessageType>ProcessingReport</MessageType>
<Message>
<ProcessingReport>
<OriginalMessageName>APIAutoFile.xml</OriginalMessageName>
<StatusCode>ProcessReport</StatusCode>
<OriginalMessageType>Inventory</OriginalMessageType>
<ProcessedStamp>2/7/2012 5:10:00 AM,PST</ProcessedStamp>
<ProcessingSummary>
<ProcessedCount>7</ProcessedCount>
<SuccessCount>7</SuccessCount>
<WithErrorCount>0</WithErrorCount>
</ProcessingSummary>
</ProcessingReport>
</Message>
</NeweggEnvelope>
Example: Json, Response
{
"NeweggEnvelope": {
"Header": { "DocumentVersion": "1.0" },
"MessageType": "ProcessingReport",
"Message": {
"ProcessingReport": {
"OriginalMessageName": "APIAutoFile.xml",
"StatusCode": "ProcessReport",
"OriginalMessageType": "Inventory",
"ProcessedStamp": "2/7/2012 5:10:00 AM,PST",
"ProcessingSummary": {
"ProcessedCount": "7",
"SuccessCount": "7",
"WithErrorCount": "0"
}
}
}
}
}
290
PRICE_DATA
Example: XML, Response
XSD
API Schema > DataFeedMgmt > DataFeedSchema > ProcessingReport.xsd
<?xml version="1.0" encoding="utf-8"?>
<NeweggEnvelope>
<Header>
<DocumentVersion>1.0</DocumentVersion>
</Header>
<MessageType>ProcessingReport</MessageType>
<Message>
<ProcessingReport>
<OriginalMessageName>APIAutoFile.xml</OriginalMessageName>
<StatusCode>ProcessReport</StatusCode>
<OriginalMessageType>Price</OriginalMessageType>
<ProcessedStamp>2/7/2012 5:10:00 AM,PST</ProcessedStamp>
<ProcessingSummary>
<ProcessedCount>7</ProcessedCount>
<SuccessCount>7</SuccessCount>
<WithErrorCount>0</WithErrorCount>
</ProcessingSummary>
</ProcessingReport>
</Message>
</NeweggEnvelope>
Example: Json, Response
{
"NeweggEnvelope": {
"Header": { "DocumentVersion": "1.0" },
"MessageType": "ProcessingReport",
"Message": {
"ProcessingReport": {
"OriginalMessageName": "APIAutoFile.xml",
"StatusCode": "ProcessReport",
"OriginalMessageType": "Price",
"ProcessedStamp": "2/7/2012 5:10:00 AM,PST",
291
"ProcessingSummary": {
"ProcessedCount": "7",
"SuccessCount": "7",
"WithErrorCount": "0"
}
}
}
}
}
ITEM_COUNTRY_RESTRICTION_DATA
Example: XML, Response
XSD
API Schema > DataFeedMgmt > DataFeedSchema > ProcessingReport.xsd
<?xml version="1.0" encoding="UTF-8"?>
<NeweggEnvelope>
<Header>
<DocumentVersion>1.0</DocumentVersion>
</Header>
<MessageType>ProcessingReport</MessageType>
<Message>
<ProcessingReport>
<OriginalMessageName><![CDATA[Batch_CountryExclusionTest.xml]]></OriginalMessageName>
<StatusCode>ProcessReport</StatusCode>
<OriginalMessageType>ExcludeSellingCountry</OriginalMessageType>
<ProcessedStamp>1/1/2015 2:25:03 PM,PST</ProcessedStamp>
<ProcessingSummary>
<ProcessedCount>1</ProcessedCount>
<SuccessCount>0</SuccessCount>
<WithErrorCount>1</WithErrorCount>
</ProcessingSummary>
<Result>
<AdditionalInfo>
<SellerPartNumber><![CDATA[K59622]]></SellerPartNumber>
<NeweggItemNumber><![CDATA[9SIA0060909188]]></NeweggItemNumber>
</AdditionalInfo>
<ErrorList>
292
<ErrorDescription><![CDATA[ExcludeCountry - The ExcludeCountry is
invalid.]]></ErrorDescription>
</ErrorList>
</Result>
</ProcessingReport>
</Message>
</NeweggEnvelope>
Example: Json, Response
{
"NeweggEnvelope": {
"Header": { "DocumentVersion": "1.0" },
"MessageType": "ProcessingReport",
"Message": {
"ProcessingReport": {
"OriginalMessageName": "Batch_CountryExclusionTest.xml",
"StatusCode": "ProcessReport",
"OriginalMessageType": "ExcludeSellingCountry",
"ProcessedStamp": "1/1/2015 2:25:03 PM,PST",
"ProcessingSummary": {
"ProcessedCount": "1",
"SuccessCount": "0",
"WithErrorCount": "1"
},
"Result": {
"AdditionalInfo": {
"SellerPartNumber": "K59622",
"NeweggItemNumber": "9SIA0690909188"
},
"ErrorList": { "ErrorDescription": "ExcludeCountry - The ExcludeCountry is invalid." }
}
}
}
}
}
293
ORDER_SHIP_NOTICE_DATA
Example: XML, Response
XSD
API Schema > DataFeedMgmt > DataFeedSchema > ProcessingReport.xsd
<?xml version="1.0" encoding="utf-8"?>
<NeweggEnvelope>
<Header>
<DocumentVersion>1.0</DocumentVersion>
</Header>
<MessageType>ProcessingReport</MessageType>
<Message>
<ProcessingReport>
<OriginalMessageName>APIAutoFile.xml</OriginalMessageName>
<StatusCode>ProcessReport</StatusCode>
<OriginalMessageType>ShipNotice</OriginalMessageType>
<ProcessedStamp>2/7/2012 5:35:02 AM,PST</ProcessedStamp>
<ProcessingSummary>
<ProcessedCount>1</ProcessedCount>
<SuccessCount>1</SuccessCount>
<WithErrorCount>0</WithErrorCount>
</ProcessingSummary>
</ProcessingReport>
</Message>
</NeweggEnvelope>
Example: Json, Response
{
"NeweggEnvelope": {
"Header": { "DocumentVersion": "1.0" },
"MessageType": "ProcessingReport",
"Message": {
"ProcessingReport": {
"OriginalMessageName": "APIAutoFile.xml",
"StatusCode": "ProcessReport",
"OriginalMessageType": "ShipNotice",
"ProcessedStamp": "2/7/2012 5:35:02 AM,PST",
294
"ProcessingSummary": {
"ProcessedCount": "1",
"SuccessCount": "1",
"WithErrorCount": "0"
}
}
}
}
}
MULTICHANNEL_ORDER_DATA
Example: XML, Response
XSD
API Schema > DataFeedMgmt > DataFeedSchema > ProcessingReport.xsd
<?xml version="1.0" encoding="utf-8"?>
<NeweggEnvelope>
<Header>
<DocumentVersion>1.0</DocumentVersion>
</Header>
<MessageType>ProcessingReport</MessageType>
<Message>
<ProcessingReport>
<OriginalMessageName>APIAutoFile.xml</OriginalMessageName>
<!-- please ignore this element -->
<StatusCode>ProcessReport</StatusCode>
<ProcessingSummary>
<ProcessedCount>2</ProcessedCount>
<SuccessCount>1</SuccessCount>
<WithErrorCount>1</WithErrorCount>
</ProcessingSummary>
<Result>
<AdditionalInfo>
<SellerOrderID>3910117</SellerOrderID>
<SellerPartNumber>XAUB2511-100PAS</SellerPartNumber>
</AdditionalInfo>
<ErrorList>
<Error>
295
<ErrorDescription>Error(s). Process failed.</ErrorDescription>
</Error>
<Error>
<ErrorDescription>SellerPart # - Item(s) does not exist.</ErrorDescription>
</Error>
</ErrorList>
</Result>
</ProcessingReport>
</Message>
</NeweggEnvelope>
Example: Json, Response
{
"NeweggEnvelope": {
"Header": { "DocumentVersion": "1.0" },
"MessageType": "ProcessingReport",
"Message": {
"ProcessingReport": {
"OriginalMessageName": "APIAutoFile.xml",
"StatusCode": "ProcessReport",
"ProcessingSummary": {
"ProcessedCount": "2",
"SuccessCount": "1",
"WithErrorCount": "1"
},
"Result": {
"AdditionalInfo": {
"SellerOrderID": "3910117",
"SellerPartNumber": "XAUB2511-100PAS"
},
"ErrorList": {
"Error": [
{ "ErrorDescription": "Error(s). Process failed." },
{ "ErrorDescription": "SellerPart # - Item(s) does not exist." }
]
}
}
}
}
}
}
296
ITEM_SUBSCRIPTION
Example: XML, Response
XSD
API Schema > DataFeedMgmt > DataFeedSchema > ProcessingReport.xsd
<NeweggEnvelope>
<Header>
<DocumentVersion>1.0</DocumentVersion>
</Header>
<MessageType>ProcessingReport</MessageType>
<Message>
<ProcessingReport>
<OriginalMessageName>Subscription</OriginalMessageName>
<StatusCode>ProcessReport</StatusCode>
<OriginalMessageType>Subscription</OriginalMessageType>
<ProcessedStamp>6/25/2014 1:50:02 AM,PST</ProcessedStamp>
<ProcessingSummary>
<ProcessedCount>2</ProcessedCount>
<SuccessCount>1</SuccessCount>
<WithErrorCount>1</WithErrorCount>
</ProcessingSummary>
<Result>
<AdditionalInfo>
<SellerPartNumber>JACKETEST0921001003</SellerPartNumber>
</AdditionalInfo>
<ErrorList>
<Error>
<ErrorElement>SellerPartNumber</ErrorElement>
<ErrorDescription>
<![CDATA[ SellerPart# is invalid. ]]>
</ErrorDescription>
</Error>
</ErrorList>
</Result>
</ProcessingReport>
</Message>
</NeweggEnvelope>
297
Example: Json, Response
{
"NeweggEnvelope": {
"Header": { "DocumentVersion": "1.0" },
"MessageType": " Subscription",
"Message": {
"ProcessingReport": {
"OriginalMessageName": " Subscription",
"StatusCode": "ProcessReport",
"ProcessingSummary": {
"ProcessedCount": "2",
"SuccessCount": "1",
"WithErrorCount": "1"
},
"Result": {
"AdditionalInfo": {
"SellerPartNumber": "JACKETEST0921001003"
},
"ErrorList": {
"Error": [
{ "ErrorDescription": "SellerPart # - Item(s) does not exist." }
]
}
}
}
}
}
}
VOLUME_DISCOUNT_DATA
Example: XML, Response
XSD
API Schema > DataFeedMgmt > DataFeedSchema > ProcessingReport.xsd
<?xml version="1.0" encoding="UTF-8"?>
<NeweggEnvelope>
<Header>
298
<DocumentVersion>1.0</DocumentVersion>
</Header>
<MessageType>ProcessingReport</MessageType>
<Message>
<ProcessingReport>
<OriginalMessageName><![CDATA[VolumeDiscountTest.xml]]></OriginalMessageName>
<StatusCode>ProcessReport</StatusCode>
<OriginalMessageType>VolumeDiscount</OriginalMessageType>
<ProcessedStamp>6/12/2014 10:29:38 AM,PST</ProcessedStamp>
<ProcessingSummary>
<ProcessedCount>2</ProcessedCount>
<SuccessCount>1</SuccessCount>
<WithErrorCount>1</WithErrorCount>
</ProcessingSummary>
<Result>
<AdditionalInfo>
<SellerPartNumber><![CDATA[phy_3890_USA_9SI_5]]></SellerPartNumber>
<ItemNumber><![CDATA[9SIA0060004809]]></ItemNumber>
</AdditionalInfo>
<ErrorList>
<ErrorDescription><![CDATA[SellerItemNumber: '9SIA0060004809', Country Code: 'USA' and
Company Code: '1003' has no Volume Discount Setting.]]></ErrorDescription>
</ErrorList>
</Result>
</ProcessingReport>
</Message>
</NeweggEnvelope>
Example: Json, Response
{
"NeweggEnvelope": {
"-xmlns:xsi": "http://www.w3.org/2001/XMLSchema-instance",
"Header": { "DocumentVersion": "1.0" },
"MessageType": "ProcessingReport",
"Message": {
"ProcessingReport": {
"OriginalMessageName": "VolumeDiscountTest.xml",
"StatusCode": "ProcessReport",
"OriginalMessageType": "VolumeDiscount",
"ProcessedStamp": "6/12/2014 10:29:38,PST",
299
"ProcessingSummary": {
"ProcessedCount": "2",
"SuccessCount": "1",
"WithErrorCount": "1"
},
"Result": {
"AdditionalInfo": {
"SellerPartNumber": "phy_3890_USA_9SI_5",
"ItemNumber": "9SIA0060004809"
},
"ErrorList": { "ErrorDescription": "SellerItemNumber: '9SIA0060004809', Country Code:
'USA' and Company Code: '1003' has no Volume Discount Setting." }
}
}
}
}
}
ITEM_PROMOTION_DATA
Example: XML, Response
XSD
API Schema > DataFeedMgmt > DataFeedSchema > ProcessingReport.xsd
<?xml version="1.0" encoding="UTF-8"?>
<NeweggEnvelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Header>
<DocumentVersion>1.0</DocumentVersion>
</Header>
<MessageType>ProcessingReport</MessageType>
<Message>
<ProcessingReport>
<OriginalMessageName><![CDATA[ItemPromotion.xml]]></OriginalMessageName>
<StatusCode>ProcessReport</StatusCode>
<OriginalMessageType>ItemPromotion</OriginalMessageType>
<ProcessedStamp>6/12/2014 10:29:38 AM,PST</ProcessedStamp>
<ProcessingSummary>
<ProcessedCount>2</ProcessedCount>
<SuccessCount>1</SuccessCount>
300
<WithErrorCount>1</WithErrorCount>
</ProcessingSummary>
<Result>
<AdditionalInfo>
<SellerPartNumber><![CDATA[phy_3890_USA_9SI_5]]></SellerPartNumber>
<ItemNumber><![CDATA[9SIA0060004809]]></ItemNumber>
</AdditionalInfo>
<ErrorList>
<ErrorDescription><![CDATA[SellerItemNumber: '9SIA0060004809', Promo End Date must be
after Promo Start Date.]]></ErrorDescription>
</ErrorList>
</Result>
</ProcessingReport>
</Message>
</NeweggEnvelope>
Example: Json, Response
{
"NeweggEnvelope": {
"-xmlns:xsi": "http://www.w3.org/2001/XMLSchema-instance",
"Header": { "DocumentVersion": "1.0" },
"MessageType": "ProcessingReport",
"Message": {
"ProcessingReport": {
"OriginalMessageName": "ItemPromotion.xml",
"StatusCode": "ProcessReport",
"OriginalMessageType": "ItemPromotion",
"ProcessedStamp": "6/12/2014 10:29:38 AM,PST",
"ProcessingSummary": {
"ProcessedCount": "2",
"SuccessCount": "1",
"WithErrorCount": "1"
},
"Result": {
"AdditionalInfo": {
"SellerPartNumber": "phy_3890_USA_9SI_5",
"ItemNumber": "9SIA0060004809"
},
"ErrorList": {"ErrorDescription": "SellerItemNumber: '9SIA0060004809', Promo End Date
must be after Promo Start Date."}
301
}
}
}
}
}
ITEM_PREMIER_MARK_DATA
Example: XML, Response
<?xml version="1.0" encoding="UTF-8"?>
<NeweggEnvelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Header>
<DocumentVersion>1.0</DocumentVersion>
</Header>
<MessageType>ProcessingReport</MessageType>
<Message>
<ProcessingReport>
<OriginalMessageName><![CDATA[ItemPremierMark.xml]]></OriginalMessageName>
<StatusCode>ProcessReport</StatusCode>
<OriginalMessageType>ItemPremierMark</OriginalMessageType>
<ProcessedStamp>6/12/2014 10:29:38 AM,PST</ProcessedStamp>
<ProcessingSummary>
<ProcessedCount>2</ProcessedCount>
<SuccessCount>1</SuccessCount>
<WithErrorCount>1</WithErrorCount>
</ProcessingSummary>
<Result>
<AdditionalInfo>
<SellerPartNumber><![CDATA[phy_3890_USA_9SI_5]]></SellerPartNumber>
<ItemNumber><![CDATA[9SIA0060004809]]></ItemNumber>
</AdditionalInfo>
<ErrorList>
<ErrorDescription><![CDATA[You have not enrolled Newegg Premier Program. Please request
to enroll Newegg Premier Program from Seller Portal.]]></ErrorDescription>
</ErrorList>
</Result>
</ProcessingReport>
</Message>
</NeweggEnvelope>
302
Example: Json, Response
{
"NeweggEnvelope": {
"-xmlns:xsi": "http://www.w3.org/2001/XMLSchema-instance",
"Header": { "DocumentVersion": "1.0" },
"MessageType": "ProcessingReport",
"Message": {
"ProcessingReport": {
"OriginalMessageName": "ItemPremierMark.xml",
"StatusCode": "ProcessReport",
"OriginalMessageType": "ItemPremierMark",
"ProcessedStamp": "6/12/2014 10:29:38 AM,PST",
"ProcessingSummary": {
"ProcessedCount": "2",
"SuccessCount": "1",
"WithErrorCount": "1"
},
"Result": {
"AdditionalInfo": {
"SellerPartNumber": "phy_3890_USA_9SI_5",
"ItemNumber": "9SIA0060004809"
},
"ErrorList": {" You have not enrolled Newegg Premier Program. Please request to enroll
Newegg Premier Program from Seller Portal."}
}
}
}
}
}
ITEM_WARRANTY_DATA
Example: XML, Response
<?xml version="1.0" encoding="UTF-8"?>
<NeweggEnvelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Header>
<DocumentVersion>1.0</DocumentVersion>
303
</Header>
<MessageType>ProcessingReport</MessageType>
<Message>
<ProcessingReport>
<OriginalMessageName><![CDATA[ItemWarranty.xml]]></OriginalMessageName>
<StatusCode>ProcessReport</StatusCode>
<OriginalMessageType>BatchThirdPartyWarrantyUpdate</OriginalMessageType>
<ProcessedStamp>6/12/2014 10:29:38 AM,PST</ProcessedStamp>
<ProcessingSummary>
<ProcessedCount>2</ProcessedCount>
<SuccessCount>1</SuccessCount>
<WithErrorCount>1</WithErrorCount>
</ProcessingSummary>
<Result>
<AdditionalInfo>
<SellerPartNumber><![CDATA[phy_3890_USA_9SI_5]]></SellerPartNumber>
<ItemNumber><![CDATA[9SIA0060004809]]></ItemNumber>
</AdditionalInfo>
<ErrorList>
<ErrorDescription><![CDATA[SellerPart # - Item(s) does not exist.]]></ErrorDescription>
</ErrorList>
</Result>
</ProcessingReport>
</Message>
</NeweggEnvelope>
Example: Json, Response
{
"NeweggEnvelope": {
"-xmlns:xsi": "http://www.w3.org/2001/XMLSchema-instance",
"Header": { "DocumentVersion": "1.0" },
"MessageType": "ProcessingReport",
"Message": {
"ProcessingReport": {
"OriginalMessageName": "ItemWarranty.xml",
"StatusCode": "ProcessReport",
"OriginalMessageType": "BatchThirdPartyWarrantyUpdate",
"ProcessedStamp": "6/12/2014 10:29:38 AM,PST",
"ProcessingSummary": {
"ProcessedCount": "2",
304
"SuccessCount": "1",
"WithErrorCount": "1"
},
"Result": {
"AdditionalInfo": {
"SellerPartNumber": "phy_3890_USA_9SI_5",
"ItemNumber": "9SIA0060004809"
},
"ErrorList": {"SellerPart # - Item(s) does not exist."}
}
}
}
}
}
ITEM_CAPROP65_DATA
Example: XML, Response
<NeweggEnvelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Header>
<DocumentVersion>1.0</DocumentVersion>
</Header>
<MessageType>ProcessingReport</MessageType>
<Message>
<ProcessingReport>
<OriginalMessageName><![CDATA[APIAutoFile.xml]]></OriginalMessageName>
<StatusCode>ProcessReport</StatusCode>
<OriginalMessageType>AddingCAProp65</OriginalMessageType>
<ProcessedStamp>06/15/2018 9:08:17 AM,PST</ProcessedStamp>
<ProcessingSummary>
<ProcessedCount>71</ProcessedCount>
<SuccessCount>67</SuccessCount>
<WithErrorCount>4</WithErrorCount>
</ProcessingSummary>
<Result>
<AdditionalInfo>
<SellerPartNumber><![CDATA[CC1965]]></SellerPartNumber>
<NeweggItemNumber><![CDATA[9SI1234]]></NeweggItemNumber>
<WarningType_ID><![CDATA[103]]></WarningType_ID>
</AdditionalInfo>
305
<ErrorList>
<ErrorDescription><![CDATA[ChemicalName_Carcinogen is required for
WarningType_ID 103.]]></ErrorDescription>
<ErrorDescription><![CDATA[System Error Sample.]]></ErrorDescription>
</ErrorList>
</Result>
</ProcessingReport>
</Message>
</NeweggEnvelope>
Example: Json, Response
{
"NeweggEnvelope": {
"-xmlns:xsi": "http://www.w3.org/2001/XMLSchema-instance",
"Header": { "DocumentVersion": "1.0" },
"MessageType": "ProcessingReport",
"Message": {
"ProcessingReport": {
"OriginalMessageName": "APIAutoFile.xml",
"StatusCode": "ProcessReport",
"OriginalMessageType": "AddingCAProp65",
"ProcessedStamp": "06/15/2018 9:08:17 AM,PST",
"ProcessingSummary": {
"ProcessedCount": "71",
"SuccessCount": "67",
"WithErrorCount": "4"
},
"Result": {
"AdditionalInfo": {
"SellerPartNumber": "CC1965",
"NeweggItemNumber": "9SI1234",
"WarningType_ID": "103"
},
"ErrorList": {
"ErrorDescription": [
"ChemicalName_Carcinogen is required for WarningType_ID 103.",
"System Error Sample."
]
}
}
}
306
}
}
}
ITEM_CHINATAXSETTING_DATA
Example: XML, Response
<?xml version="1.0" encoding="utf-8"?>
<NeweggEnvelope>
<Header>
<DocumentVersion>1.0</DocumentVersion>
</Header>
<MessageType>ProcessingReport</MessageType>
<Message>
<ProcessingReport>
<OriginalMessageName>APIAutoFile.xml</OriginalMessageName>
<StatusCode>ProcessReport</StatusCode>
<OriginalMessageType>ItemChinaTaxSetting</OriginalMessageType>
<ProcessedStamp>2/7/2012 5:10:00 AM,PST</ProcessedStamp>
<ProcessingSummary>
<ProcessedCount>7</ProcessedCount>
<SuccessCount>7</SuccessCount>
<WithErrorCount>0</WithErrorCount>
</ProcessingSummary>
</ProcessingReport>
</Message>
</NeweggEnvelope>
Example: Json, Response
{
"NeweggEnvelope": {
"Header": { "DocumentVersion": "1.0" },
"MessageType": "ProcessingReport",
"Message": {
"ProcessingReport": {
"OriginalMessageName": "APIAutoFile.xml",
"StatusCode": "ProcessReport",
"OriginalMessageType": "ItemChinaTaxSetting",
"ProcessedStamp": "2/7/2012 5:10:00 AM,PST",
"ProcessingSummary": {
307
"ProcessedCount": "7",
"SuccessCount": "7",
"WithErrorCount": "0"
}
}
}
}
}
12.3.4. Request Failure Errors
For common HTTP error responses, please refer to Common Error Responses
Error Code
Description
DF004
Unfortunately, we are unable to process your request at this time. We apologize for the inconvenience. Please
try again later.
DF005
Your feed was not submitted successfully (Feed Request ID: [{0}]). Please resubmit your feed again.
DF006
The requestID cannot be null.
DF007
Invalid RequestID.
DF010
Data feed request processing failed:{0}
Available values:
a. FileContentError (mapped error message: Incorrect data feed format or template)
b. No record (mapped error message: request with no record specified.)
Example: XML, Response
<?xml version="1.0" encoding="utf-8"?>
<Errors>
<Error>
<Code>DF006</Code>
<Message>Invalid RequestID</Message>
</Error>
</Errors>
Example: Json, Response
{
"Code": "DF006",
308
"Message": "Invalid RequestID"
}
309
13. RMA Management
The following sections describe how to create, retrieve and update RMA (refund and replacement), as well as how to
issue a courtesy refund.
RMA (Return Merchandise Authorization) is a return transaction that seller would expect a return shipment from customer
in exchange for refund or replacement. However, the functions allow you to issue refund even if a return shipment is not
received (mark auto receive, see details below). *RMA refund will result in commission refund to seller.
Simple RMA flow goes as follows:
Issue RMA -> Receive RMA -> Process Refund / Replacement. Replacement will appear as a new order in order list.
If Auto Received marked as yes:
Issue RMA -> Process Refund (not applicable to RMA Replacement type). Please consult with Newegg Integration team
for details of how auto-receiving a RMA works.
Courtesy Refund is a refund transaction that seller would not expect a return shipment from customer. It is normally a
refund for reasons such as Pricing Error. NOTE: please make sure that the courtesy refund should not be used as regular
refund. *Courtesy refund will NOT result in commission refund to seller.
13.1. Submit RMA
Issue a Refund or Replacement RMA for an invoiced order.
13.1.1. Resource URL & Information
Resource URL
https://api.newegg.com/marketplace/servicemgmt/rma/newrma?sellerid={sellerid}&version={versionno}
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
version
No
Available version numbers: 307
Resource Information
HTTP Method
Authentication?
Request Formats
Response Formats
Rate Limited?
310
POST
Required
XML, Json
XML, Json
30 per min per client
13.1.2. Request Body
Attribute
Required?
Format
Description
NeweggAPIRequest
IssueUser
No
String
The RMA issuer’s registered Seller Portal email
address. System will only accept Seller’s
registered Seller Portal email addresses. If left
blank, default value will be Seller ID.
OperationType
Yes
String
Fixed value: IssueRMARequest
RequestBody
IssueRMA
RMAType
Yes
Integer
Available values:
1: Replacement
2: Refund
For Courtesy Refund, please refer to Issue
Courtesy Refund section (click here)
SourceSONumber
Yes
Integer
The order number which the RMA is issued for.
SellerRMANumber
No
String
Seller RMA #.
An alphanumeric string, max 50 characters.
Note: only available for version=307
DiffShippedByPartyActio
n
Yes if:
RMA type =
Replacement
The original order
has items
currently fulfilled
by SBS and SBN.
Integer
The RMA replacement Order you are submitting
currently has items Shipped by Seller and
Shipped by Newegg. In order to process the
RMA replacement request, please choose one
of the following actions:
1: Convert to Refund with Restocking Fee
2: Convert to Refund without Restocking Fee
3: Split into Two RMAs
AutoReceiveMark
No
Integer
This mark is used to:
- Receive the RMA automatically once the
RMA has been created successfully. Seller
would not need to “receive” RMA as a
separate action to proceed with refund.
Otherwise, seller will need to “receive”
311
RMA after RMA created to proceed with
refund.
- Auto match with existing open RMA’s for
the same order.
Available values:
0: Don’t receive the RMA automatically
(default). Do not proceed with refund until RMA
is marked as received.
1: Receive the RMA automatically after RMA
creation and proceed with refund.
Restriction: Currently this mark only applies to
the order shipped by seller and is only available
for RMA type = refund.
Note: If the RMA didn’t create successfully, the
RMA will not be automatically received, even if
you specified the mark as 1.
Note: if you are not sure how to use this, please
consult with Datafeeds@newegg.com.
RMANote
No
String
Comment for this RMA. Max 4000 character(s).
RMA Transaction List
RMA Transaction
SellerPartNu
mber
Yes
String
The seller part number of the item, used to
identify the item
ReturnQuant
ity
Yes
Integer
The return quantity of each item in this RMA
ReturnUnitPr
ice
Yes if
RMA
type =
Refun
d
Decimal
The return unit price of each item in refund
RMA. How much refund will be issued per unit
of this item.
NOTE: All amounts are set in U.S. Dollars (USD).
RefundShippi
ngPrice
Yes if
RMA
type =
Refun
d
Decimal
The shipping amount of refund of each item in
this RMA
NOTE: All amounts are set in U.S. Dollars (USD).
312
RMAReason
Yes
Integer
The replacement/refund reason of each item in
this RMA.
Available values:
1: Carrier damage
2: Defective
3: Incompatible
4: No longer needed
5: Not match what we show
6: Ordered wrong item
7: Sent wrong item
8: Unsatisfied
Example: XML, RMA Refund Request
XSD
API Schema > RMAManagement > RMA > SubmitRMA > SubmitRMARequest.xsd
POST https://api.newegg.com/marketplace/servicemgmt/rma/newrma?sellerid={SellerID}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggAPIRequest>
<OperationType>IssueRMARequest</OperationType>
<RequestBody>
<IssueRMA>
<RMAType>2</RMAType>
<SourceSONumber>123456789</SourceSONumber>
<SellerRMANumber>E12345678</SellerRMANumber>
<AutoReceiveMark>1</AutoReceiveMark>
<RMANote>This is a test RMA</RMANote>
<RMATransactionList>
<RMATransaction>
<SellerPartNumber>test001</SellerPartNumber>
<ReturnQuantity>1</ReturnQuantity>
<ReturnUnitPrice>1.00</ReturnUnitPrice>
313
<RefundShippingPrice>1.00</RefundShippingPrice>
<RMAReason>2</RMAReason>
</RMATransaction>
</RMATransactionList>
</IssueRMA>
</RequestBody>
</NeweggAPIRequest>
Example: Json, RMA Refund Request
POST https://api.newegg.com/marketplace/servicemgmt/rma/newrma?sellerid={SellerID}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"OperationType": "IssueRMARequest",
"RequestBody": {
"IssueRMA": {
"RMAType": "2",
"SourceSONumber": "123456789",
“SellerRMANumber”:”E12345678”,
"AutoReceiveMark": "1",
"RMANote": "This is a test RMA",
"RMATransactionList": {
"RMATransaction": {
"SellerPartNumber": "test001",
"ReturnQuantity": "1",
"ReturnUnitPrice": "1.00",
"RefundShippingPrice": "1.00",
"RMAReason": "2"
}
}
}
}
}
314
Example: XML, RMA Replacement Request
XSD
API Schema > RMAManagement > RMA > SubmitRMA > SubmitRMARequest.xsd
POST https://api.newegg.com/marketplace/servicemgmt/rma/newrma/sellerid={SellerID}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggAPIRequest>
<IssueUser>test@newegg.com</IssueUser>
<OperationType>IssueRMARequest</OperationType>
<RequestBody>
<IssueRMA>
<RMAType>1</RMAType>
<SourceSONumber>123456789</SourceSONumber>
<SellerRMANumber>E12345678</SellerRMANumber>
<RMAShipMethod>1</RMAShipMethod>
<RMANote>This is a test RMA</RMANote>
<RMATransactionList>
<RMATransaction>
<SellerPartNumber>test001</SellerPartNumber>
<ReturnQuantity>1</ReturnQuantity>
<RMAReason>2</RMAReason>
</RMATransaction>
</RMATransactionList>
</IssueRMA>
</RequestBody>
</NeweggAPIRequest>
Example: Json, RMA Replacement Request
POST https://api.newegg.com/marketplace/servicemgmt/rma/newrma/sellerid={SellerID}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"OperationType": "IssueRMARequest",
315
"RequestBody": {
"IssueRMA": {
"RMAType": "1",
"SourceSONumber": "123456789",
“SellerRMANumber”:”E12345678”,
"RMAShipMethod": "1",
"RMANote": "This is a test RMA",
"RMATransactionList": {
"RMATransaction": {
"SellerPartNumber": "test001",
"ReturnQuantity": "1",
"RMAReason": "2"
}
}
}
}
}
13.1.3. Response Body
Attribute
Format
Description
NeweggAPIResponse
IsSuccess
String
Used to identify the operation of Submit RMA is
successful. Returns true or false.
OperationType
String
Fixed value: IssueRMAResponse
SellerID
String
Your seller ID
ResponseBody
RMAInfoList
RMAInfo
RMANumber
Integer
RMA number
RMAType
Integer
1. Replacement
2. Refund
RMATypeDescription
String
Replacement for RMAType value 1.
Refund for RMAType value 2.
SellerRMANumber
String
Seller RMA #.
An alphanumeric string, max 50 characters.
Note: only available for version = 307
IssueUser
String
RMA Issue User or Seller ID (if RMA Issue User
was not specified when RMA was created).
RMADate
String
Date of RMA(Pacific Standard Time)
RMAStatus
Integer
6. Processing
316
RMAStatusDescription
String
Processing (default)
RMAShipMethod
Integer
The ship method if the RMA type =
Replacement:
1: Super Saver(7-14 business days)
2: Standard Shipping(5-7 business days)
3: Expedited Shipping(3-5 business days)
4: Two-Day Shipping(2 business days)
5: One-Day Shipping(Next day)
6: International Economy Shipping(8-15 business
days)
7: International Standard Shipping(5-7 business
days)
8: International Expedited Shipping(3-5 business
days)
9: International Two-Day Shipping(2 business
days)
10: APO/FPO Military ONLY
11: Newegg Premier 3 Days
12: Newegg Premier 2 Days
13: Newegg Premier Next Day
If RMA type = Refund, this element will be blank.
NOTE: Newegg will apply the same ship method
used by order.
317
RMAShipMethodDescription
String
The ship method if the RMA type =
Replacement:
Super Saver(7-14 business days)for status code:
1
Standard Shipping(5-7 business days) for status
code: 2
Expedited Shipping(3-5 business days) for status
code: 3
Two-Day Shipping(2 business days)for status
code: 4
One-Day Shipping(Next day)for status code: 5
International Economy Shipping(8-15 business
days)for status code: 6
International Standard Shipping(5-7 business
days)for status code: 7
International Expedited Shipping (3-5 business
days)for status code: 8
International Two-Day Shipping(2 business
days) for status code :9
APO/FPO Military ONLY for status code:10
Newegg Premier 3 Days for status code:11
Newegg Premier 2 Days for status code:12
Newegg Premier Next Day for status code:13
If RMA type = Refund, this element will be blank.
NOTE: Newegg will apply the same ship method
used by order.
OrderNumber
Integer
Order Number of the RMA requested order
OrderDate
String
Order Date(Pacific Standard Time)
InvoiceNumber
Integer
Invoice Number of the order RMA requested
order
OrderAmount
Decimal
Order Amount
NOTE: All amounts are set in U.S. Dollars (USD).
AvailableRefundAmount
Decimal
Available Refund Amount
NOTE: All amounts are set in U.S. Dollars (USD).
RMAProcessedBy
String
Newegg or Seller
RMAReceiveDate
String
RMA shipment received date
RMANote
String
The comment in this RMA
PriorRefundAmount
Decimal
Previous Refund Amount if any
NOTE: All amounts are set in U.S. Dollars (USD).
318
CustomerName
String
Customer Name
CustomerPhoneNumber
String
Customer Phone Number
CustomerEmailAddress
String
The masked customer email address, you can
reach to the customer through this email address.
For example:
gdv6l0viwo4l7j1d@marketplace.newegg.com
ShipToAddress1
String
The order will be ship to address1
ShipToAddress2
String
The order’s ship to address2
ShipToCityName
String
The order’s ship to cityName
ShipToStateCode
String
The order’s ship to state code
ShipToZipCode
String
The order’s ship to zip code
ShipToCountryCode
String
The order’s ship to countrycode.
E.g. UNITED STATES
ShipToLastName
String
The ship to LastName
ShipToFirstName
String
The ship to FirstName
ShipToCompany
String
The order’s ship to company
RMATransactionList
RMATransaction
SellerPartNumber
String
The seller part number to identify a SKU
MfrPartNumber
String
Manufacturer Part Number
NeweggItemNumber
String
Newegg Item Number
Description
String
Item Description
UnitPrice
decimal
Item’s price
NOTE: All amounts are set in U.S. Dollars (USD).
ReturnQuantity
Integer
The return quantity of each SKU in this RMA
ReturnUnitPrice
decimal
If RMA type = Refund: The return unit price of
each item in refund RMA. How much refund will
be issued per unit of this item. If RMA type =
replacement, this element will be blank.
NOTE: All amounts are set in U.S. Dollars (USD).
RefundShippingPrice
decimal
If RMA type = Refund: The shipping amount of
refund of each item in this RMA. If RMA type =
replacement, this element will be blank.
NOTE: All amounts are set in U.S. Dollars (USD).
ShippedBy
Integer
If RMA type = Replacement:
Indicates if shipped by Newegg.
0: Shipped by seller
1: Shipped by Newegg
319
RMAReason
Integer
The replacement/refund reason of each SKU in
this RMA.
Available values:
1: Carrier damage
2: Defective
3: Incompatible
4: No longer needed
5: Not match what we show
6: Ordered wrong item
7: Sent wrong item
8: Unsatisfied
9: Other Reason {0}
RMAReasonDescription
String
The replacement/refund reason of each SKU in
this RMA.
Carrier damage for status code: 1
Defective for status code: 2
Incompatible for status code: 3
No longer needed for status code: 4
Not match what we show for status code: 5
Ordered wrong item for status code: 6
Sent wrong item for status code: 7
Unsatisfied for status code: 8
Other Reason {0} for status code: 9
Memo
String
Additional messages
ResponseDate
String
Response date
Example: XML, Response
XSD
API Schema > RMAManagement > RMA > SubmitRMA > SubmitRMAResponse.xsd
<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<OperationType>IssueRMAResponse</OperationType>
<SellerID>A006</SellerID>
<ResponseDate>2012-02-22 20:59:50</ResponseDate>
<Memo />
<ResponseBody>
<RMAInfo>
320
<RMANumber>20103389</RMANumber>
<RMAType>2</RMAType>
<RMATypeDescription>Refund</RMATypeDescription>
<IssueUser>A004</IssueUser>
<RMADate>2012-02-22</RMADate>
<RMAStatus>6</RMAStatus>
<RMAStatusDescription>Processing</RMAStatusDescription>
<RMAShipMethod />
<RMAShipMethodDescription />
<OrderNumber>41473422</OrderNumber>
<OrderDate>2012-01-11</OrderDate>
<InvoiceNumber>82868509</InvoiceNumber>
<OrderAmount>15.00</OrderAmount>
<AvailableRefundAmount>12000</AvailableRefundAmount>
<RMAProcessedBy>newegg</RMAProcessedBy>
<RMAReceiveDate />
<RMANote>This is a test RMA</RMANote>
<PriorRefundAmount>2.00</PriorRefundAmount>
<CustomerName>abc Roosevelt</CustomerName>
<CustomerPhoneNumber>626-271-9700</CustomerPhoneNumber>
<CustomerEmailAddress>gdv6l0viwo4l7j1d@marketplace.newegg.com</CustomerEmailAddress>
<ShipToAddress1>1941 E. Cedar Loop Drive</ShipToAddress1>
<ShipToAddress2>9A</ShipToAddress2>
<ShipToCityName>South Weber</ShipToCityName>
<ShipToStateCode>UT</ShipToStateCode>
<ShipToZipCode>884405</ShipToZipCode>
<ShipToLastName>Roosevelt</ShipToLastName>
<ShipToFirstName>abc</ShipToFirstName>
<ShipToCompany />
<RMATransactionList>
<RMATransaction>
<SellerPartNumber>201112310900</SellerPartNumber>
<MfrPartNumber>201112310900</MfrPartNumber>
<NeweggItemNumber>9SIA0040286987</NeweggItemNumber>
<Description>ICYTEST201112310900</Description>
<UnitPrice>600.00</UnitPrice>
<ReturnQuantity>1</ReturnQuantity>
<ReturnUnitPrice>1.00</ReturnUnitPrice>
<RefundShippingPrice>1.00</RefundShippingPrice>
<RMAReason>2</RMAReason>
<RMAReasonDescription>Defective</RMAReasonDescription>
321
</RMATransaction>
</RMATransactionList>
</RMAInfo>
</ResponseBody>
</NeweggAPIResponse>
Example: Json, Response
{
"IsSuccess": "true",
"OperationType": "IssueRMAResponse",
"SellerID": "A006",
"ResponseDate": "2012-02-22 20:59:50",
"ResponseBody": {
"RMAInfo": {
"RMANumber": "20103389",
"RMAType": "2",
"RMATypeDescription": "Refund",
"IssueUser": "A004",
"RMADate": "2012-02-22",
"RMAStatus": "6",
"RMAStatusDescription": "Processing",
"OrderNumber": "41473422",
"OrderDate": "2012-01-11",
"InvoiceNumber": "82868509",
"OrderAmount": "15.00",
"AvailableRefundAmount": "12000",
"RMANote": "This is a test RMA",
"PriorRefundAmount": "2.00",
"CustomerName": "abc Roosevelt",
"CustomerPhoneNumber": "626-271-9700",
"CustomerEmailAddress": "gdv6l0viwo4l7j1d@marketplace.newegg.com",
"ShipToAddress1": "1941 E. Cedar Loop Drive",
"ShipToAddress2": "9A",
"ShipToCityName": "South Weber",
"ShipToStateCode": "UT",
"ShipToZipCode": "884405",
"ShipToLastName":"Roosevelt",
"ShipToFirstName":"abc",
"RMATransactionList": {
"RMATransaction": {
322
"SellerPartNumber": "201112310900",
"MfrPartNumber": "201112310900",
"NeweggItemNumber": "9SIA0040286987",
"Description": "ICYTEST201112310900",
"UnitPrice": "600.00",
"ReturnQuantity": "1",
"ReturnUnitPrice": "1.00",
"RefundShippingPrice": "1.00",
"RMAReason": "2",
"RMAReasonDescription": "Defective"
}
}
}
}
}
13.1.4. Request Failure Errors
For common HTTP error responses, please refer to Common Error Responses
Error Code
Description
SE001
Invalid SellerPartNumber
SE003
OrderNumber is required
SE004
Cannot issue RMA because the order has not been invoiced.
SE005
ShipMethodCode is required when RMAType is replacement
SE006
RMATransaction is required in RMATransactionList
SE007
ReasonCode is required
SE008
Return Qty must be greater than zero
SE009
[Seller Part #] Return Qty has to be equal to or less than Max Return Qty - Prior Returned Qty, currently the
available return qty = {0}.
SE010
Refund per Qty must be greater than zero.
SE011
{Seller Part #} refund price per Qty cannot be greater than item unit price, which = {0.00}.
SE012
Order Shipping Refund cannot be greater than Order Shipping Charge, which = {0.00}.
SE013
Replacement RMA Order Qty cannot be greater than item available inventory.
SE014
Item(s) has two fulfillment channels. Please use DiffShippedByPartyAction field to resolve this issue.
SE020
The following item(s) must return with the current item(s) since they are in a same Combo or Auto Add to Cart
promotion :{ Seller Part # List}.
SE021
The item’s ReturnUnitPrice cannot be greater than the item’s order’s UnitPrice, which = {0.00}.
SE023
Total refund amount cannot exceed total order amount, which = {0.00}.
323
SE024
Item does not exist.
SE025
Cannot issue RMA because the order type is invalid.
SE026
Cannot issue RMA because the order is a replacement order.
SE027
Cannot issue RMA because the order has been voided.
SE031
Auto Receive is not available for order returns processed by Newegg.
SE032
Cannot issue RMA as Auto Receive because the RMA type is not refund.
SE034
Refund cannot exceed order total minus previous refunded amount[{0}]
SE035
This seller account currently does not support the selected shipping method {0}. Please setup this shipping
setting in Seller Portal or select another shipping method.
SE036
The item:{seller part #} unit product refund cannot be less than {minimum refund amount} per account
restocking fee setting: {seller restocking fee rate }
SE038
International seller covered by Newegg Buy-out policy cannot request return or refund directly. Please
contact MarketplaceSupport@newegg.com for assistance.
SE039
This item is not eligible for {refund |replacement}
SE040
This seller RMA number must be a text of number and/or letters.
Example: XML, Response
<?xml version="1.0" encoding="utf-8"?>
<Errors>
<Error>
<Code>SE004</Code>
<Message>Cannot issue RMA because the order has not been invoiced</Message>
</Error>
</Errors>
Example: Json, Response
{
"Code": "SE004",
"Message": "Cannot issue RMA because the order has not been invoiced"
}
13.2. Update RMA
Receive, Edit, Reject or Void an existing RMA.
324
13.2.1. Resource URL & Information
Resource URL
https://api.newegg.com/marketplace/servicemgmt/rma/updaterma?sellerid={sellerid}&version={versionno}
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
version
No
Available version numbers: 307
Resource Information
HTTP Method
Authentication?
Request Formats
Response Formats
Rate Limited?
POST
Required
XML, Json
XML, Json
30 per min per client
13.2.2. Request Body
Edit RMA
Attribute
Required?
Format
Description
NeweggAPIRequest
IssueUser
No
String
Specify your eligible seller account (email
address) here.
Only choose from seller account existing login
(email)
OperationType
Yes
String
Fixed value: EditRMARequest
RequestBody
EditRMAInfo
RMANumber
Yes
integer
RMA Number
RMAType
Yes
integer
Available values:
1: Replacement
2: Refund
SellerRMANumber
No
String
Seller RMA #.
An alphanumeric string, max 50 characters.
Note: only available for version=307
RMANote
No
String
The comment in this RMA
Max 4000 character(s).
RMA
Tran
sacti
onLi
st
RMA
Tran
sacti
on
SellerPartNumber
Yes
String
Seller Part Number
ReturnQuantity
Yes
integer
The return quantity of each SKU in this RMA
325
ReturnUnitPrice
Yes if
Refund
type
decimal
The return unit price of each SKU in refund RMA
NOTE: All amounts are set in U.S. Dollars (USD).
RefundShippingPric
e
Yes if
Refund
type
decimal
The shipping amount of refund of each SKU in
this RMA
NOTE: All amounts are set in U.S. Dollars (USD).
RMAReason
Yes
integer
The replacement/refund reason of each SKU in
this RMA.
Available values:
1: Carrier damage
2: Defective
3: Incompatible
4: No longer needed
5: Not match what we show
6: Ordered wrong item
7: Sent wrong item
8: Unsatisfied
Example: XML, Edit RMA
XSD
API Schema > RMAManagement > RMA > UpdateRMA > UpdateRMARequest.xsd
API Schema > RMAManagement > RMA > UpdateRMA > _UpdateRMA > _RMAEdit.xsd
POST https://api.newegg.com/marketplace/servicemgmt/rma/updaterma?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggAPIRequest>
<OperationType>EditRMARequest</OperationType>
<RequestBody>
<EditRMAInfo>
<RMANumber>38875640</RMANumber>
<RMAType>2</RMAType>
<SellerRMANumberE12345678</SellerRMANumber>
<RMANote>your note here</RMANote>
<RMATransactionList>
<RMATransaction>
<SellerPartNumber>Ben_item_12</SellerPartNumber>
326
<ReturnQuantity>1</ReturnQuantity>
<ReturnUnitPrice>200</ReturnUnitPrice>
<RefundShippingPrice>10</RefundShippingPrice>
<RMAReason>5</RMAReason>
</RMATransaction>
</RMATransactionList>
</EditRMAInfo>
</RequestBody>
</NeweggAPIRequest>
Example: Json, Edit RMA
POST https://api.newegg.com/marketplace/servicemgmt/rma/updaterma?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"OperationType": "EditRMARequest",
"RequestBody": {
"EditRMAInfo": {
"RMANumber": "38875640",
"RMAType": "2",
“SellerRMANumber”:”E12345678”,
"RMANote": "your note here",
"RMATransactionList": {
"RMATransaction": {
"SellerPartNumber": "Ben_item_12",
"ReturnQuantity": "1",
"ReturnUnitPrice": "200",
"RefundShippingPrice": "10",
"RMAReason": "5"
}
}
}
}
}
327
Reject RMA
Attribute
Required?
Format
Description
NeweggAPIRequest
IssueUser
No
String
Specify your eligible seller account (email address) here.
OperationType
Yes
String
Fixed value: RejectRMARequest
RequestBody
RejectRMAInfo
RMANumber
Yes
Integer
RMA Number
RejectReason
Yes
Integer
The reason you reject this RMA
Available values:
1: Remove/Missing Serial Number/Graffiti
2: Warranty Expired
3: Physical Damage
4: Item Missing/Parts Missing
5: Wrong Item Returned
ShipCarrier
Yes
Integer
Which carrier you want to use.
Available values:
1: UPS
2: FedEx
3: DHL
4: USPS
5: Other
OtherShipCarrier
Yes when
ShipCarrier
= Other
String
The actual ship carrier if the ship carrier type is specified as
other.
Max 10 character(s).
Only apply on Other ShipCarrier.
ShipService
Yes
String
Which ship service you want to use
Max 50 character(s).
TrackingNumberList
TrackingNumber
Yes
String
The tracking # of shipment(s).
328
Example: XML, Reject RMA
XSD
API Schema > RMAManagement > RMA > UpdateRMA > UpdateRMARequest.xsd
API Schema > RMAManagement > RMA > UpdateRMA > _UpdateRMA > _RMAReject.xsd
POST https://api.newegg.com/marketplace/servicemgmt/rma/updaterma?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggAPIRequest>
<OperationType>RejectRMARequest</OperationType>
<RequestBody>
<RejectRMAInfo>
<RMANumber>38863380</RMANumber>
<RejectReason>3</RejectReason>
<ShipCarrier>5</ShipCarrier>
<OtherShipCarrier>other</OtherShipCarrier>
<ShipService>Ground</ShipService>
<TrackingNumberList>
<TrackingNumber>123123123123</TrackingNumber>
</TrackingNumberList>
</RejectRMAInfo>
</RequestBody>
</NeweggAPIRequest>
Example: Json, Reject RMA
POST https://api.newegg.com/marketplace/servicemgmt/rma/updaterma?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"OperationType": "RejectRMARequest",
"RequestBody": {
"RejectRMAInfo": {
"RMANumber": "38863380",
329
"RejectReason": "3",
"ShipCarrier": "5",
"OtherShipCarrier": "other",
"ShipService": "Ground",
"TrackingNumberList": { "TrackingNumber": "123123123123" }
}
}
}
Void RMA
Attribute
Required?
Format
Description
NeweggAPIRequest
IssueUser
No
String
Specify your eligible seller account (email address) here.
Only choose from seller account existing login (email).
OperationType
Yes
String
Fixed value: VoidRMARequest
RequestBody
VoidRMAInfo
RMANumber
Yes
Integer
RMA Number
VoidReason
Yes
String
The reason you void this RMA.
Max 1000 character(s).
Example: XML, Void RMA
XSD
API Schema > RMAManagement > RMA > UpdateRMA > UpdateRMARequest.xsd
API Schema > RMAManagement > RMA > UpdateRMA > _UpdateRMA > _RMAVoid.xsd
POST https://api.newegg.com/marketplace/servicemgmt/rma/updaterma?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggAPIRequest>
<OperationType>VoidRMARequest</OperationType>
<RequestBody>
<VoidRMAInfo>
<RMANumber>38875600</RMANumber>
330
<VoidReason>Customer Requested</VoidReason>
</VoidRMAInfo>
</RequestBody>
</NeweggAPIRequest>
Example: Json, Void RMA
POST https://api.newegg.com/marketplace/servicemgmt/rma/updaterma?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"OperationType": "VoidRMARequest",
"RequestBody": {
"VoidRMAInfo": {
"RMANumber": "38875600",
"VoidReason": "Customer Requested"
}
}
}
Receive RMA
Attribute
Required?
Format
Description
NeweggAPIRequest
IssueUser
No
String
Specify your eligible seller account (email address) here.
Only choose from seller account existing login (email).
OperationType
Yes
String
Fixed value: ReceiveRMARequest
RequestBody
ReceiveRMAInfo
RMANumber
Yes
Integer
RMA Number
Example: XML, Receive RMA
XSD
API Schema > RMAManagement > RMA > UpdateRMA > UpdateRMARequest.xsd
331
API Schema > RMAManagement > RMA > UpdateRMA > _UpdateRMA > _RMAReceive.xsd
POST https://api.newegg.com/marketplace/servicemgmt/rma/updaterma?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggAPIRequest>
<OperationType>ReceiveRMARequest</OperationType>
<RequestBody>
<ReceiveRMAInfo>
<RMANumber>38873480</RMANumber>
</ReceiveRMAInfo>
</RequestBody>
</NeweggAPIRequest>
Example: Json, Receive RMA
POST https://api.newegg.com/marketplace/servicemgmt/rma/updaterma?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"OperationType": "ReceiveRMARequest",
"RequestBody": {
"ReceiveRMAInfo": { "RMANumber": "38873480" }
}
}
332
13.2.3. Response Body
Attribute
Format
Description
NeweggAPIResponse
IsSuccess
String
Used to identify if the current operation is successful.
Returns true or false.
OperationType
String
EditRMAResponse
RejectRMAResponse
VoidRMAResponse
ReceiveRMAResponse
SellerID
String
Your seller ID
Memo
String
Additional messages
ResponseDate
String
Response date (Pacific Standard Time)
ResponseBody
RMAInfo
RMANumber
Integer
RMA number
RMAType
Integer
Available values:
1: Replacement
2: Refund
RMATypeDescription
String
Replacement for status code: 1
Refund for status code: 2
SourceSONumber
Integer
The relevant SO number of the RMA
SellerRMANumber
String
Seller RMA #.
An alphanumeric string, max 50 characters.
Note: only available for version=307
IssueUser
String
RMA Issue User or Seller ID (if RMA Issue User was not
specified when RMA was created).
RMAShipMethod
Integer
The ship method if you want issue a replacement RMA.
1: Super Saver(7-14 business days)
2: Standard Shipping(5-7 business days)
3: Expedited Shipping(3-5 business days)
4: Two-Day Shipping(2 business days)
5: One-Day Shipping(Next day)
6: International Economy Shipping(8-15 business days)
7: International Standard Shipping(5-7 business days)
8: International Expedited Shipping(3-5 business days)
9: International Two-Day Shipping(2 business days)
10: APO/FPO Military ONLY
11: Newegg Premier 3 Days
12: Newegg Premier 2 Days
333
13: Newegg Premier Next Day
If RMA = Refund, then this element will appear blank.
NOTE: Newegg will apply the same ship method used
by order.
RMAShipMethodDescription
String
Super Saver(7-14 business days)for status code: 1
Standard Shipping(5-7 business days) for status code: 2
Expedited Shipping(3-5 business days) for status code:
3
Two-Day Shipping(2 business days)for status code: 4
One-Day Shipping(Next day)for status code: 5
International Economy Shipping(8-15 business days)for
status code: 6
International Standard Shipping(5-7 business days)for
status code: 7
International Expedited Shipping (3-5 business days)for
status code: 8
International Two-Day Shipping(2 business days) for
status code :9
APO/FPO Military ONLY for status code:10
Newegg Premier 3 Days for status code:11
Newegg Premier 2 Days for status code:12
Newegg Premier Next Day for status code:13
If RMA = Refund, then this element will appear blank.
NOTE: Newegg will apply the same ship method used
by order.
RMANote
String
The comment in this RMA
RMATransactionList
RMATransaction
SellerPartNumber
String
The seller part number to identify a SKU
ReturnQuantity
Integer
The return quantity of each SKU in this RMA
ReturnUnitPrice
Decimal
The return unit price of each SKU in refund RMA.
If RMA = Replacement, then this element will appear
blank.
NOTE: All amounts are set in U.S. Dollars (USD).
RefundShippingPrice
Decimal
The shipping amount of refund of each SKU in this
RMA. If RMA = Replacement, then this element will
appear blank.
NOTE: All amounts are set in U.S. Dollars (USD).
RMAReason
Integer
The replacement/refund reason of each SKU in this
RMA.
334
Available values:
1: Carrier damage
2: Defective
3: Incompatible
4: No longer needed
5: Not match what we show
6: Ordered wrong item
7: Sent wrong item
8: Unsatisfied
9: Other Reason {0}
RMAReasonDescription
String
Carrier damage for status code: 1
Defective for status code: 2
Incompatible for status code: 3
No longer needed for status code: 4
Not match what we show for status code: 5
Ordered wrong item for status code: 6
Sent wrong item for status code: 7
Unsatisfied for status code: 8
Other Reason {0} for status code: 9
Example: XML, Response
XSD
API Schema > RMAManagement > RMA > UpdateRMA > UpdateRMAResponse.xsd
<?xml version=”1.0 encoding=utf-8?>
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<OperationType>EditRMAResponse</OperationType>
<SellerID>A006</SellerID>
<Memo />
<ResponseDate>2011-09-28 09:02:00</ResponseDate>
<ResponseBody>
<RMAInfo>
<RMANumber>38875640</RMANumber>
<RMAType>2</RMAType>
<RMATypeDescription>Refund</RMATypeDescription>
<SourceSONumber>88219202</SourceSONumber>
<SellerRMANumber>E12345678</SellerRMANumber>
335
<RMAShipMethod />
<RMAShipMethodDescription />
<RMANote>your note here</RMANote>
<IssueUser>test@newegg.com</IssueUser>
<RMATransactionList>
<RMATransaction>
<SellerPartNumber>Ben_item_12</SellerPartNumber>
<ReturnQuantity>1</ReturnQuantity>
<ReturnUnitPrice>200.00</ReturnUnitPrice>
<RefundShippingPrice>10.00</RefundShippingPrice>
<RMAReason>1</RMAReason>
<RMAReasonDescription>Carrier damage</RMAReasonDescription>
</RMATransaction>
</RMATransactionList>
</RMAInfo>
</ResponseBody>
</NeweggAPIResponse>
Example: Json, Response
{
"IsSuccess": "true",
"OperationType": "EditRMAResponse",
"SellerID": "A006",
"ResponseDate": "2011-09-28 09:02:00",
"ResponseBody": {
"RMAInfo": {
"RMANumber": "38875640",
"RMAType": "2",
"RMATypeDescription": "Refund",
"SourceSONumber": "88219202",
“SellerRMANumber”:”E12345678”,
"RMANote": "your note here",
"IssueUser": "test@newegg.com",
"RMATransactionList": {
"RMATransaction": {
"SellerPartNumber": "Ben_item_12",
"ReturnQuantity": "1",
"ReturnUnitPrice": "200.00",
"RefundShippingPrice": "10.00",
"RMAReason": "1",
336
"RMAReasonDescription": "Carrier damage"
}
}
}
}
}
13.2.4. Request Failure Errors
Edit RMA
For common HTTP error responses, please refer to Common Error Responses
Error Code
Description
SE001
Invalid SellerPartNumber
SE004
Cannot issue RMA because the order has not been invoiced.
SE005
ShipMethodCode is required when RMAType is replacement
SE006
RMATransaction is required
SE009
[Seller Part #] Return Qty has to be equal to or less than Max Return Qty - Prior Returned Qty, currently the
available return qty = {0}.
SE010
Refund per Qty must be greater than zero.
SE011
{Seller Part #} refund price per Qty cannot be greater than item unit price, which = {0.00}.
SE012
Order Shipping Refund cannot be greater than Order Shipping Charge, which = {0.00}.
SE013
Replacement RMA Order Qty cannot be greater than item available inventory, which = {0.00}.
SE014
Items have two shipped channels.
SE017
RMANumber is required
SE020
The following item(s) must return with the current item(s) since they are in a same Combo or Auto Add to Cart
promotion:{0}.
SE021
The item’s ReturnUnitPrice cannot be greater than the item’s order’s UnitPrice, which = {0.00}.
SE023
Total refund amount cannot exceed total order amount, which = {0.00}.
SE024
Item does not exist
SE028
Can’t update because RMA was not open
SE029
Can’t update because RMA type = advanced. Please contact Newegg Marketplace Support.
SE034
This seller account currently does not support the selected shipping method {0}. Please setup this shipping
setting in Seller Portal or select another shipping method.
SE035
Refund cannot exceed order total minus previous refunded amount[{0}]
337
SE038
International seller covered by Newegg Buy-out policy cannot request return or refund directly. Please
contact MarketplaceSupport@newegg.com for assistance.
SE040
This seller RMA number must be a text of number and/or letters.
Reject RMA
Error Code
Description
SE001
Invalid SellerPartNumber
SE015
TrackingNumber is required.
SE016
TrackingNumber already exists.
SE017
RMANumber is required
SE028
Can’t update because RMA was not open
SE029
Can’t update because RMA type = advanced. Please contact Newegg Marketplace Support.
SE030
Can't update because international seller processing by Newegg
Void RMA
Error Code
Description
SE017
RMANumber is required
SE028
Can’t update because RMA was not open
SE029
Can’t update because RMA type = advanced. Please contact Newegg Marketplace Support.
SE030
Can't update because international seller processing by Newegg
Receive RMA
Error Code
Description
SE014
Items have two shipped channels.
SE017
RMANumber is required
SE028
Can’t update because RMA was not open
SE029
Can’t update because RMA type = advanced. Please contact Newegg Marketplace Support.
SE030
Can't update because international seller processing by Newegg
Example: XML, Response
<?xml version="1.0" encoding="utf-8"?>
<Errors>
<Error>
<Code>SE004</Code>
338
<Message>Cannot issue RMA because the order has not been invoiced</Message>
</Error>
</Errors>
Example: Json, Response
{
"Code": "SE004",
"Message": "Cannot issue RMA because the order has not been invoiced"
}
13.3. Get RMA Info
Get RMA info by specified query conditions.
13.3.1. Resource URL & Information
Resource URL
https://api.newegg.com/marketplace/servicemgmt/rma/rmainfo?sellerid={sellerid}&version={versionno}
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
version
No
Available Version Numbers
307. Response includes the Seller’s own RMA # for reference.
309. Response includes:
Seller’s own RMA # for reference.
The replacement order # for related RMA.
Resource Information
HTTP Method
Authentication?
Request Formats
Response Formats
Rate Limited?
PUT
Required
XML, Json
XML, Json
30 per min per client
13.3.2. Request Body
339
Attribute
Required?
Format
Description
NeweggAPIRequest
IssueUser
No
string
Specify your eligible seller account (email address) here.
Only choose from seller account existing login (email)
OperationType
Yes
String
Fixed value: GetRMAInfoRequest
PageSize
No
Integer
How many records in a page. (Max is 100 per page)
If left blank, will use 1 as default.
PageIndex
No
Integer
Current page index. Default is 1.
If left blank, will use 100 as default.
KeywordsType
No
Integer
Available values:
1: RMANumber
2: OrderNumber
3: CustomerName
4: SellerRMANumber (Note: only available for
version=307)
KeywordsValue
No
String
The keywords value of the specified type
Status
No
Integer
Available values:
0: All (Default)
1: Open
2: Received
3: Rejected
4: Voided
5: Closed
6: Processing
RMADateFrom
No
String
Search RMA by date range.
(Pacific Standard Time)
Please refer to the Acceptable Date Format
RMADateTo
No
String
Search RMA by date range.
(Pacific Standard Time)
Please refer to the Acceptable Date Format
RMAType
No
Integer
Available values:
0: All (Default)
1: Replacement
2: Refund
ProcessedBy
No
Integer
Available values:
0: All (Default)
1: Seller
340
2: Newegg
Example: XML, Request
XSD
API Schema > RMAManagement > RMA > GetRMAInfo > RMAInfoRequest.xsd
PUT https://api.newegg.com/marketplace/servicemgmt/rma/rmainfo?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggAPIRequest>
<OperationType>GetRMAInfoRequest</OperationType>
<RequestBody>
<PageInfo>
<PageIndex>1</PageIndex>
<PageSize>10</PageSize>
</PageInfo>
<KeywordsType>1</KeywordsType>
<KeywordsValue>2135422</KeywordsValue>
<Status>0</Status>
<RMADateFrom>2012-01-11</RMADateFrom>
<RMADateTo>2012-01-12</RMADateTo>
<RMAType>0</RMAType>
<ProcessedBy>0</ProcessedBy>
</RequestBody>
</NeweggAPIRequest>
Example: Json, Request
PUT https://api.newegg.com/marketplace/servicemgmt/rma/rmainfo?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
341
Accept: application/json
{
"OperationType": "GetRMAInfoRequest",
"RequestBody": {
"PageInfo": {
"PageIndex": "1",
"PageSize": "10"
},
"KeywordsType": "1",
"KeywordsValue": "2135422",
"Status": "0",
"RMADateFrom": "2012-01-11",
"RMADateTo": "2012-01-12",
"RMAType": "0",
"ProcessedBy": "0"
}
}
342
13.3.3. Response Body
Attribute
Format
Description
Available
Ver.#
NeweggAPIResponse
IsSuccess
String
Used to identify the operation of Submit
RMA is successful. Returns true or false.
All
OperationType
String
Fixed value: IssueRMAResponse
All
SellerID
String
Your seller ID
All
ResponseBody
PageInfo
TotalCount
Integer
How many record(s) for you request
All
TotalPageCount
Integer
How many page(s) return
All
PageIndex
Integer
Current page index. (Default is 1)
All
PageSize
Integer
How many record(s) in a page. (Max 100
per page)
All
RMAInfoList
RMAInfo
RMANumber
Integer
RMA number
All
RMAType
Integer
Available values:
1: Replacement
2: Refund
All
RMATypeDescription
String
Replacement for type value: 1
Refund for type value: 2
All
SellerRMANumber
String
Seller RMA #.
An alphanumeric string, max 50
characters.
Note: available for version=307 and 309
307,
309
ReplacementOrderNumber
String
The Order Number of the replacement
order.
After confirming the return item is
received, Newegg will create a
replacement order for you to process.
Note: available for RMA type:
Replacement (RMAType value= 1) and
the request version=309
309
IssueUser
String
RMA Issue User or Seller ID (if RMA Issue
User was not specified when RMA was
created).
All
RMADate
String
Date of RMA(Pacific Standard Time)
All
343
RMAStatus
Integer
Available values:
1: Open
2: Received
3: Rejected
4: Voided
5: Closed
6: Processing
All
RMAStatusDescription
String
Available values:
Open for status code: 1
Received for status code: 2
Rejected for status code: 3
Voided for status code: 4
Closed for status code: 5
Processing for status code: 6
All
RMAShipMethod
Integer
The ship method if the RMA type =
Replacement:
1: Super Saver(7-14 business days)
2: Standard Shipping(5-7 business days)
3: Expedited Shipping(3-5 business days)
4: Two-Day Shipping(2 business days)
5: One-Day Shipping(Next day)
6: International Economy Shipping(8-15
business days)
7: International Standard Shipping(5-7
business days)
8: International Expedited Shipping(3-5
business days)
9: International Two-Day Shipping(2
business days)
10: APO/FPO Military ONLY
11: Newegg Premier 3 Days
12: Newegg Premier 2 Days
13: Newegg Premier Next Day
If RMA = Refund, then this element will
appear blank.
All
344
RMAShipMethodDescription
String
The ship method if the RMA type =
Replacement:
Super Saver(7-14 business days)for status
code: 1
Standard Shipping(5-7 business days) for
status code: 2
Expedited Shipping(3-5 business days) for
status code: 3
Two-Day Shipping(2 business days)for
status code: 4
One-Day Shipping(Next day)for status
code: 5
International Economy Shipping(8-15
business days)for status code: 6
International Standard Shipping(5-7
business days)for status code: 7
International Expedited Shipping (3-5
business days)for status code: 8
International Two-Day Shipping(2
business days) for status code :9
APO/FPO Military ONLY for status
code:10
Newegg Premier 3 Days for status
code:11
Newegg Premier 2 Days for status
code:12
Newegg Premier Next Day for status
code:13
If RMA = Refund, then this element will
appear blank.
All
OrderNumber
Integer
Order Number of the RMA requested
All
OrderDate
String
Order Date(Pacific Standard Time)
All
InvoiceNumber
Integer
Invoice Number of the order RMA
requested.
All
OrderAmount
Decima
l
Order Amount
NOTE: All amounts are set in U.S. Dollars
(USD).
All
AvailableRefundAmount
Decima
l
Available Refund Amount
NOTE: All amounts are set in U.S. Dollars
(USD).
All
345
RMAProcessedBy
String
Newegg or Seller
All
RMAReceiveDate
String
RMA shipment received date
All
RMANote
String
RMA note
All
PriorRefundAmount
Decima
l
Order Prior Refund Amount
NOTE: All amounts are set in U.S. Dollars
(USD).
All
CustomerName
String
Customer Name
All
CustomerPhoneNumber
String
Customer Phone Number
All
CustomerEmailAddress
String
The masked customer email address, you
can reach to the customer through this
email address.
For example:
gdv6l0viwo4l7j1d@marketplace.newegg.
com
All
ShipToAddress1
String
The order’s ship to address line 1
All
ShipToAddress2
String
The order’s ship to address line 2
All
ShipToCityName
String
The order’s ship to city name
All
ShipToStateCode
String
The order’s ship to state code
(abbreviated)
All
ShipToZipCode
String
The order’s ship to zip code
All
ShipToCountryCode
String
The order’s ship to country.
E.g. UNITED STATES
All
ShipToLastName
String
The ship to Last Name
All
ShipToFirstName
String
The ship to First Name
All
ShipToCompany
String
The order’s ship to company name
All
RMATransactionList
RMATransaction
SellerPartNumber
String
Seller Part Number
All
MfrPartNumber
String
Manufacturer Part Number
All
NeweggItemNumber
String
Newegg Item Number
All
Description
String
Item Description
All
UnitPrice
decima
l
Item’s Unit Price
NOTE: All amounts are set in U.S. Dollars
(USD).
All
ReturnQuantity
Integer
The return quantity of each SKU in this
RMA
All
346
ReturnUnitPrice
decima
l
If RMA type = Refund: The return unit
price of each item in refund RMA. How
much refund will be issued per unit of this
item. If RMA = Replacement, then this
element will appear blank.
NOTE: All amounts are set in U.S. Dollars
(USD).
All
RefundShippingPrice
decima
l
If RMA type = Refund: The shipping
amount of refund of each item in this
RMA. If RMA = Replacement, then this
element will appear blank.
NOTE: All amounts are set in U.S. Dollars
(USD).
All
ShippedBy
Integer
If RMA type = Replacement:
Indicates if shipped by Newegg.
0: Shipped by seller
1: Shipped by Newegg
If RMA = Refund, then this element will
appear blank.
All
RMAReason
Integer
The replacement/refund reason of each
SKU in this RMA.
Available values:
1: Carrier damage
2: Defective
3: Incompatible
4: No longer needed
5: Not match what we show
6: Ordered wrong item
7: Sent wrong item
8: Unsatisfied
9: Other Reason {0}
All
347
RMAReasonDescriptio
n
String
The replacement/refund reason of each
SKU in this RMA.
Available values:
Carrier damage for status code: 1
Defective for status code: 2
Incompatible for status code: 3
No longer needed for status code: 4
Not match what we show for status
code: 5
Ordered wrong item for status code: 6
Sent wrong item for status code: 7
Unsatisfied for status code: 8
Other Reason {0} for status code: 9
All
Memo
String
Additional messages
All
ResponseDate
String
Response date
All
Example: XML, Response
XSD
API Schema > RMAManagement > RMA > GetRMAInfo > RMAInfoResponse.xsd
<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<OperationType>GetRMAInfo</OperationType>
<SellerID>A006</SellerID>
<ResponseDate>05/16/2013 14:57:25</ResponseDate>
<Memo></Memo>
<ResponseBody>
<PageInfo>
<TotalCount>1</TotalCount>
<TotalPageCount>1</TotalPageCount>
<PageIndex>1</PageIndex>
<PageSize>50</PageSize>
</PageInfo>
<RMAInfoList>
<RMAInfo>
<RMANumber>53424440</RMANumber>
<RMAType>2</RMAType>
348
<RMATypeDescription>Refund</RMATypeDescription>
<SellerRMANumber>E12345678</SellerRMANumber>
<IssueUser>A006</IssueUser>
<RMADate>12/19/2012 00:06:30</RMADate>
<RMAStatus>5</RMAStatus>
<RMAStatusDescription>Closed</RMAStatusDescription>
<RMAShipMethod></RMAShipMethod>
<RMAShipMethodDescription></RMAShipMethodDescription>
<OrderNumber>153985075</OrderNumber>
<OrderDate>12/18/2012 23:00:09</OrderDate>
<InvoiceNumber>95843690</InvoiceNumber>
<OrderAmount>3.99</OrderAmount>
<AvailableRefundAmount>0.00</AvailableRefundAmount>
<RMAProcessedBy>Seller</RMAProcessedBy>
<RMAReceiveDate>01/09/2013 18:40:28</RMAReceiveDate>
<RMANote></RMANote>
<PriorRefundAmount>0.00</PriorRefundAmount>
<CustomerName>Fiona Test</CustomerName>
<CustomerPhoneNumber>626-271-1420</CustomerPhoneNumber>
<CustomerEmailAddress>cq2sw1pler2vt958m@marketplace.newegg.com</CustomerEmailAddress>
<ShipToAddress1>17708 Rowland St</ShipToAddress1>
<ShipToAddress2></ShipToAddress2>
<ShipToCityName>Rowland Heights</ShipToCityName>
<ShipToStateCode>CA</ShipToStateCode>
<ShipToZipCode>91748-1119</ShipToZipCode>
<ShipToCountryCode>UNITED STATES</ShipToCountryCode>
<ShipToLastName>Test</ShipToLastName>
<ShipToFirstName>Fiona</ShipToFirstName>
<ShipToCompany></ShipToCompany>
<RMATransactionList>
<RMATransaction>
<SellerPartNumber>nz-tst-123</SellerPartNumber>
<MfrPartNumber>nz-tst-123</MfrPartNumber>
<NeweggItemNumber>9SIA0060BB9157</NeweggItemNumber>
<Description>Nazi Power Flag</Description>
<UnitPrice>3.99</UnitPrice>
<ReturnQuantity>1</ReturnQuantity>
<ReturnUnitPrice>3.99</ReturnUnitPrice>
<RefundShippingPrice>0.00</RefundShippingPrice>
<ShippedBy></ShippedBy>
<RMAReason>4</RMAReason>
349
<RMAReasonDescription>No longer needed</RMAReasonDescription>
</RMATransaction>
</RMATransactionList>
</RMAInfo>
</RMAInfoList>
</ResponseBody>
</NeweggAPIResponse>
Example: Json, Response
{
"IsSuccess": "true",
"OperationType": "GetRMAInfo",
"SellerID": "A006",
"ResponseDate": "05/16/2013 14:57:25",
"ResponseBody": {
"PageInfo": {
"TotalCount": "1",
"TotalPageCount": "1",
"PageIndex": "1",
"PageSize": "50"
},
"RMAInfoList": {
"RMAInfo": {
"RMANumber": "53424440",
"RMAType": "2",
"RMATypeDescription": "Refund",
“SellerRMANumber”:”E12345678”,
"IssueUser": "A006",
"RMADate": "12/19/2012 00:06:30",
"RMAStatus": "5",
"RMAStatusDescription": "Closed",
"OrderNumber": "153985075",
"OrderDate": "12/18/2012 23:00:09",
"InvoiceNumber": "95843690",
"OrderAmount": "3.99",
"AvailableRefundAmount": "0.00",
"RMAProcessedBy": "Seller",
"RMAReceiveDate": "01/09/2013 18:40:28",
"PriorRefundAmount": "0.00",
"CustomerName": "Fiona Test",
350
"CustomerPhoneNumber": "626-271-1420",
"CustomerEmailAddress": "cq2sw1pler2vt958m@marketplace.newegg.com",
"ShipToAddress1": "17708 Rowland St",
"ShipToCityName": "Rowland Heights",
"ShipToStateCode": "CA",
"ShipToZipCode": "91748-1119",
"ShipToCountryCode": "UNITED STATES",
"ShipToLastName": "Test",
"ShipToFirstName": "Fiona",
"RMATransactionList": {
"RMATransaction": {
"SellerPartNumber": "nz-tst-123",
"MfrPartNumber": "nz-tst-123",
"NeweggItemNumber": "9SIA0060BB9157",
"Description": "Nazi Power Flag",
"UnitPrice": "3.99",
"ReturnQuantity": "1",
"ReturnUnitPrice": "3.99",
"RefundShippingPrice": "0.00",
"RMAReason": "4",
"RMAReasonDescription": "No longer needed"
}
}
}
}
}
}
13.3.4. Request Failure Errors
For common HTTP error responses, please refer to Common Error Responses
Example: XML, Response
<?xml version="1.0" encoding="utf-8"?>
<Errors>
<Error>
<Code>CE001</Code>
<Message>SellerID cannot be null or empty</Message>
</Error>
351
</Errors>
Example: Json, Response
{
"Code": "CE001",
"Message": "SellerID cannot be null or empty"
}
13.4. Issue Courtesy Refund
Submit a Courtesy Refund Request. Use this function when it is simply to issue the customer a courtesy refund that does
not require RMA shipment returned to seller. This function is a request and will need user to use Get Request Status
(listed in the next section) to receive update about the status of the Courtesy Refund creation. Please note that
commission will not be refunded for refunds issued as courtesy refund.
13.4.1. Resource URL & Information
Resource URL
https://api.newegg.com/marketplace/servicemgmt/courtesyrefund/new?sellerid={sellerid}
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
Resource Information
HTTP Method
Authentication?
Request Formats
Response Formats
Rate Limited?
POST
Required
XML, Json
XML, Json
30 per min per client
13.4.2. Request Body
Attribute
Requir
ed?
Format
Description
New
egg
APIR
equ
est
IssueUser
No
String
Specify your eligible seller account (email address) here.
Only choose from seller account existing login (email)
352
OperationType
Yes
String
Fixed value: IssueCourtesyRefund
RequestBody
IssueCourtesyRefund
SourceSONumbe
r
Yes
Integer
Order Number which you wish to issue a courtesy refund for.
RefundReason
Yes
Integer
Available values for refund reason:
1: Negative customer feedback
2: Pricing error
3: Wrong item information
4: Shipping delay
5: Package not received
6: Customer Courtesy
TotalRefundAmo
unt
Yes
Decimal
The total amount need to refund.
The total refund amount cannot exceed order amount or order
amount minus previously refunded amount.
NOTE: All amounts are set in U.S. Dollars (USD).
NoteToCustomer
No
String
The note of this courtesy refund to customer.
Max 500 character(s).
Example: XML, Request
XSD
API Schema > RMAManagement > RMA > CourtesyRefund > IssueCourtesyRefund > IssueCRRequest.xsd
POST https://api.newegg.com/marketplace/servicemgmt/courtesyrefund/new?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggAPIRequest>
<OperationType>IssueCourtesyRefund</OperationType>
<RequestBody>
<IssueCourtesyRefund>
<SourceSONumber>11007735</SourceSONumber>
<RefundReason>1</RefundReason>
<TotalRefundAmount>2.01</TotalRefundAmount>
<NoteToCustomer>this is a test note</NoteToCustomer>
</IssueCourtesyRefund>
</RequestBody>
353
</NeweggAPIRequest>
Example: Json, Request
POST https://api.newegg.com/marketplace/servicemgmt/courtesyrefund/new?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"OperationType": "IssueCourtesyRefund",
"RequestBody": {
"IssueCourtesyRefund": {
"SourceSONumber": "11007735",
"RefundReason": "1",
"TotalRefundAmount": "2.01",
"NoteToCustomer": "this is a test note"
}
}
}
13.4.3. Response Body
Attribute
Format
Description
NeweggAPIResponse
IsSuccess
String
Used to identify if the operation of Issue Courtesy Refund is
successful. Returns true or false
OperationType
String
Fixed value: CourtesyRefundResponse
SellerID
String
Your Seller ID
ResponseBody
ResponseList
ResponseInfo
RequestID
String
The request ID
RequestDate
String
The date when the request was submitted. (Pacific Standard
Time)
RequestSatus
String
The status of the request submission.
SUBMITTED
Memo
String
Additional information
Example: XML, Response
354
XSD
API Schema > RMAManagement > RMA > CourtesyRefund > IssueCourtesyRefund > IssueCRResponse.xsd
<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<OperationType>CourtesyRefundResponse</OperationType>
<SellerID>A006</SellerID>
<ResponseBody>
<ResponseList>
<ResponseInfo>
<RequestId>cb0c9123-b7ac-454d-84d7-3fab9bf7e1f8</RequestId>
<RequestDate>2/17/2012 19:15:00</RequestDate>
<RequestStatus>SUBMITTED</RequestStatus>
</ResponseInfo>
</ResponseList>
</ResponseBody>
</NeweggAPIResponse>
Example: Json, Response
{
"IsSuccess": "true",
"OperationType": "CourtesyRefundResponse",
"SellerID": "A006",
"ResponseBody": {
"ResponseList": {
"ResponseInfo": {
"RequestId": "cb0c9123-b7ac-454d-84d7-3fab9bf7e1f8",
"RequestDate": "2/17/2012 19:15:00",
"RequestStatus": "SUBMITTED"
}
}
}
}
13.4.4. Request Failure Errors
For common HTTP error responses, please refer to Common Error Responses
355
Error Code
Description
SE004
Cannot issue RMA because the order has not been invoiced.
SE019
Item total refund amount must be greater than 0.
SE023
Total refund amount CANNOT exceed total order amount.
SE025
Invalid order type.
SE026
Can't issue because of replacement order.
SE027
Can't issue because order was voided.
SE033
Invalid order number.
SE038
International seller covered by Newegg Buy-out policy cannot request return or refund directly. Please
contact MarketplaceSupport@newegg.com for assistance.
Example: XML, Response
<?xml version="1.0" encoding="utf-8"?>
<Errors>
<Error>
<Code>CE001</Code>
<Message>SellerID cannot be null or empty</Message>
</Error>
</Errors>
Example: Json, Response
{
"Code": "CE001",
"Message": "SellerID cannot be null or empty"
}
13.5. Get Courtesy Refund Request Status
Get the status of specified courtesy refund request by specified query conditions.
13.5.1. Resource URL & Information
Resource URL
356
https://api.newegg.com/marketplace/servicemgmt/courtesyrefund/requeststatus?sellerid={sellerid}
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
Resource Information
HTTP Method
Authentication?
Request Formats
Response Formats
Rate Limited?
PUT
Required
XML, Json
XML, Json
30 per min per client
13.5.2. Request Body
Attribute
Required?
Format
Description
NeweggAPIRequest
IssueUser
No
String
Specify your eligible seller account (email address) here.
Only choose from seller account existing login (email)
OperationType
Yes
String
Fixed value: GetCourtesyRefundStatusRequest
RequestBody
GetRequestStatus
RequestIDList
RequestID
No
String
Courtesy refund Request ID. Other condition(s) will be
ignored Issue courtesy refund Request ID is specified.
MaxCount
No
Integer
The maximum return records. Default is 100. If you specified
over than 100, the system still return 100 records.
RequestStatus
No
String
The available values of the status of the request submission.
ALL (Default)
SUBMITTED
IN_PROGRESS
FINISHED
FAILED
CANCELLED
RequestDateFrom
No
String
Search by Courtesy Refund Date. (Pacific Standard Time)
Please refer to the Acceptable Date Format
RequestDateTo
No
String
Search by Courtesy Refund Date. (Pacific Standard Time)
Please refer to the Acceptable Date Format
Example: XML, Request
357
XSD
API Schema > RMAManagement > RMA > CourtesyRefund > GetCourtesyRefundStatus > GetCRStatusRequest.xsd
PUT
https://api.newegg.com/marketplace/servicemgmt/courtesyrefund/requeststatus?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggAPIRequest>
<OperationType>GetCourtesyRefundStatusRequest</OperationType>
<RequestBody>
<GetRequestStatus>
<RequestIDList>
<RequestID>cb0c9123-b7ac-454d-84d7-3fab9bf7e1f8</RequestID>
</RequestIDList>
<MaxCount>100</MaxCount>
<RequestStatus>ALL</RequestStatus>
<RequestDateFrom/>
<RequestDateTo/>
</GetRequestStatus>
</RequestBody>
</NeweggAPIRequest>
Example: Json, Request
PUT
https://api.newegg.com/marketplace/servicemgmt/courtesyrefund/requeststatus?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"OperationType": "GetCourtesyRefundStatusRequest",
"RequestBody": {
"GetRequestStatus": {
"RequestIDList": {
358
"RequestID": [
"cb0c9123-b7ac-454d-84d7-3fab9bf7e1f8"
]
},
"MaxCount": "100",
"RequestStatus": "ALL"
}
}
}
13.5.3. Response Body
Attribute
Format
Description
IsSuccess
String
Used to identify the operation of Get Courtesy Refund
Request Status is successful. Returns true or false.
OperationType
String
Fixed value: GetCourtesyRefundRequestStatusResponse
SellerID
String
Seller ID
Response Body
Response List
Response Info
RequestId
string
The identifier of a request
RequestType
string
The value is fixed, will always be “COURTESYREFUND”
RequestDate
String
The date when the request was submitted. (Pacific
Standard Time)
RequestStatus
String
The available values of the status of the request
submitted:
SUBMITTED
IN_PROGRESS
FINISHED
FAILED
CANCELLED
Note: If you received the request status = ‘FAILED’,
please refer to the detailed reason in the
[ProcessMemo] field.
If you received the request status = ‘FINISHED’, the
courtesy refund info will be displayed.
ProcessMemo
String
If status = failed, detailed error message(s) will be
displayed here.
Result
Courtesy
Refund Info
CourtesyRefundID
String
Refund Transaction ID
SONumber
Integer
Order Number
SOAmount
Decimal
Order Amount
InvoiceNumber
Integer
Order Invoice Number
359
RefundAmount
Decimal
Refund Amount
ReasonCode
Integer
Available values:
1: Negative customer feedback
2: Pricing error
3: Wrong item information
4: Shipping delay
5: Package not received
6: Customer Courtesy
Reason
String
Available values:
Negative customer feedback for reason code: 1
Pricing error for reason code: 2
Wrong item information for reason code: 3
Shipping delay for reason code: 4
Package not received for reason code: 5
Customer Courtesy for reason code: 6
NoteToCustomer
String
Note to Customer
Status
String
The available values of the courtesy refund status:
1: Open
2: Close
3: Void
IsNeweggRefund
String
Specify the refund issued by Newegg Customer Service
agent. Returns true or false.
InUserName
String
Courtesy refund creator
InDate
String
Courtesy refund create date(Pacific Standard Time)
EditUserName
String
Last Edit User
EditDate
String
Last Edit Date(Pacific Standard Time) (Pacific Standard
Time)
Memo
String
Additional messages
Example: XML, Response
XSD
API Schema > RMAManagement > RMA > CourtesyRefund > GetCourtesyRefundStatus > GetCRStatusResponse.xsd
<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<OperationType>GetCourtesyRefundRequestStatusResponse</OperationType>
<SellerID>A006</SellerID>
<ResponseBody>
360
<ResponseList>
<ResponseInfo>
<RequestId>cb0c9123-b7ac-454d-84d7-3fab9bf7e1f8</RequestId>
<RequestType>COURTESYREFUND</RequestType>
<RequestDate>2012-03-07 12:37:09</RequestDate>
<RequestStatus>FINISHED</RequestStatus>
<Result>
<CourtesyRefundInfo>
<CourtesyRefundID>cb0c9123-b7ac-454d-84d7-3fab9bf7e1f8</CourtesyRefundID>
<SONumber>164878278</SONumber>
<SOAmount>1.00</SOAmount>
<InvoiceNumber>84724946</InvoiceNumber>
<RefundAmount>1.00</RefundAmount>
<ReasonCode>1</ReasonCode>
<Reason>Negative Customer Feedback</Reason>
<NoteToCustomer>this is a test note</NoteToCustomer>
<Status>Close</Status>
<IsNeweggRefund>false</IsNeweggRefund>
<InUserName>A006</InUserName>
<InDate>2012-03-07 12:38:00</InDate>
<EditUserName>EDI</EditUserName>
<EditDate>2012-03-07 13:07:02</EditDate>
</CourtesyRefundInfo>
</Result>
</ResponseInfo>
</ResponseList>
</ResponseBody>
</NeweggAPIResponse>
Example: Json, Response
{
"NeweggAPIResponse": {
"IsSuccess": "true",
"OperationType": "GetCourtesyRefundRequestStatusResponse",
"SellerID": "A006",
"ResponseBody": {
"ResponseList": {
"ResponseInfo": {
"RequestId": "cb0c9123-b7ac-454d-84d7-3fab9bf7e1f8",
361
"RequestType": "COURTESYREFUND",
"RequestDate": "2012-03-07 12:37:09",
"RequestStatus": "FINISHED",
"Result": {
"CourtesyRefundInfo": {
"CourtesyRefundID": "cb0c9123-b7ac-454d-84d7-3fab9bf7e1f8",
"SONumber": "164878278",
"SOAmount": "1.00",
"InvoiceNumber": "84724946",
"RefundAmount": "1.00",
"ReasonCode": "1",
"Reason": "Negative Customer Feedback",
"NoteToCustomer": "this is a test note",
"Status": "Close",
"IsNeweggRefund": "false",
"InUserName": "A006",
"InDate": "2012-03-07 12:38:00",
"EditUserName": "EDI",
"EditDate": "2012-03-07 13:07:02"
}
}
}
}
}
}
}
13.5.4. Request Failure Errors
For common HTTP error responses, please refer to Common Error Responses
Example: XML, Response
<?xml version="1.0" encoding="utf-8"?>
<Errors>
<Error>
<Code>CE001</Code>
<Message>SellerID cannot be null or empty</Message>
</Error>
</Errors>
362
Example: Json, Response
{
"Code": "CE001",
"Message": "SellerID cannot be null or empty"
}
13.6. Get Courtesy Refund Info
Get the specified courtesy refund information by specified query conditions.
13.6.1. Resource URL & Information
Resource URL
https://api.newegg.com/marketplace/servicemgmt/courtesyrefund/info?sellerid={sellerid}
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
Resource Information
HTTP Method
Authentication?
Request Formats
Response Formats
Rate Limited?
PUT
Required
XML, Json
XML, Json
30 per min per client
13.6.2. Request Body
Attribute
Required?
Format
Description
NeweggAPIRequest
IssueUser
No
String
Specify your eligible seller account (email address) here.
Only choose from seller account existing login (email)
OperationType
Yes
String
Fixed value: GetCourtesyRefundInfo
PageIndex
No
Integer
Current page index
If left blank, will use 1 as default.
363
PageSize
No
Integer
Return records count in one page.
(Max is 100 per page)
If left blank, will use 100 as default.
KeywordsType
No
Integer
Available values:
0: All (default)
1: CourtesyRefundID
2: OrderNumber
3: CustomerName
KeywordsValue
No
String
The keywords value of the specified type. If the type is 0,
ignore this field.
Status
No
Integer
Available values:
0: All(Default)
1: Open
2: Void
3: Close
DateFrom
No
String
Search by Courtesy Refund Date. (Pacific Standard Time)
Please refer to the Acceptable Date Format
DateTo
No
String
Search by Courtesy Refund Date. (Pacific Standard Time)
Please refer to the Acceptable Date Format
Example: XML, Request
XSD
API Schema > RMAManagement > RMA > CourtesyRefund > GetGetCourtesyRefundInfo > GetCRInfoRequest.xsd
PUT https://api.newegg.com/marketplace/servicemgmt/courtesyrefund/info?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggAPIRequest >
<OperationType>GetCourtesyRefundInfo</OperationType>
<RequestBody>
<PageInfo>
<PageIndex>1</PageIndex>
<PageSize>10</PageSize>
</PageInfo>
<KeywordsType>0</KeywordsType>
364
<KeywordsValue />
<Status>0</Status>
<DateFrom>2001-12-17 09:30:47</DateFrom>
<DateTo>2011-12-17 12:30:47</DateTo>
</RequestBody>
</NeweggAPIRequest>
Example: Json, Request
PUT https://api.newegg.com/marketplace/servicemgmt/courtesyrefund/info?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"OperationType": "GetCourtesyRefundInfo",
"RequestBody": {
"PageInfo": {
"PageIndex": "1",
"PageSize": "10"
},
"KeywordsType": "0",
"Status": "0",
"DateFrom": "2001-12-17 09:30:47",
"DateTo": "2011-12-17 12:30:47"
}
}
13.6.3. Response Body
Attribute
Format
Description
NeweggAPIResponse
IsSuccess
String
Used to identify the operation of Get Courtesy Refund Info
Request is successful. Returns true or false.
OperationType
String
Fixed value: GetCourtesyRefundResponse
SellerID
String
SellerID
ResponseDate
String
The date when the request was submitted. (Pacific
Standard Time)
Resp
onse
Body
Page
Info
TotalCount
Integer
How many records
TotalPageCount
Integer
How many pages return
365
PageSize
Integer
How many records in a page
PageIndex
Integer
Current page index
courtesyrefundInfoList
courtesyrefundInfo
CourtesyRefundID
String
Refund Transaction ID
SONumber
Integer
Order Number
SOAmount
Decimal
Order Amount
NOTE: All amounts are set in U.S. Dollars (USD).
InvoiceNumber
Integer
Order Invoice Number
RefundAmount
Decimal
Refund Amount
NOTE: All amounts are set in U.S. Dollars (USD).
ReasonCode
Integer
Available values:
1: Negative customer feedback
2: Pricing error
3: Wrong item information
4: Shipping delay
5: Package not received
6: Customer Courtesy
Reason
String
Available values:
Negative customer feedback for reason code: 1
Pricing error for reason code: 2
Wrong item information for reason code: 3
Shipping delay for reason code: 4
Package not received for reason code: 5
Customer Courtesy for reason code: 6
NoteToCustomer
String
Additional Memo to customer.
Status
String
The available values for courtesy refund status:
1: Open
2: Close
3: Void
IsNeweggRefund
String
This is a refund issued by Newegg Customer Service agent.
Returns true or false.
InUserName
String
Refund Creator
InDate
String
Refund Create Date(Pacific Standard Time)
EditUserName
String
Last Edit User
EditDate
String
Last Edit Date(Pacific Standard Time) (Pacific Standard
Time)
Example: XML, Reponses
XSD
API Schema > RMAManagement > RMA > CourtesyRefund > GetGetCourtesyRefundInfo > GetCRInfoResponse.xsd
366
<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<OperationType>GetCourtesyRefundResponse</OperationType>
<SellerID>A006</SellerID>
<ResponseDate>2012-02-17 15:12:00</ResponseDate>
<ResponseBody>
<PageInfo>
<TotalCount>1</TotalCount>
<TotalPageCount>1</TotalPageCount>
<PageSize>10</PageSize>
<PageIndex>1</PageIndex>
</PageInfo>
<CourtesyRefundInfoList>
<CourtesyrefundInfo>
<CourtesyRefundID>8a9501f2-495a-4b4f-b921-966a40969aa8</CourtesyRefundID>
<SONumber>88251262</SONumber>
<SOAmount>890.40</SOAmount>
<InvoiceNumber>48799955</InvoiceNumber>
<RefundAmount>2.01</RefundAmount>
<ReasonCode>1</ReasonCode>
<Reason>Negative Customer Feedback</Reason>
<NoteToCustomer>This is a test note</NoteToCustomer>
<Status>Close</Status>
<IsNeweggRefund>false</IsNeweggRefund>
<InUserName>A006</InUserName>
<InDate>2012-02-17 12:10:00</InDate>
<EditUserName>A006</EditUserName>
<EditDate>2012-02-17 12:10:00</EditDate>
</CourtesyrefundInfo>
</CourtesyRefundInfoList>
</ResponseBody>
</NeweggAPIResponse>
Example: Json, Response
{
"NeweggAPIResponse": {
"IsSuccess": "true",
367
"OperationType": "GetCourtesyRefundResponse",
"SellerID": "A006",
"ResponseDate": "2012-02-17 15:12:00",
"ResponseBody": {
"PageInfo": {
"TotalCount": "1",
"TotalPageCount": "1",
"PageSize": "1",
"PageIndex": "10"
},
"CourtesyRefundInfoList": {
"CourtesyrefundInfo": {
"CourtesyRefundID": "8a9501f2-495a-4b4f-b921-966a40969aa8",
"SONumber": "88251262",
"SOAmount": "890.40",
"InvoiceNumber": "48799955",
"RefundAmount": "2.01",
"ReasonCode": "1",
"Reason": "Negative Customer Feedback",
"NoteToCustomer": "This is a test note",
"Status": "Close",
"IsNeweggRefund": "false",
"InUserName": "A006",
"InDate": "2012-02-17 12:10:00",
"EditUserName": "EDI",
"EditDate": "2012-02-17 12:10:00"
}
}
}
}
}
13.6.4. Request Failure Errors
For common HTTP error responses, please refer to Common Error Responses
Example: XML, Response
<?xml version="1.0" encoding="utf-8"?>
<Errors>
368
<Error>
<Code>CE001</Code>
<Message>SellerID cannot be null or empty</Message>
</Error>
</Errors>
Example: Json, Response
{
"Code": "CE001",
"Message": "SellerID cannot be null or empty"
}
369
14. Report Management
You can submit API requests to generate business reports.
Steps to Request and Retrieve a report:
Step 1- Submit a report request using the SubmitReportRequest operation. This is a request to Newegg
Marketplace API to generate a specific report.
Step 2- Submit a request using Get Report Status service to get a list of report requests’ ID and status. Newegg
Marketplace API returns a Request ID and status for every report requested. When the status of a report request
is “FINISHED”, you can use the Get Report Result service to retrieve the report.
Step 3- Submit a request using the Get Report Result service to receive a specific report. Depending on the
report type, a XML format report will be returned or an URL of the report will be provided for you to download the
file.
14.1. Submit Report Request
The following types of Business Report are available:
Order List Report
Settlement Summary Report
Settlement Transaction Report
RMA List Report
Item Lookup Report
Daily Inventory Report
Daily Price Report
Newegg Premier Item Report
California’s Proposition 65 Warning Report
Tax Setting Report for Items Enabled for China
14.1.1. Resource URL & Information
Resource URL
https://api.newegg.com/marketplace/reportmgmt/report/submitrequest?sellerid={sellerid}&version={versionno}
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
370
Version
No
Available Version Number: 310
Related Function:
Daily Inventory Report
Daily Price Report
NOTE: Compress multiple files, 40,000 records per file, into a zip formatted
single package. If your report will include 40,000 or more records, please
apply this version to avoid error.
Resource Information
HTTP Method
Authentication?
Request Formats
Response Formats
Rate Limited?
POST
Required
XML, Json
XML, Json
30 per min per client
14.1.2. Request Body
Order List Report
Attribute
Required?
Format
Description
NeweggAPIRequest
IssueUser
No
string
Specify your eligible seller account (email address)
here
OperationType
Yes
string
Fixed value: OrderListReportRequest
RequestBody
OrderReportCriteria
RequestType
Yes
string
ORDER_LIST_REPORT
KeywordsType
Yes
Integer
Available values:
0:All
1: OrderNumber
2: InvoiceNumber
3: CustomerName
4: SellerPartNumber
5: NeweggItemNumber
6: CustomerPhoneNumber
7: TitleDescription
8: Manufacturer
9: SellerOrderNumber
NOTE: 9: SellerOrderNumber is designed for sellers
using SBN (Shipped by Newegg) to fulfill multi-
channel orders.
KeywordsValue
No
string
The keywords value of the specified type. If the type
is 0, ignore this field
Status
Yes
Integer
Available values:
0: Unshipped
371
1: Partially Shipped
2: Shipped
3: Invoiced
4: Voided
Type
No
Integer
Available values:
0: All (Default)
1: SBN
2: SBS
3: Multi-Channel
OrderDateFrom
No
string
Search by Order Date Range. (Pacific Standard Time)
Please refer to the Acceptable Date Format
OrderDateTo
No
string
Search by Order Date Range. (Pacific Standard
Time)
Please refer to the Acceptable Date Format
VoidSoon
No
Integer
the order will be auto void after 24 or 48 hours
Available values:
24
48
OrderDownloaded
No
string
false(Default): include those downloaded orders
true: don’t include those downloaded orders
CountryCode
No
String
The country for your orders. Only the ISO standard
3-digit codes are accepted.
To review the complete list of available values,
please download the following:
https://promotions.newegg.com/Marketplace/Selle
rs/resourceLibrary/International%20Country%20Gui
de.pdf
PremierOrder
No
Integer
0: All (Default)
1: Premier Order Only
2: No Premier Order
Example: XML, Request
XSD
API Schema > ReportMgmt > SubmitReport > OrderListRequest.xsd
372
POST https://api.newegg.com/marketplace/reportmgmt/report/submitrequest?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggAPIRequest>
<OperationType>OrderListReportRequest</OperationType>
<RequestBody>
<OrderReportCriteria>
<RequestType>ORDER_LIST_REPORT</RequestType>
<KeywordsType>0</KeywordsType>
<KeywordsValue/>
<Status>4</Status>
<Type>0</Type>
<OrderDateFrom>2011-12-07</OrderDateFrom>
<OrderDateTo>2012-12-30</OrderDateTo>
<OrderDownloaded>false</OrderDownloaded>
<CountryCode>USA</CountryCode>
<PremierOrder>1</PremierOrder>
</OrderReportCriteria>
</RequestBody>
</NeweggAPIRequest>
373
Example: Json, Request
POST https://api.newegg.com/marketplace/reportmgmt/report/submitrequest?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"OperationType": "OrderListReportRequest",
"RequestBody": {
"OrderReportCriteria": {
"RequestType": "ORDER_LIST_REPORT",
"KeywordsType": "0",
"Status": "4",
"Type": "0",
"OrderDateFrom": "2011-12-07",
"OrderDateTo": "2012-12-30",
"OrderDownloaded": "false",
"CountryCode":”USA",
"PremierOrder":"1"
}
}
}
Settlement Summary Report
Attribute
Requir
ed?
Format
Description
NeweggAPIRequest
IssueUser
No
string
Specify your eligible seller account (email address) here
OperationType
Yes
string
Fixed value: SettlementSummaryReportRequest
RequestBody
SettlementSummary
ReportCriteria
RequestType
Yes
string
SETTLEMENT_SUMMARY_REPORT
DateFrom
Yes
String
Date Range beginning(Pacific Standard Time)
Please refer to the Acceptable Date Format
DateTo
Yes
String
Date Range end(Pacific Standard Time)
Please refer to the Acceptable Date Format
374
Example: XML, Request
XSD
API Schema > ReportMgmt > SubmitReport > SettlementSummaryRequest.xsd
POST https://api.newegg.com/marketplace/reportmgmt/report/submitrequest?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggAPIRequest >
<OperationType>SettlementSummaryReportRequest</OperationType>
<RequestBody>
<SettlementSummaryReportCriteria>
<RequestType>SETTLEMENT_SUMMARY_REPORT</RequestType>
<DateFrom>2011-12-01</DateFrom>
<DateTo>2011-12-30</DateTo>
</SettlementSummaryReportCriteria>
</RequestBody>
</NeweggAPIRequest>
Example: Json, Request
POST https://api.newegg.com/marketplace/reportmgmt/report/submitrequest?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"OperationType": "SettlementSummaryReportRequest",
"RequestBody": {
"SettlementSummaryReportCriteria": {
"RequestType": "SETTLEMENT_SUMMARY_REPORT",
"DateFrom": "2011-12-01",
"DateTo": "2011-12-30"
}
}
}
375
Settlement Transaction Report
Attribute
Required?
Format
Description
NeweggAPIRequest
IssueUser
No
string
Specify your eligible seller account (email address) here
OperationType
Yes
string
Fixed value: SettlementTransactionReportRequest
RequestBody
SettlementTransactionReportCriteria
RequestType
Yes
string
SETTLEMENT_TRANSACTION_REPORT
OrderNumber
No
Integer
Order number
TransactionType
No
Integer
Available values:
0: All (Default)
1: Order
2: Refund
3: CreditRequest
4: Chargeback
5: MonthlyFee
6: FulfillByNeweggFee
7: Multi-ChannelFee
8: RMAProcessingFee
9: Tax & Duty
10:StorageFee
11:RMABuyoutFee
12:AdjustmentFee
13:MonthlyFeeByCC
14:SBNInboundFee
15:MerchandisingFee
16:NeweggPremierFee
17:NeweggShippingLabelFee
18:ReturnAndDisposalFee
19:NeweggRelabelingFee
SettlementDateFrom
No
String
Search by Settlement Date Range. (Pacific Standard Time)
Please refer to the Acceptable Date Format
SettlementDateTo
No
String
Search by Settlement Date Range. (Pacific Standard Time)
Please refer to the Acceptable Date Format
SettlementDate
No
String
Search by Settlement Date. (Pacific Standard Time)
Please refer to the Acceptable Date Format
SettlementID
No
Integer
The settlement transaction ID
376
Example: XML, Request
XSD
API Schema > ReportMgmt > SubmitReport > SettlementTransactionRequest.xsd
POST https://api.newegg.com/marketplace/reportmgmt/report/submitrequest?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggAPIRequest>
<OperationType>SettlementTransactionReportRequest</OperationType>
<RequestBody>
<SettlementTransactionReportCriteria>
<RequestType>SETTLEMENT_TRANSACTION_REPORT</RequestType>
<TransactionType>1</TransactionType>
<SettlementDateFrom>2011-02-21</SettlementDateFrom>
<SettlementDateTo>2012-02-22</SettlementDateTo>
<SettlementDate>2/23/2012</SettlementDate>
</SettlementTransactionReportCriteria>
</RequestBody>
</NeweggAPIRequest>
Example: Json, Request
POST https://api.newegg.com/marketplace/reportmgmt/report/submitrequest?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"OperationType": "SettlementTransactionReportRequest",
"RequestBody": {
"SettlementTransactionReportCriteria": {
"RequestType": "SETTLEMENT_TRANSACTION_REPORT",
377
"TransactionType": "1",
"SettlementDateFrom": "2011-02-21",
"SettlementDateTo": "2012-02-22",
"SettlementDate":"2/23/2012"
}
}
}
RMA List Report
Attribute
Required?
Format
Description
NeweggAPIRequest
IssueUser
No
String
Specify your eligible seller account (email address) here
OperationType
Yes
String
Fixed value: RMAListReportRequest
RequestBody
RMAListReportCriteria
RequestType
Yes
String
RMA_LIST_REPORT
KeywordsType
No
Integer
Available values:
0: All (default)
1: RMANumber
2: OrderNumber
3: CustomerName
4: SellerRMANumber
keywordsValue
No
String
The keywords value of the specified type. If the type is 0, ignore this
field.
Status
No
Integer
Available values:
0: All (Default)
1: Open
2: Received
3: Rejected
4: Voided
5: Closed
6: Processing
RMADateFrom
Yes
String
Search by RMA Date Range.
(Pacific Standard Time)
Please refer to the Acceptable Date Format
RMADateTo
Yes
String
Search by RMA Date Range.
(Pacific Standard Time)
Please refer to the Acceptable Date Format
378
RMAType
No
Integer
Available values:
0: All (Default)
1: Replacement
2: Refund
ProcessedBy
No
Integer
Available values:
0: All (Default)
1: Seller
2: Newegg
Example: XML, Request
XSD
API Schema > ReportMgmt > SubmitReport > RMAListRequest.xsd
POST https://api.newegg.com/marketplace/reportmgmt/report/submitrequest?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggAPIRequest>
<OperationType>RMAListReportRequest</OperationType>
<RequestBody>
<RMAListReportCriteria>
<RequestType>RMA_LIST_REPORT</RequestType>
<KeywordsType>0</KeywordsType>
<KeywordsValue />
<Status>4</Status>
<RMADateFrom>2011-12-17</RMADateFrom>
<RMADateTo>2011-12-30</RMADateTo>
<RMAType>0</RMAType>
<ProcessedBy>0</ProcessedBy>
</RMAListReportCriteria>
</RequestBody>
</NeweggAPIRequest>
Example: Json, Request
POST https://api.newegg.com/marketplace/reportmgmt/report/submitrequest?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
379
Content-Type: application/json
Accept: application/json
{
"OperationType": "RMAListReportRequest",
"RequestBody": {
"RMAListReportCriteria": {
"RequestType": "RMA_LIST_REPORT",
"KeywordsType": "0",
"Status": "4",
"RMADateFrom": "2011-12-17",
"RMADateTo": "2011-12-30",
"RMAType": "0",
"ProcessedBy": "0"
}
}
}
Item Lookup Report
Attribute
Required?
Format
Description
NeweggAPIRequest
OperationType
Yes
String
Fixed value: ItemLookupRequest
RequestBody
RequestCriteria
Item
UPC
No
(Yes, if
ManufacturerPartNumber is not
provided)
String
The UPC code
Condition
No
Integer
Available values:
1: New
2: Refurbished
3: Used Like New
4: Used Very Good
5: Used Good
6: Used Acceptable
ManufacturerName
No
(Yes, if UPC is not provided)
String
The manufacturer name
380
ManufacturerPartN
umber
No
(Yes, if UPC is not provided)
Integer
The manufacturer part number
PacksOrSets
No
Integer
Identify the package count of this product.
Please note: all products in a pack or set will
have matching item and condition.
Example: XML, Request
XSD
API Schema > ReportMgmt > SubmitReport > ItemLookupRequest.xsd
POST https://api.newegg.com/marketplace/reportmgmt/report/submitrequest?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggAPIRequest>
<OperationType>ItemLookupRequest</OperationType>
<RequestBody>
<RequestCriteria>
<Item>
<UPC>20140711101111</UPC>
<Condition>1</Condition>
<ManufacturerName>q-see</ManufacturerName>
<ManufacturerPartNumber>canmfpn20140711101</ManufacturerPartNumber>
<PacksOrSets>1</PacksOrSets>
</Item>
<Item>
<UPC>20140711101111</UPC>
<Condition>1</Condition>
<ManufacturerName>q-see</ManufacturerName>
<ManufacturerPartNumber>canmfpn20140711101</ManufacturerPartNumber>
</Item>
<Item>
<Condition>1</Condition>
<ManufacturerName>q-see</ManufacturerName>
<ManufacturerPartNumber>canmfpn20140711101</ManufacturerPartNumber>
<PacksOrSets>4</PacksOrSets>
</Item>
381
<Item>
<ManufacturerName>q-see</ManufacturerName>
<ManufacturerPartNumber>canmfpn20140711101</ManufacturerPartNumber>
</Item>
</RequestCriteria>
</RequestBody>
</NeweggAPIRequest>
Example: Json, Request
POST https://api.newegg.com/marketplace/reportmgmt/report/submitrequest?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"OperationType": "ItemLookupRequest",
"RequestBody": {
"RequestCriteria": {
"Item": [
{
"UPC": "20140711101111",
"Condition": "1",
"ManufacturerName": "q-see",
"ManufacturerPartNumber": "canmfpn20140711101"
},
{
"UPC": "20140711101111",
"Condition": "1",
"ManufacturerName": "q-see",
"ManufacturerPartNumber": "canmfpn20140711101"
},
{
"Condition": "1",
"ManufacturerName": "q-see",
"ManufacturerPartNumber": "canmfpn20140711101"
},
{
382
"ManufacturerName": "q-see",
"ManufacturerPartNumber": "canmfpn20140711101"
}
]
}
}
}
Daily Inventory Report
Attribute
Required?
Format
Description
NeweggAPIRequest
IssueUser
No
String
Specify your eligible seller account (email address) here
OperationType
Yes
String
Fixed value: InternationalInventoryReportRequest
RequestBody
DailyInventoryReportCriteria
FulfillType
No
Integer
Available values:
0: All
1: Fulfill by Seller
2: Fulfill by Newegg
WarehouseList
WarehouseLocation
No
String
The ISO standard 3-digit codes of the country where your
warehouse is located. Please download the following to review
details:
http://promotions.newegg.com/marketplace/sellers/resourceLi
brary/International%20Country%20Guide.pdf
If left blank, default value will be All.
RequestType
Yes
String
INTERNATIONAL_INVENTORY_REPORT
FileType
No
String
Default FileType is txt. If you do not set the FileType, our system
will auto generate file for you in .txt file format.
Currently only support the following file formats:
CSV
XLS
TXT
Example: XML, Request
XSD
API Schema > ReportMgmt > SubmitReport > InternationalInventoryReportRequest.xsd
POST https://api.newegg.com/marketplace/reportmgmt/report/submitrequest?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
383
Content-Type: application/xml
Accept: application/xml
<NeweggAPIRequest>
<OperationType>InternationalInventoryReportRequest</OperationType>
<RequestBody>
<DailyInventoryReportCriteria>
<FulfillType>0</FulfillType>
<WarehouseList>
<WarehouseLocation>USA</WarehouseLocation>
<WarehouseLocation>AUS</WarehouseLocation>
</WarehouseList>
<RequestType>INTERNATIONAL_INVENTORY_REPORT</RequestType>
<FileType>XLS</FileType>
</DailyInventoryReportCriteria>
</RequestBody>
</NeweggAPIRequest>
Example: Json, Request
POST https://api.newegg.com/marketplace/reportmgmt/report/submitrequest?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"OperationType": "InternationalInventoryReportRequest",
"RequestBody": {
"DailyInventoryReportCriteria": {
"FulfillType": "0",
"WarehouseList": {
"WarehouseLocation": [
"USA",
"AUS"
]
},
"RequestType": "INTERNATIONAL_INVENTORY_REPORT",
"FileType": "XLS"
}
384
}
}
Daily Price Report
Attribute
Required?
Format
Description
NeweggAPIRequest
IssueUser
No
String
Specify your eligible seller account (email address) here
OperationType
Yes
String
Fixed value: InternationalPriceReportRequest
RequestBody
DailyPriceReportCriteria
CountryList
CountryCode
No
String
The ISO standard 3-digit codes of the country where your
warehouse is located. Please download the following to review
details:
http://promotions.newegg.com/marketplace/sellers/resourceLi
brary/International%20Country%20Guide.pdf
If left blank, default value will be All.
RequestType
Yes
String
INTERNATIONAL_PRICE_REPORT
FileType
No
String
Default FileType is txt. If you do not set the FileType, our system
will auto generate file for you in .txt file format.
Currently only support the following file formats:
CSV
XLS
TXT
Example: XML, Request
XSD
API Schema > ReportMgmt > SubmitReport > InternationalPriceReportRequest.xsd
POST https://api.newegg.com/marketplace/reportmgmt/report/submitrequest?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggAPIRequest>
<OperationType>InternationalPriceReportRequest</OperationType>
<RequestBody>
385
<DailyPriceReportCriteria>
<CountryList>
<CountryCode>USA</CountryCode>
<CountryCode>AUS</CountryCode>
</CountryList>
<RequestType>INTERNATIONAL_PRICE_REPORT</RequestType>
<FileType>XLS</FileType>
</DailyPriceReportCriteria>
</RequestBody>
</NeweggAPIRequest>
Example: Json, Request
POST https://api.newegg.com/marketplace/reportmgmt/report/submitrequest?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"OperationType": "InternationalPriceReportRequest",
"RequestBody": {
"DailyPriceReportCriteria": {
"CountryList": {
"CountryCode": [
"USA",
"AUS"
]
},
"RequestType": "INTERNATIONAL_PRICE_REPORT",
"FileType": "XLS"
}
}
}
Newegg Premier Item Report
Attribute
Required?
Format
Description
N
e
w
e
g
g
A
P
I
R
e
q
u
e
s
t
IssueUser
No
String
Specify your eligible seller account (email address) here
386
OperationType
Yes
String
Fixed value: PremierItemReportRequest
RequestBody
PremierItemReportCriteria
Subcate
goryID
No
Integer
The subcategory ID. You can get the ID from section 14.2 Get
Subcategory Status
Premier
Mark
No
Integer
0 All
1 Return premier item only (Default)
2 Return no premier item only
Request
Type
Yes
String
PREMIER_ITEM_REPORT
FileType
No
String
Default FileType is txt. If you do not set the FileType, our system will auto
generate file for you in .txt file format.
Currently only support the following file formats:
CSV
XLS
TXT
Example: XML, Request
XSD
API Schema > ReportMgmt > SubmitReport > PremierItemRequest.xsd
POST https://api.newegg.com/marketplace/reportmgmt/report/submitrequest?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggAPIRequest>
<OperationType>PremierItemReportRequest</OperationType>
<RequestBody>
<PremierItemReportCriteria>
<SubcategoryID>134</SubcategoryID>
<PremierMark>1</PremierMark>
<RequestType>PREMIER_ITEM_REPORT</RequestType>
<FileType>XLS</FileType>
</PremierItemReportCriteria>
</RequestBody>
</NeweggAPIRequest>
Example: Json, Request
387
POST https://api.newegg.com/marketplace/reportmgmt/report/submitrequest?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"OperationType": "PremierItemReportRequest",
"RequestBody": {
"PremierItemReportCriteria": {
"SubcategoryID": "0",
“PremierMark”:”1”,
"RequestType": "PREMIER_ITEM_REPORT",
"FileType": "XLS"
}
}
}
California’s Proposition 65 Warning Report
Attribute
Required?
Format
Description
NeweggAPIRequest
IssueUser
No
String
Specify your eligible seller account (email address) here
OperationType
Yes
String
Fixed value: CAProp65ReportRequest
RequestType
Yes
String
CAPROP65_REPORT
FileType
No
String
Default FileType is txt. If you do not set the FileType, our system
will auto generate file for you in .txt file format.
Currently only support the following file formats:
CSV
XLS
TXT
Example: XML, Request
XSD
API Schema > ReportMgmt > SubmitReport > CAProp65ReportRequest.xsd
POST https://api.newegg.com/marketplace/reportmgmt/report/submitrequest?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
388
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggAPIRequest>
<OperationType>CAProp65ReportRequest</OperationType>
<RequestBody>
<ItemCAProp65ReportCriteria>
<RequestType>CAPROP65_REPORT</RequestType>
<FileType>XLS</FileType>
</ItemCAProp65ReportCriteria>
</RequestBody>
</NeweggAPIRequest>
Example: Json, Request
POST https://api.newegg.com/marketplace/reportmgmt/report/submitrequest?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"OperationType": "CAProp65ReportRequest",
"RequestBody": {
"ItemCAProp65ReportCriteria": {
"RequestType": "CAPROP65_REPORT",
"FileType": "XLS"
}
}
}
Tax Setting Report for Items Enabled for China
Attribute
Required?
Format
Description
NeweggAPIR
equest
IssueUser
No
String
Specify your eligible seller account (email address) here
OperationType
Yes
String
Fixed value: ItemChinaTaxSettingReportRequest
RequestType
Yes
String
ITEM_CHINATAXSETTING_REPORT
FileType
No
String
Default FileType is txt. If you do not set the FileType, our system
389
will auto generate file for you in .txt file format.
Currently only support the following file formats:
CSV
XLS
TXT
Example: XML, Request
XSD
API Schema > ReportMgmt > SubmitReport > ItemChinaTaxSettingReportRequest.xsd
POST https://api.newegg.com/marketplace/reportmgmt/report/submitrequest?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggAPIRequest>
<OperationType>ItemChinaTaxSettingReportRequest</OperationType>
<RequestBody>
<ItemChinaTaxSettingReportCriteria>
<RequestType>ITEM_CHINATAXSETTING_REPORT</RequestType>
<FileType>XLS</FileType>
</ItemChinaTaxSettingReportCriteria>
</RequestBody>
</NeweggAPIRequest>
Example: Json, Request
POST https://api.newegg.com/marketplace/reportmgmt/report/submitrequest?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"OperationType": "ItemChinaTaxSettingReportRequest",
"RequestBody": {
"ItemChinaTaxSettingReportCriteria": {
"RequestType": "ITEM_CHINATAXSETTING_REPORT",
390
"FileType": "XLS"
}
}
}
14.1.3. Response Body
Attribute
Format
Description
IsSuccess
String
Used to identify if the operation is successful. Returns true or false.
OperationType
String
Fixed values:
OrderListReportResponse
SettlementSummaryReportResponse
SettlementTransactionReportResponse
DailyInventoryReportResponse
RMAListReportResponse
ItemLookupReportResponse
InternationalInventoryReportResponse
InternationalPriceReportResponse
PremierItemReportResponse
CAProp65ReportResponse
ItemChinaTaxSettingReportResponse
SellerID
String
Your Seller ID
ResponseBody
ResponseList
ResponseInfo
RequestId
String
The Identifier of a submission
RequestType
String
ORDER_LIST_REPORT
SETTLEMENT_SUMMARY_REPORT
SETTLEMENT_TRANSACTION_REPORT
DAILY_INVENTORY_REPORT
RMA_LIST_REPORT
ITEM_LOOKUP
INTERNATIONAL_INVENTORY_REPORT
INTERNATIONAL_PRICE_REPORT
PREMIER_ITEM_REPORT
CAPROP65 _REPORT
ITEM_CHINATAXSETTING_REPORT
RequestDate
String
The date when the feed was submitted. (Pacific Standard Time)
RequestSatus
String
The status of the submission.
Default is SUBMITTED
391
Memo
String
Additional Information.
Example: XML, Response
XSD
API Schema > ReportMgmt > SubmitReport > SubmitReportResponse.xsd
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<OperationType>ItemLookupReportResponse</OperationType>
<SellerID>a001</SellerID>
<ResponseBody>
<ResponseList>
<ResponseInfo>
<RequestId>270Z8Y3SYIGQV</RequestId>
<RequestType>ITEM_LOOKUP</RequestType>
<RequestDate>07/12/2014 11:02:35</RequestDate>
<RequestStatus>SUBMITTED</RequestStatus>
</ResponseInfo>
</ResponseList>
</ResponseBody>
</NeweggAPIResponse>
Example: Json, Response
{
"IsSuccess": true,
"OperationType": "ItemLookupReportResponse",
"SellerID": "a001",
"ResponseBody": {
"ResponseList": [
{
"RequestId": "270Z8Y3SYIGQV",
"RequestType": "ITEM_LOOKUP",
"RequestDate": "07/12/2014 11:34:57",
"RequestStatus": "SUBMITTED"
}
]
}
392
}
14.1.4. Request Failure Errors
For common HTTP error responses, please refer to Common Error Responses
Error Code
Description
RP010
Invalid Order Number.
RP018
Invalid Settlement Date
RP019
The requestID cannot be null or empty.
RP020
We are unable to process your request because one of the following search criteria is required: SettlementID,
SettlementDate, or SettlementDateFrom and SettlementDateTo
RP021
Maximum item lookup cannot exceed 1000 for each request.
RP022
Daily Inventory Report does not support multiple warehouse locations. For multiple warehouse locations, please
use International Program Daily Inventory Report.
Example: XML, Response
<?xml version="1.0" encoding="utf-8"?>
<Errors>
<Error>
<Code>RP018</Code>
<Message>Invalid Settlement Date</Message>
</Error>
</Errors>
Example: Json, Response
{
"Code": "RP018",
"Message": "Invalid Settlement Date"
}
14.2. Get Report Status
Get the status of specified report request by specified query conditions.
393
14.2.1. Resource URL & Information
Resource URL
https://api.newegg.com/marketplace/reportmgmt/report/status?sellerid={sellerid}
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
Resource Information
HTTP Method
Authentication?
Request Formats
Response Formats
Rate Limited?
PUT
Required
XML, Json
XML, Json
30 per min per client
14.2.2. Request Body
Attribute
Required?
Format
Description
NeweggAPIRequest
IssueUser
No
String
Specify your eligible seller account (email address) here
OperationType
Yes
String
Fixed value: GetReportStatusRequest
RequestBody
GetRequestStatus
RequestIDList
RequestID
No
String
A list of feed request ID, other condition will be ignored if
specify an ID in the list
RequestTypeList
RequestType
No
String
A list of feed Task type, default is All.
ORDER_LIST_REPORT
SETTLEMENT_SUMMARY_REPORT
SETTLEMENT_TRASACTION_ REPORT
DAILY_INVENTORY_ REPORT
RMA_LIST_REPORT
ITEM_LOOKUP
INTERNATIONAL_INVENTORY_REPORT
INTERNATIONAL_PRICE_REPORT
PREMIER_ITEM_REPORT
CAPROP65 _REPORT
ITEM_CHINATAXSETTING_REPORT
MaxCount
No
Integer
The maximum return records. Default and maximum is 100.
If you specified over than 100, the system still return 100
records
394
RequestStatus
No
String
The status of the feed submission.
SUBMITTED
IN_PROGRESS
FINISHED
CANCELLED
ALL
RequestDateFrom
No
String
Search by date range. (Pacific Standard Time)
Please refer to the Acceptable Date Format
RequestDateTo
No
String
Search by date range. (Pacific Standard Time)
Please refer to the Acceptable Date Format
Example: XML, Request
XSD
API Schema > ReportMgmt > GetReportStatus > GetReportStatusRequest.xsd
PUT https://api.newegg.com/marketplace/reportmgmt/report/status?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggAPIRequest>
<OperationType>GetReportStatusRequest</OperationType>
<RequestBody>
<GetRequestStatus>
<RequestIDList>
<RequestID>2PQBYWH4V68ZP</RequestID>
</RequestIDList>
<MaxCount>10</MaxCount>
</GetRequestStatus>
</RequestBody>
</NeweggAPIRequest>
Example: Json, Request
PUT https://api.newegg.com/marketplace/reportmgmt/report/status?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
395
Accept: application/xml
{
"OperationType": "GetReportStatusRequest",
"RequestBody": {
"GetRequestStatus": {
"RequestIDList": { "RequestID": "2PQBYWH4V68ZP" },
"MaxCount": "10"
}
}
}
14.2.3. Response Body
Attribute
Format
Description
NeweggAPIResponse
SellerID
String
Your seller ID on Newegg Marketplace
IsSuccess
String
Used to identify the operation is successful
True or false
OperationType
String
Fixed value: GetReportStatusResponse
ResponseBody
ResponseList
ResponseInfo
RequestId
String
The Identifier of a submission
RequestType
String
ORDER_LIST_REPORT
SETTLEMENT_SUMMARY_REPORT
SETTLEMENT_TRASACTION_REPORT
DAILY_INVENTORY_ REPORT
RMA_LIST_REPORT
ITEM_LOOKUP
INTERNATIONAL_INVENTORY_REPORT
INTERNATIONAL_PRICE_REPORT
PREMIER_ITEM_REPORT
CAPROP65 _REPORT
ITEM_CHINATAXSETTING_REPORT
RequestDate
String
The date when the request was submitted.
(Pacific Standard Time)
RequestSatus
String
The status of the request submission.
SUBMITTED
IN_PROGRESS
FINISHED
CANCELLED
TotalCount
Integer
Total number of records
396
Memo
String
Additional Information.
Example: XML, Response
XSD
API Schema > ReportMgmt > GetReportStatus > GetReportStatusResponse.xsd
<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<OperationType>GetReportStatusResponse</OperationType>
<SellerID>A006</SellerID>
<ResponseBody>
<ResponseList>
<ResponseInfo>
<RequestId>2PQBYWH4V68ZP</RequestId>
<RequestType>ORDER_LIST_REPORT</RequestType>
<RequestDate>2/21/2012 14:38:17</RequestDate>
<RequestStatus>FINISHED</RequestStatus>
<TotalCount>4</TotalCount>
</ResponseInfo>
</ResponseList>
</ResponseBody>
</NeweggAPIResponse>
Example: Json, Response
{
"IsSuccess": true,
"OperationType": "GetReportStatusResponse",
"ResponseBody": {
"ResponseList": [{
"RequestDate": "2\/21\/2012 14:38:17",
"RequestId": "2PQBYWH4V68ZP",
"RequestStatus": "IN_PROGRESS",
"RequestType": "ORDER_LIST_REPORT",
TotalCount:4
}]
},
"SellerID": "A006"
}
397
14.2.4. Request Failure Errors
For common HTTP error responses, please refer to Common Error Responses
Error Code
Description
RP004
Date From is required.
RP005
Date To is required.
RP006
Invalid Date From.
RP007
Invalid Date To.
Example: XML, Response
<?xml version="1.0" encoding="utf-8"?>
<Errors>
<Error>
<Code>RP004</Code>
<Message>Date From is required</Message>
</Error>
</Errors>
Example: Json, Response
{
"Code": "RP005",
"Message": "Dateto is required"
}
14.3. Get Report Result
Get the processing result of a specified report request.
14.3.1. Resource URL & Information
Resource URL
https://api.newegg.com/marketplace/reportmgmt/report/result?sellerid={sellerid}&version={versionno}
398
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
Version
No
Available Version Numbers
306. Response includes the Seller Order Number assigned by seller when
using for SBN to fulfill multi-channel orders.
307. Response includes SalesTax amount for U.S., VAT and Duty amount for
Newegg Global.
309. Response includes the replacement order #s for related RMAs.
Resource Information
HTTP Method
Authentication?
Request Formats
Response Formats
Rate Limited?
PUT
Required
XML, Json
XML, Json
30 per min per client
14.3.2. Request Body
Attribute
Required?
Format
Description
NeweggAPIRequest
IssueUser
No
String
Specify your eligible seller account (email address) here
OperationType
Yes
String
Fixed values:
OrderListReportRequest
SettlementSummaryReportRequest
SettlementTransactionReportRequest
DailyInventoryReportRequest
RMAListReportRequest
ItemLookupRequest
InternationalInventoryReportRequest
InternationalPriceReportRequest
PremierItemReportRequest
CAProp65ReportRequest
ItemChinaTaxSettingReportRequest
RequestBody
RequestID
Yes
String
The request ID
PageInfo
PageIndex
Yes
Integer
Current page index
PageSize
Yes
Integer
Return records count in one page.
(Max is 100 per page)
Example: XML, Request
399
XSD
API Schema > ReportMgmt > GetReport > GetReportRequest.xsd
PUT https://api.newegg.com/marketplace/reportmgmt/report/result?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggAPIRequest >
<OperationType>OrderListReportRequest</OperationType>
<RequestBody>
<RequestID>2PQBYWH4V68ZP</RequestID>
<PageInfo>
<PageIndex>1</PageIndex>
<PageSize>10</PageSize>
</PageInfo>
</RequestBody>
</NeweggAPIRequest>
Example: Json, Request
PUT https://api.newegg.com/marketplace/reportmgmt/report/result?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
{
"OperationType": "OrderListReportRequest"
"RequestBody": {
"RequestID": "2PQBYWH4V68ZP",
"PageInfo": {
"PageSize": "10",
"PageIndex": "1"
}
}
}
14.3.3. Response Body
400
Order List Report
Attribute
Format
Description
Available
Ver.#
NeweggAPIResponse
IsSuccess
String
Used to identify the operation of Get Order Info
is successful
True or False
All
SellerID
String
Your seller ID
All
OperationType
String
Fixed value: GetOrderInfoResponse
All
ResponseByody
Requ
estID
String
You request ID
All
Requ
estD
ate
String
You request datetime(Pacific Standard Time)
All
PageInfo
TotalCount
Integer
Total number of records
All
TotalPageCount
Integer
Total page count
All
PageSize
Integer
How many records in a page.
All
PageIndex
Integer
Current page index
All
OrderInfoList
OrderInfo
SellerID
String
Seller ID
All
OrderNumber
Integer
Newegg Order number
All
SellerOrderNumber
String
Order number, assigned by seller.
This is available for sellers using SBN (Shipped by
Newegg) to fulfill multi-channel orders.
307
InvoiceNumber
Integer
The Invoice Number
All
OrderDownloaded
String
False: Order has not been downloaded yet.
True: Order downloaded already.
When order is shipped, this field will
automatically become “True”.
All
OrderDate
String
Create date
All
OrderStatus
Integer
The Order Status:
0: Unshipped
1: Partially Shipped
2: Shipped
3: Invoiced
4: Voided
All
401
OrderStatusDescription
String
The Order Status Description
(Unshipped|PartiallyShipped|Shipped|Invoiced|
Void)
Unshipped for order status code: 0
Partially Shipped for order status code: 1
Shipped for order status code: 2
Invoiced for order status code: 3
Voided for order status code: 4
All
CustomerName
String
The order’s customer name.
All
CustomerPhoneNumber
String
The order’s shipping phone number
All
CustomerEmailAddress
String
The masked customer email address, you can
reach to the customer through this email address.
For example:
gdv6l0viwo4l7j1d@marketplace.newegg.com
All
ShipToAddress1
String
The order will be shipped to address
All
ShipToAddress2
String
The order will be shipped to address line 2
All
ShipToCityName
String
The order will be shipped to city name
All
ShipToStateCode
String
The order will be shipped to state
All
ShipToZipCode
String
The order will be shipped to zip code
All
ShipToCountryCode
String
The country for your orders. i.e. United Kingdom
All
402
ShipService
String
The order’s shipping service:
Shipped By Newegg
APO/FPO Military ONLY
Super Saver(7-14 business days)
Standard Shipping (5-7 business days)
Expedited Shipping (3-5 business days)
Two-Day Shipping(2 business days)
One-Day Shipping(Next day)
International Expedited Shipping(3-5 business
days)
International Two-Day Shipping(2 business days)
International Economy Shipping(8-15 business
days)
International Standard Shipping(5-7 business
days)Newegg Premier 3 Days
Newegg Premier 2 Days
Newegg Premier Next Day
Please note that the following shipping services
are for indicating Newegg Premier orders, you
should ship the order as soon as the service
required. Please contact
Datafeeds@Newegg.com for more detail
regarding Premier Seller Enrollment Program.
Newegg Premier 3 Days
Newegg Premier 2 Days
Newegg Premier Next Day
All
ShipToFirstName
String
The ship to First Name
All
ShipToLastName
String
The ship to Last Name
All
ShipToCompany
String
The order’s ship to company
All
OrderItemAmount
Decimal
The order’s item(s) total amount
NOTE: All amounts are set in U.S. Dollars (USD).
All
ShippingAmount
Decimal
The order’s shipping Amount
NOTE: All amounts are set in U.S. Dollars (USD).
All
DiscountAmount
Decimal
The order’s total discount amount
NOTE: All amounts are set in U.S. Dollars (USD).
All
OrderQty
Integer
Order’s total item quantity.
All
403
RefundAmount
Decimal
The order’s refund amount.
NOTE: All amounts are set in U.S. Dollars (USD).
All
SalesTax
Decimal
The order’s sales tax.
NOTE: All amounts are set in U.S. Dollars (USD).
306
VATTotal
Decimal
International Value Additional Tax Total.
NOTE: All amounts are set in U.S. Dollars (USD).
306
DutyTotal
Decimal
International Duty Total
NOTE: All amounts are set in U.S. Dollars (USD).
306
OrderTotalAmount
Decimal
The order’s total amount
All
IsAutoVoid
String
If an order was auto voided by Newegg system,
then the value is true. Otherwise, value is false.
All
SalesChannel
Integer
Order sales channel:
0: Newegg order
1: Multi-channel order
2: Replacement order
306, 307,
309
FulfillmentOption
Integer
Order fulfillment option:
0: Ship by seller
1: Ship by Newegg
All
ItemInfoList
ItemInfo
SellerPartNumber
String
The item’s seller part number
All
NeweggItemNumber
String
The item’s newegg item number
All
MfrPartNumber
String
The item’s manufacture part number
All
UPCCode
String
The item’s upc
All
Description
String
The item’s web title description
All
OrderedQty
Integer
Item’s Ordered Quantity.
All
ShippedQty
Integer
Item’s Shipped Quantity.
All
UnitPrice
Decimal
The final price per unit of the item appearing in
customer's shopping cart
NOTE: All amounts are set in U.S. Dollars (USD).
All
ExtendUnitPrice
Decimal
Item's total charge (Item Unit Price x Quantity
Ordered)
NOTE: All amounts are set in U.S. Dollars (USD).
All
ExtendShippingCharg
e
Decimal
Item's total shipping charge (Item Unit Shipping
Price x Quantity Ordered)
NOTE: All amounts are set in U.S. Dollars (USD).
All
404
ExtendSalesTax
Decimal
Item’s total sales tax charge.
NOTE: All amounts are set in U.S. Dollars (USD).
306
ExtendVAT
Decimal
Item’s total Value Additional Tax charge
NOTE: All amounts are set in U.S. Dollars (USD).
306
ExtendDuty
Decimal
Item’s total Duty charge
NOTE: All amounts are set in U.S. Dollars (USD).
306
Status
Integer
1: Unshipped
2: Shipped
3: Cancelled
All
StatusDescription
String
Unshipped for status code: 1
Shipped for status code: 2
Cancelled for status code: 3
All
PackageInfoList
PackageInfo
PackageType
String
The package type. Shipped | Unshipped
All
ShipCarrier
String
The package’s actual shipCarrier
All
ShipService
String
The package’s actual shipService
All
TrackingNumber
String
The package’s tracking number.
All
ShipDate
String
The package’s ship date. (Pacific Standard Time)
All
ItemInfoList
Item Info
SellerPartN
umber
String
The item’s seller part number
All
MfrPartNu
mber
String
The item’s manufacture part number
All
ShippedQt
y
Integer
Item’s Shipped Quantity.
All
Memo
String
Other information.
All
ResponseDate
String
The response date
All
Example: XML, Response
XSD
API Schema > ReportMgmt > GetReport > OrderListResponse.xsd
<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<SellerID>A006</SellerID>
<OperationType>GetOrderInfoResponse</OperationType>
<ResponseBody>
<PageInfo>
<TotalCount>2</TotalCount>
405
<TotalPageCount>1</TotalPageCount>
<PageSize>10</PageSize>
<PageIndex>1</PageIndex>
</PageInfo>
<RequestID>2PQBYWH4V68ZP</RequestID>
<RequestDate>2/21/2012 14:38:17</RequestDate>
<OrderInfoList>
<OrderInfo>
<SellerID>A006</SellerID>
<OrderNumber>41473642</OrderNumber>
<SellerOrderNumber>2153930</SellerOrderNumber>
<InvoiceNumber>0</InvoiceNumber>
<OrderDownloaded>true</OrderDownloaded>
<OrderDate>1/23/2012 7:33:05</OrderDate>
<OrderStatus>4</OrderStatus>
<OrderStatusDescription>Voided</OrderStatusDescription>
<CustomerName>WY SD</CustomerName>
<CustomerPhoneNumber>123-223-3223</CustomerPhoneNumber>
<CustomerEmailAddress>gdv6l0viwo4l7j1d@marketplace.newegg.com</CustomerEmailAddress>
<ShipToAddress1>149 Kenwood Dr</ShipToAddress1>
<ShipToAddress2 />
<ShipToCityName>Newcastle</ShipToCityName>
<ShipToStateCode>WY</ShipToStateCode>
<ShipToZipCode>82701</ShipToZipCode>
<ShipToCountryCode>UNITED STATES</ShipToCountryCode>
<ShipService>Media Mail (7-14 business days)</ShipService>
<ShipToFirstName>WY</ShipToFirstName>
<ShipToLastName>SD</ShipToLastName>
<ShipToCompany />
<OrderItemAmount>0</OrderItemAmount>
<ShippingAmount>0.00</ShippingAmount>
<DiscountAmount>0.00</DiscountAmount>
<RefundAmount>0</RefundAmount>
<SalesTax />
<VATTotal />
<DutyTotal />
<OrderTotalAmount>0.00</OrderTotalAmount>
<OrderQty>1</OrderQty>
<IsAutoVoid>true</IsAutoVoid>
<SalesChannel>0</SalesChannel>
<FulfillmentOption>1</FulfillmentOption>
406
<ItemInfoList>
<ItemInfo>
<SellerPartNumber>A00655467241</SellerPartNumber>
<NeweggItemNumber>9SIA0060823129</NeweggItemNumber>
<MfrPartNumber>55467241</MfrPartNumber>
<UPCCode />
<Description>test creation test item</Description>
<OrderedQty>1</OrderedQty>
<ShippedQty>0</ShippedQty>
<UnitPrice>1.00</UnitPrice>
<ExtendUnitPrice>1.03</ExtendUnitPrice>
<ExtendShippingCharge>1.03</ExtendShippingCharge>
<ExtendSalesTax />
<ExtendVAT />
<ExtendDuty />
<Status>3</Status>
<StatusDescription>Canceled</StatusDescription>
</ItemInfo>
</ItemInfoList>
<PackageInfoList />
</OrderInfo>
<OrderInfo>
<SellerID>A006</SellerID>
<OrderNumber>159243598</OrderNumber>
<SellerOrderNumber>2153930</SellerOrderNumber>
<InvoiceNumber>82961992</InvoiceNumber>
<OrderDownloaded>true</OrderDownloaded>
<OrderDate>1/18/2012 1:05:18</OrderDate>
<OrderStatus>3</OrderStatus>
<OrderStatusDescription>Invoiced</OrderStatusDescription>
<CustomerName>WY SD</CustomerName>
<CustomerPhoneNumber>123-223-3223</CustomerPhoneNumber>
<CustomerEmailAddress>gdv6l0viwo4l7j1d@marketplace.newegg.com</CustomerEmailAddress>
<ShipToAddress1>149 Kenwood Dr</ShipToAddress1>
<ShipToAddress2 />
<ShipToCityName>Newcastle</ShipToCityName>
<ShipToStateCode>WY</ShipToStateCode>
<ShipToZipCode>82701</ShipToZipCode>
<ShipToCountryCode>UNITED STATES</ShipToCountryCode>
<ShipService>Media Mail (7-14 business days)</ShipService>
<ShipToFirstName>WY</ShipToFirstName>
407
<ShipToLastName>SD</ShipToLastName>
<ShipToCompany />
<OrderItemAmount>2.00</OrderItemAmount>
<ShippingAmount>10.00</ShippingAmount>
<DiscountAmount>1.00</DiscountAmount>
<RefundAmount>0</RefundAmount>
<SalesTax />
<VATTotal />
<DutyTotal />
<OrderTotalAmount>11.00</OrderTotalAmount>
<OrderQty>2</OrderQty>
<IsAutoVoid>false</IsAutoVoid>
<SalesChannel>0</SalesChannel>
<FulfillmentOption>1</FulfillmentOption>
<ItemInfoList>
<ItemInfo>
<SellerPartNumber>A006ZX-35833</SellerPartNumber>
<NeweggItemNumber>9SIA0060845543</NeweggItemNumber>
<MfrPartNumber>ZX-35833</MfrPartNumber>
<UPCCode>431573000287</UPCCode>
<Description>GYRO Huge Metal Goliath 3.5CH Electric RTF RC
Helicopter</Description>
<OrderedQty>2</OrderedQty>
<ShippedQty>2</ShippedQty>
<UnitPrice>1.00</UnitPrice>
<Status>2</Status>
<StatusDescription>Shipped</StatusDescription>
<ExtendUnitPrice>1.03</ExtendUnitPrice>
<UnitShippingCharge>1.03</UnitShippingCharge>
<ExtendShippingCharge>1.03</ExtendShippingCharge>
<ItemVATTotal />
<ItemDutyTotal />
</ItemInfo>
</ItemInfoList>
<PackageInfoList>
<PackageInfo>
<PackageType>Shipped</PackageType>
<ShipCarrier>UPS</ShipCarrier>
<ShipService>342</ShipService>
<TrackingNumber>2342424</TrackingNumber>
<ShipDate>1/18/2012 16:59:15</ShipDate>
408
<ItemInfoList>
<ItemInfo>
<SellerPartNumber>A006ZX-35833</SellerPartNumber>
<MfrPartNumber>ZX-35833</MfrPartNumber>
<ShippedQty>2</ShippedQty>
</ItemInfo>
</ItemInfoList>
</PackageInfo>
</PackageInfoList>
</OrderInfo>
</OrderInfoList>
</ResponseBody>
<Memo />
<ResponseDate>2/22/2012 16:51:03</ResponseDate>
</NeweggAPIResponse>
Example: Json, Response
{
"NeweggAPIResponse": {
"IsSuccess": "true",
"SellerID": "A006",
"OperationType": "GetOrderInfoResponse",
"ResponseBody": {
"PageInfo": {
"TotalCount": "2",
"TotalPageCount": "1",
"PageSize": "10",
"PageIndex": "1"
},
"RequestID": "2PQBYWH4V68ZP",
"RequestDate": "2/21/2012 14:38:17",
"OrderInfoList": {
"OrderInfo": [{
"SellerID": "A006 ",
"OrderNumber": "41473642",
"SellerOrderNumber": "2153930",
"InvoiceNumber": "0",
"OrderDownloaded": "true",
"OrderDate": "1/23/2012 7:33:05",
"OrderStatus": "4",
409
"OrderStatusDescription": "Voided",
"CustomerName": "WY SD",
"CustomerPhoneNumber": "123-223-3223",
"ShipToAddress1": "149 Kenwood Dr",
"ShipToAddress2": null,
"ShipToCityName": "Newcastle",
"ShipToStateCode": "WY",
"ShipToZipCode": "82701",
"ShipToCountryCode": "UNITED STATES",
"ShipService": "Media Mail (7-14 business days)",
"ShipToFirstName": "WY",
"ShipToLastName": "SD",
"ShipToCompany": null,
"OrderItemAmount": "0",
"ShippingAmount": "0.00",
"DiscountAmount": "0.00",
"RefundAmount": "0",
“SalesTax”:”0.00”,
“IntlVATTotal”:”0.00”,
“IntlDutyTotal”:”0.00”,
"OrderTotalAmount": "0.00",
"OrderQty": "1",
"IsAutoVoid": "true",
SalesChannel:0,
FulfillmentOption:1,
"ItemInfoList": {
"ItemInfo": {
"SellerPartNumber": "A00655467241",
"NeweggItemNumber": "9SIA0060823129",
"MfrPartNumber": "55467241",
"UPCCode": null,
"Description": "test creation test item”,
"OrderedQty": "1",
"ShippedQty": "0",
"UnitPrice": "1.00",
"ExtendUnitPrice": "1.03",
"UnitShippingCharge": "1.03",
"ExtendShippingCharge": "1.03",
“ItemVATTotal”:”0.00”,
“ItemDutyTotal”:”0.00”,
"Status": "3",
410
"StatusDescription": "Canceled"
}
},
"PackageInfoList": null
}, {
"SellerID": "A006 ",
"OrderNumber": "159243598",
"SellerOrderNumber": "2153930",
"InvoiceNumber": "82961992",
"OrderDownloaded": "true",
"OrderDate": "1/18/2012 1:05:18",
"OrderStatus": "3",
"OrderStatusDescription": "Invoiced",
"CustomerName": "WY SD",
"CustomerPhoneNumber": "123-223-3223",
"CustomerEmailAddress”:gdv6l0viwo4l7j1d@marketplace.newegg.com",
"ShipToAddress1": "149 Kenwood Dr",
"ShipToAddress2": null,
"ShipToCityName": "Newcastle",
"ShipToStateCode": "WY",
"ShipToZipCode": "82701",
"ShipToCountryCode": "UNITED STATES",
"ShipService": "Media Mail (7-14 business days)",
"ShipToFirstName": "WY",
"ShipToLastName": "SD",
"ShipToCompany": null,
"OrderItemAmount": "2.00",
"ShippingAmount": "10.00",
"DiscountAmount": "1.00",
"RefundAmount": "0",
“SalesTax”:”0.00”,
“IntlVATTotal”:”0.00”,
“IntlDutyTotal”:”0.00”,
"OrderTotalAmount": "11.00",
"OrderQty": "2",
"IsAutoVoid": "false",
SalesChannel:0,
FulfillmentOption:1,
"ItemInfoList": {
"ItemInfo": {
"SellerPartNumber": "A006ZX-35833",
411
"NeweggItemNumber": "9SIA0060845543",
"MfrPartNumber": "ZX-35833",
"UPCCode": "431573000287",
"Description": "GYRO Huge Metal Goliath 3.5CH Electric RTF RC Helicopter
",
"OrderedQty": "2",
"ShippedQty": "2",
"UnitPrice": "1.00",
"ExtendUnitPrice": "1.03",
"UnitShippingCharge": "1.03",
"ExtendShippingCharge": "1.03",
“ItemVATTotal”:”0.00”,
“ItemDutyTotal”:”0.00”,
"Status": "2",
"StatusDescription": "Shipped"
}
},
"PackageInfoList": {
"PackageInfo": {
"PackageType": "Shipped",
"ShipCarrier": "UPS",
"ShipService": "342",
"TrackingNumber": "2342424",
"ShipDate": "1/18/2012 16:59:15",
"ItemInfoList": {
"ItemInfo": {
"SellerPartNumber": "A006ZX-35833",
"MfrPartNumber": "ZX-35833",
"ShippedQty": "2"
}
}
}
}
}]
}
},
"Memo": null,
"ResponseDate": "2/22/2012 16:53:26"
}
}
412
Settlement Summary Report Result
Attribute
Format
Description
NeweggAPIResponse
IsSuccess
String
Used to identify the operation is successful. Returns true or
false
SellerID
String
Your seller ID
OperationType
String
Fixed value: GetSettlementSummaryInfoResponse
Response Body
RequestID
String
You request ID
RequestDate
String
You request datetime(Pacific Standard Time)
PageInfo
TotalCount
Integer
Total number of records
TotalPageCount
Integer
Total page count
PageIndex
Integer
Current page index
PageSize
Integer
How many records in a page.
SettlementSummaryList
SettlementSummary
SettlementDateFrom
String
Settlement From Date (Pacific Standard Time)
SettlementDateTo
String
SettlementDateTo(Pacific Standard Time)
SettlementID
string
SettlementID
CheckNumber
string
CheckNumber
ItemPrice
Decimal
ItemPrice
NOTE: All amounts are set in U.S. Dollars (USD).
Shipping
Decimal
Shipping
NOTE: All amounts are set in U.S. Dollars (USD).
Other
Decimal
Other
NOTE: All amounts are set in U.S. Dollars (USD).
TotalOrderAmount
Decimal
TotalOrderAmount
NOTE: All amounts are set in U.S. Dollars (USD).
Refunds
Decimal
Refunds
NOTE: All amounts are set in U.S. Dollars (USD).
ChargeBack
Decimal
ChargeBack
NOTE: All amounts are set in U.S. Dollars (USD).
MiscellaneousAdjustment
Decimal
MiscellaneousAdjustment
NOTE: All amounts are set in U.S. Dollars (USD).
TotalRefunds
Decimal
TotalRefunds
NOTE: All amounts are set in U.S. Dollars (USD).
413
NeweggCommissionFee
Decimal
NeweggCommissionFee
NOTE: All amounts are set in U.S. Dollars (USD).
NeweggTransactionFee
Decimal
NeweggTransactionFee
NOTE: All amounts are set in U.S. Dollars (USD).
NeweggRefundCommissionFe
e
Decimal
NeweggRefundCommissionFee
NOTE: All amounts are set in U.S. Dollars (USD).
NeweggMonthlyFee
Decimal
NeweggMonthlyFee
NOTE: All amounts are set in U.S. Dollars (USD).
NeweggStorageFee
Decimal
NeweggStorageFee
NOTE: All amounts are set in U.S. Dollars (USD).
NeweggRMABuyoutFee
Decimal
NeweggRMABuyoutFee
NOTE: All amounts are set in U.S. Dollars (USD).
NeweggPremierFee
Decimal
NeweggPremierFee
NOTE: All amounts are set in U.S. Dollars (USD).
NeweggShippingLabelFee
Decimal
NeweggShippingLabelFee
NOTE: All amounts are set in U.S. Dollars (USD).
TotalNeweggFee
Decimal
TotalNeweggFee
NOTE: All amounts are set in U.S. Dollars (USD).
TotalSettlement
Decimal
TotalSettlement
NOTE: All amounts are set in U.S. Dollars (USD).
Memo
String
Additional Information.
ResponseDate
String
The respond date of this report
Example: XML, Response
XSD
API Schema > ReportMgmt > GetReport > settlementSummaryResponse.xsd
<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<SellerID>A09D</SellerID>
<OperationType>GetSettlementSummaryInfoResponse</OperationType>
<ResponseBody>
<PageInfo>
<TotalCount>1</TotalCount>
<TotalPageCount>1</TotalPageCount>
<PageSize>10</PageSize>
<PageIndex>1</PageIndex>
414
</PageInfo>
<RequestID>2PQBZMZTL3DYF</RequestID>
<RequestDate>2/21/2012 15:12:55</RequestDate>
<SettlementSummaryList>
<SettlementSummary>
<SettlementDate>2/21/2012 12:00:00</SettlementDate>
<SettlementDateFrom>8/5/2011 12:00:00</SettlementDateFrom>
<SettlementDateTo>2/21/2012 12:00:00</SettlementDateTo>
<SettlementID>0</SettlementID>
<CheckNumber />
<ItemPrice>71.00</ItemPrice>
<Shipping>31.95</Shipping>
<Other>0.00</Other>
<TotalOrderAmount>102.95</TotalOrderAmount>
<Refunds>-1.98</Refunds>
<ChargeBack>0.00</ChargeBack>
<MiscellaneousAdjustment>-182.53</MiscellaneousAdjustment>
<TotalRefunds>-184.51</TotalRefunds>
<NeweggCommissionFee>-7.71</NeweggCommissionFee>
<NeweggTransactionFee>0.00</NeweggTransactionFee>
<NeweggRefundCommissionFee>0.15</NeweggRefundCommissionFee>
<NeweggMonthlyFee>0.00</NeweggMonthlyFee>
<NeweggStorageFee>-59.05</NeweggStorageFee>
<NeweggRMABuyoutFee>-0.72</NeweggRMABuyoutFee>
<NeweggPremierFee>0.00</NeweggPremierFee>
<NeweggShippingLabelFee>0.00</NeweggShippingLabelFee>
<TotalNeweggFee>-638.63</TotalNeweggFee>
<TotalSettlement>-720.19</TotalSettlement>
</SettlementSummary>
</SettlementSummaryList>
</ResponseBody>
<Memo />
</NeweggAPIResponse>
Example: Json, Response
{
"NeweggAPIResponse": {
"IsSuccess": "true",
"SellerID": "A09D",
"OperationType": "GetSettlementSummaryInfoResponse",
415
"ResponseBody": {
"PageInfo": {
"TotalCount": "1",
"TotalPageCount": "1",
"PageSize": "10",
"PageIndex": "1"
},
"RequestID": "2PQBZMZTL3DYF",
"RequestDate": "2/21/2012 15:12:55",
"SettlementSummaryList": {
"SettlementSummary": {
"SettlementDate": "2/21/2012 12:00:00",
"SettlementDateFrom": "8/5/2011 12:00:00",
"SettlementDateTo": "2/21/2012 12:00:00",
"SettlementID": "0",
"ItemPrice": "71.00",
"Shipping": "31.95",
"Other": "0.00",
"TotalOrderAmount": "102.95",
"Refunds": "-1.98",
"ChargeBack": "0.00",
"MiscellaneousAdjustment": "-182.53",
"TotalRefunds": "-184.51",
"NeweggCommissionFee": "-7.71",
"NeweggTransactionFee": "0.00",
"NeweggRefundCommissionFee": "0.15",
"NeweggMonthlyFee": "0.00",
"NeweggStorageFee": "-59.05",
"NeweggRMABuyoutFee": "-0.72",
"NeweggPremierFee": "0.00",
"NeweggShippingLabelFee": "0.00",
"TotalNeweggFee": "-638.63",
"TotalSettlement": "-720.19"
}
}
}
}
}
416
Settlement Transaction Report
Attribute
Format
Description
NeweggAPIResponse
IsSuccess
String
Used to identify the operation is successful.
Returns true or false
SellerID
String
Your seller ID
OperationType
String
Fixed value:
GetSettlementTransactionInfoResponse
Response Body
RequestID
String
You request ID
RequestDate
String
You request datetime(Pacific Standard Time)
PageInfo
TotalCount
Integer
Total number of records
TotalPageCount
Integer
Total page count
PageIndex
Integer
Current page index
PageSize
Integer
How many records in a page.
SettlementTransactionInfoList
SettlementTransactionInfo
TransactionDate
String
Transaction date
TransactionType
String
TransactionType
OrderID
Integer
OrderID
InvoiceID
Integer
InvoiceID
SellerPartNumber
String
SellerPartNumber
NeweggItemNumber
String
Newegg item number
ItemDescription
String
ItemDescription
ItemCondition
String
Item condition:
New
Refurbished
Used Like New
Used Very Good
Used Good
Used Acceptable
Amount
Decimal
Amount
NOTE: All amounts are set in U.S. Dollars (USD).
Shipping
Decimal
Shipping charge
NOTE: All amounts are set in U.S. Dollars (USD).
417
CommissionFee
Decimal
CommissionFee
NOTE: All amounts are set in U.S. Dollars (USD).
SettlementID
String
SettlementID
Memo
String
Additional Information
ResponseDate
String
The respond date of this report
Example: XML, Response
XSD
API Schema > ReportMgmt > GetReport > SettlementTransactionResponse.xsd
<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<SellerID>A09D</SellerID>
<OperationType>GetSettlementTransactionInfoResponse</OperationType>
<ResponseBody>
<PageInfo>
<TotalCount>21</TotalCount>
<TotalPageCount>21</TotalPageCount>
<PageSize>10</PageSize>
<PageIndex>1</PageIndex>
</PageInfo>
<RequestID>2PQDKCAQFHL3M</RequestID>
<RequestDate>2/23/2012 11:39:00</RequestDate>
<SettlementTransactionInfoList>
<SettlementTransactionInfo>
<TransactionDate>8/9/2011 12:00:00</TransactionDate>
<TransactionType>Order</TransactionType>
<OrderID>87123017</OrderID>
<InvoiceID>75994476</InvoiceID>
<SellerPartNumber>A09D77897686</SellerPartNumber>
<NeweggItemNumber>9SIA00X0002HJ5</NeweggItemNumber>
<ItemDescription>dfdfgsdfg</ItemDescription>
<ItemCondition>New</ItemCondition>
<Amount>10.00</Amount>
<Shipping>2.00</Shipping>
<CommissionFee>-0.75</CommissionFee>
<SettlementID />
418
</SettlementTransactionInfo>
</SettlementTransactionInfoList>
</ResponseBody>
<Memo />
</NeweggAPIResponse>
Example: Json, Response
{
"NeweggAPIResponse": {
"IsSuccess": "true",
"SellerID": "A09D",
"OperationType": "GetSettlementTransactionInfoResponse",
"ResponseBody": {
"PageInfo": {
"TotalCount": "21",
"TotalPageCount": "21",
"PageSize": "10",
"PageIndex": "1"
},
"RequestID": "2PQDKCAQFHL3M",
"RequestDate": "2/23/2012 11:39:00",
"SettlementTransactionInfoList": {
"SettlementTransactionInfo": {
"TransactionDate": "8/9/2011 12:00:00",
"TransactionType": "Order",
"OrderID": "87123017 ",
"InvoiceID": "75994476 ",
"SellerPartNumber": "A09D77897686",
"NeweggItemNumber": "9SIA00X0002HJ5",
"ItemDescription": "dfdfgsdfg",
"ItemCondition": "New",
"Amount": "10.00",
"Shipping": "2.00", "CommissionFee": "-0.75",
"SettlementID": null
}
}
},
"Memo": null
}
}
419
Daily Inventory Report
Attribute
Format
Description
NeweggAPIResponse
IsSuccess
String
Used to identify the operation is successful. Returns true or false.
SellerID
String
Your seller ID
OperationType
String
Fixed value: DailyinventoryReportResponse
SellerID
String
Your seller ID
Response Body
RequestID
String
You request ID
RequestType
String
DAILY_INVENTORY_REPORT
RequestDate
String
You request datetime(Pacific Standard Time)
ReportFileURL
string
The ftp file path, where you can get the report result file.
For example:
ftp://API-
52qNFlUQ:pKLgE2aE@ftp03.newegg.com/DailyInventoryReport_2PN75DT8ZICH8.txt
Memo
String
Additional Information.
Example: XML, Response
XSD
API Schema > ReportMgmt > GetReport > DailyinventoryResponse.xsd
<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<sellerID>A006</sellerID>
<OperationType>DailyinventoryReportResponse</OperationType>
<ResponseBody>
<RequestID>2PQC13C7UYDPQ</RequestID>
<RequestType>DAILY_INVENTORY_REPORT</RequestType>
<RequestDate>2/21/2012 15:32:57</RequestDate>
<ReportFileURL>ftp://API-e6Cl2FfE:M9RUtm2s@ftp03.newegg.com/DailyInventoryReport_2PQC13C7UYDPQ.xls</ReportFileURL>
</ResponseBody>
<Memo />
</NeweggAPIResponse>
Example: Json, Response
420
{
"NeweggAPIResponse": {
"IsSuccess": "true",
"sellerID": "A006",
"OperationType": "DailyinventoryReportResponse",
"ResponseBody": {
"RequestID": "2PQC13C7UYDPQ",
"RequestType": "DAILY_INVENTORY_REPORT",
"RequestDate": "2/21/2012 15:32:57",
"ReportFileURL": "ftp://API-
e6Cl2FfE:M9RUtm2s@ftp03.newegg.com/DailyInventoryReport_2PQC13C7UYDPQ.xls"
},
"Memo": null
}
}
421
RMA List Report
Attribute
Format
Description
NeweggAPIResponse
IsSuccess
String
Used to identify the operation is successful. Returns
true or false.
SellerID
String
Your seller ID
OperationType
String
Fixed value: GetRMAListInfoResponse
ResponseByody
RequestID
String
You request ID
RequestDate
String
You request datetime(Pacific Standard Time)
PageInfo
TotalCount
Integer
Total number of records
TotalPageCount
Integer
Total page count
PageIndex
Integer
Current page index
PageSize
Integer
How many records in a page.
RMAInfoList
RMAInfo
SellerID
String
SellerID
RMANumber
Integer
RMANumber
RMAType
Integer
Available values:
1: Replacement
2: Refund
RMATypeDescription
String
Available values:
Replacement for the type code: 1
Refund for the type code: 2
SellerRMANumber
String
Seller RMA #.
An alphanumeric string, max 50 characters.
Note:avaialbel for version=307 and 309
ReplacementOrderNumber
String
The Order Number of the replacement order.
After confirming the return item is received, Newegg
will create a replacement order for you to process.
Note: available for RMA type: Replacement (RMAType
value= 1) and the request version=309
RMADate
String
Date of RMA(Pacific Standard Time)
422
RMAStatus
Integer
Available values:
1: Open
2: Received
3: Rejected
4: Voided
5: Closed
6: Processing
RMAStatusDescription
String
Available values:
Open for status code: 1
Received for status code: 2
Rejected for status code: 3
Voided for status code: 4
Closed for status code: 5
Processing for status code: 6
LastEditDate
String
Last edit date(Pacific Standard Time)
LastEditUser
String
Last edit user
OrderNumber
Integer
Order Number of the RMA requested order.
OrderDate
String
Order Date(Pacific Standard Time)
InvoiceNumber
Integer
Invoice Number of the RMA requested order.
OrderAmount
Decimal
Order Amount
RMAProcessedBy
String
Newegg or Seller
CustomerName
String
Customer Name
CustomerPhoneNumber
String
Customer Phone Number
CustomerAddress
String
Customer Address
RMAReceiveDate
String
RMA shipment received date(Pacific Standard Time)
RMANote
String
The comment in this RMA
RMATransactionList
RMATransaction
SellerPartNumber
String
The seller part number to identify a SKU
MfrPartNumber
String
Manufacturer Part Number
NeweggItemNumber
String
Newegg Item Number
Description
String
Item Description
423
UnitPirce
Decimal
The return unit price of each SKU in refund RMA
Refund/Replacement Info
ItemReturnQty
Integer
The return quantity of each SKU in this RMA
ItemRefundPerQty
Integer
Refund per qty of the item
ItemShippingRefun
d
Decimal
The shipping amount of refund of each SKU in this RMA
RMATotalRefund
Decimal
RMA total Refund
RefundReason
Integer
The replacement/refund reason of each SKU in this
RMA.
Available values:
1: Carrier damage
2: Defective
3: Incompatible
4: Not match what we show
5: Sent wrong item
6: Personal Reason | Other Reason
RMAReasonDescrip
tion
String
Available values:
Carrier damage for reason code: 1
Defective for reason code: 2
Incompatible for reason code: 3
Not match what we show for reason code: 4
Sent wrong item for reason code: 5
Personal Reason | Other Reason for reason code: 6
ShippedBy
Integer
0. Shipped by seller
1. Shipped by Newegg
RMAShipMethod
Integer
The ship method if you want issue a replacement RMA.
Available values:
1: Media Mail(7-14 business days)
2: Standard Shipping(5-7 business days)
3: Expedited Shipping(3-5 business days)
4: Two-Day shipping
5: One-day shipping
6: International Standard Shipping(5-15 business days)
7: International Expedited Shipping(3-5 business days)
8: International Two-Day shipping
9: International Two-Day Shipping(2 business days)
10: APO/FPO Military ONLY
11: Newegg Premier 3 Days
12: Newegg Premier 2 Days
13: Newegg Premier Next Day
424
RMAShipMethodDe
scription
String
Available values:
Super Saver(7-14 business days)for status code: 1
Standard Shipping(5-7 business days) for status code: 2
Expedited Shipping(3-5 business days) for status code:
3
Two-Day Shipping(2 business days)for status code: 4
One-Day Shipping(Next day)for status code: 5
International Economy Shipping(8-15 business
days)for status code: 6
International Standard Shipping(5-7 business days)for
status code: 7
International Expedited Shipping (3-5 business
days)for status code: 8
International Two-Day Shipping(2 business days) for
status code :9
APO/FPO Military ONLY for status code:10
Newegg Premier 3 Days for status code:11
Newegg Premier 2 Days for status code:12
Newegg Premier Next Day for status code:13
ReplacementReaso
n
Integer
Available values:
1: Carrier damage
2: Defective
3: Incompatible
4: Not match what we show
5: Sent wrong item
6: Personal Reason | Other Reason
Memo
String
Additional Information.
ResponseDate
String
The respond date of this report.
Example: XML, Response
XSD
API Schema > ReportMgmt > GetReport > RMAListResponse.xsd
<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<SellerID>A006</SellerID>
<OperationType>GetRMAListInfoResponse</OperationType>
425
<ResponseBody>
<PageInfo>
<TotalCount>38</TotalCount>
<TotalPageCount>38</TotalPageCount>
<PageSize>10</PageSize>
<PageIndex>1</PageIndex>
</PageInfo>
<RequestID>2PQC1CJFRIWLZ</RequestID>
<RequestDate>2/21/2012 15:46:17</RequestDate>
<RMAInfoList>
<RMAInfo>
<SellerID>A006</SellerID>
<RMANumber>46535720</RMANumber>
<RMATypeDescription>Refund</RMATypeDescription>
<SellerRMANumber>E12345678</SellerRMANumber>
<RMAType>2</RMAType>
<RMADate>8/17/2011 12:14:55</RMADate>
<RMAStatus>4</RMAStatus>
<RMAStatusDescription>Void</RMAStatusDescription>
<LastEditDate>8/17/2011 12:19:34</LastEditDate>
<LastEditUser>vy95</LastEditUser>
<OrderNumber>41471602</OrderNumber>
<OrderDate>8/16/2011 22:37:59</OrderDate>
<InvoiceNumber>76299193</InvoiceNumber>
<OrderAmount>19.20</OrderAmount>
<RMAProcessedBy>Seller</RMAProcessedBy>
<CustomerName>Jana Mmm</CustomerName>
<CustomerPhoneNumber>123-271-1420</CustomerPhoneNumber>
<CustomerAddress>17708 Rowland Street, , City of Industry, DC, 20001,
USA</CustomerAddress>
<RMAReceivedDate />
<RMANote />
<RMATransactionList>
<RMATransaction>
<SellerPartNumber>6sdfasd96</SellerPartNumber>
<MfrPartNumber>42asdfa730</MfrPartNumber>
<NeweggItemNumber>9SIA00603H5974</NeweggItemNumber>
<Description>testing Axed- Splitting</Description>
<UnitPrice>10.00</UnitPrice>
<ReplacementInfo>
<ItemReturnQty>1</ItemReturnQty>
426
<ShippedBy>Seller</ShippedBy>
<ReplacementReason>-1</ReplacementReason>
<ReplacementReasonDescription>Other reason</ReplacementReasonDescription>
<RMAShipMethod>Standard Shipping(5-7 business days)</RMAShipMethod>
</ReplacementInfo>
</RMATransaction>
</RMATransactionList>
</RMAInfo>
</RMAInfoList>
</ResponseBody>
<Memo />
</NeweggAPIResponse>
Example: Json, Response
{
"NeweggAPIResponse": {
"IsSuccess": "true",
"SellerID": "A006",
"OperationType": "GetRMAListInfoResponse",
"ResponseBody": {
"PageInfo": {
"TotalCount": "38",
"TotalPageCount": "38",
"PageSize": "10",
"PageIndex": "1"
},
"RequestID": "2PQC1CJFRIWLZ",
"RequestDate": "2/21/2012 15:46:17",
"RMAInfoList": {
"RMAInfo": {
"SellerID": "A006 ",
"RMANumber": "46535720",
"RMATypeDescription": "Refund",
“SellerRMANumber”:”E1234567”,
"RMAType": "2",
"RMADate": "8/17/2011 12:14:55",
"RMAStatus": "4",
"RMAStatusDescription": "Void",
"LastEditDate": "8/17/2011 12:19:34",
"LastEditUser": "vy95",
427
"OrderNumber": "41471602",
"OrderDate": "8/16/2011 22:37:59",
"InvoiceNumber": "76299193",
"OrderAmount": "19.20",
"RMAProcessedBy": "Seller",
"CustomerName": "Jana Mmm",
"CustomerPhoneNumber": "123-271-1420",
"CustomerAddress": "17708 Rowland Street, , City of Industry, DC, 20001, USA",
"RMAReceivedDate": null,
"RMANote": null,
"RMATransactionList": {
"RMATransaction": {
"SellerPartNumber": "6sdfasd96",
"MfrPartNumber": "42asdfa730",
"NeweggItemNumber": "9SIA00603H5974",
"Description": "testing Axed- Splitting",
"UnitPrice": "10.00",
"ReplacementInfo": {
"ItemReturnQty": "1",
"ShippedBy": "Seller",
"ReplacementReason": "-1",
"ReplacementReasonDescription": "Other reason",
"RMAShipMethod": "Standard Shipping(5-7 business days)"
}
}
}
}
}
},
"Memo": null
}
}
Item Lookup Report
Attribute
Format
Description
Newegg
APIResp
onse
IsSuccess
String
Used to identify the operation is successful. Returns
true or false.
SellerID
String
Your seller ID
428
OperationType
String
Fixed value: ItemLookupResponse
ResponseByody
RequestID
String
You request ID
RequestDate
String
You request datetime(Pacific Standard Time)
PageInfo
TotalCount
Integer
Total number of records
TotalPageCount
Integer
Total page count
PageIndex
Integer
Current page index
PageSize
Integer
How many records in a page.
ItemList
Item
ParentItemNumber
String
The parent item number
UPC
String
The upc code
Condition
Integer
Available values:
1: New
2: Refurbished
3: Used Like New
4: Used Very Good
5: Used Good
6: Used Acceptable
PacksOrSets
Integer
Identify the package count of this product.
Please note: all products in a pack or set will have
matching item and condition.
ManufacturerName
Integer
The manufacture name
ManufacturerPartNumber
String
The manufacture part number
WebShortTitle
String
The web short title
Note
String
The note
ResponseDate
String
The respond date of this report.
Example: XML, Response
XSD
API Schema > ReportMgmt > GetReport > ItemLookupResponse.xsd
<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
429
<OperationType>ItemLookupResponse</OperationType>
<SellerID>bfwk</SellerID>
<ResponseBody>
<PageInfo>
<TotalCount>4</TotalCount>
<TotalPageCount>1</TotalPageCount>
<PageIndex>1</PageIndex>
<PageSize>10</PageSize>
</PageInfo>
<RequestID>28292T8ASAL64</RequestID>
<RequestDate>07/11/2014 18:14:04</RequestDate>
<ItemList>
<Item>
<ParentItemNumber>01T-001Y-00004</ParentItemNumber>
<UPC>20140711101111</UPC>
<Condition>1</Condition>
<PacksOrSets>1</PacksOrSets>
<ManufacturerName><![CDATA[q-see ]]></ManufacturerName>
<ManufacturerPartNumber><![CDATA[canmfpn20140711101 ]]></ManufacturerPartNumber>
<WebShortTitle><![CDATA[b2b new item 201407111001 ]]></WebShortTitle>
</Item>
<Item>
<ParentItemNumber>01T-001Y-00004</ParentItemNumber>
<UPC>20140711101111</UPC>
<Condition>1</Condition>
<PacksOrSets>1</PacksOrSets>
<ManufacturerName><![CDATA[q-see ]]></ManufacturerName>
<ManufacturerPartNumber><![CDATA[canmfpn20140711101 ]]></ManufacturerPartNumber>
<WebShortTitle><![CDATA[b2b new item 201407111001 ]]></WebShortTitle>
</Item>
<Item>
<ParentItemNumber>01T-001Y-00004</ParentItemNumber>
<UPC>20140711101111</UPC>
<Condition>1</Condition>
<PacksOrSets>1</PacksOrSets>
<ManufacturerName><![CDATA[q-see ]]></ManufacturerName>
<ManufacturerPartNumber><![CDATA[canmfpn20140711101 ]]></ManufacturerPartNumber>
<WebShortTitle><![CDATA[b2b new item 201407111001 ]]></WebShortTitle>
</Item>
<Item>
<ParentItemNumber>01T-001Y-00007</ParentItemNumber>
430
<UPC />
<Condition>2</Condition>
<PacksOrSets>1</PacksOrSets>
<ManufacturerName><![CDATA[q-see ]]></ManufacturerName>
<ManufacturerPartNumber><![CDATA[canmfpn20140711101 ]]></ManufacturerPartNumber>
<WebShortTitle><![CDATA[456346 ]]></WebShortTitle>
</Item>
</ItemList>
</ResponseBody>
<ResponseDate>07/11/2014 19:00:59</ResponseDate>
</NeweggAPIResponse>
Example: Json, Response
{
"ResponseDate": "07/11/2014 19:00:59"
"IsSuccess": "true",
"OperationType": "ItemLookupResponse",
"SellerID": "bfwk",
"ResponseBody": {
"PageInfo": {
"TotalCount": "4",
"TotalPageCount": "1",
"PageIndex": "1",
"PageSize": "10"
},
"RequestID": "28292T8ASAL64",
"RequestDate": "07/11/2014 18:14:04",
"ItemList":
{
"ParentItemNumber": "01T-001Y-00004",
"UPC": "20140711101111",
"Condition": "1",
PacksOrSets”:”1”,
"ManufacturerName": "q-see",
"ManufacturerPartNumber": "canmfpn20140711101",
"WebShortTitle": "b2b new item 201407111001"
},
{
"ParentItemNumber": "01T-001Y-00004",
431
"UPC": "20140711101111",
"Condition": "1",
PacksOrSets”:”1”,
"ManufacturerName": "q-see",
"ManufacturerPartNumber": "canmfpn20140711101",
"WebShortTitle": "b2b new item 201407111001"
},
{
"ParentItemNumber": "01T-001Y-00004",
"UPC": "20140711101111",
"Condition": "1",
PacksOrSets”:”1”,
"ManufacturerName": "q-see",
"ManufacturerPartNumber": "canmfpn20140711101",
"WebShortTitle": "b2b new item 201407111001"
},
{
"ParentItemNumber": "01T-001Y-00007",
"UPC": "",
"Condition": "2",
PacksOrSets”:”1”,
"ManufacturerName": "q-see",
"ManufacturerPartNumber": "canmfpn20140711101",
"WebShortTitle": "456346"
}
]
}
}
International Program - Daily Inventory Report
Attribute
Format
Description
NeweggAPIResponse
IsSuccess
String
Used to identify the operation is successful. Returns true or false.
SellerID
String
Your seller ID
OperationType
String
Fixed value: InternationalInventoryReportResponse
SellerID
String
Your seller ID
Respons
e Body
RequestID
String
You request ID
RequestType
String
INTERNATIONAL_INVENTORY_REPORT
432
RequestDate
String
You request datetime(Pacific Standard Time)
ReportFileURL
string
The ftp file path, where you can get the report result file.
For example:
ftp://API-
52qNFlUQ:pKLgE2aE@ftp03.newegg.com/InternationalInventoryReport_2PN75DT8ZIC
H8.txt
Memo
String
Additional Information.
Example: XML, Response
XSD
API Schema > ReportMgmt > GetReport > InternationalInventoryReportResponse.xsd
<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<sellerID>A006</sellerID>
<OperationType>InternationalInventoryReportResponse</OperationType>
<ResponseBody>
<RequestID>2PQC13C7UYDPQ</RequestID>
<RequestType>INTERNATIONAL_INVENTORY_REPORT</RequestType>
<RequestDate>2/21/2012 15:32:57</RequestDate>
<ReportFileURL>ftp://API-
e6Cl2FfE:M9RUtm2s@ftp03.newegg.com/InternationalInventoryReport_2PQC13C7UYDPQ.xls</ReportFileURL>
</ResponseBody>
<Memo />
</NeweggAPIResponse>
Example: Json, Response
{
"NeweggAPIResponse": {
"IsSuccess": "true",
"sellerID": "A006",
"OperationType": "InternationalInventoryReportResponse",
"ResponseBody": {
"RequestID": "2PQC13C7UYDPQ",
"RequestType": "INTERNATIONAL_INVENTORY_REPORT",
"RequestDate": "2/21/2012 15:32:57",
433
"ReportFileURL": "ftp://API-
e6Cl2FfE:M9RUtm2s@ftp03.newegg.com/InternationalInventoryReport_2PQC13C7UYDPQ.xls"
},
"Memo": null
}
}
International Program - Daily Price Report
Attribute
Format
Description
NeweggAPIResponse
IsSuccess
String
Used to identify the operation is successful. Returns true or false.
SellerID
String
Your seller ID
OperationType
String
Fixed value: InternationalPriceReportResponse
SellerID
String
Your seller ID
Response Body
RequestID
String
You request ID
RequestType
String
INTERNATIONAL_PRICE_REPORT
RequestDate
String
You request datetime(Pacific Standard Time)
ReportFileURL
string
The ftp file path, where you can get the report result file.
For example:
ftp://API-
52qNFlUQ:pKLgE2aE@ftp03.newegg.com/InternationalPriceReport_2PN75DT8ZICH8.tx
t
Memo
String
Additional Information.
Example: XML, Response
XSD
API Schema > ReportMgmt > GetReport > InternationalPriceReportResponse.xsd
<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<sellerID>A006</sellerID>
<OperationType>InternationalPriceReportResponse</OperationType>
<ResponseBody>
<RequestID>2PQC13C7UYDPQ</RequestID>
434
<RequestType>INTERNATIONAL_PRICE_REPORT</RequestType>
<RequestDate>2/21/2012 15:32:57</RequestDate>
<ReportFileURL>ftp://API-e6Cl2FfE:M9RUtm2s@ftp03.newegg.com/InternationalPriceReport_2PQC13C7UYDPQ.xls</ReportFileURL>
</ResponseBody>
<Memo />
</NeweggAPIResponse>
Example: Json, Response
{
"NeweggAPIResponse": {
"IsSuccess": "true",
"sellerID": "A006",
"OperationType": "InternationalPriceReportResponse",
"ResponseBody": {
"RequestID": "2PQC13C7UYDPQ",
"RequestType": "INTERNATIONAL_PRICE_REPORT",
"RequestDate": "2/21/2012 15:32:57",
"ReportFileURL": "ftp://API-
e6Cl2FfE:M9RUtm2s@ftp03.newegg.com/InternationalPriceReport_2PQC13C7UYDPQ.xls"
},
"Memo": null
}
}
Newegg Premier Item Report
Attribute
Format
Description
NeweggAPIResponse
IsSuccess
String
Used to identify the operation is successful. Returns true or false.
SellerID
String
Your seller ID
OperationType
String
Fixed value: PremierItemReportResponse
SellerID
String
Your seller ID
Response
Body
RequestID
String
You request ID
RequestType
String
PREMIER_ITEM_REPORT
RequestDate
String
You request datetime(Pacific Standard Time)
435
ReportFileURL
string
The ftp file path, where you can get the report result file.
For example:
ftp://API-
52qNFlUQ:pKLgE2aE@ftp03.newegg.com/PremierItemReport_2PN75DT8ZICH8.txt
Memo
String
Additional Information.
Example: XML, Response
XSD
API Schema > ReportMgmt > GetReport > PremierItemResponse.xsd
<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<sellerID>A006</sellerID>
<OperationType>PremierItemReportResponse</OperationType>
<ResponseBody>
<RequestID>2PQC13C7UYDPQ</RequestID>
<RequestType>Premier_ITEM_REPORT</RequestType>
<RequestDate>2/21/2012 15:32:57</RequestDate>
<ReportFileURL>ftp://API-e6Cl2FfE:M9RUtm2s@ftp03.newegg.com/PremierItemReport_2PQC13C7UYDPQ.xls</ReportFileURL>
</ResponseBody>
<Memo />
</NeweggAPIResponse>
Example: Json, Response
{
"NeweggAPIResponse": {
"IsSuccess": "true",
"sellerID": "A006",
"OperationType": "PremierItemReportResponse",
"ResponseBody": {
"RequestID": "2PQC13C7UYDPQ",
"RequestType": "Premier_ITEM_REPORT",
"RequestDate": "2/21/2012 15:32:57",
"ReportFileURL": "ftp://API-e6Cl2FfE:M9RUtm2s@ftp03.newegg.com/PremierItemReport
2PQC13C7UYDPQ.xls"
},
"Memo": null
436
}
}
California’s Proposition 65 Warning Report
Attribute
Format
Description
NeweggAPIResponse
IsSuccess
String
Used to identify the operation is successful. Returns true or false.
SellerID
String
Your seller ID
OperationType
String
Fixed value: CAProp65ReportResponse
Response Body
RequestID
String
You request ID
RequestType
String
CAPROP65_REPORT
RequestDate
String
You request datetime(Pacific Standard Time)
ReportFileURL
string
The ftp file path, where you can get the report result file.
For example:
ftp://API-
52qNFlUQ:pKLgE2aE@ftp03.newegg.com/CAProp65Report_2PN75DT8ZICH8.zip
NOTE: the result may be in multiple files, 40,000 records per file. They will be
Compressed into a zip formatted single package.
Memo
String
Additional Information.
Example: XML, Response
XSD
API Schema > ReportMgmt > GetReport > CAProp65ReportResponse.xsd
<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<sellerID>A006</sellerID>
<OperationType>CAProp65ReportResponse</OperationType>
<ResponseBody>
<RequestID>2PQC13C7UYDPQ</RequestID>
<RequestType>CAPROP65_REPORT</RequestType>
<RequestDate>2/21/2012 15:32:57</RequestDate>
<ReportFileURL>ftp://API-
e6Cl2FfE:M9RUtm2s@ftp03.newegg.com/CAProp65Report_2PQC13C7UYDPQ.zip</ReportFileURL>
</ResponseBody>
<Memo />
437
</NeweggAPIResponse>
Example: Json, Response
{
"NeweggAPIResponse": {
"IsSuccess": "true",
"sellerID": "A006",
"OperationType": "CAProp65ReportResponse",
"ResponseBody": {
"RequestID": "2PQC13C7UYDPQ",
"RequestType": "CAPROP65_REPORT",
"RequestDate": "2/21/2012 15:32:57",
"ReportFileURL": "ftp://API-
e6Cl2FfE:M9RUtm2s@ftp03.newegg.com/CAProp65Report_2PQC13C7UYDPQ.zip"
},
"Memo": null
}
}
Tax Setting Report for Items Enabled for China
Attribute
Format
Description
NeweggAPIResponse
IsSuccess
String
Used to identify the operation is successful. Returns true or false.
SellerID
String
Your seller ID
OperationType
String
Fixed value: ItemChinaTaxSettingReportResponse
Response Body
RequestID
String
You request ID
RequestType
String
ITEM_CHINATAXSETTING_REPORT
RequestDate
String
You request datetime(Pacific Standard Time)
ReportFileURL
string
The ftp file path, where you can get the report result file.
For example:
ftp://API-
52qNFlUQ:pKLgE2aE@ftp03.newegg.com/ItemChinaTaxSettingReport_2PN75DT8ZICH
8.zip
Memo
String
Additional Information.
Example: XML, Response
438
XSD
API Schema > ReportMgmt > GetReport > ItemChinaTaxSettingReportResponse.xsd
<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<sellerID>A006</sellerID>
<OperationType>ItemChinaTaxSettingReportResponse</OperationType>
<ResponseBody>
<RequestID>2PQC13C7UYDPQ</RequestID>
<RequestType>ITEM_CHINATAXSETTING_REPORT</RequestType>
<RequestDate>2/21/2012 15:32:57</RequestDate>
<ReportFileURL>ftp://API-
e6Cl2FfE:M9RUtm2s@ftp03.newegg.com/InternationalPriceReport_2PQC13C7UYDPQ.zip</ReportFileURL>
</ResponseBody>
<Memo />
</NeweggAPIResponse>
Example: Json, Response
{
"NeweggAPIResponse": {
"IsSuccess": "true",
"sellerID": "A006",
"OperationType": "ItemChinaTaxSettingReportResponse",
"ResponseBody": {
"RequestID": "2PQC13C7UYDPQ",
"RequestType": "ITEM_CHINATAXSETTING_REPORT",
"RequestDate": "2/21/2012 15:32:57",
"ReportFileURL": "ftp://API-
e6Cl2FfE:M9RUtm2s@ftp03.newegg.com/ItemChinaTaxSettingReport_2PQC13C7UYDPQ.zip"
},
"Memo": null
}
}
14.3.4. Request Failure Errors
For common HTTP error responses, please refer to Common Error Responses
439
Example: XML, Response
<?xml version="1.0" encoding="utf-8"?>
<Errors>
<Error>
<Code>CE001</Code>
<Message>SellerID cannot be null or empty</Message>
</Error>
</Errors>
Example: Json, Response
{
"Code": "CE001",
"Message": "SellerID cannot be null or empty"
}
440
15. Seller Management
The Seller Management service group contains functions that will allow you to get reference information you may need to use some of
the functions in Newegg API.
15.1. Get Industry List
Get the list of industry that is currently on Newegg Marketplace. Response contains Industry Code and Industry Name.
15.1.1. Resource URL & Information
Resource URL
https://api.newegg.com/marketplace/sellermgmt/seller/industry?sellerid={sellerid}&industrycode={industrycode}
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
industrycode
No
Industry code.
If you don’t specify this parameter, system will return all industries.
Resource Information
HTTP Method
Authentication?
Request Formats
Response Formats
Rate Limited?
GET
Required
XML, Json
XML, Json
1000 per min per client
15.1.2. Request Body
Example: XML, Request
GET https://api.newegg.com/marketplace/sellermgmt/seller/industry?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
Example: Json, Request
441
GET https://api.newegg.com/marketplace/sellermgmt/seller/industry?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
15.1.3. Response Body
Attribute
Format
Description
NeweggAPIResponse
IsSuccess
String
Used to identify the operation of Get feed status is
successful
True or False
OperationType
String
Fixed value: GetSellerIndustryResponse
SellerID
String
Your seller ID
ResponseBody
IndustryList
Industry
IndustryCode
String
The industry code
IndustryName
String
The industry name
Example: XML, Response
XSD
API Schema > SellerMgmt > GetIndustry > GetIndustryResponse.xsd
<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<OperationType>GetSellerIndustryResponse</OperationType>
<SellerID>A006</SellerID>
<ResponseBody>
<IndustryList>
<Industry>
<IndustryCode>AP</IndustryCode>
<IndustryName>Apparel</IndustryName>
</Industry>
<Industry>
<IndustryCode>AL</IndustryCode>
<IndustryName>Appliance</IndustryName>
442
</Industry>
</IndustryList>
</ResponseBody>
</NeweggAPIResponse>
Example: Json, Response
{
"IsSuccess": "true",
"OperationType": "GetSellerIndustryResponse",
"SellerID": "A006",
"ResponseBody": {
"IndustryList":[
{
"IndustryCode": "AP",
"IndustryName": "Apparel"
},
{
"IndustryCode": "AL",
"IndustryName": "Appliance"
}
]
}
}
15.1.4. Request Failure Errors
For common HTTP error responses, please refer to Common Error Responses
Error Code
Description
DF008
Invalid industry code [{0}].
Example: XML, Response
<?xml version="1.0" encoding="utf-8"?>
<Errors>
<Error>
<Code>DF008</Code>
<Message>Invalid industry code ABC</Message>
</Error>
443
</Errors>
Example: Json, Response
{
"Code": "DF008",
"Message": "Invalid industry code ABC"
}
15.2. Get Subcategory Status
Get the subcategory status for the specified seller account. Subcategory is either enabled or not enabled for a seller.
15.2.1. Resource URL & Information
Resource URL
https://api.newegg.com/marketplace/sellermgmt/seller/subcategory?sellerid={sellerid}
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
Resource Information
HTTP Method
Authentication?
Request Formats
Response Formats
Rate Limited?
PUT
Required
XML, Json
XML, Json
1000 per min per client
15.2.2. Request Body
Attribute
Required
?
Format
Description
NeweggAPIRequest
OperationType
Yes
String
Fixed value: GetSellerSubcategoryRequest
RequestBody
GetItemSubcategor
y
SubcategoryIDList
SubcategoryID
No
Integer
Subcategory ID. If this value is provided, then response will
only contain information of the specified subcategory ID.
444
Industry7CodeList
IndustryCode
No
String
Industry Code
Enabled
No
Integer
Condition filter to specify the request by sub-category current
status.
Available values:
0: Not Enabled
1: Enabled
If left blank, the response will return both Not Enabled and
Enabled subcategories
Example: XML, Request
XSD
API Schema > SellerMgmt > GetSubcategory > GetSubcatetoryRequest.xsd
PUT https://api.newegg.com/marketplace/sellermgmt/seller/subcategory?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggAPIRequest>
<OperationType>GetSellerSubcategoryRequest</OperationType>
<RequestBody>
<GetItemSubcategory>
<SubcategoryIDList>
<SubcategoryID>397</SubcategoryID>
</SubcategoryIDList>
<IndustryCodeList>
<IndustryCode>CH</IndustryCode>
</IndustryCodeList>
<Enabled>1</Enabled>
</GetItemSubcategory>
</RequestBody>
</NeweggAPIRequest>
445
Example: Json, Request
PUT https://api.newegg.com/marketplace/sellermgmt/seller/subcategory?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"OperationType": "GetSellerSubcategoryRequest",
"RequestBody": {
"GetItemSubcategory": {
"SubcategoryIDList": { "SubcategoryID": "397" },
"IndustryCodeList": { "IndustryCode": "CH" },
"Enabled": "1"
}
}
}
15.2.3. Response Body
Attribute
Format
Description
NeweggAPIResponse
IsSuccess
String
Used to identify the operation of Get feed status is
successful
True or False
OperationType
String
Fixed value: GetSellerSubcategoryResponse
SellerID
String
Your seller ID
ResponseBody
SubcategoryList
Subcategory
IndustryCode
String
The industry code
IndustryName
String
The industry name
SubcategoryID
Integer
The subcategory ID
SubcategoryName
String
The subcategory name
Enabled
Integer
The subcategory is enabled or not for this seller
Available values;
0: Not Enabled
1: Enabled
Example: XML, Response
446
XSD
API Schema > SellerMgmt > GetSubcategory > GetSubcatetoryResponse.xsd
<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<OperationType>GetSellerSubcategoryResponse</OperationType>
<SellerID>A006</SellerID>
<ResponseBody>
<SubcategoryList>
<Subcategory>
<IndustryCode>AP</IndustryCode>
<IndustryName>Apparel</IndustryName>
<SubcategoryID>1508</SubcategoryID>
<SubcategoryName> <![CDATA[Belts & Suspenders]]></SubcategoryName>
<Enabled>1</Enabled>
</Subcategory>
<Subcategory>
<IndustryCode>AP</IndustryCode>
<IndustryName>Apparel</IndustryName>
<SubcategoryID>153</SubcategoryID>
<SubcategoryName> <![CDATA[Buckles]]></SubcategoryName>
<Enabled>0</Enabled>
</Subcategory>
</SubcategoryList>
</ResponseBody>
</NeweggAPIResponse>
Example: Json, Response
{
"IsSuccess": "true",
"OperationType": "GetSellerSubcategoryResponse",
"SellerID": "A006",
"ResponseBody": {
"SubcategoryList":[
{
"IndustryCode": "AP",
"IndustryName": "Apparel",
"SubcategoryID": "1508",
447
"SubcategoryName": "Belts & Suspenders",
"Enabled": "1"
},
{
"IndustryCode": "AP",
"IndustryName": "Apparel",
"SubcategoryID": "153",
"SubcategoryName": "Buckles",
"Enabled": "0"
}
]
}
}
15.2.4. Request Failure Errors
For common HTTP error responses, please refer to Common Error Responses
Error Code
Description
DF008
Invalid industry code [{0}].
Example: XML, Response
<?xml version="1.0" encoding="utf-8"?>
<Errors>
<Error>
<Code>DF008</Code>
<Message>Invalid industry code ABC</Message>
</Error>
</Errors>
Example: Json, Response
{
"Code": "DF008",
"Message": "Invalid industry code ABC"
}
448
15.3. Get Subcategory Status for international country
Get the subcategory eligibility for a seller on international country. Subcategory is either enabled or not enabled for a
seller.
15.3.1. Resource URL & Information
Resource URL
https://api.newegg.com/marketplace/sellermgmt/seller/subcategory/V2?sellerid={sellerid}
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
Resource Information
HTTP Method
Authentication?
Request Formats
Response Formats
Rate Limited?
PUT
Required
XML, Json
XML, Json
1000 per min per client
15.3.2. Request Body
Attribute
Required
?
Format
Description
NeweggAPIRequest
OperationType
Yes
String
Fixed value: GetSellerSubcategoryRequest
RequestBody
CountryCode
Yes
String
The country where the subcategory status you want to check.
Note: only the ISO standard 3-digit codes are accepted.
To review the complete list of available values, please
download the following:
https://promotions.newegg.com/Marketplace/Sellers/resourc
eLibrary/International%20Country%20Guide.pdf
GetItemSubcategor
y
SubcategoryIDList
SubcategoryID
No
Integer
Subcategory ID. If this value is provided, then response will
only contain information of the specified subcategory ID.
449
Industry7CodeList
IndustryCode
No
String
Industry Code
Enabled
No
Integer
Condition filter to specify the request by sub-category current
status.
Available values:
0: Not Enabled
1: Enabled
If left blank, the response will return both Not Enabled and
Enabled subcategories
Example: XML, Request
XSD
API Schema > SellerMgmt > GetSubcategory > GetSubcatetoryRequestV2.xsd
PUT https://api.newegg.com/marketplace/sellermgmt/seller/subcategory/V2?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggAPIRequest>
<OperationType>GetSellerSubcategoryRequest</OperationType>
<RequestBody>
<CountryCode>USA</CountryCode>
<GetItemSubcategory>
<SubcategoryIDList>
<SubcategoryID>397</SubcategoryID>
</SubcategoryIDList>
<IndustryCodeList>
<IndustryCode>CH</IndustryCode>
</IndustryCodeList>
<Enabled>1</Enabled>
</GetItemSubcategory>
</RequestBody>
</NeweggAPIRequest>
450
Example: Json, Request
PUT https://api.newegg.com/marketplace/sellermgmt/seller/subcategory/V2?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"OperationType": "GetSellerSubcategoryRequest",
"RequestBody": {
CountryCode”:”USA”,
"GetItemSubcategory": {
"SubcategoryIDList": { "SubcategoryID": "397" },
"IndustryCodeList": { "IndustryCode": "CH" },
"Enabled": "1"
}
}
}
15.3.3. Response Body
Attribute
Format
Description
NeweggAPIResponse
IsSuccess
String
Used to identify the operation of Get feed status
is successful
True or False
OperationType
String
Fixed value: GetSellerSubcategoryResponse
SellerID
String
Your seller ID
ResponseBody
CountryCode
String
The country where the subcategory status you
want to check.
Note: only the ISO standard 3-digit codes are
accepted.
To review the complete list of available values,
please download the following:
https://promotions.newegg.com/Marketplace/Sel
lers/resourceLibrary/International%20Country%2
0Guide.pdf
451
SubcategoryList
Subcategory
IndustryCode
String
The industry code
IndustryName
String
The industry name
SubcategoryID
Integer
The subcategory ID
SubcategoryName
String
The subcategory name
Enabled
Integer
The subcategory is enabled or not for this seller
Available values;
0: Not Enabled
1: Enabled
Example: XML, Response
XSD
API Schema > SellerMgmt > GetSubcategory > GetSubcatetoryResponse.xsd
<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<OperationType>GetSellerSubcategoryResponse</OperationType>
<SellerID>A006</SellerID>
<ResponseBody>
<CountryCode>USA</CountryCode>
<SubcategoryList>
<Subcategory>
<IndustryCode>AP</IndustryCode>
<IndustryName>Apparel</IndustryName>
<SubcategoryID>1508</SubcategoryID>
<SubcategoryName> <![CDATA[Belts & Suspenders]]></SubcategoryName>
<Enabled>1</Enabled>
</Subcategory>
<Subcategory>
<IndustryCode>AP</IndustryCode>
<IndustryName>Apparel</IndustryName>
<SubcategoryID>153</SubcategoryID>
<SubcategoryName> <![CDATA[Buckles]]></SubcategoryName>
<Enabled>0</Enabled>
</Subcategory>
</SubcategoryList>
</ResponseBody>
</NeweggAPIResponse>
452
Example: Json, Response
{
"IsSuccess": "true",
"OperationType": "GetSellerSubcategoryResponse",
"SellerID": "A006",
"ResponseBody": {
CountryCode”:”USA”,
"SubcategoryList":[
{
"IndustryCode": "AP",
"IndustryName": "Apparel",
"SubcategoryID": "1508",
"SubcategoryName": "Belts & Suspenders",
"Enabled": "1"
},
{
"IndustryCode": "AP",
"IndustryName": "Apparel",
"SubcategoryID": "153",
"SubcategoryName": "Buckles",
"Enabled": "0"
}
]
}
}
15.3.4. Request Failure Errors
For common HTTP error responses, please refer to Common Error Responses
Error Code
Description
DF008
Invalid industry code [{0}].
Example: XML, Response
<?xml version="1.0" encoding="utf-8"?>
<Errors>
<Error>
453
<Code>DF008</Code>
<Message>Invalid industry code ABC</Message>
</Error>
</Errors>
Example: Json, Response
{
"Code": "DF008",
"Message": "Invalid industry code ABC"
}
15.4. Download Feed Schema
Download the schema of specified feed type. You can download schema files for Item Creation, Inventory Update or
Order Shipping.
15.4.1. Resource URL & Information
Resource URL
https://api.newegg.com/marketplace/sellermgmt/seller/feedschema?sellerid={sellerid}
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
Resource Information
HTTP Method
Authentication?
Request Formats
Response Formats
Rate Limited?
PUT
Required
XML, Json
XML, Json
10 per min per client
15.4.2. Request Body
Attribute
Required?
Format
Description
N
e
w
e
g
g
A
P
I
R
e
q
u
e
s
t
OperationType
Yes
String
Fixed value: GetFeedSchemaRequest
454
RequestBody
GetFeedSchema
FeedType
Yes
Integer
The feed schema type which you want to download from
our system.
Current only support the following:
1:ITEM_DATA The schema for batch create item / update
item / update and/or append image to item(s).
2: ORDER_SHIP_NOTICE_DATA The schema for batch
ship order.
4: ITEM_BATCH_UPDATE The schema for batch item
update. The schema for batch updating the basic
information for items under multiple subcategories at a
time. This template can only be used to update
common fields: (i.e. “Website Short Title”, “Product
Description”, “Item Images”, etc.)
5: MULTICHANNEL_ORDER_DATA The schema for
batch create multi-channel order.
6: ITEM_DATA_UPCMATCH A simplified version of
item creation. This can be used to create items that exist
on Newegg.com.
7: ITEM_PROMOTION_DATA The schema for batch
create item promotion requests.
8: VOLUME_DISCOUNT_DATA The schema for batch
create/update/delete volume discount.
9: INVENTORY_DATA - Through this type you can batch
update inventory.
10: PRICE_DATA - Through this type you can batch update
price.
11: ITEM_PREMIER_MARK_DATA The schema for batch
add/remove item for Newegg Premier Program
IndustryCode
Yes if
FeedType=ITEM_DATA
String
The industry code which the ITEM_DATA schema
belongs to.
You can get the industry code through GET Industry List
function.
Example: XML, Request
XSD
455
API Schema > SellerMgmt > GetSchema > GetSchemaRequest.xsd
PUT https://api.newegg.com/marketplace/sellermgmt/seller/feedschema?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/octet-stream
<NeweggAPIRequest>
<OperationType>GetFeedSchemaRequest</OperationType>
<RequestBody>
<GetFeedSchema>
<FeedType>1</FeedType>
<IndustryCode>BA</IndustryCode>
</GetFeedSchema>
</RequestBody>
</NeweggAPIRequest>
Example: Json, Request
PUT https://api.newegg.com/marketplace/sellermgmt/seller/feedschema?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/octet-stream
{
"OperationType": "GetFeedSchemaRequest",
"RequestBody": {
"GetFeedSchema": {
"FeedType": "1",
"IndustryCode": "BA"
}
}
}
15.4.3. Response Body
456
Newegg compressed schema file(s) before returning it as a Base64-encoded string. To obtain this package, you must decode the
Base64-encoded string, save it as binary file with a “.zip” extension, and then exact the schema files from the zip file.
15.4.4. Request Failure Errors
For common HTTP error responses, please refer to Common Error Responses
Error Code
Description
DF008
Invalid industry code [{0}].
Example: XML, Response
<?xml version="1.0" encoding="utf-8"?>
<Errors>
<Error>
<Code>DF008</Code>
<Message>Invalid industry code ABC</Message>
</Error>
</Errors>
Example: Json, Response
{
"Code": "DF008",
"Message": "Invalid industry code ABC"
}
15.5. Get Subcategory Properties
Get the subcategory properties for the specified subcategory.
15.5.1. Resource URL & Information
Resource URL
https://api.newegg.com/marketplace/sellermgmt/seller/subcategoryproperty?sellerid={sellerid}
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
457
sellerId
Yes
Your seller ID on Newegg Marketplace
Resource Information
HTTP Method
Authentication?
Request Formats
Response Formats
Rate Limited?
PUT
Required
XML, Json
XML, Json
1000 per min per client
15.5.2. Request Body
Attribute
Required?
Format
Description
NeweggAPIRequest
OperationType
Yes
String
Fixed value: GetSellerSubcategoryPropertyRequest
RequestBody
SubcategoryID
Yes
Integer
Subcategory ID.
Example: XML, Request
XSD
API Schema > SellerMgmt > GetSubcategoryProperties > GetSubcatetoryPropertiesRequest.xsd
PUT https://api.newegg.com/marketplace/sellermgmt/seller/subcategoryproperty?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggAPIRequest>
<OperationType>GetSellerSubcategoryPropertyRequest</OperationType>
<RequestBody>
<SubcategoryID>1045</SubcategoryID>
</RequestBody>
</NeweggAPIRequest>
Example: Json, Request
PUT https://api.newegg.com/marketplace/sellermgmt/seller/subcategoryproperty?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
458
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"OperationType": "GetSellerSubcategoryPropertyRequest",
"RequestBody": { "SubcategoryID": "1045" }
}
15.5.3. Response Body
Attribute
Format
Description
NeweggAPIResponse
IsSuccess
String
Used to identify the operation of Get feed status is
successful
True or False
OperationType
String
Fixed value: GetSellerSubcategoryPropertyResponse
SellerID
String
Your seller ID
ResponseBody
SubcategoryPropertyList
SubcategoryProperty
SubcategoryID
Integer
The subcategory ID
SubcategoryName
String
The subcategory name
PropertyName
String
The property name
IsAdvancedSearch
Integer
Will this property be showing up in the advance search
navigation?
Available values:
0: No
1: Yes
IsGroupBy
Integer
Is this a group by property?
Available values:
0: No
1: Yes
IsRequired
Integer
Is this a required property?
Available values:
0: No
1: Yes
Example: XML, Response
XSD
API Schema > SellerMgmt > GetSubcategoryProperties > GetSubcatetoryPropertiesResponse.xsd
459
<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<OperationType>GetSellerSubcategoryPropertyResponse</OperationType>
<SellerID>A006</SellerID>
<ResponseBody>
<SubcategoryPropertyList>
<SubcategoryProperty>
<SubcategoryID>1045</SubcategoryID>
<SubcategoryName><![CDATA[Costumes]]></SubcategoryName>
<PropertyName><![CDATA[Costume_Brand]]></PropertyName>
<IsAdvancedSearch>0</IsAdvancedSearch>
<IsGroupBy>0</IsGroupBy>
<IsRequired>0</IsRequired>
</SubcategoryProperty>
<SubcategoryProperty>
<SubcategoryID>1045</SubcategoryID>
<SubcategoryName><![CDATA[Costumes]]></SubcategoryName>
<PropertyName><![CDATA[Costume_Model]]></PropertyName>
<IsAdvancedSearch>1</IsAdvancedSearch>
<IsGroupBy>1</IsGroupBy>
<IsRequired>1</IsRequired>
</SubcategoryProperty>
</SubcategoryPropertyList>
</ResponseBody>
</NeweggAPIResponse>
Example: Json, Response
{
"IsSuccess": "true",
"OperationType": "GetSellerSubcategoryPropertyResponse",
"SellerID": "A006",
"ResponseBody": {
"SubcategoryPropertyList": [
{
460
"SubcategoryID": "1045",
"SubcategoryName": "Costumes",
"PropertyName": "Costume_Brand",
"IsAdvancedSearch": "0",
"IsGroupBy": "0",
"IsRequired": "0"
},
{
"SubcategoryID": "1045",
"SubcategoryName": "Costumes",
"PropertyName": "Costume_Model",
"IsAdvancedSearch": "1",
"IsGroupBy": "1",
"IsRequired": "1",
}
]
}
}
15.5.4. Request Failure Errors
For common HTTP error responses, please refer to Common Error Responses
Error Code
Description
DF009
Invalid subcategory ID [{0}].
Example: XML, Response
<?xml version="1.0" encoding="utf-8"?>
<Errors>
<Error>
<Code>DF009</Code>
<Message>Invalid subcategory ID ABC</Message>
</Error>
</Errors>
Example: Json, Response
{
461
"Code": "DF009",
"Message": "Invalid subcategory ID ABC"
}
15.6. Get Subcategory Property Values
Get the subcategory property value for the specified property.
15.6.1. Resource URL & Information
Resource URL
https://api.newegg.com/marketplace/sellermgmt/seller/propertyvalue?sellerid={sellerid}
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
Resource Information
HTTP Method
Authentication?
Request Formats
Response Formats
Rate Limited?
PUT
Required
XML, Json
XML, Json
1000 per min per client
15.6.2. Request Body
Attribute
Required?
Format
Description
N
e
w
e
g
g
A
P
I
R
e
q
u
e
s
t
OperationType
Yes
String
Fixed value: GetSellerPropertyValueRequest
462
RequestBody
SubcategoryID
No
Integer
Subcategory ID.
If left blank, returns the property information for all applied
subcategories.
PropertyName
Yes
String
Property Name.
Example: XML, Request
XSD
API Schema > SellerMgmt > GetSubcategoryPropertyValue > GetSubcategoryPropertyValueRequest.xsd
PUT https://api.newegg.com/marketplace/sellermgmt/seller/propertyvalue?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggAPIRequest>
<OperationType>GetSellerPropertyValueRequest</OperationType>
<RequestBody>
<SubcategoryID>1045</SubcategoryID>
<PropertyName>Costume_Gender</PropertyName>
</RequestBody>
</NeweggAPIRequest>
Example: Json, Request
PUT https://api.newegg.com/marketplace/sellermgmt/seller/propertyvalue?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"OperationType": "GetSellerPropertyValueRequest",
"RequestBody": {
"SubcategoryID": "1045",
"PropertyName": "Costume_Gender"
463
}
}
15.6.3. Response Body
Attribute
Format
Description
NeweggAPIResponse
IsSuccess
String
Used to identify the operation of Get feed status is
successful
True or False
OperationType
String
Fixed value: GetSellerPropertyValueResponse
SellerID
String
Your seller ID
ResponseBody
PropertyInfoList
PropertyInfo
SubcategoryID
Integer
Subcategory ID
SubcategoryName
String
Subcategory name
PropertyName
String
The property name
IsAdvancedSearch
Integer
Will this property be showing up in the advance search
navigation?
Available values:
0: No
1: Yes
IsGroupBy
Integer
Is this a group by property?
Available values:
0: No
1: Yes
IsRequired
Integer
Is this a required property?
Available values:
0: No
1: Yes
PropertyValueList
PropertyValue
String
Property value name
Example: XML, Response
XSD
API Schema > SellerMgmt > GetSubcategoryPropertyValue > GetSubcategoryPropertyValueResponse.xsd
464
<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<OperationType>GetSellerPropertyValueResponse</OperationType>
<SellerID>A006</SellerID>
<ResponseBody>
<PropertyInfoList>
<PropertyInfo>
<SubcategoryID>1045</SubcategoryID>
<SubcategoryName><![CDATA[Costume]]></SubcategoryName>
<PropertyName><![CDATA[Costume_Gender]]></PropertyName>
<IsAdvancedSearch>1</IsAdvancedSearch>
<IsGroupBy>0</IsGroupBy>
<IsRequired>0</IsRequired>
<PropertyValueList>
<PropertyValue><![CDATA[Male]]></PropertyValue>
</PropertyValueList>
</PropertyInfo>
<PropertyInfo>
<SubcategoryID>1045</SubcategoryID>
<SubcategoryName><![CDATA[Costume]]></SubcategoryName>
<PropertyName><![CDATA[Costume_Gender]]></PropertyName>
<IsAdvancedSearch>1</IsAdvancedSearch>
<IsGroupBy>0</IsGroupBy>
<IsRequired>0</IsRequired>
<PropertyValueList>
<PropertyValue><![CDATA[Female]]></PropertyValue>
</PropertyValueList>
</PropertyInfo>
<PropertyInfo>
<SubcategoryID>1045</SubcategoryID>
<SubcategoryName><![CDATA[Costume]]></SubcategoryName>
<PropertyName><![CDATA[Costume_Gender]]></PropertyName>
<IsAdvancedSearch>1</IsAdvancedSearch>
<IsGroupBy>0</IsGroupBy>
<IsRequired>0</IsRequired>
<PropertyValueList>
<PropertyValue><![CDATA[Unisex]]></PropertyValue>
</PropertyValueList>
</PropertyInfo>
465
</PropertyInfoList>
</ResponseBody>
</NeweggAPIResponse>
Example: Json, Response
{
"IsSuccess": "true",
"OperationType": "GetSellerPropertyValueResponse",
"SellerID": "A006",
"ResponseBody": {
"PropertyInfoList": [
{
"SubcategoryID": "1045",
"SubcategoryName": "Costume",
"PropertyName": "Costume_Gender",
"IsAdvancedSearch": "1",
"IsGroupBy": "0",
"IsRequired": "0",
"PropertyValueList": [ "Male" ]
},
{
"SubcategoryID": "1045",
"SubcategoryName": "Costume",
"PropertyName": "Costume_Gender",
"IsAdvancedSearch": "1",
"IsGroupBy": "0",
"IsRequired": "0",
"PropertyValueList": [ "Female" ]
},
{
"SubcategoryID": "1045",
"SubcategoryName": "Costume",
"PropertyName": "Costume_Gender",
"IsAdvancedSearch": "1",
"IsGroupBy": "0",
"IsRequired": "0",
"PropertyValueList": [ "Unisex" ]
}
]
}
466
}
15.6.4. Request Failure Errors
For common HTTP error responses, please refer to Common Error Responses
15.7. Seller Status Check
Get the seller account status.
15.7.1. Resource URL & Information
Resource URL
https://api.newegg.com/marketplace/sellermgmt/seller/accountstatus?sellerid={sellerid}&version={versionno}
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
version
Yes
Available version numbers:
307
Resource Information
HTTP Method
Authentication?
Request Formats
Response Formats
Rate Limited?
GET
Required
XML, Json
XML, Json
1000 per min per client
15.7.2. Request Body
Example: XML, Request
GET https://api.newegg.com/marketplace/sellermgmt/seller/accountstatus?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
467
Accept: application/xml
Example: Json, Request
GET https://api.newegg.com/marketplace/sellermgmt/seller/accountstatus?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
15.7.3. Response Body
Attribute
Format
Description
NeweggAPIResponse
IsSuccess
String
Used to identify the operation of Get feed status is successful
True or False
OperationType
String
Fixed value: GetSellerAccountStatusResponse
SellerID
String
Your seller ID
ResponseBody
SellerName
String
The seller’s name
Status
String
The seller account’s status
Available values:
Active
Suspended
InActive
Terminated
Closed
Membership
Integer
Membership level code:
0: Standard
1: Professional
2: Enterprise
468
FufillmentCenterList
FufillmentCenter
WarehouseLocation
String
The ISO standard 3-digit codes of the country where your
warehouse is located. Please download the following to review
details:
http://promotions.newegg.com/marketplace/sellers/resourceLibrar
y/International%20Country%20Guide.pdf
WarehouseType
Integer
The order type what the warehouse will ship for:
0: SBS(Ship by seller)
1: SBN(Ship by Newegg)
ShippingDestinationLis
ShipToCountry
String
The target country where the fulfillment center will ship the order
to. Only the ISO standard 3-digit codes are accepted.
To review the complete list of available values, please download the
following:
https://promotions.newegg.com/Marketplace/Sellers/resourceLibr
ary/International%20Country%20Guide.pdf
Example: XML, Response
XSD
API Schema > SellerMgmt > SellerStatusCheck > GetSellerAccountStatusResponse.xsd
<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<OperationType>GetSellerAccountStatusResponse</OperationType>
<SellerID>A006</SellerID>
<ResponseBody>
<SellerName><![CDATA[Test_MKTPLS]]></SellerName>
<Status>Active</Status>
<Membership>0</Membership>
<FufillmentCenterList>
<FufillmentCenter>
<WarehouseLocation>TUR</WarehouseLocation>
<WarehouseType>0</WarehouseType>
<ShippingDestinationList>
<ShipToCountry>TUR</ShipToCountry>
<ShipToCountry>USA</ShipToCountry>
</ShippingDestinationList>
</FufillmentCenter>
<FufillmentCenter>
469
<WarehouseLocation>USA</WarehouseLocation>
<WarehouseType>0</WarehouseType>
<ShippingDestinationList>
<ShipToCountry>USA</ShipToCountry>
<ShipToCountry>NZL</ShipToCountry>
</ShippingDestinationList>
</FufillmentCenter>
<FufillmentCenter>
<WarehouseLocation>USA</WarehouseLocation>
<WarehouseType>1</WarehouseType>
<ShippingDestinationList>
<ShipToCountry>AUS</ShipToCountry>
<ShipToCountry>USA</ShipToCountry>
<ShipToCountry>SGP</ShipToCountry>
</ShippingDestinationList>
</FufillmentCenter>
</FufillmentCenterList>
</ResponseBody>
</NeweggAPIResponse>
Example: Json, Response
{
"IsSuccess": true,
"OperationType": "GetSellerAccountStatusResponse",
"SellerID": "A006",
"ResponseBody": {
"Membership": 0,
"FufillmentCenterList": [
{
"WarehouseLocation": "TUR",
"WarehouseType": 0,
"ShippingDestinationList": [
"TUR",
"USA"
]
},
{
"WarehouseLocation": "USA",
"WarehouseType": 0,
"ShippingDestinationList": [
470
"USA",
"NZL"
]
},
{
"WarehouseLocation": "USA",
"WarehouseType": 1,
"ShippingDestinationList": [
"AUS",
"USA",
"SGP"
]
}
],
"SellerName": "Test_MKTPLS",
"Status": "Active"
}
}
15.7.4. Request Failure Errors
For common HTTP error responses, please refer to Common Error Responses
16. SBN (Shipped by Newegg) Management
The SBN (Shipped by Newegg) Management service group is designed to help you send your inventory to one of Neweggs
warehouse. Once your inventory is in a Neweggs warehouse, you will be able to sell your items on Newegg, or you can sell the
products on different channels then use Shipped by Newegg to ship your orders.
16.1. Get Inbound Shipment Plan Suggestion
Create an inbound shipment plan suggestion to identify the shipments of the items that you want to send to Newegg
warehouse. By submitting the inbound shipment plan suggestion request, Newegg will provide the appropriate ship
arrangement based on Newegg’s business intelligence. This will make your items allocation more reasonable and
competitive.
471
16.1.1. Resource URL & Information
Resource URL
https://api.newegg.com/marketplace/sbnmgmt/inboundshipment/plansuggestion?sellerid={sellerid}
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
Resource Information
HTTP Method
Authentication?
Request Formats
Response Formats
Rate Limited?
PUT
Required
XML, Json
XML, Json
1000 per min per client
16.1.2. Request Body
Attribute
Required?
Format
Description
NeweggAPIRequest
OperationType
Yes
String
Fixed value: GetPlanSuggestionRequest
RequestBody
PlanSuggestion
ItemList
Item
SellerPartNumber
Yes
String
Seller part number.
PlannedQuantity
Yes
Integer
The total quantity of the specified item you want to send
to Newegg’s warehouse.
QuantityPerCarton
No
Integer
The carton capacity for this item.
If fill this element, we will return the suggested number
of cartons for you reference.
Example: XML, Request
XSD
API Schema > SBNMgmt > GetInboundShipmentPlan > GetInboundShipmentPlanRequest.xsd
PUT https://api.newegg.com/marketplace/sbnmgmt/inboundshipment/plansuggestion?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
472
<NeweggAPIRequest>
<OperationType>GetPlanSuggestionRequest</OperationType>
<RequestBody>
<PlanSuggestion>
<ItemList>
<Item>
<SellerPartNumber>SS0120130516683100755</SellerPartNumber>
<PlannedQuantity>20</PlannedQuantity>
<QuantityPerCarton>10</QuantityPerCarton>
</Item>
<Item>
<SellerPartNumber>nz-tst-123</SellerPartNumber>
<PlannedQuantity>30</PlannedQuantity>
<QuantityPerCarton>10</QuantityPerCarton>
</Item>
</ItemList>
</PlanSuggestion>
</RequestBody>
</NeweggAPIRequest>
Example: Json, Request
PUT https://api.newegg.com/marketplace/sbnmgmt/inboundshipment/plansuggestion?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"OperationType": "GetPlanSuggestionRequest",
"RequestBody": {
"PlanSuggestion": {
"ItemList": {
"Item": [
{
"SellerPartNumber": "SS0120130516683100755",
"PlannedQuantity": 20,
"QuantityPerCarton": 10
},
{
473
"SellerPartNumber": "nz-tst-123",
"PlannedQuantity": 32,
"QuantityPerCarton": 10
}
]
}
}
}
}
16.1.3. Response Body
Attribute
Format
Description
NeweggAPIResponse
IsSuccess
String
Used to identify the operation of Get feed status is
successful
True or False
OperationType
String
Fixed value: GetPlanSuggestionResponse
SellerID
String
Your seller ID
ResponseBody
ShipmentList
Shipment
ShipToWarehouseCode
String
The code of Newegg’s warehouse
Currently available Newegg warehouse:
06: Tennessee Bulk Warehouse
07: California Small Warehouse
08: California Bulk Item Warehouse
10: New Jersey Bulk Warehouse
14: New Jersey Small Warehouse
ShipToAddress1
String
The ship to address1 of Newegg’s warehouse
ShipToAddress2
String
The ship to address2 of Newegg’s warehouse
ShipToCityName
String
The ship to city name of Newegg’s warehouse
ShipToStateCode
String
The ship to state code of Newegg’s warehouse
ShipToZipCode
String
The zip code of Newegg’s warehouse
ShipToCountryCode
String
The country code of Newegg’s warehouse
ItemList
Item
SellerPartNumber
String
Seller part number
NeweggItemNumber
String
Newegg item number
Quantity
Integer
Suggested item quantity
NumberofCartons
Integer
Total cartons needed
Example: XML, Response
474
XSD
API Schema > SBNMgmt > GetInboundShipmentPlan > GetInboundShipmentPlanResponse.xsd
<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<OperationType>GetPlanSuggestionResponse</OperationType>
<SellerID>A006</SellerID>
<ResponseBody>
<ShipmentList>
<Shipment>
<ShipToWarehouseCode>07</ShipToWarehouseCode>
<ShipToAddress1>17708 Rowland St.</ShipToAddress1>
<ShipToCityName>City of Industry</ShipToCityName>
<ShipToStateCode>CA</ShipToStateCode>
<ShipToZipCode>91748</ShipToZipCode>
<ShipToCountryCode>USA</ShipToCountryCode>
<ItemList>
<Item>
<SellerPartNumber>nz-tst-123</SellerPartNumber>
<NeweggItemNumber>9SIA0060BB9157</NeweggItemNumber>
<Quantity>10</Quantity>
<NumberofCartons>1</NumberofCartons>
</Item>
</ItemList>
</Shipment>
<Shipment>
<ShipToWarehouseCode>12</ShipToWarehouseCode>
<ShipToAddress1>4995 Citation Dr Suite 101,Dock 1-10</ShipToAddress1>
<ShipToCityName>Memphis</ShipToCityName>
<ShipToStateCode>TN</ShipToStateCode>
<ShipToZipCode>38118</ShipToZipCode>
<ShipToCountryCode>USA</ShipToCountryCode>
<ItemList>
<Item>
<SellerPartNumber>SS0120130516683100755</SellerPartNumber>
<NeweggItemNumber>9SIA0060S01359</NeweggItemNumber>
<Quantity>10</Quantity>
<NumberofCartons>1</NumberofCartons>
</Item>
475
<Item>
<SellerPartNumber>nz-tst-123</SellerPartNumber>
<NeweggItemNumber>9SIA0060BB9157</NeweggItemNumber>
<Quantity>10</Quantity>
<NumberofCartons>1</NumberofCartons>
</Item>
</ItemList>
</Shipment>
<Shipment>
<ShipToWarehouseCode>14</ShipToWarehouseCode>
<ShipToAddress1>45 Patrick Ave., Dock 9-17</ShipToAddress1>
<ShipToCityName>Edison</ShipToCityName>
<ShipToStateCode>NJ</ShipToStateCode>
<ShipToZipCode>08837</ShipToZipCode>
<ShipToCountryCode>USA</ShipToCountryCode>
<ItemList>
<Item>
<SellerPartNumber>SS0120130516683100755</SellerPartNumber>
<NeweggItemNumber>9SIA0060S01359</NeweggItemNumber>
<Quantity>10</Quantity>
<NumberofCartons>1</NumberofCartons>
</Item>
<Item>
<SellerPartNumber>nz-tst-123</SellerPartNumber>
<NeweggItemNumber>9SIA0060BB9157</NeweggItemNumber>
<Quantity>10</Quantity>
<NumberofCartons>1</NumberofCartons>
</Item>
</ItemList>
</Shipment>
</ShipmentList>
</ResponseBody>
</NeweggAPIResponse>
Example: Json, Response
{
"IsSuccess": true,
"OperationType": "GetPlanSuggestionResponse",
"SellerID": "A006",
"ResponseBody": {
476
"ShipmentList": [
{
"ShipToWarehouseCode": "07",
"ShipToAddress1": "17708 Rowland St.",
"ShipToCityName": "City of Industry",
"ShipToStateCode": "CA",
"ShipToZipCode": "91748",
"ShipToCountryCode": "USA",
"ItemList": [
{
"SellerPartNumber": "SS0120130516683100755",
"NeweggItemNumber": "9SIA0060S01359",
"Quantity": 0,
"NumberofCartons": 0
},
{
"SellerPartNumber": "nz-tst-123",
"NeweggItemNumber": "9SIA0060BB9157",
"Quantity": 13
}
]
},
{
"ShipToWarehouseCode": "12",
"ShipToAddress1": "4995 Citation Dr Suite 101,Dock 1-10",
"ShipToCityName": "Memphis",
"ShipToStateCode": "TN",
"ShipToZipCode": "38118",
"ShipToCountryCode": "USA",
"ItemList": [
{
"SellerPartNumber": "SS0120130516683100755",
"NeweggItemNumber": "9SIA0060S01359",
"Quantity": 10,
"NumberofCartons": 1
},
{
"SellerPartNumber": "nz-tst-123",
"NeweggItemNumber": "9SIA0060BB9157",
"Quantity": 11
}
477
]
},
{
"ShipToWarehouseCode": "14",
"ShipToAddress1": "45 Patrick Ave., Dock 9-17",
"ShipToCityName": "Edison",
"ShipToStateCode": "NJ",
"ShipToZipCode": "08837",
"ShipToCountryCode": "USA",
"ItemList": [
{
"SellerPartNumber": "SS0120130516683100755",
"NeweggItemNumber": "9SIA0060S01359",
"Quantity": 10,
"NumberofCartons": 1
},
{
"SellerPartNumber": "nz-tst-123",
"NeweggItemNumber": "9SIA0060BB9157",
"Quantity": 8
}
]
}
]
}
}
16.1.4. Request Failure Errors
For common HTTP error responses, please refer to Common Error Responses
Error Code
Description
SBN002
Invalid Seller Part # :{sellerpart#}.
SBN003
Seller Part # :{sellerpart#} is marked as Shipped by Seller now, please convert this item to Shipped by Newegg
and try again.
Example: XML, Response
<?xml version="1.0" encoding="utf-8"?>
<Errors>
<Error>
478
<Code>DF008</Code>
<Message>Invalid industry code ABC</Message>
</Error>
</Errors>
Example: Json, Response
{
"Code": "DF008",
"Message": "Invalid industry code ABC"
}
16.2. Submit Inbound Shipment Request
Submit a request to Newegg for:
- Creating a new inbound shipment based on the information that was returned by the Get Inbound Shipment Plan
Suggestion.
- Updating existing shipment based on assigned Shipment ID.
16.2.1. Resource URL & Information
Resource URL
https://api.newegg.com/marketplace/sbnmgmt/inboundshipment/shipmentrequest?sellerid={sellerid}
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
Resource Information
HTTP Method
Authentication?
Request Formats
Response Formats
Rate Limited?
POST
Required
XML, Json
XML, Json
100 per min per client
16.2.2. Request Body
Create Inbound Shipment
479
Attribute
Required?
Format
Description
NeweggAPIRequest
OperationType
Yes
String
The value is fixed, will always be
SubmitShipmentRequest
RequestBody
Shipment
ActionCode
Yes
Integer
Action code:
1.Create
ShipFromAddress1
No
String
Ship from address1.
If left blank, will use seller’s primary address.
ShipFromAddress2
No
String
Ship from address2
If left blank, will use seller’s primary address.
ShipFromCity
No
String
Ship from city.
If left blank, will use seller’s primary address.
ShipFromState
No
String
Ship from state
If left blank, will use seller’s primary address.
ShipFromZipcode
No
String
Ship from zip code
If left blank, will use seller’s primary address.
ShipFromCountry
No
String
Ship from country code
If left blank, will use seller’s primary address.
ShipFromPhoneNumber
No
String
Ship from location contact phone number
ShipToWarehouseCode
Yes
String
Which Newegg warehouse you want to ship to.
Currently available Newegg warehouse:
06: Tennessee Bulk Warehouse
07: California Small Warehouse
08: California Bulk Item Warehouse
10: New Jersey Bulk Warehouse
14: New Jersey Small Warehouse
480
ShippingMethodCode
Yes
Integer
Which shipping method you will be using for this
shipment?
Available values:
1: Small Parcel Delivery(Individual boxes: consist of units
packed in individual boxes and individually labeled for
delivery)
2: Less Than Truckload(LTL, Pallets, Shipment at least
150 lbs:shipment combines individual boxes on pallets
for delivery)
ShippingCarrierCode
Yes
Integer
Which shipping carrier you will be using for this
shipment?
If ShippingMethodCode = 1:
101: DHL
102: FedEx
103: UPS
104: USPS
105: Newegg Partnered Carrier(UPS). For more
information, please refer to section 15.2.5: Newegg
Partnered Carrier- UPS.
99: Other
If ShippingMethodCode = 2, the only acceptable value is:
99. Other
OtherCarrierName
Yes if =
ShippingCa
rrierCode =
99
String
Provide the shipping carrier name you will be using if
ShippingCarrierCode = 99.
PackageList
Package
TrackingNumber
No
String
Tracking number in this shipment
PackageWeight
Yes if
ShippingCa
rrierCode =
105
Decimal
Package weigh
See Shipments Weight and Size Limitations for more
details.
PackageLength
Yes if
ShippingCa
rrierCode =
105
Decimal
Package length
See Shipments Weight and Size Limitations for more
details.
481
PackageHeight
Yes if
ShippingCa
rrierCode =
105
Decimal
Package height
See Shipments Weight and Size Limitations for more
details.
PackageWidth
Yes if
ShippingCa
rrierCode =
105
Decimal
Package width
See Shipments Weight and Size Limitations for more
details.
ItemList
Item
sellerPartNumber
Yes
String
Seller part number.
Quantity
Yes
Integer
Item quantity
NumberofPackage
No
Integer
Number of package labels.
If left blank, will return 1 package label.
ORM-D
No
Integer
1: Yes
0: No
If left blank, will treat it as 0.
ORM-D is a marking for mail or shipping in the United
States that identifies other regulated materials for
domestic transport only. Packages bearing this mark
contain hazardous material in a limited quantity that
presents a limited hazard during transportation, due to
its form, quantity, and packaging.
Please select ORM-D checkbox if applicable.
A material safety data sheet must be uploaded for ORM-
D items.
Examples of ORM-D items:
- Aerosol cans
- Automotive batteries
- Perfumes
- Small arms ammunition
- Gunpowder (black powder)
- Some photographic chemicals
- Lighters
- Beer
- Drain openers
482
MSDSURL
Yes if
ORM-d = 1
String
Please specify the local path where the Material Safety
Data Sheet file located.
Enter the URL for this products Material Safety Data
Sheet File. All URLs must be a direct link to the actual
file. File must be (pdf, jpg, jpeg, png, doc,docx, xls or xlsx).
An alphanumeric string; 2000 characters maximum in
length.
The maximum file size is 10MB. All files larger than the
10MB limit will fail to process.
Example: XML, Request
XSD
API Schema > SBNMgmt > SubmitInboundShipment > SubmitInboundShipmentRequest_Create.xsd
PUT
https://api.newegg.com/marketplace/sbnmgmt/inboundshipment/shipmentrequest?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggAPIRequest>
<OperationType>SubmitShipmentRequest</OperationType>
<RequestBody>
<Shipment>
<ActionCode>1</ActionCode>
<ShipFromPhoneNumber>123456789</ShipFromPhoneNumber>
<ShipToWarehouseCode>08</ShipToWarehouseCode>
<ShippingMethodCode>1</ShippingMethodCode>
<ShippingCarrierCode>99</ShippingCarrierCode>
<OtherCarrierName>newegg</OtherCarrierName>
<PackageList>
<Package>
<TrackingNumber>SBNAPI-123456789</TrackingNumber>
<PackageWeight>10.00</PackageWeight>
<PackageLength>8.00</PackageLength>
<PackageHeight>7.00</PackageHeight>
<PackageWidth>7.00</PackageWidth>
</Package>
483
</PackageList>
<ItemList>
<Item>
<SellerPartNumber>SS0120130516683100755</SellerPartNumber>
<Quantity>4</Quantity>
<NumberofPackage>2</NumberofPackage>
<ORM-D>1</ORM-D>
<MSDSURL>http://tesipaddress/MSDS/testMSDS.pdf</MSDSURL>
</Item>
</ItemList>
</Shipment>
</RequestBody>
</NeweggAPIRequest>
Example: Json, Request
PUT
https://api.newegg.com/marketplace/sbnmgmt/inboundshipment/shipmentrequest?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"OperationType": "SubmitShipmentRequest",
"RequestBody": {
"Shipment": {
"ActionCode": 1,
"ShipFromPhoneNumber": "123456789",
"ShipFromAddress1": "11708 Rowland St.",
"ShipFromAddress2": "12708 Rowland St.",
"ShipFromCity": "NY",
"ShipFromState": "CA",
"ShipFromZipcode": "123456",
"ShipFromCountry": "USA",
"ShipToWarehouseCode": "14",
"ShippingMethodCode": 1,
"ShippingCarrierCode": 105,
"OtherCarrierName": "SF",
"PackageList": {
"Package": [
{
484
"TrackingNumber": "123456789",
"PackageWeight": 10,
"PackageLength": 8,
"PackageHeight": 7,
"PackageWidth": 6
},
{
"TrackingNumber": "987654321",
"PackageWeight": 10,
"PackageLength": 8,
"PackageHeight": 7,
"PackageWidth": 6
}
]
},
"ItemList": {
"Item": [
{
"SellerPartNumber": "SS0120130516683100755",
"Quantity": 40,
"NumberofPackage": 2,
“ORM-D”:1,
“MSDSURL”:”http://tesipaddress/MSDS/testMSDS.pdf”
}
]
}
}
}
}
Void Inbound Shipment
Attribute
Required?
Format
Description
NeweggAPIRequest
OperationType
Yes
String
The value is fixed, will always be
SubmitShipmentRequest
RequestBody
Shipment
ShipmentID
Yes
String
Existing shipment ID.
ActionCode
Yes
Integer
Action code:
2.Void
485
Example: XML, Request
XSD
API Schema > SBNMgmt > SubmitInboundShipment > SubmitInboundShipmentRequest_Void.xsd
PUT
https://api.newegg.com/marketplace/sbnmgmt/inboundshipment/shipmentrequest?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggAPIRequest>
<OperationType>SubmitShipmentRequest</OperationType>
<RequestBody>
<Shipment>
<ActionCode>2</ActionCode>
<ShipmentID>2771551</ShipmentID>
</Shipment>
</RequestBody>
</NeweggAPIRequest>
Example: Json, Request
{
"OperationType": "SubmitShipmentRequest",
"RequestBody": {
"Shipment": {
"ActionCode": 2,
"ShipmentID": 2771551
}
}
}
16.2.3. Response Body
Attribute
Format
Description
New
egg
APIR
espo
nse
IsSuccess
String
Used to identify the operation of Get feed status is successful
True or False
486
OperationType
String
Fixed value: SubmitShipmentResponse
SellerID
String
Your seller ID
ResponseBody
RequestID
String
The Identifier of a submission
RequestDate
String
Request date.
RequestStatus
String
The status of the request submission.
SUBMITTED
Example: XML, Response
XSD
API Schema > SBNMgmt > SubmitInboundShipment > SubmitInboundShipmentResponse.xsd
<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<OperationType>SubmitShipmentResponse</OperationType>
<SellerID>A006</SellerID>
<ResponseBody>
<RequestID>2PQCX3SPZ3QBF</RequestID>
<RequestDate>06/06/2013 10:21:00</RequestDate>
<RequestStatus>SUBMITTED</RequestStatus>
</ResponseBody>
</NeweggAPIResponse>
Example: Json, Response
{
"IsSuccess": true,
"OperationType": "SubmitShipmentResponse",
"SellerID": "A006",
"ResponseBody": {
"RequestID": "Z2OTIV1AVVBJ",
"RequestDate": "07/11/2013 17:24:46",
"RequestStatus": "SUBMITTED"
}
}
16.2.4. Request Failure Errors
487
For common HTTP error responses, please refer to Common Error Responses
Error Code
Description
SBN001
Delivery to the Newegg warehouse: {ShipToWarehouseCode} of Seller Part # {SellerPart#} is not available. Please
submit a Get Inbound Shipment Plan request to receive the information of available option(s).
SBN002
Invalid Seller Part # :{sellerpart#}.
SBN003
Seller Part # :{sellerpart#} is marked as Shipped by Seller now, please convert this item to Shipped by Newegg
and try again.
SBN004
Invalid Shipment ID:{ShipmentID}
SBN005
Cannot void Shipment: [ShipmentID]. Shipment using Newegg Partnered Carrier service cannot be void 48 hours
after pre-paid shipping label created.
SBN006
Cannot void Shipment: [ShipmentID]. Shipment cannot be void because it is marked as [Received or Partially
Received or Manually closed or Voided]
SBN007
The field: [PackageWeight or PackageLength or PackageHeight or PackageWidth ] is required when using Newegg
Partnered Carrier service (ShippingCarrierCode:105). For more detail, please review Newegg API Development
Guide, SBN section.
SBN008
The value in the field: PackageWeight cannot exceed 150 lbs. (70 kg) when using Newegg Partnered Carrier service
(ShippingCarrierCode:105). For more detail, please review Newegg API Development Guide, SBN section.
SBN009
The value in the field: PackageLength cannot exceed 108 inches (270 cm) when using Newegg Partnered Carrier
service (ShippingCarrierCode:105). For more detail, please review Newegg API Development Guide, SBN section.
SBN010
Package size cannot exceed 165 inches (419 cm) in (Package Length + 2x Package Width + 2x Package Height) when
using Newegg Partnered Carrier service (ShippingCarrierCode:105). For more detail, please review Newegg API
Development Guide, SBN section.
SBN011
The field: OtherCarrierName is required when Shipping Carrier is Other (ShippingCarrierCode: 99). For more detail,
please review Newegg API Development Guide, SBN section.
SBN012
The value in the field of ShippingCarrier can only be Other (ShippingCarrierCode: 99) when the
ShippingMethodCode= 2. For more detail, please review Newegg API Development Guide, SBN section.
SBN013
Newegg Partnered Carrier service (ShippingCarrierCode: 105) is not available for international sellers.
SBN014
Package Dimension Weight cannot exceed 150 lbs.(70kg) in (Package Length x Package Width x Package Height/166)
when using Newegg Partnered Carrier service (ShippingCarrierCode:105). For more detail, please review Newegg
API Development Guide, SBN section.
SBN015
The field:[MSDSURL] is required when ORM-D = 1. For more detail, please contact datafeeds@newegg.com.
Example: XML, Response
<?xml version="1.0" encoding="utf-8"?>
<Errors>
<Error>
<Code>DF008</Code>
<Message>Invalid industry code ABC</Message>
</Error>
488
</Errors>
Example: Json, Response
{
"Code": "DF008",
"Message": "Invalid industry code ABC"
}
16.2.5. Newegg Partnered Carrier- UPS
Newegg partnered carriers offer deeply discounted rates, and the cost is billed to your account as an “SBN Inbound Fee”.
We will provide a shipping label that you can print and use with our partnered carriers. The rates apply to shipments
originating from the continental 50 U.S. states only (does not include Puerto Rico or APO/FPO addressed).
Please note this service is currently not available for International Sellers.
Shipment Measurement Guidelines
- Shipments Weight and Size Limitations.*
Packages can be up to 150 lbs. (70 kg).
Packages can be up to 165 inches (419 cm) in (Length + 2x Width + 2x Height).
Packages can be up to 108 inches (270 cm) in Length.
*Packages with a large size-to-weight ratio require special pricing and dimensional weight calculations.
Example: A box measuring 34" x 34" x 34" exceeds the maximum dimensions. The length (34") plus 2x width (2 x 34")
and 2x height (2 x 34") equals 170".
- Large Package
If packages Length plus 2x Width plus 2x Height exceeds 130 inches (330 cm), UPS applies a Large Package Surcharge.
Example: A box measuring 36” x 26” x 26” the length (36”) plus 2x width (2 x 26”) and 2x height (2 x 26”) equals 140”.
UPS will accept the box, but they may apply a Large Package Surcharge.
- Dimensional Weight
If a package's volume is more than 5,184 cubic inches (3 cubic feet), UPS compares the dimensional weight (cubic inches
divided by 166) with the actual weight. If the dimensional weight is greater than actual weight, UPS uses the package's
dimensional weight as the billable weight.
Example: A package measuring 26" x 16" x 16" has a volume of 6,656 cubic inches. The dimensional weight equals 6,656
divided by 166 or 41 lbs. If the package's actual weight is 24 lbs., the dimensional weight may be used for the billable
weight.
- Billable Weight
489
For large packages, UPS determines the billable weight by taking the package dimensions into account. For large packages,
if the dimensional weight is greater than the actual weight, UPS may use the dimensional weight instead of the actual weight.
16.3. Get Inbound Shipment Status Request
Get the status of specified inbound shipment.
16.3.1. Resource URL & Information
Resource URL
https://api.newegg.com/marketplace/sbnmgmt/inboundshipment/shipmentstatus?sellerid={sellerid}
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
Resource Information
HTTP Method
Authentication?
Request Formats
Response Formats
Rate Limited?
PUT
Required
XML, Json
XML, Json
1000 per min per client
16.3.2. Request Body
Attribute
Required?
Format
Description
NeweggAPIRequest
OperationType
Yes
String
The value is fixed, will always be “GetShipmentStatusRequest”
RequestBody
GetRequestStatus
RequestIDList
RequestID
No
String
The Identifier of a submission. Other condition will be ignored if
Request ID has been specified.
ActionCode
No
Integer
Available values for action code:
0: All(Default)
1: Create
2: Void
MaxCount
No
Integer
The maximum return records. Default is 100. If you specified
over than 100, the system still return 100 records.
490
RequestStatus
No
String
The status of the submitted request.
Available values:
ALL (Default)
SUBMITTED
IN_PROGRESS
FINISHED
CANCELLED
RequestDateFrom
No
DateTime
Search by request date range. (Pacific Standard Time)
Please refer to the Acceptable Date Format
RequestDateTo
No
DateTime
Search by request date range. (Pacific Standard Time)
Please refer to the Acceptable Date Format
Example: XML, Request
XSD
API Schema > SBNMgmt > GetInboundShipmentStatus > GetShipmentStatusRequest.xsd
PUT https://api.newegg.com/marketplace/sbnmgmt/inboundshipment/shipmentstatus?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggAPIRequest>
<OperationType>GetShipmentStatusRequest</OperationType>
<RequestBody>
<GetRequestStatus>
<RequestIDList>
<RequestID>22AZLF9YXKT7S</RequestID>
</RequestIDList>
<ActionCode>1</ActionCode>
<MaxCount>100</MaxCount>
<RequestStatus>ALL</RequestStatus>
<RequestDateFrom/>
<RequestDateTo/>
</GetRequestStatus>
</RequestBody>
</NeweggAPIRequest>
Example: Json, Request
491
PUT https://api.newegg.com/marketplace/sbnmgmt/inboundshipment/shipmentstatus?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"OperationType": "GetShipmentStatusRequest",
"RequestBody": {
"GetRequestStatus": {
"RequestIDList": {
"RequestID": [
"22AZLF9YXKT7S"
]
},
"ActionCode": 1,
"MaxCount": 100,
"RequestStatus": "ALL",
"RequestDateFrom": "2013-5-4",
"RequestDateTo": "2013-8-4"
}
}
}
16.3.3. Response Body
Attribute
Format
Description
NeweggAPIResponse
IsSuccess
String
Used to identify the operation of Get feed status is
successful
True or False
OperationType
String
Fixed value: GetShipmentStatusResponse
SellerID
String
Your seller ID
ResponseBody
ResponseList
ResponseInfo
RequestId
String
The Identifier of a submission
ActionCode
Integer
Available values for the action code:
1: Create
2: Void
RequestDate
String
The date when the feed was submitted. (Pacific Standard
Time)
492
RequestStatus
String
Available values for the status of the feed submission.
SUBMITTED
IN_PROGRESS
FINISHED
CANCELLED
Memo
String
Detailed error information
Example: XML, Response
XSD
API Schema > SBNMgmt > GetInboundShipmentStatus > GetShipmentStatusResponse.xsd
<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<SellerID>A006</SellerID>
<OperationType>GetShipmentStatusResponse</OperationType>
<ResponseBody>
<ResponseList>
<ResponseInfo>
<RequestId>22AZLF9YXKT7S</RequestId>
<ActionCode>1</ActionCode>
<RequestDate>07/11/2013 16:39:30</RequestDate>
<RequestStatus>IN_PROGRESS</RequestStatus>
</ResponseInfo>
</ResponseList>
</ResponseBody>
</NeweggAPIResponse>
Example: Json, Response
{
"IsSuccess": true,
"SellerID": A006,
"OperationType": "GetShipmentStatusResponse",
"ResponseBody": {
"ResponseList": [
{
"RequestId": "22AZLF9YXKT7S",
"ActionCode": 1,
493
"RequestDate": "07/11/2013 16:39:30",
"RequestStatus": "IN_PROGRESS"
}
]
}
}
16.3.4. Request Failure Errors
For common HTTP error responses, please refer to Common Error Responses
16.4. Get Inbound Shipment Request Result
Get the processing result of a specified inbound shipment request.
16.4.1. Resource URL & Information
Resource URL
https://api.newegg.com/marketplace/sbnmgmt/inboundshipment/shipmentresult/{requestid}?sellerid={sellerid}
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
{requestid}
Yes
Request ID
Resource Information
HTTP Method
Authentication?
Request Formats
Response Formats
Rate Limited?
GET
Required
XML, Json
XML, Json
100 per min per client
16.4.2. Request Body
Example: XML, Request
GET
https://api.newegg.com/marketplace/sbnmgmt/inboundshipment/shipmentresult/{requestid}?sellerid={s
ellerid}
494
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
Example: Json, Request
GET
https://api.newegg.com/marketplace/sbnmgmt/inboundshipment/shipmentresult/{requestid}?sellerid={s
ellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
16.4.3. Response Body
For the new shipment creation, once your request has been created successfully, we will return the ShipmentID and Newegg
supported label files for your downloading.
Item Label Sample:
Package Label Sample:
495
Shipping Label Sample (Only available when Shipping carrier = Newegg Partnered Carrier (UPS)):
496
Packing List Label Sample:
497
Attribute
Format
Description
NeweggAPIResponse
IsSuccess
String
Used to identify the operation of Get feed status is
successful
True or False
OperationType
String
Fixed value: GetShipmentResultResponse
SellerID
String
Your seller ID
R
e
s
p
o
n
s
e
B
o
d
y
RequestID
String
The Identifier of a submission
498
RequestDate
String
Request date
ProcessedDate
String
Processed date
RequestStatus
String
Request Status
Shipment
ShipmentID
String
Shipment ID
LabelURLList
Label
LabelType
String
Label types:
ItemLabel
PackageLabel
ShippingLabel
PackingListLabel
LabelURL
String
Downloading URL
ErrorList
Error
ErrorDescription
String
Error description
Example: XML, Response
XSD
API Schema > SBNMgmt > GetInboundShipmentResult > GetInboundShipmentResultResponse.xsd
<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<OperationType>GetShipmentResultResponse</OperationType>
<SellerID>A006</SellerID>
<ResponseBody>
<RequestID>21VS8NZ4D1RU9</RequestID>
<RequestDate>07/14/2013 22:41:25</RequestDate>
<ProcessedDate>07/14/2013 22:42:40</ProcessedDate>
<RequestStatus>FINISHED</RequestStatus>
<Shipment>
<ShipmentID>2768782</ShipmentID>
<LabelURLList>
<Label>
<LabelType>ItemLabel</LabelType>
<LabelUrl>ftp://API-kisRuBid:aa8ke7h8@ftp03.newegg.com/fff5267a-b688-4705-a676-
6b17e910454a.pdf</LabelUrl>
</Label>
<Label>
499
<LabelType>PackageLabel</LabelType>
<LabelUrl>ftp://API-kisRuBid:aa8ke7h8@ftp03.newegg.com/ac2ec547-4492-41c0-80fa-
cbcbd2e5a393.pdf</LabelUrl>
</Label>
<Label>
<LabelType>PackingListLabel</LabelType>
<LabelUrl>ftp://API-kisRuBid:aa8ke7h8@ftp03.newegg.com/d5dd197a-5e4a-410d-bc12-
98841ea84623.pdf</LabelUrl>
</Label>
<Label>
<LabelType>ShippingLabel</LabelType>
<LabelUrl>ftp://API-kisRuBid:aa8ke7h8@ftp03.newegg.com/063d7c3a-0ed3-4b5f-adb7-
f21ba46e2d4f.pdf</LabelUrl>
</Label>
</LabelURLList>
<ErrorList></ErrorList>
</Shipment>
</ResponseBody>
</NeweggAPIResponse>
Example: Json, Response
{
"IsSuccess": "true",
"OperationType": "GetShipmentResultResponse",
"SellerID": "A006",
"ResponseBody": {
"RequestID": "21VS8NZ4D1RU9",
"RequestDate": "07/14/2013 22:41:25",
"ProcessedDate": "07/14/2013 22:42:40",
"RequestStatus": "FINISHED",
"Shipment": {
ShipmentID: 2768782,
"Label": [
{
"LabelType": "ItemLabel",
"LabelUrl": "ftp://API-kisRuBid:aa8ke7h8@ftp03.newegg.com/fff5267a-b688-4705-a676-
6b17e910454a.pdf"
},
{
"LabelType": "PackageLabel",
500
"LabelUrl": "ftp://API-kisRuBid:aa8ke7h8@ftp03.newegg.com/ac2ec547-4492-41c0-80fa-
cbcbd2e5a393.pdf"
},
{
"LabelType": "PackingListLabel",
"LabelUrl": "ftp://API-kisRuBid:aa8ke7h8@ftp03.newegg.com/d5dd197a-5e4a-410d-bc12-
98841ea84623.pdf"
},
{
"LabelType": "ShippingLabel",
"LabelUrl": "ftp://API-kisRuBid:aa8ke7h8@ftp03.newegg.com/063d7c3a-0ed3-4b5f-adb7-
f21ba46e2d4f.pdf"
}
]
}
}
}
16.4.4. Request Failure Errors
For common HTTP error responses, please refer to Common Error Responses
16.5. Get Inbound Shipment List
Get the inbound shipment list of a specified Shipment ID or certain time period.
16.5.1. Resource URL & Information
Resource URL
https://api.newegg.com/marketplace/sbnmgmt/inboundshipment/shipmentlist?sellerid={sellerid}
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
Resource Information
HTTP Method
Authentication?
Request Formats
Response Formats
Rate Limited?
PUT
Required
XML, Json
XML, Json
1000 per min per client
501
16.5.2. Request Body
Attribute
Required?
Format
Description
NeweggAPIRequest
OperationType
Yes
String
The value is fixed, will always be
“GetShipmentListRequest”
RequestBody
PageInfo
PageIndex
Yes
Integer
Current page index. Default is 1.
PageSize
Yes
Integer
How many records in a page.
(Max is 100 per page)
KeywordsType
No
Integer
0. All (Default)
1. Shipment ID
2. Newegg Item Number
3. Seller Part Number
KeywordsValue
No
String
The keywords value of the
specified type
Status
No
Integer
0. All (Default)
1. Preparing
2. Shipped
3. Received
4. Partially Received
5. Manually closed
6. Voided
LastUpdateDateFrom
No
String
Get all shipments whose last
update date starts from this
date.
(Pacific Standard Time)
Please refer to the Acceptable
Date Format
Please note if both
LastUpdateDateFrom and
LastUpdateDateTo are empty,
will use last 30 days instead.
LastUpdateDateTo
No
String
Get all shipments whose last
update date ends from this date
(Include this day).
(Pacific Standard Time)
Please refer to the Acceptable
Date Format
Example: XML, Request
502
XSD
API Schema > SBNMgmt > GetInboundShipmentList > GetShipmentListRequest.xsd
PUT https://api.newegg.com/marketplace/sbnmgmt/inboundshipment/shipmentlist?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggAPIRequest>
<OperationType>GetShipmentListRequest</OperationType>
<RequestBody>
<PageInfo>
<PageIndex>1</PageIndex>
<PageSize>10</PageSize>
</PageInfo>
<KeywordsType>1</KeywordsType>
<KeywordsValue>2740139</KeywordsValue>
<Status>0</Status>
<LastUpdateDateFrom>06/01/2013</LastUpdateDateFrom>
<LastUpdateDateTo>06/07/2013</LastUpdateDateTo>
</RequestBody>
</NeweggAPIRequest>
Example: Json, Request
GET https://api.newegg.com/marketplace/sbnmgmt/inboundshipment/shipmentlist?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"OperationType": "GetShipmentListRequest",
"RequestBody": {
"PageInfo": {
"PageIndex": 1,
"PageSize": 10
},
"KeywordsType": 1,
503
"KeywordsValue": "2740139",
"Status": 0,
"LastUpdateDateFrom": "01/01/2013",
"LastUpdateDateTo": "07/07/2013"
}
}
16.5.3. Response Body
Attribute
Format
Description
NeweggAPIResponse
IsSuccess
String
Used to identify the operation of Get feed status is
successful
True or False
OperationType
String
Fixed value: GetShipmentListResponse
SellerID
String
Your seller ID
ResponseBody
ShipmentList
Shipment
ShipmentID
String
Shipment ID
Status
String
Shipment’s status:
Creating shipment is creating at backend. (I’m
going to remove)
Preparing user can work on shipment.
Ready to ship shipment is ready to ship.
Shipped shipment has been shipped out.
Partially Received warehouse received a part of
shipment.
Received warehouse received whole shipment
already.
Void shipment has been voided.
Manually closed shipment is manually closed which
is over 3 month and still no received.
CreateDate
String
Shipment create date
LastEditDate
String
Last edit date
ShipFrom
String
Ship from name. Default value: seller’s store name.
504
ShipToWarehouseCode
String
Ship to warehouse code
Currently available Newegg warehouse code in
united states:
06. -Tennessee Bulk Warehouse
07. -California Small Warehouse
08. -California Bulk Item Warehouse
10. -New Jersey Bulk Warehouse
14. -New Jersey Small Warehouse
ShipToAddress1
String
Ship to address 1
ShipToAddress2
String
Ship to address 2
ShipToCityName
String
Ship to city name
ShipToStateCode
String
Ship to state code. Example: CA -> California
ShipToZipCode
String
Ship to zip code
ShipToCountryCode
String
Ship to country code
ShippingMethodCode
Integer
The shipping method you specified for this shipment.
1.Small Parcel Delivery (Individual boxes: consist of
units packed in individual boxes and individually
labeled for delivery)
2.Less Than Truckload (LTL, Pallets, Shipment at least
150 lbs:shipment combines individual boxes on
pallets for delivery)
ShippingCarrierCode
Integer
The shipping carrier you used for this shipment.
If ShippingMethodCode = 1:
101.DHL
102.FedEx
103.UPS
104.USPS
105. Newegg Partnered Carrier(UPS)
99.Other
If ShippingMethodCode = 2:
99.Other
OtherCarrierName
String
The shipping carrier name you provided if
ShippingCarrierCode = 99.
PackageLi
st
Package
TrackingNumber
String
The number for tracking your package.
PackageWeight
Decimal
Package weight
PackageLength
Decimal
Package length
505
PackageHeight
Decimal
Package height
PackageWidth
Decimal
Package width
ItemList
Item
SellerPartNumber
String
Seller part number
Quantity
Integer
Item quantity
NumberofPackage
Integer
Number of package labels.
Example: XML, Response
XSD
API Schema > SBNMgmt > GetInboundShipmentList > GetShipmentListResponse.xsd
<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<OperationType>GetShipmentListResponse</OperationType>
<SellerID>A006</SellerID>
<ResponseBody>
<ShipmentList>
<Shipment>
<ShipmentID>2740139</ShipmentID>
<Status>Ready to ship</Status>
<CreateDate>06/06/2013 17:02:31</CreateDate>
<LastEditDate>06/07/2013 11:31:00</LastEditDate>
<ShipFrom>Test_MKTPLS'K_</ShipFrom>
<ShipToWarehouseCode>14</ShipToWarehouseCode>
<ShipToAddress1>45 Patrick Ave., Dock 9-17</ShipToAddress1>
<ShipToCityName>Edison</ShipToCityName>
<ShipToStateCode>NJ</ShipToStateCode>
<ShipToZipCode>08837</ShipToZipCode>
<ShipToCountryCode>USA</ShipToCountryCode>
<ShippingMethodCode>1</ShippingMethodCode>
<ShippingCarrierCode>99</ShippingCarrierCode>
<OtherCarrierName>1</OtherCarrierName>
<PackageList>
<Package>
<TrackingNumber>1</TrackingNumber>
<PackageWeight>0</PackageWeight>
<PackageLength>0</PackageLength>
506
<PackageHeight>0</PackageHeight>
<PackageWidth>0</PackageWidth>
</Package>
</PackageList>
<ItemList>
<Item>
<SellerPartNumber>Ss0120121228065937386</SellerPartNumber>
<Quantity>36</Quantity>
<NumberofPackage>2</NumberofPackage>
</Item>
<Item>
<SellerPartNumber>SS0120130516683100755</SellerPartNumber>
<Quantity>9</Quantity>
<NumberofPackage>3</NumberofPackage>
</Item>
</ItemList>
</Shipment>
</ShipmentList>
</ResponseBody>
</NeweggAPIResponse>
Example: Json, Response
{
"IsSuccess": true,
"OperationType": "GetShipmentListResponse",
"SellerID": "A006",
"ResponseBody": {
"ShipmentList": [
{
"ShipmentID": "2740139",
"Status": "Ready to ship",
"CreateDate": "06/06/2013 17:02:31",
"LastEditDate": "06/07/2013 11:31:00",
"ShipFrom": "Test_MKTPLS'K_",
"ShipToWarehouseCode": "14",
"ShipToAddress1": "45 Patrick Ave., Dock 9-17",
"ShipToCityName": "Edison",
"ShipToStateCode": "NJ",
"ShipToZipCode": "08837",
"ShipToCountryCode": "USA",
507
"ShippingMethodCode": 0,
"ShippingCarrierCode": 99,
"OtherCarrierName": "1",
"PackageList": [
{
"TrackingNumber": "1",
"PackageWeight": 0.0,
"PackageLength": 0.0,
"PackageHeight": 0.0,
"PackageWidth": 0.0
}
],
"ItemList": [
{
"SellerPartNumber": "Ss0120121228065937386",
"Quantity": 36,
"NumberofPackage": 2
},
{
"SellerPartNumber": "SS0120130516683100755",
"Quantity": 9,
"NumberofPackage": 3
}
]
}
]
}
}
16.5.4. Request Failure Errors
For common HTTP error responses, please refer to Common Error Responses
16.6. Get Warehouse List
Get the available information of Newegg’s warehouses.
508
Resource URL & Information
Resource URL
https://api.newegg.com/marketplace/sbnmgmt/inboundshipment/warehouse?sellerid={sellerid}
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
Resource Information
HTTP Method
Authentication?
Request Formats
Response Formats
Rate Limited?
PUT
Required
XML, Json
XML, Json
1000 per min per client
Request Body
Attribute
Required?
Format
Description
NeweggAPIRequest
OperationType
Yes
String
The value is fixed, will always be “GetWarehouseRequest
RequestBody
WarehouseCode
No
String
The warehouse code
Currently available Newegg warehouse code in united states:
06. -Tennessee Bulk Warehouse
07. -California Small Warehouse
08. -California Bulk Item Warehouse
10. -New Jersey Bulk Warehouse
14. -New Jersey Small Warehouse
Example: XML, Request
XSD
API Schema > SBNMgmt > GetWarehouseList > GetWarehouseListRequest.xsd
PUT https://api.newegg.com/marketplace/sbnmgmt/inboundshipment/warehouse?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml
<NeweggAPIRequest>
509
<OperationType>GetWarehouseRequest</OperationType>
<RequestBody>
<WarehouseCode>10</WarehouseCode>
</RequestBody>
</NeweggAPIRequest>
Example: Json, Request
GET https://api.newegg.com/marketplace/sbnmgmt/inboundshipment/shipmentlist?sellerid={sellerid}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json
{
"OperationType": "GetWarehouseRequest",
"RequestBody": {
"WarehouseCode": "10"
}
}
Response Body
Attribute
Format
Description
NeweggAPIResponse
IsSuccess
String
Used to identify the operation of Get feed status is
successful
True or False
OperationType
String
The value is fixed, will always be
GetWarehouseResponse
SellerID
String
Your seller ID
ResponseBody
WarehouseList
Warehouse
WarehouseCode
String
Available Newegg warehouses:
Currently available Newegg warehouse code in united
states:
06. -Tennessee Bulk Warehouse
07. -California Small Warehouse
08. -California Bulk Item Warehouse
10. -New Jersey Bulk Warehouse
14. -New Jersey Small Warehouse
510
AllowBulkItem
Integer
This indicates this warehouse accepts bulk item.
0 No
1 - Yes
AllowSmallItem
Integer
This indicates this warehouse accepts small item.
0 No
1 - Yes
ShipToAddress1
String
The ship to address1 of Newegg’s warehouse
ShipToAddress2
String
The ship to address2 of Newegg’s warehouse
ShipToCityName
String
The ship to city name of Newegg’s warehouse
ShipToStateCode
String
The ship to state code of Newegg’s warehouse
ShipToZipCode
String
The zip code of Newegg’s warehouse
ShipToCountryCode
String
The country code of Newegg’s warehouse
Example: XML, Response
XSD
API Schema > SBNMgmt > GetWarehouseList > GetWarehouseListResponse.xsd
<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
<IsSuccess>true</IsSuccess>
<OperationType>GetWarehouseResponse</OperationType>
<SellerID>A006</SellerID>
<ResponseBody>
<WarehouseList>
<Warehouse>
<WarehouseCode>10</WarehouseCode>
<AllowBulkItem>0</AllowBulkItem>
<AllowSmallItem>1</AllowSmallItem>
<ShipToAddress1><![CDATA[4995 Citation Dr Suite 101,Dock 1-10]]></ShipToAddress1>
<ShipToCityName>Memphis</ShipToCityName>
<ShipToStateCode>TN</ShipToStateCode>
<ShipToZipCode>38118</ShipToZipCode>
<ShipToCountryCode>USA</ShipToCountryCode>
</Warehouse>
</WarehouseList>
</ResponseBody>
</NeweggAPIResponse>
511
Example: Json, Response
{
"IsSuccess": true,
"OperationType": "GetWarehouseResponse",
"SellerID": "A006",
"ResponseBody": {
"WarehouseList": [
{
"WarehouseCode": "10",
"AllowBulkItem": 0,
"AllowSmallItem": 1,
"ShipToAddress1": "4995 Citation Dr Suite 101,Dock 1-10",
"ShipToCityName": "Memphis",
"ShipToStateCode": "TN",
"ShipToZipCode": "38118",
"ShipToCountryCode": "USA"
}
]
}
}
Request Failure Errors
For common HTTP error responses, please refer to Common Error Responses
Error Code
Description
Example: XML, Response
<?xml version="1.0" encoding="utf-8"?>
<Errors>
<Error>
<Code>DF008</Code>
<Message>Invalid industry code ABC</Message>
</Error>
</Errors>
Example: Json, Response
512
{
"Code": "DF008",
"Message": "Invalid industry code ABC"
}
513
Appendix
1. Common Request Headers
Name
Required?
Description
Accept
No
The content type of the response resource
Type: String
Default: application/json
Accept-Language
No
The information for localization
Type: String
Default: en-US
Authorization
Yes
The information required for request authentication
Type: String
Default: None
Content-Length
Conditional
Length of the message (without the headers) according to RFC 2616
Type: String
Default: None
Condition: Required for PUTs and operations that load XML
Content-Type
No
The content type of the resource. Example: application/json
Type: String
Default: None
Date
Yes
The current date and time according to the requester. Example: Wed, 01 Mar
2009 12:00:00 GMT
Type: String
Default: None
2. Failed Response Error Code List
2.1. General HTTP error code
Error Code
Description
400
The request cannot be fulfilled due to bad syntax
401
Unauthorized.
Similar to 403 Forbidden, but specifically used when authentication is possible but has failed or has not yet been
provided.
514
The response must include a WWW-Authenticate header field containing a challenge applicable to the requested
resource.
403
Forbidden.
The request was a valid request, but the server is refusing to respond to it. Unlike a 401 Unauthorized response,
authenticating will make no difference.
405
The method specified in the Request-Line is not allowed for the resource identified by the Request-URI. The
response MUST include an Allow header containing a list of valid methods for the requested resource.
404
Not Found.
The requested resource could not be found but may be available again in the future. Subsequent requests by the
client are permissible.
409
Conflict.
Indicates that the request could not be processed because of conflict in the request, such as an edit conflict.
500
Internal Server Error.
A generic error message, given when no more specific message is suitable.
501
Not Implemented.
The server either does not recognize the request method, or it lacks the ability to fulfill the request.
503
Service Unavailable.
The server is currently unavailable (because it is overloaded or down for maintenance). Generally, this is a
temporary state.
2.2. Common Error Response
Error Code
Description
CE001
SellerID cannot be null or empty
CE002
Invalid SellerID
CE003
Format error. {parse error message}
CE004
The request type you specified is invalid.
CE006
Invalid Issue user.
CE007
The MaxCount (maximum return records) is invalid. Default is 100. If you specified over than 100, the system still
return 100 records.
CE008
DateFrom is required.
CE009
DateTo is required.
CE010
Invalid Date From.
CE011
Invalid Date To.
CE012
System is currently processing your request, please wait a moment and try again.
CE013
No data found
CE014
SellerNoRightError_{0}
Available values:
SellerNoRightError_suspended
515
SellerNoRightError_terminated
SellerNoRightError_closed
SellerNoRightError_new
SellerNoRightError_ holiday lock
(NOTE: This error is to indicate the seller status that not able to submit any request)
CE016
Request cannot be processed because the current seller status is suspended.
CE017
Request cannot be processed because the current seller status is terminated.
CE018
Request cannot be processed because the current seller status is closed.
CE019
Request cannot be processed because the current seller status is new.
CE021
The DateTo should later than the DateFrom
CE022
System is currently experiencing heavy traffic in processing your request. Please wait a moment and try again.
CE023
The service is unavailable or experiencing extremely high error rates.
CE024
We sincerely apologize for the inconvenience. Newegg Marketplace API is currently under scheduled
maintenance and upgrades but will return shortly (From [{begin time}] to [{end time}]). Thank you for your
patience.
3. Acceptable Date Format
Date Format
Sample
YYYY-MM-DD HH:MM:SS
1998-02-23 14:23:05
MM/DD/YYYY HH:MM:SS
PM(AM)
02/23/1998 2:23:05 PM
YYYY-MM-DD HH:MM:SS.MMM
1998-02-23 10:00:00.123
DD MM YYYY HH:MM:SS
23 Feb 1998 14:23:05
YYYY-MM-DDTHH:MM:SS
1998-02-23T14:23:05
YYYY-MM-DDTHH:MM:SS.OZ
1998-02-23T14:23:05.OZ
MM/DD/YYYY
02/23/1998
YYYY-MM-DD
1998-02-23

Navigation menu