Module Services (Catalogue)

Le module Services d'HtkDoli vous permet de consulter, rechercher et gérer votre catalogue de services (prestations, abonnements, articles non stockables). Côté Dolibarr, produits et services partagent la même table : seul leur champ type les distingue (type = 1 pour un service). Les sections de stock physique sont donc volontairement absentes de ce module.

Interface et Fonctionnalités (Liste)

La vue principale affiche la liste de tous vos services, avec un en-tête flottant qui se masque automatiquement au défilement.

Consultation et Recherche

Barre de recherche : Recherche instantanée par référence ou libellé.
Tri : Plusieurs ordres sont disponibles :
- Référence
- Libellé
- Prix (croissant)
- Prix (décroissant)
- Stock (utile uniquement pour les services tracés avec un suivi quantitatif)
Filtres par statut commercial :
- Tous
- En Vente
- Hors Vente
Rafraîchissement : Bouton de synchronisation manuelle avec indicateur d'état (gris = obsolète, bleu = en cours, vert = succès, rouge = erreur). L'état repasse automatiquement à « obsolète » au-delà de 60 secondes.

Informations affichées (Cartes Service)

Chaque ligne représentant un service présente :

Une icône clé à molette/tournevis colorée selon le statut (vert = en vente).
Son libellé.
Sa référence (ex : SRV-0001), sous forme de pastille.
Son prix de vente HT (affiché uniquement s'il est supérieur à 0).
Son code-barres s'il est renseigné.
Son statut (En Vente / Hors Vente).

Menu contextuel (appui long) : Modifier, Supprimer.
Glissement vers la droite : Bouton de modification.
Glissement vers la gauche : Bouton de suppression (avec alerte de confirmation).

Pagination et États

Chargement par paquets de 50 services, avec un bouton « Charger plus » en bas si d'autres existent.
Indicateur de synchronisation affiché lors des chargements (squelette de liste au premier chargement).
Message clair en cas de résultat vide (différencié selon la recherche, le filtre ou le catalogue lui-même).

Vue Détail (Consultation d'un service)

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

En-tête (Hero Section)

Icône clé à molette indiquant le type Service.
Référence et libellé.
Prix de vente HT.
Un badge de statut unique : En Vente ou Hors Vente.

Description

Texte descriptif du service, affiché tel qu'enregistré dans Dolibarr. Cette section n'apparaît que si une description existe.

Catégories / Tags

Catégories Dolibarr associées, affichées sous forme de pastilles. Cette section n'apparaît que si le service possède au moins une catégorie.

Tarification

Prix Unitaire HT
Taux de TVA appliqué
Prix TTC

Comptabilité

Codes comptables associés au service (Compte Vente, Compte Achat), utiles pour la passerelle vers votre logiciel de comptabilité. Cette section n'apparaît que si au moins un code est renseigné.

Prix Fournisseurs

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

Nom du fournisseur
Référence fournisseur (si renseignée)
Prix d'achat
Quantité minimale

Composition (Kit)

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

Composant de

À l'inverse, si le service est inclus dans d'autres kits, la liste des services/produits parents s'affiche, également cliquable.

Statistiques

Une grille synthétise l'utilisation du service 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

Notes

Note Publique : visible sur les documents.
Note Privée : marquée d'un cadenas, réservée à l'usage interne.
Le HTML éventuel des notes est nettoyé pour un affichage lisible.
Bouton « Modifier les notes » pour éditer les deux notes directement.

Informations Système

Métadonnées du service : identifiant Dolibarr, date de création, date de dernière modification.

Documents

Consultation et aperçu PDF des documents attachés.
Ajout de nouveaux documents via le bouton dédié (uniquement pour un service déjà enregistré).

Actions disponibles

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

Modifier (crayon) : Ouvre l'écran d'édition complet (si vous disposez de la permission service.creer).
Supprimer (menu « … ») : Suppression définitive (alerte de confirmation).

Création et Modification

L'écran d'édition d'un service (partagé avec celui des produits, en mode « service ») regroupe :

Identité : référence, libellé.
Tarification : prix, TVA.
Durée : valeur numérique + unité (Heures, Jours, Semaines, Mois, Années). C'est le champ « durée » natif de Dolibarr, utile pour les prestations ; HtkDoli ne gère pas d'abonnement ni de récurrence à proprement parler.
Comptabilité : codes comptables.
Divers et Notes.

Les caractéristiques physiques et le stock (réservés aux produits) ne sont pas affichés en mode service.

Comportement Métier et Dolibarr

Droits et Permissions

Comme les services partagent la table llx_product avec les produits, ils sont gouvernés par les mêmes permissions Dolibarr :

Lecture : Permission de lecture du module Produits/Services requise.
Création : Bouton « + » de la barre du haut affiché si vous disposez de la permission service.creer ou produit.creer.
Modification : Boutons d'édition affichés si vous disposez de la permission service.creer.
Suppression : Immédiate côté serveur si autorisée par votre rôle, avec confirmation.

Synchronisation

Pagination de 50 par 50, bouton « Charger plus ».
Pull-to-refresh (tirer vers le bas) pour forcer une actualisation complète.
Les statistiques, prix fournisseurs, kits, catégories et documents sont récupérés à la demande lors de l'ouverture de la fiche.

Produits vs Services

Pour la gestion d'articles stockables (avec stock physique, mouvements, entrepôts), consultez le Module Produits dédié. La distinction entre les deux est automatique côté Dolibarr via le champ type (0 = produit, 1 = service).

Captures d'écran

1 capture — cliquez pour agrandir