Marketplaces & Multichannel

Not covered in this guide: setting up eBay ( eBay Integration Guide) and Kaufland ( Kaufland Integration Guide), the Google product feed ( Google Merchant Center & Product Feed Guide), and the CSV Porter in detail ( Import & Export Guide). If you’re connecting marketplaces via Billbee, you’ll find instructions in the “Interfaces & Inventory Management” guide.

Each marketplace has its own menu item under “Multichannel.” The first tab bears the marketplace’s name and displays the approved items along with their transfer status; next to it is “Settings.” Amazon also has “OAuth Authorization” and “Amazon Listings,” while Kaufland has “Marketplace Listings.” The menu items for Conrad Marketplace, MediaMarktSaturn, Galeria, OBI, Otto Office, and Home24 appear automatically.from 4.10

Where to Find What

The approval of a product and its data remain saved, even if a marketplace is not activated. If we activate it later, it will continue with the same settings.

In the “Marketplaces” tab, approve the item for each marketplace; in the sub-tab, replace the name, description, or price for that marketplace as needed. Click to enlarge.

Fields for All Marketplaces

In the sub-tab, most marketplaces list the “Marketplace-Independent Attributes” at the top:

Publishing Multiple Items at Once

Under Tools → xoPort CSV Import/Export Manager, create a file with the category “Marketplaces.” Each row contains the “Item Number” (or “Product ID”), the “Marketplace Name” (or “Marketplace ID”), and the “Marketplace Status” with 1 for active and 0 for inactive. The “Marketplace Data” section sets the “Marketplace-Specific Price” as net or gross. For instructions on how to create a Porter, see the Import & Export Guide.

Excluding Items from a Marketplace

Hide in the shop, keep on the marketplace

There is no “marketplaces only” toggle. An inactive item (“Product Status” off) will not appear on any marketplace, nor will an item that you block for the default customer group in its details under “Customer Groups.”

However, the setting that blocks a category for customer groups does not affect the transfer to marketplaces. As a result, items remain on the marketplace but are not visible in the store:

1. Create your own category, such as “Marketplace Only,” and keep it active.
2. In the category settings under “Customer Groups,” select “Custom” and deselect all customer groups.
3. Assign the items only to this category. If an item is also listed in a visible category, it will remain visible in the store.

In the “Products” section, you specify which approved products and which inventory levels are actually sent to the marketplace. Click to enlarge.

In addition, some marketplaces have their own limits in the same section: Galaxus and the Mirakl marketplaces have a “minimum inventory for products to be exported,” while the new eBay integration has a “minimum number of warehouses for export” and a “maximum number of warehouses for export.”

For Decathlon and the other Mirakl marketplaces, if no warehouse is selected, the store reports the inventory from the first secondary warehouse. If there is nothing there, it uses the inventory from the main warehouse and includes the “shipping lead time,” see Delivery Time.

The markup table from the example: up to €10.00 net plus €2.00, up to €50.00 plus 5%, up to €9,999.00 plus 3%, then rounded to x.99. Click to enlarge.

• Fixed price per item: The “Marketplace-Specific Price (Net)” in the item’s sub-tab replaces the group price and markup. Gross rounding applies to this price on most marketplaces, but not on Mirakl marketplaces.
• Mirakl marketplaces (Decathlon, Manor, and others) do not have a “customer group for price calculation.” They receive the standard price; special prices are applied only if “Consider special offer prices” is selected.
• Check Margin: The marketplace’s item list displays “Shop Price,” “Marketplace Price,” “Cost Price,” and “Margin (%)”. If the marketplace price is at or below the cost price, it is highlighted in red.
• eBay (Classic) has its own price fields; see the eBay Integration Guide.

For orders, the shop uses the price the buyer paid on the marketplace, not the current shop price.

You create traffic light profiles under Products → Traffic Light Profiles; see the guide on Creating & Managing Products. If you change a profile, the new delivery time takes effect only after the next transfer of the item.

• Check status: Above the marketplace’s product list, you’ll see a message such as “3 products are out of date and will be automatically updated shortly.”
• Transfer Immediately: In the product list, “Update Product” or “Export Products” manually triggers a run. For individual products, select them and choose the appropriate action from the “Action for Selected Products” menu, provided the marketplace offers it.
• Which inventory: Available inventory minus safety stock; for multiple warehouses, it’s taken from the selected warehouses—see filters.
• Stock 0: Each marketplace handles what happens to the listing differently. For eBay, see the eBay Integration Guide.

Customer, Name, and Address

• Guest account per order: The import creates a separate guest account for each order, even for repeat customers. Like guest accounts from the store, the store deletes it after one day when you log in to the backend. Name, addresses, and email address remain associated with the order.
• Name: Amazon and eBay provide the name in a single field. The store splits it at the last space; a single word becomes the last name. It does not recognize company names; “Zahnpraxis Mundwerk GmbH” is split into the first name “Zahnpraxis Mundwerk” and the last name “GmbH.”
• “Address verification required”: Marketplaces provide the address on separate lines. If the house number is not at the end, if a name appears in the street field, or if the street name is unusually long, the store flags the order in both the list and detail views. Check the address, correct it if necessary in the order editor, and click “Address is correct.”

If the house number is not at the end, the shop flags the marketplace order; after verification, confirm by clicking “Address is correct.” Click to enlarge.

Emails During Import

The store does not send an order confirmation to the buyer for marketplace orders; the marketplace handles that. For Amazon, eBay, Kaufland, OTTO, Galaxus, and idealo, a copy is sent to the addresses listed under Settings → Interfaces → Email Marketing / CRM → Email Options → Send Order Copy via Email. For eBay (Classic), this is controlled by the “Send order copy on eBay import” setting.

If OTTO itself cancels an order that is still pending with you, the shop will set it to “Canceled” status during the next order import and note this in the order history. If the order has already progressed further, the status remains the same, and you will receive an email at the shop’s address.from 4.9.135

Shipping email to the buyer?

Whether the buyer also receives an email from the store when the status changes is determined solely by the “Notify Customer” toggle in the order. The shop does not distinguish between shop orders and marketplace orders and sends the email to the email address provided by the marketplace. The notification to the marketplace is sent regardless of this setting.

Whether you should or are allowed to contact marketplace buyers yourself is governed by the marketplace’s terms and conditions. If you do not want to send emails to marketplace buyers, leave “Notify Customer” unchecked for these orders. The content of the status emails is described in the CMS & Email Templates Guide.

DHL label fails for a marketplace order

• The most common cause is the address: The DHL interface looks for the house number at the end of the street field. Pay attention to the message “Address verification required” and, in the order editor, separate additions such as practice or company names from the street and house number.
• The store truncates entries that are too long to the limits set by the shipping provider and logs this—for DHL, this is 40 or 50 characters for the street, depending on the interface.
• The remaining error messages and settings are listed in the Shipping & Delivery Guide.

For the manufacturer, enter at least “Manufacturer’s Address: Company,” street, ZIP code, city, “Manufacturer’s Address: Country,” and “Manufacturer’s Address: Email Address” or “… Website.” If the country is outside the EU, the form will display the fields “Address of the responsible person: ….” Be sure to fill these in as well.

Assign Orders to a Partner via Deep Links

If an agency manages your channels, assign purchases to that agency as a partner after a user clicks on a product link. For marketplaces, select the “Partner for Deep Links” in the settings; currently, the Galaxus transfer uses these links. Append the partner ID to feed and Porter addresses. Purchases made directly on the marketplace do not generate a commission. See the Partner Program guide for details.

The product list shows the upload status for each product; clicking the info icon opens the marketplace’s message; and a marketplace price below the purchase price is highlighted in red. Click to enlarge.

Logs

The shop logs every request to a marketplace in daily files on the server, in the folder tmp/log/ with a subfolder for each interface, such as tmp/log/Xonic/Api/Kaufland/ or tmp/log/api/mirakl/. The shop deletes older files after the set retention period, which is one month by default.

There is no view for this in the backend. Please provide us with the marketplace, item number, and date/time, and we will analyze the log for you. For eBay, the shop displays the message directly in the overview; see the eBay Integration Guide.