CoinDuffleDocs
Inventory Import

Importing from eBay

Connect your eBay account and import listings into CoinDuffle. Step-by-step guide covering OAuth authorization, selecting listings, field mapping, and running your import.

Importing from eBay

If you sell on eBay, you can import your active listings into CoinDuffle to quickly build your product catalog. This guide covers the entire process from connecting your eBay account to reviewing your imported products.

Prerequisites

Before starting:

  • You have an active eBay seller account with listed items
  • Your CoinDuffle seller account is set up and verified
  • Your eBay listings have images
  • You have the login credentials for your eBay account

Step 1: Connect Your eBay Account

Initiating the Connection

  1. Navigate to Seller Dashboard → Import
  2. Select eBay as your import source
  3. Click Connect eBay Account

Authorizing via OAuth

  1. You'll be redirected to eBay's sign-in page
  2. Log in with your eBay credentials
  3. Review the permissions CoinDuffle is requesting:
    • View your eBay selling activity — To access your listings
    • View items and details — To read product data, images, and descriptions
  4. Click Agree to authorize the connection
  5. You'll be redirected back to CoinDuffle

Verification

After authorization, your connection status should show Connected with your eBay username displayed. CoinDuffle can now read your active eBay listings.

Step 2: Select Listings to Import

CoinDuffle loads your active eBay listings and presents them in a selectable list.

What You'll See

For each eBay listing:

  • Listing title
  • Primary image
  • Buy It Now price (auction items show starting price)
  • Quantity available
  • Listing format (Fixed Price, Auction, etc.)

Selecting Listings

  • Import all — Click Select All to import everything
  • Select individually — Check the boxes next to listings you want to import
  • Filter — Search by keyword or filter by category
  • Import Fixed Price listings — These map cleanly to CoinDuffle products
  • Skip active auctions — Auction-style listings have a different pricing model that doesn't transfer well. Wait until the auction ends or convert to Fixed Price on eBay first.
  • Skip items with zero quantity — No point importing out-of-stock items unless you plan to restock

Step 3: Review Field Mapping

CoinDuffle maps eBay listing fields to CoinDuffle product fields as closely as possible.

Automatic Field Mapping

eBay FieldCoinDuffle FieldNotes
TitleTitleDirect mapping
Description (HTML)DescriptionHTML preserved; eBay templates may need cleanup
Gallery imagesImagesAll listing images imported
Buy It Now PricePrice (fixed)Fixed price import
SKU (Custom Label)SKUImported if set in eBay
Quantity AvailableQuantityCurrent stock level
Item WeightWeightMapped if available
eBay CategoryCategoryMapped to closest CoinDuffle category
Item SpecificsVarious fieldsMetal type, year, grade, etc. may be extracted
ConditionDescription noteCondition is added to the description

eBay Item Specifics

eBay item specifics (structured data like "Coin: Morgan Dollar", "Year: 1921", "Metal: Silver") are used to:

  • Auto-detect the metal type (Gold, Silver, Platinum, Palladium)
  • Assist with category mapping
  • Enrich the product description

Description Cleanup

eBay descriptions often contain heavy HTML formatting, tables, and custom templates. CoinDuffle imports the HTML but it may not render perfectly. Plan to review and clean up descriptions after import, especially if you use elaborate eBay listing templates.

Step 4: Run the Import

  1. Review your selections and field mappings
  2. Click Start Import
  3. Monitor the progress indicator

Import Speed

  • 10 listings: Under 1 minute
  • 50 listings: 3–7 minutes
  • 200 listings: 15–30 minutes

The import runs in the background — you'll be notified when it completes.

What Happens During Import

  1. CoinDuffle fetches listing data from eBay's API
  2. Images are downloaded from eBay's servers
  3. Fields are mapped to CoinDuffle's product schema
  4. Products are created as drafts in your CoinDuffle store

Step 5: Review and Enhance Imported Products

After the import, go to Seller Dashboard → Products and filter by Draft to see your imported listings.

Priority Review Items

Description Cleanup

eBay descriptions are often the biggest area needing attention:

  • Remove eBay-specific elements — Links to your eBay store, "check out my other auctions" text, eBay-specific policies
  • Clean up formatting — eBay HTML templates often result in messy formatting on CoinDuffle. Consider rewriting in plain text.
  • Update for audience — CoinDuffle buyers may expect a different style or level of detail than eBay buyers

Image Quality

eBay images may be lower resolution than CoinDuffle recommends. If imported images are below 800×800px:

  • Re-photograph the items for better quality
  • Or upload higher-resolution versions if you have them

Pricing

  • eBay Buy It Now prices include eBay fees in your margin. On CoinDuffle, fees are different, so you may want to adjust.
  • Consider converting bullion items from fixed pricing to metal-based pricing.

Category Assignment

eBay categories don't map 1:1 to CoinDuffle categories. Review each product's category and adjust if needed.

Metal Type and Weight

If your eBay listings include item specifics for metal type and weight, these may be auto-detected. Verify they're correct and fill in any gaps.

Post-Import Checklist

For each imported product:

  • Title is clean and descriptive
  • Description is free of eBay-specific content
  • Images are clear and meet minimum size requirements
  • Price is appropriate for CoinDuffle
  • Category is correct
  • Metal type and weight are set (if applicable)
  • SKU is assigned
  • Quantity is accurate

Managing Your eBay Connection

Disconnecting

To remove the eBay connection:

  1. Go to Seller Dashboard → Import → eBay
  2. Click Disconnect

Previously imported products remain in your CoinDuffle store.

Re-Importing

Running the import again will:

  • Detect previously imported listings (by eBay item ID) and skip them
  • Import only new listings created since the last import
  • Not overwrite changes to previously imported products

Important: Independent Inventories

The eBay import is a one-time copy, not a live sync. After import:

  • Changes to eBay listings do not update CoinDuffle products
  • Changes to CoinDuffle products do not update eBay listings
  • Inventory levels are managed independently on each platform

If you sell on both platforms simultaneously, you'll need to manually manage inventory across both to avoid overselling.

Troubleshooting

"Authorization failed"

  • Ensure you're signing into the correct eBay account
  • Clear your browser cookies and try again
  • Try in an incognito/private browsing window

"No listings found"

  • Verify you have active listings on eBay (ended/sold listings are not imported)
  • Check that your eBay account has seller activity
  • Reconnect your eBay account if the token may have expired

"Description looks broken"

  • This is common with complex eBay HTML templates
  • Edit the product in CoinDuffle and clean up or rewrite the description
  • Consider using a simple, clean description format going forward

"Images didn't import"

  • eBay image URLs may expire or become inaccessible
  • Try re-running the import for affected products
  • Upload images manually if the import can't retrieve them

"Wrong category assigned"

  • Category mapping from eBay to CoinDuffle is best-effort
  • Review and manually assign the correct CoinDuffle category
  • See Mapping and Troubleshooting for category mapping details

eBay-Specific Tips

  • eBay listing templates — If you use a third-party listing template on eBay, the imported description will include all the template HTML. This often looks messy in CoinDuffle. Strip the template and use clean, simple descriptions.
  • Variation listings — eBay variation listings (one listing with multiple options) are imported as separate CoinDuffle products, one per variation.
  • Stock photos — If you use manufacturer stock photos on eBay, make sure you have the right to use them on CoinDuffle as well.
Importing from eBay | CoinDuffle