Treue + Guthaben Revolution

MPR Loyalty Revolution

Ein umfassendes B2B-Handelskonto-, Kundenbindungs- und Kreditkonto-Verwaltungsmodul fuer PrestaShop 1.7+.

Uebersicht

MPR Loyalty Revolution bietet eine vollstaendige Loesung fuer die Verwaltung von Handelskunden, Treueprogramm-Stufen und Kreditkonten:

• Handelskonto-Antraege - Kunden beantragen Handelskonten mit USt-Validierung und Dokumenten-Upload
• Stufensystem - Konfigurierbare Stufen fuer Handels- und Privatkunden mit automatischer Qualifizierung
• Kreditkonten - Kreditlinie fuer B2B-Kunden mit Zahlungsverfolgung und Stripe-Integration
• B2B-Firmenverwaltung - Mehrbenutzer-Firmenkonten mit gemeinsamen Ressourcen

Funktionen

Handelskonto-Verwaltung

• Online-Antragsformular mit anpassbaren Feldern
• USt-Nummer-Validierung (VIES-API-Integration)
• Dokumenten-Upload-Unterstuetzung (Handelslizenzen, Zertifikate)
• Automatische Genehmigung basierend auf konfigurierbaren Regeln
• Manueller Ueberpruekungs- und Genehmigungsworkflow
• Antragsstatus-Verfolgung fuer Kunden
• Ablaufverwaltung mit Benachrichtigungen

Stufensystem

Zwei separate Stufenpfade:

• Handelsstufen - Fuer B2B/Handelskunden (erfordert Handelskonto-Genehmigung)
• Einzelkunden-Stufen - Fuer regulaere Kunden (basierend auf Kaufhistorie)

Stufen-Funktionen:

• Konfigurierbare Qualifizierungsregeln (Umsatz, Bestellanzahl, Kontoalter usw.)
• Vorteile: Rabatte, kostenloser Versand, Zahlungsbedingungen, Prioritaets-Support
• Automatische Stufenbewertung bei Bestellaufgabe
• Stufensperre mit optionalem Ablauf
• Karenzzeit vor Herabstufung
• Vollstaendige Stufenaenderungshistorie

Kreditkontosystem

Kreditlinien-Modell:

• Konfigurierbare Kreditlimits (aus Stufe, Firma oder manuell)
• Deckungsquote (z.B. 50% Kredit, 50% Vorauszahlung)
• Zahlungsbedingungen (Netto 7, 14, 30, 60 Tage)
• Zinsen auf ueberfaellige Zahlungen (konfigurierbar)

Zahlungsverfolgung:

• Pro-Bestellung-Kreditverfolgung mit Faelligkeitsdaten
• Zahlungserklaerungen mit Nachweis-Upload
• Admin-Bestaetigungs-Workflow
• Stripe Checkout-Integration fuer Online-Zahlungen
• FIFO- oder selektive Zahlungszuordnung
• Ueberschussguthaben aus Erstattungen

Firmenkredit:

• Gemeinsamer Kreditpool fuer Firmenmitglieder
• Optionale Unter-Limits pro Mitglied
• Firmenadmin kann Mitglieder-Limits verwalten

B2B-Firmenverwaltung

• Firmenprofile mit Verifizierung
• Mehrere Mitarbeiter pro Firma
• Rollenbasierte Berechtigungen (Admin/Mitglied)
• Gemeinsames Adressbuch
• Einladungssystem (Link oder E-Mail)
• Automatische E-Mail-Domain-Zuordnung

Installation

1. Modul nach /modules/mprtradeaccount/ hochladen
2. Install via PrestaShop Back Office → Modules
3. Configure settings in Trade Accounts → Configuration

Konfiguration

Allgemeine Einstellungen

• Modul aktivieren/deaktivieren
• Antragsformularfelder (erforderlich, optional, ausgeblendet)
• Automatische Genehmigungsbedingungen
• Kundengruppenzuweisung
• Ablaufeinstellungen

Stufen-Konfiguration

• Handels- und Einzelkunden-Stufen erstellen
• Qualifizierungsregeln pro Stufe definieren
• Vorteile pro Stufe konfigurieren
• Bewertungshaeufigkeit festlegen

Kreditkonto-Einstellungen

• Kreditkonten aktivieren
• Standard-Limits und Bedingungen
• Deckungsquote
• Zinseinstellungen
• Ueberfaelligkeitsbehandlung
• Erinnerungszeitplan

Stripe-Integration

Fuer die Einziehung von Kreditzahlungen:

1. Stripe in den Kreditkonto-Einstellungen aktivieren
2. Stripe-API-Schluessel konfigurieren
3. Set up webhook endpoint: https://yourshop.com/module/mprtradeaccount/StripeWebhook
4. Gewuenschte Zahlungsmethoden aktivieren

Admin-Controller

Frontend-Seiten

Hooks

The module uses the following PrestaShop hooks:

Display-Hooks:

• displayCustomerAccount - Handelskonto-Link im Kundenbereich
• displayNav1/2, displayTop, displayFooter - Handelskonto-Button
• displayAdminOrder - Kreditinformationen in der Admin-Bestellansicht
• displayAdminCustomers - Handels-/Kreditinformationen in der Kundenansicht

Action-Hooks:

• actionValidateOrder - Kreditbestellungen erstellen, Stufen bewerten
• actionOrderStatusUpdate - Stornierungen/Erstattungen verarbeiten
• paymentOptions - Kredit-Zahlungsoption registrieren

Integration mit MPR Express Checkout

Wenn beide Module installiert sind:

• Kreditkonto erscheint als Zahlungsoption im Express Checkout
• Stripe-Funktionen werden zwischen Modulen geteilt
• Einheitliche Kundenerfahrung

Cron-Aufgaben

Cron fuer taegliche Ausfuehrung einrichten:

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

Verarbeitet:

• Ueberfaelligkeitsstatus-Aktualisierungen
• Zinsberechnung
• Zahlungserinnerungen
• Stufenbewertungen (wenn geplant)

Datenbanktabellen

Kerntabellen

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

Stufen-Tabellen

• 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

Kredit-Tabellen

• 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

Gemeinsame Tabellen (mpr_ Praefix)

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

Anforderungen

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

Optional:

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

Unterstuetzung

Fuer Unterstuetzung kontaktieren Sie: info@mypresta.rocks

Lizenz

Kommerzielle Lizenz - nur fuer autorisierte Domains.

Entwicklung

Dateistruktur

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

Planungsdokumente

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