Kontolux AI empfängt Shopify-Webhooks für bezahlte Bestellungen (Order payment) und Erstattungen (Refund create). Jede Nachricht wird per HMAC-Signatur auf Echtheit geprüft und als Beleg gebucht: Bestellungen als Einnahme mit Bestellnummer, Umsatzsteuersatz und Sachkonto, Erstattungen als eigener Beleg. Die Einrichtung dauert rund fünf Minuten.
So funktioniert die Shopify-Integration
- Zahlung bei ShopifyDein Kunde bezahlt wie gewohnt.
- Webhook an KontoluxShopify 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.
Shopify schickt bei jeder bezahlten Bestellung und jeder Erstattung eine Nachricht (Webhook) an deine persönliche Kontolux-URL. Kontolux prüft zuerst die Signatur, dann wird der Beleg geschrieben — ohne dass du etwas tun musst.
Welche Shopify-Ereignisse gebucht werden
- Order payment (
orders/paid) — eine vollständig bezahlte Bestellung wird als Einnahme gebucht. Betrag ist der Gesamtbetrag der Bestellung inklusive Steuern und Versand, die Bestellnummer (z. B. #1042) landet als Rechnungsnummer im Beleg. - Refund create (
refunds/create) — eine Erstattung wird als eigener Beleg über den tatsächlich zurückgezahlten Betrag gebucht. Teilerstattungen funktionieren genauso.
Warum Kontolux jede Nachricht prüft (HMAC)
Deine Webhook-URL ist zwar geheim, aber eine URL allein ist kein Schutz. Shopify unterschreibt deshalb jede Nachricht mit dem Signaturschlüssel deines Shops (HMAC-SHA256). Kontolux berechnet dieselbe Unterschrift selbst und bucht nur, wenn beide übereinstimmen. Gefälschte oder veränderte Nachrichten werden abgelehnt — niemand kann dir so falsche Umsätze in die Buchhaltung schreiben.
Keine doppelten Buchungen
Shopify wiederholt eine Nachricht, wenn sie nicht sofort ankommt. Kontolux merkt sich jede Zustellung und zusätzlich jede Bestellung und Erstattung. Selbst wenn du versehentlich zwei gleiche Webhooks anlegst, wird eine Bestellung nur einmal gebucht.
Was im Beleg steht
Betrag, Zahlungsdatum, Bestellnummer, Kunde, Kategorie und Sachkonto nach deinem Kontenrahmen (z. B. 8400 in SKR03 bei 19 %). Rechnet dein Shop in einer anderen Währung als Euro ab, steht die Währung im Belegnamen.
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 Shopify stammen.
Shopify mit Kontolux verbinden: Schritt für Schritt
Du brauchst ein Kontolux-Konto (kostenlos) und Zugriff auf dein Shopify-Konto.
-
Shopify in Kontolux öffnen
Öffne in Kontolux Einstellungen → Integrationen → Shopify und wähle deinen Umsatzsteuersatz.
-
Webhook-URL kopieren
Klicke unter „Schritt 1“ auf Webhook-URL anzeigen und kopiere deine persönliche URL.
-
Webhooks in Shopify anlegen
Öffne im Shopify-Admin Einstellungen → Benachrichtigungen → Webhooks und klicke auf Webhook erstellen. Wähle als Ereignis Order payment, Format JSON, füge die Kontolux-URL ein und speichere. Lege danach einen zweiten Webhook mit dem Ereignis Refund create und derselben URL an.
-
Signaturschlüssel übernehmen
Unter der Webhook-Liste zeigt Shopify den Hinweis „Your webhooks will be signed with …“ und einen Schlüssel. Kopiere ihn, füge ihn in Kontolux unter „Schritt 2“ ein und klicke auf Speichern.
-
Fertig
Das Badge wechselt auf Aktiv. Ab der nächsten bezahlten Bestellung erscheinen Shopify-Belege automatisch im Belegarchiv.
Mehr Details zu allen Plattformen findest du im Hilfe-Artikel Zahlungsanbieter per Webhook verbinden.
Für wen sich die Shopify-Integration lohnt
Online-Shops mit eigenen Produkten
Mode, Kosmetik, Merch oder Handgemachtes — jede bezahlte Bestellung ist sofort gebucht.
Creator & Marken
Drops und Launches mit vielen Bestellungen in kurzer Zeit, ohne CSV-Export am Monatsende.
Shops mit Retouren
Erstattungen werden bei Shopify als eigener Beleg gegengebucht. Prüfe die Buchungen regelmäßig.
Häufige Fragen zur Shopify-Buchhaltung
Wie verbuche ich Shopify-Bestellungen richtig?
Jede bezahlte Bestellung ist eine Betriebseinnahme. Kontolux bucht sie automatisch mit Bestellnummer, Umsatzsteuersatz und Sachkonto. Shopify-Gebühren (Abo, Apps, Transaktionsgebühren) sind Betriebsausgaben — die monatliche Shopify-Rechnung lädst du als normalen Beleg hoch.
Was passiert bei Erstattungen?
Bei jeder Erstattung (Refund create) legt Kontolux einen eigenen Beleg über den tatsächlich zurückgezahlten Betrag an. Die ursprüngliche Bestellung bleibt unverändert, so bleibt nachvollziehbar, was erstattet wurde. Erstattungen ohne Geldfluss, etwa reine Rücksendungen ins Lager, werden nicht gebucht.
Kann ich mehrere Shops verbinden?
Aktuell verbindest du einen Shopify-Shop pro Kontolux-Konto, denn jeder Shop signiert mit seinem eigenen Schlüssel. Du betreibst mehrere Shops? Schreib uns an info@kontolux-ai.de — mehrere Shops pro Konto stehen auf der Liste.
Werden Testbestellungen gebucht?
Testbestellungen, die Shopify als bezahlt meldet (z. B. mit dem Bogus Gateway), würden ebenfalls als Beleg angelegt. Teste deshalb vor dem Verbinden oder lösche Testbelege danach im Belegarchiv.
Warum brauche ich den Signaturschlüssel?
Damit Kontolux prüfen kann, dass eine Nachricht wirklich von deinem Shop kommt und unterwegs nicht verändert wurde. Ohne gültige Signatur bucht Kontolux nichts.
Wird eine Bestellung doppelt gebucht, wenn Shopify den Webhook wiederholt?
Nein. Kontolux merkt sich jede Zustellung und jede Bestellnummer. Wiederholungen werden übersprungen.
Landen Shopify-Einnahmen im DATEV-Export?
Ja. Automatisch angelegte Belege erscheinen wie alle anderen im Belegarchiv, im Monatsabschluss und im DATEV-Buchungsstapel.
Was kostet die Shopify-Integration?
Nichts extra. Alle Integrationen sind in Kontolux AI enthalten, und Kontolux ist in der aktuellen Beta-Phase komplett kostenlos.