Catégories

L'écran Catégories couvre tout ce qui touche à l'organisation de votre catalogue : lister, créer, modifier, supprimer, désactiver, hiérarchiser. Les catégories portent aussi des défauts métier (marge, seuil d'alerte, groupe TVA) qui cascadent vers les articles qu'elles contiennent.

Accéder au menu

Menu latéral → Catalogue → Catégories. Vous arrivez sur la liste hiérarchique de toutes vos catégories.

Pourquoi commencer par les catégories ?

Une catégorie est obligatoire sur la fiche article. C'est la première brique à poser : créez d'abord vos catégories, puis vos articles s'y rattachent.

Au-delà du rangement, chaque catégorie sert de valeur par défaut pour ses articles : pas besoin de re-saisir la marge, le seuil ou le groupe TVA article par article — vous les définissez une fois sur la catégorie, ils cascadent.

La liste des catégories

Vue hiérarchique (par défaut)

La page Catégories affiche l'arborescence : les catégories racines en premier, puis leurs sous-catégories en retrait. Chaque ligne montre le nom, le nombre d'articles rattachés, et les actions (modifier, supprimer, activer/désactiver).

Capture à venir : 01-liste-categories.png

Vue plate (alternative)

URL /categorie/all : affiche toutes les catégories à plat, sans hiérarchie, triées par nom. Utile pour les exports et la recherche rapide quand l'arborescence devient profonde.

Statistiques en en-tête

Total catégories — nombre total dans le tenant
Catégories vides — sans aucun article rattaché
Total articles — somme des articles rattachés à toutes les catégories
Taux d'utilisation — % de catégories qui contiennent au moins un article
Quota — X / N catégories selon votre abonnement

Créer une catégorie

Bouton Nouvelle catégorie en haut à droite de la liste. Nukuntche vérifie d'abord votre quota — si vous l'avez atteint, un message vous redirige vers la liste.

Capture à venir : 03-bouton-nouvelle.png

Pré-sélection de la catégorie parente

Depuis la fiche d'une catégorie existante, le bouton « Ajouter une sous-catégorie » ouvre le formulaire avec le parent déjà pré-sélectionné (URL /categorie/new?parent=<id>). Pratique pour construire l'arborescence sans re-choisir manuellement.

Création modale (à la volée)

Endpoint /categorie/new-modal : utilisé depuis le formulaire article ou import quand l'utilisateur a besoin de créer une catégorie qui n'existe pas encore, sans quitter son écran courant. La catégorie créée est immédiatement disponible dans la liste déroulante.

Capture à venir : 02-categorie-form.png

Champs du formulaire

Identité

Nom (obligatoire) — 3 à 50 caractères. Lettres (accents acceptés : é, è, à, ô, ç, ï…), chiffres, espaces, et - _ & ( ) . , '. Unique pour le tenant.
Description (optionnel) — jusqu'à 1 000 caractères.
Slug — auto-généré depuis le nom si laissé vide. En édition, une case « Regénérer le slug » est disponible pour le reconstruire automatiquement à partir du nom courant.
Active — une catégorie inactive reste consultable mais ne peut plus être choisie sur de nouveaux articles.

Hiérarchie

Catégorie parente — liste déroulante avec le chemin complet (« Boissons > Sodas »). Laisser vide pour une catégorie racine. Profondeur maximale : 3 niveaux (Categorie::MAX_HIERARCHY_DEPTH = 3). Au-delà, la validation refuse.

Défauts métier (cascade vers les articles)

Marge par défaut (%) — appliquée comme suggestion lors de la fixation du prix de vente après la première réception (prix suggéré = CUMP × (1 + marge / 100)). Exemples : Épicerie 15 %, Électronique 28 %, Luxe 50 %. Si vide, retombe sur la marge tenant définie dans Paramètres → Entreprise (35 % par défaut).
Seuil d'alerte par défaut — valeur initiale appliquée à chaque nouveau lieu de stockage pour les articles de cette catégorie (cascade vers ArticleEntrepot). Exemples : Boissons 80, Riz 40, Téléphonie 3. Si vide, fallback sur le paramètre global (Paramètres → Stock). Modifiable ensuite lieu par lieu sur la fiche article.
Groupe TVA eMECeF — code MECeF DGI Bénin (A/B/C/D/E/F) appliqué par défaut aux articles de cette catégorie. Si vide, on hérite du défaut tenant (Paramètres → Entreprise). Un article peut toujours surcharger ce code individuellement.

Logique de cascade : article → catégorie → tenant Pour la marge, le seuil et le groupe TVA, Nukuntche regarde d'abord la valeur sur l'article ; si vide, sur la catégorie ; si vide encore, sur les paramètres du tenant. Vous renseignez le niveau qui a du sens, sans répéter.

Modifier une catégorie

Icône sur la liste ou la fiche : ouvre le formulaire pré-rempli. Tous les champs restent éditables. Particularités :

Regénérer le slug : case à cocher disponible en édition uniquement. Si cochée, le slug est reconstruit à partir du nom courant (utile après un renommage). Si le slug est vide, il est automatiquement régénéré à l'enregistrement.
Changement de parent : permis tant que la profondeur résultante reste dans la limite de 3 niveaux. Sinon, refus avec message d'erreur.

Voir le détail

Clic sur le nom ou icône : ouvre la fiche catégorie avec :

Toutes les informations (identité, défauts métier, hiérarchie)
Les sous-catégories directes
Les articles rattachés
Bouton pour ajouter une sous-catégorie (pré-sélection automatique du parent)

Activer / Désactiver

Bascule l'attribut isActive. Une catégorie désactivée n'est plus proposée dans les listes de sélection (formulaire article, import…), mais reste consultable dans la liste pour préserver l'historique.

Supprimer une catégorie

Bouton sur la fiche, avec confirmation. Nukuntche refuse la suppression dans deux cas :

Catégorie avec sous-catégories Impossible de supprimer tant qu'elle contient des sous-catégories. Migrez ou supprimez d'abord les sous-catégories.

Catégorie avec articles rattachés Impossible de supprimer tant que des articles y sont rattachés. Migrez les articles vers une autre catégorie en passant par leur fiche, puis revenez supprimer.

Bonnes pratiques

Commencez large, affinez ensuite. Mieux vaut quelques grandes catégories au démarrage et les éclater plus tard si besoin, plutôt qu'une arborescence trop fine qui sera difficile à maintenir.
Renseignez la marge sur la catégorie, pas sur chaque article. Vous gagnez du temps à la fixation des prix et harmonisez la politique commerciale par segment.
Calibrez le seuil d'alerte selon la rotation. Les boissons (rotation rapide) ont des seuils élevés ; la téléphonie (faible rotation, panier élevé) des seuils bas.
Vérifiez le groupe TVA eMECeF. Erreur fréquente : oublier que certains produits (médicaments, produits exonérés) ne sont pas dans le groupe A par défaut. Un mauvais code remonte tel quel à la DGI.
Tenez le quota à l'œil. Le quota catégories dépend de votre abonnement. Le bandeau d'en-tête affiche en permanence X / N.

Et après ?

Créez vos articles, gérez la liste du catalogue et les caractéristiques produit — voir Articles