This Version is Out of Date
You can find the updated Miva 10 Reference Guide here
This is a more detailed view of how your Miva Merchant store works with eBay.
In your eBay store, make sure that you have created at least one of each:
You can also create your eBay store policies in the admin interface. See:
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.
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.
You can create eBay listings in several places. It doesn't matter which one you use
You can create listings for products with or without attributes:
After your eBay orders have been downloaded to the admin interface, you can view them like any other order, but see also:
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.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.
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.
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 below.
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.
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.
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:|
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:
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:
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.
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:
|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: