wooms AI - KI-gestütztes WMS für Shopify & E-Commerce

API & Webhooks

Vollständige Dokumentation aller Schnittstellen — von der ersten Anbindung bis zum Live-Betrieb.

Webhooks

REST-API

Vollzugriff auf alle Objekte. Für eigene Integrationen und Sonderfälle.

JSONBearer Authv1

Webhooks

Request-Header

Jede Webhook-Anfrage enthält die folgenden Header:

http

X-Webhook-Secret: your-secret-token
Content-Type: application/json

Der Header X-Webhook-Secret enthält ein HMAC/SHA256-Digest des Request-Body mit deinem Webhook-Passwort. Prüfe diese Signatur, bevor du den Webhook verarbeitest.

Event-Typen

Unterstützte Ereignisse

Produkt-Events

Event	Beschreibung	Trigger
`product.created`	Neues Produkt im Bestand	Wenn ein Produkt neu angelegt wird
`product.updated`	Produkt wurde aktualisiert	Wenn Bestand, Name oder Daten sich ändern
`product.deleted`	Produkt wurde gelöscht	Wenn ein Produkt entfernt wird

Auftrags-Events

Event	Beschreibung	Trigger
`order.created`	Neuer Auftrag eingegangen	Wenn ein Auftrag im System landet
`order.updated`	Auftragsstatus geändert	Wenn sich Status, Tracking etc. ändern

Artikel-Events

Event	Beschreibung	Trigger
`article.stored`	Artikel eingelagert	Wenn Ware ins Lager kommt

Payload-Struktur

JSON Payload

Order Event

json

{
  "event": "order.created",
  "timestamp": "2026-02-03T14:25:00Z",
  "data": {
    "id": 67890,
    "order_number": "ORD-067890",
    "status": "pending",
    "total": 99.99,
    "currency": "USD",
    "customer_id": 1,
    "items": [
      {
        "product_id": 1,
        "name": "Sample Product",
        "quantity": 2,
        "price": 49.99
      }
    ],
    "created_at": "2026-02-03T14:25:00Z",
    "updated_at": "2026-02-03T14:25:00Z"
  }
}

Article Event

json

{
  "event": "article.stored",
  "timestamp": "2026-02-03T11:00:00Z",
  "data": [
    {
      "product": {
        "id": 12345,
        "sku": "PROD-001",
        "name": "Sample Product",
        "price": 29.99,
        "stock": 100
      },
      "total_stored": 5,
      "total_fulfillable": 5
    }
  ],
  "metadata": {
    "source": "wooms",
    "version": "1.0",
    "database": "wooms_yourtenant"
  }
}

Wichtige Hinweise zur Zustellung:

Dein Endpoint muss innerhalb von 10 Sekunden mit HTTP 2xx antworten.
Bei Fehlern wiederholt wooms die Zustellung automatisch.
Bei dauerhaftem Ausfall wird der Endpoint pausiert.

REST-API

Die wooms REST-API bietet vollständigen programmatischen Zugriff auf alle Objekte im System. Alle Anfragen und Antworten verwenden JSON.

Verbindung

Base URL & Authentifizierung

Base URLhttps://yoursubdomain.wooms.io/api/v1/

AuthAuthorization: Bearer YOUR_API_KEY

Den API-Key findest du in deinem wooms Dashboard unter Einstellungen → API. Keys sind pro Mandant getrennt.

HTTP Status

Status Codes

200OK

201Created

282Order already exists

422Unprocessable Entity

481Order not in planning

484Order not found

488Unknown order status

5xxServer Error

Endpunkte

Orders

Products

Purchase Orders

Misc

Fragen zur Integration?

Unser Team hilft dir beim Setup — egal ob Webhook-Anbindung oder eigene API-Integration.

Termin buchen →support@wooms.io

API & Webhooks

Vollständige Dokumentation aller Schnittstellen — von der ersten Anbindung bis zum Live-Betrieb.

Webhooks

REST-API

Vollzugriff auf alle Objekte. Für eigene Integrationen und Sonderfälle.

JSONBearer Authv1

Event

Beschreibung

Trigger

product.created

Neues Produkt im Bestand

Wenn ein Produkt neu angelegt wird

product.updated

Produkt wurde aktualisiert

Wenn Bestand, Name oder Daten sich ändern

product.deleted

Produkt wurde gelöscht

Wenn ein Produkt entfernt wird

Event

Beschreibung

Trigger

order.created

Neuer Auftrag eingegangen

Wenn ein Auftrag im System landet

order.updated

Auftragsstatus geändert

Wenn sich Status, Tracking etc. ändern

Event

Beschreibung

Trigger

article.stored

Artikel eingelagert

Wenn Ware ins Lager kommt

{ "event": "order.created", "timestamp": "2026-02-03T14:25:00Z", "data": { "id": 67890, "order_number": "ORD-067890", "status": "pending", "total": 99.99, "currency": "USD", "customer_id": 1, "items": [ { "product_id": 1, "name": "Sample Product", "quantity": 2, "price": 49.99 } ], "created_at": "2026-02-03T14:25:00Z", "updated_at": "2026-02-03T14:25:00Z" } }

{ "event": "article.stored", "timestamp": "2026-02-03T11:00:00Z", "data": [ { "product": { "id": 12345, "sku": "PROD-001", "name": "Sample Product", "price": 29.99, "stock": 100 }, "total_stored": 5, "total_fulfillable": 5 } ], "metadata": { "source": "wooms", "version": "1.0", "database": "wooms_yourtenant" } }