Frais de Douane DDP / DAP — Guide complet

Présentation et prérequis

Le module Frais de Douane DDP / DAP est conçu pour les boutiques établies dans l’Union européenne qui expédient vers des destinations hors UE. Dès que l’adresse de livraison sort du territoire douanier de l’UE, un bloc de choix apparaît dans l’étape transporteur du checkout : le client décide de régler les droits de douane et taxes d’importation immédiatement avec sa commande (DDP) ou à la livraison auprès du transporteur (DAP).

• Compatible PrestaShop 8.0 à 9.x, thème Classic et thèmes dérivés.
• PHP 7.4 à 8.3.
• Multiboutique et multidevise : les frais sont calculés dans la devise du panier.
• Multilingue (FR/EN/ES/DE/IT, plus PT fourni).
• Aucune surcharge de fichiers : uniquement des hooks natifs.

Installation

Installez le module comme n’importe quel module PrestaShop :

1. Téléchargez l’archive dfcustomsduty.zip depuis votre compte client.
2. Dans le back-office, allez dans Modules > Gestionnaire de modules.
3. Cliquez sur Installer un module et déposez l’archive.
4. Une fois installé, cliquez sur Configurer.

À l’installation, le module enregistre ses hooks, crée ses tables (suivi du choix par panier, persistance par commande, taux par pays) et crée automatiquement un produit virtuel masqué « Frais de douane et taxes d’importation (DDP) », hors taxe et commandable hors stock. Ce produit n’apparaît jamais au catalogue : il sert uniquement de support de facturation lorsque le client choisit le mode DDP.

Configuration générale

La page de configuration regroupe les réglages du barème et de l’affichage :

• Activer le module : interrupteur global.
• Mode présélectionné au checkout : DDP (recommandé) ou DAP. C’est l’option cochée par défaut tant que le client n’a pas fait de choix.
• Taux par défaut (%) : pourcentage appliqué à la valeur de la commande pour estimer droits + TVA d’importation. Surchargé au cas par cas par les taux par pays.
• Frais fixes de dossier : montant fixe ajouté au calcul, dans la devise par défaut de la boutique, hors taxe.
• Seuil de franchise (de minimis) : en dessous de cette valeur de commande, aucun frais n’est appliqué. 0 = pas de seuil.
• Inclure les frais de port dans la base de calcul : la valeur en douane (CIF) inclut généralement le transport.
• Afficher une notice dans le panier : informe le client en amont qu’une livraison hors UE entraînera des frais.
• Pays du territoire douanier UE (codes ISO) : liste séparée par des virgules. Toute livraison vers un pays absent de cette liste est traitée comme hors UE.

Base et formule de calcul

Les frais estimés sont calculés ainsi, dans la devise du panier et hors taxe :

base = total produits HT (hors produit de frais)
       + frais de port HT   (si l'option est activée)

frais = base × taux_pays(%) + frais_fixes

Le seuil de franchise est évalué avant tout : si la base est inférieure au seuil applicable (seuil du pays s’il est défini, sinon seuil global), aucun frais n’est facturé. Les frais fixes et les seuils, stockés dans la devise par défaut de la boutique, sont automatiquement convertis dans la devise du panier.

Taux par pays de destination

Sous les réglages généraux, le formulaire « Ajouter / modifier un taux par pays » permet d’affiner le barème destination par destination :

• Pays de destination : sélectionné dans la liste des pays de la boutique.
• Taux (%) : remplace le taux global pour ce pays.
• Frais fixes : frais de dossier propres à ce pays.
• Seuil de franchise : seuil de minimis spécifique. Laissez 0 pour utiliser le seuil global.

Les taux enregistrés apparaissent dans un tableau récapitulatif sous le formulaire, où chaque ligne peut être supprimée. Un pays sans taux dédié utilise automatiquement les valeurs globales.

Expérience client au checkout

Lorsque la livraison est hors UE et qu’un barème s’applique, le client voit dans l’étape transporteur deux options :

Mode DDP — payer maintenant

Le produit de frais est ajouté au panier avec un prix calculé dynamiquement. Le montant s’intègre aux totaux de la commande, apparaît sur la facture et les e-mails natifs, et le client n’a plus rien à régler à la réception du colis. C’est l’expérience la plus proche d’un achat domestique.

Mode DAP — payer à la livraison

Aucun frais n’est ajouté à la commande, mais une estimation chiffrée est affichée et le client est averti que le transporteur lui réclamera les droits, taxes et éventuels frais de dossier avant la remise du colis. La mention figure ensuite sur sa commande et sa facture.

Le changement d’option est instantané : le panier et les totaux sont recalculés en AJAX, et la progression du checkout est préservée (le client reste à l’étape transporteur).

Suivi côté commande et facture

À la validation de la commande, le mode choisi, le montant et le pays de destination sont enregistrés. Ces informations sont ensuite visibles :

• dans le détail de commande côté client, avec un rappel clair de ce qui a été réglé ou reste dû ;
• sur la fiche commande du back-office, via un badge DDP ou DAP indiquant le montant et la destination ;
• sur la facture PDF, avec la mention Incoterm correspondante (DDP : droits réglés à la commande ; DAP : droits à la charge du destinataire).

Traductions

Tous les libellés visibles (bloc checkout, notice panier, détail de commande, back-office, mentions de facture) sont traduits. Le module est livré avec les fichiers de traduction pour le français, l’anglais, l’espagnol, l’allemand, l’italien et le portugais. Vous pouvez aussi ajuster n’importe quel texte depuis Paramètres avancés > Traductions > Traductions des modules dans le back-office.

FAQ et dépannage

Le bloc de choix ne s’affiche pas

Vérifiez trois points : le module est activé, l’adresse de livraison est bien hors du territoire douanier UE configuré, et un barème produit un montant supérieur à zéro (taux global ou taux pays renseigné, base supérieure au seuil de franchise). Tant que le taux reste à 0 % sans frais fixes, aucun bloc n’apparaît.

Le montant semble incorrect en multidevise

Les frais fixes et les seuils sont saisis dans la devise par défaut de la boutique puis convertis dans la devise du panier selon vos taux de change. Vérifiez que les taux de conversion de vos devises sont à jour.

Le produit « Frais de douane » apparaît-il dans mon catalogue ?

Non. Il est créé avec une visibilité « nulle part » et n’est utilisé que comme support de facturation interne en mode DDP. Ne le supprimez pas manuellement : la désinstallation s’en charge proprement.

Dois-je expédier différemment en DDP ?

Oui. En DDP, vous avez collecté les droits auprès du client : vous devez donc choisir un service d’expédition DDP auprès de votre transporteur ou transitaire, qui vous refacturera les droits réellement acquittés. Le module gère la collecte et l’information, pas la déclaration douanière elle-même.

Que se passe-t-il à la désinstallation ?

La désinstallation supprime les hooks, les variables de configuration, les tables du module et le produit virtuel de frais. Aucune donnée résiduelle n’est laissée en base.