MBI Monetico

🎯 Modulübersicht

MBI Monetico verbindet Dolibarr mit Monetico, der Kartenzahlungslösung von CIC und Crédit Mutuel, und lässt Ihre Kunden Rechnungen und Aufträge online begleichen. Der Kunde erhält einen Zahlungslink und bezahlt per Karte. Sobald die Bank die Transaktion bestätigt, verbucht das Modul den Zahlungseingang ohne manuelles Zutun in Dolibarr: Freigabe der Rechnung, Anlage der Zahlung, Abgleich mit dem Bankkonto und Wechsel der Rechnung auf den Status „bezahlt“. Auch Aufträge lassen sich bezahlen: die zugehörige Rechnung entsteht beim Zahlungseingang von selbst.

Erforderlich sind ein aktiver Vertrag Monetico Paiement bei CIC oder Crédit Mutuel mit den drei Händlerkennungen (TPE-Nummer, Firmenkennung und MAC-Schlüssel) sowie Rückmelde- und Rückkehrseiten, die aus dem Internet per HTTPS erreichbar sind, da die Bank sie direkt aufruft. Die Oberfläche des Moduls ist auf Englisch und Französisch verfügbar; die deutsche, spanische und italienische Übersetzung ist teilweise vorhanden.

🌐 Demo: https://demo.mbicloud.fr 🛒 Entdecken Sie unsere weiteren Module auf Dolistore.

💡 Vorteile

• Ihre Kunden zahlen sofort online, ohne dass Sie einen Zahlungseingang nachträglich erfassen müssen.
• Zahlung, Bankbuchung und Wechsel der Rechnung auf „bezahlt“ laufen automatisch ab.
• Auch Aufträge lassen sich bezahlen: die zugehörige Rechnung entsteht beim Zahlungseingang von selbst.
• Ihr Kunde erhält unmittelbar nach der Zahlung eine Bestätigungs-E-Mail mit der Rechnung im Anhang.
• Ein Testmodus erlaubt es, die gesamte Kette zu prüfen, bevor der erste Euro fließt.

⚙️ Wichtigste Funktionen

💳 Zahlung anbieten

• Zusätzliche Zahlungsart: Monetico wird der öffentlichen Online-Zahlungsseite von Dolibarr mit einer eigenen Schaltfläche und dem Hinweis auf die akzeptierten Kartentypen hinzugefügt.
• Schaltfläche auf der Rechnung: Aus einer freigegebenen Rechnung mit offenem Betrag heraus öffnet eine Schaltfläche den Monetico-Zahlungslink in einem neuen Browser-Tab.
• Schaltfläche auf dem Auftrag: Dieselbe Schaltfläche steht in einem freigegebenen Auftrag zur Verfügung, solange ihm noch keine Rechnung zugeordnet ist.
• Vorabprüfung der Anschrift: Ist die Postanschrift des Kunden unvollständig, wird die Zahlung vorab abgewiesen und ein entsprechender Hinweis angezeigt.

🏦 Weiterleitung an die Bank

• Versiegeltes Zahlungsformular: Das Formular wird aufgebaut, mit dem Vertragsschlüssel versiegelt und dem Kunden zur Bestätigung vorgelegt.
• Testmodus: leitet sämtliche Transaktionen auf die Testplattform von Monetico anstelle der Produktivplattform um.
• 3-D Secure: Der Wunsch des Händlers zur Authentifizierung des Karteninhabers – Abschaltung, gewünschter Challenge, erforderlicher Challenge oder Ausnahmeantrag – wird bei jeder Transaktion an die Bank übermittelt.

🔄 Zahlungseingang automatisch verbuchen

• Rückmeldung der Bank: Die nach jedem Zahlungsversuch von Server zu Server gesendete Meldung wird entgegengenommen und im erwarteten Protokollformat beantwortet – auf allen Wegen, selbst wenn ein anderes Modul während der Verarbeitung einen schweren Fehler auslöst.
• Verbuchung auf der Rechnung: Es entsteht eine Kartenzahlung über den offenen Betrag, die mit dem hinterlegten Bankkonto abgeglichen wird; sinkt der Saldo auf null, wechselt die Rechnung auf „bezahlt“.
• Verbuchung auf dem Auftrag: Der Auftrag wird bei Bedarf freigegeben, die zugehörige Rechnung erstellt und vereinnahmt und der Auftrag anschließend als fakturiert eingestuft.
• Robuste Rechnungsstellung: Eine noch im Entwurf befindliche Rechnung wird vor der Verbuchung freigegeben, und eine Auftragszeile, deren Artikel aus dem Katalog gelöscht wurde, wird als freie Zeile übernommen.
• Keine Doppelbuchung: Eine von der Bank erneut gesendete Rückmeldung erzeugt keine zweite Zahlung, auch nicht zwischen zwei Raten einer Ratenzahlung.

✉️ Kunden informieren

• Bestätigungs-E-Mail: nach der Verbuchung auf Basis einer vom Administrator gewählten E-Mail-Vorlage versendet, mit dem Rechnungs-PDF im Anhang, sofern es vorliegt.
• Nachverfolgung im Terminkalender: Der Versand wird protokolliert und der Rechnung sowie dem Kunden zugeordnet.
• Rückkehrseite: Nach der Rückkehr von der Bank landet der Kunde auf einer Seite, die ihm die Annahme bestätigt oder die Ablehnung mitteilt, im Erscheinungsbild und mit den Kontaktdaten Ihres Unternehmens.

🛡️ Sicherheit und Architektur

• Mandantenfähigkeit: Die betroffene Entität begleitet die Transaktion durchgängig, von der Weiterleitung an die Bank bis zur Rückmeldung und zur Rückkehrseite; die Auswahlliste der Bankkonten zeigt nur die Konten der aktuellen Entität.
• Prüfung des Siegels: Die Echtheit der Rückmeldung wird über ein mit dem Vertragsschlüssel berechnetes Siegel geprüft; eine nicht konforme Meldung wird niemals verbucht.
• Zahlungen gehen nie verloren: Bereits erfolgte Zahlungen werden unabhängig vom Lizenzstatus stets verbucht – Rückmeldungen der Bank werden nie blockiert.
• Integration ohne Überschreibung: Das Modul fügt sich in die Standardoberfläche von Dolibarr ein, ohne den Kern zu überschreiben, und legt keine eigenen Tabellen an.
• Übersichtliche Verwaltung: Vier Reiter gliedern das Modul – Einstellungen, Über, Änderungsverlauf und Aktivierung; die im Monetico-Backoffice zu hinterlegende Rückmeldeadresse wird zum Kopieren angezeigt.

🆕 Neuerungen der letzten Versionen (1.9.3 / 1.9.2 / 1.9.1)

• Zahlung und Rückkehrseite funktionieren in einer Mandantenumgebung, wobei die Entität durchgängig erhalten bleibt; die Einstellungsseite listet nur noch die Bankkonten der aktuellen Entität auf.
• Von neueren PHP-Versionen ausgelöste Warnungen treten nicht mehr auf.
• Der Versand der Bestätigungs-E-Mail an den Kunden wird im Terminkalender protokolliert und der zugehörigen Rechnung sowie dem Kunden zugeordnet.
• Die Bestätigungs-E-Mail trägt eine Tracking-Kennung und lässt sich so unter den Austauschen wiederfinden.
• Ein noch im Entwurf befindlicher Auftrag wird bei Zahlungseingang automatisch freigegeben, bevor seine Rechnung erstellt wird.

✅ Kompatibilität

• Dolibarr: 12.0+ (getestet bis Dolibarr 23, keine Höchstversion deklariert)
• PHP: 7.2+
• Sprachen der Oberfläche: Englisch und Französisch; die deutsche, spanische und italienische Übersetzung ist teilweise vorhanden.
• Monetico Paiement (CIC / Crédit Mutuel): ein aktiver Vertrag mit den drei Händlerkennungen ist erforderlich – TPE-Nummer, Firmenkennung und MAC-Schlüssel. Das Modul arbeitet mit keinem anderen Acquirer.
• Erreichbarkeit aus dem Internet: Die Rückmelde- und Rückkehrseiten müssen per HTTPS und ohne vorherige Anmeldung erreichbar sein, da die Bank sie direkt aufruft; die Adresse der Rückmeldeseite muss im Monetico-Backoffice hinterlegt werden.
• Dolibarr-Konfiguration: die eindeutige Kennung der Instanz und ihre öffentliche Adresse müssen korrekt gesetzt sein, und die Zahlungsart mit dem Code CB muss im Wörterbuch der Zahlungsarten der Entität vorhanden sein.
• PHP-Erweiterungen: json, hash, curl und openssl.
• Aktivierung: ein ausgehender HTTPS-Zugang zu activation.mb-informatique.com wird für die Aktivierung und die laufende Lizenzprüfung benötigt.
• Bankkonto (optional): Ohne ausgewähltes Konto wird die Zahlung zwar auf der Rechnung erfasst, aber nicht mit einer Bankbuchung abgeglichen.
• E-Mail-Vorlage (optional): Bleibt die Einstellung leer, wird keine Bestätigungs-E-Mail versendet.
• Es wird kein weiteres Dolibarr-Modul benötigt, und es ist keine Inkompatibilität bekannt.

Module version: auto
Publisher/Licence: MB Informatique / GPL-v3
User interface language: English, French
Help/Support: MB Informatique
Prerequisites:

• Dolibarr min version: auto
• Dolibarr max version: auto

🔧 Installation

1. Das ZIP-Archiv des Moduls herunterladen, ohne es zu entpacken.
2. In Dolibarr Startseite > Einrichtung > Module/Anwendungen öffnen.
3. Den Reiter Externes Modul bereitstellen/installieren aufrufen.
4. Das ZIP-Archiv des Moduls hochladen.
5. MBI Monetico suchen und aktivieren.
6. Im Reiter Aktivierung die beim Kauf erhaltene Bestellreferenz eingeben: Solange das Modul nicht aktiviert ist, bleibt die Einstellungsseite gesperrt.
7. Die Einstellungsseite öffnen, die von der Bank gelieferten Händlerkennungen eintragen (TPE-Nummer, Firmenkennung und MAC-Schlüssel), das Bankkonto für den Abgleich auswählen und bei Bedarf die E-Mail-Vorlage für die Bestätigungs-E-Mail wählen.
8. Die am Ende der Einstellungsseite angezeigte Rückmeldeadresse kopieren und im Monetico-Backoffice hinterlegen.
9. Den betroffenen Benutzern die erforderlichen Rechte zuweisen.
10. Für eine manuelle Installation den Ordner mbimonetico nach /htdocs/custom/ kopieren.

ℹ️ Hinweise zur Nutzung

• Ein Vertrag Monetico Paiement bei CIC oder Crédit Mutuel ist zwingend erforderlich: Ohne die Händlerkennungen der Bank kann keine Zahlung eingezogen werden.
• Eine Firewall oder eine vorgeschaltete Zugriffsbeschränkung vor den Rückmelde- und Rückkehrseiten unterbindet die automatische Verbuchung.
• Vor der Inbetriebnahme den Testmodus aktivieren und eine Rechnung von Anfang bis Ende bezahlen, um zu prüfen, dass die Rückmeldung der Bank korrekt verarbeitet wird; den Testmodus anschließend deaktivieren.
• Die 3-D-Secure-Einstellungen entsprechend Ihrem Vertrag prüfen: Bestimmte Optionen erfordern eine gesonderte Zusatzoption im Händlervertrag.
• Die Ratenzahlung in 2, 3 oder 4 Raten samt Zusatzgebühren befindet sich noch in Entwicklung und ist auf der Einstellungsseite entsprechend gekennzeichnet; sie setzt zudem voraus, dass TPE und Vertrag bankseitig dafür freigeschaltet sind.
• Die Oberfläche des Moduls ist auf Englisch und Französisch verfügbar; die deutsche, spanische und italienische Übersetzung ist teilweise vorhanden.
• Vor jeder Aktualisierung die Datenbank und die Dateien von Dolibarr sichern und den Änderungsverlauf lesen. Das Modul legt keine eigenen Tabellen an, es sind keine SQL-Migrationen erforderlich.
• Manche Versionen verlangen, das Modul nach der Aktualisierung zu deaktivieren und wieder zu aktivieren; der Änderungsverlauf weist am Anfang der betroffenen Version ausdrücklich darauf hin.
• Die Deaktivierung gibt die Lizenz frei und entfernt die Rechte sowie die Deklarationen des Moduls; die funktionalen Einstellungen bleiben erhalten und stehen nach einer erneuten Aktivierung unverändert zur Verfügung.
• Die erzeugten Geschäftsdaten – Zahlungen, Bankbuchungen, aus Aufträgen erstellte Rechnungen und Kalendereinträge – bleiben bewusst erhalten, da sie buchhalterisch relevant sind.

🎓 Leistungen

• Eine Schulung zum Modul wird zum Preis von 80 € zzgl. MwSt. angeboten.
• Support und Aktualisierungen sind für die Laufzeit Ihrer Lizenz inbegriffen.

📄 Lizenz und Nutzungsbedingungen

Das Modul wird unter der GNU General Public License v3 oder höher (GPL v3+) vertrieben; der vollständige Text liegt der Lieferung als Datei COPYING bei.

Die vollständigen Nutzungsbedingungen werden mit dem Modul ausgeliefert und sind in Dolibarr über dessen Registerkarte „Über“ einsehbar. Unsere Allgemeinen Geschäftsbedingungen finden Sie unter https://www.mb-informatique.fr/cgv.html.

👨 💻 Herausgeber

MBI Monetico ist ein Dolibarr-Custom-Modul, entwickelt von MB Informatique.

Es wendet sich an Unternehmen mit einem Vertrag Monetico Paiement bei CIC oder Crédit Mutuel, die ihre Rechnungen und Aufträge per Karte unmittelbar aus Dolibarr heraus vereinnahmen möchten, ohne Doppelerfassung und ohne zusätzliches Werkzeug.

Herausgeber: MB Informatique
Kontakt: info@mb-informatique.fr
Website: https://www.mb-informatique.fr

🛠 CHANGELOG

UPDATE 1.9.3 (2026-06-24)

• Verbesserung: Von neueren PHP-Versionen ausgelöste Warnungen treten nicht mehr auf.
• Korrektur: Die Einstellungsseite listet nur noch die Bankkonten der aktuellen Entität auf.
• Kompatibilität: Zahlung und Rückkehrseite funktionieren in einer Mandantenumgebung, wobei die Entität durchgängig erhalten bleibt.

UPDATE 1.9.2 (2026-05-27)

• Neuerung: Der Versand der Bestätigungs-E-Mail an den Kunden wird im Terminkalender protokolliert und der zugehörigen Rechnung sowie dem Kunden zugeordnet.
• Verbesserung: Die Bestätigungs-E-Mail trägt eine Tracking-Kennung und lässt sich so unter den Austauschen wiederfinden.

UPDATE 1.9.1 (2026-05-19)

• Verbesserung: Ein noch im Entwurf befindlicher Auftrag wird bei Zahlungseingang automatisch freigegeben, bevor seine Rechnung erstellt wird.

UPDATE 1.9.0 (2026-04-20)

• Neuerung: Zwei Einstellungen erlauben es, der Bank mitzuteilen, welches Niveau der 3-D-Secure-Authentifizierung des Karteninhabers Sie erwarten.
• Neuerung: Die gewählte Option – abgeschaltet, Challenge gewünscht, Challenge erforderlich oder Ausnahmeantrag – wird bei jeder Transaktion an die Bank übermittelt.

UPDATE 1.8.0 (2026-04-08)

• ⚠️ Aktion erforderlich: Das Modul nach der Aktualisierung deaktivieren und wieder aktivieren, damit die mit dieser Version eingeführten Änderungen wirksam werden.
• Neuerung: Die Zahlung kann aus einem Auftrag gestartet werden; die Rechnung wird bei Zahlungseingang automatisch erstellt und der Auftrag als fakturiert eingestuft.
• Neuerung: Auf der Auftragskarte erscheint eine Monetico-Zahlungsschaltfläche, solange dem Auftrag keine Rechnung zugeordnet ist.
• Neuerung: Ein neuer Reiter zeigt den Änderungsverlauf des Moduls.
• Verbesserung: Die Oberfläche steht in weiteren regionalen Varianten des Englischen und des Französischen zur Verfügung; die deutsche, spanische und italienische Übersetzung ist teilweise vorhanden.
• Korrektur: Eine Auftragszeile, deren Artikel aus dem Katalog entfernt wurde, verhindert die Rechnungsstellung nicht mehr.

UPDATE 1.6.0 (2025-08-07)

• Neuerung: Die Zahlung kann aus einem Auftrag gestartet werden, wobei die zugehörige Rechnung automatisch erstellt wird.
• Neuerung: Eine Option ergänzt die Auftragskarte um eine Monetico-Zahlungsschaltfläche.

UPDATE 1.5.3 (2024-10-31)

• Neuerung: Die Zahlung in 2, 3 oder 4 Raten, auf dem Bildschirm als in Entwicklung gekennzeichnet, wird mit ihrem Zahlungsplan und den möglichen Zusatzgebühren angeboten.
• Verbesserung: Die Einstellungsseite akzeptiert Eingabefelder für Beträge.

UPDATE 1.5.2 (2024-05-29)

• Korrektur: Zahlung von Dokumenten, die in einem Mehrwährungskontext ausgestellt wurden.

UPDATE 1.5.1 (2024-05-28)

• Korrektur: das Bankkonto, auf dem die Zahlung verbucht wird.
• Korrektur: Die der Bestätigungs-E-Mail beigefügte Rechnung wurde nicht immer gefunden.

UPDATE 1.5 (2024-05-17)

• Verbesserung: Im Testmodus getätigte Zahlungen werden wie echte verbucht, wodurch sich die Anbindung von Anfang bis Ende prüfen lässt.
• Korrektur: Bei der Zahlung wurde die Rechnung über ihre Referenz identifiziert, was auf das falsche Dokument verweisen konnte.

UPDATE 1.4.0 (2024-05-16)

• Verbesserung: Die Darstellung der Oberfläche wurde überarbeitet.

UPDATE 1.3.0 (2024-05-15)

• Verbesserung: Die dem Kunden angebotenen Zahlungsarten wurden korrigiert und optimiert.

UPDATE 1.2.0 (2024-04-05)

• Sicherheit: Die Sicherheit des Moduls wurde verstärkt.

UPDATE 1.1.0 (2024-03-07)

• Neuerung: Eine Option ergänzt die Rechnungskarte um eine Monetico-Zahlungsschaltfläche.
• Kompatibilität: Ein Kompatibilitätsproblem mit Dolibarr während der Zahlung wurde behoben.

UPDATE 1.0.2 (2023-09-04)

• Korrektur: Die Zahlung konnte fehlschlagen, wenn das Dokument keine Währung trug; nun wird standardmäßig der Euro verwendet.

UPDATE 1.0

• Neuerung: erste Version des Moduls.