Cron-Jobs
Cron-Jobs sind automatische Hintergrund-Aufgaben, die in regelmässigen Abstaenden ausgefuehrt werden. Sie sorgen dafuer, dass Bestellungen importiert, Bestaende synchronisiert und alte Daten bereinigt werden — ohne dass jemand manuell etwas ausloesen muss.
Voraussetzungen
Bevor du Cron-Jobs einrichten kannst, brauchst du:
- Ein laufendes WMS — erreichbar ueber eine oeffentliche URL (z.B.
https://wms.deinefirma.de) - Ein CRON_SECRET — ein zufaelliger Schluessel, der sicherstellt, dass nur autorisierte Anfragen die Jobs ausloesen koennen
CRON_SECRET generieren
Falls noch kein CRON_SECRET gesetzt ist, generiere einen mit diesem Befehl:
openssl rand -hex 32Trage 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
- Oeffne Einstellungen → Cron-Jobs im WMS
- Trage im Feld WMS-URL die oeffentliche Adresse deines WMS ein (z.B.
https://wms.deinefirma.de) - Klicke auf Speichern
Wichtig: Die URL muss ohne abschliessenden Slash (
/) eingegeben werden.
Schritt 2: CRON_SECRET pruefen
Auf der gleichen Seite wird dir der aktuelle CRON_SECRET angezeigt. Du kannst ihn ein-/ausblenden und kopieren. Dieser Schluessel wird fuer die Einrichtung des externen Cron-Dienstes benoetigt.
Falls kein CRON_SECRET angezeigt wird, ist die Umgebungsvariable noch nicht gesetzt — siehe oben unter “CRON_SECRET generieren”.
Cron-Dienst einrichten
Das WMS fuehrt die Jobs nicht selbst zeitgesteuert aus — es stellt API-Endpunkte bereit, die von einem externen Cron-Dienst in regelmaessigen Abstaenden aufgerufen werden. Dafuer gibt es mehrere Moeglichkeiten:
Option A: Webhosting-Verwaltung (z.B. all-inkl KAS)
Die einfachste Methode, wenn du ein Webhosting-Paket mit Cron-Funktion hast.
- Logge dich in dein Hosting-Panel ein (z.B. all-inkl KAS → Tools → Cron-Jobs)
- Lege fuer jeden Job einen neuen Cron-Eintrag an
- Verwende als Befehl jeweils:
curl -s -H "x-cron-secret: DEIN_SECRET" https://wms.deinefirma.de/api/cron/order-import > /dev/null- Stelle den Zeitplan gemaess der Tabelle unten ein
Option B: Linux/Mac Crontab
Falls du Zugriff auf einen Linux-Server oder Mac hast:
- Oeffne das Terminal und bearbeite die Crontab:
crontab -e- Fuege fuer 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- Speichere und schliesse den Editor
Option C: Uptime Kuma (Self-hosted Monitoring)
Wenn du bereits Uptime Kuma einsetzt, kannst du es auch als Cron-Dienst nutzen:
- Lege pro Cron-Job einen neuen HTTP(s) Monitor an
- Trage die vollstaendige URL ein (z.B.
https://wms.deinefirma.de/api/cron/order-import) - Stelle das Intervall auf den gewuenschten Wert (z.B. 300 Sekunden fuer alle 5 Minuten)
- Fuege unter Headers hinzu:
x-cron-secret: DEIN_SECRET- Setze den Monitor auf aktiv
Alle Cron-Jobs im Ueberblick
Pflicht-Jobs (immer einrichten)
| Job | Endpunkt | Intervall | Cron-Ausdruck |
|---|---|---|---|
| Bestellimport | /api/cron/order-import | Alle 5 Minuten | */5 * * * * |
| Bestandsabgleich | /api/cron/inventory-sync | Jede Minute | * * * * * |
Bestellimport — Importiert automatisch neue Bestellungen aus allen aktiven Shopify-Integrationen mit automatischem Import. Prueft jede Integration einzeln und ueberspringt bereits importierte Bestellungen.
Bestandsabgleich — Synchronisiert WMS-Bestaende zurueck zu Shopify. Sendet nur Aenderungen (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.
| Job | Endpunkt | Intervall | Cron-Ausdruck |
|---|---|---|---|
| Versandbestaetigung Retry | /api/cron/amazon-shipment-retry | Alle 5 Min | */5 * * * * |
| FBA Auftragsimport | /api/cron/amazon-fba-import | Alle 30 Min | */30 * * * * |
| FBA Bestandssync | /api/cron/amazon-fba-inventory-sync | Alle 60 Min | 0 * * * * |
| FBM Bestandssync | /api/cron/amazon-inventory-sync | Alle 15 Min | */15 * * * * |
| Produktsynchronisierung | /api/cron/amazon-product-sync | Alle 6 Std | 0 0,6,12,18 * * * |
| Feed-Status-Check | /api/cron/amazon-feed-status-check | Alle 5 Min | */5 * * * * |
| DLQ Retry | /api/cron/amazon-retry-failed | Alle 5 Min | */5 * * * * |
FBA-Jobs (Auftragsimport + Bestandssync) werden nur benoetigt, wenn du FBA in deiner Amazon-Integration aktiviert hast. FBM-Bestandssync wird nur benoetigt, wenn der periodische FBM-Bestandsabgleich aktiviert ist.
Workflow-Job (nur bei zeitgesteuerten Workflows)
| Job | Endpunkt | Intervall | Cron-Ausdruck |
|---|---|---|---|
| Workflow-Ausfuehrung | /api/cron/execute-workflows | Alle 15 Min | */15 * * * * |
Prueft alle aktiven Workflows mit dem Trigger-Typ “Zeitgesteuert” und fuehrt faellige Workflows aus. Nur noetig, wenn du mindestens einen zeitgesteuerten Workflow eingerichtet hast (siehe Workflows).
Aufraeum-Jobs (empfohlen)
| Job | Endpunkt | Intervall | Cron-Ausdruck |
|---|---|---|---|
| Taeglicher Cleanup | /api/cron/cleanup-daily | Taeglich 02:00 UTC | 0 2 * * * |
| Woechentlicher Cleanup | /api/cron/cleanup-sync-logs | Sonntags 03:00 UTC | 0 3 * * 0 |
Taeglicher Cleanup — Loescht alte Druckauftraege (aelter als 60 Tage) und die zugehoerigen Label-PDFs aus dem Storage. Setzt ausserdem haengende Druckauftraege zurueck.
Woechentlicher Cleanup — Loescht alte Sync-Logs (aelter als 90 Tage) und Workflow-Ausfuehrungsprotokolle. Bestellungen, Kunden und Produkte werden nie geloescht.
Jobs manuell ausloesen
Auf der Einstellungen → Cron-Jobs Seite im WMS kannst du jeden Job ueber den Play-Button manuell ausloesen. Das ist nuetzlich um:
- Nach der Ersteinrichtung zu pruefen, ob alles funktioniert
- Einen sofortigen Import/Sync anzustossen, ohne auf den naechsten Intervall zu warten
- Probleme zu diagnostizieren (das Ergebnis wird direkt angezeigt)
Nach dem Ausloesen siehst du fuer jeden Job, ob er erfolgreich war und wie viele Datensaetze verarbeitet wurden.
Cron-Ausdruecke erklaert
Falls du die Cron-Ausdruecke anpassen moechtest, 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:
| Ausdruck | Bedeutung |
|---|---|
* * * * * | Jede Minute |
*/5 * * * * | Alle 5 Minuten |
*/15 * * * * | Alle 15 Minuten |
*/30 * * * * | Alle 30 Minuten |
0 * * * * | Jede volle Stunde |
0 0,6,12,18 * * * | Um 00:00, 06:00, 12:00, 18:00 Uhr |
0 2 * * * | Taeglich um 02:00 Uhr |
0 3 * * 0 | Sonntags um 03:00 Uhr |
Komplettbeispiel: Alle Pflicht-Jobs einrichten
Hier ein vollstaendiges 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
# Taeglicher 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
# Woechentlicher 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>&1Ersetze
abc123def456durch deinen echten CRON_SECRET undwms.deinefirma.dedurch deine WMS-Domain.
Haeufige 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 ueber die Zeit an.
Was passiert, wenn ein Cron-Job fehlschlaegt?
Der Job wird beim naechsten 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 aendern?
Ja, du kannst die Cron-Ausdruecke in deinem Cron-Dienst anpassen. Die empfohlenen Intervalle sind auf die API-Rate-Limits der jeweiligen Dienste (Shopify, Amazon) abgestimmt — kuerzere Intervalle koennen zu Throttling fuehren.
Brauche ich pg_cron oder Supabase Cron?
Nein. Das WMS nutzt externe HTTP-Aufrufe statt datenbankbasierter Cron-Jobs. Das macht die Einrichtung flexibler und unabhaengig 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 laeuft, ist Uptime Kuma eine gute Ergaenzung, da es sich ebenfalls ueber Coolify deployen laesst.