Darstellung
Unternehmen & Mandant (SYS07)
Transaktion: SYS07 Unternehmen
UI-Pfad: /company
Business-Zweck
Die Transaktion Unternehmen verwaltet den Mandantenstamm (Company): Name, Domain, Steuerdaten, Bankverbindungen, Wizard-Konfiguration und Cross-Tenant-Einstellungen. Jeder API-Call läuft im Kontext des angemeldeten Mandanten (tenantId aus Session).
Partner benötigen SYS07 für Mandanten-Setup, Demo-Umgebungen, Multi-Mandanten-Strukturen und Feldrechte (SYS11).
Kernbegriffe
| Begriff | Bedeutung |
|---|---|
| Company | Mandant / Unternehmen mit eigener tenantId |
| displayName | Anzeigename in Mandantenauswahl |
| domain | URL-Segment(e) der reybex-Instanz |
| mainCompany | Parent in Cross-Tenant-Hierarchie |
| CrossTenantPropertyCopyConfig | Regeln für automatische Datenreplikation |
| SystemPropertyAccessRights | Feld-Sichtbarkeit je Domäne/Rolle (SYS11) |
| tenantManagementAuthControl | Berechtigung für Mandantenverwaltung |
Fachlicher Ablauf / Workflow
Unternehmensstamm pflegen
- Firmendaten (Name, Adresse, USt-ID, Logo) in SYS07 pflegen
- Speichern via UI oder
POST /api/company/ - Abhängige Module (FIN Elster, SAL Belegkopf) nutzen Company-Daten automatisch
Multi-Mandant (Partner)
- Child-Mandanten über Cross-Tenant-Funktionen anlegen (
/api/crossTenant/createSubCompanyFromTenant) - User erhalten
UserTenant-Zuordnungen (Mandantenwechsel in UI) - Cross-Tenant-Transfers (SYS02) protokollieren Replikation
Feldrechte (SYS11)
- Domänenklasse wählen (
GET /api/company/listDomainClasses) - Rechte je Rolle laden:
POST /api/company/listPropertyAccess - Aktualisieren:
POST /api/company/updatePropertyAccess
Partner-Szenarien
| Szenario | Vorgehen |
|---|---|
| Neue Partner-Demo | POST /api/company/createDemoCompany (öffentlicher Endpoint, nur Demo) |
| Mandant aus Kunde | POST /api/company/createDemoCompanyFromCustomer |
| Konfiguration kopieren | GET/POST /api/company/copyConfigs |
| Partner-Leads verwalten | GET/POST /api/company/partnerLeads |
| Feldrechte für API-User | SYS11 + Company Property-Access-Endpoints |
Voraussetzungen
- Rolle mit Mandantenverwaltung (
CompanyUtil.COMPANY_MANAGEMENT_ROLES) für Cross-Tenant und Logs - Für Partner-Funktionen: Partner-Rolle / vereinbarter Zugang
Auswirkungen im ERP
| Bereich | Auswirkung |
|---|---|
| Alle Module | Mandanten-Isolation (Tenants.withId) |
| FIN | Steuer-/Bankdaten aus Company |
| SAL/PUR | Belegkopf, E-Mail-Absender |
| Cross-Tenant | Stammdaten-Replikation an Child-Mandanten |
| API-Integration | Sichtbare Felder durch SYS11 |
Typische Fehlerquellen
- Falscher Mandant – API-Calls gegen falsche
tenantId→ leere Listen oder 403 - Cross-Tenant ohne Berechtigung –
user.not.allowed.error - Feld nicht in API-Response – SYS11-Feldrecht oder Rolle prüfen