ERP Holzbau · API-Wiki · Rechte und Rollen

Rechte und Rollen

Jede Route verlangt ein Recht. Benutzer erhalten Rechte über ihre Rollen; die Administration Ihres Betriebs kann eigene Rollen anlegen. Fehlt das Recht, antwortet die API mit 403.

Rechte

Schlüssel	Name	Erlaubt
`masterdata.read`	Stammdaten lesen	Artikel, Lager, Plätze, Lieferanten, Baustellen und Kategorien ansehen.
`masterdata.write`	Stammdaten pflegen	Artikel, Lager, Plätze, Lieferanten, Baustellen und Kategorien anlegen und ändern.
`stock.read`	Bestände lesen	Bestände, Bewegungen, Chargen, Seriennummern und Reservierungen ansehen.
`stock.book`	Buchen	Zugänge, Entnahmen, Umlagerungen, Scannen, Etiketten, Inventur und Bestellungen.
`stock.correct`	Korrigieren	Bestandskorrekturen und Stornos buchen.
`fleet.read`	Flotte lesen	Fahrzeuge, Fahrtenbuch, Prüfungen und Fälligkeiten ansehen.
`fleet.write`	Flotte pflegen	Fahrzeuge anlegen, Fahrten und Prüfungen erfassen, Prüfpläne verwalten.
`hr.read`	Personal lesen	Mitarbeiter, Qualifikationen und Zeiterfassung ansehen.
`hr.write`	Personal pflegen	Mitarbeiter, Qualifikationen und Zeiteinträge anlegen und ändern.
`hr.compensation.read`	Vergütung lesen	Verträge und Vergütungsdaten ansehen.
`hr.compensation.write`	Vergütung pflegen	Verträge und Vergütungsdaten anlegen und ändern.
`sales.read`	Vertrieb lesen	Kunden, Angebote, Rechnungen und Zahlungen ansehen.
`sales.write`	Vertrieb pflegen	Kunden, Angebote, Rechnungen und Zahlungen anlegen, ändern und versenden.
`crm.read`	CRM lesen	Leads, Kontakte, Verkaufschancen, Aktivitäten, Aufgaben und Kampagnen ansehen.
`crm.write`	CRM pflegen	Leads, Kontakte, Verkaufschancen, Aktivitäten, Aufgaben und Kampagnen bearbeiten.
`site.write`	Baustellenakte führen	Tagesberichte, Fotos und Nachweise (Lieferungen, Abnahmen, Mängel, Aufmaß) erfassen und bearbeiten; Berichte einreichen.
`site.approve`	Baustellenakte freigeben	Tagesberichte freigeben oder zurückgeben, Berichte und Nachweise löschen, Mängel abschließen.
`planning.read`	Einsatzplanung lesen	Kalender und Plantafel aller Mitarbeiter, Einsätze, Abwesenheiten und Materialbedarf ansehen. Den eigenen Kalender sieht jeder Benutzer auch ohne dieses Recht.
`planning.write`	Einsätze planen	Einsätze anlegen, verschieben und absagen, Mitarbeiter, Fahrzeuge, Geräte und Material zuteilen, Abwesenheiten eintragen und genehmigen.
`finance.read`	Finanzen lesen	Eingangsrechnungen, Mahnläufe, Mahnungen und Exportprotokolle ansehen.
`finance.write`	Finanzen bearbeiten	Eingangsrechnungen erfassen, prüfen, freigeben und bezahlen; Mahnstufen pflegen, Mahnläufe ausführen, Mahnsperren setzen.
`finance.export`	DATEV-Export	DATEV-Einstellungen pflegen, Buchungsstapel und Stammdaten exportieren, Exporte zurücknehmen.
`users.manage`	Benutzer verwalten	Benutzer anlegen, einladen, sperren, Passwörter zurücksetzen, Sitzungen beenden, Protokoll einsehen.
`roles.manage`	Rollen und Einstellungen verwalten	Rollen mit Rechten anlegen und ändern, Mandanteneinstellungen speichern.

Systemrollen

Diese Rollen bringt jeder Betrieb mit. Sie sind fest; eigene Rollen entstehen durch Kopieren und Anpassen.

Rolle	Kennung	Aufgabe
Administrator	`ADMIN`	Alle Rechte
Lagerleitung	`LAGERLEITUNG`	Lager inkl. Korrekturen und Stammdaten
Lager / Ausgabe	`LAGER`	Buchen, Scannen, Etiketten
Bauleitung	`BAULEITUNG`	Baustellenakte (Tagesberichte, Nachweise, Freigabe), Entnahmen und Zuteilungen
Polier / Vorarbeiter	`POLIER`	Tagesberichte, Fotos und Nachweise auf der Baustelle, Entnahmen und Zuteilungen
Fuhrpark	`FUHRPARK`	Fahrzeuge, Prüfungen, Fahrerzuordnung
Personal	`HR`	Mitarbeiter, Qualifikationen, Verträge und Vergütung
Vertrieb	`VERTRIEB`	Kunden, Angebote, Rechnungen, Zahlungen, CRM
Buchhaltung	`BUCHHALTUNG`	Eingangsrechnungen, Zahlungen, Mahnlauf, E-Rechnung und DATEV-Export
Monteur	`MONTEUR`	Eigener Kalender mit den zugeteilten Einsätzen, Rückmeldung vom Handy
Nur lesen	`LESER`	Alle Listen ohne Vergütungsdaten

Prüfung

Die Rechte des angemeldeten Benutzers stehen in der Antwort von GET /auth/me.
Steht in der Spalte „Recht“ einer Route „angemeldet“, genügt eine gültige Sitzung; der Inhalt der Antwort richtet sich dann nach den Rechten des Benutzers.
Bei Dokumenten hängt das Recht vom Bezug ab: Kunde, Angebot und Rechnung verlangen Vertriebsrechte, Baustelle und Lieferant Stammdatenrechte, Bestellung Lagerrechte, Fahrzeug Flottenrechte, Mitarbeiter Personalrechte.
Verträge, Vergütung und Lohnkosten verlangen zusätzlich die Rechte hr.compensation.read beziehungsweise hr.compensation.write.

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