Frais de port Gérez les frais de port selon deux modalités à choisir : par quantité commandée ou par montant de la commande. Avec gestion des zones, des tranches et du franco. 1- Le module Frais de Port Tout ce qu'il faut pour installer et paramétrer votre module. 1.1- Présentation Le module frais de port pour Dolibarr vous permet de calculer des frais de port sur les devis et les commandes de vente de vos clients. Il est basé sur 2 options principales et 4 principes : 2 options de calcul : vous choisissez de travailler sur les frais de port selon la quantité commandée ; ou selon le montant commandé. 4 Principes généraux : Vous définissez des grilles de frais de port en fonction des quantités ou du montant (selon l'option choisie). Chaque grille de prix sera une "zone de transport", et vous définissez les prix pour chaque palier ou franco de port ; Vous indiquez sur vos fiches clients sa zone de transport par défaut (que vous pourrez toujours modifier au cas par cas sur les devis et commandes) ; Pour l'option frais de port par quantité, vous définissez une unité de référence qui sera "l'unité de transport" et vous indiquez sur chaque produit son équivalent dans l'unité de référence ; Vous ajoutez vos produits à vos devis ou commandes et le module calcule les frais automatiquement en fonction de la quantité des produits ou du montant, et de la zone de frais de transport. Le cas d'usage envisagé dans cette documentation pour les frais de port par quantité est le transport de vin. Mais vous pouvez transposer cela à tout produit dont les frais de transport sont calculés en fonction de la quantité (et non du poids ou du montant de la commande). Le cas des frais de port par montant de la commande s'applique quand à lui à de nombreuses activités. 1.1.1- Fonctionnalités  Un encart dynamique sur les documents (devis, commande) indique le montant des frais au fur et à mesure que vous ajoutez les produits à votre document. Quand vous avez terminé, vous ajoutez la ligne de port sur la commande. Les frais de port sont calculés en fonction de la grille de frais de port que vous avez définie dans la configuration selon deux aspects : la zone de livraison définie sur le tiers et/ou sur la commande qui correspond à une zone dans votre configuration ; des grilles tarifaires définies pour chaque zone avec pour chaque palier défini : pour le calcul par quantité : un forfait, un prorata ou un franco ; pour le calcul par montant : un coût ou un franco. Pour le calcul par quantité : l’équivalent en unité de livraison sur chaque produit (tout est ramené à la même unité : équivalent nombre de bouteille, équivalant nombre de panier, équivalant nombre de kg etc.). 1.1.2- Compatibilité et conformité du module  Ce module ne remet pas en cause la conformité de Dolibarr à la loi de finances 2025 pour la lutte contre la fraude à la TVA. 1.1.3- Cible Le module s'adresse à tous les utilisateurs de Dolibarr. Son utilisation ne nécessite aucune connaissance technique ou d'administration. 1.1.4- Licence  Tous nos modules sont distribués sur notre boutique en ligne et sur le  Dolistore sous licence GPL v3. 1.1.5- Ressources 1.1.5.1- La présente documentation Nos guides utilisateurs sont là pour vous accompagner sérieusement dans l'utilisation de nos modules. Certains contiennent de nombreuses pages, mais leur lecture est essentielle pour la bonne compréhension des fonctionnalités des modules. 1.1.5.2- Notre site de démonstration Le module est installé sur notre  environnement de démonstration . Connectez-vous avec l'identifiant demo et le mot de passe demo.  1.1.5.3- Forum Consultez toutes les informations sur le module dans les discussions des forums Français . Nous créons pour chacun de nos modules une discussion sur le  forum dolibarr . Ces discussions contiennent de nombreuses informations. Aussi, si vous avez des commentaires et suggestions, pour une réponse plus rapide, il est préférable de continuer sur cette même conversation. Note : Le forum est un lieu d'échange autour de l'utilisation et des fonctionnalités de nos modules. En cas de difficultés d'utilisation ou pour toute remontée de bogue, vous pouvez créer un ticket sur notre interface de support . Par ailleurs, nous vous remercions de ne pas multiplier les canaux d'échange pour un même objet sur le forum. 1.2- Avant de commencer 1.2.1- Avertissement Nous assurons le bon fonctionnement de nos modules sur les environnements natifs de Dolibarr. Nous ne pouvons pas en garantir le bon fonctionnement suite à des modifications effectuées sur les fichiers du noyau de Dolibarr ou en cas d'utilisation d'autres modules additionnels. Cette documentation s'appuie sur le module en version 2024.09.2 avec Dolibarr version 19. En cas d'utilisation d'autres versions ou selon le thème utilisé, vous pourrez constater des différences de fonctionnement ou d'affichage. 1.2.2- Pré-requis techniques Le module Frais de port est compatible avec Dolibarr à partir de version 19. 1.2.3- Mises à jour Les dernières versions de nos modules sont mises à disposition sur le Dolistore et sur notre site internet .  L'accès aux mises à jour de nos modules est gratuit pendant 1 an à compter de leur date d'achat. Avant toute mise à jour, assurez-vous que le module est officiellement compatible avec la version de Dolibarr sur laquelle vous souhaitez l'installer. Pour mettre à jour un module, téléchargez-le à nouveau sur le Dolistore avec l'identifiant utilisé lors de l'achat initial où nous rendons systématiquement disponibles en téléchargement les dernières versions de nos modules. Dézippez les fichiers de la dernière version du module dans le répertoire custom de votre environnement et confirmez le remplacement de ceux déjà présents, ou bien utilisez la fonctionnalité de déploiement d'un module externe dans la configuration. Note : Pour le bon déroulement d'une mise à jour, désactivez le module avant de lancer le remplacement de ses fichiers puis réactivez le. À l'issue de la mise à jour, il est conseillé de répéter l'opération de désactivation/activation pour être sûr du bon déroulement d'une éventuelle mise à jour de votre base de données. Vérifiez enfin si de nouveaux paramétrages sont nécessaires. 1.3- Mise en route et paramétrage 1.3.1- Procédure d'installation Si vous avez accès aux fichiers de votre Dolibarr, dézipper l'archive du module dans le dossier custom de son arborescence. Sur les versions récentes de Dolibarr, le module zippé peut être installé directement depuis la page : A ccueil > C onfiguration > M odules/ A pplications, onglet D éployer/Installer un module externe.  1.3.2- Activation  Activez le module en affichant la liste des modules depuis les menus : A ccueil > C onfiguration > M odules/ A pplications, onglet M odules/ A pplications installés. Il sera affiché dans le tableau Altairis. Activez le module en cliquant sur la pastille pour quelle devienne verte ; Pour désactiver le module cliquer de nouveau sur la pastille pour quelle devienne blanche. 1.3.3- Permissions Les accès aux fonctionnalités du module sont accessibles à l’utilisation à tout utilisateur disposant des droits sur les devis, commandes clients, les tiers et les produits/services. Le paramétrage des zones et des grilles tarifaires par palier se fait dans les réglages du module et est donc réservé aux administrateurs. 1.3.4- Paramétrage La page de configuration du module est accessible depuis la liste des modules installés ( A ccueil > C onfiguration > M odules/ A pplications) en cliquant sur son icône  . Les paramétrages du module se déroulent en trois temps : paramétrage module, paramétrage tiers, paramétrage produits. Il est bien entendu très fortement conseillé de prendre le temps de faire des tests correspondant à votre situation en balayant tous les cas de figure, avant la mise en production. 1.3.4.1- Choix de la méthode de calcul Vous devez avant toute chose choisir quelle méthode de calcul vous allez utiliser : au montant de la commande ou bien à la quantité commandée. Un message d'alerte vous invite à faire ce choix à l'activation du module. Ensuite, vous devez sélectionner le service qui sera utilisé pour ajouter une ligne de frais de port à vos commandes. 1.3.4.2- Choix du service à utiliser dans les documents comme frais de port Via la liste déroulante, choisissez le service associé aux frais de port. S'il n'existe pas encore, il faudra d'abord le créer. 1.3.4.3- Créez les zones de transport Pour créer une zone de transport sur laquelle va s'appliquer une grille de prix, saisissez son nom dans la zone de texte "Ajoutez une zone" puis cliquez sur le bouton "Créer". Vous retrouverez la zone créé dans la liste déroulante "Zone de frais de port :" Pour créer une nouvelle zone : répétez l'opération précédente. Puis choisissez la zone dans la liste déroulante pour paramétrer la grille de prix de cette zone. 1.3.4.3- Pour chaque zone, paramétrez les paliers de votre grille de prix Dans la liste déroulante, choisissez la zone à paramétrer. Le tableau va se recharger avec les informations de cette zone. Vous pouvez ensuite commencer à remplir votre grille tarifaire pour cette zone. Ajouter autant de paliers tarifaires que souhaités en remplissant la ligne d'ajout au dessus du tableau. Enregistrez votre ligne ajoutée en cliquant sur le bouton "Ajouter". Saisissez la ligne suivante au même endroit. Etc. A. Vous avez choisi le calcul par quantité Pour remplir votre ligne : Quantité maxi : c'est le plafond de votre palier (par exemple, pour les bouteilles, jusqu'à X cols. Cette quantité est votre unité de transport. Vous allez définir cette valeur sur vos produits via un nouveau champ "Unité de transport, voir plus bas le chapitre 1.34.3). Forfait ou prix par unité de livraison : vous ne pouvez en remplir qu'un seul des deux. Si vous saisissez un prix dans "forfait", vous ne pourrez pas saisir de prix dans "Prix unitaire". Franco : si vous cochez la case "franco", vous ne pourrez pas saisir de prix dans les deux autres colonnes. Cliquez sur le bouton "Ajouter" pour valider votre ligne. en forfait : jusqu'à la quantité palier indiquée, le forfait s'applique, indépendamment de la quantité. Par exemple ici : jusqu'à 29 unités, quelque soit la quantité, ce sera un forfait de 10€ ; en prix unitaire : proportionnel à la quantité vendue en « équivalent » défini sur la fiche produit. Par exemple ici pour 30 unités vendues, se sera 30 x 0.70€ ;  en Franco : Pour ce dernier palier, depuis la quantité supérieure à 1 du palier précédent jusqu'à... (mettre un chiffre très élevé) : frais de port = 0. B. Si vous avez choisi le calcul par montant total de la commande (ou du devis) Pour remplir votre ligne : Montant maxi : c'est le plafond de votre palier (jusqu'à X € HT du devis ou de la commande). Forfait ou franco : vous ne pouvez avoir que l'un des deux. Si vous cochez "Franco", vous ne pourrez pas saisir de montant dans la colonne "forfait". Cliquez sur le bouton "Ajouter" pour valider votre ligne. en forfait : jusqu'à la quantité palier indiquée, le forfait s'applique, indépendamment du montant exact du devis ou de la commande. Par exemple ici : jusqu'à 10€ de commande, quelque le montant exact, ce sera un forfait de 10€ ; Au-delà de 10€ (y compris si c'est 10.5€) et jusqu'à 50€, se sera un forfait de 5€ de frais de port.  en Franco : Pour ce dernier palier, au-delà du montant du palier précédent jusqu'à... (mettre un chiffre très élevé) : frais de port = 0. C. Actions communes aux deux méthodes Quelle que soit la méthode de calcul, vous pouvez : Modifier un palier existant : Modifiez ce que vous avez besoin de modifier, puis cliquez sur le bouton "Modifier" en fin de ligne. Modifier plusieurs palier en une seule fois : Modifiez ce que vous avez besoin d'ajuster sur chacune des lignes concernées, puis cliquez sur le bouton Modifier en dessous du tableau. Supprimer une ligne  : Cliquez sur l'icône "poubelle" en fin de ligne pour la supprimer. Si vous avez besoin d'une nouvelle zone, recommencez en créant votre nouvelle zone puis en paramétrant sa grille. Pour changer de zone : choisissez-la dans la liste déroulante et laissez la page se recharger. 1.3.4.2- Paramétrage Tiers À l’activation du module, un nouveau champs apparaît sur les fiches tiers : la zone de frais de port. Vous pouvez enregistrer une zone de transport par défaut sur vos clients. Cette information sera reprise automatiquement quand vous allez créer des devis ou des commandes. Ceci n'est pas obligatoire car on peut définir la zone de frais de port directement sur le devis ou la commande. C'est plus utile pour ne pas oublier, ou encore pour ne pas avoir à s'en occuper quand c'est clairement défini sur le client. Vous pourrez quoi qu'il en soit toujours modifier la zone de frais de port si besoin sur un document. Le champ "Zone de frais de port" est une liste déroulante issue des zones créées dans le paramétrage du module. Sur la fiche client, indiquez pour sa zone de transport par défaut. Elle sera reprise automatiquement sur ses devis et commandes. Vous pourrez toujours la modifier manuellement sur les documents en cas de besoin. 1.3.4.3- Paramétrage Produits Ceci concerne uniquement la méthode de calcul par quantité À l’activation du module et si vous avez choisi le mode de calcul par quantité, un nouveau champs apparaît sur les fiches produits : Unité de transport. Indiquez dans ce champ l'équivalent en unité de livraison de ce produit. Il s’agit du nombre « équivalent » permettant de calculer les frais de ports. Exemple pour un viticulteur : 1 bouteille de 0,75 cl = 1 1 bouteille de 1,5 l = 2  1 bouteille de 3 l = 4, etc. 2- Utilisation Utilisation du module Frais de port dans votre travail quotidien. 2.1 - Affecter une zone par défaut à vos clients La zone de frais de port est présente sur chaque document devis ou commande. C'est là l'endroit où elle est nécessaire et il est possible de l'affecter au cas par cas en fonction des besoins. Toutefois, pour des clients réguliers, il est plus pratique d'indiquer la zone de frais de port par défaut sur la fiche du tiers, elle sera ensuite automatiquement reprise sur les devis et les commandes de ce client - et il sera toujours possible d'en changer en cas de besoin sur le document. 2.1.1 - Affecter la zone de frais de port sur la fiche du client Cette méthode convient à la création d'un nouveau client ou si vous avez peu de fiches clients à éditer. Sinon, choisissez la méthode d'affectation en masse. Sur l'onglet "Tiers" ou sur l'onglet "Client" : cliquer sur le petit crayon à droite de "Zone de frais de port" pour éditer le champ, choisir la zone dans la liste déroulante et enregistrer. 2.1.2 - Affecter la zone de frais de port en masse à une sélection de clients Depuis la liste des clients, filtrez la liste selon vos choix (par exemple pays) puis cochez les lignes concernées. Pour cocher toutes les lignes affichées en une seule fois, cliquez dans la case à cocher située dans la ligne d'en-tête du tableau. Dans la liste déroulante apparue en haut au centre de l'écran, déroulez et choisissez l'item "Zone de frais de port" puis cliquez sur le bouton "Confirmer". Une zone en haut d'écran vous permet de choisir la zone à affecter dans une liste déroulante. Choisissez la zone à appliquer à cette sélection de client puis validez votre action. 2.1.3 - Origine des zones à choisir Les zones de frais de port que vous pouvez choisir dans ces actions proviennent des zones que vous avez créées dans la configuration du module. Si vous supprimez une zone ou que vous en créez une nouvelle dans la configuration, la liste déroulante de choix de la zone à affecter reflétera l'état de votre configuration. 2.2- Ajouter les frais de port à un document (devis ou commande) 2.1.1 - Devis ou Commande Nous détaillons ici le cas de la création d'une commande, mais c'est exactement la même chose sur un devis Étape 1 : calcul des frais de port À la création d’une nouvelle commande client, la zone de frais de port est héritée sur la commande si vous l'avez définie par défaut sur la fiche client, mais reste modifiable si besoin. Si vous n'aviez pas définit de zone de frais de port par défaut sur la fiche client, il faut choisir la zone de frais de port à appliquer sur la commande. Lors de la saisie de la commande brouillon, la zone reste modifiable (1). et un encart dynamique en bas à gauche de votre écran indique le calcul pour la saisie en cours (2). Exemple pour la méthode de calcul par quantité Sur cette commande, une zone a été choisie. À chaque ajout/modification de ligne comportant un produit qui a son équivalent "unité de transport" renseigné : le cadre s’actualise pour afficher le calcul en cours. Sur l'exemple ci-dessous : la première ligne est une bouteille de 75cl, équivalent transport : 1 la deuxième ligne est un balthazar, équivalent transport : 16 la troisième lignes est une bouteille de 75cl, équivalent transport : 1 Le nombre total d'unité retenu est donc : 3x1 + 2x16 + 12x1, soit 47 Exemple pour la méthode de calcul par montant Le calcul est basé sur le montant HT de la facture. D'après notre configuration, pour la zone "France", en dessous de 100€ il y a 10€ de frais de port, au-delà, c'est franco. Sur cette commande, on a donc positionné la zone de frais de port à "France Puis on a ajouté des produits à la commande. A. montant inférieur à 100€ HT B. Montant supérieur à 100€ HT Étape 2 : ajouter les frais de port à votre commande Il y a deux manières d'ajouter la ligne de frais de port à votre devis ou commande :  1- En cliquant sur le bouton "Ajouter" de l'encart dynamique Sur l'encart dynamique, le bouton est coloré tant qu'il est actif. Par défaut, quand vous créez votre document, le bouton est actif. Une fois que vous avez ajouté votre ligne de frais de port sur votre commande, le bouton "Ajouter" de l'encart dynamique est grisé, vous ne pouvez plus vous en servir. C'est le cas sur la capture ci-dessus de la partie "Calcul par quantité" : le bouton « Ajouter » dans l'encart de calcul des frais de port est grisé.  En effet, sur cette copie d'écran, la ligne de port a déjà été ajoutée à la commande. Comme toute ligne du tableau, elle est modifiable (vous pouvez y appliquer une remise ou autre). Sur les copies d'écran de la partie "Calcul par montant", le bouton est coloré et actif. Comment retrouver un bouton "Ajouter" des frais port actif Ce bouton « Ajouter » redevient actif si vous supprimez la ligne de port actuelle de votre document. Par ailleurs, si vous modifiez l'un des éléments suivants, la ligne de frais de port est automatiquement supprimée (et le bouton redevient actif) : si vous modifiez une ligne (changement de quantité ou de prix) si vous modifiez la zone de frais de transport 2- En validant votre commande (sans avoir ajouté la ligne de frais de port auparavant) Si vous validez une commande sans y avoir ajouté les ports calculés auparavant, la boite de confirmation habituelle s’ouvre, avec une nouvelle zone (si les frais de ports n’ont pas été ajoutés manuellement en cliquant sur « ajouter ») : En laissant coché à « oui » : les frais de ports seront générés automatiquement sur la commande validée, comme si vous aviez cliqué manuellement sur « ajouter ». 2.1.2 - Suppression automatique de la ligne de frais de port Pour faciliter le travail et réduire les risques d'erreur, des mécanismes de suppression automatique de la ligne de frais de port sont prévus dans les cas suivants : Vous avez validé une commande et vous repassez votre commande en brouillon pour la modifier ; Sur une commande en mode édition ( brouillon donc), vous avez déjà ajouté la ligne de frais de port, mais vous allez en haut de la commande changer la zone de frais de port. Dans ce cas, l'encart dynamique prend la nouvelle zone comme référence et recalcule les frais de port. Sur votre commande en édition (brouillon donc), si vous modifiez une ligne (changement de quantité ou de montant), la ligne de frais de port est également automatiquement supprimée, le calcul dans l'encart dynamique est ajusté en fonction des nouvelles valeurs. Dans ces trois cas, la ligne de frais de port est automatiquement supprimée . Il faudra soit l'ajouter manuellement avec le bouton "Ajouter" de l'encart dynamique, soit juste valider à nouveau votre commande et choisir d'ajouter les frais de port. IMPORTANT : Si vous changez la zone de frais de port sur une commande validée , vous devrez la repasser en brouillon pour que la ligne de frais de port soit supprimée, puis la revalider pour que le calcul des frais de port soit fait en fonction de la nouvelle zone choisie. 2.1.3 - Édition d'une ligne de frais de port Compte-tenu du chapitre précédent : si vous tentez de modifier une ligne de frais de port, cela constitue une modification d'une ligne du tableau, et la ligne de frais de port va être supprimée. Pour pouvoir éditer une ligne de frais de port sans qu'elle soit supprimée, il faut activer l'option suivante dans la configuration du module, dans la section "Service de frais de port" :  Permettre la modification de la ligne de frais de port sans suppression de celle-ci 2.1.4 - Passage du devis à la commande Lorsque vous avez ajouté les frais de port à un devis et que vous transformez ce devis en commande, les informations suivent sur la commande : zone de frais de port ligne de frais de port dans la commande encart dynamique avec bouton grisé (car les frais de port sont déjà ajoutés à la commande. La ligne de frais de port sera automatiquement supprimée si vous modifiez la zone de frais de port, ou que vous modifiez la quantité ou le montant d'une des lignes au moins. Et le bouton "Ajouter" redeviendra actif. Si vous ne retouchez pas la commande, lorsque vous allez la valider, la popup ne vous proposera pas d'ajouter les frais de port (ils y sont déjà). 2.1.5 -Passage à la facture Lorsque vous créez une facture à partir de la commande ou du devis, la ligne de frais de port est une ligne comme les autres. Le module "frais de port" n'intervient pas sur les factures. Il n'y a pas d'encart dynamique, il n'y a pas de champ "zone de frais de port". 2.1.6 - Personnalisation L’intégralité des termes apparaissant sur les captures d’écran de cette documentation (Unité de transport, Zone de frais de port, Quantité maxi, etc.) est personnalisable en français ou tout autre langue via le menu  A ccueil > C onfiguration > T raduction. 4- Pour finir 4.1- Question fréquentes / Informations pratiques 4.1.1- Question fréquentes 4.1.1.1- Bonnes pratiques  Ce chapitre répertorie les difficultés rencontrées avec le module. Vous y trouverez donc des éléments de réponse quant à son utilisation. Si vous rencontrez une autre erreur que celles décrites ci-dessous lors de l'utilisation de ce module : désactivez et réactivez le module vérifiez sur le ChangeLog si une nouvelle version a été publiée et sa compatibilité avec votre version de Dolibarr ré-installez/mettez à jour le module  vérifiez qu'aucune incompatibilité avec un autre module ne soit indiquée ; le cas échéant, suivez nos préconisations Si, malgré ces manipulations, l'erreur persiste, contactez-nous en utilisant  notre interface de support.  Pour plus d’efficacité dans l’étude de votre demande, précisez : le nom et la version du module la version de Dolibarr  la liste des modules additionnels activés  tous les éléments nécessaires à la meilleure des prise en charge de votre demande, comme le contexte, les étapes successives pour reproduire l'erreur, captures d'écran, message d'erreur, etc. 4.1.1.2- Autres difficultés Aucune difficulté connue à ce jour. 4.1.2- Informations pratiques  4.1.2.1- Liens directs Pour accéder rapidement aux diverses ressources relatives au module, nous en avons listé les liens ci-dessous : Produits associés sur notre site Le forum français 4.1.2.2- Support Nous assurons la maintenance corrective sur nos modules pendant un an à partir de leur date d'achat. Une interface de  support est à votre disposition pour signaler un bug rencontré.  Pour toute demande d'aide à l'utilisation, veuillez souscrire à l'un de  nos forfaits de support . 4.1.2.3- Crédit et historique des modifications Pour la présente documentation du module Produits associés pour Dolibarr :  Licence : GFDL Version Auteurs Date Objet 1 Arnaud Rebillard 09/2024 Première version du module de frais de port par quantité sur les commandes clients. 2 Agnès Rambaud 09/2025 Deuxième version du module avec ajout de la gestion des frais de port par montant, et ajout de la gestion des frais de port sur les devis clients.