Beispielanfragen

Kopierfertige Anfragebeispiele für jeden Endpunkt.

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", "dateTo": "2026-07-04", "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://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/customs/cases

Customs Clearance API · Create a draft case

cURL
curl -X POST 'https://betakom.de/api/v1/customs/cases' \
  -H "Authorization: Bearer $BETAKOM_API_KEY" \
  -H 'content-type: application/json' \
  -d '{
    "procedure": "export",
    "originCountry": "DE",
    "destinationCountry": "US",
    "customerReference": "PO-4711",
    "goodsDescription": "Machine parts",
    "transportMode": "road",
    "positionsCount": 3,
    "tariffNumbersCount": 2
  }'
POST/api/v1/customs/cases/{id}/documents

Customs Clearance API · Upload papers

cURL
curl -X POST 'https://betakom.de/api/v1/customs/cases/123/documents' \
  -H "Authorization: Bearer $BETAKOM_API_KEY" \
  -F 'slot=commercial_invoice' \
  -F 'file=@invoice.pdf'
POST/api/v1/customs/cases/{id}/submit

Customs Clearance API · Submit a draft

cURL
curl -X POST 'https://betakom.de/api/v1/customs/cases/123/submit' \
  -H "Authorization: Bearer $BETAKOM_API_KEY"