Zu Content springen
  • Es gibt keine Vorschläge, da das Suchfeld leer ist.

Factsheet DMS-Integration ImmoTop2 / Rimo R5 & Portal

W&W Immo Informatik AG · November 2026

ImmoTop2 und Rimo R5 sind die ERP-Systeme von W&W. Über das cloudbasierte Portal binden unsere Kunden ihre Endkunden – Eigentümer, STWEG-Eigentümer und Revisoren – in ihre Prozesse ein und stellen ihnen Dokumente, Daten und News zur Verfügung. Dokumente aus dem DMS werden dabei sicher und ohne Datenduplizierung bereitgestellt.

Überblick

DMS-Schnittstelle (on-prem) Universeller Adapter zwischen DMS und ERP. Die Anbindung erfolgt i.d.R. direkt via ODBC (DMS → ERP). Dokumente bleiben physisch im DMS – im ERP werden nur Links geführt.

Portal (Cloud) Die Dokumentenlinks werden per automatischem Datensync ins Portal gespiegelt. Für den Dokumentenaufruf sind aktuell Adapter für Canon / Therefore™, DocuWare, Colibrief, ELO und EDocScan verfügbar.

Systemlandschaft

flowchart LR
  subgraph ONPREM["Kunden-Infrastruktur (on-prem)"]
    direction TB
    ERP["<b>ImmoTop2 / Rimo R5</b><br/>ERP · Dokumentenlinks · Berechtigungen"]
    DMS["<b>DMS-System</b><br/>physische Dokumentablage"]
    API["<b>API</b><br/>Webserver · HTTPS (gültiges SSL)"]
    DMS -- "DMS-Schnittstelle<br/>(i.d.R. ODBC)" --> ERP
    DMS --- API
  end
  subgraph CLOUD["W&W Portal (Cloud) · Azure Switzerland North"]
    direction TB
    FE["<b>Portal Frontend</b><br/>Daten · News · Dokumentenlinks<br/>Berechtigungsprüfung"]
    FS["<b>Backend File Service</b><br/>Dokumentenabruf ad hoc<br/>Auslieferung als PDF"]
    FE <-- intern --> FS
  end
  EK["<b>Endkunden</b><br/>Eigentümer · STWEG-Eigentümer<br/>Revisoren (Browser)"]
  ERP -- "Automatischer Datensync" --> FE
  FS -- "HTTPS · authentisiert<br/>nur lesend · IP-beschränkt" --> API
  FE <-- "PDF-Anzeige / Download" --> EK
  EK -. "kein direkter Zugriff" .-x DMS

  classDef onprem fill:#FFFFFF,stroke:#004799,stroke-width:2px,color:#062145
  classDef cloud fill:#FFFFFF,stroke:#005EE0,stroke-width:2px,color:#062145
  classDef api fill:#DCEBFF,stroke:#005EE0,stroke-width:2px,color:#004799
  classDef user fill:#FFFFFF,stroke:#062145,stroke-width:2px,color:#062145
  class ERP,DMS onprem
  class FE,FS cloud
  class API api
  class EK user
  style ONPREM fill:#F2F4F8,stroke:#DEE3EB,color:#062145
  style CLOUD fill:#F2F7FE,stroke:#DCEBFF,color:#062145

Ablauf Dokumentenaufruf

  1. Aufruf: Der Endkunde öffnet im Portal ein Dokument (Link aus dem ERP-Datensync).
  2. Berechtigung: Das Portal prüft anhand der Berechtigungsstruktur aus dem ERP, ob der Zugriff erlaubt ist.
  3. Abruf: Der Backend File Service holt das Dokument ad hoc via API beim DMS ab (authentisiert, nur lesend).
  4. Auslieferung: Das Dokument wird über das Portal Frontend als PDF im Browser angezeigt bzw. zum Download bereitgestellt.

Sicherheitsprinzipien

  • Nur Backend-Zugriff: Ausschliesslich der Backend File Service des Portals greift auf die API des DMS zu. Endkunden erhalten nie direkten Zugang zum DMS.
  • Berechtigungen aus dem ERP: Welche Dokumente ein Endkunde sehen darf, ist durch die Berechtigungsstruktur im ERP gegeben und wird vom Portal durchgesetzt.
  • Authentisiert & nur lesend: Der Backend-User benötigt ausschliesslich Lesezugriff. Die Authentisierungsart (Basic Auth, OAuth2 u.a.) bestimmt das DMS-System.

Anforderungen

Für den DMS-Partner (DMS-Hersteller / Integrator)

  • API für den Dokumentenaufruf wird für W&W zugänglich gemacht.
  • Zugangsdaten für den lesenden Dokumentenzugriff (Benutzer/Passwort oder Client-ID/Secret o.ä.) werden W&W zur Verfügung gestellt (Details siehe Adapter-Konfiguration).
  • Fixe, exklusive Lizenz für den Backend-User, die nicht mit anderen Benutzerlizenzen konkurriert (ausschliesslich dem Portal-Backend zugewiesen).
  • Lesender Zugriff auf alle relevanten Dokumente – die feingranulare Berechtigung steuern ERP bzw. Portal.

Für den IT-Verantwortlichen des Kunden (Betrieb on-prem Infrastruktur)

  • Öffentliche Erreichbarkeit: Die API des DMS wird auf einem Webserver mit gültigem SSL-Zertifikat vom Internet her verfügbar gemacht.
  • Zugriffsbeschränkung per IP-Whitelist möglich (IP-Range siehe unten).
  • Last: Ein Abruf erfolgt nur, wenn ein Portalbenutzer ein Dokument öffnet – keine Bulk-Synchronisation, keine initialen Datentransfers. Die Last hängt somit von der Anzahl gleichzeitiger Dokumentenaufrufe ab (z.B. bei vielen parallel aktiven Portalbenutzern).
  • Verfügbarkeit: Die Dokumente im Portal sind von der Verfügbarkeit der lokalen Infrastruktur abhängig.

Hinweis zur Verantwortung: Der Zugang zu den DMS-Systemen obliegt dem DMS-Hersteller bzw. den IT-Verantwortlichen der on-prem Systeme des Kunden. W&W stellt die Portal-Adapter bereit – aktuell verfügbar für Canon / Therefore™, DocuWare, Colibrief, ELO und EDocScan. Für alle weiteren Systeme klärt W&W zuerst mit dem DMS-Hersteller die Möglichkeit einer Integration und passt den Adapter entsprechend an. Die Erstellung des Adapters kann Entwicklungskosten seitens W&W verursachen.

Adapter-Konfiguration

Aktuell verfügbare Adapter: Canon / Therefore™ · DocuWare · Colibrief · ELO · EDocScan

Für alle weiteren Systeme klärt W&W zuerst mit dem DMS-Hersteller die Möglichkeit einer Integration und passt den Adapter entsprechend an. Die Erstellung des Adapters kann Entwicklungskosten seitens W&W verursachen.

Was W&W für die Einrichtung des Adapters benötigt

Die benötigten Angaben unterscheiden sich je nach DMS-Hersteller und Authentifizierungsart.

Angabe Beschreibung Gilt für
Username oder Client-ID Kennung des technischen Backend-Users für den lesenden Zugriff alle DMS
Passwort oder Client-Secret Zugehöriges Passwort bzw. Secret des Backend-Users alle DMS
Hostname des DMS-API-Service Öffentlich erreichbare HTTPS-Adresse der API (inkl. Pfad) alle DMS
File Cabinet Name bzw. ID des Archivs, in dem die Dokumente liegen nur DocuWare
Weitere Angaben Je nach Authentifizierungsart, z.B. Token-Endpoint, Scope, Tenant oder Organisation je nach DMS

Beispiele

Canon / Therefore™ DocuWare
Authentisierung Basic Auth (Therefore-Benutzer) OAuth2 (DocuWare Identity Service)
Hostname https://dms.kunde.ch/theservice/v0001/restun https://dms.kunde.ch/DocuWare/Platform
Username svc-wwportal svc-wwportal
Passwort •••••••••••• ••••••••••••
File Cabinet – (nicht erforderlich) Liegenschaften (ID: 3f2a…)
Weitere Angaben ggf. Tenant-Name (bei Therefore™ Online) ggf. Organisation

Fiktive Beispielwerte. Die konkreten Angaben liefert der DMS-Partner bzw. die IT des Kunden. Zugangsdaten bitte über einen sicheren Kanal an W&W übermitteln.

IP-Range für die Zugriffsbeschränkung

Alle gemäss Azure möglicherweise verwendeten Outbound-IP-Adressen des Backend File Service (Region Azure Switzerland North) sowie die W&W-IP-Adresse für allfälliges Debugging im Problemfall (letzter Eintrag).

20.203.187.130
20.203.144.47
20.203.187.158
20.203.150.182
20.203.186.97
20.203.184.204
20.250.62.148
20.250.63.122
20.250.63.219
20.250.120.17
20.250.120.69
20.250.120.143
20.250.192.19
20.203.184.211
20.203.187.71
20.203.187.230
20.203.188.13
20.203.188.62
20.203.188.76
20.203.147.176
20.203.149.142
20.203.187.138
20.203.184.145
20.203.185.168
20.203.187.242
20.203.188.79
20.203.148.122
20.203.186.192
20.203.188.145
20.203.188.129
20.203.187.152
20.203.184.235
20.203.185.163
20.203.188.126
20.203.188.133
20.203.188.142
20.203.185.4
51.107.58.163   # W&W (Debugging)