Guthaben aus dem eigenen Shop übernehmen

Diese Anleitung ist nur für Shops, die per API an Rechnungskit angebunden sind und Empfehlungs- oder Kundenguthaben selbst verwalten. Den Überblick über Gutscheine und Guthaben für alle Shops gibt Geschenkgutscheine und Guthaben.

Manche Shops verwalten Guthaben selbst, etwa eine Prämie für jede erfolgreiche Empfehlung, die der Kunde beim nächsten Einkauf einlöst oder sich auszahlen lässt. Das Guthaben führt dann weiter dein Shop. Dein Shop meldet jede Bewegung an Rechnungskit, oder Rechnungskit liest den Verlauf selbst. Rechnungskit gleicht die Salden ab und übernimmt ab einem Stichtag die Buchungen für deine Steuerkanzlei.

Brauchst du das?

Nur, wenn dein eigener Shop (über die API angebunden) das Guthaben selbst verwaltet.

• Geschenkgutscheine und Guthaben aus Shopify kommen automatisch über die Shopify-Verbindung.
• Mehrzweckgutscheine aus Germanized kommen über die WooCommerce-Verbindung.
• Dafür richtest du hier nichts ein.

Andere Guthaben- oder Empfehlungs-Plugins für WooCommerce oder Shopware erkennt Rechnungskit noch nicht. Nutzt du so ein Plugin, schreib uns an support@rechnungskit.de, bevor du es einsetzt.

So funktioniert es

1. Dein Shop meldet jede Guthaben-Bewegung: Verdienen, Einlösen, Rücknahme, Auszahlung und Verfall. Jede Bewegung trägt eine eindeutige Id, Rechnungskit speichert sie genau einmal.
2. Dazu kommen die Salden je Kunde. Rechnungskit vergleicht sie mit dem Verlauf. Weicht ein Kunde ab, siehst du das unter Gutscheine.
3. Bis zum Stichtag ist das ein Probelauf. Ab dem Stichtag übernimmt Rechnungskit den Verlauf ins Guthabenbuch und bucht ihn im DATEV-Export.

Push oder Pull

Für die Meldung gibt es zwei Wege. Beide landen im selben Verlauf und lassen sich auch kombinieren.

Push ist der empfohlene Weg. Pull lohnt sich, wenn dein Shop Meldungen nicht zuverlässig verschicken kann.

Push über die API (empfohlen)

Dein Shop schickt jede Bewegung an POST /v1/credit-transactions und einmal am Tag die Salden an PUT /v1/credit-balances, mit dem API-Schlüssel aus Verbindungen → API. Aufbau und Beispiele stehen in der API-Referenz.

Einrichten musst du in Rechnungskit dafür nichts. Mit dem ersten Aufruf erscheint unter Gutscheine der Abschnitt „Guthaben aus deinem eigenen Shop“ mit dem Hinweis „Per API (Push)“.

Die Salden sind wichtig: Geht eine Meldung verloren, zeigt erst der Vergleich mit den Salden die Lücke. Schick sie deshalb mindestens einmal am Tag.

Verlauf lesen lassen (Pull)

Hier stellt dein Shop zwei lesende Endpunkte bereit, und Rechnungskit holt sich den Verlauf stündlich selbst ab. Rechnungskit merkt sich, wie weit es gelesen hat, und holt verpasste Bewegungen beim nächsten Lauf nach. Was die Endpunkte deines Shops liefern müssen, steht in der API-Anleitung.

1. Öffne Gutscheine und klicke im Abschnitt „Guthaben aus deinem eigenen Shop“ auf „Einrichten“.
2. Trag die Adresse der Schnittstelle ein, zum Beispiel https://shop.example/api/rk, und das Token.
3. Lass den Stichtag leer. So startest du mit einem Probelauf.
4. Klicke auf „Verbinden und lesen“. Rechnungskit liest den Verlauf sofort und zeigt das Ergebnis.

Probelauf und Abgleich

Ohne Stichtag nimmt Rechnungskit den Verlauf nur auf und bucht nichts. Stimmt der Abgleich, siehst du die Zahl der Kunden mit Guthaben und die Summe. Diese Summe sollte zu dem passen, was dein Shop als offenes Guthaben ausweist.

Wenn ein Kunde abweicht

Rechnungskit listet ihn mit beiden Beträgen auf: Saldo im Shop und Summe des Verlaufs.

• Beim Pull liefert der Shop Vorgänge der letzten Minute erst beim nächsten Lesen. Eine kurze Abweichung direkt nach einer Buchung ist dort normal.
• Bleibt sie, fehlt meist eine Bewegung, oder der Kunde hat im Shop eine andere E-Mail-Adresse als bei seinem Guthaben.

Der Stichtag

Der Stichtag ist der Tag, ab dem Rechnungskit das Guthaben bucht. Bis dahin bucht dein Shop selbst.

Drei Regeln

Damit nichts doppelt oder gar nicht gebucht wird, gilt:

1. Der Stichtag ist immer ein Monatserster, etwa der 1. Oktober.
2. Er darf beim Festlegen nicht in der Vergangenheit liegen. Bis dahin hat dein Shop selbst gebucht, Rechnungskit würde sonst doppelt buchen.
3. Sobald er erreicht ist, lässt er sich nicht mehr ändern.

Den Tag abstimmen

Dein Shop hört am selben Tag auf, das Guthaben selbst zu buchen. Stimm den Tag deshalb mit der Entwicklung deines Shops und mit deiner Steuerkanzlei ab, am besten zu einem Monats- oder Quartalswechsel.

Am Stichtag legt Rechnungskit je Kunde einen Eröffnungssaldo aus dem bisherigen Verlauf an, ohne Buchung.

Welches Datum zählt

Ob ein Vorgang vor oder nach dem Stichtag liegt, entscheidet das Buchungsdatum, das dein Shop mitschickt (hc_booking_date). Fehlt es, zählt das deutsche Datum des Vorgangs. Ein Vorgang um 0:30 Uhr am 1. Oktober gehört also zum Oktober, auch wenn es in UTC noch der 30. September ist.

Was Rechnungskit ab dem Stichtag bucht

Die Konten kommen aus drei Kontenrollen unter Einstellungen → DATEV: „Offene Empfehlungsprämien“, „Aufwand für Empfehlungsprämien“ und „Ertrag aus verfallenem Guthaben“. Bestätige sie dort vor dem Stichtag. Ist eine Rolle, die ein Monat braucht, nicht bestätigt, hält Rechnungskit den DATEV-Export für diesen Monat an und nennt die fehlende Rolle.

Die Kontonummern sind die Vorschläge für ein neues Konto. Deine Steuerkanzlei kann sie unter Einstellungen → DATEV ändern. Für verfallenes Guthaben schlägt Rechnungskit das Konto „Erträge aus der Herabsetzung von Verbindlichkeiten“ vor (SKR04 4932, SKR03 2736).

Was nicht gebucht wird

• Guthaben, das vor dem Stichtag angelegt und erst danach freigegeben wurde, bucht Rechnungskit nicht noch einmal: Dein Shop hat es beim Anlegen gebucht.
• Was das Guthabenbuch nicht decken kann, etwa eine Auszahlung ohne passenden Saldo, wird eine Aufgabe, nie ein negativer Saldo.

Ab dem Stichtag vergleicht der Abgleich den Saldo im Shop mit dem Guthabenbuch. Weicht er ab, erscheint eine Aufgabe.

Guthaben auf der Rechnung

Löst ein Kunde Guthaben beim Einkauf ein, schickt dein Shop den Betrag mit der Bestellung (Feld creditRedemptions). Guthaben ist eine Zahlung, kein Rabatt:

• Die Rechnung weist die Umsatzsteuer auf den vollen Betrag aus und nennt beide Anteile, etwa „PayPal (37,00 €) und Empfehlungsguthaben (12,00 €)“.
• Dein Zahlungsanbieter zieht nur den Rest ein.
• Bezahlt ein Kunde komplett mit Guthaben, stellt Rechnungskit die Rechnung ohne Zahlungseingang aus.

Den Umsatz bucht die Rechnung. Die Einlösung selbst gleicht ab dem Stichtag die Verbindlichkeit gegen den Debitor aus, wie in der Tabelle oben. Aus dem Guthabenbuch nimmt Rechnungskit die Einlösung erst für Bestellungen ab dem Stichtag. Frühere Einlösungen hat dein Shop selbst gebucht.