How do I integrate my Store with eBay?

The eBay listing module allows you to list your Shift4Shop store's products directly on eBay where the products may be auctioned or bought outright using eBay's Buy it Now options. Furthermore, as your products are ordered on eBay, the orders can be sent to your Shift4Shop store's Online Store manager where you can process the orders from one centralized location.

The procedure of listing your Shift4Shop store items on eBay involves first granting access to eBay's API from your store. Then, after API access has been given, you will create a special listing template that will be used to display your items on eBay. Finally, you will designate which items to list on eBay, how long they will be available, and how much they will sell or begin bidding for.

This article will help you set up the eBay listing integration.

Granting API Access
Back to top

The integration between your Shift4Shop store and eBay is made possible through a special API app created for Shift4Shop users. The first step in the process of integrating your store is to grant the necessary API access to your eBay account.

To begin, follow these steps:

1. Log into your Shift4Shop Online Store Manager.
2. Using the left hand navigation menu, go to Modules
3. Use the search bar at the top and search for eBay to view the module

When the module appears, click on the settings button. You will see a series of links listed. If you have not yet granted API access, clicking on either of these links will take you to a page with a button labeled "Grant Access."

4. At the top left of the page, select the eBay environment you would like to use. (*See Additional Information below)
5. Click on the Grant Access button

You will now be redirected to the eBay login page.

5. Log into your (sandbox or production) eBay account.

You will see a page on the eBay interface allowing you to grant the access. Click "Agree" to continue and you'll be returned to your Shift4Shop Admin.

You have successfully granted access to eBay's API from your store.

Configuring Your Store's eBay Settings
Back to top

Here, we will go over your basic module settings. Once access to eBay's API has been granted, your eBay settings page will refresh with additional options to toggle. However, if you need to revisit the page later, use the following steps.

From your Shift4Shop Online Store Manager:

1. Use the left hand navigation menu and go to Modules
2. Use the search bar at the top to search for "eBay" and view the module
3. Click on the "Change Settings" link

You will see a page with the following sections:

eBay Account Integration

At the top of the page you will see the Authentication Status and its validity, its expiration and the last time synchronization of your integration took place. You can also click on the "Perform a check" link to synchronize the integration on demand.

Settings

On the right-hand side of the eBay Account Integration section, you'll see an area called "Settings" with a series of checkboxes. These are:

• Enable eBay integration
  Turn on the eBay integration for your store's products.
• Allow stock to be updated when listing on eBay
  If checked, this setting will remove the quantity of items listed on eBay from your Shift4Shop store's inventory.
  In other words, if you have 10 units on hand of a particular item in your store, and you list 3 of them on eBay, this checkbox will update your store's inventory to reflect 7 units on hand, since 3 of them are designated for listing on eBay.
• Enable eBay Motors Listings
  Use this setting if you will be listing items on the eBay Motors service for car parts.
• Send synchronization results to e-mail
  Use this field to specify the email address to which syncronization logs will be sent to.
  Syncronization occurs aproxmiately once every hour.

eBay Orders Management

The next section of the page will contain settings for how your eBay orders are managed on the Shift4Shop store.

• Get all eBay orders
  Select this option if you would like all of your eBay orders to be transfered to the Shift4Shop store.
  Leaving the box unchecked will only import eBay orders for products you are listing from the Shift4Shop store.
• Consider eBay Orders in Sales Reports
  This checkbox will factor in eBay orders as part of your Shift4Shop store's built-in sales reporting.
  Be aware that this setting will correlate with the preceeding setting of getting all orders from eBay.

• Set the order Date to the date the order is marked as Paid on eBay
  This checkbox will set the imported order's date to the date when it was marked as "Paid" on eBay

Below the these checkbox options, you will see a link labeled:

• Manage Payment Methods Mapping
  Clicking this link will display a pop up window with eBay payment options on one side and your store's payment methods on the other.
  This window allows you to map the payment methods used on orders coming from eBay, and assign (or "Map") them to your Shift4Shop store's payment methods for reporting and visuals.

Finally, below the mapping link, you will see a small text field labeled:

• Use this Prefix for eBay orders
  This allows you to specify a special prefix that will be used on orders being imported from eBay for reference.
  For example, your store's regular orders may be listed with ab-1234 as the order number, but you'd like your eBay orders to be something like eBay-AB-1235, etc. In this case, you'd enter the prefix as "eBay-"

eBay Store

If you have an actual eBay store, this next section will allow you to pull category structure data and information from that store to your Shift4Shop store. This can be useful if you would like to have your Shift4Shop store's category structure match the categories in your eBay store.

Header & Footer

These two areas will let you add a header and/footer to your product descriptions when the items are listed on eBay. For example, a logo or some sort of reference to your Shift4Shop store.

Both the header and footer windows can be populated with raw HTML code, or you can use WYSIWYG to format things more easily.

Once you have toggled your necessary settings, click "Save" at the top.

eBay Listing Templates
Back to top

The next portion of the process involves setting up your eBay product's listing template which is a set of variables that will be used by the eBay listing. During this process, you will configure a series of settings that allow you to control how the product will be viewed on the eBay site, the purchasing and shipping options it uses and several other factors. When designating products to be included on eBay, you will use the created template to display it on eBay's pages.

To begin creating an eBay listing template, follow these steps.

From your Shift4Shop Online Store Manager:

1. Use the left hand navigation menu and go to Modules
2. Use the search bar at the top and search for "eBay" to locate and view the module.
3. Click on the "Listing Templates" link
4. Click "+ Add New" at the top right of the page to begin creating a new eBay Listing template.
5. Name your template (this will be a name that is easily referenced for when you assign it to individual products)
6. Select the eBay Web Site that the product listing will be used on

General Tab
Back to top

When selecting the eBay web site to use for the template, some additional settings will appear below the name and web site selectors. These settings are:

• Hide the bidder's user id on list
  Marking the "Yes" checkbox will hide bidder usernames from being listed on the item when bids are placed.
• Make this the default template
  Select this checkbox if you'd like to make this the default template selection for all of your products when it comes time to list them.

Below these two checkboxes, you will see a section where you can set the eBay categories where your products (using this listing) can be found.

• Primary eBay Category
  Click the "Change" link to specify the primary eBay Category taxonomy that the products using this template will use.
  This will help eBay users find your products easier.
• Secondary eBay Category
  (optional) Click the "Change" link to specify the secondary eBay Category taxonomy that the products using this template will use.
  (If using eBay Motors, only the primary eBay category will be allowed.)

• Use eBay variations
  This setting will only come up for certain eBay categories and it will affect the way products with Advanced Options are listed on eBay.
  • If marked "Yes" then the product will be listed as one product with each advanced option related to a variation on eBay
  • If not marked, each advanced option will be listed as its own individual product on eBay.
• Listing Duration
  Select the number of days the listing will be active on eBay.
• Measurement System (Only if listing on ebay.ca or ebay.co.uk)
  Select whether product measurements will reflect Metric or Standard measurement units.

After setting and selecting the above configuration option, you will be done with the general settings of the listing template. You should also see a series of tabs at the top of the page for Specifics, Pricing, Payment, etc.

Next we'll describe these tabs and the settings found within them.

Specifics Tab
Back to top

This tab will contain a series of item specifics and variantions that you can select for the eBay listing.

The Specifics Tab will be split into two halves. At the top you will set Item Specifics and at the bototm you will set Variations.

Item Specifics will usually be things like Brand and country of manufacturer.

For Specifics, your selection choices will be either specifics from eBay or those present on the product in your Shift4Shop store from the various custom fields.

Variations will typically be things like options and features of the item.

For Variations, your selection choices will be either variants directly from eBay or those present on the product in your Shift4Shop store from your store's product option tables.

Note that the Shift4Shop store variations will be based on options set for all products on your store - meaning that all of your store's option sets will be listed when selecting variations from your Shift4Shop store. In other words, if you have some products that use color option sets as well as other products that use size option sets, they will all be listed in the "Use Cart" set of variations.

When it comes time to list the actual items however, you will have the ability to specify which option sets are used for the product.

Pricing Tab
Back to top

The Pricing Tab will let you set how the template will list pricing for its assigned items when listing them on eBay.

The drop down labeled "Select the pricing method" will let you select whether products using this template will be available for "Auction" or "Buy it Now" purchase.

Auction

The following configuration options will be listed when selecting the "Auction" method.

• Starting Price
  These settings are available to set the Starting Bid price on items using this template.
• Reserve Price
  Settings in this section are available to set the bidding's Reserve price which is a minimum bid amount you can designate on products using this template. If the item's reserve is not met during bidding, the seller is under no obligation to sell the item. Buyers will not see the reserve price. Rather, they will see if/when the reserve is met.
• Buy it Now Price
  As part of the Auction pricing method, you can also designate "Buy it Now" pricing options which allow eBay users to purchase the item outright instead of bidding on it.

Each of the pricing methods listed above will have the following options available:

• Same Price
  This will set the product's price to the same as the product's current pricing on your Shift4Shop store (at the time of listing).
  If the item is on sale, it will be listed with the sale price.  However, this does not update the price back and forth if a price change is made on your store
• Product Price
  The product's current price on your Shift4Shop store with variables (plus or minus) a specific amount or percent.
• Product Cost
  The product's current cost on your Shift4Shop store with variables (plus or minus) a specific amount or percent.
• This Price
  Use this to designate a specific price.

Buy it Now:

The Buy it Now pricing method is available if you'd like to have the eBay product listing available for only direct purchase instead of bidding/auction. The settings for this method are the same as listed for the "Buy it Now option under Auction.

Payment Tab
Back to top

This Payment tab will let you specify which payment methods will be available to the eBay user when bidding on or purchasing your item

Payment Methods
Pleace a mark in each method you'd like to use on the product listing.

• PayPal
• ProPay
• Moneybookers
• Visa or Master Card
• Discover Card
• American Express

Payment Description
Here you can enter a description of your Payment Methods or details for eBay users as to how payment/ordering will be handled.

Shipping Tab
Back to top

Use the Shipping tab to specify your shipping options for the eBay listing of products using this template.

First, at the top of the page you will have these options:

• Handling Time
  Select your average order handling time.
  This information will be factored into the eBay listing's order delivery estimates.
• Don't Ship To
  This checkbox is used to designate locations that you do NOT wish to ship to. When marking the checkbox, you will be given the options of selecting regions and individual locations within those regions which your listing will not ship to. If the eBay purchaser has a primary shipping address to any of the selected locations, eBay will block the sale.

Next you will have your Domestic Shipping Options:

• Domestic Shipping
  Select your Domestic Shipping calculation methods.
  • Flat - same cost to all buyers
    Using this method you can select various shipping methods that will be used for the order and specify a flat rate for each - regardless of where the domestic destination is.
  • Calculated - Cost Varies by Buyer Location: Using this method, you can select services that will be used and the shipping calculation will be handled by eBay depending on where the domestic destination is.
    • Package Type
      When selecting a calculated shipping cost, an additional drop down mindow will appear beneath your "Handling time" option above. Use this to select the type of packaging the order will use when calculated by eBay. For example, Large Envelope, Package, Large Package, etc.
• Handling Cost
  Enter your domestic handling costs. This field is an eBay requirement.

• International Shipping
  If you are willing to accept international orders, select the method you would like to use for product using this template.
  • No International Shipping
    Disables orders to International Addresses.
  • eBay's Global Shipping Program
    Calculation is done by eBay using their international methods
  • Flat - same cost to all buyers
    Using this method you can select various shipping methods that will be used for the order and specify a flat rate for each - regardless of where the international destination is.
  • Calculated - Cost Varies by Buyer Location
    Using this method, shipping calculation will be handled by eBay depending on where the international destination is.

• Handling Cost
  If setting up for International Shipping, you will also have the field where you will need to enter your international shipping handling costs. This field is an eBay requirement.

Other Tab
Back to top

In the Other Tab, you will have the ability to specify additional settings for the eBay product listing(s).

Item Condition
Set the condition of the items you will be listing with this template. Your choices are:

• New
  Items are brand new in original packaging.
• New other (See details)
  Items are new with other conditional specifications.
  The details of which can be included in the text box below this section.
• Manufacturer Refurbished
  Items have been refurbished or repaired by their respective manufacturers.
• Seller Refurbished
  Items have been refurbished or repoaried by the merchant selling the items.
• Used
  Items are being sold in used condition.
• For parts or not working
  Items are not functional and only being sold for spare parts or other details.

As mentioned above, the area beneath the item condition area is an open text box in which details of the product's condition can be listed and displayed.

Return Policy
Specify your eBay seller return policy. Your choices are:

• Returns accepted
  You are willing to accept returns and exchanges you can set the Return Policy to this and configure additional return settings.
• No returns accepted
  All sales are final and no returns or exchanges will be honored

Block Buyers Who
This last section allows you to block buyers who meet certain ineligibility requirements. Your options here are:

• Don't have a PayPal Account
  Check this box to prevent non-PayPal account holders from bidding or purchasing the eBay listed item(s) using this template:
• Have received [x] unpaid item case(s) within [y] month(s)
  Use the provided drop down menus to set your variables.
• Have [x] policy violation report(s) within [y]
  Use the provided drop down menus to set your variables.
• Have a feedback score equal to or lower than [x]
  Use the provided drop down menus to set your variable.
• Have bid on or bought my items within the last 10 days and met my limit of [x]
  Use the provided drop down menus to set your variable.
• Only apply this block to buyers who have a feedback score equal to or lower than [x]
  Use the provided drop down menus to set your variable.

Listing Enhancement Tab
Back to top

This Listing Enhancement tab will allow you to enhance the eBay listing product by allowing you to select the following options:

• Use Sub-Title
  Include the item's short description on the listing (Short description must be up to 53 characters.)
• BoldTitle
  Take the title of the page (product name) and display it in Bold text.

Once you are done with your Listing Template Settings, click "Save" at the top right to store the information. If there are any missing parameters, the store will warn you of what may be missing, so you can correct it and save the template fully.

Now that your Listing Template Variables are set, the next steps in our process will be to select individual items for listing on eBay.

Listing Products on eBay
Back to top

By now, you should have your store's global eBay settings configured and at least one eBay listing template created. The next step in the process is to list your desired items on eBay.

To list your products, please use the following steps.

From your Shift4Shop Online Store Manager

1. Use the left hand navigation menu and go to Products >Product List
2. Locate the product that you'd like to list and click on its thumbnail, ID or name to open it up

3. In the product's "Information" tab, scroll down to the new "eBay Listing" section located right above the Extended Description
4. Click on the button labeled "List on eBay" to proceed.

Once you click on the "List on eBay" button, a popup window will come up and you can proceed with the next steps:

To continue:

5. Select the Settings template (from the Store Modules section) that this product will use

The system will give you a brief summary of the settings configured on the Listing Template (from Modules)

6. Click on the "Product Information" tab along the top of the window to continue
7. Schedule a date and time for the listing to begin
   (or click "Execute it Now" to begin it immediately).

8. After setting the Schedule for the listing, review the item's Title and Sub Title as needed.
9. Under Quantity, set the number of units that you want to list on eBay
10. Review the rest of the information on the item such as price, dimensions, etc.

11. When ready to proceed, click on "Preview Fees From eBay" to review the applicable fees from eBay for the item's listing.
12. When you're ready to post the item, click "Finish" at the bottom.

Congratulations! Your item is now listed on eBay!

You may now repeat the process for the rest of your items as needed.

Processing Orders
Back to top

As orders and auctions are completed on your eBay listings, the integration will also bring those orders into your Shift4Shop store's Online Store Manager. Once in your Shift4Shop store, you may review, process and ship your orders as usual.

To see all of your eBay orders:

1. Log into your Shift4Shop Online Store Manager
2. Using the left hand navigation menu, go to Modules
3. Use the search bar at the top and search for "eBay" to view and expand the eBay module
4. Click on "Manage Listings"
5. Look to the top right and click on the "Show eBay Orders" button to view all orders.

To see individual listing eBay orders:

1. Log into your Shift4Shop Online Store Manager
2. Using the left hand navigation menu, go to Modules
3. Use the search bar at the top and search for "eBay" to view and expand the eBay module
4. Click on "Manage Listings"

Here you will see a page displaying all of your current and historical listings on eBay.

• If you have many listings, you can use the page's search filter at the top to narrow your view of the listings based on status, keywords, or specific date ranges.
• Furthermore, as the listings are displayed, they can be sorted by the name of the product, number of bids, listing type, dates and statuses.
• You also have the ability to end or re-list items as needed, directly from this page.

5. Click on a listing to review its information.

As orders for the item are placed, they will appear at the bottom of the listing information page. Clicking on the order invoice number(s) will take you directly to the order.

Clicking on the "Refresh data from eBay" button at the top right will update the listing information and orders from eBay.

Once there, you can review, process and ship the order as usual to fulfill it. As the order's status is updated, it will then reflect as such on the item listing information page.

Import Products from eBay (Only on Version 8)
Back to top

Beginning with Version 8 of the Shift4Shop software, you can now import your item listings from eBay. This can be useful if you have items that you sell on eBay that are not available in your Shift4Shop store and you'd like to add them to your store's catalog for extra exposure.

To import your products from eBay to your Shift4Shop store:
(Note: You must have your eBay API Access granted to the store before proceeding with the following)

1. Log into your Shift4Shop Online Store Manager
2. Using the left hand navigation menu, go to Modules
3. Use the search bar at the top and search for "eBay" to view and expand the eBay module
4. Click on "Import Products (beta)"

This will take you to a page where you will be able to select beginning and end date range to search for your eBay listings. The purpose of this is to search for listings in this time period and download them to your store for selection.

5. Set your From Date for the listing search
6. Set your To Date for the listing search
7. Click on "Search"

The store will download any active listings found within this time period on your eBay seller account. Once the store fetches your active listings, you will see a grid of listings with a checkbox, the product's name, category, price and the day it was last synched to your store. to proceed with the steps:

8. Place a check in the checkbox of items you wish to download/import into your store
9. Click "Next" to have the selected items imported.

On the next page, you will specify how the imported items will be categorized. Your options are:

• None
  The items are not listed in any category
• New
  The items are listed with the same category taxonomy shown on eBay which will be re-created on your Shift4Shop store.
• Select Existing
  The system will allow you to select an existing category in which to place the items during the import.

When you've made your selection, take the next step:

10. click on the "Import" button located at the top right of the page.

The store will then take the listing information from eBay and copy the product's name, price, description and image URLs. It will then use this information to recreate the item on your Shift4Shop store.