weclapp API: Token erstellen und den ersten Request absetzen
Kurz gesagt: Du erzeugst in weclapp unter „Meine Einstellungen“ ein API-Token und schickst es im Header AuthenticationToken an die Adresse deines Mandanten (https://<TENANT>.weclapp.com/webapp/api/v2/). Mit einem GET auf /party liest du Kund:innen und Lieferanten, Schreibaktionen probierst du zuerst mit dryRun=true.
Dieser Artikel ist Kapitel 1 der weclapp-API-Reihe und für alle, die zum ersten Mal mit der Schnittstelle arbeiten: aus n8n, aus einem Skript oder mit einem Werkzeug wie Postman. Du bekommst den kürzesten Weg vom leeren Blatt zu einer Antwort aus deinem Mandanten, dazu die Fehler, an denen Einsteiger:innen am ersten Tag hängen bleiben.
Das Wichtigste in Kürze
- Das Token gehört einem Benutzer. Jeder Request läuft mit dessen Rechten, ein 403 heißt: Das Token stimmt, aber das Recht fehlt.
- Ein neues Token kann alle früheren ungültig machen. So steht es in der API-Spezifikation. Prüfe vor dem Erzeugen, welche Integrationen das alte Token benutzen.
-
Die Adresse besteht aus Mandant und Version. Nimm
v2; Kund:innen heißen dort/party,/customergibt es nicht. -
Lesen ist harmlos, Schreiben nicht. Teste neue POST-Aufrufe mit
dryRun=true, bevor etwas gespeichert wird.
Was kann die API, und was brauchst du dafür?
Die weclapp API ist eine REST-Schnittstelle: Du sprichst sie über HTTP an und tauschst JSON aus. Sie bindet weclapp an andere Anwendungen an, etwa Shops, Lager oder Automatisierungen. Aktuell ist Version v2, daneben gibt es v1.
Voraussetzung ist das richtige Paket. Laut weclapp-Preisseite ist die API-Schnittstelle nur in ERP Dienstleistung und ERP Handel enthalten, nicht in ERP Starter. Außerdem brauchst du einen Benutzer, dessen Rechte für die Daten reichen, die du abfragen willst. Welche Lizenz ein Benutzer für reine API-Zugriffe braucht, klärst du vorab mit weclapp.
Alle Ressourcen folgen demselben Muster:
| Was du willst | Methode | Pfad |
|---|---|---|
| Liste lesen | GET | /<ressource> |
| Anzahl lesen | GET | /<ressource>/count |
| Einen Datensatz lesen | GET | /<ressource>/id/<id> |
| Anlegen | POST | /<ressource> |
| Ändern | PUT | /<ressource>/id/<id> |
| Löschen | DELETE | /<ressource>/id/<id> |
Nicht jede Ressource unterstützt alle Operationen. Die vollständige Beschreibung als OpenAPI-Datei (JSON oder YAML) bietet weclapp zum Download an.
Fazit: Plane die API als Teil deines Pakets ein, prüfe vorher, ob dein Tarif sie enthält.
Wie erstellst du das API-Token?
Das Token erzeugst du in weclapp unter „Meine Einstellungen“ im Bereich API-Token. Die englische Spezifikation nennt den Pfad „My settings > API“. Es gehört dem Benutzer, der angemeldet ist, und jeder Request mit diesem Token läuft mit genau dessen Rechten. Behandle es wie ein Passwort: Passwortmanager ja, Tabelle, Chat oder Git-Repository nein.
Laut API-Spezifikation macht ein neu erzeugtes Token alle früheren ungültig. In manchen Mandanten legst du stattdessen mehrere benannte Tokens an und löschst sie einzeln. Prüfe vor dem Erzeugen in „Meine Einstellungen“, welcher Fall bei dir gilt und welche Anbindung das alte Token nutzt. Eine Integration mit einem ungültigen Token bekommt ein 401. Wie du ein Token geplant tauschst, steht im Artikel weclapp API-Key erneuern.
Aus unseren Projekten ergibt sich daraus eine Regel: Gib jeder Integration einen eigenen technischen Benutzer. Zwei Integrationen mit demselben Benutzer teilen sich ein Token und damit auch das Risiko, dass ein Austausch beide lahmlegt. Mit einem eigenen Benutzer steuerst du außerdem über seine Rolle, was die Integration darf, und ein Lese-Flow bekommt nur Leserechte.
Fazit: Ein Benutzer, ein Token, eine Integration. Vor dem Erzeugen eines neuen Tokens klärst du, wer das alte nutzt.
Wie sieht die Adresse aus, und welche Version nimmst du?
Jeder Mandant hat eigene Endpunkte. Die Basisadresse lautet:
https://<TENANT>.weclapp.com/webapp/api/v2/
<TENANT> ist die Subdomain, die du aus der Adresszeile von weclapp kennst. Für Neues nimmst du v2. Laut Spezifikation bringt sie unter anderem besseres Verhalten bei POST und PUT, konsistente Zusatzfelder und bessere Fehlerstatus; überholte Endpunkte sind dort entfernt. Nach einem neuen Release bleibt die Vorgängerversion mindestens ein Jahr verfügbar.
Ein Stolperstein für alle, die v1-Beispiele aus dem Netz übernehmen: Kund:innen und Lieferanten liegen in v2 unter /party. Ein Aufruf von /customer liefert in v2 einen Fehler.
Fazit: Basisadresse, Mandant und v2 festlegen, dann /party statt /customer verwenden.
Wie setzt du den ersten Request ab?

Die Spezifikation zeigt als minimalen Aufruf ein curl auf /party mit dem Token im Header. Für den Einstieg begrenzt du die Antwort auf fünf Zeilen und wenige Felder:
curl --compressed \
-H "AuthenticationToken: <TOKEN>" \
-H "Accept: application/json" \
-H "User-Agent: erste-schritte/1.0" \
"https://<TENANT>.weclapp.com/webapp/api/v2/party?pageSize=5&properties=id,partyType,company,customerNumber"
-
AuthenticationTokenträgt dein Token. Alternativ geht HTTP Basic mit dem Benutzernamen*und dem Token als Passwort. -
Accept: application/jsongehört an jeden Request. Bei POST und PUT kommtContent-Type: application/jsondazu. -
--compressedschicktAccept-Encoding: gzip. Die Spezifikation empfiehlt das; curl entpackt die Antwort selbst. -
User-Agentsetzt du bei automatisierten Aufrufen, so verlangt es die Spezifikation. -
pageSizebegrenzt die Zahl der Zeilen,propertiesdie Felder.
Wer ohne Code anfangen will, nimmt die kostenlose Postman Collection 4 weclapp. In n8n legst du im HTTP-Request-Node ein Header-Auth-Credential mit dem Namen AuthenticationToken an.
Zum schnellen Testen eignet sich auch der Browser: Bist du in weclapp angemeldet, authentifiziert die Sitzung jeden Aufruf einer API-Adresse im selben Browser, mit den Rechten dieser Sitzung. Und GET /user/currentUser fragt, mit welchem Benutzer ein Token arbeitet; der Pfad steht in der Spezifikation.
Fazit: Eine kleine Liste mit pageSize=5 und properties ist der sicherste erste Request.
Wie liest du die Antwort?
Eine Liste kommt als JSON-Objekt mit dem Feld result, darin steht ein Array mit den Datensätzen. Die Daten im Beispiel sind erfunden, die Form entspricht der Spezifikation:
{
"result": [
{
"id": "1001",
"partyType": "ORGANIZATION",
"company": "Beispiel GmbH",
"customerNumber": "10001"
}
]
}
Drei Eigenheiten brauchst du von Anfang an. Dezimalzahlen kommen als Text, damit nichts an Genauigkeit verloren geht. Datumsfelder sind Millisekunden seit 1970, ein leerer String gilt als null. Details und Fallen dazu stehen in Datum, Zahlen und Zusatzfelder. Die Statuscodes für den Anfang:
- 200 bei erfolgreichem Lesen oder Ändern, 201 beim Anlegen, 204 beim Löschen.
- 401, wenn das Token fehlt oder falsch ist.
- 403, wenn der Benutzer das Recht nicht hat.
Fehlerantworten sind nicht immer JSON, die Spezifikation nennt auch text/plain. Behandle deshalb jede Antwort außerhalb von 2xx als Fehler, den du lesen musst.
Fazit: Die Daten stehen unter result, 401 betrifft das Token, 403 die Rechte.
Wie geht es mit Filtern weiter?
Ein Filter besteht aus Feldname, Minus und Operator, zum Beispiel createdDate-gt=1398436281262. Mehrere Filter gelten zusammen als UND. Um zu sehen, wie viele Treffer ein Filter liefert, hängst du ihn an /count, etwa /party/count?customerSalesChannel-eq=NET1.
Eine Warnung gleich zu Beginn: Ein Filter auf ein unbekanntes Feld wird laut Spezifikation still ignoriert. Du bekommst die ungefilterte Menge, ohne Fehlermeldung. Vergleiche deshalb die Anzahl mit und ohne Filter. Operatoren, properties, Paging und Batching erklärt Kapitel 2: Filter, Properties und Batching, weitere Beispiele zeigt Stille Fehler der weclapp API.
Fazit: Prüfe jeden neuen Filter mit /count, bevor du dich auf das Ergebnis verlässt.
Wie testest du die erste Schreibaktion?

Mit dem Parameter dryRun=true führt weclapp einen POST oder PUT so weit wie möglich aus und prüft deine Daten. Die Antwort entspricht, soweit möglich, einer echten Ausführung, nur dass bei Erfolg 200 statt 201 kommt und die Meta-Felder id, version, createdDate und lastModifiedDate fehlen. Das Beispiel stammt aus der Spezifikation:
curl --compressed \
-H "AuthenticationToken: <TOKEN>" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-X POST "https://<TENANT>.weclapp.com/webapp/api/v2/salesOrder?dryRun=true" \
-d '{ "customerId": "<KUNDEN-ID>" }'
Bei Erfolg kommt 200. Ist ein Wert falsch, kommt 400 mit einer Liste validationErrors, in der location das betroffene Feld nennt, im Beispiel customerId.
Verlasse dich bei Schreibaktionen nicht allein auf dryRun. Die Spezifikation beschreibt es als Trockenlauf „so weit wie möglich“. Probiere neue Schreibzugriffe daher an einem Testsystem aus, nicht an deinem Produktivmandanten, und lies das Ergebnis danach nach.
Fazit: Erst dryRun=true, dann am Testsystem, erst danach produktiv schreiben.
Welche Fehler treten am ersten Tag auf?
| Symptom | Ursache | Abhilfe |
|---|---|---|
| 401 | Token fehlt, ist falsch geschrieben oder wurde durch ein neues Token ungültig | Header AuthenticationToken prüfen, aktuelles Token aus „Meine Einstellungen“ verwenden |
| 403 | Token stimmt, dem Benutzer fehlt das Recht (bei uns auch bei fehlendem Modul beobachtet) | Rolle des Benutzers prüfen |
Fehler bei /customer
|
Die Ressource gibt es nur in v1 | In v2 /party verwenden |
| Antwort lässt sich nicht als JSON lesen | Header Accept fehlt, oder die Fehlerantwort kommt als text/plain
|
Accept: application/json setzen, Statuscode zuerst prüfen |
| Liste ist größer als erwartet | Filter auf ein unbekanntes Feld wird still ignoriert | Feldname prüfen, Anzahl mit /count vergleichen, siehe stille Fehler
|
| 400 beim Schreiben | Ein Wert ist ungültig oder fehlt |
validationErrors lesen, Feld unter location korrigieren |
| 429 | Zu viele gleichzeitige Anfragen, die Warteschlange läuft nach etwa 30 Sekunden ab | Weniger parallel senden, Timeout von mindestens einer Minute, später erneut versuchen, siehe 429, Backoff und Timeouts |
Die Grundlagen zur Last und warum es kein festes Limit gibt, stehen auf der Seite Rate-Limit der weclapp API.
Fazit: Lies bei jedem Fehler zuerst Statuscode und Fehlertext, bevor du Header oder Pfad änderst.
Quellen und Grenzen
Quellen, abgerufen am 15.11.2026:
- weclapp OpenAPI-Spezifikation v2 (Getting Started, Security and Authentication, Headers, URLs, Filtering, Dry-Run, Load management): https://www.weclapp.com/api/openapi_v2.yaml
- weclapp-Hilfe zur API (Token in „Meine Einstellungen“, Rechte des Benutzers): https://doc.weclapp.com/knowledgebase/gibt-es-eine-api-zu-weclapp/
- weclapp-Preisseite (API nur in ERP Dienstleistung und Handel): https://www.weclapp.com/de/preise/
- weclapp API-Changelog: https://doc.weclapp.com/api-changelog/
Die Hinweise zu technischen Benutzern, /customer in v2 und 403 bei fehlendem Modul stammen aus unseren Projekten. Der Artikel behandelt weder Webhooks noch Last, Batching oder Caching, die Seite weclapp API im Überblick führt zu den weiteren Kapiteln der Reihe. Wenn du dein Token nicht selbst verwalten willst, geht es auch ohne eigenen Code: MCP-Server für weclapp. Für Python gibt es den weclappy-Client. Wortlaut der Menüs und Tarife kann sich ändern, prüfe ihn in deinem Mandanten.
Stand: 15. November 2026
Häufige Fragen
Wo finde ich das API-Token in weclapp?
Unter „Meine Einstellungen“ im Bereich API-Token. Die englische Spezifikation nennt den Pfad „My settings > API“.
Ist die weclapp API in jedem Tarif enthalten?
Nein. Laut weclapp-Preisseite ist die API-Schnittstelle nur in ERP Dienstleistung und ERP Handel enthalten, nicht in ERP Starter.
Was passiert mit meinen Integrationen, wenn ich ein neues Token erzeuge?
Laut API-Spezifikation macht ein neu erzeugtes Token alle früheren ungültig. In manchen Mandanten legst du stattdessen mehrere benannte Tokens an und löschst sie einzeln. Prüfe vor dem Erzeugen in „Meine Einstellungen“, welcher Fall bei dir gilt. Eine Integration mit einem ungültigen Token bekommt ein 401, bis du ein gültiges einträgst.
Warum liefert /customer einen Fehler?
In v2 gibt es die Ressource nicht. Kund:innen und Lieferanten liegen unter /party, partyType unterscheidet Organisation und Person.
Wie probiere ich einen Schreibzugriff aus, ohne Daten zu speichern?
Hänge dryRun=true an den POST oder PUT. weclapp validiert deine Daten und antwortet bei Erfolg mit 200. Teste Neues trotzdem zuerst an einem Testsystem.
Brauche ich eigenen Code, um mit weclapp-Daten zu arbeiten?
Nicht zwingend. Mit Postman oder n8n arbeitest du ohne eigenes Programm, und der MCP-Server von wals.pro AI 4 weclapp bringt die KI an deine weclapp-Daten. Die KI schreibt dort nie ungefragt: Vorschau, Freigabe, Protokoll.