Octopia-based channel guide

Summary

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

Octopia is the marketplace technology that powers Cdiscount and its network of partner marketplaces. A key requirement of this network 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.

 

Marketplace-specific Requirements and Exceptions

Octopia & Cdiscount

When doing business with Octopia, a product must be live on Cdiscount before it can be published on another marketplace part of the Octopia network. If a product is not part of the Cdiscount catalog, then it will not be possible to send that product to other Octopia-powered marketplaces like Worten, Empik or Rakuten

 

 

 

Setup

On Octopia
Cdiscount operates as an Octopia-based marketplace. To integrate your Cdiscount account with Activation, follow these steps to retrieve your Seller ID from the Octopia API portal:

  1. Access the Octopia API portal: Go to the Octopia API portal homepage.
  2. API Credentials: Click on API Credentials Management and select Get Access.
  3. Choose feed aggregator option: 
    1. Select I am using a feed aggregator, followed by My aggregator only requests my Seller ID. 
    2. you can also select "I know my agregator's clientId and input AKENEO
  4. Select Akeneo (for Activation): From the drop-down list, choose Akeneo.
  5. Grant access: Provide Akeneo Activation access to your seller account.
  6. Retrieve Seller ID: Enter your Octopia seller zone credentials, receive your Seller ID, and save it for later use.

Now back on Activation
To finalize the connection between Activation and Cdiscount:

  1. In Activation, navigate to the Channels tab.
  2. Click Connect on any Octopia channel tile.
  3. Name your channel and enter the Seller ID you previously saved.
  4. Click Save. A "Connected to Octopia" status in your channel settings confirms a successful connection.

Catalog Creation and requirement management

Catalogs are required for creating or updating product information on Octopia Powered Channels like Cdiscount, CDON or Rakuten. The category list is available in French, English and Spanish. Catalogs only need to be mapped once, in any of the three locales below, and then Octopia will handle the delivery and the translation of the product information to different supported locales.

Ex: CDON operates in Sweden. To send product information to CDON, the catalog mapping will have to be done in French/English/Spanish, and then Octopia will take care of sending it in Swedish to CDON.

Supported Languages
Octopia only supports the following languages for product submissions:

  • French
  • English
  • Spanish

If you submit product information in any other language, it will not be processed by Octopia.

Automatic Translation for Marketplaces
When you submit product details in one of the supported languages, Octopia will automatically translate the product sheet into the required language of the target marketplace.

Example

  • If you submit a product with product information in English and want to sell it on CDON Sweden, Octopia will translate the product description into Swedish so that it displays correctly on the marketplace.

This ensures your products are properly localized for buyers, even if you only provide details in French, English, or Spanish.

 

Product Information Mapping

Content

Required for all products:

  • Brand: Specify the product's brand.
  • Description: Provide a product description. Note that HTML is not supported, and the description is limited to 2,000 characters.
  • Main Image URL: Ensure that the image adheres to the following:
    • Resolution: Between 500x500 px and 3,000x3,000 px.
    • Format: JPG, JPEG, PNG, GIF.
    • Maximum file size: 5 MB.
    • URL must start with 'https://'.
  • Title: The product's title displayed on the detail page. Ideally formatted as: [Product type] - [Brand] - [Description keywords] - [Model (for technical products)] - [Gender, if applicable]. Maximum length: 132 characters. Titles must be unique, or they will be rejected by Cdiscount.

Optional for all products:

  • Additional Images: You may provide up to five additional image URLs. Follow the same requirements as the main image.

Category-specific:

  • Marketing Description: A long product description supporting limited HTML tags (bold, strong, br). Maximum length: 5,000 characters.
  • ISBN: Required for books.
  • Labels and Certifications: Certifications such as organic, fair trade, or NF environment.

Cdiscount product update

You can only modify product information if you were the original creator of that product on Cdiscount.

 

 

Managing Offers on Octopia (Cdiscount)

You can manage offers for Octopia-based marketplaces (e.g., Cdiscount) directly within Akeneo Activation. This feature supports importing and synchronizing commercial data—such as prices, stock levels, and channel-specific fees—via manual, API, or FTP workflows.

CSV Template Requirements

The offer import template for Octopia requires specific fields distinct from other marketplaces.

 

To successfully create and update offers on Cdiscount, your CSV file must include the standard product and stock information plus the following mandatory columns:

  • VAT (Value Added Tax)
  • Eco-share / DEA
  • Preparation Times (Must be between 1 and 5 days)
  • Delivery Costs (For selected shipping methods)

 

The order of columns in your CSV file is flexible; Akeneo Activation will process the data correctly as long as the required headers are present.

 

 

Column Name Examples Required Note
offer_sku product_1SKU ✅  
product_identifier offer_sku_1_1 ✅  
stock_condition   ✅ Possible Values: 
- UsedLikeNew
- UsedVeryGoodState
- UsedAverageState
- New
- RefurbishedLikeNew
- RefurbishedVeryGoodState
- RefurbishedCorrectState
base_price_amount 10.0 ✅  
base_price_currency EUR ✅  
origin_price_amount 8.0 ✅ / ❌  
tax_code_1 VAT ✅ Possible Values:
VAT: Value Added Tax applied to the sale of goods and services in France.
Ecotax: Environmental tax applied to certain products to finance recycling and waste management. Applicable to items such as electronics, furniture, or household appliances.
Deatax: Tax related to the recycling of electrical and electronic equipment (DEEE). Covers the cost of collecting and treating end-of-life electronic products.
PrivateCopy: Levy applied to products enabling digital recording or storage of copyrighted works.
tax_value_1 0.2 ✅  
tax_code_2   ❌  
tax_value_2   ❌  
tax_code_3   ❌  
tax_value_3   ❌  
tax_code_4   ❌  
tax_value_4   ❌  
delivery_mode_code_1 NTHD ✅ Possible 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 ✅  
delivery_mode_additional_cost_1 2.99 ✅  
delivery_mode_code_2   ❌  
delivery_mode_cost_2   ❌  
delivery_mode_additional_cost_2   ❌  
preparation_times 2 ✅  
stock_quantity 10 ✅  

Octopia Offer Template

 

Order Management

This section details key considerations for managing Octopia orders within Activation.

 

Fulfillment and Shipping

  • Shipping Address: In most cases, all items within an order share the same shipping address. While the Octopia API can support different addresses per item, no channel currently uses this feature.
  • Partial Shipments: Partial shipment is NOT available for Cdiscount
  • Mixed Fulfillment: For multi-line orders, it is possible (though rare, <1% of non-Cdiscount orders) to have items fulfilled by both the seller and the marketplace. This cannot currently happen on Cdiscount orders.

 

Buyer and Tax Information

  • Recipient Information: The buyer name, email, and phone number displayed in the Activation UI are the recipient's details, which are sourced from the shipping information section of the order. There can be a difference in the buyer details and the recipient details.
  • VAT Calculation: The calculation method depends on the seller's registration country.
    • For French-registered sellers on Cdiscount.com, the order data provides the VAT rate, but the seller is responsible for calculating the final amount. Consequently, Activation will not display a tax amount for these orders.
    • For sellers registered outside of France, the VAT amount will be provided directly in the order data.

Want to find out more? Take a look at these related articles