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",
"legal_entity_number": "LE-001",
"alternative_number": "ALT-PRJ-001",
"latitude": 48.1351,
"longitude": 11.582
}
]
'[
{
"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,
"latitude": 48.1351,
"longitude": 11.582,
"alternative_project_number": "<string>",
"status": "<string>",
"customer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"address": {
"address": "<string>",
"city": "<string>",
"country": "<string>",
"house_number": "<string>",
"zip": "<string>"
},
"legal_entity": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"title": "<string>",
"number": "<string>"
},
"project_invites": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"email": "jsmith@example.com",
"role": "<string>",
"role_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"tenant_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
]
}
]SAP-Projekte erstellen
Erforderliche Berechtigungen: projects:write
Empfängt und verarbeitet Projekte aus dem SAP-System. Akzeptiert ein Array von SAP-Projekten.
Feldzuordnung:
number→project_number: Die SAP-Projektnummertitle→title: Der Projekttiteltype→description: Der Projekttyp/die Beschreibungparent_number→region: Wird für die Projektregionssuche verwendetlegal_entity_number: Wird für die Buchungskreis-Zuordnung verwendetalternative_number→alternative_project_number: Die alternative Projektnummer in SAPlatitude/longitude: Geografischer Standort. Weglassen belässt den gespeicherten Wert;nulllöscht ihn.
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",
"legal_entity_number": "LE-001",
"alternative_number": "ALT-PRJ-001",
"latitude": 48.1351,
"longitude": 11.582
}
]
'[
{
"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,
"latitude": 48.1351,
"longitude": 11.582,
"alternative_project_number": "<string>",
"status": "<string>",
"customer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"address": {
"address": "<string>",
"city": "<string>",
"country": "<string>",
"house_number": "<string>",
"zip": "<string>"
},
"legal_entity": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"title": "<string>",
"number": "<string>"
},
"project_invites": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"email": "jsmith@example.com",
"role": "<string>",
"role_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"tenant_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
]
}
]Autorisierungen
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.
Scopes
Body
SAP-Projektnummer (wird zu project_number zugeordnet)
"PRJ-2024-001"
Projekttitel
"Highway Construction A1"
Projekttyp (wird zu description zugeordnet)
"Infrastructure"
Übergeordnete Nummer für Regionssuche (wird zu region zugeordnet)
"Bavaria"
Buchungskreis / Gesellschaftsnummer
"LE-001"
Alternative Projektnummer in SAP (wird zu alternative_project_number zugeordnet)
"ALT-PRJ-001"
Geografische Breite des Projektstandorts. Weglassen belässt den gespeicherten Wert; null löscht ihn.
-90 <= x <= 9048.1351
Geografische Länge des Projektstandorts. Weglassen belässt den gespeicherten Wert; null löscht ihn.
-180 <= x <= 18011.582
Antwort
Projekte erfolgreich erstellt
Die eindeutige Kennung des Projekts
Die externe Kennung des Projekts
"EXT-001"
Der Titel des Projekts
"Example Site"
Die Projektnummer
"23423420"
Eine Beschreibung des Projekts
Titel der verknüpften Projektregion. Ohne Verknüpfung der gespeicherte Regionstext, sonst null.
"Bavaria"
Die ID der verknüpften Projektregion
Steuert, ob das Projekt aktiv ist
Geografische Breite des Projektstandorts
-90 <= x <= 9048.1351
Geografische Länge des Projektstandorts
-180 <= x <= 18011.582
Alternative Projektnummer zur Referenz, z. B. aus SAP
Der Status des Projekts
Die eindeutige Kennung des Kunden
Die Adressdetails des Projekts
Show child attributes
Show child attributes
Der dem Projekt zugeordnete Buchungskreis
Show child attributes
Show child attributes
Dem Projekt zugewiesene Benutzereinladungen
Show child attributes
Show child attributes