Verbindung eines WooCommerce-E-Shops

Anbindung über das Margly-Plugin#

Für WooCommerce haben wir ein offizielles Margly-Plugin im WordPress.org-Katalog. Sie installieren es in Ihrem Adminbereich, klicken auf Mit Margly verbinden und das Plugin erledigt den Rest: Es erstellt Zugangsdaten nur zum Lesen, registriert signierte Webhooks und übergibt sie uns direkt von Server zu Server. Sie kopieren nichts, und keine Schlüssel laufen durch Ihren Browser.

Was Sie brauchen#

• WordPress 6.6 oder neuer und PHP 7.4 oder neuer
• WooCommerce 9.0 oder neuer
• Einen Shop unter HTTPS — über eine unverschlüsselte Verbindung übertragen wir keine Zugangsdaten
• Ein Margly-Konto (eine kostenlose Testphase genügt — Sie legen es beim Verbinden an)

Schritt für Schritt#

1. 1

   Margly-Plugin installieren

   Gehen Sie im WordPress-Adminbereich zu Plugins → Plugin hinzufügen, suchen Sie nach Margly und klicken Sie auf Installieren. Danach aktivieren Sie das Plugin.

2. 2

   WooCommerce → Margly öffnen

   Nach der Aktivierung erscheint im linken Menü unter WooCommerce der Eintrag Margly. Öffnen Sie ihn und klicken Sie auf Mit Margly verbinden.

   In diesem Moment erstellt das Plugin in Ihrem Shop einen API-Schlüssel nur mit Leserecht und registriert die Webhooks. Am Shop wird nichts geändert — der Schlüssel berechtigt Margly nicht zum Schreiben.

3. 3

   Bei Margly anmelden

   Das Plugin leitet Sie zu Margly weiter. Wenn Sie noch kein Konto haben, legen Sie es gleich hier an und die 14-tägige Testphase startet.

4. 4

   Verbindung bestätigen

   Margly zeigt Ihnen, um welchen Shop es geht, und Sie bestätigen mit Shop verbinden. Margly schickt die Bestätigung zurück in Ihr WordPress und startet den ersten Import.

Die ersten Daten sehen Sie in Margly nach wenigen Minuten. Bei großem Katalog und langer Bestellhistorie dauert der erste Import länger — den Fortschritt verfolgen Sie direkt in der App.

Was Margly aus WooCommerce liest#

• Bestellungen — Positionen, Mengen, Preise, Rabatte, Versand, MwSt., Retouren, Zahlungs- und Lieferstatus, Datum
• Produkte — Namen, SKUs, Verkaufspreise, MwSt., Lager, Kategorien, Sichtbarkeit. Varianten behandeln wir als eigenständige Positionen, Sie sehen Margen also pro Variante, nicht nur pro Produkt.
• Kunden — die Daten, die für Kundenrückkehr und den Kundenlebenswert nötig sind

Margly liest ausschließlich — es ändert nie Bestellungen, Produkte, Preise oder Einstellungen Ihres Shops.

Einkaufspreise#

Ohne Einkaufspreise lassen sich keine Margen berechnen, und WooCommerce hat sie nicht als Standardfeld. Margly sucht sie deshalb an drei Stellen, in dieser Reihenfolge:

1. Einkaufspreise direkt in WooCommerce (Funktion „Cost of Goods", WooCommerce 10.3 und neuer)
2. Plugin „Cost of Goods" von SkyVerge, falls Sie es nutzen
3. Der beim Produkt im Katalog gespeicherte Preis, wenn die Bestellung selbst keinen mitbringt

MwSt.#

Die Beträge in Bestellpositionen liefert WooCommerce immer ohne Steuer und die Steuer getrennt, deshalb berechnen wir den Satz jeder Position aus Ihren eigenen Zahlen — wir setzen nie einen Satz nach dem Land ein. Ist eine Bestellung oder Position steuerfrei, speichern wir eine echte Null; bei einem von der MwSt. befreiten Shop einundzwanzig Prozent zu erfinden, würde die gesamte Umsatzberechnung zerstören.

Bestellstatus#

Die Standardstatus von WooCommerce (Zahlung ausstehend, in Bearbeitung, in Wartestellung, abgeschlossen, storniert, rückerstattet, fehlgeschlagen) übersetzt Margly in eigene Status, damit sich Shops verschiedener Plattformen vergleichen lassen. Entwürfe und gelöschte Bestellungen (Papierkorb) speichern wir gar nicht.

Legen Sie sich mit einem Plugin einen eigenen Status an, verwirft Margly ihn nicht — er wird danach eingeordnet, ob die Bestellung bezahlt ist. Eine Bestellung kann also nie stillschweigend aus Ihren Zahlen verschwinden.

Änderungen kommen sofort an#

Das Plugin registriert neun signierte Webhooks — Anlegen, Ändern und Löschen bei Bestellungen, Produkten und Kunden. Eine neue Bestellung ist deshalb binnen Minuten in Margly, nicht erst bei der nächsten geplanten Synchronisation.

Jede Anfrage ist mit einem gemeinsamen Geheimnis signiert, unsignierte weisen wir ab. Zudem schreibt ein Webhook nie die Daten, die er mitbringt — er sagt nur, dass sich etwas geändert hat, und Margly liest die betreffenden Bestellungen oder Produkte erneut aus Ihrem Shop. Ein doppelt oder in falscher Reihenfolge zugestellter Webhook kann Ihre Daten deshalb nicht beschädigen.

Was Margly selbst überwacht#

WooCommerce schaltet einen Webhook nach fünf fehlgeschlagenen Zustellungen selbst ab und nie wieder ein. Margly prüft Ihren Shop deshalb einmal täglich und:

• schaltet Webhooks wieder ein, die WooCommerce abgeschaltet hat,
• vergleicht die Zahl der Bestellungen bei Ihnen und bei uns — und holt Fehlendes nach, wenn sie auseinanderlaufen,
• prüft, ob Bestellungen umnummeriert wurden (manche Plugins ändern Bestellnummern); wenn ja, ordnet Margly sie über eine interne Kennung zu, die sich nie ändert.

Dass davon etwas gelaufen ist, merken Sie nur daran, dass Ihre Zahlen stimmen — eingreifen müssen Sie nicht.

Sicherheit#

• Die Zugangsdaten erstellt das Plugin nur mit Leserecht und übergibt sie von Server zu Server — durch Ihren Browser laufen sie nie.
• Bei uns liegen sie verschlüsselt.
• Webhooks sind signiert; unsignierte Anfragen weisen wir ab.
• Das Plugin fügt Ihrem Shop keinen Frontend-Code hinzu und bremst ihn nicht.

Häufige Probleme#

• „Der Shop muss unter HTTPS laufen" — über eine unverschlüsselte Verbindung übertragen wir keine Zugangsdaten. Richten Sie ein Zertifikat ein und starten Sie die Verbindung erneut.
• „Ihre WooCommerce-Version ist zu alt" — aktualisieren Sie WooCommerce und versuchen Sie es erneut.
• „Der Kopplungslink ist abgelaufen" / „wurde bereits verwendet" — der Link gilt 30 Minuten und nur einmal. Klicken Sie im Adminbereich erneut auf Mit Margly verbinden.
• „Dieser Shop ist bereits mit einem anderen Konto verbunden" — ein Shop lässt sich nicht mit zwei Margly-Konten verbinden. Schreiben Sie an support@margly.io, wir lösen das.
• „Das Konto hat eine andere Plattform verbunden" — Sie sind mit einem Konto angemeldet, das bereits einen anderen Shop verbunden hat. Verbinden Sie den Shop mit einem anderen Konto (die Schaltfläche steht direkt auf der Seite).
• „Die Bestätigung an WordPress ist fehlgeschlagen" — meist liegt es an einer Sicherheitsschicht vor Ihrer Website (Hosting-Schutz, Wordfence und ähnliche Plugins), die unsere Anfrage nicht durchgelassen hat. Prüfen Sie, ob das Plugin aktiv ist, und versuchen Sie es erneut.
• „Die Verbindung zu WooCommerce ist unterbrochen" — Sie haben eine Meldung bekommen, dass Ihr Shop unsere Anfragen nicht mehr annimmt. Fast immer ist es ein Sicherheits-Plugin, das die REST-API blockiert. Margly deaktiviert das Konto in diesem Fall nicht und Ihre Daten bleiben erhalten — sie werden nur vorübergehend nicht aktualisiert. Geben Sie den Zugriff auf die REST-API frei, dann läuft die Synchronisation von selbst wieder an.
• Einkaufspreise fehlen — siehe Abschnitt oben; ohne sie berechnen wir keine Margen.

Trennen und Deinstallieren#

Trennen können Sie auf zwei Wegen, und beide bewirken dasselbe: über die Schaltfläche Trennen auf der Margly-Seite im WordPress-Adminbereich oder durch vollständiges Deinstallieren des Plugins. In beiden Fällen löscht das Plugin den erstellten API-Schlüssel und alle Webhooks und teilt Margly mit, dass die Verbindung beendet ist.

Danach passiert Folgendes:

• Margly holt keine neuen Daten mehr
• Historische Daten sehen Sie in der App weiterhin, sie werden nur nicht aktualisiert
• Ein bezahltes Abo wird auf Ende zum Ablauf des bezahlten Zeitraums gestellt — wir buchen nichts mehr ab
• Es startet eine 30-tägige Frist zur Aufbewahrung der Daten, in der Ihnen Margly Erinnerungen schickt (Tag 3, 7, 14, 21 und 27)

Wenn Sie das Plugin innerhalb von 30 Tagen wieder aktivieren und verbinden, knüpft Margly an Ihr ursprüngliches Konto an und es gehen keine Daten verloren. In den Einstellungen zeigen wir Ihnen währenddessen eine Schaltfläche, die Sie direkt zur Plugin-Verwaltung bringt.

Wie geht es weiter#

• Erster Datenimport — was direkt nach der Verbindung passiert
• Verbindung von Google Ads — Werbe-Rentabilität und ihre Profitabilität
• PDF-Rechnungsimport — Betriebskosten, Logistik und Marketing
• Problembehandlung bei der Verbindung