Fidélité + Crédit Revolution

MPR Loyalty Revolution

Un module complet de gestion de comptes commerciaux B2B, de fidelite client et de comptes de credit pour PrestaShop 1.7+.

Aperçu

MPR Loyalty Revolution fournit une solution complété pour la gestion des clients commerciaux, des niveaux de fidelite et des comptes de credit :

• Demandes de compte commercial - Les clients demandent des comptes commerciaux avec validation TVA et telechargement de documents
• Système de niveaux - Niveaux configurables pour les clients commerciaux et individuels avec qualification automatique
• Comptes de credit - Ligne de credit pour les clients B2B avec suivi des paiements et integration Stripe
• Gestion d'entreprise B2B - Comptes d'entreprise multi-utilisateurs avec ressources partagees

Fonctionnalités

Gestion des comptes professionnels

• Formulaire de demande en ligne avec champs personnalisables
• Validation du numéro de TVA (integration API VIES)
• Support de telechargement de documents (licences commerciales, certificats)
• Approbation automatique basee sur des regles configurables
• Workflow de revision et d'approbation manuelle
• Suivi du statut de la demande pour les clients
• Gestion de l'expiration avec notifications

Système de niveaux

Deux parcours de niveaux separes :

• Niveaux commerciaux - Pour les clients B2B/commerciaux (necessite l'approbation du compte commercial)
• Niveaux individuels - Pour les clients réguliers (base sur l'historique d'achat)

Fonctionnalités des niveaux :

• Regles de qualification configurables (chiffre d'affaires, nombre de commandes, anciennété du compte, etc.)
• Avantages : remises, livraison gratuite, conditions de paiement, support prioritaire
• Evaluation automatique du niveau lors de la commande
• Verrouillage de niveau avec expiration optionnelle
• Periodes de grâce àvant retrogradation
• Historique complet des changements de niveau

Système de comptes de credit

Modèle de ligne de credit :

• Limites de credit configurables (depuis le niveau, l'entreprise ou manuellement)
• Taux de couverture (ex. 50% credit, 50% paiement initial)
• Conditions de paiement (Net 7, 14, 30, 60 jours)
• Interets sur les paiements en retard (configurable)

Suivi des paiements :

• Suivi du credit par commande avec dates d'echeance
• Declarations de paiement avec telechargement de justificatif
• Workflow de confirmation administrateur
• Intégration Stripe Checkout pour les paiements en ligne
• Allocation de paiement FIFO ou sélective
• Solde excedentaire des remboursements

Credit d'entreprise :

• Pool de credit partage pour les membres de l'entreprise
• Sous-limites optionnelles par membre
• L'administrateur d'entreprise peut gérer les limites des membres

Gestion des entreprises B2B

• Profils d'entreprise avec verification
• Plusieurs employes par entreprise
• Permissions basees sur les roles (admin/membre)
• Carnet d'adresses partage
• Système d'invitation (lien ou email)
• Correspondance automatique de domaine email

Installation

1. Telecharger le module dans /modules/mprtradeaccount/
2. Install via PrestaShop Back Office → Modules
3. Configure settings in Trade Accounts → Configuration

Configuration

Paramètres generaux

• Activer/désactiver le module
• Champs du formulaire de demande (requis, optionnel, cache)
• Conditions d'approbation automatique
• Attribution de groupe client
• Paramètres d'expiration

Configuration des niveaux

• Créer des niveaux commerciaux et individuels
• Definir les regles de qualification par niveau
• Configurer les avantages par niveau
• Definir la frequence d'evaluation

Paramètres du compte de credit

• Activer les comptes de credit
• Limites et conditions par défaut
• Taux de couverture
• Paramètres d'interets
• Gestion des retards
• Calendrier des rappels

Intégration Stripe

Pour la collecte des paiements de credit :

1. Activer Stripe dans les paramètres du compte de credit
2. Configurer les cles API Stripe
3. Set up webhook endpoint: https://yourshop.com/module/mprtradeaccount/StripeWebhook
4. Activer les méthodes de paiement souhaitees

Contrôleurs Admin

Pages Frontend

Hooks

The module uses the following PrestaShop hooks:

Hooks d'affichage :

• displayCustomerAccount - Lien du compte commercial dans l'espace client
• displayNav1/2, displayTop, displayFooter - Bouton du compte commercial
• displayAdminOrder - Infos credit dans la vue admin de commande
• displayAdminCustomers - Infos commerce/credit dans la vue client

Hooks d'action :

• actionValidateOrder - Créer des commandes de credit, evaluer les niveaux
• actionOrderStatusUpdate - Gérer les annulations/remboursements
• paymentOptions - Enregistrer l'option de paiement par credit

Intégration avec MPR Express Checkout

Lorsque les deux modules sont installes :

• Le compte de credit apparait comme option de paiement dans Express Checkout
• Fonctionnalités Stripe partagees entre les modules
• Experience client unifiee

Taches Cron

Configurer le cron pour une execution quotidienne :

0 2 * * * curl -s "https://yourshop.com/module/mprtradeaccount/Cron?token=YOUR_TOKEN"

Gere :

• Mises a jour du statut de retard
• Calcul des interets
• Rappels de paiement
• Evaluations de niveau (si planifiees)

Tables de base de données

Tables principales

• mprtradeaccount_application - Trade applications
• mprtradeaccount_attempt - Application audit log
• mprtradeaccount_document - Uploaded documents
• mprtradeaccount_config - Module configuration

Tables des niveaux

• mprtradeaccount_tier - Tier definitions
• mprtradeaccount_tier_rule - Qualification rules
• mprtradeaccount_tier_benefit - Tier benefits
• mprtradeaccount_customer_tier - Customer assignments
• mprtradeaccount_tier_history - Change history
• mprtradeaccount_customer_metrics - Cached metrics

Tables de credit

• mpr_credit_account - Credit accounts
• mpr_credit_member_limit - Company member sub-limits
• mpr_credit_order - Credit orders
• mpr_credit_payment - Payments
• mpr_credit_payment_allocation - Payment to order mapping
• mpr_credit_transaction - Transaction log

Tables partagees (prefixe mpr_)

• mpr_company - B2B companies
• mpr_company_member - Company memberships
• mpr_company_address - Shared addresses
• mpr_company_contact - Company contacts
• mpr_company_invite - Email invitations

Prerequis

• PrestaShop 1.7.0+
• PHP 7.1+
• MySQL 5.5+

Optional:

• MPR Express Checkout (for enhanced payment integration)
• Stripe account (for credit payment collection)

Support

Pour le support, contactez : info@mypresta.rocks

Licence

Licence commerciale - limitee aux domaines autorises uniquement.

Développement

Structure des fichiers

mprtradeaccount/
├── controllers/
│   ├── admin/           # Back office controllers
│   └── front/           # Front office controllers
├── mails/               # Email templates
├── sql/                 # Database install/uninstall
├── src/
│   ├── Classes/         # ObjectModel and Manager classes
│   └── Traits/          # Shared traits
├── views/
│   ├── css/             # Stylesheets
│   ├── js/              # JavaScript
│   └── templates/       # Smarty templates
├── mprtradeaccount.php  # Main module file
└── config.xml           # Module configuration

Documents de planification

• PLAN_TIER_SYSTEM.md - Tier system implementation details
• PLAN_CREDIT_ACCOUNTS.md - Credit account system implementation details