Module Entrepôts (Stocks)

Le module Entrepôts d'HtkDoli vous permet de consulter et gérer vos entrepôts (ou points de stockage) ainsi que les mouvements de stock associés. Chaque produit stockable peut être ventilé sur plusieurs entrepôts ; ce module donne la vue par entrepôt.

Interface et Fonctionnalités (Liste)

La vue principale affiche la liste de tous vos entrepôts configurés dans Dolibarr.

Consultation et Recherche

• Barre de recherche : Recherche par nom, référence, code postal ou ville de l'entrepôt.
• Tri :
  • Nom (A→Z, Z→A)
  • Référence (A→Z, Z→A)
  • Ville (A→Z)
• Filtres par statut :
  • Tous
  • Ouverts
  • Fermés
• Rafraîchissement : Bouton dédié dans l'en-tête, état visuel pendant la synchro.

Informations affichées (Cartes Entrepôt)

Chaque ligne représentant un entrepôt présente :

• Une pastille O (Ouvert, en vert) ou F (Fermé, en gris).
• Le libellé de l'entrepôt.
• Un badge Ouvert / Fermé.
• La référence de l'entrepôt.
• La ville et le code postal si renseignés.

Actions rapides

• Bouton « + » (barre du haut) : création d'un nouvel entrepôt (visible uniquement si vous disposez du droit stock.creer).
• Menu contextuel (appui long) : Modifier, Supprimer.
• Glissement vers la droite : Bouton de modification.
• Glissement vers la gauche : Bouton de suppression (avec confirmation).

Pagination

• Chargement par paquets de 50 entrepôts, avec un bouton « Charger plus ».
• Pull-to-refresh disponible.

Vue Détail (Consultation d'un entrepôt)

En touchant un entrepôt dans la liste, vous accédez à sa fiche détaillée.

En-tête (Hero Section)

• Icône de bâtiment.
• Référence et libellé de l'entrepôt.
• Badge Ouvert ou Fermé.

Coordonnées

• Adresse complète
• Code postal
• Ville
• Pays

Mouvements récents

Liste des derniers mouvements de stock liés à cet entrepôt, triés du plus récent au plus ancien. Chaque ligne affiche :

• Une icône directionnelle : flèche verte vers le bas pour une entrée (quantité positive), flèche rouge vers le haut pour une sortie (quantité négative).
• Le libellé du mouvement (motif).
• Le produit concerné (la ligne est cliquable pour naviguer vers sa fiche).
• La date et l'heure du mouvement.
• La quantité signée (+ ou −).

Un bouton « + » dédié permet de créer un nouveau mouvement directement depuis cette section.

Un bouton « Charger plus » apparaît si l'historique contient davantage de mouvements.

Stock

Liste de tous les produits ayant un stock non nul dans cet entrepôt. Un compteur indique le nombre de produits. Chaque ligne affiche :

• Le libellé et la référence du produit.
• La quantité présente dans cet entrepôt.
• Le stock total du produit (tous entrepôts confondus).

Chaque ligne est cliquable pour naviguer vers la fiche du produit.

Description

Texte descriptif libre de l'entrepôt (consignes d'accès, horaires, etc.).

Notes

• Note Publique.
• Note Privée (marquée d'un cadenas, usage interne).

Documents

• Consultation et aperçu des documents attachés à l'entrepôt.
• Téléchargement.
• Ajout de nouveaux documents.

Actions disponibles

Depuis l'en-tête flottant :

• Modifier : Édition complète de la fiche entrepôt (droit stock.creer). Le formulaire d'édition regroupe : référence et libellé (obligatoires), statut Ouvert/Fermé, description, notes (publique et privée), coordonnées (téléphone, fax), et adresse & localisation (lieu/emplacement, adresse, code postal, ville, code pays).
• Supprimer : Suppression définitive (droit stock.supprimer).

Créer un mouvement de stock

Depuis la fiche entrepôt (bouton « + » dans la section Mouvements) ou depuis une fiche produit (action Correction de stock), un écran dédié permet d'enregistrer un mouvement.

L'écran propose un sélecteur segmenté avec deux types de mouvements :

• Correction : Ajustement manuel du stock (en plus ou en moins).
  • Choix Ajout (+) ou Retrait (-).
  • Sélection de l'entrepôt concerné.
  • Saisie de la quantité.
  • Saisie d'un libellé (motif), pré-rempli sur « Correction de stock ».
• Transfert : Déplacement de stock d'un entrepôt à un autre.
  • Sélection de l'entrepôt source.
  • Sélection de l'entrepôt cible (qui doit être différent de la source).
  • Saisie de la quantité à transférer.
  • Saisie d'un libellé, pré-rempli sur « Transfert de stock ».

⚠️ Aucun prix unitaire n'est saisi lors de la création d'un mouvement : seuls le produit, l'entrepôt (ou la paire source/cible), la quantité et le libellé sont enregistrés.

Sélection du produit

• Si le mouvement est créé depuis une fiche produit, le produit est pré-sélectionné.
• Sinon, un sélecteur permet de chercher le produit dans le catalogue.

Comportement hors-ligne

Le mouvement est enregistré localement puis poussé vers Dolibarr lors de la prochaine synchronisation. Une notification de succès confirme l'enregistrement local immédiat.

Comportement Métier et Dolibarr

Droits et Permissions

• Lecture : Permission de lecture du module Stocks requise pour afficher la liste.
• Création / Modification : Bouton « + » de la barre du haut et action de modification conditionnés par la permission stock.creer.
• Suppression : Conditionnée par la permission stock.supprimer.

Synchronisation

• Liste paginée par 50.
• Les mouvements de stock et les documents associés à un entrepôt sont chargés à l'ouverture de la fiche.
• Les mouvements créés en mobilité sont mis en file d'attente et synchronisés automatiquement vers Dolibarr.

Statut Ouvert / Fermé

Un entrepôt fermé dans Dolibarr reste consultable mais ne peut pas recevoir de nouveaux mouvements. Le badge de statut sur la liste et la fiche reflète ce paramètre.

Captures d'écran

2 captures — cliquez pour agrandir

Fermer