Skip to content

eBay Variations

The connector publishes items with Business Central variants as eBay variation listings: one listing with selection fields (e.g. colour and size) instead of many individual listings. Technically it uses eBay inventory item groups.

How it works

  1. One eBay inventory item per BC variant — with its own SKU (ItemNo-VariantCode-<MarketplaceCode>, e.g. 4711-RED-DE) and the variant-specific aspect values.
  2. All variant SKUs are combined into a group, including the specification of which aspects vary (variesBy).
  3. One offer of its own per variant SKU — with its own price, its own quantity and the fulfillment policy of the group.
  4. The group is published (publishOfferByInventoryItemGroup): eBay turns the offers into one multi-variation listing. When a variant is added, the sync publishes the group again.

Membership is controlled by the eBay Group Key field on the marketplace item; a new group gets the key ItemNo-<MarketplaceCode>, e.g. 4711-DE. Every variant carries its own offer ID; the listing ID is stored on the variants and the parent item. The parent item (without variant code) only stands for the group: it has no offer and sells nothing itself.

A group of its own per country

As with single items, eBay allows an SKU — and a variant group — on one marketplace only. When an item with variants is listed in several countries, every country therefore gets a group of its own with its own group key and its own variant SKUs. The connector creates new variants for every country the item is listed in. Existing groups with an offer keep their keys and SKUs (see eBay SKU per country).


Inventory and handling time per variant

  • Quantity: The hub calculates it separately for each variant — with the variant's own stock and the item settings of its marketplace item (see Inventory Calculation). Supplier stock counts for variants only when Count Supplier Stock for Variants is switched on in the merchantCENTRAL setup: supplier offers belong to the item, not to a variant. The quantity goes to the variant's offer.
  • Price: The price sync sends the price of every variant to its own offer.
  • Handling time: A listing shows one handling time only. When the sales channel uses the handling time, the group therefore carries the longest promise of its variants, and all offers of the group run on the same fulfillment policy. The slowest variant thus ships in time, the others earlier. When one offer changes policy, the others follow with their next quantity update.

Transition of existing group offers

Earlier versions of the connector created one single offer for the whole group on the parent item. The next variant sync converts such groups automatically: it creates the offers of the variants, publishes the group as a new listing and only then deletes the old group offer. Until then the quantity keeps going to the old offer. The result is recorded in the activity log; if the deletion fails, the next run tries again. No action is needed on your part.


Variation aspects

What the variants differ in comes from the item attributes of the variant in Business Central (variant card → Attributes). What a variant does not have itself it takes from the item. Which attribute fills which eBay aspect is set by the hub's attribute mapping – as for single items.

In the variation listing, the group carries the aspects all variants share. The aspects the variants differ in become the variation aspects (variesBy) – e.g. variant RED-L with Colour = Red and Size = L. The pictures follow one of them (see Variant pictures).

The group is not sent if the variants differ in no aspect, if eBay allows no variations by that aspect in the category, or if a variant has several values of a variation aspect. The reason is then shown on the parent item.


Variant pictures

In the product images, pictures can be assigned to individual item variants – for instance the photo of the red trousers to all variants with Colour = Red. With Include Image URLs switched on in the setup, the variant sync then sends:

On eBay Pictures
Variant with pictures of its own Its own pictures first, then the general pictures of the item (pictures without a variant), 12 at most. eBay leads with the first picture of its own – a picture of image type Main comes first – when the buyer picks the variant.
Variant without pictures of its own The general pictures.
Group (the variation listing) The general pictures.

eBay shows the pictures per value of one variation aspect: when the buyer picks Red, they see the pictures of the red variants. Where variants have pictures of their own, the connector lets the pictures vary by the first variation aspect they follow – the one for which all variants with the same value have the same pictures of their own, e.g. Red in S, M and L. Variants without pictures of their own count first, with the general pictures; if no aspect fits that way, they are left out. If the pictures still follow no aspect, the first variation aspect applies, as without variant pictures.

Assign a picture to all variants of its value, therefore – most easily with Assign Same Value. If, say, Red-M has no pictures of its own, eBay may show only the general ones for Red.

No general picture

If the item has no general picture – or all of them are deselected for the sales channel, or none of them has an image URL (stored in Business Central only) –, the group and every variant without pictures of its own receive all pictures of the item: eBay takes no listing without a picture. Such a variant then shows the same pictures as the group, photos of other colours included. Assign pictures to the variant, or give the item a general picture, such as a close-up.

Items without variant pictures behave as before: group and variants receive all pictures of the item.

Shop gallery and flagging. eBay sends pictures per variant. The shop gallery on the eBay row of a variant therefore shows the pictures its inventory item receives on eBay: its own first, then the general ones – of which 12 at most, and only pictures with an image URL, go out. The row of the parent item shows the item's whole gallery; the group itself receives the general pictures of it. When an assignment changes, merchantCENTRAL flags all eBay rows of the item for upload. The next variant sync (Upload Variant Groups) then sends the variants and the group with the matching variation aspect for the pictures. An item without a variant group goes out again with the next item sync and keeps the whole gallery.


Synchronising variations

Action (dashboard) Description
Upload Variant Groups Pushes all variant groups with pending changes to eBay — and every group that still needs the transition — on every active eBay marketplace (with progress dialog and one combined result message).

Tips

Every variant needs its value

Every variant of the group needs exactly one value of each variation aspect — otherwise eBay cannot distinguish the variant within the listing.

Who sends what

The regular listing sync skips items with an eBay group key — inventory items, the group and new offers of the variants are created by the variant sync only. Price and quantity of the variants are sent by the price and inventory sync, as for single items.