Zum Inhalt springen
Rechnungskit

WooCommerce verbinden

Aktualisiert am

WooCommerce wird ohne Plugin angebunden: eine schlanke REST-API-Verbindung liefert die Bestelldaten, die gesamte Rechnungslogik läuft außerhalb deines Shops.

Einrichtung

  1. In WooCommerce: Einstellungen → Erweitert → REST-API, neuen Schlüssel mit Berechtigung Lesen/Schreiben anlegen. Schreibzugriff braucht Rechnungskit nur, um die Webhooks für dich einzurichten.
  2. In Rechnungskit unter Einstellungen → Verbinden: Shop-URL (https://dein-shop.de), Consumer Key (ck_...) und Consumer Secret (cs_...) eintragen. Die Shop-URL muss die endgültige Adresse sein (mit oder ohne www, so wie der Shop tatsächlich antwortet); Weiterleitungen folgt Rechnungskit nicht und meldet das beim Verbinden.
  3. Rechnungskit prüft die Zugangsdaten, legt die Webhooks automatisch an und signiert sie. Du musst in WooCommerce nichts weiter konfigurieren.

Was automatisch passiert

  • Neue und geänderte Bestellungen kommen per signiertem Webhook an, Erstattungen und der Versandstatus (Bestellung „Fertiggestellt") reiten auf denselben Ereignissen.
  • Ein 4-stündlicher Abgleich holt nach, was ein Webhook verpasst haben könnte: alle in den letzten 24 Stunden geänderten Bestellungen, vollständig seitenweise, auch bei hunderten Bestellungen am Tag.
  • Auf der Seite Bestellungen startet „Jetzt synchronisieren" zusätzlich einen Abgleich der letzten 7 Tage im Hintergrund, etwa nach einer Störung oder direkt nach der Einrichtung.
  • Bleibt der Webhook still, hilft sich Rechnungskit selbst: Der Abgleich reaktiviert pausierte oder deaktivierte Rechnungskit-Webhooks im Shop über die REST-API (und legt fehlende neu an), holt Bestellungen solange alle 15 Minuten statt alle 4 Stunden ab und lädt eine Bestellung sofort einzeln nach, sobald eine Zahlung sie referenziert, aber die Bestellung noch fehlt. Die Aufgabe „Webhook-Verbindung still" bleibt nur stehen, wenn das alles nicht greift; dann in WooCommerce unter Status → Logs (Quelle „webhooks-delivery") nachsehen oder neu verbinden.
  • Produkte werden aus den Bestellpositionen übernommen und unter Einstellungen → Produkte gepflegt.
  • Erstattungen erzeugen automatisch die Stornorechnung.
  • Bestehende Belege aus einem alten PDF-Plugin bleiben unberührt, dein Nummernkreis läuft lückenlos weiter.

Vorkasse mit WooCommerce

Vorkasse funktioniert vollständig: Die Bestellung wartet („In Wartestellung"), du markierst sie nach Zahlungseingang im Shop als bezahlt („In Bearbeitung"), erst dann entsteht die Rechnung. Dein Shop bleibt die Quelle der Wahrheit für den Zahlungseingang, Rechnungskit gleicht kein Bankkonto ab. Die Zuordnung der Zahlart läuft über den exakten Gateway-Namen aus dem Shop (siehe zahlarten-rechnungskauf-vorkasse).

Post-Purchase-Upsells (FunnelKit, CartFlows)

Hängt ein Upsell-Plugin nach dem Checkout Artikel an die bestehende Bestellung und zieht dafür eine zweite Zahlung ein, entsteht automatisch eine Nachtragsrechnung über genau die neuen Artikel. Die erste Rechnung bleibt unverändert archiviert (siehe upsell-nachtragsrechnung).

Grenzen, ehrlich benannt

  • Der API-Schlüssel braucht Lesen/Schreiben. Mit einem Nur-Lesen-Schlüssel schlägt die Verbindung beim Anlegen der Webhooks bewusst fehl, statt still ohne Webhooks zu laufen.
  • Produkt-Webhooks gibt es nicht. Der Katalog wird beim Verbinden importiert, danach einmal täglich automatisch und jederzeit über „Produkte synchronisieren" auf der Produkte-Seite aktualisiert. Namen und Kategorien pflegst du in Rechnungskit.
  • Wurde ein Produkt schon verkauft, bevor es im Katalog ankam (Quelle „Shop" ohne Artikel-ID), verknüpft der nächste Produkt-Abgleich es anhand der Artikelnummer (SKU) mit dem WooCommerce-Produkt. Deine Kategorie und Namen bleiben dabei erhalten.
  • WooCommerce Subscriptions wird unterstützt, jede wiederkehrende Zahlung erzeugt eine eigene Rechnung mit korrektem Leistungszeitraum.

Wo in der App

  • /settings/connect, WooCommerce verbinden und Gateway-Zuordnung
  • /settings/products, Produkte und USt-Kategorien prüfen
  • /orders, Bestellungen mit Status und Rechnungsbezug

Versandsteuer

Rechnungskit setzt den Versand auf den Steuersatz der Ware, auch wenn der Shop pauschal 19 % meldet. Bei gemischten Warenkörben wird nach Brutto-Warenwert aufgeteilt; Details und die Einstellung je Shop-Verbindung stehen unter Recht und Grundlagen sowie in der Belegregeln-Karte „Versandsteuer“.

de