Skip to main content
POST
/
projects
/
sap
curl --request POST \ --url https://api.comstruct.com/v1/projects/sap \ --header 'Content-Type: application/json' \ --header 'X-API-Key: <api-key>' \ --data ' [ { "number": "PRJ-2024-001", "title": "Highway Construction A1", "type": "Infrastructure", "parent_number": "Bavaria", "accounting_area": "LE-001" } ] '
[
  {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "external_id": "EXT-001",
    "title": "Example Site",
    "project_number": "23423420",
    "description": "<string>",
    "region": "Bavaria",
    "project_region_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "active": true,
    "status": "<string>",
    "customer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "address": {
      "address": "<string>",
      "city": "<string>",
      "zip": "<string>"
    },
    "project_invites": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "email": "[email protected]",
        "role": "<string>",
        "role_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "tenant_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
      }
    ]
  }
]

Authorizations

​
X-API-Key
string
header
required

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

Erforderliche Berechtigungen:

  • deliveries:read - Lieferdaten lesen
  • deliveries:write - Lieferungen erstellen und ändern
  • invoices:read - Rechnungsdaten lesen
  • invoices:write - Rechnungen erstellen und ändern
  • projects:read - Projektdaten lesen
  • projects:write - Projekte erstellen und ändern
  • project_regions:read - Projektregionsdaten lesen
  • project_regions:write - Projektregionen erstellen und ändern
  • accounts:read - Kontodaten lesen
  • accounts:write - Konten erstellen und ändern
  • payment_terms:read - Zahlungsbedingungsdaten lesen
  • payment_terms:write - Zahlungsbedingungen erstellen und ändern
  • tax_codes:read - Steuercodedaten lesen
  • tax_codes:write - Steuercodes erstellen und ändern
  • users:read - Benutzerdaten lesen (erforderlich für Projekt-Benutzerverwaltung)
  • roles:read - Rollendaten lesen (erforderlich für Projekt-Rollenzuweisung)
  • tenant_settings:read - Mandanteneinstellungen lesen (erforderlich für Projekterstellung)
  • suppliers:write - Lieferanten erstellen und ändern
  • purchase_orders:write - Bestellungen erstellen

Body

application/json
​
number
string
required

SAP-Projektnummer (wird zu project_number zugeordnet)

Example:

"PRJ-2024-001"

​
title
string
required

Projekttitel

Example:

"Highway Construction A1"

​
type
string
required

Projekttyp (wird zu description zugeordnet)

Example:

"Infrastructure"

​
parent_number
string

Übergeordnete Nummer für Regionssuche (wird zu region zugeordnet)

Example:

"Bavaria"

​
accounting_area
string

Buchungskreis (wird zu legal_entity_number zugeordnet)

Example:

"LE-001"

Response

Projekte erfolgreich erstellt

​
id
string<uuid>

Die eindeutige Kennung des Projekts

​
external_id
string

Die externe Kennung des Projekts

Example:

"EXT-001"

​
title
string

Der Titel des Projekts

Example:

"Example Site"

​
project_number
string | null

Die Projektnummer

Example:

"23423420"

​
description
string

Eine Beschreibung des Projekts

​
region
string

Die Region, in der sich das Projekt befindet, wird für Filterung verwendet

Example:

"Bavaria"

​
project_region_id
string<uuid> | null

Die ID der verknüpften Projektregion

​
active
boolean | null

Steuert, ob das Projekt aktiv ist

​
status
string

Der Status des Projekts

​
customer_id
string<uuid>

Die eindeutige Kennung des Kunden

​
address
object

Die Adressdetails des Projekts

​
project_invites
object[]

Dem Projekt zugewiesene Benutzereinladungen