Häufige Fragen¶

Ratenrechner-Widget¶

Warum wird das Widget erst angezeigt, nachdem der Kunde sich angemeldet hat oder Artikel in den Warenkorb gelegt hat?¶

Für die Anzeige des Widgets muss die Verfügbarkeitsregel der Zahlungsart bereits auf der Produktdetailseite erfüllt sein. Dabei muss die Regel so aufgebaut sein, dass sie verschiedene Fälle abdeckt, z.B. Rechnungsaddresse in Deutschland oder Rechnungsadresse nicht gesetzt (sprich: der Kunde hat noch keine Adresse angegeben). siehe auch Kopplung des Widgets mit der Verfügbarkeitsregel

Verfügbarkeitsregel und Konfiguration¶

Wie kann ich die Zahlungsart-Verfügbarkeitsregel auf die Standardeinstellung zurücksetzen?¶

Die Regel wird bei Installation des Plugins automatisch angelegt und dann nicht mehr vom Plugin verändert. Um die Verfügbarkeitsregel zurückzusetzen, muss die Zahlungsart gelöscht werden. Dies ist für Plugin-Zahlungsarten erst dann möglich, wenn auch das dazugehörige Plugin gelöscht wurde. Bei Neuinstallation des Plugins wird die Zahlart und auch die Verfügbarkeitsregel automatisch neu angelegt.

Checkout¶

Im Checkout wird die Ratenauswahl und das Zahlartenlogo nicht angezeigt¶

Die easyCredit Erweiterung ermöglicht die Ratenauswahl nach Auswahl der Zahlungsart und zeigt einen Button „Weiter zum Ratenkauf“ an. Wird dieser Button nicht angezeigt, so überschreibt möglicherweise eine andere Erweiterung das Template storefront/component/payment/payment-method.html.twig in inkompatibler Weise. Die Template-Vererbung funktioniert in diesem Fall nicht korrekt und das für die easyCredit-Erweiterung spezifische Template wird nicht geladen. Bitte prüfen Sie, ob alle Erweiterungen und Ihr Theme, die das Template payment-method.html.twig überschreiben oder erweitern, einen Aufruf auf das parent-Template durchführen.

Das folgende Beispiel zeigt die korrekte Implementierung:

{% block component_payment_method_description %}
  {% if isPaymentMethodXY %}

    <div class="payment-method-description">
      [...]
    </div>

  {% else %}
    {{ parent() }}
  {% endif %}
{% endblock %}

Bestellvorgang und Regeln¶

Im Bestellvorgang erhält der Kunde nach Berechnung der Raten „Raten müssen neu berechnet werden“.¶

Möglicherweise ist in der Installation eine Regel über den Rule Builder definiert, die die Zinsposition in den Bedingungen miteinbezieht. Die Erweiterung stellt hierfür zwei alternative Bedingungen zur Verfügung, welche die Zinsen aus der Summe bzw. Gesamtsumme herausrechnen. Somit lassen sich zinsunabhängige Regeln erstellen, welche mit easyCredit-Ratenkauf funktionieren. Die beiden Bedingungen sind wie folgt bezeichnet:

Summe, inkl. Zinsen (kompatibel mit easyCredit)

Gesamtsumme, inkl. Zinsen (kompatibel mit easyCredit)

Warenkorb, Bestellbestätigung und E-Mails¶

In Warenkorb & Bestellbestätigung wird eine Steuer-Position mit 0% MwSt. angezeigt¶

Für eine transparente Darstellung der anfallenden Zinsen beim Ratenkauf wird dem Warenkorb eine separate Position „Zinsen für Ratenzahlung“ hinzugefügt. Da auf diese Position keine Umsatzsteuer berechnet wird, zeigt Shopware eine Steuer-Position mit 0% MwSt. an. Soll diese Position nicht angezeigt werden, kann dies durch eine Template-Überschreibung erreicht werden:

{% sw_extends '@Storefront/storefront/page/checkout/summary/summary-tax.html.twig' %}

{% block page_checkout_summary_tax %}

    {% if taxItem.taxRate != 0 && taxItem.tax != 0 %}
        {{ parent() }}
    {% endif %}

{% endblock %}

In den E-Mail Templates lässt sich diese Position über eine Anpassung des Templates für die Bestellbestätigung entfernen:

{% for calculatedTax in order.price.calculatedTaxes %}
    {% if calculatedTax.taxRate != 0 && calculatedTax.tax != 0 %}
        {% if order.taxStatus is same as('net') %}plus{% else %}including{% endif %} {{ calculatedTax.taxRate }}% VAT. {{ calculatedTax.tax|currency(currencyIsoCode) }}<br>
    {% endif %}
{% endfor %}

Da es sich an dieser Stelle im Template nicht eindeutig feststellen lässt, ob das easyCredit-Plugin für die Position ursächlich ist, haben wir diese Template-Überschreibung nicht ins Plugin aufgenommen.

in älteren Shopware-Versionen (< v6.6) kommt es zu dem JavaScript-Fehler Uncaught Error: Plugin „EasyCreditRatenkaufCheckout“ is already registered¶

Das easyCredit-Plugin wird in einer einzelnen Versionslinie angeboten, mit dem Anspruch, mit allen Shopware-Versionen kompatibel zu sein (siehe Voraussetzungen). Der genannte Fehler Uncaught Error: Plugin „EasyCreditRatenkaufCheckout“ is already registered tritt auf, wenn in einer Version < 6.6 die Storefront mit dem Skript ./bin/build-storefront.sh neu gebaut wird. Der Grund hierfür ist, dass das JavaScript-Bundle seit Shopware 6.6 unter einem neuen Pfad erstellt wird:

SW 6.4 / 6.5

src/Resources/app/storefront/dist/storefront/js/easy-credit-ratenkauf.js

SW 6.6

src/Resources/app/storefront/dist/storefront/js/easy-credit-ratenkauf/easy-credit-ratenkauf.js

Das zweite Bundle wird zusätzlich zum bestehenden angelegt und dann beide Bundles in die Storefront deployt. Die Lösung ist, das SW 6.6 Bundle vorab zu löschen, so dass am Ende nur noch ein Bundle im Plugin vorhanden ist und mittels ./bin/console assets:install kopiert wird.