Domaines fonctionnels

Catalogue structure

Ce domaine regroupe les marques, modèles, caractéristiques et canvas. Il sert à structurer les lots pour que les vendeurs puissent les décrire correctement et que les acheteurs puissent les rechercher efficacement.

Catalogue structure

Ce domaine regroupe les marques, modèles, caractéristiques et canvas. Il sert à structurer les lots pour que les vendeurs puissent les décrire correctement et que les acheteurs puissent les rechercher efficacement.

Notions

NotionDéfinition
MarqueFabricant ou marque commerciale associée à un lot
ModèleRéférence ou modèle rattaché à une marque
CaractéristiqueInformation descriptive: année, énergie, puissance, dimensions, état, kilométrage, etc.
CanvasGabarit de saisie qui indique quelles informations collecter pour un type de lot
CatégorieFamille de lots utilisée pour classer et rechercher

À quoi sert ce domaine ?

  • Aider le vendeur à saisir des informations complètes.
  • Standardiser les fiches lots.
  • Améliorer la recherche marketplace.
  • Éviter les doublons de marques ou modèles.
  • Permettre des filtres pertinents par type de lot.
  • Faciliter les contrôles admin avant publication.

Workflow catalogue

flowchart TD
  besoin["Besoin de structurer un lot"] --> marque["Créer ou sélectionner la marque"]
  marque --> modele["Créer ou sélectionner le modèle"]
  modele --> caracteristiques["Définir les caractéristiques"]
  caracteristiques --> canvas["Composer le canvas"]
  canvas --> categorie["Associer aux catégories"]
  categorie --> saisie["Saisie du lot"]
  saisie --> controle{"Données complètes ?"}
  controle -->|Non| correction["Corriger les champs manquants"]
  controle -->|Oui| publication["Publication et recherche marketplace"]

Gestion des marques et modèles

ActionRègle
Créer une marqueRéservé aux profils avec le droit INTERNAL.BRAND.MANAGE, pour éviter les doublons
Créer un modèleRéservé aux profils avec le droit INTERNAL.MODEL.MANAGE; doit être rattaché à une marque existante
Fusionner des doublonsRéservé aux mêmes droits (INTERNAL.BRAND.MANAGE / INTERNAL.MODEL.MANAGE); sélection d'au moins 2 éléments, choix de l'enregistrement à conserver, nom final optionnel, confirmation obligatoire avant exécution
ModifierNe doit pas casser les lots existants
SupprimerAucun contrôle d'usage retrouvé: la suppression d'une marque, d'un modèle ou d'une caractéristique passe directement en base sans vérifier si un lot y fait encore référence (vérifié dans le service backend auctelia/items, contrôleurs marques/modèles/caractéristiques)

La fusion s'effectue soit ligne à ligne depuis la liste des marques ou des modèles (sélection multiple, action « Fusionner », formulaire radio pour choisir l'enregistrement conservé et un nom de remplacement facultatif), soit via l'outil de nettoyage référentiel décrit ci-dessous.

Détection et fusion des doublons (outil de nettoyage référentiel)

Un outil dédié (« Nettoyage référentiel », un onglet par type : marques ou modèles) aide à repérer et fusionner les doublons par lots plutôt qu'un par un.

ParamètreRègle
Stratégie de détectionRapprochement approximatif des noms (« fuse »)
Seuil de similaritéRéglable de 0,3 (large) à 0,9 (strict), par pas de 0,05 ; valeur par défaut 0,4
Taille max d'un groupe de doublons50 enregistrements
Filtre « utilisés par des produits »Optionnel : n'affiche que les enregistrements déjà rattachés à au moins un lot
Scission d'un groupeUn groupe détecté peut être scindé en sous-groupes, avec exclusion des enregistrements qui ne sont pas de vrais doublons
Choix du canoniquePar défaut l'enregistrement avec le plus de lots rattachés ; modifiable manuellement, avec nom personnalisé optionnel
FusionSe fait sous-groupe par sous-groupe, avec confirmation à chaque fusion
Suivi de progressionL'état (traité, ignoré, en attente) est mémorisé dans le navigateur de l'admin, par seuil de recherche utilisé

Gestion des caractéristiques

Une caractéristique doit être compréhensible, stable et exploitable. Elle peut être obligatoire ou facultative selon le canvas.

RègleExplication
Type de valeur9 types possibles : texte court, texte long, nombre entier, nombre décimal, date, case à cocher (oui/non), choix unique, choix multiple, document
UnitéOptionnelle pour les types nombre entier/décimal ; forcée à « sans objet » pour les types case à cocher, document, date et texte long (pas de sélecteur d'unité affiché)
OptionsUniquement pour les types choix unique / choix multiple ; chaque option a ses propres traductions et un ordre d'affichage
Clé externeDeux identifiants distincts : une « clé » métier (liste fermée, sert par ex. aux règles de labels d'autorisation) et une « clé ViaMobilis » (texte libre)
ObligationSe règle par canvas (voir ci-dessous) : une même caractéristique peut être obligatoire sur un canvas et facultative sur un autre. Si absente sur un lot, elle bloque la validation
StatutUne caractéristique archivée n'apparaît plus dans le sélecteur de caractéristiques d'un canvas (seules les caractéristiques actives sont proposées)
Visibilité5 emplacements réglables indépendamment (voir tableau ci-dessous)
RechercheUne caractéristique utile peut devenir un filtre marketplace

Emplacements de visibilité d'une caractéristique, avec leur valeur par défaut à la création :

EmplacementEffetValeur par défaut
Description de l'articleAffichée dans le bloc description de la fiche lot marketplaceNon
Liste des articlesAffichée sur la vignette du lot dans les listes marketplaceNon
FactureAffichée sur la factureNon
Rapport de retraitAffichée dans le rapport de retraitNon
Libre-service (self-service)Affichée dans le formulaire de dépôt de l'espace personnel vendeurOui

Gestion des canvas

Le canvas est le support de saisie d'un lot. Il détermine les champs attendus et leur logique.

ÉtapeDescription
DéfinitionL'admin catalogue prépare le gabarit (droit INTERNAL.CATEGORY.MANAGE requis pour créer, éditer ou supprimer un canvas)
CaractéristiquesSeules les caractéristiques au statut actif peuvent être ajoutées à un canvas, regroupées par thème dans le sélecteur ; chaque caractéristique ajoutée est facultative par défaut et bascule individuellement en obligatoire via un interrupteur dédié
Marque / modèleDeux cases indépendantes sur le canvas (« Marque obligatoire », « Modèle obligatoire ») imposent leur saisie sur les lots qui utilisent ce canvas
AssociationLe canvas est rattaché à une ou plusieurs catégories
SaisieLe vendeur ou l'admin renseigne les informations attendues
ContrôleLa plateforme détecte les champs manquants ou incohérents
PublicationLa fiche lot devient lisible et searchable

Blocages possibles

  • Marque ou modèle manquant.
  • Modèle incohérent avec la marque.
  • Caractéristique obligatoire absente.
  • Valeur non conforme au format attendu.
  • Canvas non adapté au type de lot.
  • Doublon de marque ou modèle à arbitrer.

Ce qui est implémenté

  • Les marques et modèles peuvent être créés, lus, modifiés et supprimés.
  • La création, modification et suppression d'une marque ou d'un modèle met à jour l'index de recherche.
  • Un modèle peut être filtré par marque.
  • Un canvas est créé avec un statut actif.
  • Un canvas peut être associé à des catégories.
  • Quand un canvas est archivé ou supprimé, les catégories associées sont détachées.
  • Une caractéristique peut être lue individuellement ou via la liste complète.
  • Une clé externe de caractéristique est contrôlée pour éviter les réutilisations non souhaitées.
  • La validation d'un lot contrôle les caractéristiques obligatoires du canvas.
  • Si le canvas exige une marque ou un modèle, la validation du lot contrôle aussi leur présence.
  • Si un champ obligatoire est absent ou invalide, la validation du lot est bloquée et les champs manquants sont stockés sur le lot.
  • Un lot véhicule porte des caractéristiques dédiées à la carte grise (genre, type, carrosserie administrative, nombre de places), distinctes des caractéristiques commerciales affichées à l'acheteur, utilisées pour produire les documents de cession.
  • Une caractéristique peut être exclue du formulaire de dépôt self-service (espace personnel): elle reste alors saisissable par l'admin, et une valeur déjà renseignée n'est jamais perdue en réouvrant un brouillon, seul le champ est masqué au vendeur. Une caractéristique créée depuis l'admin est visible en self-service par défaut.
  • La fiche lot de la marketplace n'affiche, dans son bloc description, que les caractéristiques explicitement marquées comme visibles dans la description; les autres restent internes ou réservées à d'autres emplacements de la fiche.
  • La carte lot (vignette affichée dans les listes de la marketplace) n'affiche que les caractéristiques marquées visibles en liste d'articles, indépendamment de leur visibilité en description.
  • La visibilité d'une caractéristique se règle indépendamment par emplacement: description du lot, liste d'articles, facture, rapport de retrait et formulaire self-service. L'admin dispose d'un éditeur complet par caractéristique (traductions par langue, clé externe, unité, options pour les listes déroulantes, et ces indicateurs de visibilité); seuls nom, type, thème et statut étaient éditables auparavant.
  • Un lot affiche distinctement s'il a été remis en vente ou non, avec la date et l'auteur de la décision; un lot refusé et jamais remis en vente n'affiche plus par erreur un badge « remis en vente ».
  • La fusion d'une marque ou d'un modèle exige de sélectionner au moins deux enregistrements, de désigner celui qui est conservé, et se fait sous confirmation explicite; elle est réservée aux droits INTERNAL.BRAND.MANAGE (marques) et INTERNAL.MODEL.MANAGE (modèles).
  • Un outil de nettoyage référentiel détecte les doublons de marques et de modèles par similarité de nom (seuil réglable, filtre sur les enregistrements déjà utilisés par des produits) et permet de les fusionner groupe par groupe.
  • Seules les caractéristiques actives peuvent être ajoutées à un canvas; chaque caractéristique d'un canvas est facultative par défaut et se bascule individuellement en obligatoire.

Labels d'autorisation d'achat

Un lot peut restreindre qui a le droit de l'acheter via des labels d'autorisation. 8 labels existent au total : Professionnels de l'automobile, Revendeurs de machines-outils, Revendeurs d'engins de chantier et de travaux publics, Professionnels (générique), Carte d'identité nationale, Justificatif de registre, Autorisation manuelle, Ouvert à tous.

  • Certains labels sont calculés automatiquement à partir des caractéristiques du lot et deviennent alors obligatoires et verrouillés (case à cocher grisée) dans le formulaire vendeur, avec un bouton d'explication qui détaille la raison exacte du déclenchement.
  • Le vendeur garde la main pour cocher des labels additionnels non requis par les caractéristiques du lot, mais uniquement parmi ceux que le contrat de l'organisation vendeuse autorise à activer soi-même (« activable par le vendeur »); les autres labels n'apparaissent dans le formulaire que s'ils ont été déclenchés automatiquement.
  • La restriction d'achat s'applique dès qu'un label pertinent est actif sur le lot, quelle qu'en soit l'origine (règle de caractéristique, valeur par défaut du contrat ou choix du vendeur); un lot ne perd plus sa restriction "professionnels uniquement" selon la manière dont le label a été activé.

Règles de calcul automatique (toutes les conditions d'une même ligne doivent être vraies) :

RègleCondition(s)Label ajouté
Contrôle technique manquantDernier contrôle technique datant de plus de 6 mois et première mise en circulation datant de plus de 3 ansRevendeurs d'engins de chantier et de travaux publics
Défaut critiqueCaractéristique « défauts critiques » = ouiRevendeurs d'engins de chantier et de travaux publics
Destiné à la destructionCaractéristique « non réimmatriculable pour destruction » = ouiProfessionnels de l'automobile
Non-conformité sécuritéCaractéristique « non conforme à la sécurité au travail » = ouiRevendeurs de machines-outils et revendeurs d'engins de chantier et de travaux publics
Absence de carte griseCaractéristique « inclut les documents d'immatriculation » = nonRevendeurs d'engins de chantier et de travaux publics
Véhicule non roulantCaractéristique liée à la clé « véhicule non roulant » = fauxRevendeurs d'engins de chantier et de travaux publics

En complément, dès que l'un des trois labels « revendeurs » ci-dessus (automobile, machines-outils, ou engins de chantier/TP) est actif sur le lot — qu'il ait été déclenché par une règle ou activé par le vendeur — le label générique « Professionnels » est ajouté et verrouillé automatiquement.

Copyright © 2026