Platform v1.0 — Live in productie

KoppelAI Platform

Modulaire AI-oplossingen voor logistieke bedrijven

From email intake to document generation — AI agents that integrate with your TMS. One platform, multiple specialized agents, any logistics workflow.

Bekijk architectuur Platform overzicht
4
AI Agents
3
Live platformen
4
TMS koppelingen
Multi
Tenant ready
Architectuur

Hoe het platform is opgebouwd

Een modulaire architectuur waarbij gespecialiseerde AI-agents samenwerken via een centraal platform, gekoppeld aan elk TMS.

Customer Portals
Wegtransport Portal
Zeevracht Portal
Expeditie Portal
Custom Portal
Centraal Platform
KoppelAI Platform
Unified Agent Management & Multi-Tenant Orchestration
Admin Panel
Gespecialiseerde AI Agents
Order Intake
Intake Automation
Rate Advisor
Rate Intelligence
Dossier Agent
Dossier Management
Document Gen
Document Factory
TMS Integraties
Scope
Cargowise
Winsped
API / EDI
Platformen

Vijf platformen, één ecosysteem

Elk platform pakt een specifiek logistiek knelpunt aan. Samen vormen ze een compleet AI-ecosysteem dat naadloos integreert met uw bestaande TMS.

Live

Intake Automation

  • Leest e-mail, WhatsApp, EDI & bijlagen automatisch
  • Herkent klant, route, lading & gewicht
  • Maakt concept-boeking aan in TMS ter review
  • Classificeert urgentie en type zending
Live

Rate Intelligence

  • Verwerkt tariefbladen van carriers automatisch
  • Vergelijkt spot- vs. contracttarieven per route
  • Signaleert verlopen tarieven & toeslagen
  • Adviseert de beste rate per boeking
Roadmap

Carrier Booking

  • Boekt direct bij carrier via API of e-mail
  • Bevestiging automatisch terug in TMS
  • Ondersteunt zee-, weg- en luchtvracht
  • Slot booking & equipment request
Live

Document Factory

  • Genereert B/L, CMR, paklijst & douanedocs
  • Haalt data uit boeking, tarief & klantprofiel
  • Foutloos, compliant en klaar om te verzenden
  • Template-gebaseerd met AI-validatie
Roadmap

Customer & Tracking

  • Whitelabel portaal met live zendingstatus
  • Automatische milestone-notificaties per zending
  • Documenten & communicatie op één plek
  • Self-service voor klanten van uw klant
Extensies

Bouw verder op het platform

Aanvullende modules die het platform uitbreiden met communicatie, analytics en kennisbeheer.

Roadmap

Communication Hub

  • Statusupdates via e-mail & WhatsApp
  • Beantwoordt standaardvragen automatisch
  • Follow-ups zonder handmatige actie
Roadmap

Analytics & BI

  • Realtime dashboards per platform
  • Inzicht in doorlooptijden & carrier performance
  • Data voor continue procesverbetering
Roadmap

Knowledge Base

  • AI-assistent voor havenkennis & procedures
  • Directe antwoorden op veelgestelde vragen
  • Versnelt onboarding van nieuw personeel
Technical Specifications

Gebouwd voor productie

Een modern, schaalbaar platform dat vandaag draait op Docker en morgen klaar is voor Kubernetes.

Stack
Python 3.11+ & FastAPI
Async-first with uvicorn, SQLAlchemy async ORM, aiosqlite / PostgreSQL. Dependency management via uv.
Deployment
Docker Compose & CI/CD
Single docker-compose.yml runs all services. Traefik reverse proxy with auto-TLS. GitHub Actions for continuous deployment.
Multi-Tenancy
Per-tenant isolation
Shared platform.db for tenant registry. Each agent maintains per-tenant operational databases. Config-driven via admin panel.
AI
Claude API (Anthropic)
Classification, extraction, advisory & document generation. Structured outputs with prompt engineering per agent domain.
Integration
REST API & Webhooks
Each agent exposes a REST API with Swagger docs. Webhook support for async events. TMS field mapping per tenant.
Security
Token auth & HTTPS
Token-based authentication per session. Per-tenant data isolation. HTTPS via Let's Encrypt. CORS configured per environment.
project structure 
koppelai-platform/
  koppelai-platform-common/    # Shared Python package
  koppelai-platform-admin/     # Admin UI
  ai-order-intake-agent/      # Email classification & extraction
  ai-rate-advisor-agent/      # Tariff management & advisory
  ai-dossier-agent/           # Dossier lifecycle management
  ai-documentgen-agent/       # Document generation (PDF)
  docker-compose.yml           # All services in one command
  data/platform.db             # Shared tenant store
Technical Deep Dive

System Architecture

How services communicate, where data lives, and how the platform scales.

External Inputs
● Email (IMAP/Graph)
● WhatsApp API
● Carrier Rate Sheets
● EDI / CSV / PDF
● Customer Portals (React)
▼ HTTPS / REST API ▼
Traefik Reverse Proxy TLS termination • Let's Encrypt • Host-based routing
▼ Docker Network ▼
KoppelAI Platform Services
Platform Admin
Tenant CRUD • Agent health • Unified UI
platform.db (SQLAlchemy)
Order Intake
FastAPI + Claude API
classify • extract • poll
Rate Advisor
FastAPI + Claude API
rates • advise • extract
Dossier Agent
FastAPI + Claude API
dossiers • milestones • docs
Document Gen
FastAPI + Jinja2 + WeasyPrint
B/L • customs • CMR
▼ aiosqlite / SQLAlchemy async ▼
Data Layer
Shared Platform DB
tenants (tenant_id, company, language, baseline)
tenant_agent_configs (tenant_id, agent_id, enabled, config)
SQLite default • PostgreSQL via env var
Per-Tenant Operational DBs
{tenant}.db (intake)
messages, classifications,
extractions, attachments
{tenant}.db (rates)
rates, rate_versions,
surcharges, carrier_configs
{tenant}.db (dossier)
dossiers, milestones,
documents, tms_sync_log
{tenant}.db (docgen)
document_generations,
bl_sequences, history
SQLite per agent per tenant • ContextVar routing • WAL mode
▼ Webhooks / REST / Field Mapping ▼
TMS & External Systems
Scope
Cargowise
Winsped
Custom API / EDI
Carrier APIs

API Surface per Agent

Order Intake Agent
POST /api/{tenant}/analyze
GET  /api/{tenant}/messages
GET  /api/{tenant}/messages/{id}
GET  /api/{tenant}/config
GET  /api/{tenant}/config/categories
Rate Advisor Agent
GET  /api/{tenant}/rates
POST /api/{tenant}/rates/lookup
POST /api/{tenant}/rates/compare
POST /api/{tenant}/advise
POST /api/{tenant}/extract
Dossier Agent
GET  /api/{tenant}/dossiers
POST /api/{tenant}/dossiers
POST /api/{tenant}/dossiers/{id}/milestones
GET  /api/{tenant}/search?q=
GET  /api/{tenant}/alerts
Document Gen Agent
POST /api/{tenant}/generate/bill-of-lading
POST /api/{tenant}/generate/customs-export
GET  /api/{tenant}/documents
GET  /api/{tenant}/documents/{id}/pdf
GET  /api/{tenant}/templates

Deployment Topology

Current (Demo)
Single Server + Docker Compose
  • • Hetzner VPS (Debian)
  • • Docker Compose (5 services)
  • • Traefik reverse proxy
  • • SQLite per-tenant DBs
  • • GitHub Actions CI/CD
  • • Let's Encrypt TLS
Production Ready
PostgreSQL + Docker Compose
  • • Same Docker Compose stack
  • • PostgreSQL (swap via env var)
  • • Volume-backed persistent storage
  • • Automated backups
  • • Monitoring & alerting
  • • Staged rollouts
Scale Path
Kubernetes (k3s / k8s)
  • • Same Docker images
  • • Helm charts per service
  • • Horizontal pod autoscaling
  • • PostgreSQL cluster
  • • ArgoCD GitOps
  • • Zero-downtime deploys
Integratie

Koppelt met elk TMS

KoppelAI vervangt uw TMS niet — het maakt uw TMS slimmer. Wij sluiten aan op uw bestaande systemen.

Input
E-mail, WhatsApp, EDI, API
KoppelAI Platform
AI classificatie, extractie, validatie
Uw TMS
Draft bookings, rates, documents

Ondersteunde systemen

Scope
Cargowise
Winsped
Custom API / EDI

“Wij vervangen uw TMS niet — wij maken het slimmer.”