Les unités de mesure

📍 Où trouver ce module ?
Menu principal > Catalogue

---

Introduction #

Les unités de mesure de Kafinea vont au-delà d’une simple liste de noms : elles permettent de gérer des catégories d’unités, des conversions automatiques via des ratios, des attributs personnalisés saisissables dans les lignes de documents, et des attributs calculés par formules mathématiques. Le module est accessible via Catalogue > Unités de mesure.

---

1. Les catégories d’unités #

Chaque unité de mesure appartient à une catégorie (accessible via Catalogue > Catégories d’unité). Les catégories regroupent les unités qui mesurent la même grandeur.

Exemple : La catégorie « Poids » regroupe les unités Kilogramme, Gramme, Tonne. La catégorie « Longueur » regroupe Mètre, Centimètre, Millimètre.

Les conversions automatiques ne sont possibles qu’entre unités d’une même catégorie.

Astuce : Créez vos catégories avant de créer vos unités de mesure.

---

2. Créer une unité de mesure #

Cliquez sur Ajouter une unité depuis la liste du module Catalogue > Unités de mesure.

Informations à renseigner :

Important : Une seule unité peut être marquée comme « Unité de base » par catégorie. C’est l’unité de référence pour les conversions.

Le ratio : nombre ou formule #

Le ratio peut être :

• Un nombre fixe : par exemple 1000 pour le Gramme si le Kilogramme est l’unité de base (1 kg = 1000 g)
• Une expression mathématique utilisant des champs du produit : par exemple, si l’unité « Palette » a un ratio qui dépend du nombre de pièces par palette défini sur la fiche produit

Exemple : Si l’unité de base est « Pièce » (ratio = 1) et qu’une unité « Carton » a un ratio de 12, alors 1 carton = 12 pièces. Lors de la saisie d’un document, changer l’unité de « Pièce » à « Carton » convertira automatiquement la quantité.

---

3. Les trois unités d’un produit #

Chaque fiche produit dispose d’un bloc Unités de mesure regroupant trois champs :

Note : Lorsqu’un produit est ajouté à un document, Kafinea sélectionne automatiquement l’unité de vente ou d’achat selon le type de document. L’utilisateur peut ensuite changer d’unité parmi toutes celles de la même catégorie.

---

4. Les attributs personnalisés #

Les attributs sont des champs supplémentaires rattachés à une unité de mesure. Ils apparaissent dans les lignes de détail des documents et permettent à l’utilisateur de saisir des dimensions ou caractéristiques propres à chaque ligne.

Pour ajouter un attribut, ouvrez la fiche d’une unité de mesure et utilisez la liste associée Attributs d’unité.

Informations à renseigner :

Exemple : Pour une unité « Mètre carré », vous pouvez créer deux attributs : « Longueur » (code longueur, éditable) et « Largeur » (code largeur, éditable). L’utilisateur saisira ces dimensions dans chaque ligne de devis ou de facture.

Note : Un attribut non visible mais présent peut servir de variable dans les formules d’attributs calculés.

---

5. Les attributs calculés #

Les attributs calculés sont des valeurs déterminées automatiquement par une formule mathématique. Ils peuvent utiliser comme variables :

• Les attributs personnalisés de l’unité (via leur code interne)
• Les champs de la fiche produit

Pour ajouter un attribut calculé, ouvrez la fiche d’une unité de mesure et utilisez la liste associée Attributs calculés.

Informations à renseigner :

Exemple : Pour une unité « Mètre carré » avec les attributs « Longueur », « Largeur » et « Nombre de panneaux », un attribut calculé « Surface totale » avec l’expression longueur * largeur * nb_panneaux calculera automatiquement la surface. Si « Remplacer la quantité » est coché, la quantité de la ligne sera remplacée par le résultat du calcul.

Astuce : Les expressions peuvent référencer des champs de la fiche produit. Par exemple, si le produit a un champ poids_unitaire, vous pouvez créer un attribut calculé « Poids total » avec l’expression poids_unitaire * nb_colis.

---

6. Utilisation dans les documents #

Lorsqu’un produit est ajouté à une ligne de document (devis, commande, facture…) :

1. L’unité est sélectionnée automatiquement selon le type de document (unité de vente ou d’achat)
2. Un sélecteur d’unité permet de changer d’unité parmi celles de la même catégorie
3. La quantité est convertie automatiquement lors du changement d’unité grâce aux ratios
4. Les attributs personnalisés apparaissent sous le sélecteur d’unité pour saisie
5. Les attributs calculés sont recalculés automatiquement à chaque modification

Note : Les unités de mesure et leurs attributs sont également disponibles dans les templates d’impression via des variables dédiées.

---

7. Exemples de mise en œuvre #

Menuiserie : vente au mètre carré #

Une menuiserie vend des panneaux de bois dont le prix dépend de la surface. L’opérateur doit pouvoir saisir la longueur, la largeur et le nombre de panneaux directement dans le devis, et le calcul de surface doit servir de quantité pour la ligne.

Configuration :

1. Créez la catégorie Surface (via Catalogue > Catégories d’unité)
2. Créez l’unité Mètre carré dans cette catégorie, avec le ratio 1 et cochez Unité de base
3. Sur la fiche de l’unité « Mètre carré », ajoutez trois attributs :

4. Toujours sur cette fiche, ajoutez un attribut calculé :

5. Sur la fiche du produit « Panneau de bois », renseignez les trois unités avec Mètre carré

Résultat dans un devis :

• L’opérateur ajoute « Panneau de bois » au devis
• Les champs Longueur, Largeur et Nombre de panneaux apparaissent dans la ligne
• Il saisit Longueur = 2.5, Largeur = 1.2, Nombre de panneaux = 3
• Kafinea calcule automatiquement : 2.5 × 1.2 × 3 = 9 m²
• La quantité de la ligne est remplacée par 9, et le montant total = prix unitaire × 9

Note : L’option « Remplacer la quantité » est la clé de ce fonctionnement. Sans elle, le calcul serait affiché à titre informatif mais ne modifierait pas le montant de la ligne.

---

Magasin : bouteilles d’eau en multi-conditionnement #

Un magasin achète ses bouteilles d’eau en palettes auprès de son fournisseur, les stocke en packs de 6, et les vend soit au pack soit à la bouteille. Le système doit convertir automatiquement les quantités lors du changement d’unité.

Configuration :

1. Créez la catégorie Conditionnement eau (via Catalogue > Catégories d’unité)
2. Créez les unités suivantes :

3. Sur la fiche du produit « Eau minérale 1.5L » :

Résultat à l’achat :

• Dans une commande fournisseur, l’opérateur ajoute « Eau minérale 1.5L »
• L’unité Palette est sélectionnée automatiquement (document d’achat)
• Il commande 2 palettes

Résultat à la vente :

• Dans un devis, l’unité Pack de 6 est sélectionnée automatiquement (document de vente)
• L’opérateur saisit 10 packs
• S’il change l’unité vers Bouteille via le sélecteur, la quantité est automatiquement convertie : 10 × 6 = 60 bouteilles
• S’il passe ensuite en Palette, la quantité devient : 60 / 504 ≈ 0.119 palette

Astuce : Le sélecteur d’unité dans les lignes de document propose toutes les unités de la même catégorie. L’unité de vente ou d’achat n’est que la sélection par défaut — l’opérateur peut toujours choisir une autre unité.

Note : Le ratio peut aussi être une formule utilisant un champ du produit. Par exemple, si le nombre de packs par palette varie selon le produit, créez un champ packs_par_palette sur la fiche produit et utilisez le ratio packs_par_palette * 6 pour l’unité Palette.

---

8. Questions fréquentes #

Comment fonctionnent les conversions entre unités ?
Les conversions sont automatiques entre unités d’une même catégorie, grâce aux ratios. Par exemple, si « Kilogramme » (ratio 1) est l’unité de base et « Gramme » a un ratio de 1000, passer de 5 kg à Gramme affichera automatiquement 5000 g.

Puis-je utiliser des unités différentes pour la vente et l’achat d’un même produit ?
Oui. Chaque produit a une unité de vente et une unité d’achat distinctes. Par exemple, vous pouvez acheter en « Carton de 12 » et vendre à la « Pièce ».

Puis-je modifier une unité de mesure déjà utilisée ?
Vous pouvez modifier le nom, le ratio et les attributs. La modification du ratio affectera les futures conversions mais pas les lignes de documents déjà enregistrées.

Quelles unités sont créées par défaut ?
Kafinea est livré avec les unités les plus courantes. Vous pouvez en ajouter autant que nécessaire et créer vos propres catégories selon votre activité.

---

Glossaire #

---

Références associées 🔗 #

• Les produits
• Les services
• Les familles d’articles