Quick Start
Jedes leasinGo Widget kann über ein HTML-Element eingebunden und über das zugehörige Integrationsskript initialisiert werden.
data-*-Attribute vorbelegen.<div
class="leasingo-rate-indicator"
data-object-price-netto="12500"
data-vendor="Example GmbH"
data-model="Example 1000">
</div>
<script
src="https://lgwlif5e242.leasingo.cloud/integration/rateIndicator"
async>
</script>
/integration/v1. Dieser Endpunkt stellt Sofort-Rate, Minikalkulator und Schnellkalkulator gemeinsam bereit.Integrationsskripte
Die leasinGo Integrationen werden individuell für Ihre Instanz konfiguriert und über Ihre persönliche Subdomain bereitgestellt.
| Widget | Endpunkt | Verwendung |
|---|---|---|
| Sofort-Rate | /integration/rateIndicator | Nur Sofort-Rate |
| Minikalkulator | /integration/minicalculator | Nur Minikalkulator |
| Schnellkalkulator | /integration/calculator | Nur Schnellkalkulator |
| Alle Widgets | /integration/v1 | Empfohlen bei mehreren Widgets |
Mehrere Widgets verwenden
Wenn auf Ihrer Website verschiedene leasinGo Widgets zum Einsatz kommen, laden Sie nur den gemeinsamen Integrationsendpunkt:
<script
src="https://lgwlif5e242.leasingo.cloud/integration/v1"
async>
</script>Die einzelnen Widget-Skripte müssen in diesem Fall nicht zusätzlich eingebunden werden.
Widgets per HTML einbinden
Für klassische Websites und serverseitig gerenderte Onlineshops ist die deklarative Integration über HTML die einfachste Variante.
Sofort-Rate
<div
class="leasingo-rate-indicator"
data-object-price-netto="12500"
data-vendor="Example GmbH"
data-model="Example 1000">
</div>Minikalkulator
<div
class="leasingo-minicalculator"
data-object-price-netto="12500"
data-maturity="48"
data-finance-product="2"
data-vendor="Example GmbH"
data-model="Example 1000">
</div>Schnellkalkulator
<div
class="leasingo-calculator"
data-object-price-netto="25000"
data-maturity="48"
data-finance-product="1"
data-object-condition="1"
data-deposit-payment-percent="10">
</div>Parameter
Produkt- und Finanzierungsdaten können über data-*-Attribute als Ausgangswerte an die Widgets übergeben werden.
| Attribut | Wert | Beschreibung |
|---|---|---|
data-object-price-netto | Zahl | Netto-Objektpreis |
data-maturity | Ganzzahl | Vertragslaufzeit in Monaten |
data-finance-product | 1 / 2 | 1 = Leasing, 2 = Mietkauf |
data-object-condition | 0 / 1 | 0 = gebraucht, 1 = neu |
data-vendor | Text | Hersteller (2 - 255 Zeichen) |
data-model | Text | Modellbezeichnung (2 - 400 Zeichen) |
data-category | Text | Hauptkategorie |
data-subcategory | Text | Unterkategorie |
Zusätzliche Parameter des Schnellkalkulators
| Attribut | Wert | Beschreibung |
|---|---|---|
data-deposit-payment-percent | Zahl | Anzahlung in Prozent |
data-closing-payment-percent | Zahl | Restwert bzw. Schlussrate in Prozent |
Zahlenformate
Numerische Werte werden ohne Tausendertrennzeichen und mit einem Punkt als Dezimaltrennzeichen angegeben.
data-object-price-netto="125000"
data-deposit-payment-percent="10.75"Welche Werte und Vertragslaufzeiten tatsächlich verfügbar sind, hängt von der individuellen Konfiguration Ihrer leasinGo Instanz und der jeweiligen Kalkulation ab.
JavaScript API
Die JavaScript API ermöglicht den dynamischen Zugriff auf bereits per HTML erzeugte Widgets sowie die vollständig programmatische Erstellung neuer Widgets.
Auf die Initialisierung warten
Sobald ein Widget-Typ vollständig initialisiert und seine JavaScript API verfügbar ist, löst leasinGo auf window ein CustomEvent aus.
| Widget | Ready Event |
|---|---|
| Sofort-Rate | lgoRateIndicatorReady |
| Minikalkulator | lgoMinicalculatorReady |
| Schnellkalkulator | lgoCalculatorReady |
<script>
window.addEventListener('lgoMinicalculatorReady', function (event) {
// Minikalkulator API ist verfügbar
});
</script>
<script
src="https://lgwlif5e242.leasingo.cloud/integration/minicalculator"
async>
</script>Mit data-ref auf HTML-Widgets zugreifen
Ein deklarativ erzeugtes Widget kann über data-ref mit einer eindeutigen Referenz versehen werden:
<div
class="leasingo-rate-indicator"
data-ref="productRate"
data-object-price-netto="12500">
</div>Das Ready Event stellt über event.detail.refs() alle registrierten Referenzen des jeweiligen Widget-Typs zur Verfügung:
window.addEventListener('lgoRateIndicatorReady', function (event) {
const refs = event.detail.refs();
const rate = refs.productRate;
rate.setPriceNetto(15000);
rate.calculate();
});Der Name der Referenz entspricht dabei direkt dem Wert von data-ref:
data-ref="productRate"
// Zugriff:
event.detail.refs().productRateMehrere Widgets desselben Typs
<div
class="leasingo-rate-indicator"
data-ref="productA"
data-object-price-netto="10000">
</div>
<div
class="leasingo-rate-indicator"
data-ref="productB"
data-object-price-netto="20000">
</div>window.addEventListener('lgoRateIndicatorReady', function (event) {
const refs = event.detail.refs();
refs.productA.setPriceNetto(12000);
refs.productA.calculate();
refs.productB.setPriceNetto(22000);
refs.productB.calculate();
});Widgets per JavaScript erstellen
Widgets können vollständig programmatisch erstellt werden. Diese Variante eignet sich besonders für Single-Page-Applications, Produktkonfiguratoren und andere dynamische Webanwendungen.
Factory-Funktionen
Nach dem jeweiligen Ready Event stehen folgende Factory-Funktionen zur Verfügung:
leasinGo.createRateIndicator(
element: HTMLElement
): WidgetInterface
leasinGo.createMinicalculator(
element: HTMLElement
): WidgetInterface
leasinGo.createCalculator(
element: HTMLElement
): WidgetInterfaceDie Factory-Funktion erwartet das HTML-Element, in dem das Widget erzeugt werden soll, und gibt das zugehörige WidgetInterface zurück.
Beispiel: Minikalkulator erstellen
<div id="my-leasing-minicalculator"></div>
<script>
window.addEventListener('lgoMinicalculatorReady', function () {
const element = document.getElementById('my-leasing-minicalculator');
const calculator = leasinGo.createMinicalculator(element);
calculator.setVendor('Example GmbH');
calculator.setModel('Example 1000');
calculator.setPriceNetto(12500);
calculator.setMaturity(48);
calculator.calculate();
});
</script>Sofort-Rate erstellen
window.addEventListener('lgoRateIndicatorReady', function () {
const element = document.getElementById('my-leasing-rate');
const rate = leasinGo.createRateIndicator(element);
rate.setVendor('Example GmbH');
rate.setModel('Example 1000');
rate.setPriceNetto(12500);
rate.calculate();
});Schnellkalkulator erstellen
window.addEventListener('lgoCalculatorReady', function () {
const element = document.createElement('div');
const calculator = leasinGo.createCalculator(element);
document.body.append(element);
calculator.setPriceNetto(25000);
calculator.setFinanceProduct(1);
calculator.setMaturity(48);
calculator.calculate();
});WidgetInterface: Widget-Daten dynamisch ändern
| Methode | Parameter | Beschreibung |
|---|---|---|
setVendor(value) | string | Hersteller setzen (2 - 255 Zeichen) |
setModel(value) | string | Modellbezeichnung setzen (2 - 400 Zeichen) |
setObjectCondition(value) | number | Objektzustand setzen, 0 = gebraucht, 1 = neu |
setPriceNetto(value) | number | Netto-Objektpreis setzen |
setFinanceProduct(value) | number | Finanzierungsprodukt setzen, 1 = Leasing, 2 = Mietkauf |
setMaturity(value) | number | Vertragslaufzeit in Monaten setzen |
setCategory(value) | string | Hauptkategorie setzen |
setSubcategory(value) | string | Unterkategorie setzen |
calculate() | – | Kalkulation mit den aktuellen Werten starten |
Beispiel: Produktvariante aktualisieren
let productRate;
window.addEventListener('lgoRateIndicatorReady', function (event) {
productRate = event.detail.refs().productRate;
});
function updateProduct(product) {
productRate.setVendor(product.vendor);
productRate.setModel(product.name);
productRate.setPriceNetto(product.netPrice);
productRate.calculate();
}HTML oder JavaScript?
Für klassische Websites und Onlineshops empfehlen wir die deklarative HTML-Integration. Produktdaten können direkt über data-*-Attribute vorgegeben und bei Bedarf später über data-ref dynamisch angesprochen werden.
Die programmatische Integration eignet sich insbesondere dann, wenn Ihre Anwendung selbst darüber entscheiden soll, wann und wo ein Widget erzeugt wird. Beide Varianten können innerhalb derselben Anwendung kombiniert werden.
Legacy: Callback API
Bestehende Integrationen
Für bestehende Integrationen werden weiterhin Widget-spezifische Callback-Arrays unterstützt. Für neue Integrationen empfehlen wir die Ready Events.
| Widget | Legacy Callback |
|---|---|
| Sofort-Rate | window.lgoRateIndicatorCallbacks |
| Minikalkulator | window.lgoMinicalculatorCallbacks |
| Schnellkalkulator | window.lgoCalculatorCallbacks |
window.lgoRateIndicatorCallbacks =
window.lgoRateIndicatorCallbacks || [];
window.lgoRateIndicatorCallbacks.push(function () {
// Sofort-Rate wurde initialisiert
});Für neue Integrationen:
window.addEventListener('lgoRateIndicatorReady', function (event) {
const refs = event.detail.refs();
// Sofort-Rate wurde initialisiert
});