# Schnittstelle

Alle im Folgenden aufgelisteten Daten müssen, *sofern im ERP ebenfalls vorhanden*,
- aus etg24 ins ERP importiert werden können (manuell oder live)
- aus dem ERP in etg24 eingespielt werden können (manuell oder live)
- in etg24 aktualisiert werden, falls sie im ERP aktualisiert werden (live)
- im ERP aktualisiert werden, falls sie in etg24 aktualisiert werden (live)

## Stammdaten
1. **Objekte**
- title
- extId
- userAccess
3. **Objekt-Adressen**
- address
- buildingType
- constructionFinishedOn
- coreRenovatedOn
- heatingDatedOn
- heatingType
- heatingEnergySource
- preservationOrder
5. **Einheiten**
- number
- position
- share
- area
- type
- votingWeight
7. **Verträge**
- contractType
- extId
- validFrom
- validTo
- sondereigentumsverwaltung
- postal
- occupier
- vacancy
9. **Vertragsteilnehmer**
- salutation
- firstName
- lastName
- deliveryInstructions
- address
- emailAddress
- phoneMobile
- phoneLandline
- phoneWork
- phoneEmergency
- fax
- url
- addressee
- accessGranted
- accessGrantedFrom
- accessGrantedTo
- agent

## Soft Requirements

1. Ein Kunde muss auf Objektebene entscheiden können, ob die Synchronisierung mit etg24 stattfinden soll, oder nicht. Wird ein Objekt synchronisiert, dann wird der gesamte Bestand des Objekts synchronisiert (alle Einheiten, Verträge, Personen, ...)
3. Ein Datensatz darf nur dann gelöscht werden, wenn er im ERP gelöscht wurde, weil er nicht mehr zum Bestand der Verwaltung gehört. Wird ein Datensatz aus anderen Gründen im ERP gelöscht (zB um ihn neu anzulegen), ist ein löschen des Datensatzes in etg24 nicht erlaubt. In diesem Fall muss er entweder in etg24 belassen, oder entsprechend aktualisiert werden.
4. Sollte ein Feld nicht synchronisiert werden, weil es im ERP nicht vorhanden ist, dann muss es synchronisiert werden, sobald es im ERP eingeführt wird
5. Requests erhalten eine maximale concurrency (im Einzelfall )
6. API Tokens werden nicht an Kunden herausgegeben, oder an Dritte weitergegeben