This Version is Out of Date
You can find the updated Miva 10 Reference Guide here
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.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.
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:
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.
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.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.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.
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:
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.
|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.|
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.|
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.|
This field only applies when:
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:
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.
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.|
This field is not displayed until you select a Primary Category. Select the condition as you want it to appear in the eBay listing.
This field is greyed out until:
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:
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:
If your product has Variants, this field shows the images that are attached to the master product.
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.
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.
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.
If you've done all of the preparation (see An Overview of Marketplaces - eBay), creating a listing for a product without variants is easy:
eBay tells us how much the listing is going to cost, which you'll see in a message box:
See: edit product > Attributes tab > Generate Variants Button
In the edit product > Inventory Variants tab, click Edit Inventory
The fields in this tab control most of what the listing will look like.
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:
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:
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:
|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).
eBay tells us how much the listing is going to cost, which you'll see in a message box:
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.
|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.
|Share Inventory With eBay on Good Until Cancelled Listings:||
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.
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.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.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.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.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.
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.
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.
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:
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||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.|
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.|
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.