HomeDeco: marketplace guide

About this guide

This is a ChannelEngine guide on the Amsterdam-based marketplace HomeDeco. Here you can find information on how to request a HomeDeco account, how to configure this marketplace on ChannelEngine, and what the specific requirements are.

Table of contents

Commercial information

How to request an account

Associated costs

Marketplace features

Settings and configuration

Marketplace-specific requirements and exceptions

• Setup
• Product selection
• Mappings
• Listed products

FAQs

Commercial information

How to request an account

To start selling on HomeDeco, you must first register as a seller on their Verkopen op HomeDeco (Sell on HomeDeco) page. This page lists some of the benefits of selling your products via HomeDeco. Note that the setup is entirely in Dutch, as HomeDeco focuses on the Dutch market.

Fill out all the required information to create your winkel (store), then submit the form. The general terms and conditions can be found on Voorwaarden voor verkopers (Conditions for sellers). Someone from HomeDeco contacts you to finalize the creation of your account, then you get access to your own store – which can be reached at: homedeco.nl/winkels/[NameOfYourStore]/admin/.

Associated costs

HomeDeco does not charge any setup or monthly fees, but it does charge 20% on every sale you do through their platform. This is a higher-than-average commission, so it is not advised to sell low-margin products on HomeDeco.

Marketplace features

Settings and configuration

Setting up each channel on ChannelEngine follows the same flow, though not every channel includes the steps listed below.

1. Go through the Setup.
2. Create a Product selection.
3. Complete the Categorization.
4. Set up the Mappings: content, offers, and carriers.
5. Configure the Pricing: rules and currency conversion.
6. Fill in the Stock settings.
7. Finish the Activation.
8. Check the Listed products overview.

Marketplace-specific requirements and exceptions

Setup

On ChannelEngine

This marketplace does not require the addition of any IDs or keys on ChannelEngine's Setup page. Because it uses the ChannelEngine Channel API, it connects to ChannelEngine instead of the other way around. You need to provide your contact person at the marketplace with the following credentials, so they can connect your account:

• Your account subdomain (i.e.: https://[youraccount].channelengine.net/api)
• The Channel API key, which can be found on the Setup page of the marketplace on ChannelEngine
• Your product feed from ChannelEngine (see below)

Product selection

This channel accesses your product data directly from source files that ChannelEngine generates. In the Product selection step, you see two URLs. These are placeholders for two versions of the product feed that this channel receives from ChannelEngine – one in CSV and one in XML format.

To generate the product feed files for this channel:

1. Create a product selection for this channel.
2. Check which attributes the channel requires you to map, and make sure these attributes are stored in either the standard ChannelEngine fields or your custom fields.
3. If your product data contains custom fields, mark them as public. For guidance on marking custom fields as public, see the Custom fields section below.
4. Complete the remaining steps in Settings and configuration.
5. Let ChannelEngine run its export task for the first time. This task runs every 60 minutes.

The feed content is visible after you finish the Activation step and ChannelEngine completes its export task.

Custom fields

To include your custom fields in the generated feed and, therefore, expose your custom fields to this marketplace, mark them as public on ChannelEngine.

To mark your custom fields as public:

1. Go to Products, Custom fields.
2. Locate the custom field that you want to expose to this channel.
3. Change the Include in channel product feed status by selecting the pencil icon and setting it to enabled.

For more guidance on custom fields, check out ChannelEngine: custom fields.

Mappings

Content

Because HomeDeco uses ChannelEngine's Channel API, the mapping contains all standard ChannelEngine attributes. Some can be left empty, even though they are marked as required. However, it is recommended that you map as many attributes as possible. The more you map, the greater the visibility of the product on the marketplace is. This, in turn, tends to lead to a higher conversion rate.

All products (required)

• Brand - the product's brand. E.g.: Bamboosiness.
• Catalog price - the product's recommended price.
• Category - the product's category tree. E.g.: Verlichting > Tafellampen (Lighting > Table lamps).
• Color - the product's color. E.g.: groen.
• Description - the product's description.
• Details - the product's highlight. E.g.: Deze Bamboosiness tafellamp combineert stijl en duurzaamheid op een unieke manier (This Bamboosiness table lamp combines style and sustainability in a unique way).
• Extra image URL 1-9 - the product's additional images.
• GTIN - the product's unique identifier, such as its EAN.
• Image URL - the product's main image.
• Merchant product number - the product's internal identifier, such as its SKU. This attribute must be mapped to the Merchant product number, otherwise an error occurs when HomeDeco attempts to create an order.
• Name - the product's title. E.g.: Tafellamp Bamboosiness - Groen.
• Parent merchant product number - the Merchant product number of the product's parent, if applicable.
• Price - the product's price.
• Product URL - the link to the product detail page on your own website.
• Shipping cost - the cost to deliver the product.
• Shipping time - the average amount of time it takes to deliver the product. E.g.: 1-2 weken (1-2 weeks).
• Size - the product's size.
• Stock - the quantity of products available for purchase.
• Vendor product number - the product's internal identifier.

All products (optional)

• Discount percentage - the discount that applies to the product's price, without the percentage symbol. E.g.: 20.
• Purchase price - the product's purchase price.

Offer

Offer mappings appear if you have pricing v2 activated on this channel.

In Mappings, Offer mappings, the following offer attribute may appear on this channel, if this channel uses pricing v2:

• Allow promotion below min price - set it to ‘true’ to allow the promotion price to drop below your product's minimum price. 

In Mappings, Fee group mappings, map the marketplace fee group ID of the product.

Carrier

There is no carrier mapping required on HomeDeco.

Listed products

HomeDeco does not provide feedback via the API, so if you need information regarding the status of a product you need to contact HomeDeco.

FAQs

Why are my shipments stuck as 'Not exported yet'?

HomeDeco uses ChannelEngine's Channel API, so ChannelEngine does not initiate the import and export of data to and from the marketplace. If your shipments are not exported and not visible on [marketplace name]'s platform, something is incorrect with the import of the shipment information. Please contact [marketplace name]'s customer service to investigate this. You can copy ChannelEngine's Support team in the email, if needed.