Post-vente
Concepts de base
Shops, contrats et les quatre modes (vente, facturation, paiement, reversement) qui pilotent tout le post-vente.
Les concepts de base
Cinq notions reviennent partout : le shop, le contrat, le mode de vente, le mode de facturation et le mode de paiement. Une fois qu'on les tient, tout le reste découle.
Les shops (boutiques / marchands)
Un shop est une marketplace configurée dans le système. Il en existe quatre, identifiées par leur code comptable :
| Code | Shop | Univers |
|---|---|---|
AUEQ | Auctelia | Équipement (machines, véhicules, matériel) |
AUIM | Auctelia | Immobilier |
AGEQ | Agorastore | Équipement |
AGIM | Agorastore | Immobilier |
Chaque shop porte sa propre configuration :
- Taux par défaut (
meta.saleInformation.rates) : frais de service, TVA, commission vendeur, commission partenaire ; - Comptes bancaires associés (type
SALEpour encaisser les ventes, typeCOMMISSIONpour les commissions) ; - Configuration MangoPay sécurisée (
meta.secure.mangopay) : identifiants API et portefeuilles de la plateforme (commissions courtage, commissions commissaire-priseur, caution TVA, compte bancaire plateforme).
Où se joue la différence entre shops ? Contrairement à l'intuition, le mode de facturation (simple/double) n'est pas une propriété du shop : il vient du contrat du vendeur. Le shop détermine surtout : le code comptable (AUEQ/AGEQ…) qui préfixe toutes les écritures, les taux par défaut, les comptes bancaires/wallets utilisés, et l'habillage des documents. Des codes comptables spécifiques Agorastore existent par ligne de facture (
agorastoreAccountingCode, agorastoreVatAccountingCode).Schéma : auctelia-models/src/schemas/Configs/Shop.js — champs shopShortId, shopType (EQUIPMENT | REAL_ESTATE), accountingShopCode (AccountingShopCodes), associatedBankAccounts[].types (SALE/COMMISSION), associatedOrganisations[].roles (EDIT, CREATOR, SELLER, PARTNER).
À noter : les dossiers agorastore-slice et auctelia-slice du monorepo n'ont rien à voir avec la finance — ce sont des composants Prismic (CMS) pour le contenu marketing des deux sites.
Les contrats : la télécommande du post-vente
Chaque vendeur signe un contrat avec le shop. C'est lui qui répond aux quatre questions clés.
Question 1 — Comment vend-on ? (SalesModes)
| Mode | En clair |
|---|---|
BROKERAGE | Courtage : la plateforme met en relation vendeur et acheteur. La vente a juridiquement lieu entre eux ; la plateforme prend une commission. C'est le mode principal. |
AUCTIONEER | Commissaire-priseur : la maison de vente vend elle-même au nom du vendeur (ventes judiciaires, faillites…). |
PURCHASE_RESELL | Achat-revente : le shop achète le bien puis le revend en son nom propre. |
Question 2 — Comment facture-t-on ? (InvoiceModes)
| Mode | En clair |
|---|---|
INTERMEDIATION_INVOICE_SIMPLE | Facturation simple : 1 seule facture à l'acheteur (vente + frais acheteur ensemble). |
INTERMEDIATION_INVOICE_DOUBLE | Facturation double : 2 factures à l'acheteur (la vente d'un côté, les frais acheteur de l'autre). |
AUCTIONEER | Le commissaire-priseur facture l'acheteur directement (1 facture tout compris). |
SERVICE_INVOICE | Factures de prestations de service. |
PURCHASE_RESELL / REAL_ESTATE | Achat-revente / immobilier (variantes spécifiques). |
Question 3 — Où l'acheteur paie-t-il ? (PayInModes)
| Mode | En clair |
|---|---|
PAY_TO_SHOP_MANGOPAY | Via MangoPay : carte bancaire ou virement vers un IBAN virtuel dédié à l'acheteur. |
PAY_TO_SHOP_PONTO | Virement classique sur le compte bancaire du shop (rapproché via Ponto). |
PAY_TO_SHOP_PAYBOX | Paiement carte via PayBox (historique/legacy). |
PAY_TO_SELLER | L'acheteur paie directement le vendeur (rare — la plateforme ne touche pas l'argent). |
Question 4 — Comment reverse-t-on le vendeur ? (PayOutModes)
| Mode | En clair |
|---|---|
FEES_DEDUCTION | On reverse au vendeur le prix de vente moins la commission (déduction des frais). Le plus courant. |
FULL_SELLER_PAYMENT | On reverse 100 % au vendeur, et la commission est facturée à part. |
NO_SELLER_PAYMENT | Aucun reversement par la plateforme (ex. l'acheteur a payé directement le vendeur). |
À retenir. Le contrat est la « télécommande » : quand vous vous demandez « pourquoi cet item a 2 factures et pas cet autre ? » ou « pourquoi ce vendeur n'a pas encore été payé ? », la réponse est presque toujours dans la configuration du contrat (
invoiceMode, payInMode, payOutMode) que l'item embarque dans indexedMeta.contractInformation.L'automatisation au contrat
Le contrat définit aussi ce qui se fait tout seul ou à la main, via les AutomationParamKeys :
| Paramètre | Effet quand il est actif |
|---|---|
ASSIGN_AUTO | L'item est assigné automatiquement au gagnant à la clôture. |
SALES_INVOICE_CREATE_AUTO | Les factures de vente sont créées automatiquement. |
CONFIRM_AUTO | La vente est confirmée automatiquement après paiement. |
COMMISSION_CREATE_AUTO | La facture de commission est créée automatiquement. |
COMMISSION_VALIDATE_SHOP_AUTO | La commission est validée automatiquement côté shop. |
NO_PAY_AUTO | Passage automatique en impayé après l'échéance. |
INVOICING_MANDATE | Mandat de facturation : la plateforme est autorisée à émettre les factures de vente au nom du vendeur (autofacturation). |
auctelia-models/src/schemas/Constants/Contract.js — InvoiceModes, PayInModes, PayOutModes, AutomationParamKeys, et ContractTypes qui mappe chaque type de contrat vers son code comptable (ex. AuctionBrokerUniqueInvoice → accounting C pour courtage, Auctioneer → S, PurchaseResell → V).