# 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](https://docs.premsoft.de/plugins/schufa-bonitatsprufung/installation/schufa-zugangsdaten) für weitere Informationen.

### SCHUFA API

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

<figure><img src="https://3269960037-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEgvrQin4HSWHGzgbhlve%2Fuploads%2FAoj8G3UR2u16L9Q4sL8J%2FSCHUFA_API_DE.png?alt=media&#x26;token=9ff73273-b7b5-44ab-a512-7a3348f463e3" alt=""><figcaption></figcaption></figure>

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

{% hint style="info" %}
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.
{% endhint %}

### Konfiguration

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

<figure><img src="https://3269960037-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEgvrQin4HSWHGzgbhlve%2Fuploads%2FPvaOfkNagxS01ccSDu6s%2FConfiguration_DE.png?alt=media&#x26;token=5d60d079-6a0a-4490-be03-0383176e3ba8" alt=""><figcaption></figcaption></figure>

| 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        | <p>Legt fest ob Debug Informationen oder lediglich nur Fehler im Logfile des Shops erfasst werden sollen.<br>Im Live Betrieb sollten lediglich Fehler geloggt werden, da das Logfile ansonsten stark anwachsen kann.</p>                                          |
| Cache aktivieren             | Schalter           | <p>Aktiviert das Caching von SCHUFA Abfragen. Sowohl als Zusatzfelder als auch in der Session des Nutzers. <br>Wichtig: Das Caching sollte nur im Test-Modus und zu Fehlersuche Zwecken deaktiviert werden. Ansonsten erfolgen unnötig viele SCHUFA Abfragen.</p> |

### 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

<figure><img src="https://3269960037-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEgvrQin4HSWHGzgbhlve%2Fuploads%2F0SpOnrN8WxVWSGiNAToD%2FB2C_List_DE.png?alt=media&#x26;token=8bf46106-006d-41f5-a7ef-1e42fc4a314a" alt=""><figcaption></figcaption></figure>

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.

<figure><img src="https://3269960037-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEgvrQin4HSWHGzgbhlve%2Fuploads%2F0LiT3xa3yVmy8FqMxlKQ%2FB2C_Detail_DE.png?alt=media&#x26;token=7dcf1cc6-166a-40a8-9694-30b62b2a1ab6" alt=""><figcaption></figcaption></figure>

| 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

<figure><img src="https://3269960037-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEgvrQin4HSWHGzgbhlve%2Fuploads%2FYpdSb830Mecm50pwUldN%2FB2B_List_DE.png?alt=media&#x26;token=3d2f9f22-d4b1-4fbe-9ff8-d0aa14b45a9e" alt=""><figcaption></figcaption></figure>

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.

<figure><img src="https://3269960037-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEgvrQin4HSWHGzgbhlve%2Fuploads%2FZooXJUDZb7aMtQQU0c17%2FB2B_Detail_DE.png?alt=media&#x26;token=c4794b4e-81a6-4dff-8c6a-76cc6f507ea7" alt=""><figcaption></figcaption></figure>

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

{% hint style="warning" %}
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**.
{% endhint %}

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.

{% hint style="info" %}
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.
{% endhint %}

<figure><img src="https://3269960037-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEgvrQin4HSWHGzgbhlve%2Fuploads%2Fz6PN2YTu6UuoDlzIn4Hz%2Fimage.png?alt=media&#x26;token=a358f475-1787-432a-869d-2b8457458929" alt=""><figcaption></figcaption></figure>
