WooHS Dokumentation

1.Erste Schritte

In drei Schritten von der Installation bis zum ersten automatischen Produktimport.

Voraussetzungen

Ablauf

1. 1
   Plugin installieren & aktivierenWooHS wie gewohnt in WordPress hochladen und aktivieren.
2. 2
   Mit HS Soft verbindenUnter WooCommerce → Einstellungen → WooHS → Allgemein den API-Schlüssel hinterlegen.
3. 3
   Import konfigurieren & startenMarketing-Gruppen auswählen, Filter setzen und den ersten Import manuell oder automatisch starten.

2.Einrichtung im Detail

Alle Optionen unter WooCommerce → Einstellungen → WooHS → Allgemein.

3.Produkte importieren

Der Import läuft unter WooCommerce → Einstellungen → WooHS → Import in vier Phasen ab: Laden → Konfigurieren → Vorbereiten → Importieren.

Ablauf im Import-Bildschirm

1. 1
   LadenProdukte werden batchweise von HS Soft abgerufen (Fortschrittsanzeige).
2. 2
   KonfigurierenMarketing-Gruppen (Kategorien) auswählen, Bildpflicht ein-/ausschalten, optional «Force Import» aktivieren.
3. 3
   VorbereitenJedes geladene Produkt wird gegen die Filter geprüft und als «vorbereitet» oder «übersprungen» markiert.
4. 4
   ImportierenManuell per Klick oder automatisch zur konfigurierten Uhrzeit («Zeitplan» statt «Start»).

Filteroptionen

Bildanforderungen

Bilder werden per HTTP(S)-URL von HS Soft geladen und als PNG in der WordPress-Mediathek gespeichert (Dateiname product-{sku}.png). Nur http/https-Quellen werden akzeptiert. Schlägt der Bild-Download fehl, entscheidet die Einstellung «Require image successful import» (Erweitert-Tab, Standard: aktiviert) darüber, ob der gesamte Produktimport abgebrochen oder das Produkt ohne neues Bild importiert wird.

Status-Verhalten

• Ein Produkt wird übersprungen, wenn sich Version und Verfügbarkeitszeiträume seit dem letzten Import nicht geändert haben – ausser bei aktivem «Force Import».
• Manuell gepflegte WooCommerce-Kategorien bleiben erhalten; nur vom Plugin importierte Kategorien werden bei jedem Lauf ersetzt.
• Nach einem vollständigen Importlauf werden Produkte, die diesmal nicht mehr geladen wurden, automatisch auf Entwurf gesetzt – ausser «Check for old products» (Erweitert) ist deaktiviert oder «Force Preserving Product Status» ist aktiv.
• Fehlgeschlagene Produkte werden automatisch erneut versucht; bleiben sie fehlerhaft, erhältst du eine Benachrichtigungs-E-Mail (siehe Abschnitt 9).

4.Bestellungen übermitteln

Bestellungen werden automatisch an HS Soft übermittelt, sobald sie einen definierten Status erreichen.

Wie es funktioniert

• Unter Export → Bestellstatus für Export legst du fest, bei welchem WooCommerce-Bestellstatus exportiert wird (Standard: In Bearbeitung).
• Jede Bestellung wird nur einmal übermittelt – ein erneuter Statuswechsel löst keinen doppelten Export aus.
• Schlägt die Übermittlung fehl, wird nach 5 Minuten automatisch ein zweiter Versuch unternommen. Scheitert auch dieser, erhältst du eine Benachrichtigung per E-Mail.
• Über die Bestellaktion «Force HS Soft sync» auf der Bestellseite kannst du jede Bestellung jederzeit manuell (erneut) übermitteln.
• Die Bestellliste zeigt eine zusätzliche Spalte «API sync» mit dem Status «Not synced», «ERROR» oder der HS-Soft-Bestellnummer.

Übermittelte Daten

Rechnungs- und Lieferadresse, Kundennotiz, Zahlungsart, Versand- und Rabattbeträge sowie eine Produktliste (SKU, Menge, Preis). Sonderzeichen/Emojis werden vor dem Versand automatisch entfernt, da die HS-Soft-API diese nicht verarbeiten kann.

Liefertermin & Versand

Bestellkommentar & Shortcodes

Der an HS Soft übermittelte Kommentartext lässt sich unter Export frei gestalten und unterstützt folgende Shortcodes:

5.Verfügbarkeit steuern

WooHS bietet zwei zusammenspielende Mechanismen, um die Lieferbarkeit deiner Produkte im Shop korrekt abzubilden.

A) Produktbezogene Verfügbarkeit

Für jedes importierte Produkt werden die Wochentags-Verfügbarkeit sowie individuelle Verfügbarkeitszeiträume aus HS Soft übernommen. Mit dem Shortcode [woohs_availability] (bzw. [woohs_product_availability] für die produktgebundene Variante) zeigst du eine Wochentagsübersicht im Shop an.

Ist die Option «Availability» aktiviert (global oder pro Produkt), wird beim Checkout geprüft, ob das gewählte Lieferdatum (z. B. via YITH Delivery Date) mit der Verfügbarkeit des Produkts übereinstimmt. Passt es nicht, wird der Checkout mit einer klaren Fehlermeldung blockiert.

Zusätzlich lässt sich pro Produkt (oder Variation) ein individueller, vom WaWi unabhängiger Verfügbarkeitszeitraum hinterlegen – optional jährlich wiederkehrend.

B) Delivery Visibility (automatische Sichtbarkeit)

Ist die Option «Delivery visibility auto update» aktiv, prüft ein täglicher Cronjob um 03:00 Uhr alle betroffenen Produkte automatisch neu – ganz ohne erneuten Abruf bei HS Soft. Jede automatische Statusänderung wird protokolliert.

6.Produkt-Shortcodes

Alle Shortcodes lassen sich unter WooCommerce → Einstellungen → WooHS → Shortcodes live an einem echten Produkt vorschauen. Produktbezogene Shortcodes wirken automatisch auf der aktuellen Produktseite oder mit dem Attribut id="123" auch ausserhalb.

Produktinformationen

Nährwerte & Eigenschaften

Verfügbarkeit

7.Einstellungen im Überblick

Kurzreferenz aller Einstellungs-Tabs (Details zu Allgemein und Export siehe Abschnitte 2 und 4).

Erweitert

Logs

Tägliche Logdateien lassen sich im Tab «Logs» nach Datum durchsuchen – hilfreich für die Fehlersuche bei Import- oder Exportproblemen. Die Dateien sind serverseitig zusätzlich gegen direkten Zugriff abgesichert (nicht erratbarer Dateiname plus Serverkonfiguration).

8.Kompatible Plugins

WooHS erkennt folgende Plugins automatisch und erweitert deren Funktionalität um die WaWi-Anbindung.

9.Fehlerbehebung & FAQ

Die häufigsten Fehlermeldungen und was dahintersteckt.

Häufige Fragen

10.Entwickler-Referenz

WooHS stellt dokumentierte Filter und Actions bereit, um Datenfluss und Verhalten gezielt anzupassen – ohne den Plugin-Core zu verändern. Für Entwickler:innen

add_filter('woohs_hssoft_order_save_data', 'updateOrderDate', 10, 2);

function updateOrderDate(array $orderData, array $order): array
{
    $wcOrder = wc_get_order($order['id']);
    $customDeliveryDate = $wcOrder->get_meta('my_custom_delivery_date');

    if (empty($customDeliveryDate)) {
        return $orderData;
    }

    // Format ist zwingend Y-m-d
    $orderData['date'] = gmdate('Y-m-d', strtotime($customDeliveryDate));

    return $orderData;
}

Filter

Actions