Entwickler

CONTIFLEET API

Binden Sie Ihr Shop- oder Warenwirtschaftssystem direkt an: Frachtpreise für Gefahrgut der Klasse 1 kalkulieren, Transportaufträge übergeben und Versandlabels drucken. Eine schlanke REST-API mit JSON.

Authentifizierung

Jede Anfrage trägt Ihren API-Schlüssel im Header. Den Schlüssel erhalten Sie von uns auf Anfrage über info@contifleet.de. Behandeln Sie ihn wie ein Passwort.

Authorization: Bearer cf_live_<id>_<secret>

Endpunkte

Methode	Pfad	Zweck
POST	/api/v1/quote	Preis für eine Sendung kalkulieren
POST	/api/v1/orders	Auftrag anlegen (liefert Sendungsnummer + Label-URL)
GET	/api/v1/orders	Eigene Aufträge auflisten
GET	/api/v1/orders/{id}	Einzelnen Auftrag abrufen
GET	/api/v1/orders/{id}/label	Versandlabel als PDF (A6)
GET	/api/v1/ping	API-Schlüssel prüfen

Vollständige Spezifikation als OpenAPI 3.0: /api/v1/openapi

Preis kalkulieren

Alle Beträge kommen in Cent zurück, inklusive Einzelpositionen und Mehrwertsteuer.

curl -X POST https://contifleet.de/api/v1/quote \
  -H "Authorization: Bearer cf_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "category": "F2",
    "nemGrams": 4200,
    "weightKg": 24,
    "fromZip": "14641",
    "toZip": "10115"
  }'

Auftrag anlegen

Die Antwort enthält Sendungsnummer, Status und die URL des Versandlabels. Bei Abgabe an Privatkunden setzen Sie ageVerificationRequired auf true – das Label weist die Ausweiskontrolle aus.

curl -X POST https://contifleet.de/api/v1/orders \
  -H "Authorization: Bearer cf_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "shipment": { "category": "F2", "nemGrams": 4200, "weightKg": 24, "fromZip": "14641", "toZip": "10115" },
    "sender":    { "name": "Feuerwerk Muster GmbH", "street": "Lagerweg 3", "zip": "14641", "city": "Wustermark" },
    "recipient": { "name": "Max Mustermann", "street": "Hauptstr. 1", "zip": "10115", "city": "Berlin", "phone": "030 12345" },
    "reference": "SHOP-2026-0815",
    "ageVerificationRequired": true
  }'

Label drucken

Das Label ist ein A6-PDF mit Sendungsnummer, Barcode, Empfänger, Gefahrgutkennzeichnung Klasse 1 und Ab-18-Hinweis.

GET https://contifleet.de/api/v1/orders/{id}/label   →   application/pdf

Zugang anfragen

Schreiben Sie uns kurz, welches System Sie anbinden möchten. Sie erhalten einen Test- und einen Live-Schlüssel.

API-Zugang anfragen

Hinweis: Preise sind Kalkulationen auf Basis Ihrer Angaben. Die verkehrsrechtliche Zulässigkeit einer Sendung (Mengengrenzen, Freistellungen, Dokumentation nach ADR) prüfen wir vor Übernahme.