Suche
Suche Warenkorb 0

weclapp · Schnittstellen

weclapp API: was sie kann, wo sie endet und wann du die Schnittstelle bauen lässt

Kurz gesagt: weclapp hat eine dokumentierte REST-API mit Token-Anmeldung, Webhooks und einer Lastregelung statt fester Rate-Limits. Sie deckt viele Daten ab, endet aber an Rechten, Paketen, Parallelität und an dem, was fertige Anbindungen schon können. Ob du sie selbst nutzt, ein fertiges Plugin einrichtest oder die Schnittstelle bauen lässt, hängt an deinem Datenweg.

Die weclapp API ist eine REST-Schnittstelle, mit der andere Programme Daten in weclapp lesen, anlegen, ändern und löschen, etwa Kund:innen, Aufträge und Artikel. Die maßgebliche Quelle ist die API-Dokumentation von weclapp.

wals.pro ist weclapp-Partner und verdient an Projekten rund um weclapp.

Das Wichtigste in Kürze

  • Die API ist offen dokumentiert. Aktuell ist Version v2, die Spezifikation lädst du als OpenAPI-Datei herunter.
  • Der Zugang ist ein Token je Benutzer:in. Die API kennt nur die Rechte dieser Person, und laut Preisseite von weclapp ist sie nur in den Paketen ERP Dienstleistung und ERP Handel enthalten.
  • Es gibt keine festen Rate-Limits, aber eine Lastregelung. Viele parallele Anfragen warten in einer Warteschlange und enden nach etwa 30 Sekunden mit HTTP 429.
  • Webhooks melden Ereignisse nur knapp. Die Daten holst du danach per API.
  • Es gibt drei Wege plus KI. Fertiges Plugin, n8n-Workflow, eigene Entwicklung, und für Fälle mit Ermessen die KI mit Freigabe.

Wo finde ich die weclapp API Dokumentation?

Bei weclapp selbst, und zwar an drei Stellen. Die API-Dokumentation beschreibt Endpunkte, Filter und Lastregeln und bietet die OpenAPI-Spezifikation an. Der API-Changelog listet Änderungen je Version. Über den API-Newsletter informiert weclapp laut Dokumentation regelmäßig über geplante Änderungen.

Zum Ausprobieren bieten wir eine Postman Collection kostenlos an.

Starte bei der Herstellerdoku und lade die OpenAPI-Datei, statt Beispielen aus Foren zu folgen.

Wie funktioniert die weclapp REST API?

Jeder Mandant hat seine eigene Basis-Adresse der Form https://MANDANT.weclapp.com/webapp/api/v2/, wobei MANDANT für die Domain deines weclapp steht. Darunter liegen die Ressourcen wie Kund:innen, Aufträge oder Artikel, und alle folgen demselben Muster:

  • Liste abfragen: GET auf die Ressource, die Anzahl liefert GET auf den Zusatz „/count“.
  • Einen Datensatz lesen, ändern, löschen: GET, PUT oder DELETE auf die Adresse des Datensatzes mit dem Zusatz „/id/“ und der ID.
  • Anlegen: POST auf die Ressource.

Nicht jede Ressource unterstützt alle Operationen. Die Schnittstelle spricht nur JSON.

Das Muster ist überall gleich, die Unterschiede stecken in den Eigenschaften je Ressource.

Wie meldest du dich an der API an?

Mit einem API-Token, das jede Benutzer:in in den persönlichen Einstellungen findet. Du sendest es im Header „AuthenticationToken“, alternativ geht HTTP Basic mit dem Benutzernamen „*“ und dem Token als Passwort.

Über die API gelten nur die Rechte der Person, der das Token gehört. Ein neues Token macht laut Dokumentation alle früheren ungültig, den Tausch ohne Ausfall beschreibt weclapp API-Key erneuern.

Ob die API in deinem Paket enthalten ist, entscheidet die Lizenz: Die Preisseite von weclapp nennt die API-Schnittstelle nur für ERP Dienstleistung und ERP Handel. Welche Lizenz ein technischer API-Benutzer braucht, nennt weclapp öffentlich nicht. Kläre das vor dem Kauf mit weclapp oder mit uns.

Das Token ist ein Passwort mit den Rechten einer Person, deshalb gehört es in einen Secret-Speicher und nicht in ein Skript.

Wie fragst du Daten ab: Filter, Seiten, Felder?

Über Query-Parameter. Mit Operatoren wie „-eq“, „-gt“ oder „-in“ filterst du einzelne Eigenschaften, für komplexe Bedingungen gibt es Filter-Ausdrücke. Listen liefern standardmäßig 100 Datensätze, mit „pageSize“ sind laut Dokumentation meist bis zu 1.000 möglich, weitere Ergebnisse holst du mit „page“. Mit „properties“ begrenzt du die Felder, mit „includeReferencedEntities“ holst du verknüpfte Datensätze gleich mit.

Lange Filter sendest du auch per POST auf „/query“ im Body. Schreibzugriffe kannst du mit „dryRun=true“ zunächst im Probelauf prüfen.

Hole wenige große Antworten statt vieler kleiner, denn das schont deinen Mandanten und deine Laufzeit.

Gibt es in weclapp Webhooks?

Ja. Du legst sie in weclapp unter „Globale Einstellungen > Integration > Webhooks“ an, wählst Entität und Ereignis (angelegt, geändert, gelöscht) und trägst die Ziel-URL ein. weclapp sendet dann einen POST mit JSON, der die ID des Datensatzes, den Namen der Entität und den Ereignistyp enthält. Den Inhalt des Datensatzes holst du danach per API.

Ist deine Ziel-URL nicht erreichbar, wiederholt weclapp die Zustellung nach 1 Minute, 5 Minuten, 30 Minuten, 5 Stunden und 1 Tag und deaktiviert den Webhook danach. Der Hilfeartikel beschreibt keine Signatur und keine Anmeldung für den Aufruf. Sichere deine Ziel-URL deshalb selbst ab.

Ein Webhook ist ein Anstoß, kein Datenpaket, und ein deaktivierter Webhook fällt nur auf, wenn du ihn überwachst.

Wo endet die weclapp API?

An vier Stellen. Erstens am Paket und an den Rechten: Wer die API nicht im Paket hat oder dem Token-Benutzer ein Recht nicht gibt, bekommt keinen Zugriff. Zweitens an der Last: weclapp setzt keine festen Rate-Limits, begrenzt aber die gleichzeitigen Anfragen je Mandant. Anfragen darüber werden nicht abgelehnt, sondern warten bis zu 30 Sekunden und enden dann mit HTTP 429.

weclapp empfiehlt Timeouts ab einer Minute, Wiederholung mit wachsendem Abstand und Webhooks statt Polling.

Drittens an der Teilung der Kapazität: Alle Anbindungen eines Mandanten teilen sich dieselbe Grenze. Viertens an der Weiterentwicklung: weclapp erweitert die API laufend und hält sie nach eigener Aussage möglichst stabil, nennt aber auch Fälle, in denen Änderungen nicht abwärtskompatibel sind. Eine ältere Version bleibt nach einem neuen Release mindestens ein Jahr verfügbar. Details stehen unter weclapp API Rate Limit.

Plane Massenläufe und Wiederholungen von Anfang an ein, denn die Grenze zeigt sich erst im Betrieb.

Welche Stolpersteine gibt es?

  • Unbekannte Filter werden still ignoriert. Ein Tippfehler im Eigenschaftsnamen führt dann zu einer ungefilterten Antwort.
  • Ein vollständiges PUT setzt nicht genannte Felder auf null. Hole den Datensatz zuerst, ändere ihn und sende ihn zurück, oder nutze den Parameter „ignoreMissingProperties=true“ und sende immer die „version“ mit, damit der Abgleich bei Änderungen durch andere greift.
  • Zahlen und Daten haben eigene Formate. Dezimalzahlen kommen als Text, Datumswerte als Millisekunden seit 1970, leere Texte zählen als null.
  • Verarbeitet heißt nicht angekommen. Prüfe nach dem Schreiben, ob der Datensatz stimmt.

Die meisten Fehler sind keine Ausfälle, sondern stille Abweichungen, und die findest du nur mit einer Rücklese-Prüfung.

Welche Wege zur Anbindung gibt es?

Prüfe zuerst, was weclapp selbst mitbringt, die Übersicht steht in weclapp Schnittstellen. Reicht das nicht, hast du drei Wege und einen vierten für Fälle mit Ermessen:

Weg Passt, wenn Worauf du achtest
Fertiges Plugin Wiederkehrender Fall wie Marktplatz, Versand oder MSV3 Wer betreut die Anbindung, wenn sich die Gegenseite ändert?
n8n-Workflow Ein Ablauf berührt mehrere Systeme und ändert sich oft Betrieb, Überwachung und ein Fehlerweg
Eigene Entwicklung Spezieller Datenweg, große Mengen, eigene Oberfläche Wiederholung, Last, Pflege nach API-Änderungen
KI mit Freigabe Abfragen und Änderungen mit Ermessen, im Chat Jede Änderung braucht deine Freigabe

Fertige Anbindungen haben wir für Marktplätze, für Versand und für die MSV3-Schnittstelle gebaut. Für n8n haben wir einen quelloffenen Node für weclapp veröffentlicht, und Abläufe starten dort per Webhook von weclapp oder im festen Takt. Für Python gibt es unseren Open-Source-Client weclappy.

Wähle den kleinsten Weg, der deinen Datenweg trägt, und baue erst dann selbst, wenn keine fertige Anbindung ihn kennt.

Wie hilft KI bei der weclapp API?

Willst du keine Schnittstelle programmieren, sondern Daten im Chat abfragen und mit Vorschau ändern, passt wals.pro AI 4 weclapp. Technisch ist das ein gehosteter MCP-Server, der sich mit einem API-Schlüssel aus deinem Dashboard mit deinem Mandanten verbindet. Das geht mit Cloud-Mandanten und mit weclappON, wenn dein Server öffentlich per HTTPS auf Port 443 mit einem öffentlich gültigen Zertifikat erreichbar ist.

Die KI schreibt nie ungefragt: Vorschau, Freigabe, Protokoll. Jede Freigabe gilt genau einmal und ist per SHA-256 an den Inhalt gebunden. Welche Lizenz ein API-Benutzer dafür braucht, klärst du vorab mit weclapp. Mehr dazu unter MCP-Server für weclapp.

KI ist der Weg für Fälle mit Ermessen, für Massenläufe nimmst du ein festes Programm.

Wann lässt du die Schnittstelle bauen?

Wenn dein Datenweg speziell ist oder die Fehlerfälle wehtun. Fünf Fragen klären wir vor der ersten Zeile Code, und du kannst sie vorab selbst beantworten:

  1. Welches System führt? Für jedes Feld genau eine Quelle.
  2. In welche Richtung? Nur lesen, nur schreiben oder beides, je Datenart.
  3. Wie oft? Sofort per Webhook oder im festen Takt.
  4. Was passiert bei einem Fehler? Wiederholen, parken, melden.
  5. Wer betreut sie? Gegenseiten ändern ihre Schnittstellen, und jemand muss das nachziehen.

Für den Bau bekommst du von uns drei Optionen mit festem Umfang und festem Preis. Erst stimmen wir den Inhalt ab, dann nennen wir den Preis. Wie wir bei der Einführung vorgehen, beschreibt weclapp Einrichtung, Lizenzfragen klärt weclapp Preise.

Schon mit den fünf Antworten siehst du, ob eine fertige Anbindung reicht oder ob sich der Bau lohnt.

Wann passt das nicht

  • Du hast ERP Starter. Laut Preisseite von weclapp ist die API dort nicht enthalten, dann brauchst du ein anderes Paket oder eine Anbindung, die ohne API auskommt.
  • Du brauchst nur einen Shop oder Marktplatz im Regelfall. Dann reicht oft die Standardanbindung oder ein fertiges Plugin.
  • Das Gegensystem bietet selbst keine Schnittstelle. Dann entscheidet dieses System, nicht die weclapp API.

Eine eigene Schnittstelle lohnt sich erst, wenn Standard und Plugin nicht tragen, vorher ist sie Pflegeaufwand ohne Ertrag.

Quellen und Grenzen

Stand: 14. November 2026.

  • weclapp API-Dokumentation (OpenAPI-Spezifikation v2), abgerufen am 14. November 2026: Basis-Adresse, Token-Anmeldung, Operationen, Filter, Seiten, Felder, Optimistic Locking, Dry-Run, Formate, Lastregelung, Versionspolitik.
  • weclapp-Hilfe: Gibt es eine API zu weclapp?, abgerufen am 14. November 2026: Token, Rechte, Hinweise zum Umgang.
  • weclapp-Hilfe: Wie binde ich Webhooks in weclapp ein?, abgerufen am 14. November 2026: Einrichtung, Ereignisse, Inhalt, Wiederholungen, Deaktivierung.
  • weclapp-Preisseite, abgerufen am 14. November 2026: Hinweis „API-Schnittstelle (nur DL & Handel)“.
  • Eigene Seiten und Produkte von wals.pro (Schnittstellen, Automatisierung, Rate Limit, MCP-Server, wals.pro AI 4 weclapp, Postman Collection, n8n-Node, weclappy), Stand 14. November 2026.

Grenzen: wals.pro ist weclapp-Partner und verdient an Projekten rund um weclapp. Die API entwickelt sich weiter, prüfe Endpunkte deshalb immer in der aktuellen Spezifikation. Ob ein Paket oder Recht für deinen Fall reicht, klärst du mit weclapp oder mit uns.

Häufige Fragen

Hat weclapp eine API?

Ja. weclapp bietet eine dokumentierte REST-API, aktuell in der Version v2. Laut Preisseite von weclapp (Stand 14. November 2026) ist die API-Schnittstelle in den Paketen ERP Dienstleistung und ERP Handel enthalten, nicht in ERP Starter.

Wo finde ich die weclapp API Dokumentation?

Auf weclapp.com/api. Dort gibt es die Beschreibung der Endpunkte und die OpenAPI-Spezifikation zum Download. Änderungen listet der API-Changelog im weclapp-Supportportal.

Wie melde ich mich an der weclapp API an?

Mit dem API-Token einer Benutzer:in, das du in den persönlichen Einstellungen findest. Du sendest es im Header AuthenticationToken. Die API kennt nur die Rechte der Person, der das Token gehört, und ein neues Token macht die früheren ungültig.

Gibt es in weclapp Webhooks?

Ja. Du legst sie unter Globale Einstellungen, Integration, Webhooks an und wählst Entität und Ereignis. weclapp meldet nur die ID des Datensatzes, die Entität und die Art der Änderung.

Hat die weclapp API ein Rate Limit?

Nicht als feste Zahl pro Minute. weclapp begrenzt die gleichzeitigen Anfragen je Mandant. Anfragen darüber warten bis zu 30 Sekunden in einer Warteschlange und enden danach mit HTTP 429.

Was kostet eine weclapp Schnittstelle?

Das hängt vom Umfang. Bei wals.pro bekommst du drei Optionen mit festem Umfang und festem Preis. Erst stimmen wir den Inhalt ab, dann nennen wir den Preis. Ob eine fertige Anbindung reicht, siehst du an den fünf Fragen im Text.

Weiterlesen