# KIWI

## Übersicht

* **Kategorien**: [Zugangsmanagement](/kategorien/zugangsmanagement.md)
* **Use Cases**: [Stammdaten](#stammdaten)
* **Marketplace**: [KIWI](https://marketplace.aareon.com/de/listings/kiwi)

## Beschreibung

KIWI bietet einfachen digitalen Zugang für Mehrfamilienhäuser. Wir machen physische Schlüssel für Wohnungsbaugesellschaften für alle Türen und Anwendungsfälle überflüssig und reduzieren so die Kosten, während wir gleichzeitig die Sicherheit und den Komfort erhöhen. Bei weiteren Fragen zur Anbindung melden Sie sich direkt bei KIWI.

## Mit KIWI verbinden

1. Um einen KIWI Use Case zu nutzen müssen Sie sich gegenüber der **KIWI API** authentifizieren. Hierzu benötigen Sie:
   1. **Benutzername**
   2. **Password**
2. Nachdem Sie Aareon Connect Kunde geworden sind, können Sie die verfügbaren **KIWI 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                                                          | KIWI             |
| ------------------------------------------------------------ | ---------------- |
| [Verwaltungseinheiten](/kategorien/eigentuemerverwaltung.md) | *Kommt in Kürze* |
| [Mietverträge](/entitaeten/mietvertraege.md)                 | *Kommt in Kürze* |
| [Mieter](/entitaeten/mieter.md)                              | *Kommt in Kürze* |

#### Einstellungen

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

<table><thead><tr><th width="165">Name</th><th width="450.33333333333326">Beschreibung</th><th>Optionen</th></tr></thead><tbody><tr><td>Separator für zusammengesetzte IDs</td><td>Dieser Separator wird genutzt um die IDs in dem Partner System aus den ERP Nummern zusammenzusetzen, sodass die IDs eindeutig sind.</td><td><code>-</code>, <code>_</code>, <code>.</code>, <code>/</code>, <code>|</code></td></tr><tr><td>Mandanten Nummern</td><td>Es werden nur Daten für die eingetragenen Mandanten synchronisiert.</td><td></td></tr></tbody></table>

#### Voraussetzungen

* Es werden nur Mieter mit einer hinterlegten E-Mail Adresse synchronisiert
  * Mietverträge von Mietern, die dies nicht erfüllen, werden ebenfalls nicht synchronisiert


---

# 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/kiwi.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.