VAI Pay (JTL-Shop 5)
- 1 Einleitung
- 2 Installation / Update
- 3 Konfiguration
- 3.1 Shop
- 3.1.1 Zahlungsarten
- 3.1.2 Versandarten
- 3.2 JTL-Wawi
- 3.2.1 Zahlungsart einrichten WAWI 1.6
- 3.2.1.1 Eigenes Feld anlegen
- 3.2.2 Zahlungsart einrichten WAWI 1.5
- 3.2.2.1 Bestellattribut anlegen
- 3.2.3 JTL-Workflow einrichten
- 3.2.3.1 Rechnungsadressdaten
- 3.2.3.2 Umsatzsteuer ID
- 3.2.4 WAWI-Workflow testen
- 3.2.5 E-Mail-Vorlage anpassen
- 3.2.5.1 Betreff anpassen
- 3.2.5.2 Rechnungs-PDF Name anpassen
- 3.2.1 Zahlungsart einrichten WAWI 1.6
- 3.1 Shop
- 4 Betrieb
- 5 Individualisierung
- 6 Troubleshooting
- 6.1 Meldungen
- 6.2 Logs prüfen
- 6.2.1 Browser-Log
- 6.2.2 Shop-Log
- 6.2.3 Webserver-Log
- 7 Changelog
- 8 Support und Kontakt
Einleitung
Dieses Plugin integriert VAI Pay als Zahlungsart in Ihren JTL-Shop.
Die VAI Trade GmbH bietet im B2B-Bereich eine Rechnungskauflösung an, mit der Händler Ware von ihren
Lieferanten per Rechnung kaufen und in Raten bezahlen können. Dabei tritt die VAI Trade gegenüber dem
Lieferanten als Kunde auf, der auf Rechnung kauft und verkauft die Waren entsprechend an den Händler weiter. Der Lieferant bekommt die Zahlung für seine Waren innerhalb von 24 Stunden ausgezahlt und trägt so kein Risiko.
Anmerkung: Um die Begrifflichkeiten eindeutig zu verwenden, wird der Lieferant im Folgenden als „Verkäufer“ (da er den Online-Shop betreibt) und der kaufende Händler als „Käufer“ oder „Kunde“ (im Online-Shop) bezeichnet.
Weitere Informationen zu dem Thema finden sie hier:
https://support.vaitrade.de/de-form/articles/2104656-wie-funktioniert-einkaufsfinanzierung
Features
Frontend
Zahlungsart VAI Pay
Backend
Übersicht der Zahlungen mit VAI-Pay
Konfigurationshilfe zum Plugin
Wawi
Wawi-Workflows
Installation / Update
Systemvoraussetzungen
JTL-Shop 5.00+ und dessen Voraussetzungen
Weitere Voraussetzungen
Sie benötigen ein Kundenkonto, registrieren Sie sich unter: https://vaitrade.de/de/b2b.
Informieren Sie sich hier https://support.vaitrade.de/de-form/articles/2032365-welche-voraussetzungen-gibt-es über die weiteren Voraussetzungen von VAI Pay.
Plugin-Installation
Die Installation des Plugins erfolgt nach JTL-Standard, wie es hier beschrieben ist.
Plugin-Update
Bei einem Update auf eine neuere Version können Sie unter dem Menüpunkt “PLUGINS → Meine Käufe > Gebundene Lizenzen → VAI Pay” die Aktualisierung des Plugins auf die nächst verfügbare Version starten. In der Spalte Status klicken Sie auf “Aktualisieren“.
Konfiguration
Shop
Das Plugin unterstützt Sie bei der Einrichtung der Zahlungsart, wählen Sie dafür den Reiter “Hilfe“ im Plugin aus. Sie erhalten dort eine Übersicht über die Konfiguration. Überprüfen Sie an der Stelle die von Ihnen hinterlegten Einstellungen zu den Zahlungs- und Versandarten.
Zahlungsarten
Die Konfiguration der Zahlungsart erfolgt über die Standard-Verwaltung im JTL-Shop. Sie finden die Zahlungsarten unter Administration → Zahlungsarten. Einen direkten Link dahin finden Sie auch auf der Hilfe-Seite des Plugins. Wählen Sie VAI Pay über das Stift-Symbol aus und konfigurieren Sie die Zahlungsmethode bei Bedarf.
Neben den Standard-Einstellungen für Zahlungsarten befinden sich im Plugin unter dem Tab Einstellungen die Einstellungen zur Zahlungsart. Hier können Sie die für den Betrieb im Plugin notwendigen Daten hinterlegen, welche Sie von VAI Pay für die Einrichtung erhalten haben.
Ist die Zahlungsart VAI Pay ausgewählt, dann wird der “Zahlungspflichtig bestellen”-Button mit einem im VAI-Design gehaltenen Zahlungsbutton ersetzt. Sie können aus drei verschiedenen Buttontexten wählen.
An welcher Stelle und mit welcher Methode der Button eingebunden wird bestimmen Sie über den Selektor und Selektor-Methode.
Option | Werte | Beschreibung |
---|---|---|
Aktiv: | Ja / Nein | Hier können Sie das Plugin global aktivieren oder deaktivieren. |
API-Key (Live): |
| Geben Sie hier den Live API-Key ein, den Sie von VAI Pay nach Ihrer Registrierung erhalten haben. Dieser dient als Zugangsschlüssel für die Kommunikation mit VAI Pay. |
Secret-Key (Live): |
| Geben Sie hier den Live Geheimschlüssel für die Kommunikation mit VAI Pay ein. Diesen haben sie ebenfalls nach Ihrer Registrierung bei VAI Pay erhalten. Dieser dient dazu die Kommunikation mit VAI Pay abzusichern. |
API-Key (Sandbox): |
| Wenn sich Live und Sandbox API-Key nicht unterscheiden, geben Sie hier ebenfalls den Live API-Key für die Sandbox Kommunikation ein. |
Secret-Key (Sandbox): |
| Wenn sich Live und Sandbox Secret-Key nicht unterscheiden, geben Sie hier ebenfalls den Live API-Key für die Sandbox Kommunikation ein. |
Modus: | Sandbox / Live | Wählen Sie hier den Betriebsmodus aus Sandbox - das Plugin kommuniziert mit der Testumgebung |
Farbschema: | Hell / Dunkel | Wählen Sie hier das Farbschema für den Bezahl-Button aus. |
Button-Text: | “Bezahlen mit VAI” | Wählen Sie Ihren favorisierten Button-Text. Der Text wird im VAI Pay Button angezeigt. |
Button Selektor (Anzeigen): | CSS - Selektor Standard: #complete-order-button | Geben Sie die CSS-Selektoren (komma-getrennt) an, an denen der Button gebunden werden soll. Ist nichts angegeben, dann wird der Standard-Selektor verwendet. |
Button Selektor-Methode: | after - nach before - davor append - anhängen prepend - voranstellen replaceWith - ersetzen | after - der Button wird nach dem angebenden Element angefügt before - der Button wird vor dem angebenden Element angefügt append - der Button wird an das angebende Element angehängt prepend der Button wird an das angebende Element vorangestellt replaceWith - das angegebene Element wird mit dem Button ersetzt |
Element Selektor (Entfernen): |
| Geben Sie hier die CSS Selektoren der Elemente an, welche ausgeblendet werden sollen. Im Standard wird stets das Element “#complete-order-button“ ausgeblendet. Wenn ihre ID des Buttons anders bezeichnet ist, dann können Sie hier ihren eigenen Selektor angeben. |
Versandarten
Weisen Sie nun VAI Pay den gewünschten Versandarten/Ländern unter Administration → Versand zu. Das Plugin berücksichtigt auch etwaige Aufschläge zur Zahlungsmethode. Einen direkten Link dahin finden Sie auch auf der Hilfe-Seite des Plugins.
JTL-Wawi
Damit die über VAI Pay getätigten Zahlungen in der JTL-Wawi den Bestellungen zugeordnet werden können, sind hierfür erweiterte Einstellungen vorzunehmen. Für eine korrekte Funktion mit VAI Pay sind die beschriebenen JTL-Workflows von besonderer Bedeutung, weitere Informationen hierzu finden sie hier: https://support.vaitrade.de/de-form/articles/3482535-welche-informationen-mussen-auf-meiner-rechnung-vorhanden-sein.
Zahlungsart einrichten WAWI 1.6
Öffnen Sie in der JTL-WAWI die Zahlungsartenverwaltung über Zahlungen → Zahlungsarten.
Legen Sie als Zahlungsart “VAI Pay” an. Beachten Sie, dass die Zahlungsarten dem “Angezeigten Namen“ im JTL-Shop entsprechen müssen.
Eigenes Feld anlegen
Öffnen Sie in der JTL-WAWI die Verwaltung Eigener Felder über Admin→ “Eigene Felder”.
Falls ein Update von v1.5 auf v1.6 durchgeführt wurde, dann finden Sie hier die VaiDealNumber unter “Automatisch generiert”. Sie können eine neue Gruppe “VAI Pay” erstellen und die VaiDealNumber in die Gruppe reinziehen, um Ihre Felder zu strukturieren:
Legen sie ansonsten ein neues Feld an mit der Bezeichnung “VaiDealNumber” und dem Datentyp “Kurztext”:
Die VaiDealNumber wird dann im Angebot/Auftrag rechts in der Übersicht unter “Eigene Felder” angezeigt:
Zahlungsart einrichten WAWI 1.5
Öffnen Sie in der JTL-WAWI die Zahlungsartenverwaltung über Zahlungen → Zahlungsarten.
Legen Sie als Zahlungsart “VAI Pay” an. Beachten Sie, dass die Zahlungsarten dem “Angezeigten Namen“ im JTL-Shop entsprechen müssen.
Bestellattribut anlegen
Wechseln Sie zu Verkauf (F6) und öffnen Sie einen Auftrag. Öffnen Sie die Auftragsattribute mit
und legen Sie das Attribut “VaiDealNumber“ an. Nun wird die übermittelte dealNumber angezeigt:
JTL-Workflow einrichten
Die VAI Trade GmbH tritt gegenüber dem Verkäufer als Käufer auf, somit darf die Rechnung anders als bei anderen Bestellungen nicht an den Käufer adressiert sein, sondern muss stattdessen an die VAI Trade GmbH gestellt werden.
Richten Sie einen WAWI-Workflow ein, um bei Anlage eines Auftrags mit VAI Pay als Zahlungsart automatisch die Rechnungsadresse des Auftrags auf die zu definierende Rechnungsadresse von VAI Trade zu ändern. Dabei gehen Sie wie folgt vor:
Richten Sie “VAI Pay” als Zahlungsart ein.
Öffnen Sie unter Admin >JTL-Workflows:
Wählen Sie Aufträge:
und markieren Sie “Komplett bezahlt”
Legen Sie einen Workflow an mit:
Bedingungen festlegen:
Definieren Sie für die zuvor angelegte Zahlungsart “VAI Pay“, dass Zahlungen bearbeitet werden sollen.
Aktionen festlegen:
In Tabelle Rechnungsadressdaten sind alle zu ändernden Variablen aufgeführt.
Wählen Sie die Aktion “Werte setzen“
Bestimmen Sie mit Variable welches Datum geändert werden soll für
Auftrag > Zahlungen > Rechnungsadresse > VariableTragen Sie unter Wert den neuen Inhalt ein.
Option “Feld leeren” steht leider nicht zu Verfügung, um eine Variable zu leeren fügen Sie bitte als Workaround ein “-“ (Minus) ein.
Workflow testen
Speichern Sie den Workflow
Rechnungsadressdaten
Die Einrichtungshilfe soll Sie dabei unterstützen, alle erforderlichen Variablen einzutragen.
Variable | Inhalt | Kommentar | Einrichtungshilfe |
---|---|---|---|
Adresszusatz | - |
| erledigt |
Anrede | - |
| erledigt |
Bundesland | - |
| erledigt |
| erledigt | ||
Fax | - |
| erledigt |
Firma | VAI Trade GmbH |
| erledigt |
Firmenzusatz | - |
| |
LandISO | DE |
| |
Landname | Deutschland |
| |
Mobil | - |
| |
Name | - |
| |
Ort | Berlin |
| |
PLZ | 10245 |
| |
Straße | Warschauer Platz 11-13 |
| |
Telefon | +49 30 9599984 20 |
| |
Titel | - |
| |
Vorname | - |
| |
ZuHänden | - | bis Wawi 1.5 |
Tabelle: Rechnungsadressdaten
Das Feld “ZuHänden” gibt es ab Wawi 1.6 nicht mehr und der Workflow sollte das Datum nach Update nicht weiter beinhalten.
Umsatzsteuer ID
Sollten sie eine Umsatzsteuer ID auf der Rechnung ausweisen, so muss auch die Umsatzsteuer ID von VAI mit auf der Rechnung stehen. Sie können im einfachsten Fall die Umsatzsteuer ID in das Feld Firmenzusatz übernehmen:
WAWI-Workflow testen
Testen Sie nun den Wawi-Workflow an einer Testbestellung, indem Sie zuerst eine Testbestellung in Ihrem Shop anlegen (Barzahlung o. Ä) und diese in die WAWI übertragen. Setzen Sie für die Bestellung die Zahlung über “VAI Pay“ und einem Zahlungseingang. Notieren Sie sich die Auftragsnummer (z.B. 123).
Wechseln Sie zu JTL-Workflows in Aufträge > Komplett bezahlt > “Auftrag_Komplett bezahlt”
Ihre Aktionen des Workflows sollten in etwa so aussehen:
Starten Sie den Test mit
Wählen Sie ein Objekt aus indem Sie nach Auftragsnummer suchen (z.B. 123)
Öffnen Sie erneut den Auftrag. Der Rechnungsempfänger wurde geändert:
E-Mail-Vorlage anpassen
Sie als Verkäufer müssen dem Zwischenhändler die Rechnung des Käufers übersenden. Hierfür muss in diesem Fall eine Unterscheidung nach Zahlungsart in der E-Mail-Vorlage eingerichtet werden. Die korrekte E-Mail Adresse für den Vorgang wurde schon durch den Workflow gesetzt. Im Zahlungseingang zum Vorgang wurde die entsprechende DealNumber zugewiesen. Öffnen Sie Admin → “Druck- / E-Mail- / Exportvorlagen“
Wählen Sie Mailen → Standardvorlage → Bearbeiten. Es öffnet sich “E-Mail-Vorlagen bearbeiten”. Stellen Sie den Betreff auf “Benutzerdefiniert”, um die erweiterten Einstellungen “…“ öffnen zu können. Achten Sie darauf, dass auf der rechten Seite das Variablenset beginnend mit Vorgang verfügbar ist. Ist das nicht der Fall, dann benutzen sie eine neue Standardvorlage. Für den Betrieb ist die Vorlage “Standard (Veraltet)” zu verwenden, diese Vorlage enthält auch das benötigte Variablenset:
Betreff anpassen
Sofern Sie keine Anpassungen an Ihrer Standard E-Mai-Vorlage gemacht haben, können Sie den Code so übernehmen. Anderenfalls passen Sie den Code an bzw. fügen Ihre Änderungen in den ELSE-Teil ein:
{% if Vorgang.Zahlungen.ErstesObjekt.Zahlungsart.Name == "VAI Pay" %}
Rechnung zu VAI-Deal: #{{ Vorgang.Zahlungen.ErstesObjekt.ExterneTransaktionsID }}
{% else %}
Rechnung über "{{ Report.InvoicePosition[0].Name | Truncate: 20 }}"{% case Report.InvoicePosition.Size %}{% when 0%}{% when 1 %}{% when 2 %} und einem weiteren Artikel{% else %} und {{ Report.InvoicePosition.Size | Minus: 1 }} weiteren Artikeln{% endcase%} von {{ Report.Company.CompanyName }}
{% endif %}
Wawi 1.5
{% if Vorgang.Zahlungen.ErstesObjekt.Zahlungsart.Name == "VAI Pay" %}
Rechnung zu VAI-Deal: #{% assign Attribute = Vorgang.Auftrag.Attribute | Split: '|' %}{% for Attribut in Attribute %}{% if Attribut contains 'VaiDealNumber' %}{{ Attribut | ReplaceFirst: 'VaiDealNumber=','' }}{% endif %}{% endfor %}
{% else %}
Rechnung über "{{ Report.InvoicePosition[0].Name | Truncate: 20 }}"{% case Report.InvoicePosition.Size %}{% when 0%}{% when 1 %}{% when 2 %} und einem weiteren Artikel{% else %} und {{ Report.InvoicePosition.Size | Minus: 1 }} weiteren Artikeln{% endcase%} von {{ Report.Company.CompanyName }}
{% endif %}
Wawi 1.6
Rechnungs-PDF Name anpassen
Gleiches gilt auch für die Benennung des PDF-Rechnungsnamen. Fügen Sie Ihre Anpassungen hier auch in den ELSE-Teil weiter am Ende der Code-Zeile ein:
{% if Vorgang.Zahlungen.ErstesObjekt.Zahlungsart.Name == "VAI Pay" %}#{{ Vorgang.Zahlungen.ErstesObjekt.ExterneTransaktionsID }}.pdf{% else %}Rechnung-{{ Vorgang.Rechnungsnummer }}.pdf{% endif %}
Wawi 1.5
Wawi 1.6
Betrieb
Shop
Die Zahlungsart ist im Storefront des Shops wie eine reguläre JTL-Shop-Zahlungsart integriert.
Frontend
Die Zahlungsart VAI Pay steht Käufern nur unter bestimmten Voraussetzungen zur Verfügung. Die Zahlungsart kann nur für B2B in Deutschland und nur in Euro angeboten werden.
Ist das Rechnungsland nicht Deutschland, dann wird VAI Pay als Zahlungsart nicht angeboten.
Ist im Shop eine andere Währung als Euro ausgewählt, dann kann VAI Pay als Zahlungsart nicht angeboten werden.
Hat der Käufer keine Firma in den Kundenstammdaten eingetragen,, dann wird VAI Pay als Zahlungsart nicht angeboten.
Backend
Im Plugin-Backend können Sie die Bestellungen einsehen, die mit VAI Pay bezahlt wurden. Die Suche unterstützt Sie dabei die gewünschten Bestellungen zu finden.