Veröffentlicht von Markus Wals

n8n mit weclapp: Aufbau eines Workflows und acht Störungen, die du kennen solltest

Automatisierung Betrieb n8n n8n Workflow REST-API Webhooks weclapp

KI-generierte Illustration: Eine Kette aus vier verbundenen Blöcken mit Uhr, Verzweigung, Zahnrad und Aktenschrank, an einer roten Verbindung ein Warndreieck. Überschrift: n8n mit weclapp

Kurz gesagt: Ein n8n Workflow mit weclapp besteht aus einem Auslöser, wenigen Nodes und einem API-Token. Im Betrieb treten Störungen meist an acht wiederkehrenden Stellen auf, etwa bei Rechten, still ignorierten Filtern, 429-Antworten oder Webhooks. Wer sie beim Bau einplant, spart sich später die Fehlersuche.

Du nutzt weclapp und willst Abläufe mit n8n automatisieren, oder ein erster Workflow läuft schon und macht Ärger. Der Aufbau ist schnell erledigt. Aufwendig wird der Betrieb: Rechte ändern sich, Anfragen laufen in Grenzen, Webhooks feuern doppelt. Aus unseren Projekten und aus unserem Support wissen wir, wo Workflows mit weclapp im Alltag haken.

Das Wichtigste in Kürze

  • Ein Workflow ist Auslöser, Nodes, Ausführung. Für weclapp reicht zum Einstieg der HTTP-Request-Node mit einem Header-Auth-Credential.
  • Acht Störungsklassen wiederholen sich. Sie betreffen Rechte, Filter, Pagination, Datumswerte, Last, Webhooks, PUT und fehlende Alarme.
  • Zurücklesen schlägt Vertrauen. Nach jedem Schreiben prüft der Workflow, ob der Datensatz in weclapp so steht, wie er soll.
  • Betrieb braucht eine zuständige Person. Ein Workflow ohne Fehlerweg und ohne Verantwortliche läuft nur, bis die erste Schnittstelle sich ändert.

Wie ist ein n8n Workflow mit weclapp aufgebaut?

Grafik: So ist ein Workflow mit weclapp aufgebaut. Ein Trigger startet ihn, als Schedule Trigger im festen Takt oder als Webhook bei einem Ereignis. Nodes wie HTTP Request, IF und Code holen, verzweigen und rechnen, die Anmeldung läuft über Header Auth mit AuthenticationToken. Jeder Lauf wird als Ausführung gespeichert. Werte, die sich ändern, gehören in einen eigenen Node am Anfang.

Jeder Workflow beginnt mit einem Trigger. Im weclapp-Umfeld sind das meist ein Schedule Trigger, der im festen Takt läuft, oder ein Webhook, den weclapp bei einem Ereignis aufruft. Danach folgen Nodes: Ein HTTP-Request-Node holt Daten, ein IF-Node verzweigt, ein Code-Node rechnet. Die Daten wandern als Einträge von Node zu Node, jeder Lauf wird als Ausführung gespeichert.

Den Zugang legst du in weclapp an. Das API-Token gehört zu einem Benutzer, und es gelten genau dessen Rechte. Laut API-Spezifikation macht ein neu erzeugtes Token alle früheren ungültig, in manchen Mandanten legst du stattdessen mehrere benannte Tokens an. Welcher Fall bei dir gilt, prüfst du vor dem Erzeugen, die Schritte stehen in Token erstellen und erster Request. Lege für jede Anbindung einen eigenen technischen Benutzer an und hinterlege das Token in n8n als Header-Auth-Credential mit dem Header AuthenticationToken. Die API steht laut weclapp-Preisseite in ERP Dienstleistung und ERP Handel zur Verfügung. Mehr zur Schnittstelle selbst findest du auf unserer Seite weclapp API.

Zwei Eigenheiten von n8n kosten oft Zeit. Ein Schedule Trigger läuft nur, wenn der Workflow gespeichert und veröffentlicht ist, und verpasste Läufe überspringt n8n standardmäßig. Bei selbst betriebenen Instanzen gilt ohne Einstellung die Zeitzone America/New_York. Bei Webhook-Nodes gibt es eine Test-URL und eine Production-URL. Die Test-URL funktioniert nur, solange du auf ein Testereignis wartest.

Ein Tipp aus unseren Projekten: Lege alle Werte, die sich ändern können, in einen eigenen Node am Anfang, zum Beispiel Mandant, Intervalle und Zusatzfeld-IDs. Wir nennen ihn „Constants“. Eine Regel änderst du dann an einer Stelle.

Fazit: Trigger, wenige Nodes, ein eigenes Token pro Anbindung und die Zeitzone im Workflow gesetzt. Mehr braucht der Einstieg nicht.

n8n Cloud oder selbst betrieben?

n8n gibt es als Cloud-Dienst und zum Selbstbetrieb auf einem eigenen Server. Die Cloud ist der schnellste Start, weil du keinen Server pflegst. Selbst betrieben hast du mehr Kontrolle, trägst aber Updates, Backups und Überwachung selbst. Entscheide nach der Frage, wer den Betrieb übernimmt. Wie wir das mit Kund:innen entscheiden, steht auf der Seite n8n Agentur.

Fazit: Cloud heißt schneller Start, Selbstbetrieb heißt eigene Verantwortung für Updates, Backups und Überwachung.

Community Node oder HTTP Request?

Für viele Abläufe genügt der HTTP-Request-Node. n8n empfiehlt dort einen vordefinierten Credential-Typ, und für Dienste ohne eigenen Typ gibt es generische Credentials wie Header Auth. Der Node bietet Pagination, Batching und einen Timeout in Millisekunden. Er ist auch die erste Wahl, wenn du einen Endpunkt brauchst, den noch kein Node abdeckt.

Ein Community Node lohnt sich, wenn viele Workflows dieselbe Anbindung brauchen. Für weclapp pflegen wir @wals-pro/n8n-nodes-weclapp. Er steht unter MIT-Lizenz auf npm, aktuell in Version 1.0.2 vom 13.11.2026, und deckt laut README 16 Ressourcen ab, dazu einen Custom API Call und einen Webhook-Trigger. Der Paketname ohne Scope, n8n-nodes-weclapp, gehört einem anderen Autor.

Situation Nimm
Ein einzelner Ablauf oder ein Endpunkt, den kein Node abdeckt HTTP-Request-Node
Viele Workflows mit derselben weclapp-Anbindung Community Node
weclapp-Ereignisse als Auslöser Community Node mit Webhook-Trigger

Fazit: Starte mit dem HTTP-Request-Node und wechsle zum Community Node, sobald du dieselbe Anbindung in mehreren Workflows nachbaust.

Welche acht Störungen treten im Alltag auf?

Die acht Störungen stammen aus unserem Support und aus unseren Projekten. Sie betreffen die Anbindung an weclapp und den Betrieb in n8n, selten die Fachlogik des Workflows.

Symptom Ursache Abhilfe
HTTP 403 beim Lesen, Zusatzfeld lässt sich nicht schreiben Der Workflow-Benutzer hat nicht die nötigen Rechte; nach einer Token-Rotation steht noch das alte Token im Credential Rechte des Benutzers prüfen, Token im Header-Auth-Credential tauschen, je Kunde ein eigenes Credential
Abfrage liefert die volle Menge statt der gefilterten weclapp ignoriert unbekannte Filter still Property-Pfad und Operator gegen die OpenAPI-Datei prüfen, Trefferzahl mit /count gegenprüfen
Listen enden zu früh oder laufen endlos Die Abbruchbedingung der Pagination löst nicht auf, etwa durch eine Referenz auf den Constants-Node Seitengröße 1.000, Abbruchzahl fest eintragen, maxRequests setzen, mit pageSize=5 proben
Datum liegt einen Tag daneben weclapp liefert Epoch-Millisekunden, ein Code-Node formatiert in UTC Zeitzone Europe/Berlin beim Formatieren angeben, Datumsfilter als Zahl senden
Läufe hängen, 429, Duplikate nach Wiederholung Grenze gleichzeitiger Anfragen je Mandant, Timeout zu kurz Timeout mindestens eine Minute, Backoff nur für lesende Aufrufe, vor Wiederholung zurücklesen
Doppelt so viele Läufe wie Aufträge, oder gar keine Ereignisse mehr Ein Vorgang löst mehrere Webhooks aus, eigene Writes lösen erneut aus, ein Ziel wurde deaktiviert Schnell mit 2xx quittieren, per ID neu lesen, entprellen, zusätzlich im Takt prüfen
Positionen oder Preiszeilen fehlen nach einem Update Item-Arrays sind bei PUT vollständige Ersatzlisten Datensatz vorher lesen, mit id und version senden, alle Positionen mitschicken
Flut von Fehlermails oder gar keine Meldung bei Ausfall Der Error-Workflow löst nur bei fehlgeschlagenen Workflows aus; Stille ist kein Fehler Error-Workflow setzen, Alarme bündeln, auf ausbleibende Ereignisse alarmieren

Fazit: Die meisten dieser Störungen zeigen sich erst, wenn der Workflow schon läuft. Prüf sie beim Bau, nicht im Ticket.

429 und Timeouts unter Last

weclapp kennt kein festes Rate-Limit, begrenzt aber gleichzeitige Anfragen je Mandant. Überzählige Anfragen warten in einer Warteschlange von aktuell rund 30 Sekunden, danach antwortet weclapp mit HTTP 429. Setzt du im HTTP-Request-Node einen Timeout von 30 Sekunden, bricht n8n kurz vor der Antwort ab und wiederholt, und es entstehen Duplikate. Stell den Timeout auf mindestens eine Minute (60000 ms).

Seit Version 26.10.1 vom 21.05.2026 liefert weclapp die Header X-Weclapp-Wait-Ms und X-Weclapp-Wait-Reason mit. Daran siehst du, wie lange eine Anfrage gewartet hat und warum. Wiederhole automatisch nur lesende Aufrufe. Nach einem Timeout oder 429 bei POST, PUT oder DELETE liest du zuerst zurück. Die Einzelheiten stehen im Beitrag zu 429, Backoff und Timeouts.

Webhooks: doppelt, selbstauslösend oder stumm

Grafik: Webhooks von weclapp sicher verarbeiten, die Benachrichtigung enthält nur ID, Entitätsname und Typ. Vier Schritte: schnell mit HTTP 2xx quittieren, die Entität per ID neu aus weclapp lesen, mehrere Webhooks je Entität entprellen und mit einem zusätzlichen Lauf im Takt verpasste Ereignisse abfangen. Eigene Schreibzugriffe lösen den Webhook erneut aus.

Die Benachrichtigung von weclapp enthält nur die ID der Entität, den Entitätsnamen und den Typ, nicht den Datensatz. Ein Geschäftsvorgang erzeugt oft ein Create und mehrere Updates, und eigene Schreibzugriffe lösen den Webhook erneut aus. Quittiere deshalb schnell mit 2xx, lies die Entität per ID neu und entprelle je Entität. Ist deine URL nicht erreichbar, wiederholt weclapp laut Hilfe nach 1, 5 und 30 Minuten, 5 Stunden und einem Tag und deaktiviert den Webhook danach. Ändert sich beim Umzug eines Workflows die URL, bleibt die alte Registrierung stumm zurück. Ein zusätzlicher Lauf im Takt fängt verpasste Ereignisse ab. Mehr dazu im Beitrag zu Webhooks und Delta-Sync.

Filter, die still ignoriert werden

Laut Spezifikation ignoriert weclapp unbekannte Filter-Eigenschaften ohne Fehlermeldung. Die Antwort ist dann 200 mit der ungefilterten Menge, und der Workflow verarbeitet zu viele Datensätze. Verschiebe zur Probe die Grenze deines Filters und vergleiche die Trefferzahl über /count. Ändert sie sich nicht, greift der Filter nicht. Baue Query-Werte nicht vorcodiert, sonst wird doppelt codiert. Wie Filter, properties und Batching zusammenspielen, zeigt der Beitrag zu Filtern, Properties und Batching.

PUT überschreibt Positionen

Ein vollständiges PUT setzt Felder, die du nicht mitschickst, auf null. Bei Positionslisten wie orderItems oder shipmentItems gilt das auch mit ignoreMissingProperties=true: Die Liste, die du sendest, ersetzt die vorhandene. Bei articlePrices werden fehlende Zeilen gelöscht. Lies darum zuerst den Datensatz, sende id und version mit und gib alle bestehenden Positionen zurück. Die version schützt dich außerdem vor gleichzeitigen Änderungen.

Was macht einen Workflow betriebsfest?

Ein Workflow, der im Test läuft, hält im Alltag noch nicht. Diese Liste nutzen wir beim Bau:

  1. Zurücklesen nach dem Schreiben. Der Workflow prüft, ob der Datensatz so in weclapp steht, wie er soll. Warum das nötig ist, zeigt der Beitrag zu stillen Fehlern der weclapp-API.
  2. Error-Workflow setzen. In den Einstellungen des überwachten Workflows wählst du den Error-Workflow, dessen erster Node der Error Trigger ist. Bei uns entsteht daraus ein Ticket bei einer zuständigen Person.
  3. Auf Stille alarmieren. Fängt ein Node den Fehler mit „Continue“ ab, gilt die Ausführung in unseren Projekten nicht als fehlgeschlagen, der Error-Workflow läuft dann nicht. Zusätzlich prüfst du, ob in einem Zeitraum überhaupt Ereignisse ankamen.
  4. Wiederholen mit Abstand. Retry On Fail in den Node-Einstellungen eignet sich für lesende Aufrufe. Schreibende Aufrufe liest du vorher zurück.
  5. Token pflegen. Nach einer Rotation tauschst du das Token im Credential. Wie das ohne Ausfall geht, steht im Beitrag zum Erneuern des API-Schlüssels.
  6. Erst am Testmandanten. Neue Abläufe laufen zuerst gegen einen Testmandanten, nie mit Testdaten in deinem echten weclapp.
  7. Versionieren in Git. Jeder Stand ist nachvollziehbar und lässt sich zurückholen.

Welche Abläufe sich in weclapp zuerst lohnen, steht auf der Seite weclapp Automatisierung.

Fazit: Ein Workflow ist fertig, wenn feststeht, was bei einem Fehler passiert und wer es merkt.

Wann passt n8n nicht?

  • Dein Team arbeitet ganz in Microsoft 365. Dann ist Power Automate oft näher dran. Den Vergleich der Werkzeuge findest du im Beitrag n8n, Zapier, Power Automate und KI-Agent.
  • Der Ablauf kommt selten vor. Fünf Minuten Handarbeit im Monat rechtfertigen keinen Workflow mit Betrieb.
  • Du willst Daten einmalig übernehmen. Das ist eine Migration, kein dauerhafter Workflow.
  • Niemand ist für den Betrieb zuständig. Schnittstellen ändern sich. Jemand muss Fehler sehen und nachziehen.

Fazit: n8n lohnt sich bei wiederkehrenden Abläufen mit klarer Zuständigkeit.

Quellen und Grenzen

Die Störungsliste beruht auf unserer Praxis aus Support und Projekten, nicht auf einer Statistik. Das 30-Sekunden-Fenster der Warteschlange ist der aktuelle Wert, weclapp garantiert ihn nicht. Der Artikel behandelt keine Preise von n8n oder weclapp und bewertet keine anderen Community Nodes. Stand: 15. November 2026.

Häufige Fragen

Wie verbinde ich n8n mit weclapp?

Du erzeugst in weclapp ein API-Token für einen Benutzer mit passenden Rechten und hinterlegst es in n8n als Header-Auth-Credential mit dem Header AuthenticationToken. Danach rufst du die API mit dem HTTP-Request-Node auf oder nutzt den Community Node @wals-pro/n8n-nodes-weclapp.

Warum bekomme ich in n8n HTTP 429 von weclapp?

weclapp begrenzt gleichzeitige Anfragen je Mandant. Wartende Anfragen stehen aktuell bis rund 30 Sekunden in einer Warteschlange, danach folgt HTTP 429. Reduziere die Parallelität, stell den Timeout auf mindestens eine Minute und wiederhole nur lesende Aufrufe.

Warum liefert mein weclapp-Filter alle Datensätze?

Laut Spezifikation ignoriert weclapp unbekannte Filter-Eigenschaften still. Prüfe Property-Pfad und Operator in der OpenAPI-Datei und vergleiche die Trefferzahl über /count, wenn du die Filtergrenze verschiebst.

Was passiert, wenn mein n8n-Webhook nicht erreichbar ist?

weclapp wiederholt den Aufruf laut Hilfe nach 1, 5 und 30 Minuten, 5 Stunden und einem Tag und deaktiviert den Webhook danach. Ein zusätzlicher Lauf im festen Takt fängt verpasste Ereignisse ab.

Ist die weclapp-API in jedem Paket enthalten?

Nein. Laut weclapp-Preisseite ist die API in ERP Dienstleistung und ERP Handel enthalten, nicht in ERP Starter. Prüfe das Paket deines Mandanten, bevor du einen Workflow planst.