curl --request POST \
  --url https://api.comstruct.com/v1/projects/{id}/work-types \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
[
  {
    "code": "1000",
    "title": "Rohbau",
    "parent": "",
    "description": "Rohbauarbeiten Gebäude A"
  }
]
'

[
  {
    "code": "1000",
    "project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "title": "Rohbau",
    "parent": "100",
    "description": "Rohbauarbeiten Gebäude A",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z"
  }
]

Projekte

Kostenstellen importieren

Erforderliche Berechtigungen: projects:write

Erstellt oder aktualisiert eine oder mehrere Kostenstellen / Arbeitstypen (Struktur) für ein Projekt. Der Abgleich erfolgt über das eindeutige Paar (project_id, code). Doppelte code-Werte in derselben Anfrage behalten die letzte Zeile. Ausgelassene parent- und description-Felder werden als leere Zeichenkette gespeichert, damit ein Re-Import bestehende Werte überschreibt. Leere oder nur aus Leerzeichen bestehende code- oder title-Werte führen zu HTTP 400; der Batch wird nicht teilweise importiert.

POST

projects

{id}

work-types

curl --request POST \
  --url https://api.comstruct.com/v1/projects/{id}/work-types \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
[
  {
    "code": "1000",
    "title": "Rohbau",
    "parent": "",
    "description": "Rohbauarbeiten Gebäude A"
  }
]
'

[
  {
    "code": "1000",
    "project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "title": "Rohbau",
    "parent": "100",
    "description": "Rohbauarbeiten Gebäude A",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z"
  }
]

Übersicht

Importiert Kostenstellen / Arbeitstypen (Struktur) in ein Projekt. Vorhandene Einträge mit demselben code werden aktualisiert (title, parent, description). Die Projekt-ID erhalten Sie z. B. über GET /projects/byProjectNumber/{project_number}.

Berechtigungen

Scope	Beschreibung
`projects:write`	Projekte erstellen und ändern

Verhalten

Der Abgleich erfolgt über (project_id, code).
Doppelte code-Werte in derselben Anfrage behalten die letzte Zeile.
Ausgelassene parent- oder description-Felder werden als leere Zeichenkette gespeichert, damit ein Re-Import bestehende Werte überschreibt.
Leere oder nur aus Leerzeichen bestehende code- oder title-Werte führen zu HTTP 400; der Batch wird nicht teilweise importiert.
parent ist nur eine Nummer — es gibt keine Fremdschlüsselprüfung auf die übergeordnete Kostenstelle.
Gehört das Projekt nicht zum Mandanten des API-Schlüssels, antwortet die API mit 403.

Response Codes

Code	Beschreibung
`201`	Kostenstellen erstellt oder aktualisiert
`400`	Ungültige Anfrage
`401`	Nicht autorisiert
`403`	Projektzugriff verweigert oder Projekt nicht gefunden

Autorisierungen

X-API-Key

string

header

erforderlich

API-Schlüssel zur Authentifizierung. Kontaktieren Sie Ihren Customer Success Manager, um einen API-Schlüssel zu erhalten.

Jeder Endpunkt erfordert spezifische Berechtigungen (Scopes); die erforderlichen Scopes werden pro Endpunkt angezeigt.

Pfadparameter

string<uuid>

erforderlich

Projekt-ID (UUID)

Body

application/json

code

string

erforderlich

Eindeutige Kostenstellennummer innerhalb des Projekts

Beispiel:

"1000"

title

string

erforderlich

Bezeichnung der Kostenstelle

Beispiel:

"Rohbau"

parent

string

Optionale Nummer der übergeordneten Kostenstelle

Beispiel:

"100"

description

string

Optionale Beschreibung der Kostenstelle

Beispiel:

"Rohbauarbeiten Gebäude A"

Antwort

Kostenstellen erfolgreich erstellt oder aktualisiert

code

string

erforderlich

Eindeutige Kostenstellennummer innerhalb des Projekts

Beispiel:

"1000"

project_id

string<uuid>

erforderlich

Projekt-ID

title

string | null

Bezeichnung der Kostenstelle

Beispiel:

"Rohbau"

parent

string | null

Nummer der übergeordneten Kostenstelle

Beispiel:

"100"

description

string | null

Optionale Beschreibung der Kostenstelle

Beispiel:

"Rohbauarbeiten Gebäude A"

created_at

string<date-time>

Erstellungszeitpunkt

updated_at

string<date-time>

Zeitpunkt der letzten Aktualisierung

Übersicht

Projekte

Lieferungen

Rechnungen

Rechnungs-Dimensionen

Lieferanten

Bestellungen

Bestellungen (Lieferanten)

Stammdaten

Q-Point Integration

Workflows

Kalender

IDS Aufträge

Kostenstellen importieren

Übersicht

Berechtigungen

Verhalten

Response Codes

Autorisierungen

Pfadparameter

Body

Antwort

​Übersicht

​Berechtigungen

​Verhalten

​Response Codes

Autorisierungen

Pfadparameter

Body

Antwort

Übersicht

Berechtigungen

Verhalten

Response Codes