ALBIS Leasing Handbuch.

Voraussetzungen

Shopware 6.7 sowie ein bestehender Händlervertrag mit ALBIS. Für Shopware 6.5 und 6.6 gibt es jeweils eine eigene Plugin-Version. Ohne Vertrag und Zugangsdaten kann das Plugin keine Leasingangebote abrufen. Die Zahlart steht ab einem Warenkorb von 500 Euro netto zur Verfügung.

Installation

Plugin über den Plugin-Manager hochladen, installieren und aktivieren, anschließend die Konfiguration öffnen und die Zugangsdaten hinterlegen.

Zugangsdaten hinterlegen

Zugangsdaten lassen sich für alle Verkaufskanäle oder je Verkaufskanal hinterlegen. Dafür oben in der Konfiguration den Kanal wählen und die Werte dort eintragen. Felder, die im Kanal leer bleiben, nutzen die Angaben für alle Verkaufskanäle. Verbindungstest, Produktgruppen und die Anzeige der aktiven Schnittstelle beziehen sich immer auf den oben gewählten Kanal.

Sandbox-Modus

Zum Ausprobieren ohne echte Anträge. Ist der Modus aktiv, spricht das Plugin die Testschnittstelle von ALBIS an, und der Mindestbestellwert von 500 Euro netto entfällt, damit sich auch kleine Testbestellungen durchspielen lassen.

Zwei Verträge parallel

Neben den Hauptzugangsdaten lassen sich ein zweiter Benutzername, ein zweites Passwort und eine zweite Produktgruppe hinterlegen, ebenfalls je Verkaufskanal. Das ist gedacht für Händler mit zwei ALBIS-Verträgen, etwa für unterschiedliche Konditionen oder Gesellschaften.

Welcher Vertrag für einen Artikel gilt, legst du am Produkt fest: Hat das Zusatzfeld custom_albis_contract den Wert 2, laufen Rate und Antrag über Vertrag 2, sonst über Vertrag 1.

Provision

Die Provision wird in Prozent angegeben, zulässig sind Werte zwischen 0 und 5. Voreingestellt sind 5 Prozent. Sie fließt in die Berechnung der Leasingraten ein.

Angaben zum Geschäftsführer

Ob das Formular zusätzlich die Daten des Inhabers bzw. Geschäftsführers abfragt, hängt von der gewählten Rechtsform ab. Bei Einzelunternehmen und Personengesellschaften, etwa e.K., Freiberufler, GbR, Gewerbebetrieb oder Partnerschaftsgesellschaft, erscheint der Bereich automatisch: Anrede, Name, Geburtsdatum, Anschrift, Telefon und E-Mail.

Anzeige auf der Produktseite

Standardmäßig aktiviert. Ab einem Preis von 500 Euro netto erscheint auf der Produktdetailseite ein Hinweisblock mit der Überschrift „So einfach ist Leasing!" und einem Button, der ein Ratenbeispiel mit Laufzeit, monatlicher Rate und Versicherung öffnet. Grundlage ist der berechnete Preis, also auch Erweiterte Preise, Staffelpreise und Preisregeln. Die Einstellung lässt sich abschalten, wenn Leasing erst im Checkout auftauchen soll.

Antragsbestätigung in Kopie

Nach jedem Leasingantrag bekommt der Kunde eine Bestätigung per E-Mail. Optional lässt sich eine weitere Adresse hinterlegen, die diese Bestätigung in BCC erhält. Praktisch, wenn Leasingvorgänge intern gesondert bearbeitet werden. Die Vorlage liegt in der Shopware-Mailverwaltung und lässt sich dort anpassen.

Statuskopplung

Ist die Kopplung aktiviert, wird der Shopware-Bestellstatus automatisch anhand des ALBIS-Leasingstatus fortgeschrieben. Standardmäßig ist sie ausgeschaltet, der Bestellstatus bleibt dann in deiner Hand.

Der Leasingantrag

Der Antrag wird als Formular zur Bestellung ausgefüllt. Abgefragt werden die Unternehmensdaten des Leasingnehmers, darunter Firma, Rechtsform, Straße und Hausnummer, Telefon, E-Mail und IBAN. Je nach Rechtsform kommen die Daten des Inhabers bzw. Geschäftsführers hinzu. Telefonnummer, IBAN und Postleitzahl werden schon beim Ausfüllen geprüft.

Leasingsonderzahlung

Kunden können neben dem Leasingmodell eine Sonderzahlung angeben. Der zulässige Bereich wird angezeigt, und über „Leasingrate neu berechnen" werden die Raten aktualisiert.

Laufzeit und Leasingrate

Die verfügbaren Laufzeiten werden in Monaten mit der jeweiligen Rate angezeigt, wahlweise mit Anzahlung. Alle Beträge sind Nettobeträge zuzüglich Umsatzsteuer. Ohne Auswahl einer Rate lässt sich der Antrag nicht abschicken.

Antrag einreichen

Mit „Jetzt Leasingantrag stellen" wird der Antrag zusammen mit der Bestellung an ALBIS übermittelt. Der Kunde erhält eine Bestätigung per E-Mail mit allen Antragsdaten, die Anrede kommt aus der Rechnungsadresse. Ist eine Kopie-Adresse hinterlegt, geht die Bestätigung zusätzlich dorthin.

An der Bestellung stehen Antragsnummer, Antragsdaten und der Statusverlauf im Zusatzfeld „ALBIS Leasingantrag“.

Status per Konsole prüfen

Den Stand der Anträge fragt das Plugin über einen Konsolenbefehl bei ALBIS ab. Er muss regelmäßig per Cronjob laufen, sonst bleibt der Status stehen. Empfohlen ist ein Aufruf alle 5 Minuten:

Der Befehl prüft jeden Antrag nur dann, wenn er an der Reihe ist: in der ersten halben Stunde alle 5 Minuten, danach stündlich bis 4,5 Stunden, dann täglich bis 90 Tage. Ist ein Endstatus erreicht, endet die Abfrage für diesen Antrag. Nach 90 Tagen erfolgt ein letzter Abgleich, bei Status „abgerechnet“ wird die Bestellung abgeschlossen.

Jede Statusänderung landet mit Datum im Verlauf an der Bestellung. Ist die Statuskopplung aktiv, setzt das Plugin bei Ablehnung oder Storno Bestellung, Zahlung und Lieferung auf storniert und schließt die Bestellung nach der Abrechnung ab. Mit --dry-run siehst du, was passieren würde, ohne etwas zu ändern.

Problemlösung

Es werden keine Leasingraten angezeigt

Für die Bestellung liegt kein Angebot vor. Ursachen sind meist ein Warenkorb unter 500 Euro netto, nicht leasingfähige Positionen, eine falsche Produktgruppe oder eine vorübergehend nicht erreichbare Schnittstelle.

Die IBAN wird abgelehnt

Das Formular prüft die IBAN schon beim Ausfüllen, auch die Prüfziffer. Ist sie ungültig, erscheint der Hinweis direkt am Feld, und der Antrag lässt sich erst mit gültiger IBAN abschicken.

Fehlende Angaben zum Geschäftsführer

Bei Rechtsformen mit Angaben zum Geschäftsführer sind Geburtstag, Geburtsmonat und Geburtsjahr Pflichtangaben. Fehlt eines davon, wird das Formular nicht abgeschickt.

Der Status wird nicht aktualisiert

Meist läuft der Cronjob für bin/console albis:check-status nicht. Ruf den Befehl einmal von Hand auf und prüf die Ausgabe, danach den Cronjob einrichten wie unter Status per Konsole prüfen beschrieben.

Der Verbindungstest meldet „Zugangsdaten sind nicht korrekt“

Benutzername und Passwort genau so eintragen, wie ALBIS sie übermittelt hat, ohne Leerzeichen am Anfang oder Ende. Achte darauf, für welchen Verkaufskanal du gerade testest, und ob der Sandbox-Modus zu deinen Zugangsdaten passt.

Die Zahlungsart erscheint nicht auf der Produktseite

Prüfe die Einstellung zur Anzeige auf der Detailseite und ob die Zahlungsart im Verkaufskanal aktiv ist.

Support

Fragen zur Einrichtung im Shop beantworten wir gern. Fragen zu Konditionen, Bonität und Vertragsabwicklung klärst du direkt mit ALBIS. Schreib uns über die Kontaktseite oder an info@stoneandwater.online.

Bezug des Plugins

ALBIS Leasing ist kostenfrei zum Download, mit einer eigenen Version für Shopware 6.5, 6.6 und 6.7. Für Shopware 6.6 und 6.7 kommt die passende Version samt Updates auch über die kostenlose Plugin Suite. Die Nutzung setzt einen Händlervertrag mit ALBIS voraus, Konditionen und Zugangsdaten kommen von dort.