Elbuz pulls your eBay seller account's active listings and orders directly via the API into the base catalog, alongside your other sales channels.
When you need this:
- Your eBay range belongs in the catalog: each active listing and variation becomes a card with price, stock and category.
- eBay is one of several marketplaces: you edit the product in Elbuz, and price and stock go back to eBay.
- Prices and stock must update daily: a scheduled template does it within eBay's daily limits.
- eBay orders go with the rest: each becomes a “Customer order” document.
Where to start: link your eBay account with a code in the import template.
What the eBay connection can do
- Connects with a link code: access is granted and renewed automatically, no token to enter.
- Transfers a listing into a card: name, description, SKU, price, actual stock, full category path, brand, attributes and photos.
- Publishes new listings, with variations for a product family.
- Splits out variations: each size or color becomes a separate card.
- Pulls orders and creates them as “Customer order” documents with your statuses.
- Updates by itself: orders every 5 minutes, the catalog on a schedule within eBay's daily limits.
- Sends the price and stock back through an export template and, if needed, publishes new listings.
What you need from eBay: app linking or a user token
You can grant access in one of two ways:
- App linking with a code is the main way. The token is issued and refreshed automatically, access lasts a long time and renews itself; the token field stays empty.
- A manual user token from your own eBay app, mostly for development or the sandbox. A manual token always takes priority over one obtained through linking.
How to connect, step by step
- Create a template of type “eBay”. “Active” and “Orders” are already on in a new template: within 5 minutes of linking, Elbuz starts pulling your entire order history. Elbuz maps marketplace statuses to yours by name; what arrived and how it was mapped is shown in the template's “Order statuses” window. Want to check first? Clear “Orders”.
- Click “Connect”, sign in to eBay and approve access.
- Enter the code shown into the “Link code” field and click “Link store”. If you use your own app, paste a user token instead.
- Click “Test connection”.
- In the “Select data to import” card, turn on products, then save and run.
There is one link per eBay account: connect it in the import template and the export template uses the same access, and vice versa. Both templates have the “Connect” button and the “Link code” field.
“Test connection” doesn't import anything: it sends one short request about the seller's privileges with the same keys as a run. The answer is “Connection works” or “Connection failed” with eBay's refusal text.
What goes into the card
The checkboxes in the “Select data to import” card control what gets pulled.
1
Products2
Photo3
Orders- Products — import of listings into the catalog.
- Photo — download of listing photos.
- Orders — import of eBay orders.
Each eBay listing maps to Elbuz card fields as follows:
| eBay data | Card field in Elbuz |
|---|---|
| listing title | Name (for a variation: “Name — M / Red”) |
| listing description | Full description |
| of the listing or variation | SKU |
| current price (for a variation, its own price) | Price |
| quantity listed minus quantity sold | Stock |
category in the form Root:Sub:Leaf | Category, as a full path |
the Brand item specific | Manufacturer |
| all other item specifics of the listing | Attributes |
| variation specifics (Size, Color…) | Variant options |
| listing photos and variation photo sets | Images, when the “Photo” checkbox is on |
| listing ID (with the SKU, if needed) | Link key |
- Stock is the actual available quantity: Elbuz subtracts what was sold from what was listed. Above zero, the status is “In stock”; zero, “Out of stock”. The status can't be set separately.
- Manufacturer comes from the
Branditem specific if the seller filled it in: eBay has no separate field for it. - Not included: the old price and the barcode, because eBay doesn't provide them.
- Active listings only: ended listings and drafts don't make it into the catalog (listing ended).
Variations and attributes
Each listing variation (size, color) arrives as a separate card named like “Listing title — M / Red”, with its own price, stock and SKU. The listing title goes into each variation's “Variant family name” field, which groups them in the grid. They don't become a main product with options: each variation is a standalone card.
Variation specifics become options; the listing's regular item specifics become attributes.
For variations without their own SKU, Elbuz builds a stable marker from the set of specifics, so a repeat import creates no duplicates. But exporting the price and stock to eBay will skip such a card: a variation on the marketplace is addressed by SKU only. If you manage prices from Elbuz, assign SKUs to variations in your eBay account.
Categories
The Root:Sub:Leaf category expands into the path “Root / Sub / Leaf”. Elbuz looks for your category with the same full path, then for one with the same name anywhere in the tree (from the last level up to the root), and only then creates a branch. You won't get duplicates like “Laptops (2)” as long as the names match.
Listings without a category go into the service category “Products - ebay”; products from order lines that aren't in the catalog go into “Products - ebay - ‹your template name›”. Both are disabled and excluded from exports. Feel free to move cards out of them: a repeat run doesn't change their place in the tree. More: service categories.
Deleting a category takes the entire branch along with the products for which it is the main category, including descriptions, photos, attributes and questions. Move the cards first, then delete. Lines of existing documents aren't affected: a document keeps its own copies of the name, price and quantity.
What a repeat run does with your edits
A repeat run looks for an existing card by name. The listing number (ItemID) is stored separately as the link to the listing, used to send prices and stock back. The general mechanics: catalog import via API.
- Overwritten from eBay: name, full description, price, quantity, stock status, “Active”, and the manufacturer, SKU and family name when they're filled in on the listing. There's no warning.
- Not wiped by empty values: old price, barcode and tags. eBay doesn't provide them, so your values stay. Quantity and “Active” are always written, zero included.
- Left untouched on an existing card: photos (new cards only), attributes (new ones aren't added), the place in the category tree.
To lock the whole card, use the “Do not update” toggle in the card's “Import protection” section (the same flag is the “Do not update (flag)” column in the “Products” window). To keep only the price, use “Fixed Price”: the run updates the name, description and quantity, but the prices stay yours. More: how to lock your own value.
1
Do not update2
Fixed Price- Do not update — an eBay run skips the whole card.
- Fixed Price — an eBay run does not change the card's price.
- Action or result
- Decision: the path depends on the answer
If you rename a listing in your eBay account, the next run won't recognize the old card and will create a new one. The old card keeps the old prices, and together they look like a duplicate. If listing titles change often, check the catalog after each run by filtering on the “Date updated” column.
A listing ended or was withdrawn from sale
Elbuz requests from eBay the listings ending from today up to 120 days ahead and takes only those whose listing status is active.
| What happened on eBay | What happens to the card in Elbuz |
|---|---|
| The listing ended or was withdrawn from sale | Nothing: the card keeps its last price, stock and “Active” on, with no log line. Remove it manually |
| The listing is active, but the product sold out | The quantity arrives as zero, the status is “Out of stock” |
The eBay form has no “delete what's missing from the source” checkbox. The general rule: a product disappeared from the source.
If you turn off “Active” on a card
Every active listing arrives with “Active” on, and the run overwrites it: turn it off and the next run silently turns it back on. To make the change stick, set “Do not update” on the card. Turning a card off loses no data: photos, attributes and the listing link stay.
How to pull eBay orders
The same connection pulls new and changed orders: turn on the “Orders” checkbox, and Elbuz will pull them by itself every 5 minutes (schedule). Each one comes in as an unposted “Customer order” document: stock and reservations don't change until you post the document.
- Line items are linked to cards by listing number (for a variation, listing number plus SKU). If there's no card, one is created in the service category with the price and quantity from the line. That's why it makes sense to import the catalog first.
- Fulfillment status is mapped to yours by Elbuz itself, by name; the “Order statuses” button lets you fine-tune it. Payment state goes via “Payment statuses” (the “Related settings” section). An unrecognized state comes in as “New”. eBay doesn't provide the shipping state in this exchange.
- History: the first run pulls all of it, later runs only what changed. The starting point is in the “Advanced” section, in the “Import orders from date (YYYY-MM-DD)” field; after that, Elbuz moves it forward on its own.
1
Order statuses2
Payment statuses3
Import orders from date- Order statuses — maps eBay order statuses to Elbuz statuses.
- Payment statuses — maps eBay payment statuses to Elbuz payment statuses.
- Import orders from date (YYYY-MM-DD) — orders are loaded starting from this date.
Older orders whose status changed on eBay are updated, not duplicated, but only unposted ones. The run changes your processing status only when the status on eBay has actually changed since the last time. The general mechanics: two statuses of one order.
- Action or result
- Decision: the path depends on the answer
How to publish new listings on eBay
With the “Publish new products” checkbox on in the export template, Elbuz creates a listing from your card: fixed price, title up to 80 characters, up to 12 photos, EAN, condition and the card's description. Brand and MPN are filled in automatically from the manufacturer and SKU.
- Category. You map it in the category mapping window, separately for each eBay site (DE, FR, US and so on) if you like. Without any mapping, the product isn't published: “eBay: new products not published: N (no eBay category mapping)”.
- Required item specifics. These are mapped in the same place, to product attributes. For an item specific with a list, only an eBay value fits; multiple values are separated by commas. There's one item specific mapping per attribute, so if the item specific name differs across sites, check the log for each site. Without a required item specific, the listing isn't created: “eBay: "…" — required item specifics of the category are empty: …”.
- Warehouse address and account policies. Publishing isn't possible without them; the log reports this in a separate line.
Variations: one family, one listing
Two or more products of one family (“Variant family name”) in the selection become one listing with variations. Variants must differ by “Product option” attributes; the axis is named after the mapped eBay item specific or your attribute. Log: “eBay: family "…" published as one listing with N variations (listing …)”. Identical variants or a missing required item specific skip the whole family; the log says why.
The price and stock of published listings, variants included, then update on schedule.
Scheduled updates and daily limits
Elbuz pulls orders by itself every 5 minutes if “Orders” is selected in the template and access is granted. This is done by the shared “Marketplace orders” task in the “Job schedule” window, where you can also change the interval. This pass doesn't load the catalog, and orders also picked up by the template's schedule aren't duplicated.
The catalog is updated by the template's own schedule: the “Schedule setup” button in the “Related settings” card. eBay has daily limits on calls, shared across the app: a schedule that's too frequent for a large range will run into them. Run the catalog rarely, for example once a day at night: while it's loading, the orders pass is skipped until the next one.
The log shows the numbers:
- for each page: “eBay: catalog page 3, products received: 240”;
- the total: “eBay: catalog imported, products (including variations)” with a number;
- then “Updating values based on formulas” and “Data import completed!” with “Time spent”;
- a marketplace error appears in red, with eBay's reason text.
More about the log: how to check that the import went through.
How long a run takes
| What | Page | Response wait |
|---|---|---|
| Catalog | 100 listings, 1 s pause | up to 180 s |
| Orders | 50 orders, 2 s pause | up to 120 s |
Products are written to the catalog in batches of 500 during the run; there's no cap on the count. A request refused due to a limit (for the catalog, also on an eBay-side error) is retried up to three times, pausing 2, then 4 seconds. Your catalog's run time is in the “Time spent” column and in “Run history”.
- Action or result
- Decision: the path depends on the answer
What goes back to eBay
The import sends nothing back: that's the job of a template in the “Data export” window, with its own schedule (export templates). It sends only the price and stock to eBay, using the link the import created; the listing's description, photos and category stay on eBay's side.
New listings are published by the export template's “Publish new products” checkbox.
Which eBay site the export goes to
The site is set by the export template's “API version (marketplace parameters)” field: EBAY_DE, EBAY_FR, EBAY_PL, EBAY_GB, EBAY_US, etc., any of the 19 eBay sites. Empty means EBAY_US. Listing language and currency follow the site: German and euros for EBAY_DE, Polish and zloty for EBAY_PL. Selling on several sites? Create an export template for each.
Catalog, orders, prices and stock work with listings on any eBay site. A new listing requires:
- an eBay category for that site: in the category mapping window, on the eBay tab, pick the site from the list and map the categories; each site has its own category tree. Without a mapping for the site, the category mapped earlier without a site is used; if there's none, the product is skipped;
- a warehouse address in the account and three business policies (shipping, payment, return) for that site in Seller Hub. Otherwise the log reports “eBay: publishing new listings is not possible…” and the products are skipped;
Build the eBay fee into the price with a formula on the price field: the “Export fields” button in the “Related settings” card of the export template. The eBay fee calculator helps you work it out for a specific site and category.
Scenarios
Bring your eBay range into the catalog for the first time
Turn on “Products” and “Photo”, and turn “Orders” off for now: a new template has them on. Click “Test connection”, then run the import. Result: every active listing becomes a card, every variation a separate card, categories expand along the eBay path, and photos arrive with the new cards. Listings without a category land in the disabled “Products - ebay”.
Update prices and stock every night without losing your work on the card
Schedule the template with “Products” nightly. Use “Fixed Price” on cards whose price you set, “Do not update” on cards the run mustn't touch. Result: price, quantity and availability come from eBay nightly; photos, existing attributes and tree position stay. The run restores the name and description from the listing; remove cards of ended listings manually.
Pull only orders from eBay and manage the catalog in Elbuz
Turn off “Products” and leave “Orders” on. Elbuz maps order statuses itself; map payment state with the “Payment statuses” button before linking. Result: orders arrive by themselves every 5 minutes, lines link to cards by listing number, and without a link, to a card with exactly the same name. If no name matches, a new card appears in “Products - ebay - ‹template name›”.
Manage eBay variation prices from Elbuz
Assign an SKU to each variation in your eBay account and import the catalog. Result: the variation links to the listing by the “listing number + SKU” pair, and the export will update its price and stock on eBay. A variation without an SKU is skipped by the export.
What to do when eBay won't import
| What you see | Why | What to do |
|---|---|---|
| “eBay: account is not connected” | The account isn't linked and no token is entered, so the run doesn't even contact eBay | Link the account with a code (how to connect) |
| “Connection failed” with text from eBay | Access has expired or the manual token is invalid | Link the account again or replace the user token (what you need from eBay) |
| “eBay: API error —” with the reason | Most often, expired access or an exhausted daily limit | Click “Test connection”; if it's the limit, run the schedule less often (schedule and limits) |
| Fewer products in the catalog than listings in your account | Only active listings come in; ended listings and drafts don't | Nothing, this is by design (listing ended) |
| Two identical products with different names | The listing was renamed on eBay, so the run created a new card | Delete the old one: you'll find it by its older “Date updated” (repeat run) |
| A variation's price on eBay doesn't update | The variation has no SKU, so there's nothing to address it by on eBay | Assign an SKU in your eBay account and import the catalog again (variations) |
If a run broke off or was stopped
After an eBay error, the run stops right after the failed page. What was already written in batches stays updated; the rest keeps the old data. Run it again: it starts from the first page, creates no duplicates, and finishes markups and search data at the end. The general mechanics: if a run broke off.
- Both products and orders on: after a failed catalog, orders are still pulled, but the run's result is a failure.
- The “Stop” button in the Operations Center: the run finishes reading the current page, writes what it received and completes the final steps. The log shows an orange line “eBay: import stopped, products written: N — the catalog is incomplete”. Orders stop the same way.
If you imported the wrong data
Anything created by this connection can be filtered in the “Products” window by the “Source - name” (template name) and “Source - Code” (ebay) columns and deleted in bulk, even after the template is deleted. Look for overwritten cards by “Date updated”; old values can't be restored in bulk. More: if you imported the wrong data.
FAQ
Are listing categories preserved?
Yes. Elbuz expands the full eBay category path, so catalog sections keep their structure instead of arriving as a flat list (categories).
Will a repeat import duplicate listings?
No, as long as listing titles don't change: the run finds the card by name and overwrites it. A listing renamed on eBay produces a new card, and the old one keeps the old data.
Why don't the cards have an old price or barcode?
eBay doesn't provide them. Whatever you entered in these fields manually, the run doesn't wipe (repeat run).
Can I pull only orders from eBay?
Yes. Turn off “Products” and turn on “Orders” in the “Select data to import” card: orders will arrive by themselves every 5 minutes (scenario).
Will stock change when an eBay order comes in?
No. The order comes in as an unposted “Customer order” document, which changes neither stock nor reservations until you post it.
Can Elbuz list new items on eBay?
Yes, with the “Publish new products” checkbox in the export template, on any of the 19 eBay sites, provided the category for that site is mapped and the warehouse address and business policies are set up in Seller Hub (export site).
Where to find it and who has access
- Menu
- Directories → Operations → Data import
- Template
- new template → type “eBay”; one template per seller account
- Access right
- the “Import” window in “Group permissions”
- Have ready
- sign-in to your eBay seller account to approve access
1
eBay user token2
Test connection- eBay user token — the field for the token of your own eBay application; not needed when you connect through the Elbuz app.
- Test connection — checks that the credentials work.
How import templates work in general: data import overview.
Related topics
- If you need to understand how an import template handles any source: Importing data into the catalog.
- If you're also connecting other marketplaces via API: Catalog import via API.
- If you need to combine eBay orders with other channels: Importing orders from marketplaces.
- If the catalog is in place and next you need prices and availability from supplier price lists: Where to start and where to go next.
