Eliq’s view of the world

The Eliq model

The Eliq model consists of three main entities. These are: User, Location and Meter. A user in Eliq has zero or more locations, and each location has zero or more meters. This is illustrated in the image below. As can be seen when exploring Eliq Data Management API and Eliq Insights API, endpoints are formed around these entities.

User: The user represents a person/customer. The user entity holds contact information such as name, email address and phone number in order to handle login and communication. In API setups, Eliq does normally not manage end-user contact, which means that no contact information is required to be populated to Eliq.

Location: A location is an address/geo-point and holds information about the physical location. The location is the central entity in Eliq, which will be seen when exploring the white-label apps and Insights API.

Meter: A meter represents the entity that records energy values in a location, and hold information about the fuel measured and direction. A meter typically measures imported or exported energy from and to the grid, with different fuels (electricity, gas, district heating).

In any integration at Eliq, the client’s representation of these entities and models need to be converted to the Eliq model. Eliq is happy to assist and help on any mapping exercises.

Home profile

To provide valuable energy insights to end-users, Eliq needs information about their homes. This is referred to as the home profile. The home profile is linked to a location and contains details about the home, such as house type, size, heating type, etc.

Eliq offers APIs to input these details, which are usually collected during the user's first login. Home profile options vary by country, and each client has the flexibility to customise them to match their specific needs.

‍

Energy data

In addition to the main entities and home profile, energy data should be transferred to Eliq. Energy data is tied to a meter, hence, all energy data is added to a specific meter id. Eliq supports energy data in several different resolutions. Low resolution: Monthly, Daily. High resolution: hour, 30min, 15min, 10min, 6min.

Price formulas

Eliq can present analytics in both unit cost and energy. To provide the results in cost, Eliq need information on how the cost is calculated. This information is transferred to Eliq using price formulas, which is Eliq representation of a contract.