Albis Leasing.

Leasing-Verträge direkt im Shopware-Checkout — mit Vertragsarten-System, Mail-Anbindung und Ratenanzeige im Produktdetail.

01
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.

Live-API

Direkter Draht zu Albis

JSON-RPC-Anbindung an die Albis-Plattform — Bonitätsprüfung und Antrag in Echtzeit, ohne Mail-Hin-und-Her.

B2B-Leasing

Für gewerbliche Kunden

Speziell für B2B-Leasing — Firmendaten, Bankverbindung, ggf. Geschäftsführer-Daten ab definiertem Auftragswert.

Pro Sales-Channel

Multi-Shop-tauglich

Aktivierung und Konfiguration pro Verkaufskanal — verschiedene Sales-Channels können verschiedene Albis-Accounts nutzen.

Vertragsarten

In v2.5 · zweite Vertragsart

Ab Version 2.5 (SW 6.7) parallel zwei Vertragsarten möglich — eigene Credentials und Produktgruppe pro Vertragsart.

Mail-Templates

Pro Sales-Channel

Antragsbestätigung an Kunde, Antragsdaten an Händler, Status-Updates — per Sales-Channel überschreibbar. Details →

Detailseiten

Leasing-Rate inline

Optional: Monatsrate direkt unter dem Produktpreis — mit Konfigurator-Modal für Laufzeit-Wahl. Details →

02
Installation

Sechs Schritte — etwa 20 Minuten.

Standard-Shopware-Plugin-Installation, mit zwei Migrations für die Albis-Produktgruppen und Konfigurations-Defaults.

Schritt 1

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.39 für SW 6.7 (aktuell)
  • v2.2.46 für SW 6.6
  • v2.1.42 für SW 6.5

Zu den Downloads ↓

Schritt 2

Plugin-Manager → Hochladen

Im Shopware-Admin: Einstellungen → System → Plugins → „Plugin hochladen". ZIP auswählen, hochladen, danach „Installieren" klicken.

Schritt 3

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.

Schritt 4

Sales-Channel zuweisen

In der Plugin-Konfiguration: Aktivierung pro Sales-Channel auswählen oder global. Ohne diese Zuweisung erscheint die Zahlart nicht.

Schritt 5

Albis-Credentials eintragen

API-Endpoint, Username und Passwort eintragen — alle diese Daten erhalten Sie vom Albis-Ansprechpartner. SSL ist Pflicht.

Schritt 6

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.

03
Konfiguration

Alle Backend-Felder — dokumentiert.

Die Plugin-Konfiguration in der Shopware-Admin pro Sales-Channel oder global — hier ist jedes Feld erklärt.

API-Endpoint

URL aus Ihrem Albis-Konto

Vollständige URL Ihres Albis-API-Endpoints — Live oder Test, je nach Bereitstellung durch Albis. Pflichtfeld.

Username · Passwort

API-Credentials von Albis

Werden im Plugin-Backend eingegeben. Passwort als type=password-Feld geschützt. Nur Albis kann diese Credentials ausstellen.

Username 2 · Passwort 2

Für zweite Vertragsart (v2.5)

Optional — nur ab v2.5.39 (SW 6.7). Eigene Credentials für eine parallel laufende zweite Vertragsart (z. B. Operate-Leasing neben Mietkauf).

Produktgruppe

sw-entity-single-select

Über das Dropdown wählen Sie eine Albis-Produktgruppe, die dem Produktgruppen-Eintrag in Ihrem Albis-Konto entspricht. Wird im Antrag übermittelt, ist für Kunden nicht sichtbar.

Produktgruppe 2

Für zweite Vertragsart

Ab v2.5: separate Produktgruppe pro Vertragsart — relevant, wenn Albis verschiedene Produktgruppen für verschiedene Vertragsmodelle vorgibt.

Provision

Wert zwischen 0 und 5 %

Optional — wird in die Leasing-Rate eingerechnet und an Albis übermittelt. Standardwert: 0.

Geschäftsführer-Schwelle

Auftragswert-Limit

Ab welchem Auftragswert (netto) zusätzliche Geschäftsführer-Daten (Geburtsdatum, Wohnadresse) abgefragt werden. Frei einstellbar.

Offcanvas-Anzeige

Toggle

Soll die Albis-Zahlart im Offcanvas-Warenkorb angezeigt werden? Standard: aus.

BCC-E-Mail

Doppelt absichern

Optional eine BCC-Adresse für alle Albis-Bestellbestätigungen — für lückenlose interne Übersicht.

04
Hauptfunktionen

Was das Plugin kann.

Vom Vertragsarten-System über Flow-Builder-Integration bis zur Detailseiten-Anzeige — die wichtigsten Features im Überblick.

Vertragsarten · v2.5

Zwei Modelle parallel anbieten

Ab v2.5.39 (SW 6.7): zweite Vertragsart aktivierbar — z. B. Mietkauf und Operate-Leasing nebeneinander. Eigene Credentials, eigene Produktgruppe.

Flow-Builder · v2.5

Business-Event nach Antrag

Neues Shopware-Business-Event albis.leasing.application.placed — nach jedem Antrag im Flow-Builder verfügbar, z. B. für automatische Tag-Vergabe auf der Bestellung.

Bonitätsprüfung

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.

Mail-Templates

4 Templates ready

Antragsbestätigung, Händler-Mail, Status-Update, Vertragsbestätigung — alle vier registriert in der Shopware-Mail-Verwaltung, pro Sales-Channel anpassbar. Details →

Detailseiten-Anzeige

Rate unter Produktpreis

Optional: Monatsrate sofort unter jedem Produktpreis sichtbar — mit Konfigurator-Modal für die Wahl von Laufzeit und Vertragsart. Details →

Smart-Cache

24h Cache pro Preis

Ratenberechnungen werden pro Produktpreis gecached (Standard 24h) — Performance auch bei Traffic-Spitzen.

Status-Tracking

Im Admin sichtbar

Pro Bestellung sehen Sie im Shopware-Admin den Albis-Vertragsstatus, die Vertragsnummer und alle Albis-Antworten — direkt im Bestelldetail.

SSL · TLS 1.2+

Verschlüsselter Transport

Die Albis-API akzeptiert ausschließlich HTTPS-Verbindungen mit TLS 1.2 oder neuer. Pflicht-Voraussetzung vor Aktivierung.

Mehrsprachig

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.

05
Downloads

Drei Plugin-ZIPs.

Pro Shopware-Major-Version ein eigenes ZIP. Klicken Sie auf den Download-Button der passenden Version.

SW 6.7 · aktuell

AlbisLease v2.5.39

Für die aktuelle Shopware-6.7-Linie. Volles Feature-Set inklusive Vertrag 2 und Shopware-Flow-Builder-Anbindung.

Größe: 118 KB

MD5: a168fd0849920bd2b547dd31d627301e

ZIP herunterladen ↓

SW 6.6 · stable

AlbisLease v2.2.46

Stabile Version für Shopware 6.6 — identischer Funktionsumfang wie v2.1.42, kompatibel mit SW 6.6.

Größe: 112 KB

MD5: 751db9ef86f6dabdf97f04b0be97ce44

ZIP herunterladen ↓

SW 6.5 · LTS

AlbisLease v2.1.42

Stabile Hauptversion für Shopware 6.5 — weiterhin gepflegt. Mit API-Test-Komponente und AlbisProductGroup-Entity.

Größe: 111 KB

MD5: 5661edcceecbd6d184e393926936070b

ZIP herunterladen ↓

MD5-Verifikation

Jeder Download mit MD5-Prüfsumme — vor der Installation verifizieren.

Auf Ihrem System: md5sum AlbisLease-v2.5.39-SW6.7.zip — das Ergebnis muss mit dem hier angezeigten Wert übereinstimmen. Wenn nicht, ist die Datei beschädigt oder manipuliert — nicht installieren.

06
Changelog

Was in den drei Versionen steckt.

Stand der Plugin-Quellen aus den hier angebotenen ZIP-Paketen.

v2.5.39
für Shopware 6.7
  • Vertrag 2 · zweite Vertragsart — eigene Albis-Credentials (Username/Passwort) und eigene Produktgruppe für eine zweite Vertragsart parallel zum Standard-Vertrag
  • Shopware-Flow-Builder-Integration: neues Business-Event albis.leasing.application.placed — nach jedem eingereichten Leasing-Antrag im Flow-Builder verfügbar
  • AlbisLeasingApplicationPlacedEvent und AlbisLeasingApplicationPlacedAction registriert
  • BusinessEventCollectorSubscriber integriert das Event in die Shopware-Event-Liste
  • CreateTagAction: nach Antrag automatisch Tag auf der Bestellung setzen (z. B. albis-pending)
  • TagAware-Framework-Event für saubere Tag-Zuordnung
  • Routes auf PHP umgestellt (routes.php statt routes.xml) — SW-6.7-konform
  • Kompatibilität mit Shopware 6.7
v2.2.46
für Shopware 6.6
  • Vollständige Shopware-6.6-Kompatibilität
  • Identischer Feature-Stand wie v2.1.42 — nur auf SW 6.6 portiert
  • Composer-Constraints auf shopware/core: ~6.6 angepasst
v2.1.42
für Shopware 6.5
  • Stabile Hauptversion für Shopware 6.5
  • API-Test-Komponente im Backend — Button „API-Verbindung testen" prüft die Albis-Credentials direkt aus der Plugin-Konfiguration
  • AlbisProductGroup-Entity inkl. EntityCollection und EntityDefinition — auswählbar per sw-entity-single-select
  • Drei Subscriber: ProductPageSubscriber, OrderPlacedSubscriber, CheckoutConfirmSubscriber
  • Zwei Migrations für DB-Setup
  • AlbisApiService für API-Kommunikation, AlbisPayment als Payment-Handler
  • Mail-Templates für Antragsbestätigung und Status-Updates — vollständig in DE und EN per Snippets übersetzt
07
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.

Welche Shopware-Version brauche ich?

Es gibt drei Plugin-Versionen, eine pro aktiver Shopware-Major-Linie:

  • v2.5.39 für Shopware 6.7
  • v2.2.46 für Shopware 6.6
  • v2.1.42 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.

Was sind die Vertragsarten in v2.5?

Ab Version 2.5.39 (SW 6.7) können Sie zwei Vertragsarten parallel anbieten — z. B. klassisches Mietkauf-Leasing UND Operate-Leasing. Jede Vertragsart bekommt eigene Albis-Credentials (Username 2 / Passwort 2) und eine eigene Produktgruppe, weil Albis intern zwei verschiedene Verträge führt. Der Kunde wählt die Vertragsart im Konfigurator-Modal aus.

Kann ich das Plugin im Flow-Builder verwenden?

Ja, ab v2.5.39 (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.39-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.39.

08
Technische Details

Auf Shopware-Standard.

Symfony-Services, DAL-konformer Datenzugriff, Vue 3 im Admin. Keine Core-Patches, keine Hacks.

Kompatibilität

Shopware 6.5Shopware 6.6Shopware 6.7PHP 8.2+WooCommerce 8.x

Albis-Anbindung

JSON-RPC APILive + TestMulti-ChannelBonität in Echtzeit

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.