WooCommerce - Integrationsschritte

Integration im Überblick

Die Integration von Hive in WooCommerce ist nativ und bietet Echtzeit-Updates über Webhooks. Jede Aktualisierung in deinem Shop wird ein paar Sekunden später in der Hive-App angezeigt.

 

Wie man WooCommerce in Hive integriert

Um deinen WooCommerce Shop mit der Hive App zu verbinden, musst du einen neuen "REST API"-Schlüssel in deinem WooCommerce Shop erstellen und die "URL", den "Kundenschlüssel" und das "Kundengeheimnis" mit Hive teilen, indem du ein Ticket in der Hive App auf deiner "Support"-Seite erstellst.
Um einen "REST API"-Schlüssel in deinem WooCommerce zu erstellen, befolge bitte die folgenden Schritte:

1. Navigiere in Woocommerce zur Registerkarte "WooCommerce", suche nach dem Woo-Symbol und wähle "Einstellungen".
2. Navigiere und klicke auf die Registerkarte "Erweitert".
3. Unter "Seite einrichten" findest du den Reiter "REST API".
4. Klick auf "Schlüssel hinzufügen"
5. Füge "Hive Technologies" als Beschreibung hinzu und erteile die Berechtigung "Lesen/Schreiben", dann klicke auf "API-Schlüssel generieren".
6. Bitte kopiere deine "URL", deinen "Verbraucherschlüssel" und dein "Verbrauchergeheimnis" und schicke sie an Hive, indem du ein Ticket in der Hive App auf deiner "Support"-Seite erstellst.

⚠️ Wenn du einen weiteren WooCommerce-Shop integrierst, nachdem wir mit der Bestellabwicklung begonnen haben, informiere bitte den Hive-Kundensupport, damit wir abstimmen können, wann die Bestellabwicklung für diesen zusätzlichen Shop beginnen soll.

So importierst du deinen Katalog in Hive

Damit Hive weiß, welche SKUs von einem Shop synchronisiert und bearbeitet werden sollen, müssen sie den Hive SKUs zugeordnet werden.

Nach der Integration deines WooCommerce werden deine Produkte ein paar Sekunden später über Webhooks in die Hive App importiert. Bitte beginne damit deine Produkte in der Hive App zuzuordnen, sobald sie importiert wurden. So weiß Hive, welche physischen Produkte von den Bestellungen, die von diesem neuen Shop aus synchronisiert werden, versendet werden sollen.

Weitere Informationen darüber, wie du Shop-Produkte den Hive-SKUs zuordnen kannst, findest du hier.

So richtest du die Inventarsynchronisation ein

Hive kann die Bestandsmengen mit deinem WooCommerce synchronisieren. Auf diese Weise hast du einen genauen Überblick über deinen Bestand in WooCommerce und kannst Überverkäufe verhindern. Die Bestandszahlen werden stündlich mit WooCommerce synchronisiert. Die Bestandssynchronisierung wird erst aktiviert, wenn Hive mit der Ausführung deiner Bestellungen begonnen hat. Wenn du diese Funktion nicht aktivieren möchtest, wende dich bitte an den Kundensupport.

• Hinweis: Bestandssynchronisation und Auftragssynchronisation sind nicht miteinander verbunden. Ohne Bestandssynchronisierung werden die Bestellungen weiterhin in Hive eingehen. Die Bestandssynchronisierung dient dazu, die Bestandszahlen an WooCommerce zu übermitteln.
  
  

Wie werden die Tracking-Informationen an WooCommerce übermittelt?

Die Tracking-Informationen der Sendungen werden an WooCommerce übermittelt, sobald die Bestellung in Hive als "versandt" markiert ist. Wenn Hive eine Bestellung im Fulfillment Center ausführt, markieren wir die Bestellung als "abgeschlossen" und übersenden den Namen des Versanddienstleisters, die Tracking-URL und die Tracking-Nummer der Sendung an WooCommerce.

 

Integration Details

1. Aus WooCommerce importierte SKU-Daten

Die folgenden SKU-Felder werden von WooCommerce in Hive importiert:

• Gewicht
• Kosten/Produktionskosten
• Status

Die Produktionskosten sind ein wichtiges Feld, das du in WooCommerce ausfüllen musst. Zusammen mit dem HS-Code und dem Herkunftsland wird es benötigt, um die Zollbehörden beim Versand außerhalb der EU zu passieren. Fehlt eines dieser Felder, wird die Bestellung im Fulfillment Center blockiert, bis du die SKU-Informationen aktualisiert hast.

• Hinweis: Die SKU-Felder "Ursprungsland" und "HS-Code" werden noch nicht von WooCommerce importiert. Wenn du einen Versand außerhalb der EU in Betracht ziehst, fülle sie bitte direkt in der Hive-App aus.
• Hinweis: Derzeit importieren wir das Feld "Barcode" (EAN) nicht aus WooCommerce. Damit wir deine SKUs besser identifizieren können, fülle diese Felder bitte in der Hive App aus.

 

1. Details zur Bestellung und Produktsynchronisation

Bestellungen und Produktaktualisierungen mit der WooCommerce-Integration erfolgen in Echtzeit, da die Verbindung über Webhooks hergestellt wird. 

Dies sind die API-Endpunkte, die wir derzeit verwenden:

GET /wp-json/wc/v3/settings/products/<id>

• Um Produkteinstellungen zu importieren

GET /wp-json/wc/v3

• So testest du, ob die URL und der API-Schlüssel korrekt funktionieren

GET /wp-json/wc/v3/products

• Um Produkte zu importieren

GET /wp-json/wc/v3/products/<product_id>/variations

• Um Variationen eines Produkts zu importieren

POST /wp-json/wc/v3/products/<product_id>/variations/batch

• So aktualisierst du die Bestandsaufnahme

GET /wp-json/wc/v3/orders

• Um Bestellungen zu importieren

GET /wp-json/wc/v3/orders/<id>

• Um eine bestimmte Bestellung zu importieren

PUT /wp-json/wc/v3/orders/<id>

• So aktualisierst du den Bestellstatus

GET /wp-json/wc/v3/orders/<id>/notes

• Um die Bestellnotizen abzurufen

POST /wp-json/wc/v3/orders/<id>/notes

• So erstellst du eine neue Bestellnotiz mit der Trackingnummer/URL

GET /wp-json/wc-shipment-tracking/v3

• Um das Vorhandensein des Plugins für die bezahlte Sendungsverfolgung zu erkennen

GET /wp-json/wc-shipment-tracking/v3/orders/<order_id>/shipment-trackings/

• Um alle Sendungen zu erhalten

POST /wp-json/wc-shipment-tracking/v3/orders/<order_id>/shipment-trackings/

• Um eine neue Sendung zu erstellen

GET /wp-json/wc/v3/webhooks

• So überprüfst du, ob unsere Webhook-URLs registriert sind

POST /wp-json/wc/v3/webhooks/batch

• Um unsere Webhook-URLs zu registrieren, wenn sie fehlen

Auf dieser Seite von WooCommerce findest du weitere Informationen zu den API-Endpunkten, die wir verwenden.

 

1. Können wir FIFO aktivieren?

Wir erhalten Zeit- und Datumsstempel von WooCommerce, die es uns ermöglichen, eine First-in-First-out (FIFO)-Logik für aus WooCommerce importierte Bestellungen anzuwenden.

 

Nicht unterstützte Funktionen

Die Integration unterstützt derzeit die folgenden Funktionen nicht:

• Batch-Übertragung von Tracking-Informationen von Hive zu WooCommerce
• Übertragung von Informationen zur Seriennummernverfolgung von Hive zu WooCommerce
  • Hochladen von Dokumenten von WooCommerce zu Hive für B2B-Bestellungen Du kannst Dokumente alternativ auch manuell in der Hive-App hinzufügen. Alle Schritte werden in dieser FAQ erklärt.
• Ankündigung von Wiederauffüllungslieferungen
• Artikel in WooCommerce als "auf Eis gelegt" markieren
  • Du kannst alternativ die "Bestellaktionen" in der Hive App verwenden, um Bestellungen als "zurückgestellt" zu markieren

 

Anleitung zur Deinstallation

Du kannst unseren API-Schlüssel in deinem WooCommerce widerrufen, um unsere Zusammenarbeit zu beenden. Befolge dazu die folgenden Schritte:

1. Navigiere in Woocommerce zur Registerkarte "WooCommerce", suche nach dem Woo-Symbol und wähle "Einstellungen".
2. Navigiere und klicke auf den Reiter "Erweitert".
3. Unter "Seite einrichten" findest du den Reiter "REST API".
4. Finde den Schlüssel "Hive Technologies".
5. Klick auf "Widerrufen"