Articles

L'écran Articles regroupe tout le quotidien de votre catalogue produit : consulter la liste, rechercher, filtrer, créer, modifier, dupliquer, importer en masse, enrichir d'images et de caractéristiques. Cette section couvre chaque action disponible depuis le menu Catalogue → Articles.

Accéder au menu

Menu latéral → Catalogue → Articles. La page affiche la liste complète des articles de votre tenant, avec leur statut, leur stock et leur prix de vente.

Capture à venir : 00-acces-menu.png

La liste du catalogue

Ce que vous voyez

Chaque ligne représente un article du catalogue tenant. Les colonnes affichées :

Photo, nom, référence et catégorie de rattachement
Stock total sur la boutique active et ses magasins liés (Vision A multi-boutiques)
Prix de vente actuel, ou badge Bloqué en vente si non renseigné
Statut : actif, inactif, bloqué en vente, en rupture, en stock bas
Actions : voir, modifier, dupliquer, activer/désactiver, supprimer

Multi-boutiques (Vision A) La liste affiche tout le catalogue du tenant — un article appartient à votre entreprise, pas à une boutique. En revanche, les statistiques stock (en-tête : « total », « en stock », « rupture », « valeur ») sont calculées sur la boutique active et ses magasins liés.

Capture à venir : 03-liste-catalogue.png

Statistiques en en-tête

Total catalogue — nombre d'articles dans votre catalogue
Articles en stock — au moins une unité disponible
Articles en rupture — stock à zéro
Valeur du stock — somme des (CUMP × quantité) sur tous les articles
Quota — X / N articles selon votre abonnement

Rechercher

La barre de recherche en haut filtre sur le nom, la référence et le code-barres. Si vous utilisez un scanner physique, scannez directement dans le champ — la recherche se met à jour à la frappe.

Filtrer et trier

Statut : Tous / Actifs / Inactifs / Bloqués en vente
Stock : Tous / En stock / Rupture / Stock bas (sous le seuil d'alerte)
Tri : par nom, référence, catégorie, prix, stock, date de création (ASC / DESC)
Pagination : 20 / 50 / 100 articles par page (paramètre limit)

Exporter

Bouton Export CSV en haut à droite : exporte la liste filtrée (jusqu'à 10 000 lignes) au format CSV avec toutes les colonnes pour ouverture Excel.

Actions par ligne

Voir le détail

Clic sur la ligne ou icône : ouvre la fiche article avec :

Toutes les informations catalogue
Stock par entrepôt et par emplacement
Historique des coûts d'achat (CUMP au fil du temps)
Mouvements de stock chronologiques
Conditions fournisseurs : prix négociés, délais, références

Modifier

Icône : ouvre le formulaire de modification. Tous les champs catalogue restent éditables. Particularités :

Image : remplacer une image supprime automatiquement l'ancienne du disque
Fournisseur principal : si vous changez le fournisseur historique, l'ArticleFournisseur principal est basculé en conséquence (sync automatique)
Seuils par lieu : modifiables depuis la fiche détaillée, pas depuis ce formulaire

Dupliquer

Icône : crée une copie de l'article avec :

Nouvelle référence générée automatiquement (unique)
Nouveau code-barres généré automatiquement
Nom préfixé « Copie de … »
Stock vide (à zéro)
Image non copiée (à re-uploader si besoin)
Caractéristiques copiées, catégorie / fournisseur / emplacement aussi

Après duplication, vous arrivez directement sur le formulaire de modification de la copie.

Activer / Désactiver

Bascule l'attribut isActive. Un article désactivé reste consultable mais n'apparaît plus dans les listes de sélection (facture, BC…).

Supprimer

Confirmation requise (modal). La suppression est logique (SoftDeleteable) : l'article disparaît des listes mais reste référencé dans l'historique des factures, mouvements et BC pour préserver la traçabilité comptable.

Actions groupées

Sélectionnez plusieurs articles avec les cases à cocher, puis choisissez une action :

Activer — mise à isActive = true en masse
Désactiver — mise à isActive = false en masse
Supprimer — suppression logique en masse
Exporter Excel — fichier .xlsx de la sélection avec toutes les colonnes

Créer un article

Bouton Nouvel article en haut à droite de la liste, ou menu rapide. Le formulaire s'ouvre avec la référence et le code-barres pré-remplis automatiquement (modifiables, mais obligatoires).

Capture à venir : 01-formulaire-vide.png

Champs obligatoires

Nom du produit (visible sur factures et catalogues), 3 à 100 caractères
Catégorie — définit la marge cible, le seuil et le groupe TVA par défaut (voir Catégories)
Unité de mesure (pièce, kg, litre, boîte…)
TVA applicable : 18 % ou exonéré (transmis à e-MECeF)
Référence (pré-remplie) — 3 à 50 caractères, lettres/chiffres/tirets/underscores

Champs optionnels

Code-barres : pré-rempli, modifiable ou scannable depuis le formulaire
Description : jusqu'à 2 000 caractères (zone de texte longue)
Image : JPG ou PNG, max 1 Mo
Caractéristiques : liste normalisée (voir section ci-dessous)
Fournisseur principal : peut être complété par d'autres fournisseurs depuis la fiche

Ce qui n'est PAS saisi ici

Pas de prix d'achat — déterminé par les bons de commande et la réception (CUMP recalculé à chaque entrée).

Pas de prix de vente — fixé après la première réception via un écran dédié, avec suggestion basée sur la marge catégorie.

Pas de seuils de stock — définis par lieu de stockage sur la fiche article (un même produit peut avoir des rotations différentes selon la boutique).

Importer en masse

Bouton Importer en haut de la liste. Permet de créer plusieurs centaines d'articles d'un coup, idéal pour la reprise d'un catalogue existant.

Capture à venir : 04-import-excel.png

Télécharger le template — bouton en haut. Le fichier template_import_articles.xlsx contient les colonnes attendues et la liste réelle de vos catégories en validation.
Remplir le template — une ligne par article. Tous les champs obligatoires sont marqués.
Uploader le fichier — formats acceptés : .xlsx, .xls.
Validation automatique — Nukuntche contrôle le fichier (extension, taille), puis chaque ligne (champs obligatoires, format catégorie, unicité référence/code-barres).
Vérification du quota — si votre fichier dépasse le quota d'articles de votre abonnement, l'import est refusé avec un message clair (par exemple « Quota insuffisant : vous pouvez importer 50 articles, votre fichier en contient 200 »).
Import effectif — les lignes valides sont créées en masse, avec un flash de succès indiquant le nombre d'articles importés.

Erreurs ligne par ligne Si le fichier contient des erreurs, l'écran les affiche ligne par ligne (numéro de ligne, nom, liste d'erreurs). Corrigez votre fichier et re-uploadez — aucun article n'est créé tant qu'il y a des erreurs.

Recherche par code-barres (scan)

Endpoint dédié pour les workflows scan : /article/barcode/<barcode>. Retourne en JSON l'article correspondant si trouvé. Utilisé en interne par la caisse, les bons de commande et les réceptions pour lookup instantané.

Création rapide (quick-create)

Depuis un formulaire (facture, BC…), un bouton + à côté du sélecteur d'article ouvre une modale qui permet de créer l'article minimal (nom + catégorie + unité + TVA) sans quitter le formulaire en cours. L'article est immédiatement disponible dans la liste.

Les caractéristiques

Les caractéristiques enrichissent la fiche d'un produit avec des attributs structurés (couleur, taille, poids, marque…). Nukuntche utilise une liste normalisée pour éviter les doublons et permettre la recherche par attribut.

Capture à venir : 02-caracteristiques.png

Pourquoi une liste fermée ?

Si chacun peut saisir librement, vous finissez avec « poids », « Poids », « weight », « pds » qui décrivent la même chose. Résultat : vous ne pouvez plus rechercher ni filtrer vos articles. La liste fermée garantit la cohérence.

Les 20 types disponibles

Identité : Marque, Modèle, Référence fabricant
Apparence : Couleur, Taille, Dimensions, Matière
Mesures physiques : Poids, Volume, Capacité
Énergétique : Puissance, Tension
Cible : Genre, Âge cible
Alimentaire / cosmétique : Saveur, Parfum
Commercial : Origine, Garantie, Conditionnement, Certification

Comment ça marche

Dans le formulaire article, section Caractéristiques, cliquer sur Ajouter une caractéristique
Choisir le type dans la liste déroulante (ex. Couleur)
Le placeholder du champ valeur s'adapte automatiquement (« ex : Bleu nuit, Rouge cerise »)
Saisir la valeur librement
Répéter pour chaque caractéristique pertinente

Un type manque ? Contactez votre administrateur. Ajouter un nouveau type est une décision structurante — elle ne se fait pas à la volée pour garder la base propre dans le temps.

Et après ?

Créez vos catégories d'abord — voir Catégories
Créez vos articles (fiche catalogue uniquement)
Passez un bon de commande — voir Créer un bon de commande
Réceptionnez → le CUMP est calculé, le stock entre — voir Réceptionner un BC
Fixez le prix de vente via l'écran dédié
L'article devient vendable en facture