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 and
AccountRoleThe 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 | Description |
|---|---|---|
1 | Admin | An admin of the platform. |
2 | PropertyManagementCompany | An organization responsible for managing properties. |
3 | PoolManager | A manager role for shared pools of services. |
5 | Contractor | A third-party service provider, such as a craftsman or technician. |
7 | User | A private individual — usually a tenant, owner, or resident. |
10 | EnergyProvider | A utility company supplying energy (e.g. electricity, gas, water). |
11 | Guest | A temporary or limited-access user. |
13 | InsuranceBroker | A party acting as an intermediary for insurance services. |
14 | Insurer | A party providing insurance policies. |
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 | Type Name | Description |
|---|---|---|
1 | BoardChairman | Acts as chair of the owner or cooperative board. |
2 | BoardMember | Member of the property’s board. |
3 | Owner | Legal owner of the unit. |
4 | Tenant | Primary leaseholder or renting party. |
5 | Subtenant | Person subletting the unit from the primary tenant. |
6 | Resident | Occupant of the unit without ownership or tenancy rights. |
7 | SpecialOwner | Non-standard ownership case (e.g., partial ownership). |
8 | PropertyOwner | General property-level ownership role. |
9 | AuthorizedOwnerRecipient | Delegate authorized to receive documents or notices for owner. |
10 | AuthorizedTenantRecipient | Delegate authorized to receive documents or notices for tenant. |