Reference Guide

Marketplaces

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.

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 Appendix 7: 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:	The purpose of the Variation Image Types field is to let you upload images to an eBay listing for a product that uses both Attributes and Image Types. You can add images to product Variants using Image Types. One way to do this is by using the Add Image(s) to the Option's Part Products Button. If your product variants use Image Types, select the Image Types that you want to include in the eBay listing. For example, let's say that you have a t-shirt that comes in: Size: small Color: blue Create an Image Type called "Front" Edit the variant, small blue shirt and select the Images tab. Upload an image of a blue shirt and assign it to "Front". In the Variation Image Types field, check the box next to "Front" When you create an eBay listing for the shirt, the image you attached to the small blue variant will be included in the listing.
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:



• 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:





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.



The 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.

Marketplaces - eBay > Settings

Marketplaces - eBay > Settings Tab > General

Order Import:	When a customer buys something in your eBay store, the order is downloaded (almost instantly) to your Miva Merchant store. But you can use this field to control what orders from your eBay store will be downloaded to your Miva Merchant store. Your eBay orders can be viewed and edited in: > Order Processing > Orders tab. Do Not Import eBay Orders: no orders from your eBay store will be downloaded. Import eBay Orders if at Least One Matching Product is Found: if the eBay order contains at least one product that is in your Miva Merchant store, the order is downloaded. Import all eBay Orders: All orders from your eBay store are downloaded, even if they are for products that do not exist in your Miva Merchant store.
Allocate Inventory When a Listing is Posted:	This checkbox is only used if you are tracking inventory in your Miva Merchant store. See Appendix 7: Inventory Management. If you don't check this box, your Miva Merchant inventory gets decremented when you download orders from eBay. If you check this box, your Miva Merchant inventory is decremented when you create an eBay listing.
Share Inventory With eBay on Good Until Cancelled Listings:	If you don't check this box, your Miva Merchant store inventory is not changed, even if someone purchases the product in your eBay store. If this box is checked, your Miva Merchant store inventory is decremented when someone buys the item in your eBay store.

Marketplaces - eBay > Settings Tab > Custom Fields

It will be a lot easier to understand this section if you read To Use eBay Item Specifics first.

When you create an eBay listing (actually when you select a category for your listing) eBay shows you a list of descriptive fields that are appropriate for the product. For example, if you are creating an eBay listing for a shirt, eBay asks you to fill out fields like the shirt brand and the sleeve length.

If you sell the same shirt in your Miva Merchant store, you might wonder how you can get the eBay Item Specific fields to show up in your Miva store. That way, customers see the same information about the product, regardless of which store they are looking at.

The purpose of the Custom Fields section is to "link" eBay Item Specific fields in your eBay store listings with custom product fields in your Miva Merchant store product pages.

• You can set the value of the Custom Field and the eBay Item Specific field will have the same value.
• The eBay Item Specific fields show up in your Miva Merchant product pages.

To Link eBay Item Specific Fields to Custom Fields in Your Miva Merchant Store

1. Create a product in your Miva Merchant store. In our example, we'll create a red Hawaiian shirt.
2. Fill out the fields in the edit product > Marketplace - eBay Listing Settings tab.

If you want, you could fill out the fields in the listing settings tab after you create the custom field. However, you do need to know the exact name of the eBay Item Specific field that you want to duplicate in Miva Merchant. There's several ways to do this, but one way is to fill out the fields in the listing settings tab.

See To Edit a Product's Listing Settings.

When you select a Primary Category in the listing settings tab, Miva Merchant will download the Item Specific fields for that category. For our Hawaiian shirt, we set the Primary Category to:



As soon as we selected this Primary Category, Miva Merchant downloaded the eBay Item Specific fields for men's casual shirts:



One of these fields is "Brand". This field exists in the eBay listing, but it won't show up when the customer looks at the shirt in our Miva Merchant store.

3. Create a custom field in Miva Merchant.

3.1. Go to > Utilities > Custom Fields tab.

3.2. In the custom fields tab, click Add Custom Field



3.3. Go to > User Interface > Pages > edit page PROD > Page tab > Product Display Layout section.

3.4. Under Custom Fields, select the custom field that you just created and click Select, then click Update.



4. Link the custom field to the eBay Item Specific field

4.1. Go to > Marketplaces - eBay > Settings tab > Custom Fields section. The custom field that you created will show up.

4.2. Type in (or copy/paste) the exact name of the eBay item specific field and click Update.



5. Enter a value for the custom field.

5.1. Edit a product and select the Custom Fields tab.

5.2. We'll edit our Hawaiian shirt, enter a value for the Brand field, and then click Update.



6. Update the Listing Settings tab

6.1. Edit a product and select the eBay Listing Settings tab

6.2. Delete the value in the Brand field (if any), then click the Update button.



7. Now product pages in our Miva Merchant store will display the Brand field, and the Brand field in our Miva Merchant store is linked to the Brand field that we'll use for eBay Listings for this product.



Notes About Linking Custom Fields to eBay Item Specific Fields

• The update works in one direction: The process described above copies the field value from the Custom Fields tab to the Marketplaces - eBay Listing Settings tab, but not the reverse. If you change the field value in the listing settings tab, the value in the Custom Fields tab will not be updated.
• If you change the custom field value, you must update the listing settings tab. For our Hawaiian shirt example, we went to the Custom Fields tab and set the Brand to "Miva". If we wanted to change the brand for our shirt, we would:
1. Edit the shirt and select the Custom Fields tab.
2. Change the value for Brand and click Update.
3. Select the Marketplaces - eBay Listing Settings tab.
4. Delete the current value for Brand and click Update

Marketplaces - eBay > Accounts

There's a number of things that you need to do before you can create an eBay listing from the admin interface. See An Overview of Marketplaces - eBay.

One important task is to link your Miva Merchant store to your eBay store, and you do that in the Accounts tab. See To Link Your Miva Merchant Store to Your eBay Seller Account.

Marketplaces - eBay > Listing Details

A listing detail is like a high-level template for the eBay listings you are going to create. For example, a listing detail is where you select the shipping, payment, and return policies. Generally, you only need a few listing details, and you only have to create them once. See To Create a Listing Detail.

Marketplaces - eBay > Listings

After you have taken care of the preliminaries (see An Overview of Marketplaces - eBay) you can create an eBay listing from the admin interface. There are two places where you can do this:

• > Marketplaces - eBay > Listings Tab Here you can create a listing for any of your products and see all of the listings that you've created
• > Catalog > Products tab > edit product > Marketplaces - eBay > Product Listings tab Here you can create a listing for the product you are editing and view the listings only for that product.

The functionality is basically the same in both tabs.

Listings	The Listings button reveals a drop-down list with the following options, which are described below. Create Listing Create Variation Listing Link Listing Create Miva Merchant Product(s)
Create Listing	See To Create a Listing for a Product with No Variants
Create Variation Listing	Use this button if you are creating a listing for a product that has Variants. See To Create a Listing for a Product that has Variants.
Link Listing	This option allows you to link an existing eBay listing to a Miva Merchant product. Enter the Miva Merchant product code in Link Listing dialog. The Product Name is filled in automatically. When you click Add, the Listing Lookup dialog appears showing the eBay listings (see below).
Create Miva Merchant Product(s)	This option allows you to look up existing eBay product listings to create Miva Merchant product listings. Select this option and a Listing Lookup dialog appears with available eBay products.
Update All Listing Details	If you change a listing detail, you have to use the Update All Listings Details button to "push" the changes up to the listings in your eBay store.
Get Orders	eBay order are automatically downloaded, basically in real-time, from your eBay store. However, if there is some delay with an eBay order being downloaded, you can click the Get Orders to force a download.
Update Shipping	If you edit an order in the admin interface that has been downloaded from your eBay store, and you change the order status to Shipped, the change is automatically uploaded to your eBay store. If you use a third-party tool to change the order status, such as ShipWorks, the change is automatically made in the admin interface, but you have to manually update the status in your eBay store. Using a third-party tool, change the status of an eBay order to Shipped. In the admin interface, go to: edit product > Marketplaces - eBay > Listings tab Click Update Shipping.