eBay details on the marketplace item card
An eBay listing has one card: the marketplace item card of merchantCENTRAL, the same one as for the listings of every other marketplace. Title, subtitle, description, price and quantity, images, status and errors are shown by the card itself. What only eBay has, the eBay connector adds on the same card – on eBay listings only:
- in the Marketplace Details section the eBay group with eBay SKU, condition, category, offer ID and policy, followed by the eBay Condition Details,
- in the Marketplace action group the eBay actions,
- under Copilot the action Translate Marketing Text.
On a listing of another marketplace these sections and actions are not shown.
Open the page
- Via the eBay item list → open a row
- On the Business Central item card with eBay Item: when the item has one eBay listing, its card opens; with several (per eBay site or variant) the eBay item list with its listings
- From the eBay listing issues, the listings on eBay, the result of Copy to Another eBay Site and the ways to fix of Check Listing
- From every hub list and FactBox that shows listings
The card always opens exactly the row of the listing – with its sales channel (eBay site) and variant.
Fields in the eBay group
| Field | Description |
|---|---|
| eBay SKU | SKU of this item on eBay — one of its own per country. It can be changed until eBay has an offer for the item or its variant group; after that it is read-only (eBay SKU per country). |
| Condition | Item condition (New, New Other, Refurbished levels, Used). A new condition creates the matching condition details. |
| Condition Note | What the buyer should know about the condition, for example "B-stock: packaging damaged, item unused". Shown highlighted in the eBay description and, for used and refurbished goods, as eBay's condition description. |
| eBay Category ID | eBay category — the … button opens the category search of the eBay site of the listing. A new category asks eBay for its condition details (with eBay switched on and licensed, otherwise from the cache). It is the same value as the Marketplace Category in the General section: choose it here, and the marketplace category follows with Category Source Manual; empty, the category mapping applies again. |
| eBay Offer ID | Offer ID assigned by eBay after publishing. The eBay listing ID is the Marketplace Item ID in the General section. |
| eBay Handling Time Policy ID | Fulfillment policy the connector moved the offer to for its promise (handling time policies). Empty: the offer runs on the marketplace's default fulfillment policy. |
In the eBay Condition Details section below you maintain the condition details required by eBay (condition descriptors). They hold per item, so for all eBay sites of the item.
From the hub's card (not repeated in the eBay section): title and subtitle, description with description template and preview, brand / MPN / EAN, price and quantity, Handling Time (Days) – choosing it shows the inventory sources the way the eBay sync calculates them, that is with the location of the eBay marketplace when the listing names none of its own –, Item Online, Sync Status and the last error with its machine translation. The flags Update Item/Price/Quantity and the last sync time are in the Technical section (via Show more). The Attributes FactBox shows the item specifics of the category.
Actions of the Marketplace group
| Action | Description |
|---|---|
| Mark for Upload | Sets Update Item, Update Price and Update Quantity: item data, price and quantity go to eBay with the next upload. Nothing is sent yet. |
| Check Listing | Lists everything the listing still lacks before the upload – category, item specifics, condition details, price, quantity, pictures, policies, texts in the language of the site –, each with the way to where it is fixed. Nothing is sent. |
| Preview Listing | Shows the listing with title, price, pictures and description as it would go to eBay, in the language of the site. Nothing is sent. |
| Refresh Condition Details | Asks eBay which condition details the category and condition need (for example grader and grade for trading cards) and adds them under eBay Condition Details. |
| Condition Descriptors | Shows the condition details eBay names for the category of the item per condition, as last read from eBay. |
| Copy to Another eBay Site | Copies the listing to another eBay site of the account, such as eBay Spain: condition, brand, MPN and EAN, and the category where that site has it, otherwise eBay's best suggestion. A summary shows the result; the copy is marked for upload only when nothing blocks it. Nothing is sent yet. Not for a single variant. |
| Upload Images to eBay | Sends the pictures of the item, as selected for this sales channel in merchantCENTRAL (product images), to its inventory item on eBay. For a variant, these are its own pictures followed by the general ones (variant pictures); the next variant sync brings the group up to date. |
| Download Images from eBay | Takes the pictures of the item over from eBay into the product pictures of the Business Central item. Pictures the item already has are not added twice; nothing is deleted. |
| View on eBay | Opens the listing in the browser on the eBay site of its marketplace, for an account in the eBay sandbox in the sandbox. Not without an eBay listing ID and not in Simulation Mode. |
Under Copilot you find Translate Marketing Text: Copilot drafts the marketing text of the item in the language of this sales channel; you review the draft before it is stored. Visible only when a module offers the translation (e.g. the SEO Engine) and the sales channel has another language than the item texts (description in the language of the sales channel).
Translate Error Message, the Business Central Item Card, the attribute check and the description preview come with the hub's card.
The two picture actions are only enabled when the marketplace item has an inventory item of its own on eBay — that is, it carries an eBay SKU and is not the parent of a variant group. For a variant group, use the actions on the individual variants.
Users without an eBay permission set
Every merchantCENTRAL user can open the card. Without an eBay permission set, a user sees the eBay details of an eBay listing but cannot change them; the eBay actions are not enabled.
Description in the language of the sales channel
With the description source eBay Template (Hub Content) in the eBay setup, the connector takes the description in the language of the sales channel. A channel in another language than the item texts – ebay.fr with German item texts, say – therefore does not get the marketing text of the item card but, in this order:
- the listing's own description, if it has one;
- the marketing text in that language – the action Translate Marketing Text drafts it;
- a text from an external content source;
- the item translation (Description and Description 2).
If there is none of them, the text part of the description stays empty – a description in the wrong language does not go to eBay. The marketing text is stored as plain text; the connector adds the HTML of the eBay template (paragraphs, key features, technical data, header and footer) when it uploads. After the translation, the listings of that language are marked for upload.
The other description sources (item description, extended text, marketplace item, description + attributes) do not tell languages apart; the translation changes nothing for them.
eBay SKU per country
eBay does not allow the same SKU on several marketplaces. A Business Central item that you list with one eBay account in several countries is therefore kept as an eBay item of its own with an SKU of its own per country — every country is a sales channel of its own with its own marketplace item.
- New rows get the SKU
ItemNo-<MarketplaceCode>, e.g.4711-DEand4711-AT; variantsItemNo-VariantCode-<MarketplaceCode>, e.g.4711-RED-AT(see variations). If the suggestion is already taken in the account, the connector appends-2,-3… - Existing listings keep their SKU — eBay knows the listing by it.
- Rules for an SKU you enter: at most 50 characters, only the letters A–Z and a–z, the digits 0–9 and
-,_and.; leading and trailing blanks are removed. The SKU must be unique within the eBay account (another account may use the same value) and must not be the SKU of a marketplace offer (pack) in the hub. - Not changeable after the first offer: as soon as eBay has an offer for the item or its variant group, the field is read-only.
- The SKU of the marketplace item in the hub carries the same value; the order import finds item and variant by it (order import). If you change either, the other follows.
Changeover of existing data
When updating to this version, the connector checks per eBay account whether an SKU (or group key) is used in several countries. Rows without an offer get an SKU following the new scheme and are transferred to eBay again with Update Item. If several countries already have an offer on the same SKU, this cannot be resolved automatically: the rows are marked as errors (Last Sync Error, listing issues). In that case end all but one of the listings on eBay and add the other countries again with an SKU of their own.
Price and inventory sync
- Quantity: The hub calculates it for the eBay item itself — with every item setting of the hub: fixed quantity, safety stock, quantity percentage, max quantity, bundle content, stock source and locations, for a variant those of the variant (see Inventory Calculation). Max Listing Qty in the eBay setup caps the result afterwards; where both limits apply, the lower one wins. The location of the eBay marketplace applies only when the item names none of its own. Every country calculates on its own (stock per country).
- Sending the quantity: Quantities go out through eBay's bulk call for price and quantity (
bulkUpdatePriceQuantity), in batches of 25 from 25 items on. It changes the quantity only; title, description, product data and policies stay untouched. eBay answers per item: a rejected quantity keeps Update Inventory and goes out again on the next run; the activity log shows the reason. - Price and category: The connector reads an existing offer from eBay in full, changes only price and category and writes it back. Policies — including the fulfillment policy of the handling time — and the description are kept.
- Handling time: When the sales channel uses the hub's handling time, the inventory sync moves the offer to the matching fulfillment policy together with the quantity — see handling time policies.
Stock per country
Because every country is an eBay item of its own, every country reports the full available quantity. If you list the same item in several countries, the same stock can therefore be sold more than once. Split the stock with Quantity Percentage or Safety Stock on the marketplace item of each country to avoid overselling — e.g. 50 % for DE and 50 % for AT.
Tips
How the listing upload works
The sync first creates the eBay inventory item, then the offer (with the price from the marketplace price list and the marketplace's business policies) and publishes it. Errors end up in listing issues.
Variations
Items with BC variants are published as a variation listing via a variant group — see variations.