API-Wiki

ERP Holzbau hat eine HTTP-Schnittstelle mit JSON. Die Anwendung im Browser nutzt dieselbe Schnittstelle – alles, was Sie dort tun, geht auch per API. Dieses Wiki beschreibt Anmeldung, Fehlerformat, Rechte und die Routen aller Bereiche.

Grundlagen

Thema	Regel
Basisadresse	`https://www.plattform.sllr-global.com/api`
Format	JSON in Anfrage und Antwort (`Content-Type: application/json`), Zeichensatz UTF-8
Anmeldung	Sitzungs-Token im Kopf `Authorization: Bearer …`
Mandant	Jeder Betrieb ist ein getrennter Mandant. Das Token legt den Mandanten fest; fremde Daten sind nicht erreichbar.
Rechte	Jede Route verlangt ein Recht. Es ergibt sich aus den Rollen des Benutzers – siehe Rechte und Rollen.
Kennungen	Datensätze tragen eine UUID als `id`; Belege zusätzlich eine lesbare Nummer je Jahr.
Zeitangaben	ISO 8601, zum Beispiel `2026-10-04` oder `2026-10-04T07:30:00Z`
Dateien	Hochladen als Base64 im JSON, höchstens 25 MB je Datei

Anmelden

Sie melden sich mit der Kennung Ihres Betriebs, Benutzername und Passwort an. Die Antwort enthält das Token und seinen Ablaufzeitpunkt. Nach fünf Fehlversuchen wird das Konto vorübergehend gesperrt.

curl -s https://www.plattform.sllr-global.com/api/auth/login \
  -H 'Content-Type: application/json' \
  -d '{"tenant":"ihr-betrieb","username":"lager","password":"…"}'

# Antwort: { "token": "…", "expiresAt": "…", "user": { … } }

curl -s https://www.plattform.sllr-global.com/api/stock/levels \
  -H "Authorization: Bearer $TOKEN"

Legen Sie für Programme einen eigenen Benutzer mit genau den Rollen an, die das Programm braucht. Alle Einzelheiten: Anmeldung und Sitzung.

Fehler

Fehler kommen mit passendem Statuscode und einheitlichem Körper:

{ "error": { "code": "…", "message": "…", "details": … } }

Status	Bedeutung
400	Anfrage nicht lesbar
401	Nicht angemeldet oder Token abgelaufen
403	Recht fehlt oder Betrieb nicht aktiv
404	Datensatz nicht gefunden
409	Zustand lässt die Aktion nicht zu – zum Beispiel zu wenig Bestand oder Beleg schon gebucht
422	Eingabe ungültig; `details` nennt Feld und Grund
423	Konto nach zu vielen Fehlversuchen vorübergehend gesperrt
429	Zu viele Anfragen in kurzer Zeit
500	Fehler auf unserer Seite

Bereiche

Bereich	Inhalt
Anmeldung und Sitzung	Anmelden, Sitzung
Stammdaten	Artikel, Einheiten, Kategorien, Lager, Lagerplätze, Lieferanten, Baustellen und Objekte
Bestand und Rückverfolgung	Bestand lesen, Rückverfolgung
Buchungen, Zuteilung und Scan	Buchungen, Zuteilung an Träger, Scan und Etiketten
Inventur, Chargen und Auswertungen	Inventurbelege, Chargen und Auswertungen, Prüfintervalle und Stücklisten, Meldungen
Einkauf, Reservierung und Materialplan	Reservierungen, Bestellungen, Materialplan, Preise, Bewertung
Baustellenakte	Übersichten, Tagesberichte, Nachweise, Fotos, Mängel
Flotte, Prüfungen und Fahrtenbuch	Fahrzeuge, Prüfungen und Fälligkeiten
Personal, Zeiten und Fahrten	Mitarbeiter, Zeiten und Fahrtenbuch, Suche und Protokoll, Benutzer und Rollen
Vertrieb: Kunden, Angebote, Rechnungen	Kunden, Angebote, Rechnungen
CRM	Übersicht und Pipeline, Leads und Kontakte, Verkaufschancen, Aktivitäten und Aufgaben, Kampagnen
Dokumente und Firmenprofil	Dokumente, Firmenprofil und Postausgang
Karte und Geodaten	Karte, Geodaten
Herstellerkatalog	Katalog
Administration	Betrieb und Rollen, Benutzer, Einladungen, Sitzungen

Grenzen

Die Felder der Anfragen und Antworten sind hier nicht einzeln aufgeführt. Ungültige Eingaben beantwortet die API mit 422 und nennt Feld und Grund.
Es gibt keine eigenen API-Schlüssel und keine Webhooks. Programme melden sich wie Benutzer an.
Die Schnittstelle trägt keine Versionsnummer im Pfad.
Routen für den Betreiber der Plattform (Mandanten, Tarife) sind nicht Teil der Kunden-API.

Stand 04.10.2026 · Fehlt etwas oder stimmt etwas nicht? Schreiben Sie uns.