Integracje · 2026 · ~6 min czytania
Integracje platform — Bolt, Uber, FreeNow
Jakie platformy zintegrowane, jak to działa technicznie, co Wasza flota dostaje out-of-the-box. Bez bullshitu „nasz system łączy się z każdym".
Platformy taksówkowe
Bolt — Fleet API (Standard tier)
Bolt udostępnia oficjalne Fleet API dla operatorów flot. Mamy tier Standard:
- • Trips endpoint: pełna lista kursów per kierowca, ze szczegółami (start, koniec, kwota, prowizja, sposób płatności)
- • Earnings endpoint: zarobki kierowcy zaagregowane per okres
- • Driver mapping: ręczne mapowanie kierowcy w panelu (Bolt ID ↔ Carpatian ID), bo Bolt nie udostępnia driver-create API
- • Sync częstotliwości: cron nocny (3:00) pełen sync 7 dni, on-demand sync przyciskiem w panelu
- • BoltSyncLog: pełna historia syncow z timestampami i liczbą trips/errors
- • Idempotency: dedup po trip ID, bezpieczne re-sync
Bolt Fleet API nie udostępnia danych o kampaniach flotowych — te wpisujesz ręcznie do panelu jako osobną pozycję earning (źródło: BOLT_CAMPAIGN). Po wpisaniu dzielimy je między kierowców według definiowalnej reguły.
Uber — Fleet portal CSV
Uber nie ma w Polsce publicznego Fleet API dla małych flot. Robi się to przez portal Uber Fleet: tygodniowo pobierasz CSV z zarobkami, wrzucasz do naszego panelu.
- • Import CSV: drag-and-drop w panelu, walidacja formatu
- • Mapowanie kierowca: ręcznie raz, potem cache
- • Dedup: po unique combination (kierowca + tydzień + suma)
- • Diff vs poprzedni import: pokazuje co nowego, co zmienione
FreeNow — planowane Q3 2026
Obecnie manualne dodawanie earningów per kierowca per okres. Q3 2026 planowany import CSV (analogicznie do Ubera). FreeNow API dla flot pracuje — czekamy na publikację.
Powiadomienia — FCM
Wszystkie powiadomienia mobile (do aplikacji kierowcy i do administratora) idą przez Firebase Cloud Messaging:
- • Nowy slot grafiku przypisany do kierowcy
- • Wypłata zatwierdzona / odrzucona
- • Dokument wygasa za 30/7/0 dni
- • Nowy lead (admin)
- • Awaria zgłoszona (dyspozytor)
FCM jest darmowy (do 100k notyfikacji / dzień). Skala typowej floty: 50-500 notyfikacji dziennie, bez problemu w darmowym tier.
Email — SMTP
Konfigurowalny SMTP w env: Mailgun, Postmark, SES, własny Postfix — co preferujesz. Standardowe maile:
- • Rozliczenie tygodniowe per kierowca (PDF w załączniku)
- • Powiadomienia o nowych leadach (do administracji)
- • Reset hasła
- • Raporty miesięczne dla księgowości
Storage plików — MinIO / S3
Wszystkie pliki (zdjęcia szkód, walkaround, dokumenty kierowców, eksport raportów) trafiają do storage S3-compatible:
- • MinIO (default, self-hosted) — dane w Twojej infrastrukturze
- • AWS S3 — gdy preferujesz Amazon
- • Cloudflare R2 — tańsza alternatywa dla S3
- • OVH / Hetzner Object Storage — europejskie alternatywy
Presigned URLs (TTL 5 minut) dla bezpiecznego dostępu kierowcy do swoich plików. Retention policy: walkaround 30 dni, dokumenty bezterminowo, eksporty 90 dni.
Custom integracje
Backend Carpatian Fleet to NestJS z modułową architekturą. Customowe integracje robione są jako osobne moduły — bez ryzyka dla podstawowej funkcjonalności.
Przykłady ostatnich custom integracji u klientów:
- • Integracja z systemem księgowym (Optima, Comarch ERP)
- • Integracja z systemem CRM (Bitrix24)
- • Integracja z systemem czasu pracy (Tachoplus)
- • Webhooki do własnych systemów (Slack, Discord, MS Teams)
Wycena indywidualna, stawka godzinowa 180-250 zł netto / godz. zależnie od złożoności.
Porozmawiajmy o Waszych integracjach
Macie konkretne systemy, które chcielibyście podłączyć? Daj nam znać — zwykle pierwszy ekspresowy estimate dajemy w 24h od demo.