> ## 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).

# Configurer le Transport

## Transporteurs disponibles

Le module affiche les transporteurs que vous avez préalablement sélectionnés dans votre back-office Cdiscount. Seule cette sélection apparaîtra dans votre module :

![PrestaShop Cdiscount choix d'expédition](https://storage.crisp.chat/users/helpdesk/website/-/3/f/a/8/3fa8ee645cd13200/prestashop-cdiscount-choix-dex_g2eslm.png)

> 📌 **Règles importantes pour le calcul des frais de port :**
> * **Zone de destination :** Lors de l'export des offres, les frais de port sont calculés spécifiquement sur la base des tarifs configurés pour la zone **France** dans votre PrestaShop (et non par pays de destination individuel).
> * **Produits lourds (> 30 kg) :** Les articles dépassant 30 kg ne peuvent pas utiliser les modes de livraison standards et nécessitent des modes spécifiques pour grands colis. Si aucun mode grand colis n'est associé dans le module, le produit risque d'être ignoré lors de l'export d'offres.

---

## Configuration simplifiée

Le champ **Délai de préparation** est **strictement obligatoire**. Il indique le temps (en jours ouvrés) nécessaire à la préparation et à l'expédition de la commande. Cette valeur par défaut peut être surchargée par profil ou directement sur chaque fiche produit.

![PrestaShop Cdiscount temps de préparation](https://storage.crisp.chat/users/helpdesk/website/-/3/f/a/8/3fa8ee645cd13200/prestashop-cdiscount-temps-de-_ozsxt0.png)

Au minimum, vous devez configurer vos modes de livraison obligatoires et leur associer un transporteur PrestaShop :

![PrestaShop Cdiscount frais de port](https://storage.crisp.chat/users/helpdesk/website/-/3/f/a/8/3fa8ee645cd13200/prestashop-cdiscount-frais-de-_1wn2rmz.png)

### Frais de port minimum
Bien que la colonne **Minimum** soit mise en évidence en rouge dans l'interface, le code du module permet de la laisser vide.

* **Comportement par défaut :** Si le champ est laissé vide, le module s'appuiera uniquement sur la grille de votre transporteur PrestaShop. Si vous renseignez un montant Minimum, il sert de prix plancher : le module compare le tarif calculé via votre grille au montant Minimum indiqué, puis exporte la valeur la plus élevée.
* **Saisir « 0 » :** Indiquer `0` ne signifie **pas** que la livraison sera gratuite ; le tarif de la grille s'appliquera toujours. Si vous ne souhaitez aucun prix plancher, laissez simplement la case vide.
* **Import de commandes :** Un champ Minimum vide ne bloquera **pas** l'importation de vos commandes.

---

## Logique de calcul détaillée

### Transporteurs associés
* **Transporteurs obligatoires :** Les modes d'expédition exigés par Cdiscount.
* **Transporteurs optionnels :** Les modes d'expédition complémentaires proposés à vos clients.

### Ordre de calcul des frais de port
Lors de l'export des offres (en XML), les frais de port sont calculés dans l'ordre suivant :
1. **Grille au poids :** Le module vérifie la grille par poids du transporteur PrestaShop. Si une tranche correspond, cette valeur est utilisée.
2. **Grille au prix :** Si la grille au poids est vide ou ne contient aucune tranche correspondante, le module vérifie la grille par prix.
3. **Application du prix plancher :** Le tarif calculé est comparé à la valeur **Minimum**. Le module exporte le montant le plus élevé des deux.

### Définition des champs

1. **Minimum :** Le tarif plancher de sécurité. Par exemple, si votre grille PrestaShop indique 1,00 € mais que votre Minimum est réglé sur 5,00 €, c'est la valeur de 5,00 € qui sera exportée. Si le champ est vide, le tarif exact de la grille est envoyé.
2. **Additionnel :** Montant **absolu** (en euros), optionnel, appliqué comme frais de port additionnel pour les unités supplémentaires du même article. Ce n’est **pas** un pourcentage. Exemple : `2.50` = 2,50 € d’additionnel. Laissez vide si non utilisé. Utilisez un point comme séparateur décimal (ex. `4.50`).

---

## Types de synchronisation et écrasement sur Octopia

> ⚠️ **Important si vous gérez vos tarifs directement sur Octopia :**
> * **Export d'offres complet (XML) :** Envoie l'ensemble des données d'offres, **y compris les frais de port**. Exécuter un export complet **écrasera** les tarifs de livraison configurés directement dans le back-office Octopia / Cdiscount.
> * **Synchronisation Stock & Prix (XML) :** Met à jour uniquement les stocks et les prix. Elle **n'envoie pas de données de livraison**, préservant ainsi les tarifs gérés directement sur Octopia.

---

## Notification de suivi des colis

Les transporteurs sont référencés sur Cdiscount selon une nomenclature précise :
* Le nom du transporteur
* L'URL de suivi par défaut

Dans cette section, associez chaque transporteur Cdiscount au transporteur PrestaShop correspondant.

* Si l'URL de suivi n'est pas renseignée dans la configuration de votre transporteur PrestaShop, l'URL par défaut de Cdiscount sera utilisée comme solution de repli.
* C'est le nom officiel du transporteur Cdiscount sélectionné qui sera transmis lors des mises à jour de statut d'expédition.

> 💡 *Note : Le fonctionnement de la notification de suivi reste valide sur toutes les versions du module, bien que les intitulés de l'interface puissent légèrement varier selon votre version.*