Neue API-Version v7.7.0 wurde veröffentlicht! 🎉
REST Dokumentation
POST Projekt erstellen

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.