n8n mit weclapp: Aufbau eines Workflows und acht Störungen, die du kennen solltest
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?

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

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:
- 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.
- 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.
- 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.
- Wiederholen mit Abstand. Retry On Fail in den Node-Einstellungen eignet sich für lesende Aufrufe. Schreibende Aufrufe liest du vorher zurück.
- 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.
- Erst am Testmandanten. Neue Abläufe laufen zuerst gegen einen Testmandanten, nie mit Testdaten in deinem echten weclapp.
- 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
- n8n-Dokumentation, HTTP-Request-Node: docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.httprequest (abgerufen am 15.11.2026)
- n8n-Dokumentation, Node-Einstellungen (Retry On Fail, On Error): docs.n8n.io/workflows/components/nodes (abgerufen am 15.11.2026)
- n8n-Dokumentation, Webhook-Node: docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.webhook (abgerufen am 15.11.2026)
- n8n-Dokumentation, Schedule Trigger: docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.scheduletrigger (abgerufen am 15.11.2026)
- n8n-Dokumentation, Error Handling: docs.n8n.io/flow-logic/error-handling (abgerufen am 15.11.2026)
- weclapp, API-Spezifikation (Getting Started, Filtering, Load management): weclapp.com/api/openapi_v2.yaml (abgerufen am 15.11.2026)
- weclapp, API-Changelog: doc.weclapp.com/api-changelog (abgerufen am 15.11.2026)
- weclapp-Hilfe, Webhooks: doc.weclapp.com/knowledgebase/wie-binde-ich-webhooks-in-weclapp-ein (abgerufen am 15.11.2026)
- weclapp-Hilfe, API-Token: doc.weclapp.com/knowledgebase/gibt-es-eine-api-zu-weclapp (abgerufen am 15.11.2026)
- weclapp, Preise und Pakete: weclapp.com/de/preise (abgerufen am 15.11.2026)
- npm,
@wals-pro/n8n-nodes-weclapp: npmjs.com/package/@wals-pro/n8n-nodes-weclapp (abgerufen am 15.11.2026)
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.