Direkter Draht zu ALBIS
JSON-RPC-Anbindung an die ALBIS-Plattform - Bonitätsprüfung und Antrag in Echtzeit, ohne Mail-Hin-und-Her.
ALBIS Leasing.
Leasing-Verträge direkt im Shopware-Checkout - mit Live-API, automatischem Status-Polling, Flow-Builder-Integration und Mail-Templates pro Sales-Channel.
Inhalt dieser Doku
Was leistet das Plugin?
ALBIS-Leasing als vollwertige Zahlart.
Eine komplette Leasing-Strecke direkt in Shopware: API-Anbindung, Antragsstrecke im Checkout, Mail-Anbindung, optionale Detailseiten-Anzeige - aus einer Hand und ohne externe Tools.
Was bekommt Ihr Shop?
Eine vollständige Anbindung an die ALBIS-Leasing-Plattform - direkt im Shopware-Checkout.
Das Plugin erweitert Shopware 6 um eine eigene Zahlart „ALBIS Leasing". Im Checkout füllt der Geschäftskunde alle Leasingdaten selbst aus, das Plugin schickt diese an die ALBIS-API, die Bonitätsprüfung läuft in Echtzeit, und der Kunde bekommt sofort Antwort. Sie als Händler erhalten parallel alle Daten und können den Vertrag normal abwickeln. Anschließend pollt das Plugin den ALBIS-Status vollautomatisch im Hintergrund und kann den Shopware-Bestellstatus bei Bedarf direkt anpassen.
Für gewerbliche Kunden
Speziell für B2B-Leasing - Firmendaten, Bankverbindung, ggf. Geschäftsführer-Daten ab definiertem Auftragswert.
Multi-Shop-tauglich
Aktivierung und Konfiguration pro Verkaufskanal - verschiedene Sales-Channels können verschiedene ALBIS-Accounts nutzen.
In v2.5 · zusätzliche Credentials
Ab v2.5 (SW 6.7) lassen sich zusätzliche ALBIS-Credentials und eine zweite Produktgruppe konfigurieren - für Setups, in denen ALBIS intern zwei verschiedene Händlerverträge führt.
Pro Sales-Channel
Antragsbestätigung an Kunde, Antragsdaten an Händler, Status-Updates - per Sales-Channel überschreibbar. Details →
Leasing-Rate inline
Optional: ALBIS-Zahlart auf der Produktdetailseite vorschlagen, sofern die Mindestanforderungen erfüllt sind. Details →
Installation
Sechs Schritte - etwa 20 Minuten.
Standard-Shopware-Plugin-Installation, mit zwei Migrations für die ALBIS-Produktgruppen und Konfigurations-Defaults.
ZIP herunterladen
Wählen Sie die ZIP-Variante für Ihre Shopware-Version aus dem Download-Bereich weiter unten. Drei Versionen verfügbar:
- v2.5.86 für SW 6.7 (aktuell)
- v2.2.96 für SW 6.6
- v2.1.73 für SW 6.5
Plugin-Manager → Hochladen
Im Shopware-Admin: Einstellungen → System → Plugins → „Plugin hochladen". ZIP auswählen, hochladen, danach „Installieren" klicken.
Aktivieren
Plugin in der Plugin-Übersicht aktivieren. Die nötigen Migrations (zwei Stück) laufen dabei automatisch - sie legen die albis_product_group-Tabelle und Konfigurations-Defaults an.
Sales-Channel zuweisen
In der Plugin-Konfiguration: Aktivierung pro Sales-Channel auswählen oder global. Ohne diese Zuweisung erscheint die Zahlart nicht.
ALBIS-Credentials eintragen
API-Endpoint, Username und Passwort eintragen - alle diese Daten erhalten Sie vom ALBIS-Ansprechpartner. SSL ist Pflicht.
Test & los
Im Plugin-Backend gibt es einen „API-Verbindung testen"-Button. Klick - wenn die Verbindung steht, ist alles bereit für die erste Test-Bestellung.
Konfiguration
Alle Backend-Felder - dokumentiert.
Die Plugin-Konfiguration in der Shopware-Admin pro Sales-Channel oder global - hier ist jedes Feld erklärt.
Wichtig vor dem Live-Betrieb
Zugangsdaten und Produktgruppen prüfen.
Nach dem Eintragen der Konfiguration unbedingt beide Punkte verifizieren: Erstens die ALBIS-API-Verbindung über den API-Test-Button (pro Vertrag) - schlägt der Test fehl, kann kein Antrag eingereicht werden. Zweitens die ausgewählte Produktgruppe - diese muss zu den jeweiligen Credentials gehören, sonst lehnt ALBIS den Leasingantrag direkt ab. Bei Verträgen mit zwei Credentials (v2.5) gilt das für beide Verträge separat.
URL aus Ihrem ALBIS-Konto
Vollständige URL Ihres ALBIS-API-Endpoints - Live oder Test, je nach Bereitstellung durch ALBIS. Pflichtfeld.
API-Zugangsdaten Vertrag 1
Werden im Plugin-Backend eingegeben. Passwort als type=password-Feld geschützt. Nur ALBIS kann diese Credentials ausstellen.
Optional - Zugangsdaten Vertrag 2
Zusätzliche Credentials für einen zweiten ALBIS-Händlervertrag, wenn ALBIS intern zwei verschiedene Verträge führt. Nur ab v2.5 (SW 6.7).
Verbindung sofort prüfen
Direkt unter den Credentials platziert - Klick prüft die ALBIS-API-Verbindung live aus dem Backend. Vertrag 1 und Vertrag 2 haben jeweils einen eigenen Button.
Dropdown im Backend
Über das Dropdown wählen Sie eine ALBIS-Produktgruppe, die dem Eintrag in Ihrem ALBIS-Konto entspricht. Es werden nur die Gruppen angezeigt, die für die Credentials von Vertrag 1 verfügbar sind. Wird im Antrag übermittelt, für Kunden nicht sichtbar.
Zweite Produktgruppe (v2.5)
Zusätzliche Produktgruppe - relevant, wenn ALBIS pro Vertrag eine andere Produktgruppe vorgibt. Auswahl ist auf Gruppen beschränkt, die für Vertrag-2-Credentials gültig sind.
Wert zwischen 0 und 5 %
Optional - wird in die Leasing-Rate eingerechnet und an ALBIS übermittelt. Standardwert: 5.
Auftragswert-Limit ab 500
Ab welchem Warenkorbwert (netto) zusätzliche Geschäftsführer-Kontaktdaten abgefragt werden. Standardwert: 500.
ALBIS-Zahlart vorschlagen
Boolean - wenn aktiv, wird die ALBIS-Zahlart bereits auf der Produktdetailseite vorgeschlagen, sofern die Mindestanforderungen erfüllt sind. Standard: an.
Doppelt absichern
Optionale BCC-Adresse für alle ALBIS-Bestellbestätigungen - für lückenlose interne Übersicht. Leer lassen, wenn keine zusätzliche Kopie gewünscht ist.
Bestellstatus an ALBIS koppeln
Boolean - wenn aktiv, wird der Shopware-Bestellstatus automatisch an den ALBIS-Status angepasst: bei Stornierung/Ablehnung auf „storniert", bei Abrechnung wird die Bestellung abgeschlossen und die Zahlung als „bezahlt" markiert. Standard: aus.
Hauptfunktionen
Was das Plugin tatsächlich kann.
API-Anbindung, Flow-Builder-Integration, API-Test im Backend, Mail-Templates und optionale Detailseiten-Anzeige - die Features im aktuellen Stand der drei Plugin-Versionen.
Zusätzliche Credentials
Ab v2.5.86 (SW 6.7): ein zweites Set ALBIS-Credentials (Username 2 / Passwort 2) und eine zweite Produktgruppe in der Plugin-Config. Sinnvoll, wenn ALBIS intern zwei verschiedene Händlerverträge für Ihren Shop führt.
Business-Event nach Antrag
Neues Shopware-Business-Event albis.leasing.application.placed - nach jedem eingereichten Leasing-Antrag im Flow-Builder verfügbar. Mitgelieferte CreateTagAction setzt automatisch ein Tag auf die Bestellung (z. B. albis-pending).
Automatische Status-Updates
Neuer CLI-Befehl bin/console albis:check-status pollt den ALBIS-Status offener Anträge in Phasen: alle 5 Min in der ersten halben Stunde, danach stündlich bis 4,5h, dann täglich bis 90 Tage. Über Scheduled Tasks komplett automatisch.
ALBIS-Status auf der Bestellung
Plugin legt automatisch das Custom-Field-Set „ALBIS Leasing" auf der Bestell-Entity an - ALBIS-Status, Antrags-Nr und letzte Prüfung sind direkt im Backend auf der Bestellung sichtbar. Status-Historie in eigener Tabelle albis_status_tracking.
Shopware-Bestellstatus angleichen
Optional aktivierbare Config coupleOrderStatus: Bei ALBIS-Stornierung oder Ablehnung werden Bestell-, Zahlungs- und Lieferstatus automatisch auf „storniert" gesetzt. Bei Abrechnung wird die Bestellung abgeschlossen und die Zahlung als „bezahlt" markiert.
Echtzeit-Antwort
Nach Antrag-Abschluss im Checkout läuft die ALBIS-Bonitätsprüfung in Sekunden - Antwort kommt zurück, bevor der Kunde die Page verlässt.
Direkt im Backend
Eigener „API-Verbindung testen"-Button (Endpoint /api/_action/albis-api/verify) - prüft die eingetragenen Credentials direkt gegen den ALBIS-Endpoint, mit Fehler-Anzeige bei falschen Daten.
Antrag & Status
Mail-Templates für Antragsbestätigung und Status-Updates an Kunde und Händler - registriert in der Shopware-Mail-Verwaltung, pro Sales-Channel anpassbar. Optional BCC-Adresse für interne Übersicht. Details →
Pro Sales-Channel
Optional über die Plugin-Config aktivierbar (detailPageDisplay): ALBIS-Zahlart auf der Produktdetailseite vorschlagen, sofern alle Mindestanforderungen erfüllt sind. Details →
Eigene DAL-Entity
AlbisProductGroup als eigenständige Shopware-Entity mit EntityCollection und EntityDefinition - auswählbar im Backend per sw-entity-single-select.
Verschlüsselter Transport
Die ALBIS-API akzeptiert ausschließlich HTTPS-Verbindungen mit TLS 1.2 oder neuer. Pflicht-Voraussetzung vor Aktivierung.
DE + EN out-of-the-box
Alle Storefront- und Admin-Strings in DE und EN per Shopware-Snippets übersetzt - weitere Sprachen über die Standard-Snippet-Mechanik erweiterbar.
Downloads
Drei Plugin-ZIPs.
Pro Shopware-Major-Version ein eigenes ZIP. Klicken Sie auf den Download-Button der passenden Version.
AlbisLease v2.5.86
Für die aktuelle Shopware-6.7-Linie. Volles Feature-Set inklusive Vertrag 2 und Shopware-Flow-Builder-Anbindung.
Größe: 164 KB
MD5: bdfc93b2fddc5c1acf8447df18f13079
AlbisLease v2.2.96
Stabile Version für Shopware 6.6 - identischer Funktionsumfang wie v2.1.73, kompatibel mit SW 6.6.
Größe: 148 KB
MD5: 1344a657a7f90a8737430b75c2a18301
AlbisLease v2.1.73
Stabile Hauptversion für Shopware 6.5 - weiterhin gepflegt. Mit API-Test-Komponente und AlbisProductGroup-Entity.
Größe: 140 KB
MD5: 4b95eab6b8ff5c32b55b320fe35e4592
MD5-Verifikation
Jeder Download mit MD5-Prüfsumme - vor der Installation verifizieren.
Auf Ihrem System: md5sum AlbisLease-v2.5.86-SW6.7.zip - das Ergebnis muss mit dem hier angezeigten Wert übereinstimmen. Wenn nicht, ist die Datei beschädigt oder manipuliert - nicht installieren.
Häufige Fragen · FAQ
FAQ zum ALBIS-Plugin.
Die häufigsten Fragen, die uns zu ALBIS-Leasing in Shopware gestellt werden - aus echten Kundenanfragen.
Brauche ich einen eigenen Vertrag mit ALBIS?
Ja. Das Plugin ist eine Schnittstelle zur ALBIS-Leasing-Plattform - den eigentlichen Händlervertrag müssen Sie direkt mit der ALBIS Leasing AG abschließen. Ihr ALBIS-Ansprechpartner stellt danach die API-Credentials zur Verfügung, die Sie im Plugin eintragen.
Warum kann ich die Produktgruppen nicht direkt auswählen?
Bei der initialen Installation sind die Produktgruppen-Dropdowns zunächst leer - das ist Absicht. Das Plugin kann die verfügbaren Gruppen erst dann aus der ALBIS-API laden, wenn gültige Zugangsdaten vorliegen.
Richtiger Ablauf:
- Im ersten Schritt nur die Zugangsdaten (Username, Passwort, API-Endpoint) eintragen und speichern
- Im zweiten Schritt - nach dem Reload der Config - stehen die Produktgruppen im Dropdown zur Auswahl bereit
- Passende Produktgruppe wählen und nochmals speichern
Bei einem zweiten Vertrag (v2.5) gilt das analog: erst Username 2 / Passwort 2 speichern, dann ist Produktgruppe Vertrag 2 auswählbar.
Muss ich einen zweiten Vertrag konfigurieren?
Nein. Der zweite Vertrag ist komplett optional. Die Felder Benutzername 2 · Passwort 2 und Produktgruppe Vertrag 2 bleiben einfach leer, wenn Sie nur einen ALBIS-Händlervertrag haben.
Das Plugin nutzt dann ausschließlich den ersten Vertrag - die Vertrag-2-Felder sind nur dafür gedacht, wenn ALBIS Ihnen intern zwei separate Verträge ausstellt (z.B. für unterschiedliche Geschäftsbereiche oder Produkttypen).
Welche Shopware-Version brauche ich?
Es gibt drei Plugin-Versionen, eine pro aktiver Shopware-Major-Linie:
- v2.5.86 für Shopware 6.7
- v2.2.96 für Shopware 6.6
- v2.1.73 für Shopware 6.5
Eine Cross-Installation (z. B. die SW-6.7-Version auf einem SW-6.6-Shop) funktioniert nicht - die Composer-Constraints verhindern das.
Was kostet die Nutzung des Plugins?
Das Plugin selbst ist Teil eines ALBIS-Händlervertrages und ist im Rahmen dieser Geschäftsbeziehung kostenfrei. Sie zahlen also keine Plugin-Lizenz an Stone & Water - die Konditionen ergeben sich aus Ihrem Vertrag mit ALBIS. Wenn Sie ein individuelles Setup oder Anpassungen brauchen, sprechen Sie uns an.
Wie funktioniert die Bonitätsprüfung?
Der Kunde gibt im Checkout seine Firmen- und ggf. Geschäftsführer-Daten ein. Das Plugin sendet diese per JSON-RPC an die ALBIS-API. ALBIS macht die Bonitätsprüfung in Echtzeit und antwortet binnen Sekunden - mit Annahme, Ablehnung oder „in Prüfung". Der Status landet automatisch auf der Bestellung und in der Status-Mail an Kunde und Händler.
Wie funktioniert das automatische Status-Polling?
Nach dem Einreichen eines Leasing-Antrags speichert das Plugin den Antrag in einer eigenen Tabelle albis_status_tracking. Der CLI-Befehl bin/console albis:check-status läuft in Phasen:
- Schnelle Phase: 0-30 Min nach Antrag → alle 5 Minuten prüfen
- Stündliche Phase: 30 Min - 4,5h → stündlich prüfen
- Tägliche Phase: 4,5h - 90 Tage → einmal pro Tag prüfen
- Abgelaufen: Nach 90 Tagen wird ein finaler API-Abgleich gemacht: bei Status „abgerechnet" wird die Bestellung abgeschlossen, sonst endet das Polling ohne weitere Status-Änderung - der Shopbetreiber entscheidet manuell
Über Shopware-Scheduled-Tasks läuft das Polling vollautomatisch. Sobald ein ALBIS-Endstatus erreicht ist (Annahme, Ablehnung, Stornierung, Abrechnung), wird das Polling für diesen Antrag beendet. Mit der Config-Option coupleOrderStatus wird zusätzlich der Shopware-Bestellstatus automatisch angepasst.
Kann ich das Plugin im Flow-Builder verwenden?
Ja, ab v2.5.86 (SW 6.7). Das Plugin registriert das Business-Event albis.leasing.application.placed, das nach jedem eingereichten Antrag im Flow-Builder verfügbar ist. Damit lässt sich z. B. automatisch ein Tag albis-pending auf die Bestellung setzen oder eine zusätzliche Mail auslösen.
Können auch B2C-Kunden Leasing nutzen?
Nein. ALBIS-Leasing richtet sich an gewerbliche Kunden (B2B). Privatpersonen sind ausdrücklich ausgeschlossen - das ergibt sich aus dem ALBIS-Vertragsmodell, nicht aus dem Plugin. Wenn Sie B2C-Finanzierung anbieten wollen, brauchen Sie einen anderen Anbieter.
Was passiert bei einer Ablehnung?
ALBIS schickt die Ablehnung an das Plugin zurück, der Status auf der Bestellung wird auf „rejected" gesetzt, und sowohl Kunde als auch Händler erhalten eine Status-Mail. Die Bestellung selbst bleibt erhalten - Sie können entscheiden, ob Sie dem Kunden eine alternative Zahlart anbieten oder die Bestellung stornieren.
Kann ich die Mail-Templates anpassen?
Ja, vollständig. Alle vier Mail-Templates sind in der Shopware-Mail-Verwaltung registriert und können wie jede andere Shopware-Mail editiert werden - mit Twig, Sales-Channel-Override und allen Standard-Variablen plus den ALBIS-spezifischen wie {{ albis.application.contract }}. Mehr Details →
Wie verifiziere ich den Download?
Jeder Download oben hat eine MD5-Prüfsumme. Auf Ihrem System nach dem Download: md5sum AlbisLease-v2.5.86-SW6.7.zip. Das Ergebnis muss mit dem angezeigten MD5-Wert übereinstimmen - sonst ist die Datei beschädigt oder manipuliert.
Wer richtet das Plugin ein?
Sie selbst oder wir. Die Installation ist Standard-Shopware-Plugin-Verfahren und dauert für jemanden, der mit Shopware vertraut ist, 20-30 Minuten. Wenn Sie das lieber an uns auslagern wollen: albis@stoneandwater.online - wir richten das komplette Setup ein, inklusive Test-Bestellung mit Echt-ALBIS-Antwort.
Was ist mit Shopware 5?
Eine ältere Shopware-5-Version (AlbisPayment 5) existiert noch, ist aber nicht mehr aktiv weiterentwickelt - Shopware selbst hat den offiziellen Support für SW 5 eingestellt. Wenn Sie auf SW 5 sind, empfehlen wir Migration auf SW 6.7 und die aktuelle Plugin-Version v2.5.86.
Troubleshooting · Known Issues
Typische Setup-Stolpersteine.
Die Punkte, die bei der Einrichtung am häufigsten übersehen werden - mit klarer Lösung.
ALBIS-Zahlart pro Sales-Channel zuordnen
Häufigster Fehler nach der Installation: Plugin ist aktiv, Credentials sind eingetragen - aber im Checkout taucht ALBIS nicht auf. Grund: Die Zahlart muss explizit pro Sales-Channel zugewiesen werden.
So gehts:
- Im Admin:
Einstellungen → Sales Channel → [Ihr Verkaufskanal] - Tab „Zahlungs- & Versandarten" öffnen
- Unter „Zahlungsarten" die Zahlart „ALBIS Leasing" hinzufügen
- Speichern, Cache leeren
Optional kann sie auch als Standard-Zahlart festgelegt werden, ist aber nicht zwingend.
Cronjob für Scheduled Tasks einrichten
Das Polling-System nutzt Shopware-Scheduled-Tasks. Damit diese laufen, muss auf dem Server ein Cronjob den Scheduled-Task-Worker ausführen. Ohne Cronjob bleibt das Polling stehen, auch wenn alles korrekt konfiguriert ist.
Cronjob (alle 5 Minuten empfohlen):
*/5 * * * * cd /var/www/shop && bin/console scheduled-task:run --time-limit=290
Alternative - manuell auslösen: Auf der Bestellübersicht im Backend gibt es einen Button, mit dem das Status-Polling für eine einzelne Bestellung manuell angestoßen werden kann - nützlich für Tests oder wenn der Cronjob mal nicht durchläuft.
Prüfen ob der Cronjob läuft: bin/console scheduled-task:list - die Spalte „nextExecutionTime" zeigt die nächste geplante Ausführung. Wenn diese in der Vergangenheit liegt und sich nicht aktualisiert, läuft der Cronjob nicht.
Mehrere mögliche Ursachen
Wenn der „API-Verbindung testen"-Button im Backend Fehler meldet, prüfen Sie der Reihe nach:
- SSL-Pflicht: ALBIS akzeptiert nur HTTPS-Endpoints - keine HTTP-URLs eintragen
- Credentials: Username und Passwort exakt wie vom ALBIS-Ansprechpartner übermittelt - keine zusätzlichen Leerzeichen am Anfang oder Ende
- Endpoint-URL: Live- und Test-Endpoint sind unterschiedlich - kontrollieren Sie, welchen ALBIS Ihnen freigeschaltet hat
- Firewall/Proxy: Der Server muss ausgehende HTTPS-Verbindungen zur ALBIS-API erlauben - bei restriktiven Hostern ggf. die ALBIS-Domain explizit freischalten lassen
Mail-Templates pro Sales-Channel aktiv?
Wenn Status-Mails nicht ankommen, liegt es meistens nicht am Plugin selbst, sondern an Shopware-Mail-Settings:
- Mail-Sender: Sind die Standard-Sender-Adressen im Sales-Channel gesetzt?
- Mail-Templates pro Sales-Channel: Die Templates sind global registriert, aber pro Sales-Channel zugeordnet - beim Multi-Channel-Setup prüfen
- Message-Queue: Mails werden über die Shopware-Message-Queue versendet - der
messenger:consume-Worker muss laufen (siehe oben Cronjob) - SMTP-Konfiguration: Falls Sie einen externen SMTP-Server nutzen, in der Shopware-Mail-Konfiguration prüfen, ob die Zugangsdaten stimmen
Technische Details
Auf Shopware-Standard.
Symfony-Services, DAL-konformer Datenzugriff, Vue 3 im Admin. Keine Core-Patches, keine Hacks.
Kompatibilität
ALBIS-Anbindung
Voraussetzung: ALBIS-Händlervertrag. API-Credentials werden vom ALBIS-Ansprechpartner bereitgestellt.
DSGVO
Alle Vertrags- und Kundendaten werden in der Shopware-Datenbank gespeichert. Bonitätsprüfungen erfolgen bei ALBIS - ALBIS ist eigener Verantwortlicher gemäß DSGVO. Auftragsverarbeitungsvertrag mit ALBIS erforderlich.
Support
Bei Fragen zur Installation, Konfiguration oder bei Bugs: albis@stoneandwater.online
Bereit für die Einrichtung?
Wir richten das ein.
Vom Plugin-Upload über ALBIS-API-Konfiguration bis Test-Bestellung - wir übernehmen das gesamte Setup, wenn Sie wollen.