Entitätsüberblick
Projekt
Nutze Flowtly-Projekte als Single Source of Truth für PMO und Finance.
Endpoints
GET
/api/projects
Projekte auflisten
Liest Projekte mit Filtern nach Kunde, Status oder Vertragstyp.
POST
/api/projects
Projekt erstellen
Legt ein Projekt mit Billing-Typ, Kunde und Zeitplan an.
GET
/api/projects/{id}
Projekt per ID abrufen
Zeigt Details zu Projektmitgliedern, Währung und Feldern.
PATCH
/api/projects/{id}
Projekt aktualisieren
Projektstammdaten, Termine oder Abrechnungsart per PATCH ändern.
GET
/api/projects/preview
Preview projects
Preview project data before creation.
GET
/api/projects/search
Search projects
Search projects by filters.
GET
/api/projects/{id}/profitability
Get project profitability
Inspect profitability metrics for a project.
Anwendungsfälle
Erstelle Projekte aus dem CRM nach Deal-Gewinn, um Staffing zu starten.
Aktualisiere Projektstatus aus externen Tools, damit Flowtly-Prognosen stimmen.
Schemafelder
Project-project.read| Feld | Typ | Beschreibung |
|---|---|---|
id |
integer | Interne Projekt-ID. |
client |
string | null | IRI des Kunden. |
currency |
string | null | Währung für Billing und Budgets. |
dateFrom |
string | null | Geplanter Projektstart. |
dateTo |
string | null | Geplantes Projektende. |
name |
string | Projektname. |
publicDescription |
string | null | Öffentlich sichtbare Beschreibung. |
type |
string | Abrechnungsmodell, z. B. fixed-price oder T&M. |
clientHash |
string | Gehashter Kunden-Identifier für Dedupe. |
notes |
string | null | Interne Notizen. |
color |
string | Farbcode zur Anzeige. |
priceNet |
string | null | Netto-Projektpreis (falls gesetzt). |
taxGroup |
string | null | IRI der Steuergruppe. |
projectMembers |
array | Liste der Mitglieder-IRIs. |
status |
string | Lifecycle-Status des Projekts. |
flattenType |
string | Normalisierter Projekttyp in Flowtly. |
Beispiele
POST
/api/projects
Projekt „Aurora Rollout“ erstellen
Fügt ein T&M-Projekt mit CRM-Kunde und geplanten Terminen hinzu.
Request-Payload
{
"name": "Aurora Rollout",
"type": "time-and-material",
"currency": "/api/currencies/EUR",
"client": "/api/clients/cl_901",
"dateFrom": "2024-06-01T00:00:00+00:00",
"dateTo": "2024-12-31T00:00:00+00:00",
"notes": "Expansion to Germany and France"
}
Response-Payload
{
"@id": "/api/projects/prj_aurora",
"@type": "Project",
"id": 9821,
"name": "Aurora Rollout",
"type": "time-and-material",
"currency": "/api/currencies/EUR",
"client": "/api/clients/cl_901",
"dateFrom": "2024-06-01T00:00:00+00:00",
"dateTo": "2024-12-31T00:00:00+00:00",
"status": "active"
}