/
eBay

eBay

eBay Integration

UltraCart provides a tight integration with eBay to manage the full life-cycle of listing products and converting them to UltraCart orders.
This includes inventory management, if you have it configured. Setting up your eBay integration should take about 10 minutes, plus item configuration (depends on item count).

LAST THINGS FIRST
What to do if you have a problem with an eBay order:

If an order comes back from eBay with something unexpected (shipping, total charge, tax, etc.), please see the eBay response.
To see the response, view the order in the Orders Review page and click the ebay data button. This button will only be visible on eBay orders. Below the order, the xml response from eBay is displayed. This proves very useful in diagnosing configuration/setup issues.

Requirements

  • An eBay store. The listings are fixed price store listings, not normal auctions (this is a significant cost savings to you). Using such listings requires an eBay store. See http://pages.ebay.com/help/sell/store-getstarted.html for details about starting an eBay store.

  • A valid Premier or Business PayPal account. All listings are instant payment through PayPal. eBay requires this level of PayPal account to process instant payment orders. See https://www.paypal.com/cgi-bin/webscr?cmd=p/gen/personal_vs_business-outside for help setting up a Premier or Business PayPal account.

  • Your eBay login credentials. You won't be providing them to us. We never see your eBay login. However, you will need them handy to authorize UltraCart to act on your behalf. To do this, you must login to eBay's site once during the setup.

  • Store-wide configuration (details below)

    • This includes a template file for the listing description. Such a template can be as simple as a single line or as complex as your web site's normal pages.

  • Per Item configuration (details below)

Configuring your store

Navigate to:

Home → Configuration → [Channel Partners] section (at bottom of page) → eBay

Giving UltraCart permission to act on your behalf

The initial prompt for this integration will be the "Connect eBay Account" button:

The next you'll be prompted to log into your eBay account:

Immediately, UltraCart will check to see if it has an API Key for you.

The API Key is a long list of characters that UltraCart provides to eBay during each conversation.
It allows UltraCart to act on your behalf without having your login and password.


eBay key expiration

The key is good for one year, and may be cancelled by you at any time.

The first step in generating a key is to click the eBay Sign-in Service link. It looks like this:




After signing in, follow the instructions to grant UltraCart permission to act on your behalf.

Setting Store-Wide Options

PayPal Email

UltraCart will not do any validation on your email address. It can't. If you enter an incorrect email address, or a PayPal email address that is not Business or Premier, your items will fail to list with an error message pointing to this email setting as the root cause of failure.

Listing Options

The listing options are shown below, and then described in a subsequent table.

Setting Name

Description

Possible Values

Setting Name

Description

Possible Values

Listing Duration

How long the item is listed for on eBay. When the item expires, it is automatically relisted

(Good til Cancelled GTC), 1 Day, 3 Day, 5 Day, 7 Days, 10 Days, 14 Days, 21 Days, 30 Days, 60 Days, 90 Days, 120

Html Template

The Apache Velocity Template that will render the product description. See the eBay - Listing Templates pages for a thorough discussion of templates.

Simplest template? Just create a template and add $item.description

Refund Options

Display your refund option, if you have Returns Allowed Within set to Returns Accepted.

Money Back, Money Back or Exchange, Merchandise Credit, Exchange

Returns Allowed Within

Flag for whether or not you accept returns

Returns Accepted, Returns not Accepted

Shipping Cost Paid By

Who pays shipping. This is only applicable to auto sales. You'll most always want this to be set to Buyer. This is NOT a way to configure "Free Shipping".

Buyer, Seller

Inventory Management

Determines whether UltraCart will de-list your items when the inventory for that item is zero. If you use Inventory Management, then set this to use the item level settings. UltraCart will then check the inventory and adjust the eBay inventory hourly. It will also de-list an item when your inventory runs outs.

Use item level settings, All items are always available

Always Available Quantity

This select box will only appear if you set your Inventory Management to "All items are always available". Choose an available quantity that meets your needs. Please read this article before setting your quantity. Your listings will be denied if you set this too high.

5,10,20,50,100,1000

Upload Default Image

This is currently not used. UltraCart will upload any images for your item.

Yes/No

Use eBay Tax Table

You'll almost always want this to be checked. There are 3 ways to handle tax for an eBay item. Two of them are available to you using UltraCart. The first is to let eBay calculate it. If you check this box, eBay will handle tax. The second option is to configure it within your eBay Store Selling Preferences. If you leave this field unchecked, it's up to you to configure your eBay store with a custom tax policy. See http://pages.ebay.com/help/pay/checkout-tax-table.html for details.

Yes/No

Return Policy

This field contains the return policy text displayed on your listing.

This is custom text. Browse eBay for examples if you need help.