---
title: Les unités de mesure
description: "> 📍 **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…"
url: "https://www.kafinea.com/fr/documentation/catalogue/les-unites-de-mesure/"
updated: "2026-10-28"
category: Catalogue
---

# 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 :**

| Champ | Description |
| --- | --- |
| **Nom** | Le nom complet de l'unité (obligatoire), ex. : « Kilogramme », « Mètre linéaire » |
| **Catégorie** | La catégorie à laquelle l'unité appartient (obligatoire) |
| **Ratio** | Le facteur de conversion par rapport à l'unité de base de la catégorie (obligatoire). Peut être un nombre ou une expression mathématique utilisant des champs du produit |
| **Unité de base** | Cochez cette case si cette unité est la référence de sa catégorie (ratio = 1). Une seule unité de base par catégorie |

> **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 :

| Champ | Rôle |
| --- | --- |
| **Unité de base** | L'unité de référence du produit (utilisée par défaut pour le stock) |
| **Unité de vente** | L'unité proposée automatiquement dans les documents de vente (devis, commandes clients, factures clients, bons de livraison, avoirs clients) |
| **Unité d'achat** | L'unité proposée automatiquement dans les documents d'achat (commandes fournisseurs, factures fournisseurs, bons de réception, avoirs fournisseurs) |

> **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 :**

| Champ | Description |
| --- | --- |
| **Nom** | Le libellé affiché à l'utilisateur, ex. : « Longueur », « Largeur » |
| **Code interne** | Un identifiant technique utilisé dans les formules et les templates d'impression |
| **Valeur par défaut** | La valeur pré-remplie lors de l'ajout d'une ligne |
| **Visible** | Si l'attribut est affiché dans les lignes de document |
| **Éditable** | Si l'utilisateur peut modifier la valeur dans les lignes de document |

> **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 :**

| Champ | Description |
| --- | --- |
| **Nom** | Le libellé affiché, ex. : « Surface totale » |
| **Code interne** | Un identifiant technique pour les templates d'impression |
| **Expression** | La formule de calcul, ex. : `longueur * largeur * nb_panneaux` |
| **Visible** | Si le résultat est affiché dans les lignes de document |
| **Afficher l'expression** | Si la formule est affichée sous le résultat (à titre informatif) |
| **Remplacer la quantité** | Si le résultat du calcul doit remplacer la quantité de la ligne |

> **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** :

| Attribut | Code interne | Visible | Éditable | Valeur par défaut |
| --- | --- | --- | --- | --- |
| Longueur | `longueur` | ✅ | ✅ | *(vide)* |
| Largeur | `largeur` | ✅ | ✅ | *(vide)* |
| Nombre de panneaux | `nb_panneaux` | ✅ | ✅ | `1` |

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

| Champ | Valeur |
| --- | --- |
| Nom | Surface totale |
| Code interne | `surface` |
| Expression | `longueur * largeur * nb_panneaux` |
| Visible | ✅ |
| Remplacer la quantité | ✅ |

1. 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 :

| Unité | Ratio | Unité de base |
| --- | --- | --- |
| Bouteille | `1` | ✅ |
| Pack de 6 | `6` |  |
| Palette (84 packs) | `504` |  |

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

| Champ | Valeur |
| --- | --- |
| Unité de base | Bouteille |
| Unité de vente | Pack de 6 |
| Unité d'achat | Palette |

**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

| Terme | Définition |
| --- | --- |
| **Catégorie d'unité** | Regroupement d'unités mesurant la même grandeur (ex. : Poids, Longueur) |
| **Unité de base** | L'unité de référence d'une catégorie, avec un ratio de 1 |
| **Ratio** | Le facteur de conversion entre une unité et l'unité de base de sa catégorie |
| **Attribut** | Un champ personnalisé rattaché à une unité, saisissable dans les lignes de document |
| **Attribut calculé** | Une valeur calculée automatiquement par une formule mathématique |

---

## Références associées 🔗

- [Les produits](https://www.kafinea.com/fr/documentation/catalogue/les-produits/)
- [Les services](https://www.kafinea.com/fr/documentation/catalogue/les-services/)
- [Les familles d'articles](https://www.kafinea.com/fr/documentation/catalogue/les-familles-darticles/)