Die Integration nutzt das kostenlose Plugin KigoCloud for WooCommerce (über GitHub verteilt). Es überwacht Bestellstatus und sendet automatisch Daten an die Kigo Cloud API, die eine Rechnung oder ein Angebot erstellt, fiskalisiert (falls aktiviert) und R1-Felder für B2B-Kunden unterstützt.

Übersicht

WooCommerce-Bestellungen werden automatisch an Kigo Cloud übertragen und in fiskalisierte Dokumente umgewandelt. Das Plugin aktualisiert sich selbst über GitHub, sodass Sie nach der Erstinstallation keine neuen Versionen manuell herunterladen müssen.

Plugin installieren

Das Plugin wird über GitHub verteilt, nicht über wordpress.org. "Plugins → Installieren → Suche" findet es daher NICHT - laden Sie die Zip einmal manuell hoch, danach aktualisiert es sich selbst.

  1. Laden Sie kigocloud-for-woocommerce.zip von GitHub Releases herunter
  2. Im WordPress-Admin: Plugins → Installieren → Plugin hochladen
  3. Zip auswählen, Jetzt installieren, dann Aktivieren
  4. Im linken WP-Menü erscheint der Eintrag KigoCloud (Wolken-Symbol) - alle Einstellungen sind dort, NICHT unter "WooCommerce → Einstellungen"

Quellcode, Changelog und Fehlermeldungen: github.com/symmetria-doo/kigocloud-for-woocommerce

Connection - API-Zugangsdaten

Die KigoCloud-Adminseite hat 9 Tabs (Connection, Orders, Prices, Price list, R1, Email, Mapping, Logs, About) und einen einzigen Save all settings-Button unten. Der erste Tab ist Connection:

  • API username / password - Ihre Kigo-Cloud-Zugangsdaten (wie Login auf app.kigo.cloud; zum Testen admin_demo / admin_demo)
  • Employee PIN - PIN des Mitarbeiters, der als Dokumentersteller gilt (Standard 1; Liste unter "Mitarbeiter" in Kigo Cloud)

Orders - Zuordnung je Zahlungsart

Der Hauptkonfigurationsbereich. Legen Sie für jedes WooCommerce-Gateway (Stripe, Überweisung, Nachnahme...) fest, was in Kigo erstellt wird (Rechnung oder Angebot) und bei welchem Bestellstatus gesendet wird.

Mit dem Auslöser Order created entsteht das Dokument, sobald die Bestellung zum ersten Mal den Status Wartend, In Bearbeitung oder Abgeschlossen erreicht, auch wenn die Zahlung erst beim zweiten Versuch gelungen ist. Spätere Statusänderungen erzeugen kein neues Dokument. Aus einer Bestellung entsteht ein Dokument.

Sind Steuern in WooCommerce ausgeschaltet, verwendet die Rechnung den MwSt.-Satz, der am Artikel in Kigo Cloud eingetragen ist. Varianten ohne eigene SKU teilen die SKU des Produkts und werden auf der Rechnung zu einer Zeile mit der Gesamtmenge zusammengefasst.

Globale Optionen: Shipping reference (Kigo-Referenz für die Position "Versand", Standard shipping) und Fill empty SKU (hat ein Produkt keine SKU, wird sku-{id} gesendet, damit das Lookup nie fehlschlägt).

Stellen Sie vorab sicher, dass SKUs und Steuersätze in WooCommerce korrekt sind. Mehr als die Hälfte der Integrationsprobleme kommt von falscher USt oder fehlenden/doppelten SKUs.

R1-Rechnungen für B2B

Der Tab R1 ermöglicht R1-Rechnungen für Geschäftskunden (Firmenname und Steuernummer im Checkout), mit Live-Vorschau und "Send test R1 offer"-Button.

Diagnose

Der Tab Logs zeigt die letzten 50 API-Aufrufe mit Ergebnis - das wichtigste Debugging-Werkzeug. Der Tab About zeigt die Plugin-Version und WC/WP/PHP-Erkennung.

Die vollständige Schritt-für-Schritt-Anleitung finden Sie auch in der App: Optionen → Integrationen → WooCommerce-Integration.

Synchronisierung von Artikeln und Bestand *

Auf dem Reiter WooCommerce Sinkronizacija sendet Kigo Cloud Artikel und Bestand an den Shop. Der Shop wird mit seiner Adresse und den API-Schlüsseln aus WooCommerce verbunden.

  • Vollständige Synchronisierung: Name, Beschreibung, Preis, Kategorien, Marke, Varianten und Mengen im Shop werden durch die Daten aus Kigo Cloud ersetzt.
  • Nur Mengen: an den Shop wird nur die Menge gesendet, anhand der Artikelnummer (SKU). Alles andere bleibt, wie es im Shop gepflegt ist.

Wenn Sie einen mit dem Shop verknüpften Artikel mit Im Web sichtbar auf Nein speichern, fragt Kigo Cloud, was im Shop geschehen soll: das Produkt ausblenden, den Bestand auf 0 setzen oder nichts ändern.

* Die Synchronisierung von Artikeln und Bestand ist Teil des Business-Pakets und höherer Pakete.

Buchungs-Plugins (z. B. Amelia)

Buchungs-Plugins wie Amelia, die die Zahlung über WooCommerce abwickeln, benötigen keine separate Integration - jede Buchung wird zu einer WooCommerce-Bestellung, die das Plugin wie jede andere verarbeitet (gleiche Voraussetzungen: zugeordnetes Gateway und saubere SKU/USt).