Konfiguration der Erweiterung

Um eine SCHUFA Bonitätsabfrage in deinem Shop durchzuführen, musst du zuerst einen SCHUFA Account beantragen und deine SCHUFA API Zugangsdaten konfigurieren. Folge unserer Schritt für Schritt Anleitung für weitere Informationen.

SCHUFA API

In dem Bereich werden die Zugangsdaten hinterlegt, welche für die Verbindung zur SCHUFA notwendig sind.

Feld	Typ	Beschreibung
Modus	Auswahlfeld	Auswahl zwischen Test- und Live Modus. Die Funktionsweise der Erweiterung sollte immer erst im Test Modus geprüft werden. Hierbei ist zu beachten, das ausschließlich mit den Testdatensätzen der SCHUFA getestet werden darf.
Öffentliche Zertifikat Schlüssel Datei	Datei Upload	Lade die Datei mit dem öffentlichen Zertifikatsschlüssel hier hoch, welche du von der SCHUFA erhalten hast. Dies ist eine Datei mit der Endung certs.pem.
Private Zertifikat Schlüssel Datei	Datei Upload	Lade die Datei mit dem privaten Zertifikatsschlüssel hier hoch, welche du von der SCHUFA erhalten hast. Dies ist eine Datei mit der Endung key.pem.
Schlüssel Passwort	Passwort Feld	Gebe das Passwort ein, mit dem du deine Zertifikat Schlüssel Datei gesichert hast.
Teilnehmerkennung	Texteingabe	Die Teilnehmerkennung erhälst du von der SCHUFA per E-Mail.
Teilnehmerpasswort	Passwort Feld	Hinterlege das Teilenhmerpasstwort, welches dir die SCHUFA per E-Mail mitgeteilt hat.

Stelle sicher, das du die API Daten korrekt hinterlegt hast indem du nach dem Speichern der Daten den Verbindung prüfen Button klickst. Nach Betätigen des Buttons erscheint eine Erfolgs- oder Fehlermeldung.

Konfiguration

Tätige allgemeine Konfigurationseinstellungen für die Nutzung der Erweiterung.

Feld	Typ	Beschreibung
Minimum Warenkorbwert in EUR	Numerische Eingabe	Mit Eingabe eines Minimum Netto-Warenkorbwertes kann festgelegt werden, das eine SCHUFA Abfrage erst ab einer bestimmten Schwelle getätigt wird.
Log Level	Auswahlfeld	Legt fest ob Debug Informationen oder lediglich nur Fehler im Logfile des Shops erfasst werden sollen. Im Live Betrieb sollten lediglich Fehler geloggt werden, da das Logfile ansonsten stark anwachsen kann.
Cache aktivieren	Schalter	Aktiviert das Caching von SCHUFA Abfragen. Sowohl als Zusatzfelder als auch in der Session des Nutzers. Wichtig: Das Caching sollte nur im Test-Modus und zu Fehlersuche Zwecken deaktiviert werden. Ansonsten erfolgen unnötig viele SCHUFA Abfragen.

B2C Rating Stufen

Der Bereich zeigt die SCHUFA Score Stufen für B2C Kunden und ist unterteilt in die Spalten:

• Rating Level

• Risikoquote in %

• Maximaler Warenkorbwert in EUR

• Speicherzeit in Tagen

Das Rating Level und die Risikoquote sind die Bewertung der SCHUFA für den angefragten Kunden. Der Maximale Warenkorbwert ist eine Beschränkung wie hoch der Warenkorbwert für den angefragten Kunden mit der entsprechenden Risikoeinstufung sein darf. Das heißt wenn der Warenkorbwert überschritten wird, dann wird eine entsprechende Zahlart automatisch gesperrt, auch wenn diese auf Basis der Bonität des Kunden erlaubt wäre. Mit der Speicherzeit in Tagen wird festgelegt wie lange die Anfrage eines Kunden im Shop gespeichert wird, bevor bei erneuter Bestellung eine neue SCHUFA Abfrage durchgeführt wird.

Bei Rating Level und Riskoquote handelt es sich um feste, unveränderliche Werte, wohingegen Maximaler Warenkorbwert und Speicherzeit angepasst werden können.

Anpassen des Warenkorbwerts und der Speicherzeit

Klicke auf die drei ... bei einem Eintrag und wähle die Option Bearbeiten. Es öffnet sich die Seite zum Editieren des Eintrages. Die Felder Rating Level und Risikoquote sind nicht veränderlich, da diese Werte fest über die SCHUFA Schnittstelle ausgegeben werden.

Feld	Typ	Beschreibung
Rating Level	Gesperrtes Feld	SCHUFA Rating Level
Risikoquote in %	Gesperrtes Feld	SCHUFA Risikoquote
Maximaler Warenkorbwert in EUR	Numerische Eingabe	Lege fest wie hoch der maximale Netto Warenkorbwert in EUR sein darf, wenn ein Kunde das Rating Level bzw. die Risikoquote hat, die für diesen Eintrag hinterlegt sind.
Speicherzeit in Tagen	Numerische Eingabe	Gibt für wie viele Tage eine erfolgte SCHUFA Anfrage gespeichert werden soll. Tätigt ein Nutzer innerhalb dieser Zeit eine erneute Bestellung, so wird keine neue Abfrage gestartet.

Zum Speichern von Änderungen klicke den Button Speichern. Um wieder auf die Listenansicht zu gelangen klicke den Button Abbrechen.

B2B Rating Stufen

Der Bereich zeigt die SCHUFA Score Stufen für B2B Kunden und ist unterteilt in die Spalten:

• Bonitätsindex

• Risikoquote in %

• Maximaler Warenkorbwert in EUR

• Speicherzeit in Tagen

Der Bonitätsindex und die Risikoquote sind die Bewertung der SCHUFA für den angefragten Kunden. Der Maximale Warenkorbwert ist eine Beschränkung wie hoch der Warenkorbwert für den angefragten Kunden mit der entsprechenden Risikoeinstufung sein darf. Das heißt wenn der Warenkorbwert überschritten wird, dann wird eine entsprechende Zahlart automatisch gesperrt, auch wenn diese auf Basis der Bonität des Kunden erlaubt wäre. Mit der Speicherzeit in Tagen wird festgelegt wie lange die Anfrage eines Kunden im Shop gecacht wird, bevor bei erneuter Bestellung eine neue SCHUFA Abfrage durchgeführt wird.

Bei Rating Level und Bonitätsindex handelt es sich um feste, unveränderliche Werte, wohingegen Maximaler Warenkorbwert und Speicherzeit angepasst werden können.

Anpassen des Warenkorbwerts und der Speicherzeit

Klicke auf die drei ... bei einem Eintrag und wähle die Option Bearbeiten. Es öffnet sich die Seite zum Editieren des Eintrages. Die Felder Rating Level und Risikoquote sind nicht veränderlich, da diese Werte fest über die SCHUFA Schnittstelle ausgegeben werden.

Feld	Typ	Beschreibung
Bonitätsindex	Gesperrtes Feld	SCHUFA Bonitätsindex
Risikoquote in %	Gesperrtes Feld	SCHUFA Risikoquote
Maximaler Warenkorbwert in EUR	Numerische Eingabe	Lege fest wie hoch der maximale Netto Warenkorbwert in EUR sein darf, wenn ein Kunde das Rating Level bzw. die Risikoquote hat, die für diesen Eintrag hinterlegt sind.
Speicherzeit in Tagen	Numerische Eingabe	Gibt für wie viele Tage eine erfolgte SCHUFA Anfrage gespeichert werden soll. Tätigt ein Nutzer innerhalb dieser Zeit eine erneute Bestellung, so wird keine neue Abfrage gestartet.

Zum Speichern von Änderungen klicke den Button Speichern. Um wieder auf die Listenansicht zu gelangen klicke den Button Abbrechen.

Konfigurieren von Zahlarten für SCHUFA Prüfung

Soll eine Zahlart für eine Bestellung nur nach positiver SCHUFA Prüfung möglich sein, so musst du dies bei der jeweiligen Zahlart konfigurieren.

Eine SCHUFA Abfrage darf nur für Zahlungsarten durchgeführt werden, bei denen ein Ausfallrisiko für den Shop Betreiber besteht. Dies sind die Zahlarten: Kauf auch Rechnung und SEPA Lastschrift.

Wähle in der Shopware Administration unter Einstellungen > Shop > Zahlungsarten die gewünschte Zahlart aus und klicke auf Details bearbeiten. Es öffnet sich die Editiermaske der Zahlart. Scrolle nach unten bis der Bereich Zusatzfelder angezeigt wird. Aktiviere die Risikoprüfung für die Zahlart indem du den Schalter bei SCHUFA Risikoprüfung aktivieren klickst.

Wenn der Shop mehrsprachig ist, dann diese Einstellung bitte für die Standard Sprache vornehmen oder für jede Sprache, falls die Vererbung nicht genutzt werden soll.