This guide provides specific instructions and requirements for connecting to and managing Octopia-powered channels, such as Cdiscount, through Akeneo Activation.
The role of Octopia in Akeneo Activation
Octopia is the marketplace technology that powers Cdiscount and its network of partner marketplaces. When working with Octopia channels in Akeneo Activation, a key requirement is that a product must first be live on Cdiscount before it can be published to any other Octopia-powered marketplace, such as Worten, Empik, or Rakuten.
A product must be live on Cdiscount before it can be published on any other marketplace in the Octopia network. If a product is not part of the Cdiscount catalog, it cannot be sent to other Octopia-powered marketplaces like Worten, Empik, or Rakuten.
Set up your Octopia channel in Activation
To connect an Octopia-based marketplace to Akeneo Activation, you need to retrieve your Seller ID from the Octopia API portal and then finalize the connection in Activation.
Retrieve your Seller ID from the Octopia API portal
- Go to the Octopia API portal homepage.
- Click API Credentials Management and select Get Access.
- Select your feed aggregator option:
- Select I am using a feed aggregator, followed by My aggregator only requests my Seller ID.
- Alternatively, select I know my aggregator's clientId and enter
AKENEO.
The screenshot above shows the Octopia API portal homepage with the API Credentials Management section.
The screenshot above shows the Get Access page for the Octopia API Credentials Management.
The screenshot above shows the feed aggregator selection screen on the Octopia API portal.
The screenshot above shows the aggregator clientId input field, where you enter AKENEO.
The screenshot above shows the aggregator selection dropdown on the Octopia API portal.
- From the drop-down list, choose Akeneo.
- Grant Akeneo Activation access to your seller account.
- Enter your Octopia seller zone credentials, receive your Seller ID, and save it for later use.
The screenshot above shows the Seller ID retrieval screen on the Octopia seller zone.
Connect your Octopia channel in Activation
To finalize the connection between Akeneo Activation and Cdiscount:
- In Activation, navigate to the Channels tab.
- Click Connect on the Octopia channel tile.
- Name your channel and enter the Seller ID you retrieved from the Octopia API portal.
- Click Save. A "Connected to Octopia" status in your channel settings confirms a successful connection.
The screenshot above shows the Activation channel settings tab with the "Connected to Octopia" status displayed.
Catalog creation and requirement management for Octopia
Catalogs in Akeneo Activation are required to create or update product information on Octopia-powered channels such as Cdiscount, CDON, or Rakuten. Each catalog is designed for a single product family and tailored to the requirements of the selected Octopia channel.
The Octopia category list is available in French, English, and Spanish. Catalogs only need to be mapped once in any of these three languages — Octopia handles delivery and translation of the product information to the supported locale of each destination marketplace.
Example: CDON operates in Sweden. To send product information to CDON, map your catalog in French, English, or Spanish. Octopia then delivers the product sheet in Swedish to CDON.
Supported languages for Octopia product submissions
Octopia only processes product submissions in the following languages:
- French
- English
- Spanish
Product information submitted in any other language will not be processed by Octopia.
Automatic translation for Octopia marketplaces
When you submit product details in one of the three supported languages, Octopia automatically translates the product sheet into the required language of the target marketplace.
Example: Submit a product in English for CDON Sweden, and Octopia translates the product description into Swedish for display on the marketplace.
Product information mapping for Octopia channels
This section describes the fields required when mapping product data for Octopia-powered channels in Akeneo Activation.
Required fields for all products
- Brand: The product's brand name.
- Description: A plain-text product description. HTML is not supported, and the maximum length is 2,000 characters.
- Main Image URL: The primary product image. Requirements:
- Resolution: between 500×500 px and 3,000×3,000 px.
- Format: JPG, JPEG, PNG, or GIF.
- Maximum file size: 5 MB.
- URL must begin with
https://. -
Title: The product title displayed on the detail page. Recommended format:
[Product type] - [Brand] - [Description keywords] - [Model (for technical products)] - [Gender, if applicable]. Maximum length: 132 characters. Titles must be unique — Cdiscount rejects duplicate titles.
Optional fields for all products
- Additional Images: Up to five additional image URLs. The same requirements as the main image apply.
Category-specific fields
-
Marketing Description: A long product description supporting limited HTML tags (
<b>,<strong>,<br>). Maximum length: 5,000 characters. - ISBN: Required for books.
- Labels and Certifications: Certifications such as organic, fair trade, or NF environment.
You can only modify product information on Cdiscount if you were the original creator of that product. Products created by another seller cannot be updated through Akeneo Activation.
Manage offers on Octopia channels
In Akeneo Activation, you can manage offers for Octopia-powered marketplaces (such as Cdiscount) directly within the channel. Offer data includes commercial information such as prices, stock levels, tax codes, and delivery costs. You can import offer data manually via CSV upload, via FTP or SFTP, or through the Offer API.
For details on the Offer API and general offer management, see Sending product offers to marketplaces and Import product offers to Activation.
The offer import template for Octopia channels requires specific fields that are distinct from other marketplaces. Use the Octopia-specific CSV template below.
Octopia offer CSV format
To create or update offers on Octopia-powered marketplaces, your CSV file must include the following columns. The order of columns is flexible — Akeneo Activation processes the data correctly as long as the required column headers are present.
| Column name | Example | Required | Notes |
|---|---|---|---|
offer_sku |
offer_sku_1_1 | Yes | The offer identifier. Can be the product SKU or a customer-defined identifier. |
product_identifier |
product_1SKU | Yes | Must be the product SKU used in Activation. |
stock_condition |
New | Yes | Accepted values: New, UsedLikeNew, UsedVeryGoodState, UsedAverageState, RefurbishedLikeNew, RefurbishedVeryGoodState, RefurbishedCorrectState. |
base_price_amount |
10.0 | No | The current selling price (may be a promotional price). |
base_price_currency |
EUR | No | The currency for base_price_amount. |
origin_price_amount |
8.0 | No | The struck-through (original) price displayed alongside the current price. |
tax_code_1 |
VAT | Yes | The primary tax type. Accepted values: VAT (Value Added Tax on goods and services in France), Ecotax (environmental tax for recyclable products), Deatax (DEEE recycling tax for electronic equipment), PrivateCopy (levy on products enabling digital recording). |
tax_value_1 |
0.2 | Yes | The value for tax_code_1. |
tax_code_2 |
No | A secondary tax type. Same accepted values as tax_code_1. |
|
tax_value_2 |
No | The value for tax_code_2. |
|
tax_code_3 |
No | A tertiary tax type. Same accepted values as tax_code_1. |
|
tax_value_3 |
No | The value for tax_code_3. |
|
tax_code_4 |
No | A fourth tax type. Same accepted values as tax_code_1. |
|
tax_value_4 |
No | The value for tax_code_4. |
|
delivery_mode_code_1 |
NTHD | Yes | The primary delivery mode code. Accepted values: NTHD (NotTrackedHomeDelivery, Cdiscount only), THD (TrackedHomeDelivery), EHD (ExpressHomeDelivery), SHD (SignedHomeDelivery), FDHD (FixedDateHomeDelivery), SRHD (SpecificRoomHomeDelivery), WSHD (WithSetupHomeDelivery), IVP (ImmediateVendorPickup, Cdiscount only), SVP (VendorPickup, Cdiscount only), PPMR (PickupPointMondialRelay, Cdiscount only), PPRC (PickupPointRelaisColis, Cdiscount only), PPLP (PickupPointLaPoste, Cdiscount only). |
delivery_mode_cost_1 |
1.99 | Yes | The shipping cost for delivery_mode_code_1. |
delivery_mode_additional_cost_1 |
2.99 | Yes | The additional per-item shipping cost for delivery_mode_code_1. |
delivery_mode_code_2 |
No | A secondary delivery mode code. Same accepted values as delivery_mode_code_1. |
|
delivery_mode_cost_2 |
No | The shipping cost for delivery_mode_code_2. |
|
delivery_mode_additional_cost_2 |
No | The additional per-item shipping cost for delivery_mode_code_2. |
|
preparation_time |
2 | Yes | The number of days between order confirmation and carrier pickup. Must be between 1 and 5. |
stock_quantity |
10 | No | The available stock quantity. |
Download the Octopia offer template
Both comma (,) and semicolon (;) delimiters are supported. Akeneo Activation auto-detects the delimiter from the file header. Enum values (such as stock_condition and tax_code_1) are case-insensitive.
Order management for Octopia channels
This section describes key considerations for managing orders from Octopia-powered channels (such as Cdiscount) within Akeneo Activation.
Fulfillment and shipping
- Shipping address: In most cases, all items within an order share the same shipping address. The Octopia API supports different addresses per item, but no current Octopia channel uses this capability.
- Partial shipments: Partial shipment is not available for Cdiscount.
- Mixed fulfillment: For multi-line orders, it is possible (though rare, in fewer than 1% of non-Cdiscount orders) for items to be fulfilled by both the seller and the marketplace. This cannot happen on Cdiscount orders.
Buyer and tax information
- Recipient information: The buyer name, email, and phone number displayed in the Activation interface are the recipient's details, sourced from the shipping information section of the order. Buyer details and recipient details may differ.
- VAT calculation: The calculation method depends on the seller's country of registration.
- For sellers registered in France on Cdiscount.com, the order data provides the VAT rate, but the seller is responsible for calculating the final tax amount. Akeneo Activation does not display a tax amount for these orders.
- For sellers registered outside France, the VAT amount is included directly in the order data.