Betakom

Beispielanfragen

Kopierfertige Anfragebeispiele für jeden Endpunkt. Wechseln Sie die Basis-URL zwischen Sandbox und Produktion.

Umgebung
https://api.betakom.de
POST/api/v1/partners/orders/ingest

Partner Order API · Create a marketplace order from a partner TMS

Request
{
  "partnerOrderId": "PO-1001",
  "customer": { "email": "kunde@example.com", "name": "Muster GmbH" },
  "loading":  { "country": "DE", "city": "Berlin",   "postalCode": "10115", "date": "2026-07-02", "timeFrom": "08:00", "timeTo": "12:00" },
  "unloading":{ "country": "DE", "city": "Muenchen", "postalCode": "80331", "date": "2026-07-03" },
  "vehicleType": "sprinter",
  "totalPriceEur": 480,
  "totalWeightKg": 850,
  "packages": [{ "length": 120, "width": 80, "height": 100, "weight": 850, "quantity": 1 }],
  "extraServices": { "tailLift": true },
  "notes": "Anlieferung Rampe 4"
}
POST/api/v1/partners/orders/ingest

Partner Order API · Create a marketplace order from a partner TMS

cURL
TS=$(date +%s)
BODY='{"partnerOrderId":"PO-1001","customer":{"email":"kunde@example.com"},"loading":{"country":"DE"},"unloading":{"country":"DE"},"vehicleType":"sprinter","totalPriceEur":480}'
SIG=$(printf '%s' "$TS.$BODY" | openssl dgst -sha256 -hmac "$BETAKOM_PARTNER_SECRET" | awk '{print $2}')

curl -X POST 'https://api.betakom.de/api/v1/partners/orders/ingest' \
  -H 'content-type: application/json' \
  -H "x-partner-id: acme" \
  -H "x-betakom-timestamp: $TS" \
  -H "x-betakom-signature: v1=$SIG" \
  -d "$BODY"
POST/api/v1/carriers-module/my-company/integrations/inbound/{connector}/{token}

Carrier Integration API · Push fleet data to a carrier integration connection

Request
{
  "positions": [
    { "externalUnitId": "TRK-1", "at": "2026-07-01T10:00:00Z", "lat": 48.13, "lng": 11.57,
      "speedKmh": 80, "headingDeg": 270, "isMoving": true, "ignitionOn": true, "driverName": "M. Muster" }
  ],
  "plans": [
    { "externalUnitId": "TRK-1", "externalPlanId": "TOUR-42", "status": "planned",
      "legs": [
        { "seq": 0, "kind": "pickup",
          "place": { "lat": 48.1, "lng": 11.5, "postalCode": "80331", "country": "DE", "name": "Muenchen" },
          "windowStart": "2026-07-02T08:00:00Z", "windowEnd": "2026-07-02T12:00:00Z",
          "loadState": "empty", "goodsDescription": "Paletten", "weightKg": 12000 }
      ] }
  ],
  "availability": [
    { "externalUnitId": "TRK-2", "externalOfferId": "OFFER-7",
      "availableFrom": "2026-07-03T00:00:00Z", "availableTo": "2026-07-05T00:00:00Z",
      "origin": { "lat": 50.1, "lng": 8.6, "postalCode": "60311", "country": "DE", "radiusKm": 50 },
      "preferredDestination": { "region": "Ruhr", "country": "DE" },
      "bodyType": "tautliner", "capacityKg": 24000 }
  ]
}
POST/api/v1/public/freight-quotes

Pricing & Quote API · Request a freight quote for a lane

Request
{
  "loadingLocation": "10115 Berlin, DE",
  "unloadingLocation": "80331 Munich, DE",
  "weight": 850,
  "length": 2.4,
  "accessApiKey": "YOUR_FREIGHT_QUOTES_API_KEY"
}
POST/api/v1/public/freight-quotes

Pricing & Quote API · Request a freight quote for a lane

cURL
curl -X POST 'https://api.betakom.de/api/v1/public/freight-quotes' \
  -H 'content-type: application/json' \
  -d '{
    "loadingLocation": "10115 Berlin, DE",
    "unloadingLocation": "80331 Munich, DE",
    "weight": 850,
    "accessApiKey": "YOUR_FREIGHT_QUOTES_API_KEY"
  }'
GET/api/public/tracking/{orderId}

Tracking API · Get the tracking timeline + order summary

cURL
curl 'https://api.betakom.de/api/public/tracking/48213?t=SIGNED_SHARE_TOKEN'