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 überschreiten
- 1 = Ja, aber nur nicht-abrechenbare Zeiten können die Planstunden überschreiten
- 2 = Nein, alle Zeiten können die Planstunden nicht überschreiten
- 3 = Ja, aber nur Reise- oder nicht-abrechenbare Zeiten können die Planstunden überschreiten
- 4 = 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.

GET Projekt-Standorte Projektzeiten