Installation and configuring plug-in eBay Connector

The plugin connects your nopCommerce store with your eBay seller account. It imports the eBay orders into your store, sends the tracking numbers back to eBay and uploads your prices and stock quantities to your eBay items.

It's easy to configure the plugin. See pictures.

1. Open https://developer.ebay.com, sign in and open 'Application Keys'. Create the eBay application if you don't have it yet.
You will see two key sets - 'Sandbox' and 'Production'. Use the Sandbox keys to test the plugin and the Production keys for your live store.

2. Create the eBay token. Press 'User Tokens' next to your key set.
Select the environment - 'Sandbox' or 'Production'. Open 'Get a User Token Here', select 'Auth'n'Auth' and press 'Sign in to Sandbox' (or 'Sign in to Production'). Sign in with your eBay seller account and copy the token.
Do not select 'OAuth (new security)'. The plugin uses the Auth'n'Auth token.
The token is valid for about 18 months - see 'Expires' on this page. When it expires the plugin can't read the orders any more. Create a new token and paste it on the configure page again.

3. Install the plugin and open the configure page (menu 'FoxNetSoft' - 'eBay Connector' - 'Configure').

Enable 'Use Sandbox' when you use the sandbox keys and the sandbox token. Disable it for the production keys.
Select your 'eBay site' (ex. US).
Copy 'App ID (Client ID)' and paste the token into 'eBayToken'. 'Dev ID' and 'Cert ID (Client Secret)' are optional, you can leave them empty.

Enable 'Import Orders from eBay' ('Enable plugin' on the picture).
'Last updated' - the plugin reads the orders created after this date. Set the date from which you want to read the orders. It can't be more than 80 days ago, otherwise the plugin changes it to 20 days ago.

If eBay doesn't give the email of the buyer, the plugin uses 'Virtual email address for ebay's customer'. Enable 'Use one virtual customer for all eBay orders' if you want all eBay orders on one customer with this email.

'What to do if the product is not found'. 'Create New' creates a new unpublished product in your store. 'Use One Virtual Product' puts all unknown items on one virtual product. 'None' skips the item.
Enable 'Do not load products from eBay' ('Not load products from eBay' on the picture) if you want the orders with the amounts, but without the products.

Enable 'Send tracknumbers back to eBay' to send your tracking numbers to the buyer.
Enable 'Convert to primary store currency' if your eBay site uses another currency than your store (ex. USD on eBay and Euro in the store).
If eBay doesn't give the taxes, enable 'Calculate TAX using Nopcommerce'. The plugin uses your nopCommerce tax provider, or 'TAX percent for eBay' when eBay doesn't give the tax percentage.

'Select product key' - how the plugin finds your product for the eBay item. It compares the eBay SKU (Custom label) with the nopCommerce 'Sku', 'Id', 'Gtin' or 'Manufacturer Part Number'. Fill in the SKU on your eBay items, otherwise the plugin can't find the product.

4. Press 'Run now' under 'Manually run task for reading orders from eBay.' Or wait for the schedule task 'eBay Connector - Import orders', it runs each hour.
Open the list of orders. You will see the orders from eBay. Only the eBay orders with the status 'Completed' are imported.

5. Open one of the orders. The plugin reads all information - the order, payment and shipping status, the billing and shipping address, the products, the prices, the shipping and the tax. The eBay order ID is saved in the order notes ('eBayOrderId=...').

Add a shipment with the tracking number and mark it as shipped. The plugin sends the tracking number to eBay on the next run of 'eBay Connector - Import orders' and adds the order note 'Information. Tracking number has been sent to eBay.' If eBay rejects it, you will see the error in the order notes.
The carrier is taken from the shipping method of the order - USPS, UPS, FedEx, DHL, RoyalMail or Parcelforce. All other methods are sent as 'Other'.

The plugin removes the buyer's name, phone and street address from the imported eBay orders after 30 days ('Removed by eBay PII'). Print your labels and invoices before that.

6. Upload prices and stock quantities to eBay. Enable 'Upload stock quantities' and 'Upload prices'.
'Price Markup' adds a percentage to your nopCommerce price, ex. 20 for the eBay fees.
The schedule task 'eBay Connector - Update prices and stock quantities' runs once a day, or press 'Run now' under 'Manually run task for uploading prices and stock quantities to eBay.' The plugin sends only the values which were changed, and only for the products mapped to eBay items.

7. If you already have items on eBay, enable 'Enable sync products' and press 'Sync products'. The plugin loads your eBay items and maps them to your products using 'Select product key'. It doesn't create new products in nopCommerce.
You will find the mappings in the menu 'FoxNetSoft' - 'eBay Connector' - 'eBay Product Mapping'. There you can also add, revise, relist and end your fixed-price items on eBay. Map your categories to the eBay categories in 'eBay Category Mapping'.

8. The unregistered version is fully operational, but it imports only 50 orders. The trial period is 30 days. When the license expires the plugin stops importing the orders.
Enable 'Enable Debugging' if something doesn't work. Then you can download the log file with the button 'Download the log-file'.
Each store could use its own eBay account. Select the store in 'Multi-store configuration for' and check the override checkboxes.