Installation
Installieren Sie die Erweiterung einfach und bequem über den Shopware Extension Store. Suchen Sie dazu nach „Gini für Shopware 6“.
Systemvorraussetzungen
Es gelten die gleichen Anforderungen wie an die eingesetze Shopware Version.
Gini Zahlungsmethode aktivieren
Wählen Sie in der Seitenliste unter „Verkaufskanäle“ Ihren gewünschten Verkaufskanal aus.
nter „Zahlung und Versand“ fügen Sie die beiden Zahlungsmethoden „QR-Code Bank Transfer | Gini Plugin für Shopware 6“ sowie „Bank Transfer | Gini Plugin für Shopware 6“ hinzu.
(Optional) Sie können zusätzlich „QR-Code Bank Transfer“ in der Liste als Standard-Zahlungsart auswählen.
Konfiguration
Um Gini nutzen zu können, müssen Sie Ihre Bankdaten sowie Ihre Gini-Zugangsdaten in den Plugin-Einstellungen hinterlegen.
Navigieren Sie dazu zum Extension Manager unter [Erweiterungen → Meine Erweiterungen].
Wählen Sie das „Gini Plugin für Shopware 6“ aus, klicken Sie auf das Menü „…“ und anschließend auf „Konfigurieren“.
Api Zugangsdaten
Tragen Sie hier die Zugangsdaten ein, die Sie von Gini erhalten haben.
Um Ihre Eingaben zu überprüfen, klicken Sie auf „Zugangsdaten überprüfen“. Bei korrekter Eingabe erhalten Sie eine Bestätigung.
Speichern Sie anschließend Ihre Eingaben über den Button „Speichern“ in der Info-Leiste.
Open api.png
Gini QR-Code zu bestehenden Zahlungsmethoden hinzufügen
Wenn Sie den Gini QR-Code auch bei weiteren Zahlungsmethoden anzeigen möchten, wählen Sie diese unter „Konfiguration“ aus.
Open methods.png
Bankdaten
Im Abschnitt „Zahlungsdaten“ hinterlegen Sie Ihre Empfängerdaten. Alle Felder sind Pflichtfelder.
Empfänger: Tragen Sie hier den Kontonamen ein, der dem Kunden als Empfänger der Überweisung angezeigt wird.
IBAN: Geben Sie hier die IBAN des Kontos ohne Leerzeichen ein, auf welches die Überweisung erfolgen soll.
BIC: Die BIC wird für internationale Banküberweisungen benötigt.
Purpose (Verwendungszweck): Wir empfehlen die Verwendung der Bestellnummer. Sie können jedoch auch beliebige dynamische Werte aus der Bestellung nutzen, wie das Bestelldatum oder die Website. Beachten Sie: Bestimmte Sonderzeichen wie „#“ werden von einigen Banken nicht unterstützt, und die Gesamtlänge darf 140 Zeichen nicht überschreiten. Mögliche Platzhalter sind beispielsweise: {{order.orderNumber}}.
Open payment data.png
Testen Sie abschließend Ihre eingegebenen Daten, indem Sie auf „Konfiguration prüfen“ klicken.
Wenn Ihre Daten korrekt sind, erhalten Sie eine entsprechende Meldung. Speichern Sie anschließend Ihre Eingaben über den Button „Speichern“ in der Info-Leiste.Sie können den QR-Code in allen E-Mail-Templates hinterlegen, in denen die Bestelldaten verfügbar sind. Wir empfehlen, den QR-Code im E-Mail-Template „Bestellbestätigung“ anzuzeigen.
QR-Code in Bestellbestätigung anzeigen
Sie können den QR-Code in allen E-Mail Templates hinterlegen in denen die Daten der Bestellung verfügbar sind. Wir empfehlen den QR-Code in dem E-Mail Template “Bestellbestätigung“ anzuzeigen.
Navigieren Sie zu [Einstellungen → Shop → E-Mail Templates] und wählen Sie das Template „Bestellbestätigung“ aus.
Fügen Sie im Abschnitt „Mail-Text“ im Feld unter „Text“ den folgenden Code an der gewünschten Stelle ein:
{% if giniPaymentPlain %}
{{giniPaymentPlain|raw}}
{% endif %}
Fügen Sie anschließend im Abschnitt “Mail-Text“ im Feld unter “HTML“ den nachstehenden Code an einer Stelle ihrer Wahl ein.
{% if giniPaymentHtml %}
{{giniPaymentHtml|raw}}
{% endif %
Am Ende dieser Dokumentation finden Sie eine vollständige E-Mail-Konfiguration als Beispiel.
Beispiel Mail Text:
{% set currencyIsoCode = order.currency.isoCode %}
Hallo {% if order.orderCustomer.salutation %}{{ order.orderCustomer.salutation.translated.letterName ~ ' ' }}{% endif %}{{ order.orderCustomer.firstName }} {{ order.orderCustomer.lastName }},
Ihre Bestellung ist am {{ order.orderDateTime|format_datetime('medium', 'short', locale='de-DE') }} bei uns eingegangen.
Bestellnummer: {{ order.orderNumber }}
Sobald ein Zahlungseingang erfolgt ist, erhalten Sie eine separate Benachrichtigung und Ihre Bestellung wird verarbeitet.
Den aktuellen Status Ihrer Bestellung können Sie jederzeit über diesen Link abrufen: {{ rawUrl('frontend.account.order.single.page', { 'deepLinkCode': order.deepLinkCode }, salesChannel.domains|first.url) }}
Über diesen Link können Sie auch die Bestellung bearbeiten, die Zahlungsart wechseln oder nachträglich eine Zahlung durchführen.
Informationen zu Ihrer Bestellung:
Pos. Artikel-Nr. Produktbild(Alt-Text) Beschreibung Menge Preis Summe
{% for lineItem in order.lineItems %}
{{ loop.index }} {% if lineItem.payload.productNumber is defined %}{{ lineItem.payload.productNumber|u.wordwrap(80) }}{% endif %} {% if nestedItem.cover is defined and nestedItem.cover is not null %}{{ lineItem.cover.alt }}{% endif %} {{ lineItem.label|u.wordwrap(80) }}{% if lineItem.payload.options is defined and lineItem.payload.options|length >= 1 %}, {% for option in lineItem.payload.options %}{{ option.group }}: {{ option.option }}{% if lineItem.payload.options|last != option %}{{ " | " }}{% endif %}{% endfor %}{% endif %}{% if lineItem.payload.features is defined and lineItem.payload.features|length >= 1 %}{% set referencePriceFeatures = lineItem.payload.features|filter(feature => feature.type == 'referencePrice') %}{% if referencePriceFeatures|length >= 1 %}{% set referencePriceFeature = referencePriceFeatures|first %}, {{ referencePriceFeature.value.purchaseUnit }} {{ referencePriceFeature.value.unitName }}({{ referencePriceFeature.value.price|currency(currencyIsoCode) }}* / {{ referencePriceFeature.value.referenceUnit }} {{ referencePriceFeature.value.unitName }}){% endif %}{% endif %}
{{ lineItem.quantity }} {{ lineItem.unitPrice|currency(currencyIsoCode) }} {{ lineItem.totalPrice|currency(currencyIsoCode) }}
{% endfor %}
{% set delivery = order.deliveries.first %}
{% set displayRounded = order.totalRounding.interval != 0.01 or order.totalRounding.decimals != order.itemRounding.decimals %}
{% set decimals = order.totalRounding.decimals %}
{% set total = order.price.totalPrice %}
{% if displayRounded %}
{% set total = order.price.rawTotal %}
{% set decimals = order.itemRounding.decimals %}
{% endif %}
{% for shippingCost in order.deliveries %}
Versandkosten: {{ shippingCost.shippingCosts.totalPrice|currency(currencyIsoCode) }}
{% endfor %}
Gesamtkosten Netto: {{ order.amountNet|currency(currencyIsoCode) }}
{% for calculatedTax in order.price.calculatedTaxes %}
{% if order.taxStatus is same as('net') %}zzgl.{% else %}inkl.{% endif %} {{ calculatedTax.taxRate }}% MwSt. {{ calculatedTax.tax|currency(currencyIsoCode) }}
{% endfor %}
Gesamtkosten Brutto: {{ total|currency(currencyIsoCode,decimals=decimals) }}
{% if displayRounded %}
Gesamtkosten Brutto gerundet: {{ order.price.totalPrice|currency(currencyIsoCode,decimals=order.totalRounding.decimals) }}
{% endif %}
{% if delivery %}
Gewählte Versandart: {{ delivery.shippingMethod.translated.name }}
{{ delivery.shippingMethod.translated.description }}
{% endif %}
{% set billingAddress = order.addresses.get(order.billingAddressId) %}
Rechnungsadresse:
{{ billingAddress.company }}
{{ billingAddress.firstName }} {{ billingAddress.lastName }}
{{ billingAddress.street }}
{{ billingAddress.zipcode }} {{ billingAddress.city }}
{{ billingAddress.country.translated.name }}
{% if delivery %}
Lieferadresse:
{{ delivery.shippingOrderAddress.company }}
{{ delivery.shippingOrderAddress.firstName }} {{ delivery.shippingOrderAddress.lastName }}
{{ delivery.shippingOrderAddress.street }}
{{ delivery.shippingOrderAddress.zipcode}} {{ delivery.shippingOrderAddress.city }}
{{ delivery.shippingOrderAddress.country.translated.name }}
{% endif %}
{% if order.orderCustomer.vatIds %}
Ihre Umsatzsteuer-ID: {{ order.orderCustomer.vatIds|first }}
Bei erfolgreicher Prüfung und sofern Sie aus dem EU-Ausland
bestellen, erhalten Sie Ihre Ware umsatzsteuerbefreit.
{% endif %}
Den aktuellen Status Ihrer Bestellung können Sie auch jederzeit auf unserer Webseite im Bereich "Mein Konto" - "Meine Bestellungen" abrufen: {{ rawUrl('frontend.account.order.single.page', { 'deepLinkCode': order.deepLinkCode }, salesChannel.domains|first.url) }}
Für Rückfragen stehen wir Ihnen jederzeit gerne zur Verfügung.
Beispiel Mail HTML
{% set currencyIsoCode = order.currency.isoCode %}
Hallo {% if order.orderCustomer.salutation %}{{ order.orderCustomer.salutation.translated.letterName ~ ' ' }}{% endif %}{{ order.orderCustomer.firstName }} {{ order.orderCustomer.lastName }},
Ihre Bestellung ist am {{ order.orderDateTime|format_datetime('medium', 'short', locale='de-DE') }} bei uns eingegangen.
Bestellnummer: {{ order.orderNumber }}
Sobald ein Zahlungseingang erfolgt ist, erhalten Sie eine separate Benachrichtigung und Ihre Bestellung wird verarbeitet.
Den aktuellen Status Ihrer Bestellung können Sie jederzeit über diesen Link abrufen: {{ rawUrl('frontend.account.order.single.page', { 'deepLinkCode': order.deepLinkCode }, salesChannel.domains|first.url) }}
Über diesen Link können Sie auch die Bestellung bearbeiten, die Zahlungsart wechseln oder nachträglich eine Zahlung durchführen.
Informationen zu Ihrer Bestellung:Produkt-Nr.ProduktbildBezeichnungMengePreisSumme
{% for lineItem in order.nestedLineItems %}
{% set nestingLevel = 0 %}
{% set nestedItem = lineItem %}
{% block lineItem %}
{% if nestedItem.payload.productNumber is defined %}{{ nestedItem.payload.productNumber|u.wordwrap(80) }}{% endif %}{% if nestedItem.cover is defined and nestedItem.cover is not null %}{% endif %}
{% if nestingLevel > 0 %}
{% for i in 1..nestingLevel %}
{% endfor %}
{% endif %}
0 %} {% endif %}>
{{ nestedItem.label|u.wordwrap(80) }}
{% if nestedItem.payload.options is defined and nestedItem.payload.options|length >= 1 %}
{% for option in nestedItem.payload.options %}
{{ option.group }}: {{ option.option }}
{% if nestedItem.payload.options|last != option %}
{{ " | " }}
{% endif %}
{% endfor %}
{% endif %}
{% if nestedItem.payload.features is defined and nestedItem.payload.features|length >= 1 %}
{% set referencePriceFeatures = nestedItem.payload.features|filter(feature => feature.type == 'referencePrice') %}
{% if referencePriceFeatures|length >= 1 %}
{% set referencePriceFeature = referencePriceFeatures|first %}
{{ referencePriceFeature.value.purchaseUnit }} {{ referencePriceFeature.value.unitName }}
({{ referencePriceFeature.value.price|currency(currencyIsoCode) }}* / {{ referencePriceFeature.value.referenceUnit }} {{ referencePriceFeature.value.unitName }})
{% endif %}
{% endif %}
{{ nestedItem.quantity }}{{ nestedItem.unitPrice|currency(currencyIsoCode) }}{{ nestedItem.totalPrice|currency(currencyIsoCode) }}
{% if nestedItem.children.count > 0 %}
{% set nestingLevel = nestingLevel + 1 %}
{% for lineItem in nestedItem.children %}
{% set nestedItem = lineItem %}
{{ block('lineItem') }}
{% endfor %}
{% endif %}
{% endblock %}
{% endfor %}
{% set delivery = order.deliveries.first %}
{% set displayRounded = order.totalRounding.interval != 0.01 or order.totalRounding.decimals != order.itemRounding.decimals %}
{% set decimals = order.totalRounding.decimals %}
{% set total = order.price.totalPrice %}
{% if displayRounded %}
{% set total = order.price.rawTotal %}
{% set decimals = order.itemRounding.decimals %}
{% endif %}
{% for shippingCost in order.deliveries %}
Versandkosten: {{ shippingCost.shippingCosts.totalPrice|currency(currencyIsoCode) }}
{% endfor %}
Gesamtkosten Netto: {{ order.amountNet|currency(currencyIsoCode) }}
{% for calculatedTax in order.price.calculatedTaxes %}
{% if order.taxStatus is same as('net') %}zzgl.{% else %}inkl.{% endif %} {{ calculatedTax.taxRate }}% MwSt. {{ calculatedTax.tax|currency(currencyIsoCode) }}
{% endfor %}
{% if not displayRounded %}{% endif %}Gesamtkosten Brutto: {{ total|currency(currencyIsoCode,decimals=decimals) }}{% if not displayRounded %}{% endif %}
{% if displayRounded %}
Gesamtkosten Brutto gerundet: {{ order.price.totalPrice|currency(currencyIsoCode,decimals=order.totalRounding.decimals) }}
{% endif %}
{% if delivery %}
Gewählte Versandart: {{ delivery.shippingMethod.translated.name }}
{{ delivery.shippingMethod.translated.description }}
{% endif %}
{% set billingAddress = order.addresses.get(order.billingAddressId) %}
Rechnungsadresse:
{{ billingAddress.company }}
{{ billingAddress.firstName }} {{ billingAddress.lastName }}
{{ billingAddress.street }}
{{ billingAddress.zipcode }} {{ billingAddress.city }}
{{ billingAddress.country.translated.name }}
{% if delivery %}
Lieferadresse:
{{ delivery.shippingOrderAddress.company }}
{{ delivery.shippingOrderAddress.firstName }} {{ delivery.shippingOrderAddress.lastName }}
{{ delivery.shippingOrderAddress.street }}
{{ delivery.shippingOrderAddress.zipcode}} {{ delivery.shippingOrderAddress.city }}
{{ delivery.shippingOrderAddress.country.translated.name }}
{% endif %}
{% if order.orderCustomer.vatIds %}
Ihre Umsatzsteuer-ID: {{ order.orderCustomer.vatIds|first }}
Bei erfolgreicher Prüfung und sofern Sie aus dem EU-Ausland
bestellen, erhalten Sie Ihre Ware umsatzsteuerbefreit.
{% endif %}
Den aktuellen Status Ihrer Bestellung können Sie auch jederzeit auf unserer Webseite im Bereich "Mein Konto" - "Meine Bestellungen" abrufen: {{ rawUrl('frontend.account.order.single.page', { 'deepLinkCode': order.deepLinkCode }, salesChannel.domains|first.url) }}
Für Rückfragen stehen wir Ihnen jederzeit gerne zur Verfügung.
Shopware