Skip to main content

Create a house

A house is an entity from which an user can visualize and manage the energy consumption of a specific location. As the name itself says, this entity is usually a residential dwelling, but it can also be a town hall, a local, etc.

It can be linked to different data sources, such as the electricity distributor, a photovoltaic (PV) installation, an energy community or a combination of these.

You can easily create an user's house from the portal without external help.

How to create an user's house from the portal​

Before starting with the process of creating a house, it is necessary that the user (holder of the supply point) exists beforehand.

If the user does not exist yet and you have doubts about how to create it, take a look at the documentation on how to create a user.

Once the user is created, this is how you can create a house associated to this user:

  1. Go to the Users section of the portal.

  2. Find the user you want to create a house for and click on it.

  3. Check that the user does not already have the home you want to create associated to their profile. If not, click on the "Add house" button.

  4. Fill in the form with:

  • Address (required)
  • Zip/Postal code (required)
  1. Click on the "Add house" button.

Further actions​

Since your goal may not just be to create a house, but to have them receive consumption data, take a look at the possible cases that apply to this house.

Add distributor Data via FTP​

To connect a house with distributor data, you must edit the CUPS and include the corresponding identifier -either electricity or gas-. This allows us to retrieve distributor information automatically from the FTP.

This distributor connection is required in order to synchronize metering data and other distributor-provided information with the house.

If you need more details, see Distributor integration.

Add contracts and invoices​

Contracts and invoices can be created manually from the tabs "electricity contract" / "gas contract" / "electricity invoices" / "gas invoices" at the house level once CUPS is defined. However, the most common use case is to import this information automatically.

Contract and invoice data can be sent either through the API or via integrations with billing systems, ensuring that the information stays synchronized and up to date.

Add a PV installation​

If the house you have created has a PV installation, you can add it by following the steps in the tutorial for linking an installation.

Connect the house to Datadis​

In order for the user to receive consumption data without being your current energy marketer customer, you can encourage them to connect to Datadis so that they can view their consumption data from your application.

It is strictly necessary that the user himself carries out this process from the application.

The user will find a description of the actions to be carried out to connect to Datadis on the "More" screen > "Connections" secction > "Datadis" module.