> ## 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. # Purchase orders (SAP) > **Erforderliche Berechtigungen:** `purchase_orders:write` Empfängt und verarbeitet Bestellungen aus dem SAP-System. Akzeptiert ein Array von SAP-Bestellungen als rohe JSON-Daten. API-Schlüssel muss mit einem Kunden verknüpft sein. **Validierung**: Alle Bestellungen müssen die Schemavalidierung bestehen und auf existierende Lieferanten verweisen. **Optionale Felder:** - `alternative_number`: Alternative Bestellnummer in SAP (wird zu `alternative_contract_number` zugeordnet) ## OpenAPI ````yaml POST /purchase-orders/sap 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` verwenden Token-basierte Authentifizierung anstelle von API-Schlüsseln. ## 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 - 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.9 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: /purchase-orders/sap: post: tags: - Purchase Orders (SAP) - Purchase Orders summary: Bestellungen aus SAP-System erstellen description: > **Erforderliche Berechtigungen:** `purchase_orders:write` Empfängt und verarbeitet Bestellungen aus dem SAP-System. Akzeptiert ein Array von SAP-Bestellungen als rohe JSON-Daten. API-Schlüssel muss mit einem Kunden verknüpft sein. **Validierung**: Alle Bestellungen müssen die Schemavalidierung bestehen und auf existierende Lieferanten verweisen. **Optionale Felder:** - `alternative_number`: Alternative Bestellnummer in SAP (wird zu `alternative_contract_number` zugeordnet) operationId: createPurchaseOrdersFromSAP requestBody: required: true content: application/json: schema: type: array items: type: object required: - number - title - creditor_number - items properties: number: type: string title: type: string creditor_number: type: string payment_term: type: string nullable: true alternative_number: type: string nullable: true items: type: array minItems: 1 items: type: object required: - number - title - quantity - cost_bearer_number properties: number: type: string title: type: string quantity: type: number net_price: type: number nullable: true cost_bearer_number: type: string account_number: type: string nullable: true tax_code: type: string nullable: true unit: type: string nullable: true examples: single_material_order: summary: Einzelne Baumaterialbestellung value: - number: PO-2024-001 title: Concrete Materials Order creditor_number: SUPPLIER-123456 payment_term: 30T alternative_number: ALT-PO-001 items: - number: '001' title: Concrete C25/30 quantity: 50 cost_bearer_number: PROJECT-KTR-789 unit: m3 account_number: ACC-4000 tax_code: VAT19 multi_project_order: summary: Bestellung über mehrere Projekte value: - number: PO-2024-002 title: Steel and Concrete Mix Order creditor_number: SUPPLIER-654321 payment_term: 45T alternative_number: ALT-PO-002 items: - number: '001' title: Steel Reinforcement Bars quantity: 100 cost_bearer_number: PROJECT-ABC-123 unit: t account_number: ACC-4100 - number: '002' title: Ready-Mix Concrete quantity: 75 cost_bearer_number: PROJECT-XYZ-456 unit: m3 account_number: ACC-4000 tax_code: VAT19 responses: '201': description: Bestellungsdaten erfolgreich empfangen content: application/json: schema: type: object properties: message: type: string example: Purchase Order data received successfully '400': $ref: '#/components/responses/BadRequest' '401': description: Nicht autorisiert - Fehlende Berechtigung content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: 'Unauthorized. Missing scope: purchase_orders:write' '500': $ref: '#/components/responses/InternalServerError' security: - ApiKey: - purchase_orders:write components: responses: BadRequest: description: Ungültige Anfrage - Ungültige Eingabe oder Validierung fehlgeschlagen content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: validation_error: summary: Feldvalidierungsfehler value: error: Validation failed for field external_id array_expected: summary: Array erwartet value: error: Invalid request body. Expected an array of purchase orders. InternalServerError: description: Interner Serverfehler content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: server_error: summary: Server-Verarbeitungsfehler value: error: The server was unable to process processing_error: summary: Verarbeitungsfehler mit Details value: error: Error processing Purchase Orders message: >- Supplier not found. creditor_number does not match an existing supplier. invoice_processing_error: summary: Rechnungsverarbeitungsfehler value: success: false error: Failed to parse invoice supplier_processing_error: summary: Lieferantenverarbeitungsfehler value: message: Error processing supplier data. schemas: 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 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. ````