To use the AtomicUploader, each bit of data or "field" in your text file must be separated by
an ASCII TAB character. This is how the uploader software knows how to distinguish between your selling price
and your quantity (as an example). Any popular spreadsheet application like Microsoft Excel
is able to produce TAB-delimited text files suitable for use with AtomicUploader.
In addition to your actual data, a header must be included in each uploaded file which tells
our software which fields contain which types of data. Like the data itself, each field in the
header is separated or "delimited" by a TAB character:
The above example only shows the first six field values contained within the header. A
template file
is available for download which contains a useable header as well as a sample product line.
Click the link and select:
Below is a complete list of field header values shown in correct sequence, and the type of data
expected for each. The ones shown in bold red are required fields which cannot be
blank.
| itemname |
Enter the name of your item here. Avoid non-alphanumeric characters
(% ^ & @) as a general rule for best search visibility.
Max: 80 characters
Example: Acme Magic Widget, Rare Platinum Edition |
| qty |
The number of units you have for sale. It is important to keep this number as current
as possible to avoid oversold situations which may irritate your customers. Note: A zero (0) value entered here
will delete that item from your inventory until it is resubmitted with a positive quantity value.
Range: 0 ~ 9999
Example: 25 |
| price |
The lowest price at which you're willing to sell your item, in US dollars. Should consist only of
digits and a single decimal point. Dollar signs ($), commas (,) and other characters should not be entered.
If you would like to offer a "free" item, set the price here to "0.00".
Range: 0.00 ~ 9999999.99
Example: 79.95 |
| condition |
A numeric value which corresponds to the condition of your item. This should be set as
accurately as possible to assure no disappointments upon delivery to your Buyer.
- 1 = Brand New (still sealed in original packaging, never used)
- 2 = Used - Like New
- 3 = Used - Excellent
- 4 = Used - Good
- 5 = Used - Fair
- 6 = Used - Non-functional
- 7 = Refurbished
- 8 = Vintage
- 9 = Antique
- 0 = See Description
Range: 0 ~ 9
Example: 2 |
| mfr |
The manufacturer of your item. (If software or a book, enter the publisher here). Not a
required field, but recommended, since Buyers will be able to find your item easier when searching
products by manufacturer.
Max: 35 characters
Example: Black & Decker |
| shiptime |
The number of days after order receipt, that you agree to ship your product. If you ship within 24 hours,
enter a zero (0) here. A numeral five (5) = 5+ days.
Range: 0 ~ 5
Example: 1 |
| shipto |
The geographic region you are willing to ship your product to.
Options:
- Worldwide
- USA 50 States
- USA Lower 48 (all states except Alaska & Hawaii)
- USA/Canada
- USA/Canada/Mexico
- Originating Country Only
- Local Pickup Only (if you cannot/will not ship the item)
Example: USA Lower 48 |
| shipping_reg |
The price you charge for economy domestic shipping. Typically this will be
USPS Media Mail, 1st-Class Mail, UPS Ground, or Fedex Ground. Only digits and a
single decimal point should be entered. No commas (,) dollar signs ($) or other characters
are allowed. Note: Set to "0" for Free Shipping.
Range: 0 ~ 9999.99
Example: 4.95 |
| shipping_exp |
The price you charge for domestic Express shipping, typically Fedex or UPS 2-Day Air, or
USPS Priority Mail Express. Leave blank if you don't offer Express shipping.
Range: .01 ~ 9999.99
Example: 14.00 |
| shipping_intl |
The price you charge for shipping outside your country of origin, typically Postal Small Packet Airmail or UPS/DHL/Fedex
International Air. Leave blank if you don't offer International shipping.
Range: .01 ~ 9999.99
Example: 24.50 |
| method_reg |
The shipping method you use for domestic, economy shipping.
Options:
- USPS 1st-Class Mail
- USPS Priority Mail
- USPS Ground Advantage
- USPS Media Mail (Books, software, DVDs, etc)
- UPS Ground
- Fedex Ground
- Truck Freight
- Ground
- Air
- Canada Post
- Local Pickup
- Digital Delivery
Example: USPS 1st-Class Mail |
| method_exp |
The shipping method you use for domestic, Express shipping. Leave blank if you don't offer Express shipping.
Options:
- UPS 3-Day
- UPS 2-Day
- UPS Overnight
- Fedex 3-Day
- Fedex 2-Day
- Fedex Overnight
- DHL Express
- USPS Priority Mail
- USPS Priority Mail Express
- XpressPost
Example: DHL Express |
| method_intl |
The shipping method you use for International (foreign) shipping. Leave blank if you don't offer International shipping.
Options:
- USPS 1st-Class Mail International
- USPS Priority Mail International
- USPS Priority Mail Express Intl
- Fedex International Air
- UPS International Air
- DHL International Air
- XpressPost International
- Canada Post International
- Other International Air
- Digital Delivery
Example: Fedex International Air |
| image |
The URL location of your item's primary image. This should be the full URL, beginning
with "http://". Not required, but highly recommended, since studies have proven that
images sell products! All images should ideally be more than 500 pixels in width.
Allowable image types: .jpg .gif and .png NOTE: Images hosted on PhotoBucket.com will
be rejected. Only non-interference image hosts may be used.
Max: 150 characters
Example: http://www.imagehost.com/images/widget1.jpg |
| image_2 |
The URL location of your item's 2nd image.
Max: 150 characters
Example: http://www.imagehost.com/images/widget2.jpg |
| image_3 |
The URL location of your item's 3rd image.
Max: 150 characters
Example: http://www.imagehost.com/images/widget3.jpg |
| image_4 |
The URL location of your item's 4th image.
Max: 150 characters
Example: http://www.imagehost.com/images/widget4.jpg |
| image_5 |
The URL location of your item's 5th image.
Max: 150 characters
Example: http://www.imagehost.com/images/widget5.jpg |
| image_6 |
The URL location of your item's 6th image.
Max: 150 characters
Example: http://www.imagehost.com/images/widget6.jpg |
| upc |
The UPC or ISBN barcode number of your product. Entering this number will make your
items highly visible, as shoppers will be able to see your listings when they do price
comparisons for identical items from competing vendors. Should be entered without spaces, dashes
or other special characters. Only a contiguous string. UPC numbers are typically 12 digits, while
ISBN numbers are typically 10 or 13 digits, and are used to identify books.
Example: 001235557825 |
| sku |
Stands for "stock keeping unit". A unique product identifier used to differentiate your
item from all others in your inventory. Can be a combination of alphanumeric characters,
spaces, hyphens, underscores and forward slashes. Must be unique to a particular product, and cannot
duplicate other SKUs in your inventory.
Max: 55 characters
Example: WIDG-07blu |
| description |
Your full product description. If it contains quotation marks within the body of the text,
the entire field must be enclosed by quotes ("..."). Any embedded quotation marks
must then be "escaped" by converting them to double quotes ("") or double apostrophes (''). Most
spreadsheet apps like Excel do this automatically, but you should verify this by viewing
the upload file after it's created by your spreadsheet.
The description text also should not include any line breaks, line feeds, or
carriage returns. It must all be included on a single, unbroken line within your upload file.
Basic HTML permitted, including:
<p><br><b><i><ul><ol><li><blockquote>.
Max: 10,000 characters
Example:
"This <b>beautiful</b> chrome-plated widget certainly isn't short on features:
<ul>
<li>Upper and lower lookback mirrors
<li>Inner thermal barrier
<li>15"" bottom feeder lever
<li>your choice of purple, red, or black side marker plates
</ul>
<p> Only a few left in stock, so order now!"
|
| notes |
Any additional information you'd like to add which isn't covered in the description. It
could be a note about how fast you ship, or about a unique detail of the product, or
how long you've been in business, etc.
Max: 80 characters
Example: We ship same day! See our store for more discounts. |
| specs |
Product attributes for your item. This might include the item's shipping weight,
color, size, etc. Entering this information can enhance your product's visiblity in Zzuss.com searches by using the data
as additional attributes. Each attribute group must be separated by a pipe (|) symbol. Note: To insert Youtube videos into your
listing, just copy the video identifer string (the part that comes after ?v=).
Options:
- Age Range
- Artist
- Color
- Gender
- Length
- Material
- Model #
- Part #
- Size
- Weight
- Width
- Youtube
|
Parameter
|
Example
|
|
years
|
6-12
|
|
|
Kurt Cobain
|
|
|
Red
|
|
|
Female
|
|
inches
|
17.5
|
|
|
Velvet
|
|
|
iPhone 3G
|
|
|
J12-4007-15
|
|
|
XL
|
|
pounds
|
1.2
|
|
inches
|
5
|
|
11-char video ID
|
_O2aVaqKD7g
|
Max: 12 fields, 255 characters total
Example: Length: 7|Youtube: 34_gXl39aQr|Gender: Unisex |
| warranty |
Detailed warranty information about the product.
Max: 255 characters
Example: 180-day factory warranty provided by Black & Decker |
| reg_price |
The regular or "retail" price of your item. Entering a value here will create
the addition of a "Savings" quote on your product page, showing the dollar amount a Buyer
is saving vs. paying the item's regular price. Price must be set higher than your item's
price value. As always, no dollar signs, commas or other characters besides numerals
and a single decimal point.
Range: .01 above price ~ 9999999.99
Example: 109.99 |
| sale_expdate |
When used in conjunction with the reg_price field, creates a red "On Sale" sign
on your product page, as well as the expiration date of the sale. On this date, the price defined
by your price field will automatically switch over to the reg_price value. Sale expiration
dates can be extended by changing the date in future uploads, or by manually editing the
item from your Inventory page. Date must be entered using format: YYYY-MM-DD
Example: 2021-12-31 |
| category |
Primary shopping category for your product.
Options:
- Art
- Automotive
- Baby
- Books
- Camera & Video
- Cellular
- Clothing & Accessories
- Collectibles
- Computers
- Crafts
- Dolls & Bears
- Electronics
- Food & Nutrition
- Health & Beauty
- Home & Garden
- Jewelry
- Movies & TV
- Music
- Office & Industrial
- Pet Supplies
- Software
- Sports & Outdoors
- Sports Memorabilia
- Tools
- Toys & Hobbies
- Video Games
- Everything Else
- Bargain Basement
Example: Toys & Hobbies |
| subcategory |
Secondary, sub-category for your product. This is a more specific subset of
the main category, designed to make searches for specific products more accurate. A
complete list of categories, subcategories and sub-subcategories is available for download.
Example: Gadgets & Widgets (as a subset of Electronics) |
| subsub |
Tertiary level sub-subcategory for your product. This is a more specific subset of
the subcategory field, designed to add an additional layer of definition to your product's item type.
Example: Turbo Widgets (as a subset of Gadgets & Widgets) |
| storecat |
A custom category which will be visible to shoppers on your Storefront page. This category can be anything of your
choosing, and allows you to customize a buyer's browsing experience by directing them to specific areas of your store that might not
be covered by our standard category structure.
Example: Honda Brake Pads |
