Ticket erstellen

Mit diesem Endpunkt können Sie ein neues Ticket erstellen.

Request

curl --request POST \
     --url 'https://www.zep-online.de/zepinstanz/next/api/v1/tickets' \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer {token}' \
     --header 'Content-Type: application/json' \
     --data '{
  "status": 1,
  "project_id": 456,
  "project_task_id": "12",
  "priority": 3,
  "subject": "Fehler in der Benutzeroberfläche beheben",
  "planned_hours": 8.5,
  "creator_username": "max.mustermann",
  "receipt_date": "2024-11-15",
  "processor_username": "anna.mueller",
  "start_date": "2024-11-16",
  "deadline": "2024-11-20",
  "categories": ["Bug", "UI"]
}'

Pflichtfelder

• status (integer): Ticket-Status
  • 1 - STATUS_NEW: Neues Ticket
  • 2 - STATUS_IN_PROCESS: Ticket wird bearbeitet
  • 3 - STATUS_DONE: Ticket ist abgeschlossen
  • 4 - STATUS_REJECTED: Ticket wurde abgelehnt
  • 5 - STATUS_APPROVED: Ticket wurde genehmigt
  • 8 - STATUS_BILLED: Ticket wurde abgerechnet
• project_id (integer): ID des Projekts
• project_task_id (string): ID der Projektaufgabe
• priority (integer): Priorität von 1 (niedrigste) bis 5 (höchste)
• subject (string): Ticket-Betreff/Titel (max. 255 Zeichen)

Optionale Felder

• planned_hours (number): Geschätzte Stunden zur Fertigstellung
• creator_username (string): Benutzername des Erstellers (erforderlich, wenn customer_contact_person nicht angegeben)
• receipt_date (string): Eingangsdatum (Format: YYYY-MM-DD)
• processor_username (string): Benutzername des Bearbeiters
• start_date (string): Startdatum der Bearbeitung (Format: YYYY-MM-DD)
• deadline (string): Fälligkeitsdatum (Format: YYYY-MM-DD)
• from_mail (string): E-Mail-Adresse, von der das Ticket erstellt wurde
• external_ticket_number (string): Externe Ticketnummer (max. 255 Zeichen)
• notify_of_completion (boolean): Benachrichtigung bei 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
• customer_contact_person (string): E-Mail des Kundenkontakts (erforderlich, wenn creator_username nicht angegeben)
• customer_reference (string): Kundenreferenznummer (max. 255 Zeichen)
• keywords (string): Kommagetrennte Schlüsselwörter/Tags (max. 255 Zeichen)
• categories (array): Array von Kategorienamen

Response

{
	"data": {
		"id": 789,
		"status": 1,
		"project_id": 456,
		"project_task_id": "12",
		"priority": 3,
		"subject": "Fehler in der Benutzeroberfläche beheben",
		"planned_hours": "8.50",
		"creator_username": "max.mustermann",
		"receipt_date": "2024-11-15",
		"processor_username": "anna.mueller",
		"start_date": "2024-11-16",
		"deadline": "2024-11-20",
		"created": "2024-11-15T10:30:00.000000Z",
		"modified": "2024-11-15T10:30:00.000000Z",
		"categories": [
			{
				"id": 15,
				"name": "Bug"
			},
			{
				"id": 28,
				"name": "UI"
			}
		]
	}
}

Fehlercodes

• 401 Unauthorized: Ungültige oder fehlende Authentifizierung
• 422 Unprocessable Entity: Validierungsfehler

Hinweise

• Entweder creator_username oder customer_contact_person muss angegeben werden
• Alle Benutzernamen müssen gültige Mitarbeiter-Benutzernamen sein
• Das Projekt und die Projektaufgabe müssen existieren
• Kategorien müssen in der Kategorientabelle vorhanden sein