Module Produits (Catalogue)

Le module Produits d'HtkDoli vous permet de consulter, rechercher et gérer votre catalogue de produits physiques (articles stockables). Les services (articles non stockables) sont traités dans un module dédié (Module Services). Toutes les informations affichées reflètent fidèlement le fonctionnement métier de Dolibarr (prix, stocks, statuts de vente et d'achat, variantes, kits, etc.).

Interface et Fonctionnalités (Liste)

La vue principale affiche la liste de tous vos produits, avec un en-tête flottant qui se masque automatiquement au défilement pour libérer l'espace.

Consultation et Recherche

Barre de recherche : Recherche instantanée par référence, libellé ou code-barres.
Scanner code-barres : Une icône dédiée (📷) permet d'ouvrir le scanner pour rechercher un produit directement depuis son code-barres ou QR Code.
Tri : Plusieurs ordres sont disponibles :
- Référence (A→Z, Z→A)
- Libellé (A→Z, Z→A)
- Prix (croissant, décroissant)
- Stock (croissant, décroissant)
Filtres : Une icône en haut de l'écran permet de filtrer par disponibilité :
- Tous
- En stock (> 0)
- Hors stock (≤ 0)
Lettre flottante : Lors d'un tri alphabétique (Référence ou Libellé), une bulle bleue affiche temporairement la lettre courante lors du défilement, pour vous repérer rapidement dans une liste longue.
Rafraîchissement : Un bouton en haut de l'écran déclenche la synchronisation manuelle. L'icône change de couleur selon l'état (gris = données obsolètes, bleu = en cours, vert = succès, rouge = erreur).

Informations affichées (Cartes Produit)

Chaque ligne représentant un produit affiche :

La photo Dolibarr du produit (un cube est affiché en visuel par défaut lorsqu'aucune photo n'est attachée).
La référence du produit (ex : PR-0001).
Le libellé du produit.
Le prix de vente HT (libellé « € HT »).
Le stock réel disponible, avec un code couleur permettant de repérer rapidement les produits en rupture.

Un appui long sur un produit ouvre un menu contextuel avec les options suivantes :

Voir le stock : Consultation rapide du stock par entrepôt.
Dupliquer : Création d'un nouveau produit à partir d'un existant.
Modifier : Ouvre la fiche du produit en mode édition.
Supprimer : Supprime définitivement le produit (avec alerte de confirmation).

Vous pouvez également utiliser les gestes de glissement :

Glisser vers la droite pour faire apparaître le bouton de modification.
Glisser vers la gauche pour faire apparaître le bouton de suppression.

Pagination et États

La liste se charge par paquets de 50 produits. Un bouton « Charger plus » apparaît en bas si d'autres produits existent sur le serveur.
En cas d'absence de résultats, un message clair s'affiche (différencié selon que la recherche, le filtre ou le catalogue lui-même est vide).
Un indicateur de synchronisation est affiché pendant les chargements.

Vue Détail (Consultation d'un produit)

En touchant un produit dans la liste, vous accédez à sa fiche détaillée, structurée en sections claires.

En-tête (Hero Section)

Icône cube indiquant le type Produit.
Référence et libellé du produit.
Badges de statut :
- En Vente / Hors Vente (statut commercial).
- En Achat si le produit est aussi marqué comme achetable.

Galerie Photos

Si des images sont attachées au produit (.jpg, .jpeg, .png, .webp), elles s'affichent dans un carrousel horizontal en haut de la fiche. Un tap ouvre l'aperçu plein écran (avec zoom et déplacement).

Informations Générales

Référence
Libellé
Code-barres
Poids (en kg si renseigné)

Catégories / Tags

Affichage des catégories Dolibarr associées au produit sous forme de pastilles.
Si vous disposez du droit de modification, un bouton « Modifier les tags » permet d'ajouter ou retirer des catégories directement.

Prix & Taxes

Prix de vente HT
Prix de vente TTC
Taux de TVA appliqué

Stock

Stock Physique : Quantité réellement présente.
Stock Théorique : Quantité prévisionnelle (incluant les mouvements en attente).
Détail par entrepôt : Pour les produits stockables, la répartition par entrepôt est affichée si l'information est disponible.

Composition (Kit / Virtuel)

Si le produit est un kit (ou produit virtuel), la liste de ses composants enfants s'affiche avec leur référence, libellé et quantité. Chaque composant est cliquable pour naviguer vers sa propre fiche.

Composant de

À l'inverse, si le produit est utilisé comme composant dans d'autres kits, la liste des produits parents s'affiche, également cliquable.

Historique des Mouvements

Un lien dédié ouvre l'historique complet des mouvements de stock (entrées, sorties, corrections) pour le produit.

Statistiques

Une grille de cartes synthétise l'utilisation du produit dans les autres modules, avec le nombre d'occurrences et le montant total. Chaque carte est cliquable pour ouvrir la liste filtrée correspondante :

Devis (Propositions commerciales)
Commandes (clients)
Factures (clients)
Contrats
Commandes Fournisseurs
Factures Fournisseurs
Interventions
Expéditions

Prix Fournisseurs

Liste des tarifs négociés auprès des fournisseurs, avec pour chacun :

Nom du fournisseur
Référence fournisseur
Prix d'achat
Quantité minimale

Si vous disposez de la permission produit.creer :

Un bouton « Ajouter un prix fournisseur » au bas de la section ouvre un formulaire permettant de saisir un nouveau tarif (sélection du fournisseur dans le cache local des tiers marqués comme fournisseurs, référence fournisseur libre, quantité minimale, prix d'achat HT, TVA optionnelle). Le tarif est envoyé à Dolibarr via l'endpoint POST /products/{id}/purchase_prices.
Un glissement vers la gauche sur une ligne expose deux actions : Modifier (rouvre le formulaire pré-rempli pour mettre à jour via PUT /products/{id}/purchase_prices/{priceid}) et Supprimer (avec alerte de confirmation, appelle DELETE /products/{id}/purchase_prices/{priceid}).

Après chaque ajout, modification ou suppression, la section est rechargée automatiquement depuis le serveur.

Variantes

Si le produit est un produit parent, ses variantes (couleur, taille, etc.) sont listées.
Si le produit est lui-même une variante, ses « frères et sœurs » (autres variantes du même parent) sont affichés, la variante en cours étant mise en évidence.

Si vous disposez de la permission produit.creer et que le produit n'est pas lui-même une variante enfant, un bouton « Créer une variante » s'affiche sous la liste. Il ouvre un formulaire dédié qui :

charge les attributs disponibles côté Dolibarr (GET /products/attributes) — Couleur, Taille, etc. ;
propose pour chaque attribut un menu déroulant des valeurs configurées (ou « Aucun ») ;
accepte une référence variante optionnelle (auto-générée si vide) et une variation de prix HT par rapport au produit parent ;
envoie la combinaison à POST /products/{id}/variants.

Si l'instance Dolibarr n'a pas activé le module Combinaisons de produits (l'endpoint des attributs répond 404), le formulaire dégrade gracieusement en affichant le message « Le module Variantes Produit n'est pas activé sur cette instance Dolibarr », sans bloquer le reste de la fiche produit. Après création réussie, la section Variantes est automatiquement rechargée.

Description, Notes et Documents

Description : Texte descriptif riche, dépouillé de son formatage HTML pour une lecture optimisée.
Notes : Notes publiques et privées (la note privée est marquée par une icône de cadenas).
Documents : Consultation, téléchargement (aperçu PDF) et ajout de nouveaux documents (fiches techniques, photos haute définition, etc.). Un glissement vers la gauche sur la ligne d'un document expose l'action Supprimer (avec alerte de confirmation) pour retirer le document du serveur Dolibarr.

Actions disponibles

Depuis l'en-tête flottant de la fiche :

Modifier (icône crayon) : Ouvre l'écran d'édition complet du produit.
Correction de stock : Ouvre l'écran d'ajout d'un mouvement de stock manuel (correction, transfert, entrée, sortie).
Supprimer : Suppression définitive du produit (alerte de confirmation).

Création / Modification

Le formulaire de création ou de modification d'un produit (ou service) est découpé en sections cohérentes : Identité, Prix & taxes, Caractéristiques physiques (produits uniquement : code-barres, poids), Limites de stock (produits uniquement : stock désiré), Comptabilité, Divers et Notes.

La section Identité comporte notamment l'interrupteur « En achat » (status_buy) qui marque le produit comme achetable, en plus du statut de vente.

Pour la section Prix & taxes :

TVA (%) : ce champ est un sélecteur (menu déroulant) alimenté par le dictionnaire c_tva de votre instance Dolibarr, et non plus un champ texte libre. La liste est chargée au premier affichage du formulaire puis mise en cache pour la durée de la session. Si le produit en cours d'édition porte un taux personnalisé absent du dictionnaire (configuration custom), ce taux reste affiché en tête du sélecteur pour ne pas perdre la valeur. Le taux sélectionné est sérialisé sous la forme "20.00" exactement comme avant : aucun changement côté API.

Comportement Métier et Dolibarr

Le module Produits respecte strictement les permissions et la configuration de votre instance Dolibarr.

Droits et Permissions

Lecture : Vous devez posséder la permission de lire les produits pour que la liste s'affiche.
Création / Modification : Un bouton « + » dans la barre du haut n'apparaît que si vous disposez de la permission produit.creer. Cette même permission conditionne l'accès aux actions de modification et de gestion des catégories.
Suppression : Si autorisée par votre rôle, la suppression depuis HtkDoli est immédiate et définitive côté serveur.

Synchronisation

Chargement initial par paquets de 50.
Les détails de stock par entrepôt sont chargés automatiquement pour les produits ayant un stock non nul.
Les statistiques, prix fournisseurs, kits, variantes et catégories sont récupérés à la demande lors de l'ouverture de la fiche détail.
Un pull-to-refresh (tirer vers le bas) sur la liste ou la fiche permet de forcer une actualisation complète.

Produits vs Services

Dans Dolibarr, les produits et les services partagent la même table mais se distinguent par leur champ type :

type = 0 → Produit (stockable) — géré dans ce module.
type = 1 → Service (non stockable) — géré dans le Module Services.

Les écrans de liste et de détail s'adaptent automatiquement : les sections de stock (stock physique, mouvements, entrepôts) ne sont affichées que pour les produits.

Captures d'écran

3 captures — cliquez pour agrandir