Cron-Jobs

Cron-Jobs sind automatische Hintergrund-Aufgaben, die in regelmäßigen Abständen ausgeführt werden. Sie sorgen dafür, dass Bestellungen importiert, Bestände synchronisiert und alte Daten bereinigt werden — ohne dass jemand manuell etwas auslösen muss.

Voraussetzungen

Bevor du Cron-Jobs einrichten kannst, brauchst du:

1. Ein laufendes WMS — erreichbar über eine öffentliche URL (z.B. https://wms.deinefirma.de)
2. Ein CRON_SECRET — ein zufälliger Schlüssel, der sicherstellt, dass nur autorisierte Anfragen die Jobs auslösen können

CRON_SECRET generieren

Falls noch kein CRON_SECRET gesetzt ist, generiere einen mit diesem Befehl:

openssl rand -hex 32

Trage das Ergebnis als Umgebungsvariable (CRON_SECRET) in deinem Hosting ein (z.B. in Coolify unter dem Service → Environment Variables).

Einrichtung im WMS

Schritt 1: WMS-URL eintragen

1. Öffne Einstellungen → Cron-Jobs im WMS
2. Trage im Feld WMS-URL die öffentliche Adresse deines WMS ein (z.B. https://wms.deinefirma.de)
3. Klicke auf Speichern

Wichtig: Die URL muss ohne abschließenden Slash (/) eingegeben werden.

Schritt 2: CRON_SECRET prüfen

Auf der gleichen Seite wird dir der aktuelle CRON_SECRET angezeigt. Du kannst ihn ein-/ausblenden und kopieren. Dieser Schlüssel wird für die Einrichtung des externen Cron-Dienstes benötigt.

Falls kein CRON_SECRET angezeigt wird, ist die Umgebungsvariable noch nicht gesetzt — siehe oben unter “CRON_SECRET generieren”.

Cron-Dienst einrichten

Das WMS führt die Jobs nicht selbst zeitgesteuert aus — es stellt API-Endpunkte bereit, die von einem externen Cron-Dienst in regelmäßigen Abständen aufgerufen werden. Dafür gibt es mehrere Möglichkeiten:

Option A: Webhosting-Verwaltung (z.B. all-inkl KAS)

Die einfachste Methode, wenn du ein Webhosting-Paket mit Cron-Funktion hast.

1. Logge dich in dein Hosting-Panel ein (z.B. all-inkl KAS → Tools → Cron-Jobs)
2. Lege für jeden Job einen neuen Cron-Eintrag an
3. Verwende als Befehl jeweils:

curl -s -H "x-cron-secret: DEIN_SECRET" https://wms.deinefirma.de/api/cron/order-import > /dev/null

4. Stelle den Zeitplan gemäß der Tabelle unten ein

Option B: Linux/Mac Crontab

Falls du Zugriff auf einen Linux-Server oder Mac hast:

1. Öffne das Terminal und bearbeite die Crontab:

crontab -e

2. Füge für jeden Job eine Zeile hinzu, z.B.:

*/5 * * * * curl -s -H "x-cron-secret: DEIN_SECRET" https://wms.deinefirma.de/api/cron/order-import > /dev/null 2>&1
* * * * * curl -s -H "x-cron-secret: DEIN_SECRET" https://wms.deinefirma.de/api/cron/inventory-sync > /dev/null 2>&1

3. Speichere und schließe den Editor

Option C: Uptime Kuma (Self-hosted Monitoring)

Wenn du bereits Uptime Kuma  einsetzt, kannst du es auch als Cron-Dienst nutzen:

1. Lege pro Cron-Job einen neuen HTTP(s) Monitor an
2. Trage die vollständige URL ein (z.B. https://wms.deinefirma.de/api/cron/order-import)
3. Stelle das Intervall auf den gewünschten Wert (z.B. 300 Sekunden für alle 5 Minuten)
4. Füge unter Headers hinzu:

x-cron-secret: DEIN_SECRET

5. Setze den Monitor auf aktiv

Alle Cron-Jobs im Überblick

Pflicht-Jobs (immer einrichten)

Bestellimport — Importiert automatisch neue Bestellungen aus allen aktiven Shopify-Integrationen mit automatischem Import. Prüft jede Integration einzeln und überspringt bereits importierte Bestellungen.

Bestandsabgleich — Synchronisiert WMS-Bestände zurück zu Shopify. Sendet nur Änderungen (Dirty-Queue), nicht den kompletten Bestand. Das Intervall pro Integration ist separat konfigurierbar (1–60 Minuten).

Amazon-Jobs (nur bei aktiver Amazon-Integration)

Diese Jobs erscheinen automatisch auf der Cron-Jobs-Seite, sobald du eine Amazon-Integration aktiviert hast.

FBA-Jobs (Auftragsimport + Inventory Pull) werden nur benötigt, wenn du FBA in deiner Amazon-Integration aktiviert hast.

Workflow-Job (nur bei zeitgesteuerten Workflows)

Prüft alle aktiven Workflows mit dem Trigger-Typ “Zeitgesteuert” und führt fällige Workflows aus. Nur nötig, wenn du mindestens einen zeitgesteuerten Workflow eingerichtet hast (siehe Workflows).

Aufräum-Jobs (empfohlen)

Täglicher Cleanup — Löscht alte Druckaufträge (älter als 60 Tage) und die zugehörigen Label-PDFs aus dem Storage. Setzt außerdem hängende Druckaufträge zurück.

Wöchentlicher Cleanup — Löscht alte Sync-Logs (älter als 90 Tage) und Workflow-Ausführungsprotokolle. Bestellungen, Kunden und Produkte werden nie gelöscht.

Jobs manuell auslösen

Auf der Einstellungen → Cron-Jobs Seite im WMS kannst du jeden Job über den Play-Button manuell auslösen. Das ist nützlich um:

• Nach der Ersteinrichtung zu prüfen, ob alles funktioniert
• Einen sofortigen Import/Sync anzustoßen, ohne auf den nächsten Intervall zu warten
• Probleme zu diagnostizieren (das Ergebnis wird direkt angezeigt)

Nach dem Auslösen siehst du für jeden Job, ob er erfolgreich war und wie viele Datensätze verarbeitet wurden.

Cron-Ausdrücke erklärt

Falls du die Cron-Ausdrücke anpassen möchtest, hier die Syntax:

┌───────── Minute (0-59)
│ ┌─────── Stunde (0-23)
│ │ ┌───── Tag im Monat (1-31)
│ │ │ ┌─── Monat (1-12)
│ │ │ │ ┌─ Wochentag (0-7, 0 und 7 = Sonntag)
│ │ │ │ │
* * * * *

Beispiele:

Komplettbeispiel: Alle Pflicht-Jobs einrichten

Hier ein vollständiges Crontab-Beispiel mit den beiden Pflicht-Jobs und den empfohlenen Cleanup-Jobs:

# WMS Cron-Jobs
# Bestellimport (alle 5 Minuten)
*/5 * * * * curl -s -H "x-cron-secret: abc123def456" https://wms.deinefirma.de/api/cron/order-import > /dev/null 2>&1
 
# Bestandsabgleich (jede Minute)
* * * * * curl -s -H "x-cron-secret: abc123def456" https://wms.deinefirma.de/api/cron/inventory-sync > /dev/null 2>&1
 
# Täglicher Cleanup (02:00 UTC)
0 2 * * * curl -s -H "x-cron-secret: abc123def456" https://wms.deinefirma.de/api/cron/cleanup-daily > /dev/null 2>&1
 
# Wöchentlicher Cleanup (Sonntag 03:00 UTC)
0 3 * * 0 curl -s -H "x-cron-secret: abc123def456" https://wms.deinefirma.de/api/cron/cleanup-sync-logs > /dev/null 2>&1

Ersetze abc123def456 durch deinen echten CRON_SECRET und wms.deinefirma.de durch deine WMS-Domain.

Bestandssynchronisierung: Architektur

Flowkom synchronisiert Bestände automatisch an alle verbundenen Plattformen (Shopify, Amazon). Dabei gibt es zwei Mechanismen, die zusammenarbeiten:

Dirty-Queue (Event-basiert, sofort)

Bei jeder Bestandsänderung werden die betroffenen Produkte in eine Warteschlange geschrieben. Der Flush-Cron (jede Minute) verarbeitet die Queue und pusht die aktualisierte Menge an die jeweilige Plattform.

Auslöser, die automatisch in die Dirty-Queue schreiben:

Wichtig: Beim Auftragsimport wird noch kein physischer Bestand abgebucht — aber die Reservierung (offene Aufträge) wird bei der Berechnung der verfügbaren Menge berücksichtigt. So sehen alle Plattformen sofort den reduzierten verfügbaren Bestand.

Safety-Sync (Vollabgleich, periodisch)

Als Sicherheitsnetz läuft ein periodischer Vollabgleich, der alle Produkte mit der Plattform synchronisiert — unabhängig davon, ob sie in der Dirty-Queue waren. Das fängt verlorene Events auf.

Da die Dirty-Queue lückenlos alle Änderungen erfasst, reicht ein täglicher Safety-Sync als Absicherung.

Berechnung der verfügbaren Menge

Die an Amazon/Shopify gepushte Menge ist nicht der physische Lagerbestand, sondern:

Verfügbar = Physischer Bestand (alle non-FBA Lager)
           − Reservierungen (offene/in Bearbeitung/gepickte Aufträge)

Bei Bundle-Artikeln wird zusätzlich das Minimum der Komponentenverfügbarkeit berechnet.

Häufige Fragen

Muss ich alle Jobs einrichten?

Nein. Nur Bestellimport und Bestandsabgleich sind Pflicht. Die Amazon-Jobs brauchst du nur, wenn du Amazon als Marktplatz nutzt. Die Cleanup-Jobs sind empfohlen, aber nicht zwingend — ohne sie wachsen die Datenbank und der Storage über die Zeit an.

Was passiert, wenn ein Cron-Job fehlschlägt?

Der Job wird beim nächsten Intervall automatisch erneut versucht. Fehlgeschlagene Jobs blockieren keine anderen Jobs. Auf der Cron-Jobs-Seite siehst du den letzten Status pro Job.

Kann ich die Intervalle ändern?

Ja, du kannst die Cron-Ausdrücke in deinem Cron-Dienst anpassen. Die empfohlenen Intervalle sind auf die API-Rate-Limits der jeweiligen Dienste (Shopify, Amazon) abgestimmt — kürzere Intervalle können zu Throttling führen.

Brauche ich pg_cron oder Supabase Cron?

Nein. Das WMS nutzt externe HTTP-Aufrufe statt datenbankbasierter Cron-Jobs. Das macht die Einrichtung flexibler und unabhängig von der Datenbank.

Ich nutze Coolify — gibt es eine integrierte Cron-Funktion?

Coolify selbst bietet keine Cron-Funktion. Du brauchst einen externen Dienst (Webhosting-Panel, Crontab auf einem Server, oder Uptime Kuma). Wenn dein WMS auf Coolify läuft, ist Uptime Kuma eine gute Ergänzung, da es sich ebenfalls über Coolify deployen lässt.