UVI Complete · Technische Integration

Ein neutrales Datenmodell, viele Anbieter.

UVI Complete abstrahiert die Unterschiede der Messdienstleister hinter einem einheitlichen Modell und einer offenen REST-API. Diese Seite fasst zusammen, was technische Entscheider für Bewertung und Anbindung brauchen.

Technische Integration besprechen Zurück zur Produktübersicht
Bausteine

Die technische Basis.

Offene Standards statt proprietärer Insel. Jeder Baustein ist so gebaut, dass er sich in bestehende Landschaften einfügt.

REST-API

Ressourcenorientierte HTTPS-Schnittstelle mit JSON für Objekte, Einheiten, Bewohner, Verbrauch und Zustellstatus.

OAuth

Tokenbasierte Authentifizierung und Autorisierung. Keine dauerhaften Klartext-Zugangsdaten in Integrationen.

Webhooks

Ereignisbasierte Benachrichtigungen, etwa bei neuem Verbrauchsstand, Zustellnachweis oder erkannter Abweichung.

Provider-Adapter

Je Messdienstleister ein Adapter, der dessen Format auf das neutrale Modell abbildet. Neue Anbieter werden ergänzt, ohne die API zu ändern.

Neutrales Datenmodell

Ein anbieterunabhängiges Modell für Verbrauch, Perioden, Schätz- und Korrekturwerte – konsumentenseitig immer gleich.

Mandantenfähigkeit

Jede Verwaltung ist ein isolierter Mandant. Datentrennung und Rechte sind auf Mandantenebene erzwungen.

CSV-Import

Strukturierter Datei-Import für Objekt-, Einheiten- und Bewohnerdaten, wenn keine Schnittstelle vorliegt.

White Label

Auftritt im Erscheinungsbild der Verwaltung – Umfang je nach Vereinbarung.

Audit-Logs

Nachvollziehbare, revisionssichere Protokolle über Veröffentlichung, Benachrichtigung und Zugriffe.

Adapter-Modell

Anbieterunterschiede bleiben im Adapter.

Konsumenten – Dashboard, Bewohnerportal, Ihre Systeme – sehen immer dasselbe Modell. Die Eigenheiten jedes Messdienstleisters kapselt der jeweilige Adapter.

QUELLEMessdienstleister

API, Portal oder Datei je Anbieter.

ADAPTERProvider-Adapter

Mappt Format & Semantik auf das neutrale Modell.

KERNNeutrales Modell

Verbrauch, Perioden, Schätz-/Korrekturwerte, Zuordnung.

PRÜFUNGZuordnung & Regeln

Deterministische Prüfung, Ausnahmen werden ausgesteuert.

AUSGABEAPI · Portal · Nachweis

Einheitlich für alle Konsumenten – inkl. Zustellnachweis.

Der produktive Betrieb je Adapter setzt einen gültigen Anbieterzugang und ggf. eine vertragliche Freigabe voraus. Der Aktivierungsstand wird im Onboarding festgehalten.

API & Status

Vorhersehbar integrierbar.

Ressourcen sind klar geschnitten, Antworten sind stabil, Ereignisse kommen per Webhook. Eine Status-API macht den Betriebs- und Anbindungszustand maschinenlesbar.

  • Status-API für Anbindungs- und Verarbeitungszustand je Mandant und Anbieter.
  • Sandbox zum Testen der Anbindung ohne produktive Bewohnerdaten.
  • Webhooks mit Signatur zur Verifikation der Ereignisse.
  • Idempotente Schreiboperationen für sichere Wiederholung.

Struktur illustrativ. Verbindliche Endpunkte, Felder und Sandbox-Zugang stellen wir im technischen Onboarding bereit.

GET /api/v1/units/{id}/consumption

{
  "unit_id": "W0101-04",
  "period": "2026-06",
  "provider": "prepared:techem",
  "readings": [
    { "medium": "heating",     "value": 128.4, "unit": "kWh", "estimated": false },
    { "medium": "hot_water",   "value":  3.10, "unit": "m3",  "estimated": true  }
  ],
  "assignment": { "status": "confirmed", "resident_id": "R-8842" },
  "publication": { "published_at": "2026-07-05T08:12Z", "notified": true }
}
Integrationsablauf

Von der Sandbox in den Regelbetrieb.

  1. Mandant & Zugang

    Mandant anlegen, OAuth-Zugang erzeugen, Rollen und Rechte festlegen.

  2. Stammdaten anbinden

    Objekte, Einheiten und Bewohner per API oder CSV übernehmen; Zustelldaten pflegen.

  3. Provider-Adapter aktivieren

    Anbieterzugang hinterlegen, Adapter in der Sandbox verifizieren.

  4. Zuordnung prüfen

    Wohnung/Zähler/Bewohner abgleichen, Ausnahmen bereinigen.

  5. Testlauf & Freigabe

    Monatslauf in der Sandbox, kontrollierte Bewohnerfreigabe, dann Umschaltung in den Regelbetrieb.

Der nächste Schritt

Technische Integration besprechen.

Wir gehen Ihre Systemlandschaft, die vorhandenen Messdienstleisterzugänge und den Anbindungsweg konkret durch.

Technische Integration besprechen Pilotzugang anfragen