curl --request POST \
  --url https://api.comstruct.com/v1/deliveries \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "deliveryNumber": "LS-2024-001234",
  "deliveryDate": "2024-01-15T08:30:00Z",
  "projectNumber": "PRJ-2024-001",
  "items": [
    {
      "title": "Beton C30/37",
      "quantity": 8.5,
      "unit": "m3",
      "productNumber": "BET-C30-37"
    }
  ]
}
'

{
  "success": true,
  "message": "Delivery note has no changes"
}

Deliveries

Create delivery

Erforderliche Berechtigungen: deliveries:write

Erstellt einen neuen Lieferschein im System. Dieser Endpunkt wird typischerweise von Lieferanten verwendet, um Lieferinformationen zu übermitteln.

Erforderliche Felder:

deliveryNumber: Eindeutige Lieferscheinnummer vom Lieferanten
deliveryDate: Datum und Uhrzeit der Lieferung (ISO 8601-Format)

Projektzuordnung: Die Lieferung kann mit einem Projekt verknüpft werden, indem einer der folgenden Werte verwendet wird (in Reihenfolge der Priorität):

projectId: Direkte UUID-Referenz zum Projekt
projectNumber: Projektnummer für automatischen Abgleich
projectTitle: Projekttitel für Fuzzy-Matching
customerName: Kundenname für Projektsuche

Positionen: Jede Lieferung sollte mindestens eine Position mit einem title enthalten. Das type-Feld ist optional und wird automatisch basierend auf Titel und Einheit bestimmt, wenn nicht angegeben.

POST

deliveries

curl --request POST \
  --url https://api.comstruct.com/v1/deliveries \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "deliveryNumber": "LS-2024-001234",
  "deliveryDate": "2024-01-15T08:30:00Z",
  "projectNumber": "PRJ-2024-001",
  "items": [
    {
      "title": "Beton C30/37",
      "quantity": 8.5,
      "unit": "m3",
      "productNumber": "BET-C30-37"
    }
  ]
}
'

{
  "success": true,
  "message": "Delivery note has no changes"
}

PDF document

An optional PDF delivery note can be provided in the documentUrl field. The field accepts both Base64 formats:

Format	Example
Raw Base64	`"documentUrl": "JVBERi0xLjcK..."`
Data URI	`"documentUrl": "data:application/pdf;base64,JVBERi0xLjcK..."`

Despite its name, documentUrl does not accept an HTTP(S) URL. Provide the PDF content directly as raw Base64 or as a data URI.

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.

Jeder Endpunkt erfordert spezifische Berechtigungen (Scopes); die erforderlichen Scopes werden pro Endpunkt angezeigt.

Body

application/json

deliveryNumber

string

required

Die Referenznummer für die Lieferung. Muss für den Lieferanten eindeutig sein.

Example:

"1234'23"

deliveryDate

string<date-time>

required

Datum und Uhrzeit der Lieferung. Muss im ISO 8601-Format sein.

Example:

"2024-01-15T08:30:00Z"

projectNumber

string

Die Projektnummer, zu der die Lieferung gehört. Wird für die Zuordnung der Lieferung zu einem Projekt verwendet.

Example:

"PRJ-2024-001"

projectTitle

string

Der Titel des Projekts. Kann als Alternative zur projectNumber für die Projektzuordnung verwendet werden.

Example:

"Highway Construction A1"

supplierId

string<uuid>

write-only

Die ID des Lieferanten, zu dem die Lieferung gehört.

projectId

string<uuid>

Die ID des Projekts, zu dem die Lieferung gehört. Wenn angegeben, hat diese Vorrang vor projectNumber.

customerName

string

Der Name des Kunden, der die Lieferung erhält. Kann für die Projektzuordnung verwendet werden.

Example:

"Bauunternehmen Müller GmbH"

vehicleNumber

string

Das Kennzeichen des Fahrzeugs, mit dem die Lieferung transportiert wird.

Example:

"M-AB 1234"

plant

string

Der Name oder die Kennung des Werks/der Anlage, von der die Lieferung stammt.

Example:

"Werk München-Nord"

documentUrl

string

Optionales, Base64-kodiertes PDF des Lieferscheins. Beide Formate werden unterstützt: rohes Base64 (z. B. JVBERi0xLjcK...) und eine vollständige Data-URI (z. B. data:application/pdf;base64,JVBERi0xLjcK...). HTTP(S)-URLs werden trotz des Feldnamens nicht unterstützt.

Example:

"data:application/pdf;base64,JVBERi0xLjcK..."

comment

string

Ein optionaler Kommentar zur Lieferung.

status

string

Der Status der Lieferung (z.B. DELIVERED, IN_TRANSIT, PENDING).

Example:

"DELIVERED"

items

object[]

Eine Liste der in der Lieferung enthaltenen Positionen.

Show child attributes

Response

Lieferschein empfangen, aber keine Änderungen vorgenommen (Duplikat oder unverändert)

success

boolean

Example:

true

message

string

Example:

"Delivery note has no changes"

Overview

Projects

Deliveries

Invoices

Invoice dimensions

Suppliers

Purchase orders

Orders (Supplier)

Master data

Q-Point Integration

Workflows

Calendar

IDS Orders

Create delivery

PDF document

Authorizations

Body

Response

​PDF document

Authorizations

Body

Response

PDF document