Ultimate
Finance.

Shopware 6 · Anzahlung & Teilzahlung · Version 1.0.1

Vollständige Anzahlungs- und Teilzahlungslösung für Shopware 6. Der Kunde zahlt im Checkout eine Anzahlung, den Rest später per Überweisung — Eingänge werden manuell im Admin verbucht.

Features

Alle Funktionen
im Überblick.

Zahlart „Anzahlung“

Eine dedizierte Zahlart ist der alleinige Auslöser — keine globalen Schalter. Nur wo die Zahlart aktiv und dem Verkaufskanal zugeordnet ist, entsteht eine Anzahlungsbestellung.

Vier Berechnungsmodi

Prozentual, fester Betrag, gestaffelt (fest) und gestaffelt (prozentual). Für jeden Verkaufskanal einzeln wählbar.

Mindestbetrag & Deckelung

Mindest-Anzahlung (Floor) und automatische Deckelung (Cap): Die Anzahlung ist nie höher als der Bestellwert.

Storefront-Anzeige

Anzeige als Box oder Badge — Farben und Texte konfigurierbar. Platzhalter {depositAmount}, {remainderAmount}, {totalAmount} werden automatisch ersetzt.

Admin-Modul „Anzahlungen“

Eingänge buchen, Restzahlung anfordern, Korrektur und Rückzahlung — alles zentral in einem eigenen Admin-Modul.

Abgleich & Warnungen

Automatische Warnungen (z. B. bei Überzahlung) auf Basis des live berechneten Restbetrags — ohne die Buchung zu blockieren.

Zahlungs-E-Mails

E-Mails für Anzahlung und Restzahlung über den Flow Builder — inklusive Bankdaten und Verwendungszweck.

Berechtigungen (ACL)

Feingranulare Rechte: Ansehen, Zahlung bestätigen, Restzahlung anfordern sowie Korrektur/Rückzahlung.

Mehrkanal & zweisprachig

Sales-Channel-fähig und vollständig zweisprachig (de-DE / en-GB).

Handbuch

Dokumentation.

↓ Handbuch herunterladen (v1.0.1) →
1. Einleitung

Ultimate Finance ist eine vollständige Anzahlungs- und Teilzahlungslösung für Shopware 6. Der Kunde zahlt im Checkout eine Anzahlung und den Rest später per Überweisung. Die Zahlungseingänge werden manuell im Admin verbucht. Ideal für auftragsbezogene Fertigung und höherwertige Artikel.

Kernfunktionen:

  • Zahlart „Anzahlung“ als alleiniger Auslöser — keine globalen Schalter
  • Vier Berechnungsmodi: prozentual, fester Betrag, gestaffelt (fest), gestaffelt (prozentual)
  • Mindest-Anzahlung (Floor) und automatische Deckelung (Cap)
  • Storefront-Anzeige als Box oder Badge, Farben und Texte konfigurierbar
  • Admin-Modul „Anzahlungen“ zum Buchen von Eingängen und Anfordern der Restzahlung
  • Abgleich mit automatischen Warnungen (z. B. Überzahlung)
  • Zahlungs-E-Mails über den Flow Builder inkl. Bankdaten und Verwendungszweck
  • Feingranulare Berechtigungen (ACL)
  • Sales-Channel-fähig und zweisprachig (de-DE / en-GB)

Systemanforderungen: Shopware ~6.7.0 (getestet mit 6.7.7), PHP 8.2 / 8.3 / 8.4

Installation:

  1. Ordner GkUltimateFinance nach custom/plugins/ kopieren
  2. bin/console plugin:refresh
  3. bin/console plugin:install GkUltimateFinance
  4. bin/console plugin:activate GkUltimateFinance
  5. bin/console database:migrate --all GkUltimateFinance
  6. bin/console cache:clear
Hinweis: Ultimate Finance ersetzt keinen Zahlungsanbieter. Das Plugin steuert die Aufteilung in Anzahlung und Restzahlung sowie deren manuelle Verbuchung im Admin.
2. Erste Schritte (Quickstart)

In sechs Schritten von der Installation zur ersten Anzahlungsbestellung:

  1. Konfiguration je Verkaufskanal öffnen: Erweiterungen → Meine Erweiterungen → Ultimate Finance → Konfiguration. Verkaufskanal oben auswählen.
  2. Modus wählen: prozentual, fester Betrag, gestaffelt (fest) oder gestaffelt (prozentual).
  3. Optional: Mindest-Anzahlung (Floor) und Rundung (Schrittweite) setzen.
  4. Bankverbindung in der gleichnamigen Konfig-Karte hinterlegen (IBAN, BIC, Kontoinhaber).
  5. Zahlart „Anzahlung“ zuordnen und die beiden Flows anlegen (Trigger gkuf.deposit.requested und gkuf.deposit.remainder_requested).
  6. Testbestellung mit der Zahlart „Anzahlung“ durchführen und den Ablauf im Admin prüfen.
Hinweis: Die Zahlart löst nur dann eine Anzahlungsbestellung aus, wenn sie aktiv und dem jeweiligen Verkaufskanal zugeordnet ist.
3. So funktioniert Ultimate Finance

Ablauf einer Bestellung:

  1. Bestellung mit der Zahlart „Anzahlung“
  2. Anzahlung angefordert (automatisch beim Bestelleingang)
  3. Anzahlung eingegangen (manuell im Admin verbucht)
  4. Restzahlung anfordern (Zeilenaktion im Admin)
  5. Restzahlung eingegangen (manuell im Admin verbucht)

Es wird eine Rechnung über den vollen Betrag erstellt — nicht zwei getrennte Rechnungen. Gebucht wird stets der Ist-Betrag statt des Soll-Betrags, sodass Abweichungen sauber abgebildet werden. Der offene Betrag wird live berechnet.

Hinweis: Ultimate Finance ersetzt keinen Zahlungsanbieter. Es organisiert die Aufteilung in Anzahlung und Restzahlung und deren Verbuchung.
4. Anzahlung berechnen: Modi & Regeln

Vier Modi stehen zur Wahl: prozentual, fester Betrag, gestaffelt (fest) und gestaffelt (prozentual).

Berechnungs-Pipeline:

  1. Rohbetrag aus dem gewählten Modus
  2. Abrunden auf die konfigurierte Schrittweite
  3. Mindest-Anzahlung (Floor) anwenden
  4. Deckelung (Cap): Anzahlung ≤ Bestellwert

Staffel-Format: je Zeile Schwelle:Wert. Beispiel Gestaffelt (fest):

  • 230:50
  • 300:100
  • 400:150

Bei einem Bestellwert von 350 € greift die Stufe 300:100 = 100 € Anzahlung.

Rechenbeispiel: 100 € Bestellwert bei 20 % = 20 € Anzahlung / 80 € Rest.
5. Die Zahlart „Anzahlung“

Die Anzahlung wird ausschließlich über die Zahlart „Anzahlung“ ausgelöst — es gibt keine globalen Schalter.

  • Zahlart aktivieren und dem Verkaufskanal zuordnen
  • Nur die zugeordnete, aktive Zahlart löst eine Anzahlungsbestellung aus
Hinweis: Ist die Zahlart nicht dem Verkaufskanal zugeordnet oder inaktiv, erscheint sie nicht im Checkout und es entsteht keine Anzahlung.
6. Storefront (Kundensicht)

Auf der Bestätigungs- und der Abschluss-Seite (Confirm und Finish) sieht der Kunde die Aufteilung in Anzahlung, Rest und Gesamt.

Darstellung: wahlweise als Box oder als Badge.

Farben: Akzent- und Box-Farben sind konfigurierbar. Leere Farbfelder bedeuten Theme-Standardoptik.

Hinweis: Die Texte enthalten die Platzhalter {depositAmount}, {remainderAmount} und {totalAmount}, die automatisch mit den berechneten Beträgen gefüllt werden.
7. Admin: Anzahlungen verwalten

Im Admin-Modul „Anzahlungen“ stehen pro Bestellung folgende Zeilenaktionen bereit:

  • Anzahlung eingegangen
  • Restzahlung anfordern
  • Restzahlung eingegangen
  • Korrektur / Rückzahlung

Gebucht wird der Ist-Betrag. Die Buchungen sind idempotent — ein versehentlicher Doppelklick verdoppelt den Betrag nicht.

Weicht der gebuchte Betrag vom erwarteten ab, erscheint ein weicher Hinweis. Es gibt keine harte Obergrenze — eine Überzahlung ist möglich und wird nicht blockiert.

8. Abgleich & Warnungen

Der Restbetrag wird live aus Bestellwert und bereits gebuchten Zahlungen berechnet.

Warnungen:

  • Überzahlung (gebuchte Summe über Bestellwert)
  • „teilbezahlt, aber Saldo ≤ 0“
  • fehlgeschlagene Anzahlungs-Mail (Marker ist zurücksetzbar)
Hinweis: Warnungen sind Hinweise, keine Sperren — sie blockieren keine Buchung.
9. E-Mail-Benachrichtigungen

Ultimate Finance stellt zwei Flow-Builder-Trigger bereit:

  • gkuf.deposit.requested — automatisch beim Bestelleingang
  • gkuf.deposit.remainder_requested — über die Zeilenaktion „Restzahlung anfordern“

Die Bankdaten stammen aus der Konfig-Karte „Bankverbindung“. Der Verwendungszweck ist die Bestellnummer. Die Restzahlungs-Mail rendert in der Sprache der Bestellung.

Hinweis: Legen Sie zu beiden Triggern je einen Flow mit einer „E-Mail senden“-Aktion an, damit die Zahlungs-E-Mails versendet werden.
10. Berechtigungen (ACL)

Die Aktionen lassen sich über feingranulare Rechte pro Rolle steuern:

  • Anzahlungen ansehen
  • Zahlung bestätigen
  • Restzahlung anfordern
  • Korrektur / Rückzahlung
Hinweis: Fehlt einem Benutzer ein Recht, ist die zugehörige Aktion ausgegraut.
11. FAQ

Zahlart erscheint nicht im Checkout: Zahlart aktiv? Dem Verkaufskanal zugeordnet? Cache leeren.

Betrag stimmt nicht: Modus, Schrittweite (Rundung), Mindest-Anzahlung (Floor) und Deckelung (Cap) prüfen — die Pipeline rechnet in dieser Reihenfolge.

Mails kommen nicht an: Sind die beiden Flows zu gkuf.deposit.requested und gkuf.deposit.remainder_requested angelegt und aktiv? Mailer und Task Runner prüfen.

Überzahlung: Es gibt keine harte Obergrenze — eine Überzahlung wird als Warnung angezeigt, aber nicht blockiert. Bei Bedarf über Korrektur/Rückzahlung ausgleichen.

Bestellwert nachträglich geändert: Der offene Betrag wird live neu berechnet. Bereits gebuchte Zahlungen bleiben erhalten; der Restbetrag passt sich an.

Aktion ausgegraut: In der Regel fehlt das zugehörige ACL-Recht. Rolle des Benutzers prüfen.

Voraussetzungen

Technische Voraussetzungen.

Shopware ~6.7.0 PHP 8.2 / 8.3 / 8.4 Sales-Channel-fähig Zweisprachig (de-DE / en-GB) Keine externen Abhängigkeiten
Kontakt

Fragen zum Plugin?

Kontaktieren Sie uns unter mail@gruenderkind.com

E-Mail schreiben → Alle Kontaktdaten →