quick start integration guide - newegg · data integration guide 2.1. account status you can find...

quick start

integration guide

Version 1.0 11/14/2013

Table of Contents

Document Version – What’s New ......................................................................................................... 3

Getting Started – Sell on Newegg ........................................................................................................... 3

Seller Portal - Quick Reference .............................................................................................................. 3

1. Login page ........................................................................................................................................ 3

2. Home page ....................................................................................................................................... 3

2.1. Account Status ................................................................................................................. 4

2.2. Seller ID ............................................................................................................................ 4

3. Icon and Terms ................................................................................................................................. 5

Data Feed Types & Formats .............................................................................................................. 6

4. Item Creation and Update Feeds ..................................................................................................... 6

5. Order Processing Feed ..................................................................................................................... 6

Data Fields - Definitions........................................................................................................................... 7

6. Data Feed Header Fields .................................................................................................................. 7

7. Item Identification Fields ................................................................................................................. 8

8. Required Fields ................................................................................................................................ 9

9. Optional Fields ............................................................................................................................... 11

Manage Items - Item Creation and Update .......................................................................................... 13

10. Item Creation ................................................................................................................................. 14

10.1. Create a New Item ......................................................................................................... 14

10.2. Create Similar Item ........................................................................................................ 19

10.3. Or, Find it on Newegg .................................................................................................... 22

11. Item List ......................................................................................................................................... 23

11.1. Lookup Item ................................................................................................................... 23

11.2. Update/Delete Item....................................................................................................... 25

11.3. Activate/Deactivate Item ............................................................................................... 27

12. Batch Upload Inventory ................................................................................................................. 28

12.1. Download Inventory Feed Template ............................................................................. 28

12.2. Enter Item Information .................................................................................................. 31

12.3. Upload Inventory Feed .................................................................................................. 31

12.4. Inventory Processing Result File .................................................................................... 34

13. Batch Item Creation/Update.......................................................................................................... 36

13.1. Download Data Feed Template ..................................................................................... 36

13.2. Enter Item Information .................................................................................................. 39

13.3. Batch Group Related/Variant Items .............................................................................. 40

13.4. Batch Update Items ....................................................................................................... 43

13.5. Upload Data Feed .......................................................................................................... 45

13.6. Processing Result File .................................................................................................... 47

14. Manufacturer (View List/Request New) ........................................................................................ 48

14.1. Manufacturer Page ........................................................................................................ 48

14.2. View Accepted Manufacturer/Brands ........................................................................... 48

14.3. Submit New Manufacturer Request .............................................................................. 49

14.4. Batch Manufacturer Request ........................................................................................ 49

Manage Order – Process Orders and Batch Ship .................................................................................. 50

15. Order List........................................................................................................................................ 50

15.1. Order List page .............................................................................................................. 50

15.2. View and Search Orders ................................................................................................ 50

15.3. Process and Ship Order.................................................................................................. 52

16. Batch Ship Orders .......................................................................................................................... 53

16.1. Download Order Shipping Template ............................................................................. 53

16.2. Complete Your Batch Shipping File ............................................................................... 57

16.3. Upload Batch Shipping File ............................................................................................ 58

Data Feed Settings – FTP ..................................................................................................................... 60

17. Setup/Manage FTP account ........................................................................................................... 60

17.1. Data Feed Settings Page ................................................................................................ 60

17.2. Ftp Settings .................................................................................................................... 60

17.3. FTP Order File Format .................................................................................................... 61

17.4. Inventory Snapshot File ................................................................................................. 61

18. FTP Directory Structure .................................................................................................................. 63

Index ......................................................................................................................................................... 64

3 Data Integration Guide

Document Version – What’s New

Version 5.1

Section 13.6.6 updated for Processing Result File

New Index section

“Batch Upload Inventory” updated to “Batch Update Inventory”

Version 5

Integration Guide reformatted

Screenshots updated

Getting Started – Sell on Newegg

Seller Portal – Quick Reference

Data Fields - Definitions


Get Familiar with

Seller Portal

and our

Data Feed Types

• All core operations are controlled via Seller Portal and/or Data Feed

Manage Items

• Decide how to send your item information to Newegg

• Create New Items

• Update Existing Inventory

Manage Order • Process

your order to get paid!

Getting Started – Sell on Newegg

- Item Creation and Update

– Process Orders and Batch Ship


Seller Portal - Quick Reference

To manage your Newegg seller account, login to Seller Portal: https://sellerportal.newegg.com

1. Login page

2. Home page

After logging into Seller Portal, your browser will direct you to the home screen.

https://sellerportal.newegg.com/


2.1. Account Status You can find the status of your account on the top-right hand corner of the Seller Portal’s homepage.

Active 2.1.1.Seller may create, update, and activate their items to sell on Newegg Marketplace.

InActive 2.1.2.Seller can perform all actions except activate items. Any items online will be deactivated and turned offline. This status will not affect any pending orders; seller may still process orders normally.

Suspended 2.1.3.Seller can only process any pending orders. All items will be deactivate and set with an inventory (qty.) of zero.

Terminated 2.1.4.Seller will lose access to Seller Portal when their account is terminated. All items will be cleared and any pending orders will be canceled.

Closed 2.1.5.Upon agreement between seller and Newegg, account may be closed.

2.2. Seller ID The Seller ID is a unique 4 character identification code assigned to each seller’s account. Kindly include your Seller ID whenever contacting Newegg support via email.

2.3. Quick links

Manage Account 2.3.1.Quickly navigate to your account settings page to view/update the following: Account Information User Account Settings Seller information RMA Policy And Info

Manage Shipping 2.3.2.Quickly navigate to your shipping settings page to view/update the following: Shipping Methods Shipping Charge

Sell Item 2.3.3.Quickly navigate to the Item Creation page to start creating new items on your Newegg account.

Manage Item 2.3.4.Quickly navigate to the Item List page to view or edit your item’s information.


Manage Order 2.3.5.Quickly navigate to the Order List page to manage and process orders individually or in batch using a Batch Ship file.

View Report 2.3.6.Quickly navigate to the Payment Reports page to view the following: Summary Transaction Detail Storage Detail Settlements Commission Reference

2.4. Announcements

You will find announcements that pertain to business, customer service, integration, IT and financial aspects of your account.

3. Icon and Terms

3.1. Navigation panel The Navigation panel is located on the left side of the Seller Portal (see Figure 1).

3.2. Breadcrumbs Breadcrumbs at the top of the page are clickable in case you need to navigate back to the previous pages. Do not use your browser’s back button. (see Figure 2)

3.3. Pencil Icon The pencil icon represents the edit function. You will find that each item created on your account has its own pencil icon. You will be able to view/edit your item’s content by clicking on this icon. (see Figure 2)

3.4. Question Mark Icon

Question Mark icons are placed throughout the Seller Portal to help describe the function or field it is next to. Moving your cursor over the icon will bring up the description box. (see Figure 2)

Skip to Next Section

Back to Table of Contents

5 Data Integration Guide Figure 1: Navigation Panel

Back

Figure 2: Breadcrumbs/Icons

Back


Data Feed Types & Formats

A data feed is a file that is used to process items or orders in batch. Newegg provides multiple types and formats for your convenience.

4. Item Creation and Update Feeds

There are currently three different types of data feeds that will allow you batch create and/or update items on Newegg. Each type of feed is available in four different formats: xls, csv, txt (tab-delimited), and xml. Newegg highly recommends first time users to download each type in the xls format. The MS Excel (xls) format templates include more information how to properly use the respective data feed type.

Item Creation/Update Data Feed This feed can be used to either batch create new items or update your existing items. It’s important to note that each subcategory has its own respective data feed. It’s the seller’s responsibility to download the data feed template(s) that are specifically designed for their items. It’s essential to use the appropriate data feed in order for the items to be correctly categorized in Newegg’s Marketplace: Download Data Feed Template

Existing Item Creation Data Feed This type of feed may be used if the items you wish to create already exist on Newegg’s database. This feed will allow you to batch create your items using the matching Newegg item numbers, matching manufacturer/manufacturer part numbers, or matching manufacturer/UPC numbers that Newegg currently has on their database only: Download Data Feed Template

Inventory Feed This type of feed is only used to batch update your items’ pricing information, shipping, inventory

and/or activation. For more details including where to download/upload the inventory feed, please see

the Batch Upload Inventory section.

5. Order Processing Feed

Our Order Shipping Template is the only type of feed used to process orders in bulk. The feed is available in four different formats: xls, csv, txt (tab-delimited), and xml. Newegg highly recommends first time users to download the feed in the xls format. The MS Excel (xls) format template includes information how to properly use the feed. Download Order Shipping Template

Order List File The Batch Order Shipping Template is interchangeably known as the Order List File, specifically when the template has been downloaded with unshipped or new orders populated.

Batch Shipping File The Batch Order Shipping Template is interchangeably known as the Batch Shipping File, specifically when all required shipping information (i.e. shipping method, tracking, etc.) has been entered by the seller. Orders will NOT be processed if required fields are not properly entered into the file.


Data Fields - Definitions

Data Feed Header Fields

Overwrite SubCategoryID Version

Item Identification Fields

Seller Part # Manufacturer Manufacturer Part#/ISBN

UPC Newegg Item #

Required Fields

Action Inventory Item Images

Item Length Item Width Item Height

Item Weight(lb.) Product Description Selling Price

Shipping Website Short Title

Optional Fields

Activation Mark Age 18+ Verification CheckoutMAP

Choking Hazard Currency Item Condition

Item Package Manufacturer Item URL* MSRP

MAP Proposition 65 (California) Related Seller Part #*

Shipping Restrictions/Hazardous Materials

Website Long Title


6. Data Feed Header Fields

6.1. Overwrite The Overwrite function was NOT designed to overwrite any item or item information. Setting the function, “Overwrite=Yes”, is designed to DEACTIVATE all items from the subcategory that is specified on the data feed or all items on the seller’s account if using an Inventory Feed and then process each item listed accordingly.

6.2. SubCategoryID SubCategoryID is prepopulated and should NOT be deleted or changed from the data feed template. The system will not process the data feed correctly if the ID is modified. This field is only applicable to the Item Creation/Update Data Feed.

6.3. Version The version number is for internal operations only. Do not edit or remove from the data feed header.


7. Item Identification Fields

7.1. Seller Part # Enter a unique identification number for each item. This value is assigned by the seller and must be unique for every item, including variations of the same product (for example, if item A comes in both red and blue, then red one must have a different Seller Part # than the blue one). This field is not editable after item creation. Max length: 40 characters.

7.2. Manufacturer Enter the manufacturer name for the item. Manufacturer names need pre-approval before they can be used. You can check the list of acceptable manufacturers or request a new manufacturer to be added through the Manufacturer page in Seller Portal. Bulk request may be sent to [email protected]. This field is not editable after item creation.

7.3. Manufacturer Part#/ISBN Enter the manufacturer's unique part number or ISBN. This number must be unique for every item with the same manufacturer name, including variations of the same product (for example, if item A comes in both red and blue, then the red one must have a different Manufacturer Part#/ISBN than the blue one). This field is not editable after item creation. Max length: 20 characters. The Manufacturer Part#/ISBN is only required if the UPC is not provided. Both are recommended.

7.4. UPC Enter the item's 12 digit numeric Universal Product Code (UPC) or the 13 digit European Article Number (EAN). This field is not editable after item creation. The UPC is only required if the Manufacturer Part#/ISBN is not provided. Both are recommended.

7.5. Newegg Item # The Newegg (NE) Item # is the unique identification number assigned to each item by Newegg. All Marketplace NE item #’s will begin with, ‘9SI’+ Seller ID + 7-alphanumeric code (i.e. 9SIA0VY0GP4666).

Back to Data Fields

mailto:[email protected]


8. Required Fields

8.1. Action* The Action field is technically an optional field however it is crucial that you understand this function in order to update your item properly. Below are the five different values that the Action field will accept.

Create Item 8.1.1.This action will create a new item listing not currently in your item list. If the item exists in your item list and this action is selected, the system default to Update Item Price and Inventory instead.

Update Item 8.1.2.This action will allow you to update your item’s content including the detail property fields. This action will NOT update the item’s pricing information, inventory, shipping, activation or images.

Update Item Price and Inventory 8.1.3.This action will only allow you to update your existing item’s pricing information including Currency, MSRP, MAP, Selling Price, Shipping, Inventory and Activation Mark.

Update/Append Image 8.1.4.This action will allow you to update your existing item’s image(s) or append new image(s). When this action is selected, the system will only process the information provided in the Item Images and Activation Mark fields. All other information, including Selling Price, will be ignored.

Replace Image 8.1.5.This action will allow you to replace and reorder all your previously uploaded images. Any images uploaded by Newegg or other marketplace sellers cannot by replaced. When this action is selected, the system will only process the Item Images field and Activation Mark; all other information will be ignored.

If item does not exist in our system and the action is left blank, then the action will automatically default to “Create Item”. If the item does exist in our system and the action is left blank, then the action will default to “Update Item Price and Inventory”.

8.2. Inventory This field is used to input the item’s inventory or quantity that is in stock and available for sale.

8.3. Item Dimensions(in.) The dimensions must be entered for each individual unit in inches. The fields will accept a number with up to 6 digits to the left of the decimal point and 2 digits to the right of the decimal point. Do not use commas, units of measurement, or any other symbols.

Item Length 8.3.1.

Item Width 8.3.2.

Item Height 8.3.3.

* Data feed only

8.4. Item Images At least one image is required to activate the item. Image Requirements

Min dimensions: 320 pixels wide OR 240 pixels high. There are no maximum dimensions. i. Only .jpg and .jpeg formats/file extensions are acceptable. ii. Each image's maximum size is 5 megabytes. iii. You can only upload 7 images per item. iv. Images should be clear and free of extra text, watermarks, and/or merchant logos. v. Blank images and images containing messages similar to, “Image Coming Soon!” are prohibited. vi.

Highly Recommended

Provide images with 4:3 aspect ratios. i. Provide actual images of the item ii. Provide different angles, with the item open/closed (if applicable). iii.

8.5. Item Weight(lb.) Enter the shipping weight for an individual unit in pounds. Do not include commas, unit of measurements, or any other symbols.

8.6. Product Description Enter a detailed description to be featured on the product page’s overview. This description should state the features and functions of the product. Items in the same product family should contain the same product description. Maximum: 4,000 characters, including spaces. Accepts the following basic HTML tags only:

<ol>,<ul>, <li>, , , , , , , , , 

HTML must be well-formatted. All open tags (i.e. ) must be closed () except for . The product description must adhere to our Product Description Policy and Guidelines and Offensive Content Policy.

8.7. Selling Price The selling price is the actual price at which the item is listed for sale. This field accepts a number with up to 10 digits to the left of the decimal point and 2 digits to the right of the decimal point. Do not use commas, dollar signs, or any other symbols.

8.8. Shipping Based on your shipping settings, the system will calculate your shipping charge for the item if this field is set to “Default”. Or, you may set the shipping to “Free”. Shipping settings may be managed via Seller Portal: Manage Account>Shipping Settings.

8.9. Website Short Title Enter a short and easily identifiable title for the item. The Website Short Title is the title that will appear on the product page, search results, Sales Orders and receipts, so it should not contain variables. Maximum: 200 characters, including spaces. The title must adhere to our Website Short Title Policy & Guidelines and Offensive Content Policy.

Back to Data Fields

http://promotions.newegg.ca/marketplace/contentpolicy/ContentPolicy.html#Product Description

http://promotions.newegg.ca/marketplace/contentpolicy/ContentPolicy.html#Offensive Content


http://promotions.newegg.ca/marketplace/contentpolicy/ContentPolicy.html#Short Title


9. Optional Fields

9.1. Activation Mark* The Activation Mark field allows the seller to control the item’s activation. Setting the Activation Mark to “True” will activate the item to go online. Setting the field to “False” will deactivate the item to go offline (consumers will not be able to see any deactivated items on Newegg.com). If left blank, the default is "True".

9.2. Age 18+ Verification Certain items have an age restriction on use. If the item you are creating has such a restriction, set this value to Yes. Otherwise, set it to No. The default is No.

9.3. CheckoutMAP If Checkout MAP is marked as True (checked) and the Selling Price is below MAP, then the website will ask customer to add item to shopping cart AND go to checkout page to see the item's price.

9.4. Choking Hazard Certain items contain or are a choking hazard for children. If the item you are creating is such a hazard, please specify the type of choking hazard here. For more information, please refer to CPSIA for details. Please note: if the item is a small ball, it cannot contain a small ball. Acceptable values include the following.

a) Small parts b) Is a small ball c) Contains a small ball d) Contains balloons e) Is a marble f) Contains a marble

9.5. Commission Rate† This field is pre-populated and only for your reference. It cannot be changed.

9.6. Currency* The currency of the item's selling price and instant rebate. Currently, the only option available for this field is USD. If left blank, system will default currency to USD.

9.7. Item Condition Set the item’s condition to “New” or “Refurbished”. The default is “New”.

9.8. Item Package Enter either “Retail” or “OEM”. The default is “Retail”.

* Data Feed only

† Seller Portal only

http://www.cpsc.gov/about/cpsia/sect105.html


9.9. Manufacturer Item URL* Enter the website (URL) of the item’s manufacturer.

9.10. MAP 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. This field accepts a number with up to 10 digits to the left of the decimal point and 2 digits to the right of the decimal point. Do not use commas, dollar signs, or any other symbols. Please note: When an item’s MAP is set by Newegg, the system will force all items listed under the same item to follow Newegg’s MAP.

9.11. MSRP The manufacturer’s suggested retail price (MSRP) or list price for the item. This field accepts a number with up to 10 digits to the left of the decimal point and 2 digits to the right of the decimal point. Do not use commas, dollar signs, or any other symbols.

9.12. Proposition 65 (California) Certain items contain chemicals that are known to the State of California to cause cancer or reproductive toxicity. If the item you are creating contains such chemicals, set this value to Yes. Otherwise, set it to No. The default is No. For more information please go to: http://www.oehha.ca.gov/prop65.html for list of chemicals.

9.13. Related Seller Part #* This field is used to group items that are similar but vary in size, color, etc. It’s highly recommended and in some cases required that sellers group any related items together so that they can be listed under one product page/listing. See the section Batch Group Related/Variant Items for more information. This field is not editable after item creation.

9.14. Shipping Restrictions/Hazardous Materials Certain items have shipping restrictions where the item cannot be shipped via air. If the item you are creating has such a restriction, set this value to Yes. Otherwise, set it to No. The default is No.

9.15. Website Long Title* Enter a longer, more descriptive item name for your item.

Back to Data Fields

* Data Feed only

http://www.oehha.ca.gov/prop65.html


Batch Item Creation/Update

•To Create or Update Items in bulk

Download Data Feed

•Data Feed Overview

•Important Instructions

Enter Item Info

•Group Related/Variant Items

•Update Items

Upload Data Feed

•Upload via Seller Portal

•Upload via FTP

Check Results

•Download via Seller portal

•Download via FTP

1x1 Item Creation

•To Create and Update items one by one in Seller Portal

Create a New Item

•Enter all data directly into seller portal

Create Similar Item

•Create child/variant items

Or, Find it on Newegg

•Easily create an item that already exists on Newegg

Item List

•View Items

•Edit Item

•Activate/ Deactivate Item

•Delete Item

Batch Upload Inventory

•To Update your exiting item's inventory, price, shipping, and activation in batch only

Download Inventoy Feed

•Inventory Feed Overview

•Important Instructions

Enter Item Info

•Update item's price, shipping, or activation

Upload Inventory Feed

•Upload via Seller Portal

•Upload via FTP

Check Results

•Download via Seller portal

•Download via FTP

Manage Items - Item Creation and Update

In order to sell items on Newegg Marketplace, the seller needs to create the items on our system by assigning product information to each item. Managing items on Newegg Marketplace can be achieved with any of the following methods. The seller does not have to choose and stick to only one method; all methods may be used interchangeably to manage your items on Newegg.



1x1 Item Creation Create a New Item Create Similar

Item Or, Find it on

Newegg Item List

10. Item Creation

Sellers can individually create new items to our Newegg Marketplace by manually entering the product’s information directly into Seller Portal. “Or, Find it on Newegg”, if the item already exists in our database then find the item in Seller Portal and quickly add the same listing to your Newegg account. Seller Portal also gives you the capability to create a variant (i.e. different size, color, etc.) of your item to allow consumers to select from different attribute options on one product page/listing.

Back to Manage Items

10.1. Create a New Item Items may be created one at a time using our web-based Seller Portal.

Logon to Seller Portal 10.1.1.

From the Navigation panel 10.1.2. Click Manage Items i. Click Item Creation ii.

Click the Create a New Item button 10.1.3.The button is located in the top left corner of the Item Creation Frame.

Select the industry 10.1.4.After you click on the Create a New Item button, the portal will take you to a page that includes a list of industries. Select the industry you wish to create your item in by clicking on the proper link.




Item Or, Find it on

Newegg Item List

Select the subcategory 10.1.5.After you select the industry, the portal will take you to a page with a list of subcategories. Select the subcategory that you wish to create your item under by clicking on the proper subcategory link. Any subcategory links that are grayed out are restricted. Special permission must be obtained to sell items that fall under a restricted subcategory. If you wish to sell an item that falls under a restricted subcategory, please contact your Category Manager to request permission.

Basic Information Page 10.1.6.After you have selected the subcategory, the portal will take you to the Basic Information page. The basic information fields marked with a red asterisks are required. The manufacturer field will also begin to autocomplete once you start to type; you must select one of the given values from the drop-down menu. For more information about each field, please refer to the section on Data Fields - Definitions of this document. Click on the Continue Button to advance to the next page.



Item Or, Find it on

Newegg Item List

Specific Information Page 10.1.7.This next page will allow you to fill in the item’s specific information fields. Fields marked with a red asterisk are required. For more information about each field, please refer back to the Data Fields - Definitions section of this document. Click on the Continue Button to advance to the next page.

Detail Information Page 10.1.8.This next page will allow you to provide the item’s detail information. All the provided values will appear for the consumer to view under the detail tab of the item’s product page. These fields will vary depending on the category the item is being created under. Fields with a red asterisk are required. Fields with a blue asterisk are only required if the item will be grouped with a similar item. For the best search results, provide as much detail as possible. Some of the property fields are used to help consumers filter their search results. Missing any of these values, may cause your item to be excluded from the consumer’s search. Click on the Continue Button to advance to the next page.



Item Or, Find it on

Newegg Item List

Price, Inventory, Shipping and Images 10.1.9.This next page will allow you to enter the pricing information, inventory, shipping method and to upload images for your item. Fields marked with a red asterisk are required. At least one image is also required to create your item. You may upload up to seven images for each item.

10.1.9a. Upload Images (see Figure below) Click the Browse button i. Pop-up window will appear ii. Search and select your image iii. Click the Open button iv. Repeat steps i. thru iv. to upload more images v. Click the Upload button vi.

10.1.9b. Click on Submit button The button is located in the bottom right-hand corner of the page.



Item Or, Find it on

Newegg Item List

Confirm update(s) 10.1.10.After you submit your item a pop-up window will appear asking you if you are sure you want to save your update(s). Click the OK button to continue.

Add a Similar Item Option 10.1.11.Before you complete your item creation you may be given the option to create a variation of the same item. Depending on the subcategory, this may include a different size, color and/or another detail property. Click on the “Add a Similar Item” button to create a variant of your item or click the “Continue Without Adding Similar Item” button to complete your item creation.

Item Creation/Update Completed 10.1.12.Your item will not be successfully created or updated until you reach this last Create Item page.



Item Or, Find it on

Newegg Item List

10.2. Create Similar Item Manually create a variation (i.e. different size, color, etc.) of your item to allow consumers to select from different attribute options on one product page. Before you begin, take a few minutes to familiarize yourself with Newegg’s grouping concept found under the section Batch Group Related/Variant Items.

Lookup Item in Seller Portal 10.2.1.One of your variant items must exist on your Newegg account before similar items can be created. Search for the existing item in your Manage Items>Item List or Create a New Item first if none exist.

Add Variation 10.2.2.Once you have found your item, click on the “More” link under the Action column and click “Add Variation”. If you do not see the “Add Variation” link, then the subcategory is not currently setup to allow variation items to be grouped. Please contact [email protected] for more information.




Item Or, Find it on

Newegg Item List

Add a Similar Item 10.2.3.The next page will take you to an overview of your original/parent item. Click on the “Add a Similar Item” button to begin your similar item creation.

Enter Similar Item’s Information 10.2.4.After clicking the “Add a Similar Item” button, a designated section for your variant item will appear. Enter/Update all required data fields and group-by properties (marked with a blue asterisk).

Upload Images for Similar Item 10.2.5.At one image is required to create any item on your account (even if the similar item has the same image as the original item). Upload an image for the variant item by clicking its respective “Upload Images” link.



Item Or, Find it on

Newegg Item List

Click on the Save All button 10.2.6.The button is located in the bottom right-hand corner of the page.

Confirm Similar Item Creation 10.2.7.A pop-up window will appear asking you if you are sure you want to save all similar items. Click the OK button to confirm and continue.

Similar Item Creation Completed 10.2.8.After confirmation, the system will begin creating your similar items. Allow at least 10 minutes for updates to reflect on all systems. Contact [email protected] if similar items have not appeared on the website 24 hours after creation.

Back to Top




Item Or, Find it on

Newegg Item List

10.3. Or, Find it on Newegg Save time by adding the same item listing that already exists on Newegg’s database.


From the Navigation panel 10.3.2. Click Manage Items i. Click Item Creation ii.

Find it on Newegg 10.3.3.Search for the item’s listing by entering one of its following specific details into the text box and click the search button. a) Manufacturer b) Manufacturer Part # c) Item Description d) Newegg Item # e) UPC

“Sell This” 10.3.4.Once you find the item you wish to sell, simply click on the “Sell This” button to create the same listing under your account.

Enter Detail Information 10.3.5.Provide any properties that may be missing. Please refer to the Detail Information section under Create a New Item for more information. Click the Continue button to advance to the next page.

Refer to Price, Inventory, Shipping and 10.3.6.Images Enter the item’s required information including its seller part # and submit your item for creation.




Item Or, Find it on

Newegg Item List

11. Item List

The Item List page is where you can view all the items that you currently have on your Newegg account. The page also allows you to edit, activate/deactivate, and delete your item from your account.

11.1. Lookup Item To view an item’s product information on your Newegg account.


From the Navigation panel 11.1.2. Click Manage Items i. Click Item List ii.

Select the All Item tab 11.1.3.The All Item tab is the Item List’s default page.

Select the search expression 11.1.4.From the pull-down menu, select one of the following options you wish to search for your item by: a) Seller Part # b) Manufacturer Part # c) Newegg Item # d) Item Description (title)

Enter respective search 11.1.5.expression into the search box

Click the Search button 11.1.6.Once you click the Search button, a list of items that match your search expression will be displayed.

(optional) Please refer to Create 11.1.7.Similar Item




Item Or, Find it on

Newegg Item List

View Item’s Title/Listing 11.1.8.To view the item’s product page listing, click on the clickable product title. Only active items can be viewed.

(Optional) Click Advanced Search 11.1.9.The Advanced Search option will allow you to filter your search results with different attributes.



Item Or, Find it on

Newegg Item List

11.2. Update/Delete Item The Item List allows you to update or delete your items individually. To update your items in bulk, please refer to Batch Update Items. To batch delete, please contact [email protected].

Lookup Item under the Manage Items>Item List page 11.2.1.

To Update Item Content or Delete Item

Select Action 11.2.2.Under the Action column of your Item List, select the Action you want to perform for the item.

a) Click the red “x” to delete your item

Warning: Once item is deleted, it cannot be recovered.

b) Click the pencil icon to Edit Item Once you click the pencil icon the portal will take you into the same information pages used to Create New Items in Seller Portal. See Basic Information Page to continue updating your item. Please note that you may not have permission to edit some of the item’s information. By default, our system assigns content ownership to the seller who creates the item first on our database.

Sellers are NOT allowed to update the following: Seller Part # Manufacturer Manufacturer Part # UPC Please contact [email protected] to update any of your item’s information listed above.

To Update Price, Inventory and Shipping only

Enter new value into text box 11.2.3.From the Item List, you can quickly update the item’s price, inventory, and/or shipping by changing the value in the text box. A value that has been changed will automatically be highlighted in yellow.





Item Or, Find it on

Newegg Item List

Click Save All Updates button 11.2.4.Click the button at the bottom left-hand corner of browser to save all updates made to the items in the Item List.

Confirm Update 11.2.5.Click the OK button in the Confirm pop-up window to confirm all updates or click Cancel to return to the Item List.

Result Message 11.2.6.A message will appear at the bottom of your browser with the result of your update.



Item Or, Find it on

Newegg Item List

11.3. Activate/Deactivate Item

Lookup Item in your Manage Items>Item List. 11.3.1.

Status Column 11.3.2.Scroll to the right of the item list to view the status column. The item’s status will show a green light for active (online) and yellow light for inactive (offline). Click the light to change the status.

Confirm Status Change 11.3.3.After clicking the status button, click the OK button from the Confirm popup window.

Result Message 11.3.4.A message will appear at the bottom of your browser with the result of your status change.



Download Inventory Feed

Enter Item Info Upload

Inventory Feed Check Results

12. Batch Upload Inventory

The Batch Upload Inventory page is where you can update all your existing items’ pricing information, inventory, shipping, and activation using one feed. To batch create new items or update your existing item content, please see the section Batch Item Creation/Update .


12.1. Download Inventory Feed Template

The Inventory feed may be downloaded from seller portal or you may setup an Inventory Snapshot File to be automatically generated for you to download via FTP.

To Download via Seller portal 12.1.1.Logon to Seller Portal

From the Navigation panel 12.1.2. Click Manage Items i. Click Batch Upload Inventory ii.

Download File Template tab 12.1.3.Keep the page under the Download File Template tab to download a new inventory template.

Select the Template File Type 12.1.4.(i.e. xls, csv, txt, xml)

Download template with your items 12.1.5.populated in the file? a) Check box for “YES” (default) b) Uncheck box for “NO”

Feed Overview Important Instructions







Click on the Download File Template button 12.1.6.If you choose to download the template without your items populated then you may be prompted to Open, Save, or Cancel the template download. Click Save to save a copy to your PC.

Download File Template Status and History 12.1.7.If you selected to download the Inventory Feed with your items populated in the file then they system will begin to generate your file. You can check the status and download your feed under the Download File Template Status and History. Once the status shows “Completed” you can then download the file by clicking on the Download link.






Inventory Feed Overview Regardless of the Inventory feed format you decide to use (xls, csv, txt, xml), it is highly suggested for first time users to download the template in the MS Excel (xls) format. The Excel Template includes the following worksheets that contain valuable information you will need to properly fill out the Inventory Feed. Instructions

The Instructions sheet provides an overview of how to use the template. BatchInventoryAndPriceUpdate

This is the actual worksheet that will be used to enter your product information. Do not rename the tab otherwise the system will not process your feed.

Important Inventory Instructions Template Header

The template header includes the overwrite function on the first row. It’s recommended not to remove the header. Warning: Setting the ‘Overwrite=Yes’ was NOT designed to overwrite any existing item information. Instead, it was designed to DEACTIVATE all items from your Newegg account and then process only the items that are currently listed on the respective inventory feed.

Data field Header Names

All data fields should be included. Do NOT modify the format or remove any fields from your inventory feed. Doing so may cause your items from being properly updated or to fail completely. If the field does not pertain to your item then simply leave the field blank.










12.2. Enter Item Information To update your items inventory information, enter the updated information for each item on its own row. The

only required field is the seller part #. The Newegg Item # field is just for reference and verification; it may be

left blank. Only the following fields may be updated using the Inventory Feed. To update any other item

information, see Batch Update Items.

Currency

MSRP

MAP

CheckoutMAP

Selling Price

Shipping

Inventory

Activation Mark

12.3. Upload Inventory Feed You may upload your item inventory data feed through Seller Portal or FTP.

Upload Inventory Feed via FTP

First time users: Setup/Manage FTP account 12.3.0.

Upload to the following Directory: 12.3.1.>Inbound/Inventory

Upload Inventory Feed via Seller Portal



Click on the Upload File tab 12.3.3.







Click the Browse button 12.3.4.A window titled “Open” will pop-up.

From the Open pop-up window 12.3.5. Search for and select your data feed i. Click the Open button ii.

Click on the Upload button 12.3.6.Our system will begin to process your file. The time to process your file may vary depending on the current traffic on our system and size of you file.






Uploaded File Status and History 12.3.7.Once the file has been successfully uploaded, the system will begin to process. You can view the status of your data feed under this section.






12.4. Inventory Processing Result File After the system has finished processing your uploaded Inventory feed, it will generate a processing result file. The processing result file includes the status of each item processed. The processing result file can be downloaded from the Seller Portal or FTP.

To Download via FTP


Download from the following Directory: 12.4.1.>Outbound/Inventory

To Download via Seller Portal



Click the Upload File tab 12.4.3.

Uploaded File Status and History 12.4.4.Search through history of uploaded data feeds to find your Inventory feed.

Download 12.4.5.Click on the >> View Details link under the Download Link column to download the processing result file for the respective Inventory feed.







Item’s Status and Error Descriptions 12.4.6.For xls, csv, and txt data feed formats the statuses will be given at the end of each item’s row. For xml data feed formats, only the results for items that processed with errors will be given.



Download Data Feed


Data Feed Check Results

13. Batch Item Creation/Update

Newegg provides the capability to batch create new items and update your existing items on your Newegg account by using a data feed. A data feed is simply a file that allows sellers to enter all the item information that Newegg requires in a certain format in order to create/update items in bulk.


13.1. Download Data Feed Template

*To download an Inventory Feed template, please refer to Batch Upload Inventory.


From the Navigation panel 13.1.2. Click Manage Items i. Click Batch Item Creation/Update ii.

Under the Download File Template tab 13.1.3.

Select the Action 13.1.4.

a) “Batch Item Creation”

To download an empty item creation/update or existing item creation data feed template.

b) “Batch Item Update”

To download all your existing items from your Newegg Marketplace account. All items will be downloaded into one data feed for each respective subcategory. This Action can only be performed once every 24 hours.

Feed Overview Important Instructions

To download an Existing Item Creation TemplateCheck the box where it says:

“Create items that exist on Newegg”




Download Data Feed



Select the Template File Format (xls, csv, txt, xml) 13.1.5.The XML template is not available for “Batch Item Update”.

Select the Industry (i.e. Apparel) 13.1.6.This option is only applicable when downloading an empty Item Creation/Update Data Feed template.

Select the Category (i.e. MensCasualShirts) 13.1.7.This option is only applicable when downloading an empty Item Creation/Update Data Feed template.

Click the Download File Template button 13.1.8.

For “Batch Item Update” only 13.1.9.The system will start to generate a zipped file containing your completed data feed(s).

Download File Template Status and History 13.1.10.You can check the file’s status and download the generated file once it’s completed in this section.



Download Data Feed



Data Feed Overview Regardless of the data feed format you decide to use (xls, csv, txt, xml), it is highly suggested to download the template in the MS Excel (xls) format. The Excel Template includes the following worksheets that contain valuable information you will need to properly fill out the Datafeed.

Instructions The Instructions sheet provides an overview of how to use the template.

Basic Item Info – Definitions This sheet includes definitions and accepted values for all common fields across all data feeds.

Detail Item Info – Values This sheet includes accepted property field values that have been pre-defined for the respective subcategory (i.e. Mens Shirts). The worksheet is only included in the Item Creation/Update Data Feed Template. It’s best to only use the values found under this sheet for the respective property. If the value you need is not listed, kindly send a request to add your value to [email protected].

Datafeed

This is the actual worksheet that will be used to enter your product information to create new items or update the items that already exist on your account. The worksheet clearly marks all required fields with header names in red font and group-by properties with header names in blue font. Please Note: This is the only place to find the subcategory’s group-by properties.




Download Data Feed



Important Data Feed Instructions Template Header

Do not remove the main data feed template header from your feed. The Version number, SubCategoryID, and Overwrite function should always be included. Warning: Setting the ‘Overwrite=Yes’ was NOT designed to overwrite any existing item information. Instead, it was designed to DEACTIVATE any items not currently listed on the respective data feed for the specified subcategory. Please see the Data Feed Header Fields section for more information about each header field.

Data field Header Names

All data fields should be included. Do NOT modify the format or remove any fields from your data feed. Doing so may cause your items from being properly created or to fail completely. If the field does not pertain to your item then simply leave the field blank.

Manufacturer Field

Only manufacturer names that have been pre-approved can be used. For more information, see the Manufacturer section.

13.2. Enter Item Information

To create new items in batch, enter each item’s information into its own row by assigning values to the Item Identification Fields. Values for the Required Fields must be properly entered to prevent the item from failing. For any items that you offer with variant options (i.e. different sizes, colors, etc.), see the Batch Group Related/Variant Items for more information. To update existing items, see Batch Update Items.

Input Image Links 13.2.1.Refer to the Item Images definition to familiarize yourself with the image requirements (may also be found in the Instructions worksheet of the data feed template). The image(s) must be provided from an HTTP URL when creating or updating your item from a data feed. A maximum of seven images may be uploaded by entering all image links as one string into the field and separating each link with a comma.

Property Fields 13.2.2.Refer to the Detail Item Info – Values worksheet. For the best search results, provide as much detail as possible. Some of the property fields are used to help consumers filter their search results. Missing any of these values, may cause your item to be excluded from the consumer’s search.

Upload Data Feed13.2.3.


13.3. Batch Group Related/Variant Items If you offer your item in different variants (i.e. size, color, etc.) then we highly recommend that you group those related items together. This will allow consumers to select each variant from one product page rather than viewing each variant from its own separate listing.

Download Data Feed Template in the MS Excel (xls) format 13.3.1.Download each subcategory’s respective data feed to determine its required group-by properties.

Input each variant item 13.3.2.Each variant item needs to be inputted on its separate row and assigned its own unique values for the seller part #, manufacturer part #, and UPC. All items inputted should be real items NOT virtual items.


Setup variant item’s relationship 13.3.3.Consider the first variant item listed from the group to be the “parent” or “original” item. All other items are considered to be a “child” or “similar” item. Enter the parent’s seller part # into the child’s Related Seller Part #* field. The parent item should be an actual item for sale NOT a “place-holder” or virtual item. Leave the parent item’s Related Seller Part # field BLANK. Please note that additional new items may also be grouped into an existing group of related items using a data feed or via seller portal’s Create Similar Item feature.


Fill in ALL group-by properties 13.3.4.A “group-by” property is an item’s detail property that will be used as one of the variant attribute options that will allow consumers to select from one product page. Each subcategory has its own set of group-by properties. The Data Feed Template in the MS excel format will mark all of the subcategory’s group-by properties with header names in blue font. ALL group-by properties are required in order to group related items together. Even if you do not have any variant options for one of the group-by properties (i.e. Mens Shirts_Size shown in the image below) a value must still be provided. Only values found in the Detail Item Info – Values worksheet can be used for the respective group-by property field.



Download Data Feed



Final Product page with grouped items 13.3.5.The product page shows variant options for color and size.

Back to Top

13.4. Batch Update Items It’s essential to understand the Action field definition in order to properly batch update your items. If you only need to update your item’s pricing information, inventory, shipping and/or activation then you may want to consider using our Inventory Feed instead.

Download Data Feed Template with your items populated 13.4.1.For your convenience, you may also download the template(s) with your existing items already populated. This step is optional.

Review the Important Data Feed Instructions before any updates are made 13.4.2.

Change any item fields that need to be updated 13.4.3.Sellers are NOT allowed to update the following: Seller Part # Manufacturer Manufacturer Part # UPC Related Seller Part # SubcategoryID Please contact [email protected] to update any of your item’s information listed above




Download Data Feed



Set the Action field 13.4.4.

a) Set the Item’s Action field to “Update Item” to update the following fields: Website Short Title

Website Long Title

Product Description

Item Length

Item Width

Item Height

Item Weight(lb.)

Item Package

Proposition 65 (California)

Age 18+ Verification

Choking Hazard

All detail property fields (refer to Detail Item Info – Values).

b) Set the Item’s Action field to “Update Item Price and Inventory” to update the following fields: Currency

MSRP

MAP

CheckoutMAP

Selling Price

Shipping

Inventory

Activation Mark

c) Set the Item’s Action field to “Update/Append Image”: To update your existing images or to add new images.

d) Set the Item’s Action field to “Replace Image” :

To delete all your previously uploaded images and replace with the images provided in the Item Images field.

Save and Upload Data Feed13.4.5.



Download Data Feed



13.5. Upload Data Feed The data feed may be uploaded via Seller Portal or FTP.

Upload Data Feed via FTP


Upload to the following Directory 13.5.1.>Inbound/CreateItem

Upload Data Feed via Seller Portal



Click on the Upload File tab 13.5.3.






Download Data Feed



Click on the Upload button 13.5.6.Our system will begin to process your file. The time to process your file may vary depending on the current traffic on our system and size of you file.

Uploaded File Status and History 13.5.7.Once the file has been successfully uploaded, the system will begin to process. You can view the status of your data feed under this section.



Download Data Feed



13.6. Processing Result File

After the system has finished processing your uploaded data feed it will generate a processing result file. It can be downloaded from the Seller Portal or FTP.

To Download via FTP


Download from the following Directory: 13.6.1.>Outbound/CreateItem

To Download via Seller Portal




Upload File Status and History 13.6.4.Search through your list of uploaded data feeds.

Download 13.6.5.Click on the >> View Details link under the Download Link column to download the processing result file for the respective data feed.

Errors 13.6.6.The Processing Result File will include the item’s SubcategoryID, Seller Part #, Manufacturer Part #/ISBN, and UPC for items that failed with errors. The file will also include a small description of the error.



14. Manufacturer (View List/Request New)

All manufacturer/brand names must be pre-approved before they can be used to create an item. In Seller Portal, you can search through our database of accepted manufacturer names and/or submit a request to add a new one.

14.1. Manufacturer Page


From the Navigation panel 14.1.2. Click Manage Items i. Click Manufacturer ii.

14.2. View Accepted Manufacturer/Brands

Go to Manage Items>Manufacturer 14.2.1.

Click the Manufacturer List tab 14.2.2.

Search for manufacturer 14.2.3.Enter one of the following into the search box. a) Manufacturer ID (Newegg’s internal identification)

b) Manufacturer Name

c) Manufacturer URL

d) Manufacturer Support Email

e) Manufacturer Support Phone

f) Manufacturer Support URL

For best search results, enter a part of the manufacturer name instead of the entire name. (Ex. “Sony” instead of “Sony Electronics Inc.”).



14.3. Submit New Manufacturer Request We request sellers to only request manufacturer/brands that do not already exist in the manufacturer list stated above.

Go to Manage Items>Manufacturer Page 14.3.1.

Click Manufacturer Request tab 14.3.2.

Click the Add Manufacturer button 14.3.3.

Enter all requested information 14.3.4.

Submit request 14.3.5.a) Click “Submit & New” to submit request and add another manufacturer. b) Click “Submit & Close” to submit request and return to Seller Portal.

Marketplace Content team will review and process each request submitted.

14.4. Batch Manufacturer Request If you have many manufacturer/brands that do not exist in our manufacturer list and would like to batch create requests, please contact your account representative or Marketplace Content Team [email protected] for the batch manufacturer/brand request template. Fill out and send the completed template to Marketplace Content Team [email protected] for review and process.




Manage Order – Process Orders and Batch Ship

After a customer places an order, Newegg Marketplace will verify the payment information and order details. Once the order is verified, Newegg Marketplace will notify you by:

1. Sending a notification email to your default account. Please also check your seller account in Seller Portal for current order status.

2. For sellers that have an FTP account setup, Newegg will also upload an order file every hour to your directory >Outbound/OrderList.

Back to Table of Content

15. Order List

15.1. Order List page To access order list page in Seller Portal:


From the Navigation panel 15.1.2. Click Manage Order i. Click Order List ii.

15.2. View and Search Orders

Go to Manage Order>Order List page 15.2.1.The Order List page will show all orders placed.

(optional) To Process orders in batch, please refer to Batch Ship Orders.15.2.2.



Select the search option 15.2.3.From the pull-down menu, select one of the following options you wish to search for your order by: a) Order Number

b) Invoice Number

c) Customer Name

d) Seller Part #

e) NE Item #

f) Customer Phone #

g) Title Description

h) Manufacturer

Enter the search expression into the Input Keywords search box 15.2.4.

Click the Search button 15.2.5.Once you click the Search button, a list of items that match your search expression will be displayed.

(Optional) You can use the Advanced Search option to perform more complex searches. Click the 15.2.6.Advanced Search link to enable this option.


15.3. Process and Ship Order

Go to Manage Order>Order List page 15.3.1.

View and Search Orders 15.3.2.

Click the Ship button 15.3.3.Under the Action column, click Ship for the respective order to upload shipping information under the Order Detail page and complete order.

Order Detail Page

Under Order Content 15.3.4. Select the items to include in the i.

package (multiple packages may be generated).

Click Generate Package buttonii.

Unshipped Package List | Shipped Package List

Select the package’s Shipping Carrier 15.3.5.From the drop-down list, select the ship carrier (i.e. UPS). If the shipping carrier that is being used is not listed, select “Other” and enter the carrier into the text box.

Enter the Shipping Service 15.3.6.In the designated text box, enter the shipping service, such as “Ground”.

Enter the Tracking # 15.3.7.In the designated text box, enter the tracking # supplied by your shipping carrier. Please note that the Tracking # is not required if the Shipping Carrier is set to “USPS” and Ship Service is set to “First Class”. The same tracking # cannot be used for different order numbers.

Enter the correct Ship Date for the date you shipped the package. 15.3.8.

Print Package List 15.3.9.Click the Print link shown at the top-right corner of each package.


Save or Ship All Packages 15.3.10.a) Click the Save All Packages button to save the current package information. b) Click the Ship All Packages button to confirm and process multiple shipments

16. Batch Ship Orders

Orders may be processed in batch by using the Batch Order Shipping Template. The template may be downloaded and uploaded via Seller Portal or FTP.

16.1. Download Order Shipping Template The Order Shipping Template can be downloaded via Seller Portal or FTP.

Download Order List via FTP


Download Order List file from: /Outbound/OrderList 16.1.1.Order List files are generated every hour to include all orders made within the respective hour. If no orders were made then a file will NOT be generated.

Please note: Order numbers from our system are always unique. In general, orders should not appear in multiple order files; however, there are some situations in which a single order can be sent multiple times (e.g., past orders may be resent in the event of a system or network failure, or an additional file with all unshipped orders is requested, etc.). It is your responsibility to check order lists carefully to ensure that you do not process the same order twice.

Download Order List via Seller Portal

Go to Order List page in Seller Portal 16.1.1.Manage Order>Order List


Click the Batch Ship button 16.1.2.

Download File Template tab 16.1.3.After clicking the Batch Ship button, the portal will take you to the Download File Template tab under the Batch Ship page. Here, you can download the Batch Order Shipping Template/Order List.

Select the Template File Type (i.e. xls, csv, txt, xml) 16.1.4.Newegg Marketplace currently supports Batch Ship files in the following formats: Microsoft Excel, tab-delimited Text, comma-delimited CSV, and XML.

Download template with your unshipped orders populated in the file 16.1.5.To download your unshipped orders populated in the template: Check the box where is says, “Download template with your unshipped orders populated in the file?”

Please note: Order numbers from our system are always unique. In general, orders should not appear in multiple order files; however, there are some situations in which a single order can be sent multiple times (e.g., past orders may be resent in the event of a system or network failure, or an additional file with all unshipped orders is requested, etc.). It is your responsibility to check order lists carefully to ensure that you do not process the same order twice.


Click Download File Template button 16.1.6.

Please note that after your request is submitted, the system may take up to 20 minutes to prepare your templates if you checked the option to include all your unshipped orders.

Download File Template Status and History 16.1.7.Under this section, you can view the status and availability of your file(s). You can use the Refresh List button in the bar to update the status of your request. When the Batch Ship file is ready, you will receive an email notification. In addition, the Status will change to Update with a Download link available. Click the Download link to retrieve a Batch Ship file. Your browser will typically give you a choice of either open the file directly in an application, or saving it to disk. We recommend you save the file to disk for viewing offline.


Order Shipping Template Overview Regardless of the format you decide to use (xls, csv, txt, xml), it is highly suggested to download the template in the MS Excel (xls) format. The Excel Template includes the following worksheets that contain valuable information you will need to properly fill out the Batch Shipping file.

Instructions The Instructions sheet provides an overview of how to use the template including a detailed review of each field in the template.

BatchShippingUpdate This is the actual worksheet in which you enter your Shipping info, using the specifications listed in the Instructions tab. This worksheet contains column headings (field names) representing each of the fields in your Ship Notice file. It has color-coded column headers to indicate whether the field is required (red) or desired (black).


16.2. Complete Your Batch Shipping File

Make sure your heading/field names are exactly the same as the template’s 16.2.1.For example, the heading/field name for one of the required fields is “Seller Part #”. If your file’s heading/field name shows “Seller Part Number” or “Seller Part#”, your file will fail to process.

Make sure you enter the correct value for each required field 16.2.2.For example, the MSRP and Selling Price fields only accept numbers. If you add a dollar sign ($) before the number, your file will fail to process.

Tracking # 16.2.3.The Tracking # is required unless the Shipping Carrier is set to “USPS” and Ship Service is set to “First Class”. The same tracking # cannot be used for different order numbers.

Multiple Item-quantity Orders 16.2.4.An item that has been ordered with a multiple quantity must be shipped and processed entirely. Items may be shipped in multiple packages with different tracking #’s but the must be processed in the same file.

Multiple Item Orders 16.2.5.If a single order contains multiple items, multiple rows with the same order number will be created. If multiple items were shipped in the same package then they must be included in the same ship notice/batch ship file with the same tracking number. All items need to be processed to complete the order and receive payment.

Upload Batch Shipping File 16.2.6.


16.3. Upload Batch Shipping File The Batch Shipping File may be uploaded via Seller Portal or FTP.

To Upload Batch Shipping File via FTP


Upload Batch Shipping file to: >Inbound/Shipping 16.3.1.All successful batch shipping updates will be reflected in our system approximately within 5 to 10 minutes. When uploading files through FTP: We strongly recommend that you do not reuse the same file name for multiple files. Each file should have a unique file name to help our system identify the file as a unique file. Using the same file name may result in an unintentional file overwriting in our system, which may hamper your batch file processing time and updates.

To Upload Batch Shipping via Seller Portal

Go to Order List page 16.3.1.





Click the Upload button 16.3.5.All successful batch shipping updates will be reflected in our system approximately within 5 to 10 minutes.


Data Feed Settings – FTP

File Transfer Protocol (FTP) is a simple way for users to transfer files from one host to another host over the internet. Using FTP gives sellers an alternative method to sync their data feed operations with Newegg’s system which includes downloading and processing orders. The Data Feed Settings page will allow sellers to setup and maintain their FTP account on Newegg.

Section Overview

Setup/Manage FTP account FTP Directory Structure


17. Setup/Manage FTP account

17.1. Data Feed Settings Page To access Data Feed Settings Page via Seller Portal:


From the Navigation panel 17.1.2. Click Manage Account i. Click Data Feed Settings ii.

17.2. Ftp Settings The FTP account can be setup under the FTP Settings section. Sellers may also obtain the FTP login information and change their FTP password under the FTP Settings section.

First time users: Click the Request button to setup 17.2.0.FTP account

Enter the desired password that will be associated 17.2.1.with the FTP account

Re – enter Password for confirmation 17.2.2.



Select the FTP Order File Format 17.2.3.The file format must be selected in order to properly setup the FTP account.

Click the Save button 17.2.4.

17.3. FTP Order File Format When an FTP account is setup, Newegg will automatically generate an order list file every hour that will include all orders placed within that hour. It is required to set the FTP Order File Format to use an FTP account on Newegg. The generated order list will be available for sellers to download from the >Outbound/OrderList directory.

Select File Format (xls, csv, txt, xml) 17.3.1.


17.4. Inventory Snapshot File Sellers may request to have inventory snapshots automatically generated to download from their FTP account. You can specify the file format, generation start time, and generation frequency. The inventory snapshot file will be available for sellers to download on the >Outbound /Inventory directory.

First time users need to Setup/Manage FTP account 17.4.0.

Click the Request button to setup your Inventory Snapshot File 17.4.1.


Select the desired File Format (xls, csv, txt, xml) 17.4.2.

Select the File Generation Start Time 17.4.3.Select the start time that you would like the system to generate your Inventory Snapshot each day. Please note: depending on the amount of traffic on the system, the completion time may vary.

Select the File Generation Frequency 17.4.4.Select how often you want the file generated throughout the day. a) Every 4 Hours b) Every 8 Hours c) Every 12 Hours d) Every 24 Hours


File Location 17.4.6.The Inventory Snapshot File may be downloaded from the following directory: >Outbound/Inventory

Naming Convention 17.4.7.The Inventory Snapshot files will be named with the following convention: InventorySnapShot_YYYYMMDD_HHMMSS.xls


18. FTP Directory Structure

The FTP root directory (/) includes the following directories:

18.1. Inbound The Inbound directory and its inclusive subdirectories are designated for files that are uploaded by the seller. The Newegg system will scan and pull any appropriate file(s) from the Inbound subdirectories to process every 5 to 10 minutes.

CreateItem 18.1.1.This directory is designated for sellers to upload any Item Creation/Update or Existing Item Creation Data Feeds only.

Inventory 18.1.2.This directory is designated for sellers to upload their Inventory Feeds only.

Shipping 18.1.3.This directory is designated for sellers to upload their Batch Ship files that include tracking information only.

18.2. Outbound The Outbound directory and its inclusive subdirectories are designated for to download files that are generated and provided by Newegg. The files generated by Newegg include the processing result files, Inventory Snapshot files, and Order List files.

CreateItem 18.2.1.This directory is designated for sellers to download the processing result files for their processed Item Creation/Update or Existing Item Creation Data Feeds.

Inventory 18.2.2.This directory is designated for sellers to download the processing result files for their processed Inventory Feeds and the auto generated Inventory Snapshot file if set up.

OrderList 18.2.3.This directory is designated for sellers to download the Order List files that are automatically generated by Newegg every hour. Please note: if NO orders were made then an Order List file will NOT be generated.

Shipping 18.2.4.This directory is designated for sellers to download the processing result files for their processed Batch Ship files.

Back to Data Feed Settings


Index

A

Account Status ......................................................................... 4

B

Batch Processing ..................... See Data Feed Types & Formats

C

Create Items .......................................... See also Manage Items

1x1 Item Creation .............................................................. 14

Batch Item Creation ........................................................... 36

Refurbished Items .................................. See Item Condition

Variant Items .............................................. See Group Items

D

Data Feed Types & Formats ..................................................... 6

Existing Item Creation Data Feed ........................................ 6

Inventory Feed ..................................................................... 6

Item Creation/Update Data Feed ........................................ 6

Order Shipping Template .................................................... 6

Delete Item ............................................................................ 25

Download Items

All Item Information .......................................................... 36

Price, Shipping, Inventory, Activation Only ....................... 28

E

Errors

Inventory Processing Result File ........................................ 34

Processing Result File ........................................................ 47

F

Feeds ....................................... See Data Feed Types & Formats

FTP ......................................................................................... 60

G

Group Items

Batch Group Related/Variant Items .................................. 40

Create Similar Item ............................................................ 19

Group-By Property ..................................................... 16, 38, 42

H

HTML ...................................................................................... 10

I

Image Requirements ........................................................ 10, 39

Item Condition ....................................................................... 11

Item List ................................................................................. 23

M

Manage Items ........................................................................ 13

Manage Order ....................................................................... 50

Manufacturer..................................................................... 8, 48

MAP ................................................................................. 11, 12

O

Order ........................................................... See Manage Order

P

Parent/Child .................................................... See Group Items

Property Values ..................................................................... 38

R

Refurbished Items....................................... See Item Condition

Related Seller Part # .............................................................. 12

S

Seller ID .................................................................................... 4

Shipping Price ........................................................................ 10

T

Templates ............................... See Data Feed Types & Formats

Tracking Number ............................................................. 52, 57

Troubleshooting ........................................................ See Errors

U

Update Images ......................................... See also Update Item

Replace Image ............................................................... 9, 44

Update/Append Image .................................................. 9, 44

Update Items ........................................ See also Manage Items

Batch Item Update ............................................................ 43

Batch Upload Inventory .................................................... 28

Restrictions ........................................................................ 43

Update Item ........................................ 25, See also Item List

V

Variation Items ............................................... See Group Items

X

XML ......................................... See Data Feed Types & Formats

quick start integration guide - newegg · data integration guide 2.1. account status you can find...

Documents