Kontolux AI empfängt Ablefy-Ereignisse per Webhook. Bezahlte Einmalkäufe, Raten und Zahlungen aus befristeten Abos werden als Einnahme-Beleg gebucht — im Reseller-Modell mit deinem Anteil laut Gutschrift, bei Verkauf im eigenen Namen mit dem vollen Kaufpreis —, Erstattungen als eigener Beleg. Ablefy bietet keine Webhook-Signatur an — die Sicherheit beruht auf deiner geheimen, persönlichen Webhook-URL.
So funktioniert die Ablefy-Integration
- Zahlung bei AblefyDein Kunde bezahlt wie gewohnt.
- Webhook an KontoluxAblefy meldet die Zahlung sofort an deine persönliche URL. Kontolux prüft die Echtheit.
- Beleg im ArchivBezahlter Beleg mit dem eingestellten MwSt-Satz, Kategorie und Sachkonto; ohne eingestellten Satz bleibt er offen.
Ablefy sendet bei jedem Ereignis den vollständigen Bestelldatensatz an deine persönliche Kontolux-URL. Kontolux wertet das Ereignis aus und legt den passenden Beleg an.
Welche Ablefy-Ereignisse gebucht werden
- Als Einnahme:
order.one_time.paid,order.installment.paid,order.limited_subscription.paidundpayment.successful. - Als Erstattung (eigener Beleg):
order.one_time.refunded,order.installment.refunded,order.subscription.refunded,order.limited_subscription.refundedundrefund.successful.
Wichtig zur Sicherheit: Ablefy signiert Webhooks nicht. Deine Webhook-URL enthält deshalb einen langen geheimen Teil. Behandle sie wie ein Passwort und gib sie nicht weiter.
Abrechnung von Ablefy
Die Ablefy-Abrechnung bzw. Gutschrift lädst du als Sammelbeleg hoch — als Nachweis, ohne Doppelbuchung.
Steuerlicher Hinweis: Bei Ablefy gibt es zwei Verkaufsmodelle, und Kontolux fragt bei der Einrichtung ab, welches du nutzt. Reseller-Modell: Vertragspartner deiner Kunden ist namotto (eine Ablefy-Tochter), du erhältst je Auszahlung eine Gutschrift. Kontolux bucht deshalb deinen Anteil — Kaufpreis ohne Umsatzsteuer, Gebühren und Provisionen —, bei eingestellten 19 % bzw. 7 % zuzüglich dieses Satzes, als Kleinunternehmer netto; ist kein Satz eingestellt oder „Keine Angabe“ gewählt, netto ohne Steuersatz, und der Beleg bleibt offen, bis du den Satz ergänzt. Verkauf im eigenen Namen: Du stellst die Rechnung selbst, Kontolux bucht den vollen Kaufpreis; die Ablefy-Gebühren erfasst du über die monatliche Abrechnung als Ausgabe. Fragen zu Sonderfällen wie Auslandsverkäufen kann dein Finanzamt oder, falls du mit einer arbeitest, eine steuerberatende Person klären.
Umsatzsteuer, Kategorie und Sachkonto
Den Umsatzsteuersatz legst du einmal pro Integration fest. Kontolux ordnet jedem Einnahme-Beleg daraus die passende Kategorie und das Sachkonto deines Kontenrahmens zu. Das Land des Kunden wertet Kontolux nur aus, wenn die Plattform es übermittelt und die Funktion „Bestellungen an Kunden im Ausland“ für dein Konto freigeschaltet ist (mehr in der Hilfe); solche Belege bleiben dann zur Klärung offen. Bis dahin zählen solche Zahlungen mit dem eingestellten Satz; verkaufst du auch ins Ausland, prüfe und korrigiere diese Belege selbst.
| Deine Einstellung | Kategorie im Beleg | Typisch für |
|---|---|---|
| 19 % Umsatzsteuer | Einnahmen 19% (z. B. SKR03 8400) | Regelbesteuerte Selbstständige |
| 7 % Umsatzsteuer | Einnahmen 7% | Ermäßigte Leistungen, z. B. bestimmte Bücher |
| 0 % – Kleinunternehmer nach § 19 UStG | Einnahmen steuerfrei | Kleinunternehmer |
| Keine Angabe | keine; Beleg ohne Steuersatz mit Hinweis „Steuersatz offen“ | Satz steht noch nicht fest; bei Regelbesteuerung zählt der Beleg bis zur Ergänzung als nicht berechnet |
Jeden automatisch angelegten Beleg kannst du im Belegarchiv nachträglich anpassen: Kategorie, Buchungstext und MwSt-Satz ändern oder eine Datei anhängen. Betrag und Datum bleiben gesperrt, weil sie direkt von Ablefy stammen.
Ablefy mit Kontolux verbinden: Schritt für Schritt
Du brauchst ein Kontolux-Konto (kostenlos) und Zugriff auf dein Ablefy-Konto.
-
Ablefy in Kontolux aktivieren
Öffne in Kontolux Einstellungen → Integrationen → Ablefy, wähle dein Verkaufsmodell (Reseller-Modell oder Verkauf im eigenen Namen) und deinen Umsatzsteuersatz und klicke auf Speichern. Ein Secret brauchst du nicht.
-
Webhook-URL kopieren
Kontolux zeigt dir deine persönliche Webhook-URL. Kopiere sie und behandle sie vertraulich.
-
Webhook bei Ablefy anlegen
Öffne in deinem Ablefy-Konto im Bereich Market & Sell → Webhook die Übersicht, lege mit Erstellen einen neuen Webhook mit der Kontolux-URL an und aktiviere die Ereignisse für bezahlte Bestellungen, Raten und Erstattungen.
-
Fertig
Das Badge steht auf Aktiv. Neue Zahlungen und Erstattungen erscheinen automatisch im Belegarchiv.
Mehr Details zu allen Plattformen findest du im Hilfe-Artikel Zahlungsanbieter per Webhook verbinden.
Für wen sich die Ablefy-Integration lohnt
Online-Akademien
Kurse und Mitgliederbereiche verkaufen, jede Zahlung automatisch gebucht.
Ratenzahlung
Jede einzelne Rate wird zum Zahlungszeitpunkt als Einnahme erfasst.
Coaching-Programme
Hochpreis-Programme mit Erstattungen sauber abbilden.
Häufige Fragen zur Ablefy-Buchhaltung
Ist Ablefy dasselbe wie elopage?
Ja. Die Plattform elopage heißt heute Ablefy. Die Kontolux-Integration funktioniert mit deinem bestehenden Konto.
Wie werden Ratenzahlungen gebucht?
Jede bezahlte Rate (order.installment.paid) wird als eigener Einnahme-Beleg zum Zahlungszeitpunkt gebucht. Das entspricht dem Zufluss bei der Einnahmenüberschussrechnung.
Werden Erstattungen gebucht?
Ja. Bei Ablefy werden Erstattungs-Ereignisse als eigener Beleg erfasst. Der ursprüngliche Einnahme-Beleg bleibt unverändert.
Warum gibt es kein Secret-Feld?
Ablefy bietet keine Signatur für Webhooks an. Die Sicherheit beruht auf dem geheimen Teil deiner persönlichen Webhook-URL. Gib diese URL deshalb nicht weiter.
Werden Ereignisse doppelt gebucht?
Nein. Kontolux bildet für jedes Ereignis einen eindeutigen Schlüssel aus Bestellung, Ereignistyp und Zeitpunkt und verarbeitet es nur einmal.
Wie teste ich die Verbindung ohne echten Kauf?
Ablefy hat keinen eigenen Testmodus. Am einfachsten kaufst du dein Produkt mit einem 100-%-Gutscheincode — das empfiehlt Ablefy auch für Produkte im Reseller-Modell. Der Webhook kommt dann mit 0 € an: Kontolux bucht nichts, zeigt aber in der Integrationskarte „Nachricht ohne Betrag empfangen — Verbindung funktioniert“.
Was kostet die Ablefy-Integration?
Nichts extra. Alle Integrationen sind in Kontolux AI enthalten, und Kontolux ist in der aktuellen Beta-Phase komplett kostenlos.