Die Aufzugsbranche arbeitet mit PDFs, Faxen und Excel. Jeder Hersteller, jede Servicefirma und jede Prüfstelle hat eigene Formate. evi ist API first gebaut: Alles, was die Plattform kann, ist über die Open Elevator API und den Elevator MCP erreichbar, und alles, was evi liest, wird in einen offenen, gemeinsamen Standard überführt.

Warum ein Standard

Ein Wartungsvertrag ist erst vergleichbar, wenn Vertragsart, Intervalle, Notruf, Laufzeit und Preisgleitklausel in denselben Feldern stehen. Ein Prüfbericht ist erst bearbeitbar, wenn jeder Mangel Code, Frist und Gefährdungsstufe hat. Open Elevator legt diese Felder offen fest, damit Betreiber, Servicefirmen, Prüfstellen und Software dieselbe Sprache sprechen.

Basis

Base URL   https://api.elevatorintelligence.com/v1
Format     application/json, UTF-8
Auth       Authorization: Bearer <token>   (OAuth 2.0 Client Credentials oder API-Key)
Version    URL-Präfix /v1, additive Änderungen ohne Versionssprung

Ressourcen

Beispiel: Dokument analysieren

POST /v1/documents:analyze
Authorization: Bearer <token>
Content-Type: multipart/form-data

file=@pruefbericht.pdf
elevator_hint=Leopoldstraße 112

{
  "id": "doc_7Kq2",
  "type": "inspection_report",
  "confidence": 0.97,
  "elevator": { "id": "elv_A2021", "match": "factory_number" },
  "inspection": { "kind": "main", "date": "2026-06-11", "result": "defects", "next_due": "2028-06" },
  "defects": [
    { "code": "4.3.2", "text": "Notrufsprechverbindung nicht i.O.", "severity": "significant", "due": "2026-07-09" }
  ]
}

Fehler und Limits

Fehler folgen RFC 9457 (Problem Details). Rate Limits stehen in den Headern RateLimit-Limit, RateLimit-Remaining und RateLimit-Reset. Lange Analysen laufen asynchron: Antwort 202 mit Job-ID, Ergebnis per Event oder Abfrage.

Dokumentarten

Qualität

Jedes Feld trägt eine Konfidenz und einen Verweis auf die Fundstelle im Dokument (Seite, Bereich). Unsichere Felder gehen an das evi-Backoffice zur Prüfung, bevor sie in der Akte landen.

Wartungsverträge sind heute nicht vergleichbar: andere Begriffe, andere Leistungsumfänge, versteckte Preisgleitklauseln. Der Contract Standard legt fest, welche Felder ein Aufzugsvertrag hat und was sie bedeuten. evi überführt jeden gelesenen Vertrag in dieses Schema.

{
  "$schema": "https://openelevator.org/schema/contract.json",
  "kind": "full_maintenance",           // basic_maintenance | full_maintenance
  "elevators": ["elv_A2021"],
  "term": { "start": "2019-01-01", "years": 10, "auto_renew_years": 1, "notice_months": 3 },
  "services": {
    "maintenance_visits_per_year": 6,
    "emergency_call": { "included": true, "technology": "2G" },
    "fault_repair": "included",
    "spare_parts": "wear_parts_only"
  },
  "price": { "annual_net": 2760, "currency": "EUR", "escalation": { "type": "index", "index": "destatis_wage_metal", "cap_pct": 4 } }
}

Benchmark

GET /contracts/{id}/benchmark hält den Vertrag gegen vergleichbare Anlagen (Antrieb, Haltestellen, Baujahr, Region, Leistungsumfang) und liefert Marktspanne, Median und Einsparpotenzial. Die Vergleichsbasis ist anonymisiert und aggregiert.

Mitmachen

Der Standard ist offen. Servicefirmen, Verwaltungen und Softwareanbieter können Felder vorschlagen. Ziel ist Version 1.0 als gemeinsame Branchengrundlage.

Alle Objekte haben id, created_at, updated_at und organization. Datumsfelder sind ISO 8601.

{
  "nr": "A2",
  "hazard": "Fehlender Notfallplan",
  "present": "no",            // yes | no | na
  "risk": "ok",                // ok | na | low | medium | high
  "measures": [{ "text": "Notfallplan erstellen", "required": false }]
}

Dazu Handlungsbedarf (kein, 5–10 Jahre, 2–4 Jahre, 1 Jahr), Dokumentencheckliste und eine Cyber-Bauteilliste mit Schnittstelle (Kabel, Funk), Barriere und Risiko.

{
  "id": "evt_91x",
  "type": "inspection.due_soon",
  "created": "2026-10-20T08:00:00Z",
  "data": { "elevator_id": "elv_A2021", "kind": "main", "due": "2026-11-18", "days_left": 30 }
}

Signatur per HMAC-SHA256 im Header Elevator-Signature. Zustellung mit Wiederholung bis 24 Stunden.

Der Elevator MCP stellt evis Fachwissen als Werkzeuge bereit. Ein Agent kann damit einen Prüfbericht lesen, die Frist der nächsten Hauptprüfung berechnen oder einen Wartungsvertrag gegen den Markt halten, ohne eigene Parser oder Prompts.

Verbinden

{
  "mcpServers": {
    "elevator": {
      "url": "https://mcp.elevatorintelligence.com/v1",
      "headers": { "Authorization": "Bearer <token>" }
    }
  }
}

Werkzeuge

Ressourcen und Prompts

• elevator://{id} liefert die Anlagenakte als Kontext
• regulation://betrsichv/16 liefert den Normtext mit Erläuterung
• Prompt „Betreiberpflichten prüfen“: geht alle Pflichten einer Anlage durch und meldet Lücken