Projekt erstellen
Sie können diesen Endpunkt verwenden, um ein neues Projekt zu erstellen.
Request
POST /api/v1/projects
curl --request POST \
--url 'https://www.zep-online.de/zepinstanz/next/api/v1/projects' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {token}' \
--header 'Content-Type: application/json' \
--data '{
"name": "Website Redesign Projekt",
"description": "Vollständige Neugestaltung der Unternehmenswebsite mit modernem UI/UX",
"start_date": "2024-10-01",
"end_date": "2024-12-31",
"project_status_id": "aktiv",
"customer_id": 12345,
"department_id": 1,
"plan_hours": 500.0,
"plan_can_exceed": 2,
"billing_type": "hourly"
}'
Response
{
"data": {
"id": 42,
"name": "Website Redesign Projekt",
"description": "Vollständige Neugestaltung der Unternehmenswebsite mit modernem UI/UX",
"start_date": "2024-10-01T00:00:00.000000Z",
"end_date": "2024-12-31T00:00:00.000000Z",
"project_status_id": "aktiv",
"status": {
"id": "aktiv",
"name": "aktiv",
"description": "Projekt ist aktiv und kann bearbeitet werden",
"bookable": true,
"order": 0,
"color": "#008B00"
},
"comments": null,
"customer_id": 12345,
"department_id": 1,
"plan_hours": "500.0000000000",
"plan_can_exceed": {
"id": 2,
"name": "Nein, alle Zeiten können die Planstunden nicht überschreiten"
},
"billing_type": "hourly",
"created": "2024-09-12T10:30:00.000000Z",
"modified": "2024-09-12T10:30:00.000000Z",
"categories": [],
"dynamicAttributes": [],
"tasks_count": 0,
"employees_count": 0,
"activities_count": 0,
"priceTables": []
}
}
Erforderliche Parameter
- Name
name
- Type
- string
- Description
Der Projektname.
Optionale Parameter
- Name
description
- Type
- string
- Description
Projektbeschreibung.
- Name
start_date
- Type
- date | Y-m-d
- Description
Projektstartdatum.
- Name
end_date
- Type
- date | Y-m-d
- Description
Projektenddatum.
- Name
project_status_id
- Type
- string
- Description
Projektstatuskennung.
- Name
customer_id
- Type
- integer
- Description
ID des zugehörigen Kunden.
- Name
department_id
- Type
- integer
- Description
ID der zugehörigen Abteilung.
- Name
plan_hours
- Type
- float
- Description
Geplante Stunden für das Projekt.
- Name
plan_can_exceed
- Type
- integer | enum
- Description
Ob das Projekt die geplanten Stunden überschreiten kann. Mögliche Werte:
0
= Ja, alle Zeiten können die Planstunden überschreiten1
= Ja, aber nur nicht-abrechenbare Zeiten können die Planstunden überschreiten2
= Nein, alle Zeiten können die Planstunden nicht überschreiten3
= Ja, aber nur Reise- oder nicht-abrechenbare Zeiten können die Planstunden überschreiten4
= Ja, aber nur Reisezeiten können die Planstunden überschreiten
- Name
billing_type
- Type
- string
- Description
Abrechnungstyp (z. B. "hourly", "fixed").
- Name
comments
- Type
- string
- Description
Kommentare oder Notizen zum Projekt.
- Name
cost_object
- Type
- string
- Description
Kostenstellenkennung.
- Name
keywords
- Type
- array
- Description
Array von Schlüsselwörtern, die dem Projekt zugeordnet sind.
- Name
currency
- Type
- string
- Description
Projektwährung (z. B. "EUR", "USD").
- Name
location_address
- Type
- string
- Description
Projektadresse.
- Name
location_city
- Type
- string
- Description
Projektstadt.
- Name
location_country
- Type
- string
- Description
Projektland.