JobRad®-Leasing

Das Plugin fügt Ihrem Shop das JobRad® Dienstradleasing als reguläre Shopware-Zahlungsart hinzu. Schließt eine Kundin oder ein Kunde eine Bestellung ab und bezahlt mit JobRad®, übernimmt Shopware die Bestelldaten, erstellt daraus ein Leasing-Angebot und übermittelt es an die JobRad® Dealer API. Sie müssen Bestelldaten nicht mehr von Hand in ein zweites System übertragen

Die Übermittlung erfolgt im Hintergrund, nachdem die Bestellung aufgegeben wurde. Ihr Bestellabschluss wird dadurch nie verzögert und schlägt nie wegen JobRad® fehl. Kann eine Bestellung nicht übermittelt werden, weil Daten fehlen oder weil JobRad® das Angebot ablehnt, wird sie in einem eigenen Modul der Administration gesammelt. Dort ergänzt ein Mitglied Ihres Teams die Daten und sendet das Angebot erneut. Ist ein Angebot einmal angenommen, hält Shopware dessen Status automatisch aktuell.

Bevor Sie beginnen

Bitte stellen Sie sicher, dass Folgendes vorhanden ist, bevor Sie starten:

• Sie haben von JobRad® die Zugangsdaten zur JobRad® Dealer API erhalten. Diese bestehen aus einer Client-ID, einem Client-Secret und einem Scope.
• Auf Ihrer Installation läuft ein Message-Queue-Worker, denn die Angebote werden im Hintergrund verarbeitet. Ohne Worker werden Bestellungen zwar angenommen, aber nie übermittelt.
• Die geplanten Aufgaben Ihrer Installation laufen, denn die Angebotsstatus werden über eine geplante Aufgabe aktualisiert.
• Sie kennen den sechsstelligen BIDEX-Code jedes Fahrrads, das Sie zum Leasing anbieten möchten. JobRad® identifiziert ein Fahrrad über diesen Code.

Installation

1. Installieren und aktivieren Sie das Plugin unter Erweiterungen > Meine Erweiterungen.
2. Öffnen Sie Einstellungen > Zahlungsarten, öffnen Sie die Zahlungsart JobRad® und aktivieren Sie sie. Die Zahlungsart wird bei der Installation angelegt und ist inaktiv, bis Sie sie aktivieren.
3. Öffnen Sie Ihren Verkaufskanal und fügen Sie JobRad® den Zahlungsarten des Verkaufskanals hinzu.

Möchten Sie JobRad® nur unter bestimmten Bedingungen anbieten, zum Beispiel erst ab einem bestimmten Warenkorbwert, öffnen Sie die Zahlungsart und wählen im Bereich Verfügbarkeitsregel eine Regel aus. Passende Regeln legen Sie wie gewohnt im Rule Builder unter Einstellungen > Rule Builder an.

Konfiguration

Die Konfiguration finden Sie unter Erweiterungen > Meine Erweiterungen > JobRad®-Leasing > Konfigurieren. Alle Einstellungen werden je Verkaufskanal vorgenommen. Wählen Sie daher oben auf der Seite zuerst den Verkaufskanal aus, den Sie konfigurieren möchten.

JobRad®-API-Autorisierung

Dies sind die Zugangsdaten, die Sie von JobRad® erhalten haben. Ohne sie kann das Plugin keine Angebote übermitteln.

• Token-URL: Der Endpunkt, an dem das Plugin sein Access-Token anfordert. Der richtige Wert ist bereits eingetragen. Ändern Sie ihn bitte nur, wenn JobRad® Ihnen einen anderen genannt hat, zum Beispiel für eine Testumgebung.
• Client-ID: Tragen Sie hier die Client-ID ein, die Sie von JobRad® erhalten haben.
• Client-Secret: Tragen Sie hier das Client-Secret ein, das Sie von JobRad® erhalten haben.
• Scope: Der Berechtigungsumfang für den API-Zugriff. In der Regel ist das dealer-api.
• Angebots-URL: Der Endpunkt, an dem die Angebote erstellt werden. Auch hier ist der richtige Wert bereits eingetragen.

JobRad®-Angebotsvorbereitung

Hier teilen Sie dem Plugin mit, wo es die von JobRad® benötigten Informationen in Ihren Produkten findet.

• Eigenschaftsgruppen: JobRad® beschreibt ein Fahrrad über seinen Modellnamen, sein Modelljahr, seine Farbe, seine Größe und, bei einem E-Bike, über den Antriebshersteller und die Akkukapazität. In Shopware pflegen Sie diese Werte als Produkteigenschaften. Wählen Sie daher jeweils die Eigenschaft aus, die den Wert enthält. Eine ausführliche Beschreibung finden Sie im Abschnitt Ihre Produkte einrichten.
• Ersatz-Lieferzeit in Tagen: JobRad® benötigt für jedes Angebot ein Lieferdatum. Das Plugin berechnet es aus der Lieferzeit des Produkts. Tragen Sie hier ein, von wie vielen Tagen ausgegangen werden soll, wenn bei einem Produkt keine Lieferzeit gepflegt ist. Der Standardwert beträgt 14 Tage.
• Produkt für die Montagekosten: Berechnen Sie Ihren Kundinnen und Kunden die Montage des Fahrrads, wählen Sie hier das Produkt aus, das Sie dafür verwenden. Weitere Einzelheiten finden Sie im Abschnitt Montagekosten.
• Versandarten ohne Versand: Wählen Sie hier alle Versandarten aus, bei denen tatsächlich nichts versendet wird, zum Beispiel die Abholung in Ihrem Laden. Weitere Einzelheiten finden Sie im Abschnitt Versandkosten.

Storefront

Das Plugin kann in Ihrer Storefront einen kurzen Hinweis zum JobRad®-Leasing anzeigen. Beide Hinweise sind standardmäßig deaktiviert.

• JobRad®-Infobox auf der Produktseite anzeigen: Zeigt den Hinweis auf der Produktdetailseite jedes Produkts an.
• JobRad®-Infobox im Checkout anzeigen: Zeigt den Hinweis im Bestellabschluss an, sobald die Kundin oder der Kunde JobRad® als Zahlungsart gewählt hat.

Beide Texte können Sie unter Einstellungen > Textbausteine an Ihre eigene Formulierung anpassen. Suchen Sie dort nach diga-jobrad-leasing.

JobRad®-Statusabgleich

• Zeitfenster für Statusänderungen: Das Plugin aktualisiert die Angebotsstatus alle zwei Stunden. Wählen Sie hier aus, wie weit zurück es JobRad® nach Änderungen fragt. Der Wert muss größer sein als das Intervall von zwei Stunden, damit keine Änderung verloren geht, wenn eine Aktualisierung sich verzögert. Wir empfehlen, den Standardwert von 24 Stunden beizubehalten.

Fehlerbenachrichtigung

• E-Mail-Adresse für Benachrichtigungen: Tragen Sie hier die Adresse ein, die per E-Mail informiert werden soll, sobald eine Bestellung nicht an JobRad® übermittelt werden kann und von Hand ergänzt werden muss. Lassen Sie das Feld leer, wenn Sie keine Benachrichtigungen erhalten möchten.

Ihre Produkte einrichten

JobRad® nimmt ein Angebot nur an, wenn das Fahrrad vollständig beschrieben ist. Bitte pflegen Sie die folgenden Informationen bei jedem Produkt, das Sie zum Leasing anbieten möchten.

BIDEX-Code

Der BIDEX-Code ist die sechsstellige Nummer, mit der JobRad® ein Fahrrad in seiner eigenen Fahrraddatenbank identifiziert. Das Feld finden Sie auf der Produktkonfigurationsseite in der Administration, in der Karte JobRad®-Leasing. Der Code muss bei JobRad® existieren, sonst wird das Angebot abgelehnt, auch wenn die Nummer formal korrekt ist.

Hersteller

Der Hersteller, der dem Produkt in Shopware zugewiesen ist, wird als Marke des Fahrrads übermittelt. JobRad® akzeptiert nur Marken, die dort bekannt sind. Vergleichen Sie daher die Schreibweise Ihrer Hersteller mit den von JobRad® verwendeten Markennamen.

Modellname

JobRad® erwartet den Modellnamen, den der Hersteller dem Fahrrad gibt. Pflegen Sie den Modellnamen als Produkteigenschaft und haben Sie diese Eigenschaft in der Plugin-Konfiguration ausgewählt, übermittelt das Plugin den Wert des Produkts. Haben Sie das nicht getan, übermittelt es stattdessen den Produktnamen aus Shopware.

Immer dann, wenn keine Eigenschaft ausgewählt ist, erreicht also Ihr Produktname JobRad® als Modell. Achten Sie bitte darauf, dass er dem Modellnamen des Herstellers entspricht, zum Beispiel Reaction Hybrid Pro 625.

Modelljahr, Farbe, Größe, Antriebshersteller und Akkukapazität

Diese Angaben liest das Plugin aus den Eigenschaften des Produkts. Am Beispiel des Modelljahrs:

1. Kataloge > Eigenschaften: Legen Sie eine Eigenschaft mit dem Namen Modelljahr an und ergänzen Sie die Jahre, die Sie verkaufen, als deren Eigenschaftswerte, zum Beispiel 2025 und 2026.
2. Produkt > Spezifikationen > Eigenschaften: Weisen Sie dem Fahrrad über Eigenschaften konfigurieren den passenden Wert zu.
3. Plugin-Konfiguration > JobRad®-Angebotsvorbereitung: Wählen Sie im Feld Eigenschaftsgruppe für das Modelljahr die Eigenschaft Modelljahr aus.

Gehen Sie für die Farbe, die Größe und, wenn Sie E-Bikes verkaufen, für den Antriebshersteller und die Akkukapazität genauso vor.

Bitte wählen Sie für jede Angabe, die Sie pflegen, eine Eigenschaft aus. Ihre Eigenschaftswerte müssen Sie nicht genau so benennen, wie JobRad® sie erwartet.

Haben Sie keine Eigenschaft ausgewählt, versucht das Plugin, sie an ihrem Namen zu erkennen, zum Beispiel eine Eigenschaft namens Colour oder Farbe. Das funktioniert nur bei wenigen gängigen Namen und scheitert etwa bei einem Namen wie Rahmengröße. Wählen Sie Ihre Eigenschaften deshalb bitte immer aus, sonst fehlen Angaben im Angebot, obwohl sie am Produkt gepflegt sind.

Preise

JobRad® benötigt für jedes Fahrrad und jedes Zubehör einen Verkaufspreis und einen Listenpreis, und der Verkaufspreis muss kleiner oder gleich dem Listenpreis sein. Das Plugin übernimmt beide Preise aus der Bestellung.

Haben Sie bei einem Produkt keinen Streichpreis gepflegt, übermittelt das Plugin den Verkaufspreis zugleich als Listenpreis. Ein Angebot wird daher nie abgelehnt, weil ein Listenpreis fehlt. Einen Streichpreis müssen Sie nur dort pflegen, wo Sie ein Produkt tatsächlich unter seiner unverbindlichen Preisempfehlung verkaufen, damit JobRad® die Reduzierung sehen kann.

Zubehör

Ihre Kundinnen und Kunden können Zubehör zusammen mit dem Fahrrad bestellen, zum Beispiel einen Helm oder ein Schloss. Pflegen Sie Ihr Zubehör in Shopware bitte als gewöhnliche Produkte und tragen Sie dessen BIDEX-Code in der Karte JobRad®-Leasing ein, genau wie bei einem Fahrrad.

Sie müssen Zubehör nirgends als solches kennzeichnen. Das Plugin erkennt es am BIDEX-Code selbst, denn JobRad® verwendet eigene Kategorien für Fahrräder und für Zubehör. Für jedes Zubehör benötigt JobRad® den BIDEX-Code, den Hersteller, den Modellnamen und den Verkaufspreis. Die Menge eines Zubehörs wird aus der Bestellung übernommen und unverändert übermittelt. Welches Zubehör und welche Mengen in einem Leasing-Angebot zulässig sind, entscheidet JobRad®.

Wie bei einem Fahrrad stammt der Modellname eines Zubehörs aus dem Produktnamen in Shopware. Benennen Sie Ihre Zubehörprodukte deshalb bitte so, dass JobRad® sie identifizieren kann, zum Beispiel Abus Urban-I 3.0 Helm statt Helm, schwarz.

Welche Angaben verpflichtend sind

Fehlen Angaben, wird die Bestellung trotzdem ganz normal aufgegeben. Sie wird lediglich nicht an JobRad® übermittelt, sondern unter JobRad®-Angebote gesammelt, wo Sie sie ergänzen können.

Bitte beachten Sie außerdem, dass JobRad® genau ein Fahrrad je Bestellung least. Bestellt eine Kundin oder ein Kunde mehrere Fahrräder oder ein Fahrrad mit einer Menge größer als eins, wird die Bestellung nicht übermittelt und erscheint ebenfalls unter JobRad®-Angebote. Diese Regel gilt nur für das Fahrrad; Zubehör in der Bestellung wird nicht mitgezählt.

BIDEX-Codes in großer Menge pflegen

Damit Sie die Codes Ihres gesamten Sortiments nicht einzeln eintragen müssen, installiert das Plugin ein fertiges Import/Export-Profil.

1. Öffnen Sie Einstellungen > Import/Export und wählen Sie das Profil diga_jobrad_bidex aus.
2. Führen Sie zuerst einen Export durch. Sie erhalten eine CSV-Datei mit den beiden Spalten product_number und bidex_code.
3. Tragen Sie die Codes in der Datei ein und importieren Sie sie wieder. Die Produkte werden über ihre Produktnummer zugeordnet, sodass Sie den Import jederzeit wiederholen können, um Codes zu aktualisieren.

Montagekosten

Berechnen Sie Ihren Kundinnen und Kunden die Montage des Fahrrads, kann das Plugin diese Kosten für Sie in den Warenkorb legen. In Shopware bilden Sie sie als gewöhnliches Produkt ab:

1. Legen Sie ein Produkt für die Montagekosten an und geben Sie ihm den Preis, den Sie berechnen.
2. Blenden Sie das Produkt in Ihrer Storefront aus, damit Kundinnen und Kunden es nicht einzeln finden und bestellen können. Das machen Sie auf der Produktkonfigurationsseite in der Administration, in der Karte Zuweisung. Folgen Sie dort Sichtbarkeit für ausgewählte Verkaufskanäle einstellen und setzen Sie das Produkt auf In Produktlisten und Suche ausblenden.
3. Wählen Sie dieses Produkt in der Plugin-Konfiguration unter Produkt für die Montagekosten aus.

Sobald eine Kundin oder ein Kunde JobRad® als Zahlungsart wählt, legt das Plugin dieses Produkt automatisch in den Warenkorb und entfernt es wieder, wenn eine andere Zahlungsart gewählt wird. Die Kundin oder der Kunde sieht die Kosten als eigene Position im Warenkorb und kann sie weder löschen noch deren Menge ändern. Der Betrag wird als Montagekosten an JobRad® übermittelt.

Berechnen Sie keine Montagekosten, lassen Sie die Einstellung einfach leer.

Versandkosten

Die Versandkosten der Bestellung werden als Bruttobetrag an JobRad® übermittelt, genau so, wie sie in der Bestellung berechnet wurden. Versandkosten von 0,00 sind zulässig.

Bei Bestellungen, die die Kundin oder der Kunde bei Ihnen abholt, erwartet JobRad® zusätzlich die Information, dass nichts versendet wird. Wählen Sie deshalb bitte alle Versandarten dieser Art in der Plugin-Konfiguration unter Versandarten ohne Versand aus. Wird in Ihrem Shop jede Bestellung versendet, lassen Sie die Einstellung einfach leer.

Weder die Versandkosten noch die Montagekosten können nachträglich geändert werden, denn beide stammen direkt aus der Bestellung.

Mit JobRad®-Angeboten arbeiten

Das Plugin fügt dem Hauptmenü der Administration unterhalb von Bestellungen einen eigenen Menüpunkt JobRad®-Angebote hinzu. Dort ist zu jeder Bestellung, die mit JobRad® bezahlt wurde, das zugehörige JobRad®-Angebot aufgeführt, einschließlich der Angebote, die ohne Probleme übermittelt wurden. Die Übersicht zeigt zu jedem Angebot zwei verschiedene Status.

Technischer Verarbeitungsstatus

Dieser Status sagt Ihnen, was das Plugin bisher mit der Bestellung gemacht hat.

• In Warteschlange: Die Bestellung ist eingegangen und wartet auf den Hintergrund-Worker. In der Regel dauert das nur wenige Sekunden. Bleiben Bestellungen längere Zeit in diesem Status, läuft auf Ihrer Installation kein Message-Queue-Worker.
• Prüfung erforderlich: Die Bestelldaten sind unvollständig, deshalb wurde noch nichts an JobRad® übermittelt. Bitte ergänzen Sie die Daten und senden Sie das Angebot.
• Angebot erstellt: Das Angebot wurde bei JobRad® erfolgreich erstellt. Das bedeutet noch nicht, dass das Leasing bewilligt ist. Der Leasing-Prozess läuft nun bei JobRad® weiter, und Sie können seinen Fortschritt im unten beschriebenen Angebotsstatus verfolgen.
• Übermittlung fehlgeschlagen: Bei JobRad® konnte kein Angebot erstellt werden. Entweder hat JobRad® die Daten nicht akzeptiert, oder die Übermittlung selbst ist fehlgeschlagen. Der Grund wird in der Prüfansicht angezeigt, wo Sie die Angebotsdaten korrigieren und erneut übermitteln können.

Von JobRad® zurückgemeldeter Angebotsstatus

Dieser Status zeigt, wie weit der Leasing-Prozess bei JobRad® fortgeschritten ist. Er wird automatisch aktualisiert und durchläuft die folgenden Stufen: Nicht übermittelt, Status wird abgefragt, Ausstehend, Entwurf, Bestellprozess gestartet, Entscheidung des Arbeitgebers ausstehend, Entscheidung von JobRad® ausstehend und schließlich Abgeschlossen, Storniert oder Abgelehnt. Die letzten drei Status sind endgültig.

Ein Angebot ergänzen und übermitteln

Klicken Sie bei einem Angebot auf Bearbeiten, um die Prüfansicht zu öffnen. Dort sehen Sie immer die Daten des Angebots, aufgeteilt auf die Karten Allgemein, Produkt und Zubehör.

Stimmt etwas am Angebot nicht, zeigt die Ansicht es oberhalb der Daten an: die Felder, die noch fehlen oder ungültig sind, und den Grund, warum die letzte Übermittlung fehlgeschlagen ist.

Ein Angebot, das bei JobRad® bereits erstellt wurde, kann nicht mehr bearbeitet werden.

Korrigieren können Sie hier den BIDEX-Code, die Marke, das Modell, das Modelljahr, die Farbe, die Größe, den Antriebshersteller, die Akkukapazität und das Lieferdatum. Die Bestellnummer, die Kundendaten, die Preise sowie die Versand- und Montagekosten stammen aus der Bestellung und können nicht geändert werden.

Mit Speichern sichern Sie Ihre Korrekturen, mit Absenden übermitteln Sie das Angebot. Vor der Übermittlung werden die Daten erneut geprüft.

Bitte beachten Sie, dass eine hier vorgenommene Korrektur nur für dieses eine Angebot gilt und Ihr Produkt nicht verändert. Wir empfehlen deshalb, auch das Produkt zu korrigieren, damit die nächste Bestellung von vornherein vollständig ist. Das gilt ebenso umgekehrt: Korrigieren Sie ein Produkt nachträglich, wird ein Angebot, das bereits auf seine Prüfung wartet, nicht automatisch aktualisiert.

Sobald ein Angebot bei JobRad® erstellt wurde, kann es weder bearbeitet noch ein zweites Mal übermittelt werden.

Bestellungen, die Sie in der Administration anlegen

Eine Bestellung, die Sie von Hand in der Administration anlegen, durchläuft nicht den Bestellabschluss. Deshalb wird dafür nicht automatisch ein Angebot vorbereitet. Die Schaltfläche An JobRad® senden finden Sie auf der Bestelldetailseite in der Karte JobRad® Dienstradleasing. Sie startet genau denselben Vorgang wie eine Kundenbestellung.

Angebotsstatus aktualisieren

Die Angebotsstatus werden automatisch alle zwei Stunden aktualisiert. Erreicht ein Angebot den Status Abgeschlossen, wird die Zahlung der Shopware-Bestellung auf bezahlt gesetzt; die Status Storniert und Abgelehnt werden ebenso auf die Bestellung übertragen.

Benötigen Sie sofort einen aktuellen Status, lässt sich die Aktualisierung auch direkt auf dem Server starten. Dieser Befehl fragt JobRad® nach jedem übermittelten Angebot, ganz ohne Zeitfenster:bin/console diga:jobrad:sync-offer-status

Ergänzen Sie --window=24, um nur nach Angeboten zu fragen, deren Status sich in den letzten 24 Stunden geändert hat.

Viel Erfolg und Spaß mit der Erweiterung.