Post-vente
De l'assignation d'un item jusqu'à la facturation et aux flux MangoPay — parcours technique et fonctionnel du post-vente.
Post-vente : de l'assignation à la facturation
Cette section raconte la vie d'un item (un lot mis en vente : machine, véhicule, bien immobilier…) à partir du moment où l'enchère se termine, jusqu'à ce que tout le monde ait été payé et que la comptabilité soit bouclée.
Contrairement au reste de la documentation — volontairement fonctionnelle — cette section est technique et fonctionnelle : les encadrés « Détails techniques » (repliés) donnent les noms de fichiers, fonctions et enums exacts du monorepo. Dépliez-les quand vous voulez aller au code.
L'histoire en 6 étapes
Quoi qu'il arrive, le parcours post-vente suit toujours la même logique.
flowchart LR
a["1. Assignation"] --> b["2. Facturation"]
b --> c["3. Paiement acheteur"]
c --> d["4. Répartition"]
d --> e["5. Reversement vendeur"]
e --> f["6. Clôture (SETTLED)"]
| Étape | Ce qui s'y passe |
|---|---|
| 1. Assignation | Un job automatique détecte la fin d'enchère. S'il y a un gagnant et que le prix de réserve est atteint, l'item est assigné : on enregistre officiellement qui l'a remporté et à quel prix. |
| 2. Facturation | Les factures sont créées automatiquement à l'assignation (pas au paiement). Selon le mode, 1 ou 2 factures : la vente, et parfois une facture de frais acheteur séparée. |
| 3. Paiement acheteur | L'acheteur paie par carte ou virement, via MangoPay ou par virement classique sur le compte du shop (Ponto). Le paiement reçu est rapproché de la facture. |
| 4. Répartition | Sur MangoPay, des transfers déplacent l'argent du portefeuille de l'acheteur vers celui du vendeur (sa part) et celui de la plateforme (commission + frais acheteur). |
| 5. Reversement vendeur | Un payout envoie l'argent du portefeuille MangoPay du vendeur vers son vrai compte bancaire (IBAN). La plateforme garde sa commission. |
| 6. Clôture | Tout est réglé (SETTLED) : factures soldées, écritures comptables exportées, l'acheteur enlève son lot lors d'un rendez-vous. |
L'image à garder en tête. La plateforme agit comme un notaire de brocante géante : elle constate qui a gagné quoi (assignation), rédige les papiers (factures), encaisse dans un coffre sécurisé (MangoPay), puis redistribue à chacun sa part — le vendeur reçoit le prix de vente moins la commission, la plateforme garde la commission et les frais acheteur.
Les deux grandes familles de circuits d'argent
Circuit MangoPay
PAY_TO_SHOP_MANGOPAY — l'argent transite par des portefeuilles électroniques (wallets) chez MangoPay, un établissement de paiement agréé. Tout est traçable et automatisé : encaissement → transfert → reversement. C'est le circuit moderne.Circuit virement classique
PAY_TO_SHOP_PONTO — l'acheteur vire directement sur le compte bancaire du shop. Les mouvements sont synchronisés via Ponto/Isabel, rapprochés des factures, et les reversements partent en virements SEPA (fichiers XML Isabel). C'est le circuit historique.Parcourir la section
| Chapitre | Page |
|---|---|
| Concepts de base (shops, contrats, modes) | Concepts |
| 1. L'assignation | Assignation |
| 2. La facturation | Facturation |
| 3. Calculs & TVA | Calculs et TVA |
| 4. Le paiement | Paiement |
| 5. Les flux MangoPay | Flux MangoPay |
| 6. Avoirs & remboursements | Avoirs et remboursements |
| 7. Comptabilité & reporting | Comptabilité et reporting |
| Annexes (enums, fichiers, FAQ) | Annexes |
Le monorepo découpe le post-vente en micro-services :
jobs (workflows automatiques : clôture, assignation, facturation), book-keeper (cœur de la facturation : factures, mouvements bancaires, lettrage), mangopay (intégration MangoPay : payins, transfers, payouts, webhooks), items / bidding (lots et enchères), appointments (rendez-vous d'enlèvement), documents + document-template (PDF des factures), email-sender (notifications), reporting (exports comptables et rapports), admin-frontend (écrans back-office).