Chronela Logistik — Entwickler-API

REST-API v1 & Webhooks

Sendungen aus Ihrem Shop, ERP oder WMS direkt an die Chronela-Logistik übergeben und den Zustellstatus zurückbekommen — ohne manuelle Erfassung.

Authentifizierung

API-Key mit Scope logistik (im Adminbereich unter Integrationen → API-Keys erstellen). Der Key wird als Header mitgeschickt:

X-API-Key: chr_xxxxxxxxxxxxxxxx

Basis-URL: https://cloud.chronela.com/api/public/logistik/v1

Endpunkte

POST/shipments — Sendung anlegen (Antwort: Sendungsnummer + Tracking-URL)

GET/shipments?status=OFFEN&reference=… — Sendungen listen

GET/shipments/{nummer} — Status inkl. Zustellnachweisen (auch per Referenz oder Tracking-Code)

POST/shipments/{nummer}/cancel — stornieren (solange nicht unterwegs)

Beispiel: Sendung anlegen

curl -X POST https://cloud.chronela.com/api/public/logistik/v1/shipments \
  -H "X-API-Key: chr_…" -H "Content-Type: application/json" \
  -d '{
    "recipientName": "Gasthaus Goldener Adler",
    "street": "Hauptplatz 1", "zip": "2130", "city": "Mistelbach",
    "email": "office@adler.at", "phone": "+43 664 1234567",
    "weightKg": 120, "pallets": 1,
    "contents": "12 Kartons Wein",
    "priority": "NORMAL",
    "type": "ZUSTELLUNG",
    "clientName": "Weinhandel Nord GmbH",
    "reference": "SHOP-4711"
  }'

→ { "shipmentNumber": "SDG-2026-00071",
    "trackingCode": "A1B2C3D4E5F6",
    "trackingUrl": "https://chronela.com/track?nr=SDG-2026-00071" }

Adressen werden automatisch verortet und fließen direkt in Tourenplanung, Auto-Dispo und Live-ETA. clientName ordnet die Sendung einem Auftraggeber (Frachtabrechnung) zu, reference ist Ihre eigene Bestellnummer und in allen Abfragen nutzbar.

Webhooks

Unter Integrationen → Webhooks eine URL registrieren und Events abonnieren. Jeder Aufruf ist HMAC-signiert (X-Chronela-Signature, SHA-256 über den Body mit Ihrem Webhook-Secret).

Event	Wann
`logistik.shipment.created`	Sendung erfasst (API, Portal, CSV, Admin)
`logistik.shipment.delivered`	Zustellung mit Nachweis gebucht
`logistik.shipment.failed`	Fehlversuch / Annahme verweigert
`logistik.tour.finished`	Tour abgeschlossen (inkl. End-km)

Beispiel-Payload

{
  "event": "logistik.shipment.delivered",
  "timestamp": "2026-07-25T14:31:07.000Z",
  "data": { "shipmentNumber": "SDG-2026-00071", "status": "ZUGESTELLT", "recipientName": "Fr. Huber" }
}

Empfänger-Erlebnis

Jede Sendung hat eine öffentliche Tracking-Seite mit Live-ETA, Warteschlangen-Position und Wunschtermin-Wahl: https://chronela.com/track?nr={nummer}. Auftraggeber erhalten auf Wunsch ein eigenes Versandportal (Sendungen beauftragen, Frachtrechner, Ablieferbelege, Reklamationen, Abrechnungen).

Fragen? office@chronela.com · Chronela Logistik ist ein Modul der Chronela Betriebsplattform.