Implement energy label for rental units

Overview

Define your project's scope and problem space by following the instructions for the Project Poster Play.

How does this project fit into your broader strategy?	MXTS system should hold all relevant unit details in Content Manager which are relevant to display during the core activity (create / manage / show reservations) via MXTS RM, MXT Web solutions, MXT API or MXT reports
Team	Content Manager, Owner Manager, Webmanager, API, Reporting
Project owner	Frank Louwerse
Team members	-
Date	Sep 30, 2023
Status	in progress

Problem space

Why are we doing this?	It is relevant to have the unit energy label added in the system, so it can be displayed and/or used during the booking process.

Why are we doing this?

It is relevant to have the unit energy label added in the system, so it can be displayed and/or used during the booking process.

How do we judge success?

It is possible to configure and change an unit energy label at unit level and via bulk update
It is possible to store a PDF at unit level
It is possible to add a energy label registration number in MXTS
It is possible to fetch unit energy label onto email templates
It is possible to expose unit energy label at Maxxton Websolutions (Webmanager, MyEnvironment, Owner Portal)
It is possible to easy import unit energy labels in bulk for a first time setup
It is possible to easily have an overview for which units the energy label is missing
Clients are able to populate the system from 1-OCT-23 onwards.

What are possible solutions?

Most feasible directions to implement the requirement are to:

Develop a new field at unit level
Develop a new field at accommodationtype level (potentially with inheritance to unit level)
Use amenity at unit level
Use amenity at accommodationtype level

Validation

What do we already know?

If someone sells or rents out a recreational accommodation, it is mandatory to propose an energy label to the buyer / renter and mention this in any advertisements.
From 1-1-2024 onwards the Dutch organ ILT will inspect if legislation is complied with.
Exceptions are possible, no energylabel is required for i) monuments, ii) detached units with <50m2 usable area, iii) >2 years not in use, iv) units without energy installations and v) units with <4 months usage per year and <25% energy usage compared to a full-year usage scenario.
Energylabels must be registered at the online government portal EP-online. This results in a registration number which might be relevant to add in MXTS.
Energylabel is at unit level (but client websites often fetch data at accommodationtype level. Also for units of type ‘quantity’ there is only ‘type-level’ data)
Legislation allows holiday resorts to efficiently label comparable units with same characteristics (based on maps). In other words, units belonging to the same accommdationtype are most likely evaluated and processed in bulk.
It refers to Dutch legislation, so this does not apply to units in countries other than NL.
The due date of energy labels is 10 years

What do we already know?

If someone sells or rents out a recreational accommodation, it is mandatory to propose an energy label to the buyer / renter and mention this in any advertisements.
From 1-1-2024 onwards the Dutch organ ILT will inspect if legislation is complied with.
Exceptions are possible, no energylabel is required for i) monuments, ii) detached units with <50m2 usable area, iii) >2 years not in use, iv) units without energy installations and v) units with <4 months usage per year and <25% energy usage compared to a full-year usage scenario.
Energylabels must be registered at the online government portal EP-online. This results in a registration number which might be relevant to add in MXTS.
Energylabel is at unit level (but client websites often fetch data at accommodationtype level. Also for units of type ‘quantity’ there is only ‘type-level’ data)
Legislation allows holiday resorts to efficiently label comparable units with same characteristics (based on maps). In other words, units belonging to the same accommdationtype are most likely evaluated and processed in bulk.
It refers to Dutch legislation, so this does not apply to units in countries other than NL.
The due date of energy labels is 10 years

What do we need to answer?

How does the evaluation process and its output look in practice? In other words, what does our client receive from evaluators and in which format?
Should the obligation to mention energylabels in advertisements be interpreted as mandatory to display on client websites?
Can it be expected the energylabel is used for reports / batch update processes etcetera? (Manage prices for units with Energylabel X for instance, or as search criteria on a website)
Is it relevant to keep track of energylabel changes other than via the unit_history_log?
Is it correct understood (based on Infographic) only label A-G are valid for recreational units? (And A+/A+++++ are only for residential/utility)

Ready to make it

What are we doing?

Store energylabel at unitlevel as amenity in potentially a new amenity_category to reflect the unit energylabel no development
Store energylabel_reference at unit level to have a mapping between MXTS units and EP-Online units development MXTS-41156
(Potentially) Store amenity at accommodationtype level to display the relevant information at websitelevel (which often has a bookingfunnel at accommodationtype level) no development
(Potentially) store PDF documents at unit level (either Rentable unit or Owner unit, depends on customer preference) no development
Make sure PDF documents are exposed via API refer MXTS-41155
Make sure PDF documents can be displayed on RP and MCMS owner portal development MCMS + RP team
Make sure the unit energylabel can be displayed on email templates which are send to guests MXTS-41157
Make sure user can have insight in energylabel configuration; which units have and which units do not have an energy label to check with CM PO
Make sure the values can be imported for a first time setup via script

What are we doing?

Store energylabel at unitlevel as amenity in potentially a new amenity_category to reflect the unit energylabel no development
Store energylabel_reference at unit level to have a mapping between MXTS units and EP-Online units development MXTS-41156
(Potentially) Store amenity at accommodationtype level to display the relevant information at websitelevel (which often has a bookingfunnel at accommodationtype level) no development
(Potentially) store PDF documents at unit level (either Rentable unit or Owner unit, depends on customer preference) no development
Make sure PDF documents are exposed via API refer MXTS-41155
Make sure PDF documents can be displayed on RP and MCMS owner portal development MCMS + RP team
Make sure the unit energylabel can be displayed on email templates which are send to guests MXTS-41157
Make sure user can have insight in energylabel configuration; which units have and which units do not have an energy label to check with CM PO
Make sure the values can be imported for a first time setup via script

Why will a customer want this?

It is mandatory legislation in NL to have the energylabels for recreational units. Multiple clients are also convinced it is mandatory to display the energylabel during the booking process

Visualize the solution

Somewhere at unit level a varchar field should be available to add the energylabel reference_code (there seems enough space to add a field). Registrationnumber is a 9 digit numeric code, but let’s make the field flexible enough (varchar 15 digit for instance)

Either the rentable_unit or owner_unit will have the PDF document stored which should be exposed at MXT owner portals

Scale and scope

Project size is SMALL

Reference materials

Government legislation

Government portal for registration by client

Example energylabel