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
- Aufruf: Der Endkunde öffnet im Portal ein Dokument (Link aus dem ERP-Datensync).
- Berechtigung: Das Portal prüft anhand der Berechtigungsstruktur aus dem ERP, ob der Zugriff erlaubt ist.
- Abruf: Der Backend File Service holt das Dokument ad hoc via API beim DMS ab (authentisiert, nur lesend).
- 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)