Teilaufgabe erstellen

Mit diesem Endpunkt können Sie eine neue Teilaufgabe zu einem bestehenden Ticket hinzufügen.

Request

curl --request POST \
     --url 'https://www.zep-online.de/zepinstanz/next/api/v1/tickets/123/subtasks' \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer {token}' \
     --header 'Content-Type: application/json' \
     --data '{
  "subject": "Datenbankoptimierung durchführen",
  "name": "DB-Optimierung Phase 1",
  "creator_username": "max.mustermann",
  "status": 1,
  "categories": ["Performance", "Backend"],
  "start_date": "2024-11-20",
  "deadline": "2024-11-25",
  "planned_hours": 12.5,
  "processor_username": "anna.mueller"
}'

Parameter

• id (integer, erforderlich): Die ID des übergeordneten Tickets

Pflichtfelder

• subject (string): Betreff der Teilaufgabe (max. 255 Zeichen)
• name (string): Name/Titel der Teilaufgabe (max. 255 Zeichen)
• creator_username (string): Benutzername des Erstellers (erforderlich, wenn customer_contact_person nicht angegeben)
• status (integer): Status der Teilaufgabe
  • 1 - STATUS_NEW: Neue Teilaufgabe
  • 2 - STATUS_IN_PROCESS: Teilaufgabe wird bearbeitet
  • 3 - STATUS_DONE: Teilaufgabe ist abgeschlossen
  • 4 - STATUS_REJECTED: Teilaufgabe wurde abgelehnt
  • 5 - STATUS_APPROVED: Teilaufgabe wurde genehmigt
  • 8 - STATUS_BILLED: Teilaufgabe wurde abgerechnet
• categories (array): Array von Kategorienamen

Optionale Felder

• customer_reference (string): Kundenreferenznummer (max. 255 Zeichen, erforderlich wenn creator_username nicht angegeben)
• start_date (string): Startdatum der Bearbeitung (Format: YYYY-MM-DD)
• receipt_date (string): Eingangsdatum (Format: YYYY-MM-DD)
• deadline (string): Fälligkeitsdatum (Format: YYYY-MM-DD)
• planned_hours (number): Geschätzte Stunden zur Fertigstellung
• prevent_overbooking (integer): Überbuchungsverhinderung
  • 0 - YES_ALL: Alle Arbeiten können geplante Stunden überschreiten
  • 1 - YES_ONLY_NON_BILLABLE: Nur nicht abrechenbare Arbeiten
  • 2 - NO_ALL: Keine Arbeiten können überschreiten
  • 3 - YES_TRAVEL_OR_NON_BILLABLE: Reise- oder nicht abrechenbare Arbeiten
  • 4 - YES_ONLY_TRAVEL: Nur Reisearbeiten
• processor_username (string): Benutzername des Bearbeiters
• keywords (string): Kommagetrennte Schlüsselwörter/Tags (max. 255 Zeichen)
• customer_contact_person (string): E-Mail des Kundenkontakts (erforderlich, wenn creator_username nicht angegeben)

Response

{
	"data": {
		"id": 456,
		"ticket_id": 123,
		"subject": "Datenbankoptimierung durchführen",
		"name": "DB-Optimierung Phase 1",
		"status": 1,
		"creator_username": "max.mustermann",
		"processor_username": "anna.mueller",
		"start_date": "2024-11-20",
		"deadline": "2024-11-25",
		"planned_hours": "12.50",
		"created": "2024-11-18T14:30:00.000000Z",
		"modified": "2024-11-18T14:30:00.000000Z",
		"categories": [
			{
				"id": 22,
				"name": "Performance"
			},
			{
				"id": 18,
				"name": "Backend"
			}
		]
	}
}

Fehlercodes

• 401 Unauthorized: Ungültige oder fehlende Authentifizierung
• 404 Not Found: Übergeordnetes Ticket nicht gefunden
• 422 Unprocessable Entity: Validierungsfehler

Hinweise

• Die Teilaufgabe wird dem Ticket mit der angegebenen ID zugeordnet
• Entweder creator_username oder customer_contact_person muss angegeben werden
• Alle Benutzernamen müssen gültige Mitarbeiter-Benutzernamen sein
• Kategorien müssen in der Kategorientabelle vorhanden sein
• Die Teilaufgabe erbt Berechtigungen vom übergeordneten Ticket