Instalation and first steps with nopcommerce ebay Plugin by nop4you.com 1
List of content: 1. How to install... 3 2. Configuration... 3 a. General Settings... 3 b. Site and ebaymotors... 4 c. Location, PayPal Email, ebay StoreName... 6 d. Settings import/export... 6 e. ebay Token... 6 f. Default product settings... 9 g. Return Policy... 9 h. Ship To Location... 10 i. Shipping Methods... 10 j. Payment Methods... 10 k. Templates... 11 l. Mass Export Products... 12 3. Categories Settings... 13 a. ebay Mapping... 13 b. ebay Store Mapping... 15 c. Product template... 15 4. Products Settings and Uploading... 15 a. Using templates or description... 16 5. How to add new product to ebay using nopcommerce... 17 6. Common problems... 19 a. Wrong language of error... 19 b. No location error... 20 c. PayPal and leaf category.... 20 d. Product specifications, attributes and branding... 21 e. Invalid starting price or Buy It Now... 27 f. EAN... 27 2
g. Listing is missing required item specific... 28 1. How to install Plugin should be installed before use. o o Unzip downloaded zip folder. Copy Misc.ebay directory to [your nopcommerce website directory]\plugins. In admin panel go to Configuration -> Plugins a) Click Reload list of plugins ; b) Install Plugin; 2. Configuration a. General Settings 3
Go to Plugins -> EBay -> Global Settings ; Fill all necessary parameters in Global Settings (please note: only ebay Token is required): b. Site and ebaymotors Basically, site is location of store. Notice, that ebay has also special category: motor. If you are selling only from that category, than you may selected as follows: 4
What if motor parts is only part of? Then you really should check 5
c. Location, PayPal Email, ebay StoreName Locations is your area. Nothing more, just it. PayPal Email PayPal is fully integrated with ebay. If you want to get payments via this processor, you really should place your email address here, this same you have registered at PayPal service. Last option is for people, who have own store with own categories on ebay. To fully integrated our plugin with ebay and your ebay store, place here name. d. Settings import/export Use manufacturer (brand) Product attributes Product specification Update stock Import order Set status Paid Crate new customer from ebay ebay this feature is avaible to qualified sellers who participate in the Discount Pricing program Check the size of the image Connect product with brand or manufacturer (ex. Selling console PSP, Sony) Ex. Shoe with size 7,8,9 and color: yellow and black Ex. Leather shoe Check to specify interval between update time Check to specify interval between importing orders from customers Import orders with status paid If checked, plugin compare email address from ebay and nopcommerce database, if not found creates new customer. If unchecked, all orders are made as a guest. Check it if you are using discount and using Discount Pricing program Check if you want to resize image to size using by ebay e. ebay Token ebay token can be generated on ebay site for developers: https://developer.ebay.com/join/ After registration go to your account: https://developer.ebay.com/, then go to Get your application Keys. In Menu go "My account" -> "application keys", and click "Generate Production Keys" 6
Please note: there is a difference between production and sandbox system. If you want to use Sandbox for tests you need to generate Sandbox Key. You will get DEVID, AppId and CertId. Now you can generate your ebay Token. Go to Configure Settings On opened website click User Tokens : 7
then Generate Token (Please note: login using your seller account, not developer!). In case of sandbox token, login using your sandbox account. Save token Done! 8
f. Default product settings Options here will be default for every product. Note, you may still edit details on product page. ebay price if you want to sell on ebay as a 105% of nopcommerce store price, type 105%, to make it 95%, type 95. ebay price BIN Buy In Now price. g. Return Policy 9
Set up ebay Return Policy parameters: h. Ship To Location Set up ebay Ship To Location parameters: i. Shipping Methods Set up ebay Shipping Methods and map them with nopcommerce definitions: j. Payment Methods 10
Set up ebay Payment Methods and map them with nopcommerce definitions: k. Templates You may prepare own design of products. For example you are able to add your store logo. To add template to product, you will need to open card, and proceed to ebay tab, where will be Template for Description dropdown menu with all available templates. 11
l. Mass Export Products This option is useful to send multiple products to specific category. List of category is available as a dropdown menu. Note: FixedPriceItem is not working with ebay price BIN! Get quantity from product: get quantity from product OR set new value as a Quantity. Template for description: choose available template, or leave it as a None to use description from product. Send product: choose action for situation when product is already sent. 12
Send as new create new auction. Revise/Relist if auction is running, update auction, if auction is closed, create new one. Skip skip this product. Override the setting of product: if checked, values from this tab will be send to ebay. If not checked, values of this tab will be omitted, values from product page will be send. 3. Categories Settings a. ebay Mapping There is extra tab on Category Details. Use it to map store categories with ebay ones. 13
To set up appropriate category just choose it from tree list. It will be saved automatically. Note: If you will not map category, products from that will not be able to export to ebay. Correctly category mapping: Category not mapped 14
b. ebay Store Mapping If your ebay Store using own categories, use this option to fully integrate ebay Store with nopcommerce. c. Product template To set default value for all products, choose product and use ebay tab. Choose template from dropdown list. 4. Products Settings and Uploading There is extra tab on Product Details. These fields will be filled automatically by plugin, after product publishing on ebay. 15
Setup all necessary ebay parameters. Please note: you need to be familiar with ebay sales. (more: http://pages.ebay.com/help/sell/rules.html). ebay Item id generated by ebay service; Product Variant you can select Product Variant name; Quantity sales quantity that you want to sell on auction; Start price fill start price (more: http://pages.ebay.com/help/sell/starting_price.html); Buy It Now Price fill Buy It Now Price (more: http://pages.ebay.com/help/sell/fixedprice.html); Handling time fill Handling Time (delivery time for item); Listing type choose Listing type (more: http://pages.ebay.com/help/sell/formats.html) Duration Time: choose auction duration time; Check extra paid highlighters ( Bold Title, Highlight, Best Offer ). After product publishing Link to product will appear. Buttons: Save save parameters (without uploading to ebay); Send upload product to ebay after correct uploading ebay Item id and Link to product will be generated. Revise update product parameters for uploaded (active on ebay) products, e.g. you want to change product price; Relist re-upload product to ebay (when auction duration time was up product is moved to Unsold list, you can re-send it to auction). a. Using templates or description How to choose description, or templates? Plugin has a priority list. As a most important is Template for Description available on ebay tab. 16
If None option is set, next plugin looking for ebay - Full Description also on ebay tab. If this option is empty, then plugin will use Full description on Product Info tab. 5. How to add new product to ebay using nopcommerce Choose product you want to sell. Go to tab ebay and click Send to ebay If you have everything done correctly, you may see on that tab success 17
At the bottom, you may see Link product To ebay, when you click, your browser will open new tab with new product to sell. 18
6. Common problems a. Wrong language of error First, error message, wrong language. You have not set your global settings. 19
b. No location error You have not set your location, at the global settings c. PayPal and leaf category. If you choose PayPal as a Payment Method, you need to put valid registered email, you have registered in PayPal Payment System. If you do not have it, just remove this option from Payment Method. Leaf category, go to Catalog -> Categories -> List and choose category to edit. Leaf category the simple difference best to see on the picture below. 20
d. Product specifications, attributes and branding If you will ever see an error message, read it carefully, it is saying where problem is. That`s a lot things to correct. You must create a manufacturer (Catalog -> Manufactures), add new. 21
Save and continue to add products. Add products to manufacturer. Choose from list, and save. 22
Next two options to modify. Adding attributes, which ebay asks. 23
When ready, back to product, add options. To add values, click on them. 24
Just two sizes. It`s example. Shoes (not only), you have in different size, color, and quantity. Here you may add quantity of each (here depends on size). The last, click ebay tab and send product to ebay. How it is working? 25
26
e. Invalid starting price or Buy It Now It happened when Start Price and Buy It Now price are set in auction option. Solution: Buy it now set to a value 0. f. EAN Some country s use GTIN, and some use EAN. This terms are equal. To set your EAN, just fill field at your products Product Info tab. 27
g. Listing is missing required item specific You set the Item Specific from attribute, but anyway you got error Listing is missing required item specific(s): Size. (This error might be displayed not only for Size, but for other options i.e. Shoe Size, Dress Size, etc ). Usually such situation appears for configurable products, when Size is presented in Item Specific and also as an option in variations. There is no value for custom attribute in configurable product as all values are kept in the associated simple products. So to avoid this error message, the Item Specific Size should be set not from Custom Attribute, but as Custom Value. You can put it some generic info (i.e. varies, L-M-XL, etc) 28