Aufträge erstellen

POST /v1/orders – legt einen neuen Transportauftrag an und stellt ihn automatisch im Dispo-Board deiner Organisation bereit.

POST /v1/orders

Request-Parameter

Feld

Typ

Beschreibung

erforderlich

customer_id

string

ID des Auftraggebers

erforderlich

material

string

z. B. sand_0_2, kies_8_16

erforderlich

quantity_tons

number

Bestellte Menge in Tonnen

erforderlich

pickup_address

object

Abholadresse (Werk/Lager)

erforderlich

delivery_address

object

Baustellenadresse

optional

requested_date

string (ISO 8601)

Gewünschtes Lieferdatum

optional

vehicle_type

string

z. B. sattelkipper, walking_floor

ℹ Hinweis Nach dem Erstellen sendet Kisslog automatisch das Webhook-Event order.created an alle konfigurierten Endpunkte.

Antwortcodes

201 Auftrag wurde erstellt

422 Validierungsfehler – Pflichtfeld fehlt oder ungültig

401 API-Key fehlt oder ist ungültig

429 Rate Limit überschritten

War dieser Artikel hilfreich?

curl https://api.kisslog.de/v1/orders \ -X POST \ -H "Authorization: Bearer sk_live_..." \ -H "Content-Type: application/json" \ -d '{ "customer_id": "cus_88fd2", "material": "sand_0_2", "quantity_tons": 24, "pickup_address": { "site": "Kieswerk Aurach" }, "delivery_address": { "site": "Baustelle Nord, Halle 7" }, "requested_date": "2026-08-06" }'

$response = Http::withToken($apiKey) ->post('https://api.kisslog.de/v1/orders', [ 'customer_id' => 'cus_88fd2', 'material' => 'sand_0_2', 'quantity_tons' => 24, 'pickup_address' => ['site' => 'Kieswerk Aurach'], 'delivery_address' => ['site' => 'Baustelle Nord, Halle 7'], 'requested_date' => '2026-08-06', ]);

const res = await fetch('https://api.kisslog.de/v1/orders', { method: 'POST', headers: { Authorization: `Bearer ${apiKey}`, 'Content-Type': 'application/json', }, body: JSON.stringify({ customer_id: 'cus_88fd2', material: 'sand_0_2', quantity_tons: 24, pickup_address: { site: 'Kieswerk Aurach' }, delivery_address: { site: 'Baustelle Nord, Halle 7' }, requested_date: '2026-08-06', }), });

{ "id": "ord_4821x", "status": "unassigned", "customer_id": "cus_88fd2", "material": "sand_0_2", "quantity_tons": 24, "tracking_url": "https://trk.kisslog.de/ord_4821x", "created_at": "2026-08-05T09:12:03Z" }