Projekte (PRM01)

Transaktion: PRM01 Alle Projekte
UI-Pfad: /projectList
Controller: ProjectApiController – /api/project

Business-Zweck

PRM01 ist der Projektstamm in reybex. Partner legen hier Hauptprojekte an, strukturieren sie in Phasen und Sprints, verknüpfen Kunden aus CRM/SAL und importieren optional Aufgaben aus Vertriebsauftragspositionen.

Typische Partner-Szenarien:

• PSA-/Projekt-Tool spiegelt reybex-Projekte
• Auftragspositionen (SAL16) werden als Tasks ins Projekt übernommen
• Agile Planung über Phasen → Sprints → Tasks

Kernbegriffe

Begriff	Bedeutung
Project	Projektstamm mit Nummer, Titel, Kunde, Status
mainProject	Übergeordnetes Projekt (Phase/Sprint → Hauptprojekt)
isPhase	Projektphase innerhalb eines Hauptprojekts
isSprint	Sprint innerhalb einer Phase
isTemplate	Vorlage zum Ableiten neuer Projekte
profit	Abrechenbares Projekt (Voraussetzung PRM58)
projectType	Projektart (z. B. Kundenprojekt, Support type=8)
projectStatus	Status mit type (abgeschlossen ab type > 5)
members	Projektbeteiligte (User-Liste)

Projekt-Hierarchie

Phasen und Sprints sind selbst Project-Datensätze mit gesetzten Flags. Die Sortierung erfolgt über sortOrder (Phasen und Sprints innerhalb der Hierarchie).

Fachlicher Ablauf

1. Hauptprojekt anlegen – Kunde, Projekttyp, Zeitraum, ggf. Festpreis
2. Phasen definieren – Meilensteine oder Projektabschnitte
3. Sprints planen – Agile Iterationen pro Phase
4. Tasks zuweisen – manuell (PRM20) oder aus SAL-Positionen
5. Fortschritt tracken – progress, Projektstatus, Beobachtung (ObservedProject)

Partner-Szenarien

Projekt aus Vorlage

Beim Speichern mit shouldCreateFromTemplate=true wird aus einer Projektvorlage ein neues Projekt erzeugt.

Tasks aus Auftragspositionen

Offene Auftragspositionen eines Kunden abrufen und als Tasks importieren:

GET  /api/project/getOpenSalesOrdersForCustomer
POST /api/project/importTasksFromSalesItems

Body für Import:

{
  "projectId": 123456789,
  "salesItemsIds": [987654321, 987654322]
}

Jede SalesItem-Position wird zu einem Task mit Referenz auf salesItem, Budget aus Menge und passendem taskType.

Phasen und Sprints abrufen

GET /api/project/phases/{mainProjectId}
GET /api/project/sprints/{mainProjectId}

Sprint-Reihenfolge in Phasen ändern:

POST /api/project/reorderSprints

Support-Projekte (Cross-Tenant)

Mit Query ?type=support arbeitet die API im Support-Mandanten des Kunden. Relevant für B2B-Support-Szenarien mit Tickets.

Voraussetzungen

• Kunde aus CRM oder SAL Kunden
• Projekttyp und -status mandantenspezifisch konfiguriert
• Partner-Rechte PRM01
• Für SAL-Import: offene Auftragspositionen (SalesItem ohne abgeschlossene Task-Referenz)

Auswirkungen im ERP

Aktion	Auswirkung
Projekt speichern	Nummernkreis (projectNumber), Mitglieder-Zuordnung
Task-Import aus SAL	Task mit salesItem-Referenz, Budget aus Positionsmenge
Projekt löschen	Soft-Delete (isDelete=1), abhängige Tasks gesperrt
profit=1	TaskCosts erscheinen in PRM58 Projektabrechnung

API-Referenz

Details: Project API

Weiterlesen

• Tasks & Kanban
• Aufträge SAL16
• Projektabrechnung PRM58