Konfiguration der Erweiterung

Um eine SCHUFA Bonitätsabfrage in Ihrem Shop durchzuführen, müssen Sie zuerst einen SCHUFA Account beantragen und Ihre SCHUFA API Zugangsdaten konfigurieren. Folgen Sie 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	Laden Sie die Datei mit dem öffentlichen Zertifikatsschlüssel hier hoch, welche Sie von der SCHUFA erhalten haben. Dies ist eine Datei mit der Endung certs.pem.
Private Zertifikat Schlüssel Datei	Datei Upload	Laden Sie die Datei mit dem privaten Zertifikatsschlüssel hier hoch, welche Sie von der SCHUFA erhalten haben. Dies ist eine Datei mit der Endung key.pem.
Schlüssel Passwort	Passwort Feld	Geben Sie das Passwort ein, mit dem Sie Ihre Zertifikat Schlüssel Datei gesichert haben.
Teilnehmerkennung	Texteingabe	Die Teilnehmerkennung erhalten Sie von der SCHUFA per E-Mail.
Teilnehmerpasswort	Passwort Feld	Hinterlegen Sie das Teilnehmerpasswort, welches Ihnen die SCHUFA per E-Mail mitgeteilt hat.

Stellen Sie sicher, das Sie die API Daten korrekt hinterlegt haben indem Sie nach dem Speichern der Daten den Verbindung prüfen Button klicken. 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

Klicken Sie auf die drei ... bei einem Eintrag und wählen Sie 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	Legen Sie 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 klicken Sie den Button Speichern. Um wieder auf die Listenansicht zu gelangen klicken Sie 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

Feld	Typ	Beschreibung
Bonitätsindex	Gesperrtes Feld	SCHUFA Bonitätsindex
Risikoquote in %	Gesperrtes Feld	SCHUFA Risikoquote
Maximaler Warenkorbwert in EUR	Numerische Eingabe	Legen Sie 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 klicken Sie den Button Speichern. Um wieder auf die Listenansicht zu gelangen klicken Sie 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 müssen Sie 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ählen Sie in der Shopware Administration unter Einstellungen > Shop > Zahlungsarten die gewünschte Zahlart aus und klicken Sie auf Details bearbeiten.
Es öffnet sich die Editiermaske der Zahlart. Scrollen Sie nach unten bis der Bereich Zusatzfelder angezeigt wird. Aktivieren Sie die Risikoprüfung für die Zahlart indem Sie den Schalter bei SCHUFA Risikoprüfung aktivieren klicken.

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.