WooCommerce- und Sellsy-Webhooks

Wozu dienen Webhooks?

Webhooks ermöglichen es Order Invoicer, sofort benachrichtigt zu werden, wenn ein Ereignis eintritt (neue Bestellung, Produktaktualisierung, in Sellsy bezahlte Rechnung usw.). Sie ergänzen die bereits vorhandenen periodischen Synchronisierungen (geplante Aufgaben).

Ohne funktionierende Webhooks kann es länger dauern, bis manche Aktionen berücksichtigt werden.

---

WooCommerce

Was für Sie konfiguriert wird

Wenn Sie die Verbindung zu Ihrem Shop speichern (URL + WooCommerce-API-Schlüssel), erstellt oder aktualisiert Order Invoicer automatisch die erforderlichen Webhooks auf Ihrer Website.

Die folgenden Topics werden verwendet:

• Orders: Erstellung, Aktualisierung, Löschung
• Products: Erstellung, Aktualisierung, Löschung

Jeder Webhook verweist auf eine von Order Invoicer verwaltete Delivery-URL (ein sicheres Gateway). Sie müssen sie nicht manuell kopieren.

Andere Plugins oder Tools

Wenn Sie bereits WooCommerce-Webhooks für dasselbe Topic haben, die jedoch auf eine andere URL verweisen (ein anderes Tool, Zapier usw.), löscht Order Invoicer diese nicht. Nur die Order Invoicer-Webhooks (mit derselben Delivery-URL wie unserer) werden bei den automatischen Überprüfungen repariert oder dedupliziert.

Überprüfen, ob alles in Ordnung ist

1. Öffnen Sie in Order Invoicer Ihren Connector
2. Gehen Sie zu Einstellungen (oder Setup)
3. Der Reiter für Ihren Shop (E-Commerce)
4. Überprüfen Sie den Abschnitt Webhooks: Jedes Topic sollte den Status OK haben

Dort sehen Sie außerdem die fehlenden, inaktiven Topics oder solche mit einer falschen URL (eine andere Integration auf demselben Topic).

WooCommerce: leeres Zustellungsprotokoll

In WooCommerce zeigt der Bildschirm Webhooks → Delivery log (oder ein entsprechender) erst nach dem Versand eines Ereignisses einen Eintrag an. Wenn Sie die Webhooks gerade erst installiert haben und sich keine Bestellung oder kein Produkt geändert hat, bleibt das Protokoll möglicherweise leer: Das ist normal.

Zum Testen: Erstellen oder aktualisieren Sie eine Bestellung / ein Produkt und überprüfen Sie es dann erneut.

WooCommerce-Fehlerbehebung

• WordPress-Permalinks: Verwenden Sie eine andere Struktur als „Einfach", wenn die REST-API oder die Webhooks fehlschlagen.
• Sicherheits-Plugins / Firewalls: Sie blockieren möglicherweise eingehende Aufrufe; fügen Sie bei Bedarf eine Ausnahme hinzu.
• Die Shop-URL in Order Invoicer: Sie muss mit dem Shop übereinstimmen (einschließlich eines Unterordners https://site.com/boutique, falls Sie diese Konfiguration verwenden). Eine Nichtübereinstimmung von http / https wird normalerweise behandelt, aber die gespeicherte URL muss die korrekte bleiben.
• Im Zweifelsfall fasst der Abschnitt Webhooks auf der Connector-Seite den tatsächlichen Zustand auf der API-Seite zusammen.

---

Sellsy

Was für Sie konfiguriert wird

Wenn Sie Sellsy verbinden (OAuth) auf einem Connector, registriert Order Invoicer einen Webhook auf Ihrem Sellsy-Konto: einen einzigen Eintrag pro Konto, der auf dieselbe sichere Infrastruktur wie bei WooCommerce verweist.

Die Ereignistypen (Rechnung, Angebot, Artikel, Zahlung usw.) folgen der von Order Invoicer vorgesehenen Konfiguration. Sie müssen nicht jedes Kästchen in Sellsy manuell ankreuzen, wenn Sie unseren Installationsablauf durchlaufen.

Überprüfen, ob alles in Ordnung ist

1. Öffnen Sie den Connector
2. Einstellungen / Setup
3. Der Reiter Rechnungsstellung (Sellsy)
4. Der Abschnitt Webhooks: Sie können sehen, ob der Webhook vorhanden und aktiv ist und ob jedes erforderliche Ereignis konform ist.

Fehler auf der Sellsy-Seite

Wenn keine Ereignisse mehr gesendet werden oder wenn die Anwendung ein Authentifizierungsproblem beim Webhook meldet:

• Verbinden Sie Sellsy erneut (OAuth) aus Order Invoicer, um die Zugriffstoken zu erneuern.
• Stellen Sie sicher, dass der verbundene Benutzer über die entsprechenden Rechte in Sellsy verfügt (ein Administrator wird empfohlen).

---

Benötigen Sie Hilfe?

Für einen WooCommerce + Sellsy-Connector lesen Sie auch die Übersichtsdokumentation.
Kontakt: contact@orderinvoicer.com.