> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://doc.common-services.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Préambule Cdiscount

## Compatibilité

La branche 4.5 du module Cdiscount Marketplace est compatible avec PrestaShop **1.7 à 9.x**.

Utilisez toujours la dernière version du module fournie par Common-Services (Addons ou lien de mise à jour support).

## Préconfiguration

Par défaut, la configuration d’origine convient aux besoins courants.
Ne modifiez les réglages avancés que si nécessaire, et uniquement si vous en maîtrisez l’impact.

## Où retrouver le module

Une fois installé et configuré, vous trouverez le module ici :

- **Modules > Module Manager > Cdiscount** (bouton Configurer) : configuration complète (onglets Connexion, Modèles, Profils, Catégories, Transport, Paramètres, Cron, etc.)
- **Catalogue > Cdiscount** : création de produits (Product Integration) et envoi / mise à jour des offres (Offer Integration)
- **Commandes > Cdiscount** : acceptation et import des commandes
- **Fiche produit PrestaShop** : sous-onglet **Cdiscount** (options optionnelles : prix forcé, stock forcé, délai, commentaire d’offre, etc.)

## À lire avant de configurer

1. [Bien savoir différencier une offre et un produit (CDiscount)](https://doc.common-services.com/fr/article/bien-savoir-differencier-une-offre-et-un-produit-cdiscount-1rgd0j/)
2. [Valider votre structure de catalogue (Cdiscount)](https://doc.common-services.com/fr/article/valider-votre-structure-de-catalogue-cdiscount-bvnfse/)
3. Puis la section **Configurer** (installation → connexion Octopia → modèles → profils → catégories → transport)

## Connexion Octopia

Le module se connecte à la place de marché via **Octopia** (API Cdiscount).
Vous aurez besoin d’un **Client ID**, d’un **Client Secret** et d’un **Seller ID**.

Voir : [Paramètres de Connexion (Cdiscount)](https://doc.common-services.com/fr/article/parametres-de-connexion-cdiscount-…)

*(Conservez le lien exact de votre article Connexion dans le helpdesk.)*

## Profils et Modèles

Le module s’articule autour de deux notions :

- **Le Modèle** : définit la **catégorie / taxonomie Cdiscount** et les champs attendus (caractéristiques, attributs, variantes). C’est ici que vous choisissez la catégorie marketplace.
- **Le Profil** : applique les **règles métier** (prix, port, stock, délai de préparation, CDaV…) et est associé à un modèle. Dans l’onglet **Catégories**, vous liez vos catégories PrestaShop à un profil.

> 💡 En résumé : la catégorie Cdiscount se configure dans le **Modèle**. Le **Profil** porte les règles d’export. L’onglet **Catégories** relie vos catégories PrestaShop au profil choisi.
>
> Le modèle est surtout indispensable pour la **création de fiches produits**. Pour publier uniquement des offres sur des produits déjà connus (matching EAN), un profil + transport correctement configurés peuvent suffire.

## Codes EAN / GTIN

Le module fonctionne en **matching** et en **création** :

- Si l’EAN existe déjà chez Cdiscount/Octopia → votre **offre** peut s’y associer (matching).
- Si l’EAN est inconnu → il faut d’abord **créer le produit** (Product Integration), puis envoyer l’offre.

L’usage de codes privés / locaux (ex. 200…, 000…) ou non GS1 est interdit.

> ⚠️ Important : le **GTIN/EAN est obligatoire** pour toute création de produit. Aucune exemption n’est accordée par Octopia/Cdiscount.

## Parcours recommandé (première mise en ligne)

1. Installer le module et enregistrer la configuration
2. Connecter Octopia (Credentials)
3. Créer au moins un **Modèle** + un **Profil**
4. Cocher les **Catégories** PrestaShop et leur associer le profil
5. Configurer le **Transport** (modes + ChargeMin)
6. Décider : création produits (si EAN inconnu) puis **Full Package** des offres
7. Configurer les **tâches planifiées** (cron)