weclapp API Beispiele: offene Rechnungen, Bestand und Aufträge – mit oder ohne Code

Die weclapp-API in zwei Minuten

weclapp hat eine REST-API, die fast alles abdeckt, was Sie in der Anwendung sehen: Artikel, Kunden und andere Parteien, Angebote, Aufträge, Rechnungen, Lieferungen und Lagerbestände. Jedes Unternehmen hat seine eigene Adresse:

https://your-company.weclapp.com/webapp/api/v2/

Jede Anfrage enthält einen API-Token im Header AuthenticationToken. Der Token gehört zu einem weclapp-Benutzer und hat dessen Rechte. Sie erstellen ihn in Ihren persönlichen weclapp-Einstellungen.

Listen erreichen Sie über den Namen der Entität, etwa /salesInvoice oder /article. Einige wenige Abfrageparameter erledigen den Großteil der Arbeit:

Parameter	Was er bewirkt	Beispiel
<field>-eq und andere Operatoren	Nach einem Feld filtern	paymentStatus-eq=OPEN
properties	Nur ausgewählte Felder zurückgeben	properties=invoiceNumber,dueDate,grossAmount
page und pageSize	Durch lange Listen blättern	page=2&pageSize=100
/count	Zählen statt auflisten	/salesInvoice/count?paymentStatus-eq=OPEN

Welche Felder und Operatoren Ihnen genau zur Verfügung stehen, sehen Sie in der interaktiven API-Referenz in Ihrem eigenen weclapp-Konto.

Beispiel 1: offene Rechnungen

GET /webapp/api/v2/salesInvoice?paymentStatus-eq=OPEN&properties=invoiceNumber,invoiceDate,dueDate,grossAmount
AuthenticationToken: <your token>

weclapp unterscheidet Zahlungsstatus wie OPEN, PAID und NO_OPEN_ITEM. Um überfällige Rechnungen zu finden, vergleichen Sie dueDate in Ihrem eigenen Code mit dem heutigen Datum. weclapp speichert Datumsangaben als Zeitstempel. Wandeln Sie sie also um, bevor Sie sie jemandem zeigen.

Beispiel 2: Wie viele Rechnungen sind offen?

GET /webapp/api/v2/salesInvoice/count?paymentStatus-eq=OPEN

Die Antwort ist eine einzige Zahl – ideal für ein Dashboard oder eine schnelle Prüfung.

Beispiel 3: aktuelle Aufträge

GET /webapp/api/v2/salesOrder?properties=orderNumber,orderDate,status,netAmount&pageSize=50

Mit einem Filter auf orderDate oder status grenzen Sie die Liste ein. Für den Umsatz pro Kunde müssten Sie Aufträge mit den Daten der Parteien verknüpfen und die Ergebnisse selbst gruppieren.

Beispiel 4: Lagerbestände

GET /webapp/api/v2/warehouseStock?pageSize=100

Der Bestand wird pro Artikel und Lager gespeichert. Um die Frage „Welche Artikel gehen bald aus?“ zu beantworten, brauchen Sie zusätzlich die Absatzhistorie. Damit wird daraus ein kleines Datenprojekt.

Wo die API für ein Unternehmen teuer wird

Die Anfragen oben sind einfach. Die Arbeit drumherum ist es nicht:

• Daten verknüpfen. Die meisten geschäftlichen Fragen kombinieren mehrere Entitäten, etwa Rechnungen, Parteien und Zahlungen.
• Seiten und Limits. Große Listen erfordern Schleifen, Wiederholungen und Fehlerbehandlung.
• Den Token schützen. Skripte, Tabellen und Integrationswerkzeuge sammeln mit der Zeit Kopien davon.
• Sicher schreiben. Ein PUT auf den falschen Artikel ändert Ihre Live-Daten. Ein eingebautes „Bitte erst prüfen“ gibt es nicht.
• Wartung. Jede neue Frage bedeutet neuen Code – und wer ihn geschrieben hat, ist im nächsten Jahr vielleicht nicht mehr da.

Dieselben Antworten ohne Code

Steward nutzt dieselbe weclapp-API, aber Ihr Team fragt in normaler Sprache. Steward kennt die Entitäten, Felder und Filter von weclapp bereits, baut die Anfragen, blättert durch die Ergebnisse und führt sie zusammen.

Statt …	Fragen Sie Steward
Beispiel 1	„Welche Rechnungen sind überfällig, und wie hoch ist die Summe? Gruppiere sie nach Kunde.“
Beispiel 2	„Wie viele Rechnungen sind noch offen?“
Beispiel 3	„Vergleiche den Auftragsumsatz pro Kunde in diesem Quartal mit dem Vorquartal.“
Beispiel 4	„Welche Artikel sind beim aktuellen Absatz innerhalb von zwei Wochen ausverkauft?“

Drei Dinge sind anders als bei einem Skript:

1. Der Token bleibt geschützt. Ein Administrator verbindet weclapp einmalig. Der Token wird verschlüsselt gespeichert und nie angezeigt. Auch die KI erhält ihn nie. Code, den Steward für eine Analyse schreibt, läuft ohne Ihre Zugangsdaten.
2. Projektrollen. Betrachter verfolgen Ergebnisse, Mitwirkende nutzen eingerichtete Verbindungen und bereiten Änderungen vor, Projektmanager genehmigen. Eingeladene Projektmitglieder benötigen keine separate Verbindungsfreigabe.
3. Zum Genehmigen oder Ablehnen benötigen Sie Projektmanagerzugriff auf das Projekt des Vorschlags. Mitwirkende können Änderungen vorbereiten und die Details prüfen. Vor der Ausführung werden der aktuelle Projektzugriff der ausführenden Person und die aktivierte Verbindung erneut geprüft.

Wann Sie die API direkt nutzen sollten

Nutzen Sie die API direkt für dauerhafte Integrationen, etwa die Synchronisierung eines Webshops, die Anbindung eines Logistikdienstleisters oder eine eigene Anwendung. Nutzen Sie Steward für die Hunderten von Fragen, die Ihr Team zwischen diesen Integrationen stellt. Für diese Fragen lohnen sich selten ein Entwickler, ein Skript und ein Wartungsplan.

Jetzt starten

Verbinden Sie weclapp, aktivieren Sie die Verbindung für ein Projekt und stellen Sie eine der Fragen oben im Modus Nur lesen. Einen breiteren Vergleich der KI-Möglichkeiten finden Sie in weclapp mit KI nutzen.