COCOLI: marketplace guide

About this guide

This is a ChannelEngine guide on the Berlin-based marketplace COCOLI. Here you can find information on how to request a COCOLI 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

FAQs

Commercial information

How to request an account

To start selling on COCOLI, contact its partner team via email.

Associated costs

COCOLI does not charge any setup or monthly fees, but it does charge a commission of 20-50% – depending on your logistic needs.

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 COCOLI is a Channel API marketplace, the mappings contain all standard ChannelEngine attributes. Some can be left empty, even though they are marked as required. However, it is recommended to 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.

Although all attributes are written in English, COCOLI requires content in German.

All products (required)

• Depth - the product's depth in cm.
• Describe condition - the product's condition. E.g.: like new, refurbished, used, etc.
• Ext. SKU - the product's SKU, usually its Merchant product number.
• Height - the product's height in cm.
• Image primary - the product's main image. The requirements are:
  • Formats - JPG, JPEG, PNG, WEBP.
  • Resolution - 500-10,000 px (width); 500-10,000 px (height).
  • Recommended size - less than 10 MB.
• Main color - the product's main color.
• Primary material - the product's main material.
• Title - the product's title.
• Width - the product's width in cm.

All products (optional)

• Brand name - the product's brand.
• Bulb included - if a light bulb is included in the product or not.
• Country of production - the country where the product was made.
• Dimmable - if the product supports dimming or not.
• EAN - the product's GTIN.
• Image additional - the product's additional images. For the requirements, check the Image primary attribute. 
• Image back - an image showing the product's back, if applicable.
• Image bottom - an image showing the product's bottom, if applicable.
• Image defect - an image showing the product's defects, if any.
• Image detail - an image showing the product in detail, if applicable.
• Image front - an image showing the product's front, if applicable.
• Image left - an image showing the product from the left-hand side, if applicable.
• Image right - an image showing the product from the right-hand side, if applicable.
• Image top - an image showing the product from the top, if applicable.
• Inventory quantity - defines if the product comprises a single unit, or it is part of a pair or set.
• Original price - the product's original or recommended price, if it is a new product. Although optional, mapping this attribute is highly recommended as the value within it is shown by COCOLI on both the results and product detail pages.
• Period - the decade when the product was made, or the decade it emulates.
• Personal description - the product's description.
• Seating height - the height at which a person sits when using the product, if applicable.
• Secondary material - the product's secondary material, if applicable.
• Socket type - the type of power plug the product has. E.g.: Europlug, BS 1363, etc.
• Status of condition - the product's physical condition. E.g.: acceptable, repairs needed, not used, etc.
• Style - the product's style. E.g.: antique, art deco, industrial, Scandinavian, etc.

• Type of condition - the category of the product's condition. E.g.: B ware, discontinued or overproduction, refurbished, vintage, etc.

  NB: COCOLI uses the different condition attributes to refine its discovery system, so it is important to map them.

Offer

Required

• Seller price - the product's price.
• Stock count - the product's stock.

Carrier

Although recommended, carrier mapping is not required on COCOLI. However, you need to provide a tracking code or a tracking URL with every shipment.

FAQs

Why are my shipments stuck as 'Not exported yet'?
COCOLI 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 COCOLI's back-end platform, something is wrong with the import of the shipment information. Please contact COCOLI's customer service to investigate this. You can copy ChannelEngine's Support team in the email, if needed.