This section explains how facilioo models individuals and organizations via Parties and how they interact with the system through Accounts.
Parties
A Party represents a legal entity in the facilioo system. It can be an individual, a company, or another organization. Each Party has a type that defines its role in the system and determines available functionality and relationships.
Disclaimer: Party type andAccountRoleThe type of a party is currently represented in this API by the
AccountRoleenum. This naming can be misleading, as it implies a direct connection to the Account entity. In practice,AccountRoledefines the type of the Party—not the role of an Account. However, since each Account is associated with a Party, it inherits theAccountRoleindirectly through that relationship.
| ID | Name (EN) | Name (DE) | Description |
|---|---|---|---|
1 | Admin | Admin | An admin of the platform. |
2 | Property ManagementCompany | Hausverwaltung | An organization responsible for managing properties. |
3 | Pool Manager | Pool | A manager of shared service pools, coordinating resources across parties. |
5 | Contractor | Firma | A third-party service provider, such as a craftsman or technician. |
7 | User | Nutzer:in | A private individual — usually a tenant, owner, or resident. |
10 | Energy Provider | Versorger | A utility company supplying energy (e.g. electricity, gas, water). |
11 | Guest | Gast | A temporary or limited-access user (restricted scope and permissions). |
13 | Insurance Broker | Makler | A party acting as an intermediary for insurance services. |
14 | Insurer | Versicherer | A party providing insurance policies. |
15 | Mediator | Vermittler | A facilitator or intermediary between parties, without being the direct provider or end-user. |
Accounts
An Account represents a user’s access to the facilioo system. It includes login credentials and permissions, and is always linked to a Party.
Account-to-Party Relationships
Typically, all legal entities (like Property Management Companies, Contractors, etc.) have one Party, and multiple Accounts for each of their employees.
Meanwhile, Users (e.g., tenants, owners) have a 1:1 relationship between Party and Account. Their Party is typically created and associated with the property managing company’s Party.
Unit Contracts
A Unit Contract describes the relationship between a Party of type User and a Unit. This is how facilioo models roles like tenant, owner, or resident, and determines access rights and communication paths within a building. The known types to represent these roles associated with a unit contract are:
| ID | Name (EN) | Name (DE) | Description |
|---|---|---|---|
1 | Board Chairman | Beiratvorsitze | Acts as chair of the owner or cooperative board. |
2 | Board Member | Beiräte | Member of the property’s board. |
3 | Owner | Eigentümer:innen | Legal owner of the unit. |
4 | Tenant | Mieter:innen | Primary leaseholder or renting party. |
5 | Subtenant | Untermieter:innen | Person subletting the unit from the primary tenant. |
6 | Resident | Bewohner:innen | Occupant of the unit without ownership or tenancy rights. |
7 | Special Owner | Sondereigentümer:innen | Non-standard ownership case (e.g., partial ownership). |
8 | Property Owner | Objekteigentümer:innen | General property-level ownership role. |
9 | Authorized Owner Recipient | Zustellberechtigte Eigentümer:innen | Delegate authorized to receive documents or notices for owner. |
10 | Authorized Tenant Recipient | Zustellberechtigte Mieter:innen | Delegate authorized to receive documents or notices for tenant. |