# iDWELL

## Übersicht

* **Kategorien**: [Eigentümerverwaltung](/kategorien/eigentuemerverwaltung.md), [Mieterkommunikation](/kategorien/mieterkommunikation.md)
* **Use Cases**: [Stammdaten](#stammdaten)
* **Marketplace**: [iDWELL](https://marketplace.aareon.com/de/listings/idwell)
* **API Dokumentation**: [Link](https://api.docs.idwell.com/docs/public-api/f125ebad8f979-i-dwell-api)

## Beschreibung

iDWELL hat sich zum Ziel gesetzt, den Digitalisierungstrend in die traditionsreiche Immobilienbranche zu übersetzen und Unternehmen aktiv zu unterstützen, aufwändige Prozesse zu automatisieren. Die durchdachte Softwarelösung schafft Klarheit zwischen Immobilienverwaltungen, MieterInnen/EigentümerInnen und Dienstleistern. Bei weiteren Fragen zur Anbindung melden Sie sich direkt bei iDWELL.

## Mit iDWELL verbinden

1. Um einen iDWELL-Use-Case zu nutzen, müssen Sie sich gegenüber der **iDWELL** **API** authentifizieren. Hierzu benötigen Sie:
   1. **Benutzername**
   2. **Password**
   3. **Subdomain**: \
      Die Subdomain finden Sie, wenn Sie in Ihrem iDWELL Account eingeloggt sind oben in der URL Leiste. Hier wird ein Link mit folgender Anfangsstruktur zu sehen sein: [https://***aareon-connect***.idwell.com/](https://di-test.idwell.com/) Dort wo im Beispiel aareon-connect in fett und kursiv steht finden Sie Ihre Subdomain.
2. Nachdem Sie Aareon Connect Kunde geworden sind, können Sie die verfügbaren **iDWELL Integrationen innerhalb Ihres ERP-Systems** auswählen und aktivieren.

## Use Cases

### 1. Stammdaten

#### Übersicht

* [Allgemeine Informationen](/use-cases/allgemein/stammdaten.md)
* [Feld Mapping](https://docs.google.com/spreadsheets/d/1fLwCGcttemtlDpznO3O00352cZZ5SPJXBPv6IRWQ6Bk/edit?gid=1022321755#gid=1022321755)

#### Entitäten

| ERP                                                       | iDWELL             |
| --------------------------------------------------------- | ------------------ |
| [Gebäude](/entitaeten/gebaeude.md)                        | Gebäude            |
| [Verwaltungseinheit](/entitaeten/verwaltungseinheiten.md) | Verwaltungseinheit |
| [Mieter](/entitaeten/mieter.md)                           | Mieter             |
| [Eigentümer](/entitaeten/eigentuemer.md)                  | Eigentümer         |

#### Einstellungen

Im Zuge der Aktivierung des Stammdaten Use Cases, können Sie folgende Einstellungen nutzen:

<table><thead><tr><th width="187">Name</th><th width="549.3333333333333">Beschreibung</th><th>Optionen</th></tr></thead><tbody><tr><td>Mandanten Nummern Filtern</td><td>Es werden nur Daten für die eingetragenen Mandanten synchronisiert.</td><td></td></tr><tr><td>Objekt Nummern Filtern</td><td>Es werden nur Daten für die eingetragenen Objekte synchronisiert.</td><td></td></tr></tbody></table>

#### Test der Integration: Stammdaten von ERP nach iDWELL

Nachdem Sie die Integration aktiviert haben und die ersten Stammdaten in Ihrem iDWELL Account zusehen sind, prüfen Sie bitte, ob alle Daten wie gewünscht übertragen wurden. Die verfügbaren Felder für ihr ERP und iDWELL finden Sie [**hier**](https://docs.google.com/spreadsheets/d/1b5iCRsnGxBGTXNzHzaNm0SlfRoIpbRofghzS-7HwbVc/edit#gid=1213044489\&fvid=23969279). Prüfen Sie die Entitäten folgendermaßen:

**Objekte**

Bitte überprüfen Sie, ob die übertragenen Informationen in den Reitern Info, Einheiten und Kunden korrekt übertragen wurden.

**Einheiten**

Bitte überprüfen Sie, ob die übertragenen Informationen in den Reitern Info, Kunden und Adresse korrekt übertragen wurden. Historische Mieter mit abgelaufenen Mietverträgen werden auch aus dem ERP nach iDWELL übertragen. Jedoch erhalten sie den Status "blocked" und sind nur zu sehen, wenn Sie dies in den Einstellungen anpassen. Dazu müssen Sie oben rechts auf das Dropdown-Menu clicken und dann weiter zum Reiter Unternehmen, welcher mit einem Zahnrad versehen ist. Hier können Sie die Einstellungen unter "Historie der archivierten Nutzer" vornehmen.

**Mieter/Eigentümer**

Bitte überprüfen Sie bei den Mietern, sowie Eigentümern, die Reiter Kontaktdaten, Info und Einheiten.

### 2. Dokumente

#### Übersicht

* [Allgemeine Informationen](/use-cases/digitales-buro/dokumente.md)
* [Feld Mapping](https://docs.google.com/spreadsheets/d/1fLwCGcttemtlDpznO3O00352cZZ5SPJXBPv6IRWQ6Bk/edit?gid=136836836#gid=136836836)

In iDWELL lassen sich Dokumente mit Objekte, Einheiten, Eigentümern und Mietern verknüpfen. Zusätzlich werden in iDWELL Ordner für die Dokumente angelegt.

#### Einstellungen

**ERPs**

UTS KARTHAGO\
Bei der UTS KARTHAGO Integration für Dokumente können Sie bestimmen für welche Mandanten die Dokumente übertragen werden sollen. Hierzu muss die Mandanten ID / Firmen ID angegeben werden. Zusätzlich lässt sich ein Datumsfilter bestimmen, sodass nur Dokumente ab Tag X synchronisiert werden. Die Integration synchronisiert neben den Dokumenten auch die Ordnerstruktur aus dem ERP nach iDWELL.

**Archiv**

AAK\
Bei der AAK Integration für Dokumente müssen Sie folgende Informationen teilen, damit die Integration die Dokumente korrekt überträgt:

* Archiv IDs pro Träger: Welche Archive werden welchem Träger zugeordnet?
* Index IDs: Welche Index IDs werden genutzt?
* Datumsfilter: Ab welchem Datum sollen Dokumente übertragen werden?
* Trennzeichen: Welches Trennzeichen wird in der Stammdatenintegration verwendet?

**Beispiel**:

Sie können folgende Archiv IDs angeben.

<figure><img src="/files/eP79TT7TOccNpDl19ide" alt=""><figcaption></figcaption></figure>

Folglich rufen wir alle Dokumente aus den Archiven 1 & 2 ab und vernküpfen diese in iDWELL mit den entsprechenden Mietern. nach dem gleichen Prinzip verknüpfen wir alle Dokumente aus den Archiven 59, 63 & 65 mit den entsprechenden Objekten in iDWELL. Damit alles korrekt verknüpft werden kann, brauchen wir die Archiv Index Details.&#x20;

### 3. Kreditoren & Rechnungen (Domonda)

Domonda ist eine Finanzmanagement-Plattform, die Buchhaltung, Rechnungsverarbeitung und Liquiditätsmanagement für Unternehmen vereinfacht. Sie automatisiert Buchhaltungsaufgaben, integriert sich mit Banksystemen und bietet Echtzeit-Einblicke in die Finanzen. Die Integration zwischen Domonda und Ihrem ERP synchronisiert Daten in beide Richtungen. Zunächst müssen die Kreditoren, Sachkonten und Objekte nach Domonda importiert werden. Anschließend können Sie Ihre Rechnungen in Domonda durch den Freigabeprozess laufen lassen und sie anschließend automatisch in Ihr ERP senden.

#### Einstellungen

Damit eine Rechnung automatisch nach der Freigabe an Ihr ERP gesendet wird, müssen Sie in Ihrem Domonda Account die Regeln dazu definieren und konfigurieren. Dabei hilft Ihnen ihr Domonda Ansprechpartner.&#x20;

**Details**

* Status-Synchronisation
  * Wenn in Domonda ein Status gesetzt ist, wird der Status im ERP auf "fertig" gesetzt. Andernfalls bleibt der Status "offen".
  * Ist ein Status in Domonda gepflegt wird davon ausgegangen, dass die Rechnung bezahlt ist, sodass die Rechnung im ERP mit dem Lastschrift Kennzeichen versehen wird.

    <figure><img src="https://lh7-qw.googleusercontent.com/docsz/AD_4nXewAiXon7t88g1Zx9owzjC0gEetDqa2NfHod-UCitfNYGbo1DsmuZ53uorWWBX_wee5ad6LlavNWFl9xBnOEsjoA5dZEBAYei3A3VBBby36hACGkVtR8Y342eimwhZ7stZzFq8SiQ?key=xk78K25kLln98yDAbzbvkAqS" alt=""><figcaption></figcaption></figure>
* Freigabeprozess und Rechnungsstatus
  * Die Felder "Sachlich OK" und "Rechnerisch OK" werden automatisch bestätigt, wenn eine Rechnung in Domonda den Freigabeprozess durchlaufen ist.
* Pflege von Paragraph 35a EStG in UTS
  * Es werden sowohl der HD Typ als auch der Lohnanteil aus Domonda an das ERP übertragen.
  * Die Zuordnung erfolgt nach folgender Klassifikation:
    * MARGINAL\_EMPLOYMENT: 1 - §35a EStG Abs. 1 geringfügige Beschäftigung
    * ENSURED\_EMPLOYMENT
    * HOUSEHOLD\_SERVICES: 2 - §35a EStG Abs. 2 haushaltsnahe Dienstleistungen
    * CRAFTSMAN\_SERVICES: 3 - §35a EStG Abs. 3 Handwerkerleistungen
* Buchungssperre und Zahlungsverkehrssperre
  * Der Rechnungsbetrag wird auf die jeweilige Position in UTS übertragen.
  * Wenn der Betrag größer als 0 ist, werden beide Sperren auf False gesetzt.
  * Andernfalls bleiben sie auf True gesetzt.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://connect-docs-de.locoia.com/partner-and-apps/idwell.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
