Workflow item / lot

Ce workflow matérialise le cycle d'un item, appelé lot dans la documentation fonctionnelle TARS.

flowchart TD
  creation["Création de l'item"] --> brouillon["Brouillon vendeur"]
  brouillon --> enrichissement["Description, photos, catalogue, prix et conditions"]
  enrichissement --> completude{"Item complet ?"}
  completude -->|Non| correction["Correction vendeur ou admin"]
  correction --> enrichissement
  completude -->|Oui| controle["Contrôles: organisation, contrat, documents, catalogue"]
  controle --> decision{"Publication possible ?"}
  decision -->|Non| blocage["Blocage ou demande de modification"]
  blocage --> correction
  decision -->|Oui| publication["Publication marketplace"]
  publication --> vente["Item visible dans une vente ou séance"]
  vente --> participation["Watchlist, questions, offres ou enchères"]
  participation --> cloture{"Clôture"}
  cloture -->|Gagnant| attribution["Attribution à l'acheteur"]
  cloture -->|Aucun gagnant| invendu["Invendu"]
  attribution --> finance["Facture, paiement et commission"]
  finance --> retrait["Rendez-vous, retrait ou livraison"]
  invendu --> suite{"Suite item"}
  suite -->|Remise en vente| enrichissement
  suite -->|Retrait| archive["Archivage et audit"]
  retrait --> archive

États principaux

Contrôles structurants

• L'item doit être rattaché à un vendeur et à une organisation autorisée.
• Les informations obligatoires de catalogue doivent être complètes.
• Le contrat et les conditions de vente doivent permettre la publication.
• Les documents ou validations requis ne doivent pas bloquer la vente.
• La clôture détermine attribution, invendu, remise en vente ou retrait.
• Un vendeur peut accepter ou refuser en masse l'attribution des lots à valider ayant reçu au moins une enchère.
• Un lot non payé (défaut de paiement acheteur) peut être remis en vente comme un invendu, s'il ne l'a jamais été auparavant.
• Un super-admin peut, à titre exceptionnel, forcer le statut d'un lot en dehors de ce workflow.
• Le statut « Retiré » est désormais visible et filtrable par le vendeur dans sa propre liste de lots, plus seulement par l'admin.
• Au démarrage d'une création de brouillon en libre-service, le vendeur peut choisir l'organisation procurée pour laquelle il dépose (parmi celles disposant d'un contrat de vente actif éligible au libre-service pour la boutique courante); changer d'organisation à cette étape bascule le contexte de session avant la création.
• Un vendeur terminant le dépôt d'un lot alors qu'il opérait au nom d'une autre organisation que la sienne est automatiquement replacé dans le contexte de son organisation principale avant d'être redirigé vers sa liste de brouillons.
• Dans sa liste de brouillons, le vendeur voit désormais tous ses brouillons, y compris ceux créés pour lui par l'administration, plus seulement ceux créés en libre-service.
• Les changements importants doivent rester visibles dans l'audit et les rapports.

D'où vient le lot : BO ou espace personnel

Chaque lot porte une source d'origine (BO pour le back-office admin, EP pour l'espace personnel) et un indicateur auto-service (selfService) qui détermine qui pilote sa validation :

• un lot créé en admin (admin-front) est marqué selfService = false : c'est un lot « géré » par les opérations, dont la mise en vente passe par une validation interne puis, si besoin, une validation du vendeur explicitement demandée ;
• un lot déposé en libre-service par le vendeur (customer-front, ou l'inventaire terrain une fois publié) est marqué selfService = true : le vendeur peut le soumettre, le corriger et, selon le contrat, le faire valider par ce circuit ;
• un lot legacy (importé de l'ancienne plateforme, identifiant préfixé agora-) est traité à part : il ne peut être ni validé, ni supprimé, ni retiré, ni voir son statut forcé par les outils standard.

Cette distinction source + auto-service conditionne la plupart des règles ci-dessous ; voir aussi Différences BO / espace personnel.

Changements de statuts

La liste exhaustive des statuts de lot, des transitions, des droits requis et des conditions précises est tenue dans Statuts et transitions. En résumé, les actions de workflow proposées en admin dépendent du statut courant :

Un profil super-admin disposant de SUPER.ITEM.STATUS_MANAGE peut, hors de ce workflow, forcer le statut du lot vers l'un des statuts aval accessibles (validé, ouvert, fermé, assigné, facturé, non attribué, invendu, payé, non payé, confirmé, remboursé, commissionné, soumis, soldé) — jamais vers un statut amont (brouillon, à contrôler, à modifier, refusé) et jamais sur un lot legacy. L'action « Forcer le statut » propose ces statuts moins le statut courant, et reste tracée dans l'audit.

Les statuts aval facturé, payé, non payé, confirmé, commissionné, remboursé, soldé ne résultent pas d'une action sur le lot lui-même : ils suivent le cycle de vie de la ou des factures associées (voir Statuts et transitions — Facture).

Automatismes du cycle de vie

Un lot n'avance pas uniquement sous l'effet d'actions humaines : le back-office fait progresser les lots automatiquement, et une partie du comportement dépend des paramètres du contrat de vente.

Ouverture, prolongation et clôture automatiques

Des traitements récurrents balaient les lots et déclenchent :

• Ouverture : un lot validé dont la date de début est atteinte passe automatiquement « ouvert ».
• Prolongation : un lot d'enchères arrivant à échéance sans aucune enchère est prolongé une fois (durée fixée par la boutique) avant d'être clôturé — une dernière chance de recevoir une enchère.
• Clôture : à l'échéance, le lot passe « fermé », puis une décision automatique est prise.

Décision à la clôture

À la clôture, deux cas :

• Aucune enchère (et pas d'offre directe gagnante) → le lot devient invendu.
• Au moins une enchère → la suite dépend de trois réglages du contrat de vente :

Sans prix de réserve défini, la réserve est réputée atteinte. Ces réglages (attribution automatique, facturation automatique) sont relus sur le contrat à chaque décision : les modifier change le comportement des lots concernés, y compris ceux déjà en cours de vente.

Auto-refus des lots fermés non traités

Un lot resté fermé au-delà d'un délai (exprimé en jours ouvrés, fixé par le paramètre d'attribution automatique du contrat) est automatiquement refusé : il passe non attribué mais conserve son enchère gagnante, qui pourra être ré-attribuée. Les jours fériés ne sont pas déduits du délai. Si le contrat n'active pas l'attribution automatique, il n'y a pas d'auto-refus : le lot attend une décision manuelle.

Validation de vente (deux objets distincts)

Quand un lot « géré » (non auto-service) doit être validé par le vendeur, le back-office demande une validation de vente : le lot passe « à contrôler (EP) » et un objet validation de vente séparé est créé (statuts : à contrôler, validée, refusée, annulée). La décision se prend sur cet objet, pas sur le lot directement :

• Valider → le lot passe « validé » (prêt à rouvrir). Garde-fou : un non-administrateur ne peut pas valider si la fin d'enchère prévue est à moins de 5 jours.
• Refuser → le lot est retiré (motif obligatoire).
• Annuler → le lot repart « à contrôler BO ».

Relances automatiques

• Un lot d'enchères sans enchère proche de sa clôture (moins de 48 h) apparaît dans un tableau de suivi dédié, sans bloquer la clôture.
• Un vendeur dont des lots sont invendus / non attribués / non payés et jamais encore remis en vente reçoit un email de relance l'invitant à les remettre en vente (envoi unique, tracé pour éviter les doublons).

Remise en vente

La remise en vente permet de redonner une chance à un lot qui n'a pas trouvé preneur. Elle obéit à trois règles constantes, quel que soit le frontal :

• Statuts éligibles : uniquement invendu (UNSOLD) sans aucune enchère, non attribué (NOT_ASSIGNED) ou non payé (NOT_PAID, défaut de paiement acheteur). Un invendu ayant reçu au moins une enchère n'est pas remis en vente par ce mécanisme.
• Une seule fois : un lot déjà remis en vente (ou pour lequel la remise en vente a été explicitement déclinée) porte un marqueur resold qui interdit toute nouvelle remise en vente.
• Traçabilité de la filiation : le lot remis en vente reste rattaché au lot d'origine (lot parent), ce qui permet de suivre la chaîne des tentatives et de reprendre le prix de départ / prix de réserve de l'annonce initiale.

En admin (admin-front)

• Action « Remettre en vente les produits », réservée à ITEM.ITEM.MANAGE.
• L'admin choisit la séance de destination ; le ou les lots y sont déplacés directement. L'action est disponible à l'unité comme en masse (les lots doivent alors appartenir à la même boutique).

Dans l'espace personnel (customer-front, vendeur)

Le vendeur dispose de trois actions distinctes sur un lot éligible :

Les deux dernières actions sont aussi disponibles en masse (jusqu'à 50 lots à la fois).

Duplication d'un lot

La duplication crée un ou plusieurs lots à partir d'un lot existant. Elle diffère nettement selon le frontal.

Dans les deux cas, la duplication produit de nouveaux lots indépendants (nouveaux identifiants) ; elle ne modifie pas le lot source.

Assignation

L'assignation attribue un lot fermé à un acheteur. Deux mécanismes coexistent, plus le circuit d'acceptation côté vendeur. Cette section décrit les actions et les droits par frontal ; le déroulé métier complet (enchère gagnante, prix de réserve, création du compte payeur, réassignation, invendu/non payé) est détaillé dans L'assignation (post-vente).

En admin (admin-front)

« Attribuer » et « Assignation manuelle » sont deux comportements distincts, pas deux variantes d'une même action :

Autrement dit : Attribuer part d'une enchère réelle et désigne le gagnant ; Assignation manuelle fabrique l'enchère gagnante (acheteur + montant) là où il n'y en a pas, ou pour forcer un autre acheteur / un autre prix. Chaque action passe par une confirmation et un contrôle du droit rejoué côté serveur. Un troisième parcours, l'écran d'assignation de la séance, permet en plus de choisir, lot par lot, quelle enchère existante attribuer (parmi les meilleures) ou de marquer « aucune enchère » — voir L'assignation (post-vente).

Dans l'espace personnel (customer-front, vendeur)

Sur un lot fermé ayant reçu au moins une enchère (« vente à valider »), le vendeur peut, s'il dispose de SALES.ITEM.ASSIGN :

• Accepter la vente (« Accepter la vente ») — attribue le lot ;
• Refuser la vente (« Refuser la vente ») — refuse l'attribution.

Ces deux décisions sont disponibles à l'unité et en masse jusqu'à 50 lots.

Différences de règles BO / espace personnel

Une case « possible » reste soumise aux droits, au statut et aux contrôles métier ; voir Actions par frontal et Statuts et transitions.