> ## Documentation Index > Fetch the complete documentation index at: https://developer.comstruct.com/llms.txt > Use this file to discover all available pages before exploring further. # Lieferkomponenten abrufen > **Erforderliche Berechtigungen:** `deliveries:read` Gibt die einer Lieferung zugeordneten Projektkomponenten zurück, gruppiert nach `group_id`. Jede Gruppe enthält eine gemeinsame Mengenverteilung auf die Positionsbezeichnungen der Lieferung sowie die zugehörigen Komponenten (typischerweise eine pro Komponententyp). ## Übersicht Dieser Endpunkt liefert die einer Lieferung zugeordneten **Projektkomponenten** (Baustoff-/Leistungskomponenten aus dem Projekt), gruppiert nach `group_id`. Jede Gruppe teilt sich eine **Verteilung** der Mengen auf die Positionsbezeichnungen (`title`) der Lieferpositionen — dieselbe Logik wie in der comstruct Web-App für Massenbilanz und Komponentenübersicht. ## Berechtigungen | Scope | Beschreibung | | ----------------- | ----------------- | | `deliveries:read` | Lieferdaten lesen | ## Response-Struktur Die Antwort enthält ein Feld `groups`. Jede Gruppe umfasst: | Feld | Beschreibung | | -------------- | ---------------------------------------------------------------------------------------------------------------------------------- | | `group_id` | UUID der Gruppe | | `distribution` | Objekt mit Mengen je Positionsbezeichnung der Lieferung, z. B. `{ "Beton C30/37": 5.5 }`, oder `null` | | `components` | Liste der zugeordneten Projektkomponenten mit `id`, `component_id`, `component_title`, `component_type_id`, `component_type_title` | ## Response Codes | Code | Beschreibung | | ----- | ---------------------------------------------------------- | | `200` | Erfolg | | `403` | Keine Berechtigung — Lieferung gehört einem anderen Kunden | | `404` | Lieferung nicht gefunden | ## OpenAPI ````yaml GET /deliveries/{id}/components openapi: 3.0.3 info: title: comstruct Public API description: > Die comstruct API ist eine umfassende und flexible Lösung zur Optimierung des Materialbeschaffungsprozesses für Unternehmen. Diese API bietet eine einfache Schnittstelle für Entwickler, um auf Materialbeschaffungsdaten zuzugreifen und diese zu verwalten, einschließlich Lieferanteninformationen, Lieferungen und Projekte. ## Erste Schritte Um Zugang zur comstruct API zu erhalten, wenden Sie sich bitte an Ihren zuständigen Customer Success Manager. Unser Expertenteam steht Ihnen mit erstklassigem Support zur Verfügung, um Ihnen zu helfen, das Beste aus unserer API herauszuholen. ## Authentifizierung Alle API-Endpunkte unter `/v1` erfordern eine Authentifizierung mittels API-Schlüssel im `x-api-key`-Header. Jeder API-Schlüssel hat spezifische Berechtigungen (Scopes), die bestimmen, welche Endpunkte und Operationen verfügbar sind. Die Authentifizierung wird durch Middleware durchgesetzt, die den API-Schlüssel und die Berechtigungen für jede Anfrage validiert. Kalender-Endpunkte unter `/calendars` und IDS-Endpunkte unter `/ids` liegen **ohne** `/v1`-Präfix (Basis-URL `https://api.comstruct.com`). Kalender verwenden Token-basierte Authentifizierung; IDS ist ein öffentlicher Callback ohne API-Schlüssel. ## Datenformate - Alle Zeitstempel sind im ISO 8601-Format (UTC) - Geldbeträge werden als Dezimalzahlen dargestellt - IDs sind UUIDs, sofern nicht anders angegeben ## Anfragegrößenbeschränkungen - PDF-Rechnungsverarbeitung, benutzerdefinierte Rechnungsverarbeitung und Workflow-Verarbeitung: 32MiB - Asynchroner Lieferschein-PDF-Upload (`POST /deliveries/pdf`): 16MiB - Alle anderen Endpunkte: 10MiB ## Fehlerbehandlung Die API verwendet Standard-HTTP-Statuscodes und gibt detaillierte Fehlermeldungen im JSON-Format zurück. Weitere Details finden Sie in den Fehlerschemas. ## Integrationsmuster - **SAP-Integration**: Spezialisierte Endpunkte für SAP-ERP-Systeme - **Projektverwaltung**: Vollständiges Projektlebenszyklusmanagement mit Benutzerrollen - **Lieferverfolgung**: Unterstützung mehrerer Lieferscheinformate (OpenTrans, PAHM, Q-Point, benutzerdefiniert) - **Rechnungsverarbeitung**: Automatisierte Rechnungsanalyse und -validierung mit KI/GPT-Unterstützung - **Auftragsverwaltung**: IDS-Auftragsverarbeitung mit XML-Parsing und Projektkalenderintegration - **Kalenderintegration**: Separate Kalender-Endpunkte für iCalendar-Abonnement-Feeds version: 1.0.10 license: name: Proprietary url: https://comstruct.com contact: name: comstruct ICT GmbH url: https://comstruct.com email: support@comstruct.com termsOfService: https://comstruct.com/datenschutzerklarung/ x-logo: url: https://app.comstruct.com/logo-light-text.png altText: comstruct logo servers: - url: https://api.comstruct.com/v1 description: Haupt-API-Endpunkte (erfordert API-Schlüssel-Authentifizierung) variables: {} - url: https://api.comstruct.com description: Basisserver für Kalender- und IDS-Endpunkte (andere Authentifizierung) variables: {} security: - ApiKey: [] tags: - name: Projects description: Endpunkte für Projekte. - name: Projects (SAP) description: SAP-spezifische Projekt-Endpunkte. - name: Project Regions description: Endpunkte für die Verwaltung von Projektregionen. - name: Deliveries description: Endpunkte für Lieferungen. - name: Deliveries (Supplier) description: Lieferantenspezifische Liefer-Endpunkte. - name: Accounts description: Endpunkte für die Verwaltung von Sachkonten. - name: Payment Terms description: Endpunkte für die Verwaltung von Zahlungsbedingungen. - name: Tax Codes description: Endpunkte für die Verwaltung von Steuercodes. - name: Company Codes description: Endpunkte für die Verwaltung von Buchungskreisen (juristische Einheiten). - name: Suppliers description: Endpunkte für die Verwaltung von Lieferanten. - name: Purchase Orders description: Endpunkte für Bestellungen. - name: Purchase Orders (SAP) description: SAP-spezifische Bestellungs-Endpunkte. - name: Orders (Supplier) description: >- Lieferantenspezifische Bestellungs-Endpunkte (Bestätigung, Ablehnung, Bearbeitung). - name: Suppliers (SAP) description: SAP-spezifische Lieferanten-Endpunkte. - name: Invoices description: Endpunkte für Rechnungen. - name: Invoices (Supplier) description: Lieferantenspezifische Rechnungs-Endpunkte. - name: Invoices (SAP) description: SAP-spezifische Rechnungs-Endpunkte. - name: Invoice Dimensions description: > Rechnungs-Dimensionen (benutzerdefinierte Eigenschaften) und Zuweisungen auf Rechnung (`header`), Position (`line_item`) oder Kontierung (`account`). Dimensionen haben den Typ `option` (vordefinierte Werte) oder `text` (Freitext über `dimension_id` + `text_value`). Bulk-Konto-POST (`/assignments/account/bulk`) unterstützt nur Options-Zuweisungen über `option_ids`; Freitext auf Kontoebene über Einzel-POST, PATCH-Bulk oder Positions-Bulk. - name: Workflows description: Endpunkte für Workflow- und Prozessmanagement. - name: Calendar description: Kalender-Abonnement-Endpunkte mit separater Authentifizierung. - name: Orders description: Endpunkte für Auftragsverarbeitung und -verwaltung. paths: /deliveries/{id}/components: get: tags: - Deliveries summary: Lieferkomponenten abrufen description: > **Erforderliche Berechtigungen:** `deliveries:read` Gibt die einer Lieferung zugeordneten Projektkomponenten zurück, gruppiert nach `group_id`. Jede Gruppe enthält eine gemeinsame Mengenverteilung auf die Positionsbezeichnungen der Lieferung sowie die zugehörigen Komponenten (typischerweise eine pro Komponententyp). operationId: getDeliveryComponents parameters: - name: id in: path required: true schema: type: string format: uuid description: Lieferungs-ID (UUID) responses: '200': description: Komponentengruppen der Lieferung content: application/json: schema: $ref: '#/components/schemas/DeliveryComponentsResponse' '403': $ref: '#/components/responses/Forbidden' '404': description: Lieferung nicht gefunden content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - ApiKey: - deliveries:read components: schemas: DeliveryComponentsResponse: type: object required: - groups properties: groups: type: array items: $ref: '#/components/schemas/DeliveryComponentGroupResponse' ErrorResponse: type: object properties: error: type: string description: Fehlermeldung, die beschreibt, was schiefgelaufen ist message: type: string description: Zusätzliche Fehlerdetails oder benutzerfreundliche Nachricht success: type: boolean description: Zeigt Fehlschlag an, wenn in Fehlerantworten vorhanden anyOf: - required: - error - required: - message - required: - success example: error: Validation failed message: The provided data did not pass validation checks DeliveryComponentGroupResponse: type: object properties: group_id: type: string format: uuid description: Gruppenkennung, die alle Komponenten dieser Gruppe teilen distribution: type: object additionalProperties: type: number nullable: true description: >- Mengen je Positionsbezeichnung der Lieferung (Schlüssel = `title` der Position) example: Beton C30/37: 5.5 components: type: array description: Eine Zeile pro Projektkomponente in dieser Gruppe items: $ref: '#/components/schemas/DeliveryComponentAssignment' DeliveryComponentAssignment: type: object properties: id: type: string format: uuid description: ID der Zuordnungszeile component_id: type: integer description: ID der Projektkomponente component_title: type: string description: Titel der Projektkomponente component_type_id: type: string format: uuid nullable: true description: ID des Komponententyps (Kategorie) component_type_title: type: string nullable: true description: Titel des Komponententyps (Kategorie) responses: Forbidden: description: Verboten - Ungültige oder fehlende Berechtigung content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: invalid_scope: summary: Ungültige Berechtigung value: message: Invalid scope. missing_scope: summary: Fehlende spezifische Berechtigung value: error: 'Unauthorized. Missing scope: projects:write' missing_invoices_scope: summary: Fehlende Rechnungsberechtigung value: error: 'Unauthorized. Missing scope: invoices:write' missing_suppliers_scope: summary: Fehlende Lieferantenberechtigung value: error: 'Unauthorized. Missing scope: suppliers:write' securitySchemes: ApiKey: type: apiKey in: header name: X-API-Key description: > 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. ````