Integrationen & API
GRK ist keine Sackgasse. Zahlungen, Karten, ERP, Telegram und eine offene API mit signierten Webhooks und mehrsprachigen SDKs — damit Sie die Plattform mit Ihrem bestehenden Stack verbinden, ohne CSV-Hin-und-Her.
Zahlungen — Stripe, PayPal, SEPA
Ein Stack für alle Geld-Flüsse rund um Aufträge und Marktplatz:
- Stripe Connect Express — Direktauszahlung an Fahrer / Subunternehmer
- Stripe Checkout — Karten- und SEPA-Zahlung durch Endkunden im B2C-Marktplatz
- PayPal — alternative Auszahlungsmethode auf Wunsch
- Onfido KYC — Identitätsprüfung von Fahrern und Empfängern (für Stripe-Auszahlungen erforderlich)
- SEPA pain.001 — Bulk-Überweisungen als XML-Datei
Webhooks (Stripe, PayPal, Onfido) werden über `/api/webhooks/*` mit Raw-Body und Signaturprüfung entgegengenommen.
Karten & Routing
Default: Google Maps Platform — Geocoding, Directions, Distance Matrix, Live-Traffic. Bring-Your-Own-API-Key möglich, damit das eigene Quota-Budget verwendet wird.
Alternativ OpenStreetMap / Mapbox als Vendor-unabhängige Variante (in Roadmap).
ERP & Buchhaltung
Export-Formate vorbereitet für:
- DATEV (ASCII / Online)
- Lexware (XML / CSV)
- sevDesk (REST API)
- BuchhaltungsButler (CSV)
- SAP Business One (über REST API)
Für Custom-ERPs steht die öffentliche API mit konsistentem JSON-Schema bereit — kein Reverse-Engineering aus Excel-Exporten nötig.
Telegram & Messaging
Telegram-Bot ist Erstklassen-Kanal, nicht ein Add-on:
- Fahrer-Workflow vollständig (`/start`, `/sos`, `/scan`, `/shift`, `/report`)
- Kunden-Tracking auf Anfrage per Bot
- Disponenten-Benachrichtigungen in privater Gruppe
- 9 Sprachen, automatische Erkennung anhand Telegram-Profil
Für Enterprise: WhatsApp Business API und Microsoft Teams in Roadmap.
Öffentliche REST API
Voll-dokumentierte REST API unter `api.grk-logistik.one`:
- Auth: API-Keys im Format `grk_...`, anlegbar im Cockpit unter Organisation → API & Webhooks
- Rate-Limit: 1.000 req/min pro Key, 10.000 req/min Enterprise
- OpenAPI 3.1 Spec, Swagger-UI unter `/api/docs`
- Idempotency-Key Header für sichere Retries
- Pagination Cursor-basiert, kein Offset-Drift bei großen Listen
SDKs offiziell unterstützt:
- TypeScript — `@grk-logistik/sdk` (npm)
- Python — `grk-logistik` (pip)
Webhooks mit HMAC-Signatur
Ausgehende Webhooks für jeden relevanten Lifecycle-Event (Auftrag erstellt, Status geändert, Fahrer zugewiesen, CMR unterschrieben, Zahlung erhalten).
- Header `X-GRK-Signature: sha256=<hex>` — HMAC-SHA-256 mit Endpoint-Geheimnis
- Verifikations-Library `@grk-logistik/sdk-webhook-verify` für TS/Node
- Retry-Schema: 6 Versuche, exponentielles Backoff (1s, 5s, 30s, 5m, 30m, 6h)
- Dead-Letter-Queue mit manuellem Replay im Cockpit
API-Key erstellen
API & Webhooks sind ab Starter-Plan verfügbar. Volle Rate-Limits und Multi-Endpoint-Webhooks ab Business.