INHALTSVERZEICHNIS
- A. Was macht das Plugin?
- B. Welchen Vorteil bringt mir das?
- C. Unterstützung zu Billie und dem Plugin
- Allgemeines & Doku
- Go-Live Checkliste
- Ersteinrichtung des Plugin
- Rechnung in der JTL-WaWi anpassen
- JTL-Workflow anpassen
- Testbestellung anlegen
- Bestellungsverwaltung in der JTL Wawi
A. Was macht das Plugin?
Billie Rechnungskauf ermöglicht es, Onlinehändlern ihren Unternehmenskunden die Zahlungsmethode Rechnungskauf im Checkout anzubieten.
Kunden können damit bequem Ihre offene Rechnung zum Zahlungsziel begleichen, das basierend auf der Vereinbarung zwischen Billie und dem Händler zwischen 7 und 120 Tagen variieren kann. Der Händler erhält den offenen Betrag direkt nach
dem Versand der Ware bzw. der Erbringung der Dienstleistung.
Billie übernimmt das damit verbundene Kreditrisiko und verarbeitet die eingehenden Zahlungen.
B. Welchen Vorteil bringt mir das?
- Einfache und schnelle Einbindung in den JTL Shop
- Kauf auf Rechnung für Geschäftskunden ohne Risiko mit komplettem Ausfallschutz
- Sofortige Liquidität, denn Billie kümmert sich um den Zahlungseingang
C. Unterstützung zu Billie und dem Plugin
Unterstützung zu allen Billie Themen erhältst du hier im Helpdesk oder direkt bei Billie:
- Per E-Mail: info@billie.io
- In deinem Account: zum Account
- Per Telefon: +49 (0) 30 120 867 996
Das Billie Support-Team kommuniziert alle Fragen direkt mit uns und ist die Schnittstelle zwischen dir und unseren Entwicklern. Damit musst du dich um technische Details nicht kümmern.
Allgemeines & Doku
Um mit Billie loslegen zu können, brauchst du zwei Dinge,
- Einen Billie Account und
- das kostenfreie Billie JTL Shop Plugin.
Deinen Billie Account kannst du ganz easy hier anfordern: » Registrierung bei Billie
Go-Live Checkliste
Billie hat eine hilfreiche Checkliste (auf englisch) angelegt, mit deren Hilfe du strukturiert Billie in deinem Shop einrichten kannst.
Ersteinrichtung des Plugin
Folge bitte der Anweisung des Einrichtungsassistenten im Plugin.
Alle Keys, sowie Felder für die Rechnungserstellung können in den Plugineinstellungen eingetragen werden.
Achte darauf, dass die Zahlungsart Billie auf Zahlung vor Bestellabschluss: JA steht.
Damit die Zahlungsart angezeigt wird, muss der Kunde zwingend Anrede und einen Firmenname angeben.
Rechnung in der JTL-WaWi anpassen
Billie nutzt dynamische Kontoverbindungen.
Das bedeutet jeder Kunde erhält eine andere Kontoverbindung.
Damit auf der Rechnung die richtigen Kontodaten stehen, muss das Rechnungstemplate in der JTL-Wawi angepasst werden:
1. WaWi Druckvorlage
Öffne deine JTL-Wawi und klicke unter Admin → Vorlagen: Druck- / E-Mail- / Exportvorlagen auf den Knoten „Rechnung“.
Vorlage bearbeiten oder eine neue Vorlage hinzufügen.
Wichtig: Die Vorlage muss dem neuen Standard entsprechen (nicht “veraltet”). Wenn die Struktur der Vorlage den nächsten Schritten nicht entspricht, handelt es sich hier wahrscheinlich um das “veraltete” Format
2. Payment Block kopieren
Als erstes muss ein Payment Block kopiert werden damit eine Basis für die Formatierung existiert. Dazu wähle einen Block aus, kopiere den Block (Tastaturkürzel Strg+c) und füge diesen anschließend hinzu (Tastenkürzel Strg+v).
Alternativ kannst du die Schaltflächen im Kopfbereich “Kopieren” und “Hinzufügen” nutzen.
3. Block Namen ändern
Ändere den Namen des kopierten Blocks in z.B. Payment with Billie:
4. Datenzeile anpassen
Danach ändere den Tabelleninhalt, z.B. in Billie Payment auf der linken Seite.
5. Text einfügen
- Klicke doppelt auf den Text unter Billie-Payment.
- Auf der rechten Seite führest du dann einen Doppelklicken auf Daten: (Inhalt) aus.
- Lösche nun den Textblock und füge den Text für List&Labels ein.
Syntax für List&Label(Druck):
"Bitte überweisen Sie den Rechnungsbetrag bis zum "+ date$
(AddDays( now(),val(JTL_GetReportAttribute ('billiePaymentTerm',str$(Report.InternalId,0)))), "%d.
%m.%y")+" unter Angabe der Rechnungsnummer
auf folgendes Konto:¶"+
"¶Kontoinhaber: "+ Report.Company.CompanyName+
"¶IBAN: "+ JTL_GetReportAttribute ('billieIban',str$(Report.InternalId,0))+
"¶BIC: "+ NullSafe(JTL_GetReportAttribute ('billieBic',str$(Report.InternalId,0)),'HYVEDEMMXXX')+
"¶Bank: "+ NullSafe(JTL_GetReportAttribute ('billieBank',str$
(Report.InternalId,0)),'UniCredit Bank-HypoVereinsbank')+
"¶Fälligkeitsdatum: "+ date$(AddDays( now(),val(JTL_GetReportAttribute ('billiePaymentTerm',str$
(Report.InternalId,0)))), "%d.%m.%y")+
"¶Verwendungszweck: "+ Report.InvoiceNumber+
"¶Bitte beachten Sie, dass Ihre Rechnung nur dann beglichen ist, wenn Ihre Zahlung auf das
oben genannte Konto erfolgt.¶"Zur Info: Für die BIC und Bank sind Standardwerte hinterlegt. Diese Werte werden benötigt, wenn du manuell Bestellungen im Billie Dashboard anlegst
6. Darstellungsbedingung
Für den Payment Block muss nun die Darstellungsbedingung verändert werden:
Füge folgenden Code ein:
Report.PaymentMethodName = 'Billie Rechnungskauf'
7. Kontodaten Code
Damit auf der Rechnung keine eigenen Kontodaten stehen wenn Billie die Zahlart ist, füge bitte folgenden Code in die Darstellungsbedingung des Kontodatenblocks ein:
Not Report.PaymentMethodName = 'Billie Rechnungskauf'
Oder du hängst an eine bestehende Bedingung folgendes an:
AND Not Report.PaymentMethodName = 'Billie Rechnungskauf'
JTL-Workflow anpassen
Es existiert keine direkte Verbindung zwischen der JTL Wawi und Billie.
Sämtliche Kommunikation findet zwischen JTL Wawi - JTL Shop - Billie statt. Mit einem JTL-Workflow ist es möglich, automatisiert die Rechnungsnummer an den JTL Shop zu übertragen.
Die Rechnungsnummer ist wichtig um den Versand einer Bestellung an Billie zu melden
1. Workflow anlegen
Klicke im Reiter “Admin” unter “Automatisierung” auf “JTL-Workflows”
Lege in der Workflow-Verwaltung im Reiter “Rechnungen” für das Event “Erstellt” einen neuen Workflow an.
2. Neue Bedingung
Auf der rechten Seite klicke bitte auf „Neue Bedingung“ und anschließend auf „Erweiterte Eigenschaften verwalten“.
3. Name isBillie
Trage als Name „isBillie“ ein und kopiere folgenden Text in die Rohdaten:
{% capture isBillieQuery%}
SELECT ba.cValue FROM dbo.tBestellungAttribute AS ba LEFT JOIN dbo.tBestellung b ON ba.kBestellung=b.kBestellung WHERE b.tRechnung_kRechnung='
{{Vorgang.InterneRechnungsnummer | SqlEscape }}' AND ba.cName='billieIban'{% endcapture -%}
{% assign isBillie = isBillieQuery | DirectQueryScalar -%}
{% if isBillie != '' %}true{% else %}false{% endif %}
4. Gleich und true
Die anderen Werte der Bedingung sollen „Gleich“ und „true“ sein.
5. Web-Request(POST)
Unter Aktionen wähle bitte „Web-Request(POST)“ aus
Es muss nur die URL angepasst werden, Header, Body und die Checkboxen können ignoriert werden.
6. URL
Rechts neben „Url:“ klicke bitte auf die drei Punkte „...“ und trage folgenden Code ein:
{% capture shopUrlQuery%}SELECT s.cServerWeb FROM dbo.tBestellung AS b LEFT JOIN tShop AS s
ON b.kShop=s.kShop
WHERE
b.tRechnung_kRechnung='{{ Vorgang.interneRechnungsnummer| SqlEscape }}'{% endcapture -%}
{% assign shopUrl = shopUrlQuery | DirectQueryScalar -%}
{% capture dataQuery%}SELECT b.kInetBestellung FROM dbo.tBestellung AS b WHERE
b.tRechnung_kRechnung='{{ Vorgang.interneRechnungsnummer| SqlEscape }}'{% endcapture -%}
{% assign data = dataQuery | DirectQueryScalar -%}
{{ shopUrl }}/plugins/ws5_billie/workflow.php?kbestellung={{data}}&user=sync&password=sync&invoiceid={{ Vorgang.Rechnungsnummer }}
7. Vorschau
Der Vorschau text sollte in etwa so aussehen wenn für testzwecken eine Rechung ausgewählt wurde.
Wichtig, es muss eine Rechnung sein die Plattform als "Onlineshop" hat, sonst wird die vorschau ohne URL erstellt.
Die Zugangsdaten gemäß deiner ersetzen:
- &user=sync => &user=<Wawi Sync Nutzer>
- &password=sync => &password=<Wawi Sync Passwort>
Daten ohne anführungszeichen und <> zeichen
Mit eigenen Daten sollte diser part in etwa so aussehen:
&user=wawiconnector&password=7sdgj5j023hq&invoice...
9. Workflow simulieren
Zum Abschluss simuliere bitte den Workflow, um zu testen, ob Fehler auftreten.
Testbestellung anlegen
Um zu testen, ob der Shop funktioniert, öffne bitte deinen JTL-Shop und lege zwei verschiedene Artikel (jeweils unter 100€) in den Warenkorb.
Gib als Adresse bitte die Billie Adresse ein. Vor- und Nachnamen und die E-Mail Adresse kannst du frei wählen
Bestätige die Kundendaten.
Wichtig: Da Billie die Kundendaten prüft ist es rechtlich verpflichtend, dass die AGB und die Datenschutzbestimmungen per Opt-in, in der Kundenregistrierung vom Kunden bestätigt werden
Nach dem Klick auf „Zahlungspflichtig bestellen“ wird das Billie Widget aufgehen
Bitte bestätige das Widget mit dem Klick auf „Bestätigen“. Zum Schluss erscheint wie gewohnt die Bestellabschlussseite.
Bestellungsverwaltung in der JTL Wawi
Rechnung erstellen
Durch das Erstellen einer Rechnung in der JTL Wawi wird der „Workflow“ automatisch ausgelöst.
Die Rechnungsnummer wird nun automatisch in den JTL Shop übertragen.
Bestellung versenden
Der Versand wird durch den normalen Standard der JTL Wawi an Billie gesendet.
Die Bestellung muss auf „gesendet“ stehen und unter „Versand“ muss ein Lieferdatum angegeben worden sein.
Sobald ein Shop Abgleich durchgeführt wurde, wird der Status an Billie übertragen.
Überprüfen kannst du dies im JTL Shop unter Plugins → Billie. In den Bestelldetails steht nun im Status-Feld „shipped“.
Sobald du die Bestellung versendest, beginnt bei Billie das Zahlungsziel. Deshalb ist es wichtig, dass der Versand und die Rechnungserstellung zeitlich nah beieinander liegen.
Bestellung stornieren
Die Stornierung einer Bestellung bei Billie funktioniert über den normalen Standard der JTL Wawi: https://guide.jtl-software.de/jtl-wawi/verkauf/auftraege-stornieren/
Erst nach einem Shop Abgleich wird die Stornierung an Billie übertragen.
Wichtig: Die gesamte Kommunikation zu Billie erfolgt über den JTL Shop. Der Shop darf sich nicht im Wartungsmodus befinden. Die Zugangsdaten von Billie müssen eingetragen sein. Es muss ein regelmäßiger Shop Abgleich stattfinden.
Tags: