DataFirefly Dunning — Dokumentation
B2B-Mahnungen installieren, konfigurieren und nutzen: 3-Stufen-Szenarien, Berechnung der Verzugszinsen und der 40-€-Entschädigung, PDF-Briefe, Cron und Forderungs-Dashboard.
Überblick
DataFirefly Dunning automatisiert das außergerichtliche Inkasso von B2B-Bestellungen, die per Überweisung bezahlt werden und unbezahlt bleiben. Sobald eine berechtigte Bestellung bestätigt ist, eröffnet das Modul eine Forderung, verfolgt deren Fälligkeit, löst gestaffelte Mahnungen nach einem von Ihnen festgelegten Zeitplan aus und berechnet die Verzugszinsen sowie die pauschale Beitreibungsentschädigung von 40 €, die das französische Handelsgesetzbuch vorsieht.
Drei Mahnstufen werden bei der Installation mitgeliefert (höfliche Erinnerung, bestimmte Mahnung mit Verzugskosten und PDF, formelle Zahlungsaufforderung) und bleiben vollständig konfigurierbar. Ein eigenes Dashboard bündelt den offenen Betrag, die Altersstruktur und den Versandverlauf.
Installation
- Legen Sie den Ordner
dfdunningin das Verzeichnis/modules/Ihres Shops, oder installieren Sie das ZIP-Archiv über Module > Modul-Manager. - Klicken Sie auf Installieren. Das Modul erstellt seine Tabellen, seine drei Standard-Mahnstufen, seine Erstkonfiguration, ein Sicherheitstoken für den Cron und den Verwaltungs-Tab unter Bestellungen > Überfällige Mahnungen (DF Dunning).
- Leeren Sie bei Bedarf den PrestaShop-Cache über Erweiterte Parameter > Leistung.
Konfiguration
Die Konfiguration ist über Module > Modul-Manager > dfdunning > Konfigurieren erreichbar. Die wichtigsten Einstellungen sind:
- Verfolgte Zahlungsmodule: die Module, deren Bestellungen eine Forderung eröffnen. Standardmäßig die Banküberweisung (
ps_wirepayment). - Verfolgte Bestellstatus: die als „Zahlung ausstehend“ geltenden Status. Standardmäßig der Status Zahlung per Überweisung ausstehend.
- Zahlungsziel: Anzahl der Tage bis zur Fälligkeit. Standardmäßig 30 Tage.
- Verzugszinssatz: der angewandte Jahressatz. Standardmäßig 12,15 % (EZB-Leitzins zuzüglich 10 Punkten).
- Pauschale Entschädigung: fester Betrag pro überfälliger Rechnung. Standardmäßig 40 €.
- Mindestintervall zwischen zwei Mahnungen: Anti-Spam-Schutz, standardmäßig 3 Tage.
- Automatischer Versand: aktiviert den Mahnversand beim Cron-Lauf.
- Blindkopie (BCC): Adresse, die eine Kopie jeder Mahnung erhält, für den buchhalterischen Nachweis.
Der Standardsatz entspricht dem EZB-Refinanzierungssatz zuzüglich 10 Punkten. Dieser Satz ändert sich: Denken Sie daran, ihn halbjährlich (Januar und Juli) in der Konfiguration zu überprüfen.
Die drei Mahnstufen
Eine Mahnstufe legt fest, wann und wie ein Kunde gemahnt wird. Jede Stufe wird in den Einstellungen konfiguriert: Position in der Sequenz, Auslösefrist (in Tagen nach der Fälligkeit), E-Mail-Vorlage, ob Verzugskosten hinzugefügt werden, PDF-Anhang und Aktivierung.
Stufe 1 — Höfliche Erinnerung (T+7)
Eine einfache Erinnerung, ohne Verzugskosten oder Anhang, 7 Tage nach der Fälligkeit versendet. Ziel: auf das Versäumnis hinweisen, ohne die Geschäftsbeziehung zu belasten.
Stufe 2 — Bestimmte Mahnung (T+15)
Eine bestimmtere Mahnung, mit der Aufschlüsselung der Verzugszinsen und der pauschalen Entschädigung, begleitet von einem PDF-Brief. 15 Tage nach der Fälligkeit versendet.
Stufe 3 — Formelle Zahlungsaufforderung (T+30)
Eine formelle Zahlungsaufforderung, die die fälligen Beträge, die Verzugskosten und den Verweis auf Artikel 1231-6 des französischen Zivilgesetzbuchs wiederholt, mit PDF-Brief und einer Zahlungsfrist von 8 Tagen. 30 Tage nach der Fälligkeit versendet.
Die Fristen und Inhalte jeder Stufe sind Richtwerte: Passen Sie sie an Ihre Inkassopolitik und Ihre AGB an.
Berechnung der Verzugskosten
Für jede überfällige Forderung berechnet das Modul:
- Die Verzugszinsen: fälliger Betrag × (Satz / 100) × (Verzugstage / 365).
- Die pauschale Beitreibungsentschädigung: ein fester Betrag pro Rechnung (standardmäßig 40 €), fällig ab dem ersten Verzugstag.
Der fällige Betrag wird aus dem bezahlten Gesamtbetrag und dem tatsächlich eingegangenen Gesamtbetrag der Bestellung ermittelt, wodurch Teilzahlungen berücksichtigt werden. Die Rechtsgrundlage bilden die Artikel L441-10 und D441-5 des französischen Handelsgesetzbuchs für die Entschädigung und die Verzugskosten sowie Artikel 1231-6 des französischen Zivilgesetzbuchs für die formelle Zahlungsaufforderung.
Die Briefvorlagen spiegeln den geltenden französischen Rechtsrahmen wider. Lassen Sie sie von Ihrem Rechtsbeistand prüfen und passen Sie sie vor der Stufe der formellen Zahlungsaufforderung an Ihr Geschäft an. DataFirefly bietet keine Rechtsberatung.
Automatisierung per Cron
Die Synchronisierung der Forderungen und der automatische Mahnversand beruhen auf einem token-gesicherten Front-Controller. Die vollständige URL, mit dem bei der Installation generierten Token, wird im Konfigurationsbildschirm angezeigt und ist kopierbereit. Sie hat die folgende Form:
https://ihrshop.tld/index.php?fc=module&module=dfdunning&controller=cron&token=IHR_TOKENPlanen Sie einen täglichen Aufruf, zum Beispiel um 7 Uhr morgens, über die geplante Aufgabe (crontab) Ihres Servers:
0 7 * * * curl -s "https://ihrshop.tld/index.php?fc=module&module=dfdunning&controller=cron&token=IHR_TOKEN"Bei jedem Lauf aktualisiert das Modul die Forderungen (Fälligkeiten, Abschlüsse, Ausschlüsse) und versendet dann, sofern der automatische Versand aktiviert ist, die fällig gewordenen Mahnungen unter Einhaltung des konfigurierten Mindestintervalls.
Das Token schützt den Zugang zum Cron: Ohne es gibt die URL einen Fehler zurück. Generieren Sie es neu, wenn Sie vermuten, dass es offengelegt wurde.
Forderungs-Dashboard
Das Dashboard, unter Bestellungen > Überfällige Mahnungen (DF Dunning), zeigt:
- Sechs Kennzahlen: gesamter offener Betrag, fälliger Betrag, überfällige Forderungen, offene Vorgänge, theoretische Verzugskosten und Mahnungen des Monats.
- Eine Altersstruktur, die den offenen Betrag nach Zeitraum aufteilt: nicht fällig, 1-30, 31-60, 61-90 und über 90 Tage.
- Eine filterbare Liste der Forderungen (offen, überfällig, bezahlt, ausgeschlossen), mit Aktionen je Zeile: eine gewählte Mahnstufe senden, als bezahlt markieren, ausschließen oder wieder einbeziehen, den PDF-Brief herunterladen.
Ein Vorgang wird automatisch geschlossen, wenn die Bestellung in einen bezahlten Status wechselt, und ausgeschlossen, wenn die Bestellung storniert, erstattet oder im Zahlungsfehler ist.
PDF-Briefe und E-Mails
Mahnungen werden per E-Mail (HTML- und Textversion) versendet und, je nach Stufe, von einem PDF-Brief begleitet. Die Briefe werden je nach Bestellsprache auf Französisch oder Englisch erstellt. Die Vorlagen verwenden beim Versand ersetzte Variablen: Vorname, Nachname, Bestellreferenz, fälliger Betrag, Fälligkeitsdatum, Verzugstage, Verzugskosten, pauschale Entschädigung, Gesamtbetrag, angewandter Satz und Shop-Name.
Die E-Mails sind über Design > Übersetzungen > E-Mail-Übersetzungen sprachweise bearbeitbar, wie jede PrestaShop-E-Mail.
FAQ
Welche Bestellungen werden angemahnt?
Nur diejenigen, die den in der Konfiguration ausgewählten Zahlungsmodulen und Status entsprechen. Standardmäßig die per Überweisung bezahlten Bestellungen, die auf Zahlung warten.
Wird eine teilweise bezahlte Bestellung berücksichtigt?
Ja. Der fällige Betrag berücksichtigt die bereits eingegangenen Summen; nur der verbleibende Teil wird angemahnt, und der Vorgang wird geschlossen, sobald der Saldo beglichen ist.
Ist das Modul mit PrestaShop 9 und Multistore kompatibel?
Ja. Die Verwaltungs-Controller beruhen auf ModuleAdminController für die Kompatibilität mit PrestaShop 8 und 9, ohne Composer, und das Modul verwaltet den Multistore-Kontext.
Kann ich eine Mahnung manuell auslösen?
Ja. Über das Dashboard können Sie für eine bestimmte Forderung sofort die Stufe Ihrer Wahl senden, unabhängig vom Cron.