weclapp Sammelrechnung mit n8n sortieren: Vier Schutzmechanismen gegen Webhook-Loops und Versionskonflikte
Kurz gesagt: Wenn du Sammelrechnungen in weclapp per n8n und REST API v2 automatisiert sortierst oder gliederst, löst dein eigenes PUT-Update den weclapp-Webhook erneut aus und überschreibt ohne Versionsschutz offene Bearbeitungen im Browser. Produktionsfest wird der Ablauf durch vier Schutzmechanismen: einen harten Status- und Sammelbeleg-Filter direkt nach dem Belegabruf, die Trennung aus manuellem Not-Aus-Zusatzfeld (customAttributes) und Soll-Ist-Vergleich vor dem Schreiben, Optimistic Locking über ein frisches version-Feld samt vollständiger Positionsliste sowie einen Takt-Check auf deaktivierte Webhooks (deactivatedDate).
Im B2B-Großhandel und Projektgeschäft fassen Buchhaltungsteams regelmäßig mehrere Aufträge oder Lieferungen eines Monats zu einer Sammelrechnung zusammen. Sobald Großkund:innen eine spezielle Sortierung, Zwischenüberschriften oder Seitenumbrüche jenseits der weclapp-Standardgruppierung verlangen, liegt ein n8n-Workflow nahe – doch der erste naive Entwurf endet fast immer in einer Endlosschleife aus Update-Webhooks oder in der Browser-Fehlermeldung, dass Benutzereingaben verloren gegangen sind. Dieser Leitfaden zeigt dir anhand der offiziellen weclapp OpenAPI v2 und der n8n-Dokumentation, wie du Beleg-Automatisierung ohne Schleifen und ohne Datenverlust aufbaust.
Das Wichtigste in Kürze
- Prüfe zuerst den weclapp-Standard. Für einfaches Gruppieren nach Auftrag oder Lieferung samt Zwischensumme reicht oft schon Formularwesen > Formularkonfiguration > Rechnungen ohne jede API-Zeile.
-
Jedes eigene
PUTfeuert einen neuenUPDATE-Webhook. Weil weclapp im Webhook nurentityId,entityNameundtypeschickt, muss dein Workflow Belege außerhalb des EntwurfsstatusNEWsofort verwerfen. -
Not-Aus-Zusatzfeld und Soll-Ist-Vergleich bremsen Schleifen sauber. Ein manuelles Sperrfeld in
customAttributesgibt der Buchhaltung im Browser einen echten Not-Aus-Schalter, während ein Soll-Ist-Abgleich aufpositionNumberverhindert, dass bereits sortierte Entwürfe erneut geschrieben werden. -
versionund vollständigesalesInvoiceItemsschützen vor Datenverlust. Nur mit aktuellemversion-Wert greift das Optimistic Locking (HTTP 409 statt stillem Überschreiben), und jede bestehende Position muss mit ihrerid(sowie idealerweise ihrerversion) im Array mitreisen. -
Abgeschaltete Webhooks sind stumm. Nach einem Tag erfolgloser Zustellversuche setzt weclapp
deactivatedDateam Webhook – das merkt keinError Trigger, sondern nur ein geplanter Prüf-Workflow.
Was kann weclapp bei Sammelrechnungen von Haus aus – und wann lohnt sich n8n überhaupt?
Bevor du einen Workflow baust, lohnt ein Blick in die Bordmittel. Laut weclapp-Dokumentation bündelst du mehrere bestätigte Standard-Aufträge (mindestens Status „Auftragsbestätigung erstellt“ und identischer Vertriebsweg) oder Lieferungen eines Kunden per Massenaktion zu einer Sammelrechnung. Über das Belegfeld collectiveInvoicePositionPrintType gruppiert weclapp die Positionen auf dem PDF bereits nativ nach Auftrag ("ORDER_POSITION_GROUP") oder nach Lieferung ("SHIPMENT_POSITION_GROUP"), und unter Formularwesen > Formularkonfiguration auf dem Reiter Rechnungen gibst du im Gruppenkopf und in der Gruppenfußzeile Variablen wie Auftragsnummer (..orderNumber..), Liefernummer (..shipmentNumber..), Kunden-Bestellnummer (..orderNumberAtCustomer..) und Zwischensumme (..groupTotalSum..) aus.
Ein ergänzender n8n-Workflow über die REST API v2 (enthalten ab ERP Dienstleistung und ERP Handel) wird erst dann sinnvoll, wenn diese Standardblöcke im Alltag nicht reichen – etwa wenn Positionen über mehrere Lieferungen hinweg nach Artikelnummer, Kostenstelle oder Lieferdatum umsortiert (positionNumber), durch erklärende Freitextzeilen (itemType: "FREE_TEXT") gegliedert oder vor bestimmten Blöcken mit Seitenumbrüchen (addPageBreakBefore: true) versehen werden sollen. Sollen dabei Felder auftragsbezogener Positionen verändert werden, muss in weclapp unter Globale Einstellungen > Verkauf > Rechnungen zudem die Option „Änderung von Rechnungspositionen erlauben“ aktiv sein.
Fazit: Nutze für reine Auftrags- oder Lieferblöcke den weclapp-Formulardesigner und setze n8n gezielt dort ein, wo Positionen im Entwurf belegübergreifend sortiert oder angereichert werden müssen.
Warum geraten naive Webhook-Workflows auf Verkaufsrechnungen in eine Endlosschleife?
Richtest du unter Globale Einstellungen > Integration > Webhooks einen Webhook auf die Entität salesInvoice für die Ereignisse „erstellt“ und „geändert“ ein, sendet weclapp bei jedem Speichern einen knappen HTTP-POST an deine n8n-Production-URL: Übertragen werden laut Dokumentation ausschließlich entityId, entityName und type (CREATE, UPDATE oder DELETE) – niemals der Beleginhalt selbst.
Liest dein Workflow daraufhin die Rechnung, sortiert salesInvoiceItems neu und schreibt das Ergebnis per PUT /webapp/api/v2/salesInvoice/id/{id}?ignoreMissingProperties=true zurück, wertet weclapp genau diesen Schreibzugriff als erneute Änderung an salesInvoice und feuert sofort den nächsten UPDATE-Webhook. Ohne Schutzlogik ruft sich der Workflow im Sekundentakt selbst auf, füllt die mandantenweite Request-Warteschlange von weclapp (aktuell bis rund 30 Sekunden Wartezeit, danach HTTP 429 Too Many Requests) und zählt die Datensatzversion (version) im Hintergrund hoch.
Hat eine Kolleg:in dieselbe Sammelrechnung zeitgleich im Browser geöffnet, passiert eines von zwei Dingen: Sendet n8n das PUT ohne version, überschreibt die API laut Spezifikation im Stillen jede Zwischenänderung; sendet n8n mit version, lehnt der Browser beim Klick auf Speichern die Eingabe der Person ab, weil die Version im Hintergrund weitergesprungen ist.
Fazit: Auf salesInvoice darf niemals ein ungebremstes „Webhook rein → PUT raus“ laufen – jeder eigene Schreibzugriff löst denselben Trigger erneut aus.
Welche vier Schutzmechanismen machen den n8n-Workflow produktionsfest?
Mit vier klar getrennten Sicherungen in n8n und weclapp beendest du sowohl Endlosschleifen als auch konkurrierende Schreibzugriffe im Browser zuverlässig.

Vier Sicherheitsstufen in n8n: Nur echte Sammelrechnungs-Entwürfe passieren den Eingangsfilter, Not-Aus-Feld und Soll-Ist-Abgleich verhindern Echo-Schleifen, version schützt offene Browser-Sitzungen und ein Takt-Check überwacht die Webhook-Gesundheit.
| Schutzschicht | Technisches Feld / Endpunkt (API v2) | Was ohne diese Sicherung passiert |
|---|---|---|
| 1. Harter Eingangsfilter direkt nach dem Belegabruf |
status === "NEW", salesInvoiceType === "STANDARD_INVOICE", salesChannel, Sammelbeleg-Prüfung (salesOrders bzw. Lieferbezüge) |
Workflow versucht bereits erzeugte Rechnungen (DOCUMENT_CREATED, OPEN_ITEM_CREATED) oder Einzelbelege anderer Kanäle umzubauen |
| 2. Manuelles Not-Aus-Zusatzfeld & Soll-Ist-Idempotenz |
customAttributes (booleanValue: true = manuelle Sperre) + Soll-Ist-Vergleich auf positionNumber vor jedem PUT
|
Das eigene PUT löst sofort den nächsten UPDATE-Lauf aus (Webhook-Loop), oder Sachbearbeiter:innen können Sonderfälle nicht manuell sperren |
| 3. Optimistic Locking & vollständige Positionsliste | Frisches GET vor PUT ?ignoreMissingProperties=true mit Kopf-version und allen salesInvoiceItems (jeweils id + version) |
Positionen ohne id werden gelöscht, und eine fehlende version überschreibt zeitgleiche Browser-Eingaben im Stillen |
| 4. Überwachung stumm abgeschalteter Webhooks | Geplanter GET /webapp/api/v2/webhook auf deactivatedDate != null und errorMessage + Error Trigger
|
Nach Ausfällen deaktiviert weclapp den Webhook dauerhaft; weil keine Aufrufe mehr ankommen, bleibt auch der Error Trigger in n8n stumm |
1. Harte Abbruchbedingung im allerersten Filter-Knoten
Quittiere den eingehenden Webhook in n8n rasch mit HTTP 2xx, prüfe im ersten Filter- oder If-Node entityName === "salesInvoice" (sowie type !== "DELETE") und lies den Beleg gezielt per GET /webapp/api/v2/salesInvoice/id/{entityId} mit gesetztem properties-Parameter und mindestens 60.000 ms Timeout ein. Unmittelbar dahinter blockt ein zweiter Filter-Node alles ab, was nicht exakt status === "NEW", salesInvoiceType === "STANDARD_INVOICE" und den gewünschten salesChannel hat sowie nachweislich eine Sammelrechnung ist – bei Auftrags-Sammelrechnungen über mehrere Einträge in salesOrders, bei Lieferungs-Sammelrechnungen über mehrere unterschiedliche Lieferbezüge in salesInvoiceItemRelationships (oder ein explizites Start-Zusatzfeld). Sobald das Rechnungsdokument erzeugt (DOCUMENT_CREATED) oder als offener Posten gebucht (OPEN_ITEM_CREATED) wurde, endet die Ausführung an dieser Stelle sofort ohne Schreibversuch.
2. Manuelles Not-Aus-Zusatzfeld getrennt vom Soll-Ist-Vergleich
Trenne an dieser Stelle bewusst die manuelle Sperre von der automatischen Schleifenbremse. Lege unter Globale Einstellungen > Zusatzfelder > Zusatzfelder verwalten an der Verkaufsrechnung ein boolesches Zusatzfeld wie „Automatisierung sperren“ an, das ausschließlich Menschen im Browser setzen: Steht dieses Feld auf booleanValue: true, bricht n8n direkt nach dem Lesen ab und rührt Sonderfälle nicht an. Die eigentliche Idempotenz gegen den Echo-Webhook erledigt dein Code-Node vor dem PUT über einen Soll-Ist-Vergleich auf positionNumber und die Gliederungszeilen: Entspricht der Ist-Stand bereits exakt der Zielsortierung, sendet n8n kein PUT und der Bestätigungs-Webhook verpufft sofort – fügt die Buchhaltung dem offenen Entwurf später noch eine Lieferung hinzu, erkennt der nächste Lauf die Abweichung und sortiert sauber nach (optional protokolliert ein zweites Status- oder Zeitstempelfeld den letzten Lauf).
3. Frisches GET vor PUT mit version und vollständigen salesInvoiceItems
Zwischen Beleg-Erstellung im Browser und Webhook-Verarbeitung vergehen oft genau jene Sekunden, in denen jemand im Tab noch einen Einleitungstext ergänzt. Entkopple die Bearbeitung bei Bedarf um wenige Sekunden, hole unmittelbar vor dem Zusammenbauen des Schreib-Payloads noch einmal den aktuellen Stand per GET und sende PUT /webapp/api/v2/salesInvoice/id/{id}?ignoreMissingProperties=true zwingend mit dem gelesenen version-Feld im Body. Laut OpenAPI-v2-Spezifikation übernimmt weclapp bei customAttributes zwar ungenannte Felder aus dem Bestand, behandelt Positionslisten wie salesInvoiceItems aber als vollständige Ersatzliste: Jede bestehende Position muss mit ihrer id im Array enthalten sein, sonst versucht weclapp sie zu löschen; gibst du zusätzlich ihre version je Position mit, greift das Optimistic Locking auch auf Positionsebene. Antwortet weclapp mit HTTP 409 (Optimistic-Lock-Fehler), hat gerade ein Mensch gespeichert – wiederhole das PUT niemals blind mit alten Daten, sondern lies den Beleg frisch ein und prüfe neu.
4. Deaktivierte Webhooks aktiv abfragen statt auf Fehlermails zu hoffen
Ist deine n8n-Instanz wegen Wartung, DNS-Wechsel oder Zertifikatsablauf vorübergehend nicht erreichbar, wiederholt weclapp die Zustellung laut Dokumentation nach 1 Minute, 5 Minuten, 30 Minuten, 5 Stunden und 1 Tag – und deaktiviert den Webhook danach dauerhaft. In der weclapp-API erkennst du diesen Zustand am Endpunkt GET /webapp/api/v2/webhook daran, dass das Zeitstempelfeld deactivatedDate gefüllt ist und errorMessage den letzten Fehler trägt. Weil ein deaktivierter Webhook schlicht keine Anfragen mehr an n8n schickt, löst dein Error Trigger-Workflow nicht aus: Ergänze deshalb einen schlanken Schedule Trigger (z. B. stündlich), der /webhook prüft und dein Team sofort alarmiert, sobald deactivatedDate gesetzt ist.
Fazit: Erst das Zusammenspiel aus Status-Gate, Zusatzfeld-Bremse, version-gebundenem Voll-Array-PUT und aktivem Webhook-Monitoring macht den Ablauf im Tagesgeschäft wartungsarm.
Wann passt ein ereignisgetriebener Webhook-Workflow für Sammelrechnungen nicht?
Selbst mit allen vier Sicherungen ist der sofortige Webhook auf salesInvoice nicht in jedem Betrieb das beste Muster:
- Sachbearbeiter:innen bauen Sammelrechnungen minutenlang von Hand um: Wenn dein Team nach „Sammelrechnung erstellen“ regelmäßig noch fünf Minuten lang manuell Positionen über „Auftrag oder Lieferung hinzufügen“ nachzieht, funkt ein Echtzeit-Webhook unnötig dazwischen. Besser ist dann ein geplanter Lauf im festen Takt oder ein explizites Freigabe-Zusatzfeld („Jetzt gliedern“), das die Person erst nach Abschluss ihrer Handarbeit anhakt.
- Wiederkehrende Vertragsabrechnungen statt Auftrags-Sammelrechnungen: Laufende Wartungs- und Serviceverträge bündelt weclapp über Abrechnungsgruppen im Vertragsmodul; dort gelten eigene Regeln für Sammelabrechnungen statt nachträglicher Positions-Umsortierung.
- Keine klare technische Zuständigkeit im Haus: Ein Workflow, der aktiv in Verkaufsrechnungen schreibt, braucht einen Testmandanten für Vorab-Proben, ein dokumentiertes API-Token eines eigenen Integrationskontos und eine verantwortliche Person für Fehlermeldungen.
Fazit: Wenn Menschen intensiv am offenen Rechnungsentwurf arbeiten, schlägt ein expliziter Start-Haken im Zusatzfeld jeden automatischen Sofort-Trigger beim Anlegen.
Quellen und Grenzen
Stand: 16. November 2026.
- weclapp REST API v2 Spezifikation: OpenAPI 3 YAML (openapi_v2.yaml) (abgerufen am 16.11.2026) – Schemas
salesInvoice,salesInvoiceItem,webhookundcustomAttribute, Verhalten vonPUTmitignoreMissingProperties=truebei Positionslisten vs. Zusatzfeldern, Optimistic Locking überversionsowie Load-Management (Warteschlange bis aktuell 30 s, danach HTTP 429, empfohlener Timeout mindestens 1 Minute). - weclapp Knowledge Base & Handbuch Verkauf: Sammelrechnung Verkauf: Rechnung für mehrere Aufträge/Lieferungen erstellen sowie 10.5 Rechnungen (Globale Einstellungen Verkauf) (aktualisiert am 22.07.2025, beide abgerufen am 16.11.2026) – Formularkonfiguration mit Gruppenkopf- und Gruppenfußzeilen, Voraussetzungen für Sammelrechnungen und Option „Änderung von Rechnungspositionen erlauben“.
- weclapp Knowledge Base & Handbuch Integration: Wie binde ich Webhooks in weclapp ein?, 03. Webhooks, 3.1 Zusatzfelder verwalten, API-Token in weclapp und weclapp Preise & Pakete (alle abgerufen am 16.11.2026) – Webhook-Payload, Wiederholungsintervalle (1, 5, 30 Min., 5 Std., 1 Tag) bis zur Deaktivierung, Zusatzfeld-Anlage und Paketvoraussetzungen der API.
- n8n Dokumentation: Webhook Node, Filter Node, If Node, HTTP Request Node und Handle errors gracefully (Error Workflow) (alle abgerufen am 16.11.2026).
Grenzen dieses Artikels: Die vier Schutzmechanismen verbinden die dokumentierten Eigenschaften der weclapp REST API v2 mit unserer Projekterfahrung im Bau produktiver n8n-Integrationen. Welche Positionsfelder sich an einer konkreten Sammelrechnung ändern lassen, hängt von den Einstellungen deines Mandanten (insbesondere „Änderung von Rechnungspositionen erlauben“ sowie eventuellen Pflicht-Zusatzfeldern) ab; teste jeden Schreib-Workflow vor dem Produktiveinsatz vollständig in einer weclapp-Sandbox. Steuerliche Pflichtangaben auf Sammelrechnungen stimmst du mit deiner Steuerberatung ab.
Weiterlesen: Die Grundlagen zu Triggern, Authentifizierung und den acht häufigsten Alltagsstörungen findest du im Leitfaden n8n mit weclapp: Aufbau eines Workflows und acht Störungen. Wann sich welche Automatisierung im ERP rechnet, zeigt unsere Übersichtsseite zur weclapp-Automatisierung; Details zu parallelen Anfragen und Warteschlangen liest du unter Hat die weclapp API ein Rate Limit? sowie zum unterbrechungsfreien Schlüsselwechsel unter weclapp API-Key ohne Ausfall erneuern.
Häufige Fragen
Warum löst mein n8n-Workflow auf weclapp-Rechnungen eine Endlosschleife aus?
Ein Webhook auf die Entität salesInvoice mit aktiviertem Update-Ereignis feuert bei jeder Speicherung erneut – auch dann, wenn dein eigener n8n-Workflow per PUT eine Änderung zurückschreibt. Ohne harten Statusfilter auf NEW, ein manuelles Not-Aus-Zusatzfeld und einen Soll-Ist-Vergleich vor dem PUT ruft sich der Workflow dadurch immer wieder selbst auf.
Kann weclapp Sammelrechnungen auch ohne n8n nach Auftrag oder Lieferung gruppieren?
Ja. Unter Formularwesen, Formularkonfiguration und Rechnungen gruppiert weclapp Sammelrechnungen im Standard nach Auftrag oder Lieferung und druckt im Gruppenkopf sowie in der Gruppenfußzeile Variablen wie Auftragsnummer, Liefernummer und Zwischensumme. Ein n8n-Workflow ist erst nötig, wenn du Positionen belegübergreifend nach eigenen Regeln sortieren oder Freitextblöcke ergänzen willst.
Wie verhindere ich die Meldung „Eingaben sind verloren gegangen“, während n8n eine Rechnung aktualisiert?
Lies die Rechnung unmittelbar vor dem Schreiben frisch per GET ein und übergib zwingend das aktuelle version-Feld im PUT-Request, damit das Optimistic Locking der weclapp API v2 greift. Zusätzlich kannst du die Verarbeitung nur über ein bewusst gesetztes Zusatzfeld anstoßen oder über einen Not-Aus-Schalter am Beleg pausieren, solange jemand im Browser arbeitet.
Warum verschwinden beim Aktualisieren einer Rechnung per API plötzlich bestehende Positionen?
In der weclapp REST API v2 wird das Array salesInvoiceItems bei einem PUT-Aufruf auch mit gesetztem Parameter ignoreMissingProperties=true als vollständige Ersatzliste verarbeitet. Jede bestehende Position muss deshalb mit ihrer id im gesendeten Array stehen, damit weclapp sie nicht löscht, und zusätzlich ihre version mitführen, damit der Versionsschutz auch auf Positionsebene greift.
Wann schaltet weclapp einen Webhook automatisch ab und wie bemerke ich das in n8n?
Ist deine Webhook-URL nicht erreichbar, wiederholt weclapp die Zustellung laut Dokumentation nach 1, 5 und 30 Minuten, 5 Stunden und einem Tag und deaktiviert den Webhook danach. Da ab diesem Moment keine Aufrufe mehr bei n8n ankommen, prüfst du den Endpunkt GET /webapp/api/v2/webhook regelmäßig per Schedule Trigger auf ein gesetztes Feld deactivatedDate.
Darf mein Workflow auch bereits abgeschlossene oder gebuchte Sammelrechnungen per API umsortieren?
Nein. Positionen einer Verkaufsrechnung dürfen ausschließlich im Entwurfsstatus NEW bearbeitet werden, solange noch kein Rechnungsdokument (DOCUMENT_CREATED) und kein offener Posten (OPEN_ITEM_CREATED) erzeugt wurden. Dein erster Filter-Knoten in n8n sollte deshalb jeden Beleg außerhalb von NEW sofort verwerfen.