Stock

Tenez à jour votre catalogue d'articles, suivez les quantités en temps réel grâce à des mouvements tracés (entrée, sortie, ajustement), repérez d'un coup d'œil ce qu'il faut recommander et connaissez la valeur de votre stock.

/stock /api/stock stock.view stock.manage

À quoi sert ce module

Le module Stock gère votre catalogue d'articles et l'état de vos quantités. Chaque article porte une référence (SKU) unique, un nom, un prix de vente, un coût unitaire et une quantité en stock. Toute variation de quantité passe obligatoirement par un mouvement daté et tracé : on ne modifie jamais une quantité « à la main » dans la fiche, ce qui garantit un historique complet et fiable.

Il s'adresse aux personnes chargées de l'approvisionnement, du magasin et de l'inventaire, ainsi qu'aux gestionnaires qui suivent la valorisation du stock et les articles à réapprovisionner. Le stock est directement alimenté par les Achats : réceptionner une commande fournisseur crée automatiquement une entrée en stock pour chaque ligne reliée à un article.

Vue d'ensemble de l'écran

La liste des articles : trois indicateurs en tête (nombre, valorisation, articles sous le seuil), la recherche par référence ou nom, la case Stock bas uniquement, puis le tableau. Les quantités passées sous le seuil de réapprovisionnement s'affichent en rouge avec un triangle d'alerte.

Parcourir et filtrer la liste

La page liste les articles, les plus récents en premier. Deux outils se combinent au-dessus du tableau :

• Recherche — par référence (SKU) ou nom d'article. La recherche porte sur le début du mot (« Filt » trouve « Filtre »).
• Stock bas uniquement — une case à cocher qui restreint la liste aux articles dont la quantité est inférieure ou égale au seuil de réapprovisionnement.

Le tableau affiche pour chaque article : Référence, Article, Quantité (en rouge si sous le seuil), Seuil, Prix vente et Valeur stock (quantité × coût unitaire). La liste se parcourt par pages (pagination par curseur, sans ralentissement sur les gros volumes).

Créer un article

Cliquez sur + Ajouter un article pour ouvrir la fenêtre Nouvel article.

1. Référence (SKU) — saisissez un code unique (ex. ART-001). Deux articles ne peuvent pas partager la même référence.
2. Nom de l'article — la désignation visible partout (obligatoire).
3. Description — texte libre facultatif.
4. Prix de vente HT et Coût unitaire — le coût sert au calcul de la valorisation.
5. Unité — unité de mesure (« u » par défaut, 10 caractères maximum).
6. Stock initial — quantité de départ. Ce champ n'est saisissable qu'à la création ; ensuite, la quantité ne bouge plus que par mouvement.
7. Seuil de réapprovisionnement — la quantité plancher en dessous de laquelle l'article est signalé comme « à réapprovisionner ».
8. Enregistrer — l'article apparaît immédiatement dans la liste.

Modifier ou supprimer un article

Sur chaque ligne, les actions disponibles (si vous avez la permission stock.manage) :

• Modifier (icône crayon) — corrige la référence, le nom, la description, les prix, l'unité et le seuil. La quantité reste figée.
• Supprimer (icône corbeille) — retire l'article. Une confirmation rappelle que l'article et tout son historique de mouvements seront supprimés définitivement.

Enregistrer un mouvement de stock

Le bouton Mouvement (icône sur la ligne) ouvre la fenêtre Mouvement de stock. C'est l'unique façon de faire varier une quantité.

1. Type de mouvement — choisissez dans la liste : Entrée (+), Sortie (−) ou Ajustement (inventaire).
2. Quantité — un nombre positif. Pour un ajustement, le libellé devient Nouveau stock (inventaire) : vous saisissez la quantité réelle constatée.
3. Motif (optionnel) — texte libre conservé dans l'historique (ex. « Réception fournisseur », « Casse », « Inventaire »).
4. Valider le mouvement — la quantité de l'article est recalculée et la ligne d'historique créée, le tout de façon atomique.

Les trois types de mouvement

Consulter l'historique d'un article

Le bouton Historique (icône horloge) — ou un clic sur le nom de l'article — ouvre la chronologie de ses mouvements. Chaque ligne indique :

Seuils de réapprovisionnement

Chaque article porte un seuil de réapprovisionnement. Dès que sa quantité descend à ce niveau ou en dessous, il est compté dans l'indicateur À réapprovisionner en haut de page, sa quantité s'affiche en rouge avec un triangle d'alerte, et il apparaît quand on coche Stock bas uniquement. Un seuil à 0 désactive l'alerte pour l'article. Ajustez le seuil selon le délai de réappro et la rotation du produit.

Valorisation du stock

La valeur du stock d'un article vaut quantité × coût unitaire. La colonne Valeur stock l'affiche par ligne, et l'indicateur Valorisation du stock en somme l'ensemble. C'est le coût unitaire (et non le prix de vente) qui est retenu : maintenez-le à jour pour une valorisation fidèle. Notez que le prix de vente sert, lui, à la facturation côté Factures.

Champs de l'article

sku

Référence unique de l'article (obligatoire).

name

Désignation de l'article (obligatoire).

description

Texte libre facultatif.

unit

Unité de mesure (« u » par défaut).

unit_price

Prix de vente HT — utilisé par la facturation.

unit_cost

Coût unitaire — base de la valorisation du stock.

quantity

Quantité en stock — modifiable uniquement par mouvement.

reorder_level

Seuil de réapprovisionnement déclenchant l'alerte « stock bas ».

Permissions

Sans stock.manage, les boutons d'ajout, de mouvement, de modification et de suppression sont masqués : la page reste en consultation. Voir Rôles & permissions pour la composition des rôles.

Liens utiles

• Achats — réceptionner une commande fournisseur alimente automatiquement le stock.
• Factures — le prix de vente des articles sert à la facturation.
• Rôles & permissions — qui peut faire quoi.