INTEGRATION API V1

Transportpreise, Booking, Orders & Adressen

Die V18 Integrations-API verwendet die bereits vorhandenen UMZUGER Rest-API-Keys. API-Keys können im bestehenden Admin-Modul /rest-api verwaltet werden. Niemals Live-Keys in öffentliche Frontend-Skripte einbauen.

Authentifizierung

Authorization: Bearer YOUR_API_KEY
Accept: application/json

POST /api/v1/logistics/price

{
  "service_type": "direct",
  "pickup_address": "Teichstraße 27, 79539 Lörrach, Deutschland",
  "delivery_address": "Stuttgart, Deutschland",
  "shipment_category": "automotive",
  "total_weight": 220,
  "total_parcel": 2,
  "length_m": 1.2,
  "width_m": 0.8,
  "height_m": 0.7,
  "pallet_count": 0,
  "optional_services": ["loading_help"]
}

POST /api/v1/logistics/booking

{
  "customer": {
    "name": "Muster GmbH",
    "email": "logistik@example.com",
    "mobile_number": "+491234567890"
  },
  "service_type": "same_day",
  "pickup_address": "Lörrach, Deutschland",
  "delivery_address": "Freiburg im Breisgau, Deutschland",
  "shipment_category": "parcel",
  "total_weight": 15,
  "total_parcel": 1
}

GET /api/v1/logistics/orders/{reference}

Gibt einen datensparsamen Status für einen Auftrag zurück, der über denselben API-Key erstellt wurde.

POST /api/v1/logistics/orders/{reference}/cancel

{"reason":"Auftrag nicht mehr benötigt"}

GET /api/v1/logistics/cities?q=Berlin

Stadt-/Ländersuche aus den vorhandenen UMZUGER Stammdaten.

GET /api/v1/logistics/address-autocomplete?q=Hauptstraße

Nutzt Google Places, wenn GOOGLE_MAP_API_KEY konfiguriert ist. Sonst wird auf die lokale Städtesuche zurückgefallen.

GET /api/v1/logistics/options

Liefert Transportarten, Sendungskategorien, Fahrzeugklassen, Zusatzleistungen und nur die öffentlichen Namen aktiver Zahlungsmethoden. Geheimnisse aus PaymentGateway werden nicht ausgegeben.

Vorhandene Keys