WooCommerce-Integration¶
Die WooCommerce-Integration ermöglicht es Ihnen, Ihren WooCommerce-Online-Shop mit Gem Logic zu verbinden. Nach der Verbindung können Sie Produkte von Gem Logic zu Ihrem WooCommerce-Shop übertragen und Bestellungen von WooCommerce in Gem Logic abrufen. Dies hält Ihren Produktkatalog und Ihre Auftragsverwaltung über beide Plattformen hinweg synchron.
Konfiguration¶
API-Schlüssel in WooCommerce generieren¶
Bevor Sie WooCommerce mit Gem Logic verbinden, müssen Sie API-Schlüssel in Ihrem WooCommerce-Shop generieren.
Melden Sie sich bei Ihrem WordPress-Admin-Panel an.
Navigieren Sie zu .
Klicken Sie auf Schlüssel hinzufügen.
Füllen Sie die Details aus:
Beschreibung: Geben Sie einen Namen ein, um diesen Schlüssel zu identifizieren (z. B.
Gem Logic Integration).Benutzer: Wählen Sie den WordPress-Benutzer aus, der für die API-Verbindung verwendet wird.
Berechtigungen: Wählen Sie Lesen/Schreiben. Dies ist erforderlich, damit Gem Logic sowohl Bestellungen lesen als auch Produkte in Ihrem Shop erstellen/aktualisieren kann.
Klicken Sie auf API-Schlüssel generieren.
Kopieren Sie den Verbraucherschlüssel und das Verbrauchergeheimnis. Diese werden nur einmal angezeigt, stellen Sie daher sicher, dass Sie sie an einem sicheren Ort speichern.
Wichtig
Das Verbrauchergeheimnis wird nur einmal angezeigt. Wenn Sie es verlieren, müssen Sie den Schlüssel widerrufen und einen neuen generieren.
WooCommerce mit Gem Logic verbinden¶
Gehen Sie in Gem Logic zu .
Öffnen Sie den Vertriebskanal, den Sie mit WooCommerce verbinden möchten, oder erstellen Sie einen neuen.
Aktivieren Sie das Kontrollkästchen WooCommerce.
Füllen Sie die folgenden Felder aus:
URL: Die vollständige URL Ihres WooCommerce-Shops (z. B.
https://www.ihrshop.com). Fügen Sie keinen abschließenden Schrägstrich hinzu.WooCommerce-Schlüssel: Fügen Sie den zuvor generierten Verbraucherschlüssel ein.
WooCommerce-Geheimnis: Fügen Sie das zuvor generierte Verbrauchergeheimnis ein.
Wenn Sie das Plugin Perfect WooCommerce Brands in Ihrem WooCommerce-Shop verwenden, aktivieren Sie das Kontrollkästchen WooCommerce brands plugin. Dadurch kann Gem Logic Produktmarken mit WooCommerce synchronisieren.
Speichern Sie den Vertriebskanal.
Tipp
Stellen Sie sicher, dass Ihr WooCommerce-Shop HTTPS verwendet. Die API-Zugangsdaten werden verschlüsselt und sicher in Gem Logic gespeichert.
Produkte dem Vertriebskanal zuweisen¶
Damit Produkte an WooCommerce übertragen werden, müssen sie dem WooCommerce-Vertriebskanal zugewiesen werden.
Gehen Sie zu .
Öffnen Sie ein Produkt und gehen Sie zu dessen Bereich Vertriebskanäle.
Fügen Sie den WooCommerce-Vertriebskanal zum Produkt hinzu.
Stellen Sie sicher, dass für das Produkt eine Preisregel für diesen Vertriebskanal konfiguriert ist, damit es bei der Übertragung an WooCommerce einen Preis hat.
Produkte übertragen¶
Sie können Produkte von Gem Logic an Ihren WooCommerce-Shop übertragen. Dabei werden Produkte in WooCommerce basierend auf den Daten in Gem Logic erstellt oder aktualisiert.
Ein einzelnes Produkt übertragen¶
Um ein einzelnes Produkt zu übertragen, öffnen Sie das Produkt in Gem Logic und verwenden Sie die Übertragungsaktion im Bereich Vertriebskanäle des Produkts. Das Produkt wird in WooCommerce erstellt, falls es noch nicht existiert, oder aktualisiert, falls es bereits eine WooCommerce-ID besitzt.
Alle Produkte übertragen¶
Um alle einem WooCommerce-Vertriebskanal zugewiesenen Produkte auf einmal zu übertragen:
Gehen Sie zu .
Öffnen Sie den WooCommerce-Vertriebskanal.
Klicken Sie auf Alle Produkte zu WooCommerce senden.
Dies wird als Hintergrundaufgabe ausgeführt. Sie können den Fortschritt auf der Seite Abrufverlauf verfolgen.
Was gesendet wird¶
Wenn ein Produkt zu WooCommerce gesendet wird, werden die folgenden Daten synchronisiert:
Artikelnr. (wird verwendet, um Produkte zwischen den beiden Systemen abzugleichen)
Name und Beschreibung (basierend auf der Sprache des Vertriebskanals)
Regulärer Preis und Aktionspreis (aus der Preisregel für diesen Vertriebskanal)
Bilder (nur bei Änderungen erneut hochgeladen)
Kategorien und Kollektionen (werden in WooCommerce erstellt, falls sie nicht vorhanden sind)
Attribute (werden als globale WooCommerce-Attribute erstellt)
Tags
Bestandsmenge
Marken (falls das WooCommerce-Brands-Plugin aktiviert ist)
Produkttyp: einfach oder variabel (mit Varianten)
Variable Produkte und Varianten¶
Wenn ein Produkt in Gem Logic als Elternprodukt markiert ist, wird es als variables Produkt zu WooCommerce gesendet. Alle untergeordneten Produkte (Varianten) werden als Produktvariationen gesendet. Jede Variante enthält ihren eigenen Preis, Artikelnr., Bild und Attributwerte (z. B. Größe, Farbe).
Produktdeaktivierung¶
Sie können ein Produkt in WooCommerce von Gem Logic aus deaktivieren. Dadurch wird der Produktstatus in WooCommerce auf Entwurf gesetzt, sodass es im Shop nicht mehr sichtbar ist, ohne es zu löschen.
Sendeverlauf¶
Jeder Sendevorgang wird protokolliert. Sie können den Sendeverlauf auf der Detailseite des Vertriebskanals einsehen. Jeder Verlaufseintrag zeigt:
Start- und Endzeit
Status (gestartet, abgeschlossen, fehlgeschlagen oder teilweise erfolgreich)
Gesamtzahl der Produkte, erfolgreiche und fehlgeschlagene Anzahl
Erfolgsquote und Dauer
Detaillierte Ergebnisse pro Produkt (klicken Sie auf Details anzeigen, um zu sehen, welche Produkte erfolgreich waren oder fehlgeschlagen sind)
Produkte abrufen¶
Sie können Produkte aus Ihrem WooCommerce-Shop in Gem Logic abrufen. Dies ist besonders nützlich für den ersten Import, wenn Sie Ihren Shop zum ersten Mal verbinden.
Gehen Sie zu .
Öffnen Sie den WooCommerce-Vertriebskanal.
Klicken Sie auf Produkte von WooCommerce abrufen.
Dies wird als Hintergrundaufgabe ausgeführt und importiert die folgenden Daten für jedes Produkt:
Artikelnr., Name und Beschreibung
Regulärer Preis und Aktionspreis
Kategorien und Marken
Bilder (heruntergeladen und in Gem Logic gespeichert)
Tags
Lagermengen
Attribute und Metalle
Produktvarianten (für variable Produkte)
Bemerkung
Produkte, die bereits in Gem Logic vorhanden sind (abgeglichen über WooCommerce-ID oder Artikelnr.), werden beim Import übersprungen. Es werden nur neue Produkte erstellt.
Bestellungen abrufen¶
Sie können abgeschlossene Bestellungen aus WooCommerce in Gem Logic abrufen.
Bestellungen manuell abrufen¶
Gehen Sie zu .
Öffnen Sie den WooCommerce-Vertriebskanal.
Klicken Sie auf Bestellungen aus WooCommerce abrufen.
Dies läuft als Hintergrundaufgabe. Sie werden zur Seite Abrufverlauf weitergeleitet, wo Sie den Fortschritt in Echtzeit verfolgen können.
Automatischer Bestellabruf¶
Bestellungen können auch automatisch nach einem Zeitplan über das Hintergrundaufgaben-System abgerufen werden. Dies stellt sicher, dass neue abgeschlossene Bestellungen regelmäßig ohne manuelle Aktion importiert werden.
Was importiert wird¶
Wenn Bestellungen aus WooCommerce abgerufen werden, werden folgende Daten importiert:
Bestellschlüssel (wird als eindeutige Bestellkennung verwendet)
Kundenkontaktinformationen (Name, Adresse, E-Mail, Telefon) — ein Kontakt wird im CRM erstellt oder aktualisiert
Bestelldatum und Währung
Bestellpositionen: jede Bestellposition enthält das Produkt (abgeglichen über WooCommerce-ID oder Artikelnr.), Menge, Preise (exkl. und inkl. MwSt.) und MwSt.-Satz
Lagerabzug: der Lagerbestand wird automatisch für jede Bestellposition abgezogen
Bemerkung
Es werden nur Bestellungen mit dem Status abgeschlossen importiert. Bestellungen mit anderen Status (z. B. in Bearbeitung, wartend, ausstehend) werden übersprungen.
Bemerkung
Bestellungen, die bereits importiert wurden (abgeglichen über Bestellschlüssel), werden übersprungen, um Duplikate zu vermeiden.
Abrufverlauf¶
Jeder Abrufvorgang wird protokolliert. Sie können den Abrufverlauf über die Detailseite des Vertriebskanals einsehen. Jeder Verlaufseintrag zeigt:
Start- und Endzeit
Status (gestartet, abgeschlossen, fehlgeschlagen oder teilweise erfolgreich)
Gesamtzahl der verarbeiteten Bestellungen, neu erstellte Bestellungen, übersprungene und fehlgeschlagene Bestellungen
Dauer und eventuelle Fehlermeldungen