Reference Guide

Marketplaces

Marketplaces - eBay

1. Overview

2. Link MM Store to eBay Seller Account

3. Links Between MM Store & eBay Seller Account

4. Edit a Product's Listing Settings

5. Create a Listing Detail

6. Create Listing for Product with No Variants

7. Create Listing for Product that has Variants

Notes:

• If you want to view your eBay listings in the admin interface, you have to create the listing in the admin interface and upload it to your eBay store. If you create a listing in your eBay store, you won't be able to download it to the admin interface.
• You can view eBay orders no matter where the listing was created. If someone buys something in your eBay store, you can always view the order in the admin interface. It doesn't matter if the listing was created in your eBay store or in the admin interface. You can also configure which eBay orders you want to download. See Marketplaces - eBay > Settings tab > General section > Order Import field.
• If you want to experiment with the Miva Merchant / eBay interface without affecting your Miva Merchant store or your eBay store, you need:
• A Miva Merchant developer store. Please contact Miva Merchant support for more information.
• An eBay developer's sandbox

An Overview of Marketplaces - eBay

This is a more detailed view of how your Miva Merchant store works with eBay.

1. Check your eBay store policies.

In your eBay store, make sure that you have created at least one of each:

• Shipping Policy
• Payment Policy
• Return Policy

You can also create your eBay store policies in the admin interface. See:

Marketplaces - eBay > Policies Tab

2. Install the Marketplaces module in your Miva Merchant store.
3. Link your Miva Merchant store to your eBay store.
4. Create a listing detail.

A listing detail is like a high-level template for your eBay listings. It contains a number of variables, such as your eBay store's shipping, payment, and return policies. Generally, you only need a few listing details, and you only have to create them once.

5. Edit a product's eBay Listing Settings.

After you install the Marketplaces module and link your Miva Merchant store to your eBay account, you'll see a new tab when you edit a product:

> Catalog > Product tab > edit product > Marketplaces - eBay Listing Settings tab. The listing settings tab doesn't create the listing, but it controls most of the listing information. For example, this tab is where you decide if the listings for this product will be auction or fixed price. You only have to fill out the fields in this tab once. After that, you can go to the Marketplace - eBay Product Listings tab and create as many listings as you want.

6. Create the listing.

You can create eBay listings in several places. It doesn't matter which one you use

• > Marketplace - eBay > Listings tab.
• > Catalog > Product tab > edit product > Marketplaces - eBay Products Listings tab.

You can create listings for products with or without attributes:

• To Create a Listing for a Product with No Variants
• To Create a Listing for a Product that has Variants
7. Use The eBay Customer Relationship tab (optional)
8. View your eBay listings in the admin interface.
   • > Marketplaces - eBay > Listings tab
   • > Catalog > Products tab > edit a product > Marketplaces - eBay Product Listings tab.
9. View your eBay orders in the admin interface.

   After your eBay orders have been downloaded to the admin interface, you can view them like any other order, but see also:

   Associating Customers with Orders

To Link Your Miva Merchant Store to Your eBay Seller Account

1. Select > Marketplaces - eBay, then select the Accounts tab.



2. In the Accounts tab, click Add Account.
3. In the Add Account dialog box:



3.1. Environment: Set the environment to either Sandbox or Production. Production refers to your real eBay store. Sandbox refers to an eBay Developer's sandbox account, so that you can create test eBay listings without affecting your real eBay store. Both environments require an eBay seller account.

3.2. Error Language Country: After you link your Miva Merchant store to your eBay seller account, eBay can send error messages that will be displayed in the admin interface. If you set the Error Language Country to English, the eBay errors (if any) will be displayed in English.

3.3. Click Retrieve Account. A dialog box opens that lets you sign into your eBay seller account.

4. In the Sign In dialog box, enter your eBay seller account User ID and Password, then click Sign In.



4.1. Another dialog box will open, asking you to give the Miva Merchant software access to your seller account data. Click I Agree and close the popup window.



4.2. A Confirm Access message box will open, asking if you clicked the I Agree button that will give Miva Merchant access to your eBay account. If you clicked the "I Agree" button in the previous dialog box, click Yes here.

If you don't want to give Miva Merchant access to your eBay seller account, click No. Your Miva Merchant store will not be linked to your eBay seller account and you won't be able to use the Marketplaces - eBay features in the admin interface.



5. Now you'll see that the Add Account dialog box has been updated with your eBay seller account User ID. Click the Add button. Your Miva Merchant store is now linked to your eBay seller account.

To Update the Link Between Your Miva Merchant Store and Your eBay Seller Account

If you make any changes to your eBay seller account, such as changing your password, you must update the account link in the admin interface.

1. Go to > Marketplaces - eBay > Accounts tab.
2. In the Accounts tab, edit your eBay account link.



3. In the Edit Account dialog box, click Update Account. The admin interface will download the modified details of your eBay seller account.

To Create a Listing Detail

A listing detail is like a high-level template for your eBay listings. It contains a number of variables, such as your eBay store's shipping, payment, and return policies. For example, you could create a listing detail for the clothing that you sell, and another for electronics. Each listing detail might have a different return policy. When you create a product listing, the product listing references the listing detail.

Generally, you only need a few listing details, and you only have to create them once

1. Go to > Marketplaces - eBay > Listing Details tab and click Add Detail.



1.1. Detail Title: The name of the listing detail that you want displayed in the admin interface.

1.2. Account: The eBay seller account you want to associate with this listing detail.

1.3. Site: The eBay site (domain) where you want your product listings to appear. For example, if you set this field to "United Kingdom" and then you apply this listing detail to a product listing, that product listing would appear on eBay's UK site, but would not appear in your eBay US store page.

The site can also affect the categories that are available when you create the listing settings (see To Edit a Product's Listing Settings). For example, if you select China as the site, and then you select this listing detail when you edit the listing settings, the Primary Category drop-down list box will have different values in it because the list of categories for eBay's China domain are different from the category listings in eBay's US domain.

In version 9.0005, Miva Merchant added support for eBay Motors.

• Select eBay Motors from the Site list box
• As of 02/29/16, you can only sell car parts and accessories, not vehicles.

1.4. Currency: The currency that you want to use for the product listing.

1.5. Shipping From Zip/Postal Code: Enter the postal code where you ship from.

1.6. Shipping Policy / Payment Policy / Return Policy: These are policies that you've created in your eBay store. You must have at least one of each policy type before you can create a listing detail in the admin interface.

1.7. Calculated Shipping Policy: In this context "calculated shipping" means a shipping rate that is calculated by a carrier, such as FedEx or UPS, as opposed to a shipping rate that is calculated by Miva Merchant or eBay. For example:

• If you selected a Shipping Policy from your eBay store that is associated with a carrier like FedEx, you would check the Calculated Shipping Policy checkbox.
• If you selected a Shipping Policy from your eBay store that is not associated with a carrier, such as free shipping, flat rate, quantity or weight based shipping, you would not check this box.

1.8. Hit Counter: Choose whether you want a hit counter in your product listings.

1.9. Maximum Quantity Per Buyer: Limits the quantity of items that your customer can purchase from the same product listing. If the customer wants to purchase more of the same item, they would have to wait for you to create a new product listing. For example, let's say you are creating a Black Friday sale on t-shirts, but you want to limit purchases to three shirts per customer. You would set the Maximum Quantity Per Buyer to three, and then select this listing detail when you fill out the listing settings for the t-shirt (edit product > Marketplace - eBay Listing Settings tab > Detail list box.) When customers buy the shirt in your eBay store, they can't buy more than three, unless you create a new product listing.

1.10. Private Listing: Check this box if you want your eBay product listings to be private. When an eBay auction style listing is private, the winning bidder's name is not published in the listing. This checkbox has no effect on Fixed Price type listings.

1.11. Enable Store Categories: Please see To Use Your eBay Store Categories from the Admin Interface below.

2. When you finish filling out the fields in the Add Detail dialog box, click Add.

To Use Your eBay Store Categories from the Admin Interface

You can create categories in your eBay store. Customers can navigate to your eBay store and browse your inventory by clicking on one of your eBay store categories.

When you create an eBay listing in the admin interface, you can create the listing so that it will show up in one of your eBay store categories. If you do not use your eBay store categories in the admin interface, the listing will still show up in your eBay store, it just won't be visible when a customer clicks on one of your store categories.

1. Enable Store Categories in the listing detail.

1.1. You should already have created a listing detail. Edit the listing detail you are going to use. > Marketplaces - eBay > Listing Details tab > edit a listing detail

1.2. In the Edit Detail dialog box, make sure that the Enable Store Categories checkbox is checked.



2. Edit the product and select an eBay store category.

2.1. Go to > Catalog > Products tab > edit product > Marketplace - eBay Listing Settings tab.

2.2. In the Listing Settings tab, make sure that you have selected a Primary Category.

2.3. After you select a Primary Category you'll be able to select one of your eBay store categories. When you create a listing for this product, it will appear in your eBay store in the category that you select here.

To Edit a Product's Listing Settings

After you install the Marketplaces module and link your Miva Merchant store to your eBay store, there will be two new tabs when you edit a product:

• Marketplace - eBay Product Listings: this is where you generate the product listing. See:
• To Create a Listing for a Product with No Variants
• To Create a Listing for a Product that has Variants

• Marketplace - eBay Listing Settings: the fields in the listing settings tab control most of the listing information. For example, this tab is where you select the eBay category for the listing, and whether listings for this product will be auctions or fixed price.

You have to fill out the fields in this tab before you can generate an eBay listing. However, you only have to fill out the fields in this tab once. After that, you can go to the Marketplace - eBay Product Listings tab and create as many listings as you want.

1. Go to > Catalog > Products tab > edit product > Marketplace - eBay Listing Settings tab.

Detail:	You must create a listing detail before you can fill out the fields in this tab or create a product listing. See To Create a Listing Detail.
Account:	You must link your Miva Merchant store to your eBay account before you can fill out the fields in this tab or create a product listing. See To Link Your Miva Merchant Store to Your eBay Seller Account. If you have multiple eBay accounts configured in your Miva Merchant store, the Account field appears as a list box. If you only have one eBay account configured in your Miva Merchant store, this field is displayed as read-only.
Listing Type:	Choose Fixed Price or Auction.
Title:	Enter a title for the listing as you want it to appear in your eBay store.
Subtitle:	Enter a subtitle for the listing as you want it to appear in your eBay store.
SKU:	The value in this field is automatically taken from: Edit Product > Product tab > Details section > SKU field.
Item Lookup:	This feature is currently under development and should not be used.
Start Price:	The starting price for your auction type listing. If you set the Listing Type to Fixed Price", this field is greyed out.
Buy It Now Price:	Enter the buy it now price as it will appear in the eBay listing.
Reserve Price:	Enter the reserve price for your auction type listing. If you set the Listing Type to "Fixed Price", this field is greyed out.
Packaging Weight:	The value in this field is automatically taken from: Edit Product > Product tab > Details section > Weight field
Description Header/Footer:	You can create headers and footers for the eBay listings that you create in the admin interface. See Marketplaces - eBay > Product Header & Footers Tab.
Description:	The listing description, as you want it to appear in your eBay store.
Quantity:	This field only applies when: You set the Listing Type to "Fixed Price". If you set the Listing Type to "Auction" this field is greyed out. You are creating a listing for a product with no Variants. If you are creating a listing for a product that does have variants, you still have to enter a value here (the field is required), but you actually set the quantity in the Add Variation Listing dialog box: edit product > Marketplace - eBay Product Listings tab > Create Variation Listing button. For a product with no attributes, the number that you enter here will show up in the eBay listing as the quantity available. For example, if you set this number to 5, the eBay listing will show "Quantity Available: 5". When someone buys the item in your eBay store, the eBay listing is updated and will show that only 4 are available. If you are tracking inventory at both the store level and the product level in your Miva Merchant store: You'll see a message next to the Quantity field that tells you what your Miva store inventory is for this item. In our example below, "5" is the quantity that we want to show as available in the eBay listing for this product. Our Miva Merchant store has 50 of this item. When someone buys this item in your eBay store, the number that you entered in the Quantity field will drop by 1 and your Miva Merchant store inventory will drop by 1. See Inventory Management.
Primary Category:	Select the primary category for the eBay listing. After you select a Primary Category, the Listing Settings screen will refresh show more options.
Secondary Category:	Select the secondary category for this product. For example, a t-shirt could appear under clothing (primary category) and sporting goods (secondary category).
Store Category	The Store Category list box is not displayed until you enable it in the Listing Detail and select a Primary Category. Please see To Use Your eBay Store Categories from the Admin Interface.
Listing Duration:	Enter a duration for the eBay listing.
Condition:	This field is not displayed until you select a Primary Category. Select the condition as you want it to appear in the eBay listing.
Condition Description:	This field is greyed out until: You select a Primary Category. You set the Condition list box to either "New with defects" or "Pre-owned". According to eBay selling practices: http://pages.ebay.com/help/policies/selling-practices.html If you list an item that is not new and in perfect condition, you are also supposed to include a condition description where you list any defects or flaws.
Item Specifics:	This field is greyed out until you select a Primary Category. See To Use eBay Item Specifics.
Variation Image Types:	Use this field to add images to your eBay listing if the product has both Attributes and Image Types. If your product doesn't use Attributes and Image Types, use the Images field below. See also: Add Image(s) to the Option's Part Products Button
Images:	You must have at least one image attached to your Miva store product before you can create an eBay listing, and you have to select at least one of those images using the checkboxes in this field. The product pictures that you select in the Images field will be included in the eBay listing. For example: Go to edit product > Images tab. Click Add Image(s) and use the Image Picker dialog box to attach a picture to the product. Go back to the edit product > Marketplace - eBay Listing Settings tab. In the Images field, click the checkbox next to the product picture that you added in the Images tab. If your product has Variants, this field shows the images that are attached to the master product.

To Use eBay Item Specifics

Item Specifics are a set of eBay provided fields that describe your product in the listing. A group of Item Specific Fields is automatically associated with a listing as soon as you select an eBay Primary Category.

For example:

1. Go to your eBay store.
2. Create a new listing.
3. Set the Category to: Clothing, Shoes & Accessories > Men's Clothing > Casual Shirts.
4. Further down in the create listing page, you'll see a section for Add Item Specifics:



5. The values that you enter in these fields show up in the listing.



6. The same thing happens when you fill out the fields in the edit product > Marketplace - eBay Listing Settings tab.

6.1. You select a Primary Category

6.2. Miva Merchant downloads the eBay item specific fields for that category and displays them in the tab.



To Create Your Own eBay Item Specific Field

When you create a listing in your eBay store, eBay shows you the item specific fields for the primary category that you select. However, in addition to the default item specific fields, you can also create your own, and you can do the same thing in the admin interface.

1. Edit a product and select the Marketplaces - eBay Listing Settings tab.
2. Select a Primary Category. Miva Merchant will download the default eBay Item Specific fields for the Primary Category that you select.
3. At the top of the Item Specifics field list, enter a Name for your new field and a Value, then click Add. Your custom Item Specific field will show up in the listing that you (eventually) create for this product.



To Create a Listing for a Product with No Variants

If you've done all of the preparation (see An Overview of Marketplaces - eBay), creating a listing for a product without variants is easy:

1. Go to > Catalog > Products tab > edit product > Marketplace - eBay Product Listings tab.
2. Click Create Listing.
3. Miva Merchant will upload all of the information about the listing, mostly from the:
• listing detail,) and the
• edit product > Marketplace - eBay Listing Settings tab.

eBay tells us how much the listing is going to cost, which you'll see in a message box:



4. Click OK to create the listing.

To Create a Listing for a Product that has Variants

1. You may need to enable inventory tracking at the store level. See: edit product > Marketplace - eBay Product Listings tab > Create Variation Listing button > Quantity field.
2. Create a product that has Attributes
• You must enable inventory tracking at the attribute level in order to generate variants.
• You do not need to enable inventory tracking at the product level.
3. Generate Variants.

See: edit product > Attributes tab > Generate Variants Button

4. Set the inventory for the variants.

In the edit product > Inventory Variants tab, click Edit Inventory

5. Edit the fields in the edit product > Marketplace - eBay Listing Settings tab.

The fields in this tab control most of what the listing will look like.

6. Create the listing.

6.1. Go to the edit product > eBay Product Listings tab.

6.2. Click Create Variation Listing

6.3. In the Add Variation Listing dialog box:



Pictures Attribute:

This field shows you the Attributes that you created for the product. In our example, we have a t-shirt with Attributes for Size and Color. You have to select something from the Pictures Attribute field, but it has only a minor effect on the eBay listing. Basically, it creates a kind of link between thumbnail images and an Attribute list box in the listing. In our example, our t-shirt has Attributes of Size and Color. In the Pictures Attribute list box, we selected Color. After we generate the eBay listing, if the customer clicks on a thumbnail of a white shirt, the Color list box selection changes to "White". If the customer selects "Blue" from the Color list box, the blue shirt thumbnail is selected and the blue shirt will be displayed in the larger frame. In order to use the Pictures Attribute field, you must have images attached to the product Variants. One way to do this is with the Add Image(s) to the Option's Part Products Button.



Quantity:

If you create a listing for a product without variants, the quantity (number of products shown as available in the eBay listing) is set in the: edit product > Marketplace - eBay Listing Settings tab > Quantity field If you are creating a listing for a product with variants, the quantity is set in the: edit product > Marketplace - eBay Product Listings tab > Add Variation Listing dialog box > Quantity field. When you create a listing for a product that has variants, you have to let eBay know how many you have of each variant. For example, if you are creating a listing for a t-shirt that has three sizes and two colors, there are six variants: small blue medium blue large blue small white medium white large white If you set the Quantity field to Fixed, and then enter "5" in the text field, your eBay listing will show there are 5 shirts available in small/blue, 5 shirts available in medium/blue, etc If you want to use the Quantity as a Percentage: You must enable inventory tracking at the store level: > Catalog > Inventory tab > Track Inventory checkbox You must set an inventory level on the variants: edit product > Inventory Variants tab > Edit Inventory button In the Add Variation Listing dialog box, set Quantity to Percentage, then enter the percent of the variant inventory you want to make available in the eBay listing.



eBay listing will show that there are 5 shirts available for each variant (5 small/blue, 5 medium/blue etc.)

The eBay listing will show that the number of available shirts for each variant is 5% of whatever we set the variant inventory to in: edit product > Inventory Variants tab > Edit Inventory button. If we tell our Miva store that we have 400 shirts in small/blue, then our eBay listing will show there are 20 shirts available in small/blue (400 x .05 = 20).

7. In the Add Variation Listing dialog box, click Add.
8. Miva Merchant will upload all of the information about the listing, mostly from the:

• listing detail, and the

• edit product > Marketplace - eBay Listing Settings tab.

eBay tells us how much the listing is going to cost, which you'll see in a message box:



9. Click OK to create the listing.

To continue on, follow the appropriate links below:


1. eBay Settings

2. eBay Accounts

3. eBay Listing Details

4. eBay Log Console

5. eBay Policies

6. eBay Product Header & Footers