Skip to main content

​
Übersicht

Dieser Leitfaden erklärt, wie Lieferanten sich mit comstruct integrieren können, um Lieferscheine und Rechnungen automatisch zu übermitteln. Durch die Anbindung an comstruct können Lieferanten ihre Logistikprozesse optimieren und Echtzeit-Lieferinformationen an ihre Auftraggeberkunden bereitstellen.
Um Zugang zur comstruct API zu erhalten, wenden Sie sich an Ihren zuständigen Customer Success Manager. Unser Expertenteam unterstützt Sie gerne bei der optimalen Nutzung unserer API.

​
Was Lieferanten tun können

Als angebundener Lieferant bei comstruct können Sie:
  • Lieferscheine automatisch übermitteln aus Ihren Systemen
  • Rechnungen hochladen zur Verarbeitung
  • Lieferstatus verfolgen in Echtzeit
  • Mit verschiedenen Lieferformaten integrieren (OpenTrans, PAHM, Q-Point, eigene Formate)

​
Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie Folgendes haben:
  1. Einen API-Schlüssel von comstruct
  2. Die entsprechenden Berechtigungen für Ihren API-Schlüssel:
    • deliveries:write - Zum Erstellen von Lieferscheinen
    • invoices:write - Zum Einreichen von Rechnungen
  3. Ihre Lieferanten-ID in comstruct konfiguriert

​
Authentifizierung

Alle API-Anfragen erfordern eine Authentifizierung mittels eines API-Schlüssels im x-api-key-Header. 
curl -X POST "https://api.comstruct.com/v1/deliveries" \
  -H "x-api-key: IHR_API_SCHLUESSEL" \
  -H "Content-Type: application/json" \
  -d '{"..."}'

​
Lieferschein-Integration

​
Standard-Lieferformat

Der einfachste Weg, Lieferscheine zu übermitteln, ist das Standard-JSON-Format. 
{
  "deliveryNumber": "LS-2024-001",
  "deliveryDate": "2024-01-15T08:30:00Z",
  "projectNumber": "PRJ-001",
  "items": [
    {
      "productNumber": "BETON-C30",
      "title": "Beton C30/37",
      "quantity": 25.5,
      "unit": "m³"
    }
  ]
}

​
OpenTrans-Format

Wenn Ihr System OpenTrans unterstützt, können Sie Lieferscheine in diesem standardisierten Format übermitteln. 
curl -X POST "https://api.comstruct.com/v1/deliveries/opentrans" \
  -H "x-api-key: IHR_API_SCHLUESSEL" \
  -H "Content-Type: application/xml" \
  -d '<DESPADV>...</DESPADV>'

​
PAHM-Format

Für PAHM-kompatible Systeme: 
curl -X POST "https://api.comstruct.com/v1/deliveries/pahm" \
  -H "x-api-key: IHR_API_SCHLUESSEL" \
  -H "Content-Type: application/xml" \
  -d '<pahm-delivery>...</pahm-delivery>'

​
Q-Point-Integration

Wenn Sie Q-Point für Qualitätsmanagement verwenden: 
curl -X POST "https://api.comstruct.com/v1/qpoint" \
  -H "x-api-key: IHR_API_SCHLUESSEL" \
  -H "Content-Type: application/json" \
  -d '{...}'

​
Eigenes Format mit KI-Verarbeitung

Für nicht-standardisierte Formate bietet comstruct KI-gestützte Analyse: 
curl -X POST "https://api.comstruct.com/v1/deliveries/custom" \
  -H "x-api-key: IHR_API_SCHLUESSEL" \
  -H "Content-Type: application/octet-stream" \
  --data-binary @lieferschein_dokument.pdf

​
Rechnungseinreichung

​
Standard-Rechnungs-Upload

Reichen Sie Rechnungen zur Verarbeitung mit KI-gestützter Datenextraktion ein: 
curl -X POST "https://api.comstruct.com/v1/invoices/custom" \
  -H "x-api-key: IHR_API_SCHLUESSEL" \
  -H "Content-Type: application/pdf" \
  --data-binary @rechnung.pdf

​
Lieferdaten-Schema

​
Pflichtfelder

FeldTypBeschreibung
deliveryNumberstringEindeutige Lieferscheinnummer (pro Lieferant)
deliveryDatedatetimeISO 8601 formatiertes Lieferdatum

​
Projektzuordnung (mindestens eines empfohlen)

FeldTypBeschreibung
projectIduuidDirekte Projekt-ID (höchste Priorität)
projectNumberstringProjektnummer des Auftraggebers
projectTitlestringProjekttitel für Fuzzy-Matching
customerNamestringKundenname für Projektsuche

​
Optionale Felder

FeldTypBeschreibung
vehicleNumberstringKennzeichen des Lieferfahrzeugs
plantstringWerk/Anlage der Herkunft
commentstringOptionaler Kommentar
documentUrlstringLink zum Lieferschein-Dokument
statusstringLieferstatus (z.B. DELIVERED, IN_TRANSIT)

​
Positionen (items)

FeldTypBeschreibung
items[].titlestringProduktbeschreibung (Pflichtfeld)
items[].productNumberstringIhre Produktreferenz
items[].quantitynumberGelieferte Menge
items[].unitstringMengeneinheit (Standard: “pau”)
items[].typestringProdukttyp (wird automatisch ermittelt wenn nicht angegeben)

​
Best Practices

Eindeutige Referenzen verwenden

Verwenden Sie immer eindeutige Referenznummern für jede Lieferung, um Nachverfolgung zu ermöglichen und Duplikate zu vermeiden.

Projektnummern angeben

Geben Sie immer die Projektnummer des Auftraggebers an, damit Lieferungen korrekt zugeordnet werden.

Vor dem Senden validieren

Validieren Sie Ihr Datenformat lokal, bevor Sie es übermitteln, um Verarbeitungsfehler zu vermeiden.

Fehler behandeln

Implementieren Sie ordnungsgemäße Fehlerbehandlung und Wiederholungslogik für vorübergehende Fehler.

​
Fehlerbehandlung

Die API verwendet Standard-HTTP-Statuscodes:
StatusBeschreibung
200Erfolg
400Ungültiger Anfragekörper oder Validierung fehlgeschlagen
401Nicht autorisiert - ungültiger API-Schlüssel oder fehlende Berechtigung
403Verboten - API-Schlüssel nicht mit Lieferant verknüpft
500Interner Serverfehler

​
Beispiel-Fehlerantwort

{
  "error": "Validation failed",
  "message": "The provided data did not pass validation checks"
}

​
Ihre Integration testen

1

Test-Zugangsdaten erhalten

Fordern Sie Test-API-Zugangsdaten von Ihrem Customer Success Manager an.
2

Test-Lieferung übermitteln

Übermitteln Sie einen Test-Lieferschein mit Beispieldaten, um Ihre Integration zu verifizieren.
3

In comstruct überprüfen

Prüfen Sie in der comstruct-App, ob Ihre Lieferung korrekt angezeigt wird.
4

Live schalten

Sobald die Tests abgeschlossen sind, wechseln Sie zu den Produktionszugangsdaten.

​
Support

Bei Problemen oder Fragen:
  • Kontaktieren Sie Ihren Customer Success Manager
  • E-Mail: [email protected]
  • Sehen Sie sich die API-Referenz für detaillierte Endpunkt-Dokumentation an