Other data sources

User Account data

NET2GRID gets smart meter measurements data ingested to show energy usage and breakdown for a household. In order to couple the energy data to a user and household, some way of account identification is required.

The data model of the Customer Engagement service has the following important objects:

• The label partner
  The label_partner tag is used to identify the group within the customer domain to which a user belongs. The label partner tag can be used to provide similar services for various brands, labels, subsidiaries or countries from the same service platform setup.
• The user
  Important parameters are the external_account_id and email_address (for registration and notification).
• The installation
  The installation describes the household. One user account can include one or more installations. Important parameters for the installation are the external_installation_id, postal_code (for weather information) and the installation profile parameters that are detailed in Managing Installation Profile Information. Installation profile information is usually derived via user input in the app.
• The meter
  In order to identify energy meters in the installation, the external_meter_id of the electricity meter and/or the gas meter is required.

The basic information for these objects is usually already available in your CRM or other system that holds end-user records. NET2GRID can help to associate the external_meter_id.

As part of the user registration process, the elementary user account data as described above needs to be provisioned in NET2GRID EnergyAI. NET2GRID provides a dedicated API for this purpose:

👍

The Account Management API

To provision the Customer Engagement Service with the essential customer account and installation data, visit the Account Management API documentation.

Tariff data

Besides the energy usage part of the Customer Engagement service, users are often interested in the costs part. In other words, how does the energy consumed in kWh or m3 translate into valuta? To calculate costs requires the tariff that the energy retailer charges for the energy at that particular moment.

This means that in order to derive costs from the API for a particular energy measurements window or category, the tariff has to be provided. There are three ways of achieving this:

• provide tariff data via the Account Management API:
  The Account Management API supports tariff input calls, including the tariff of the household for offtake and injection, both for peak and off-peak, and for specific time intervals for which the tariffs apply.
• provide tariff data via File Exchange:
  The same tariff data can be regularly delivered in csv files containing delta's (updates) in a data format that is specified by NET2GRID.
• provide tariff data via the CE-API as described in Managing energy contract information section.

NET2GRID is specialized in energy insights and EnergyAI is not a billing platform. Therefore, precise billing data and invoices need to be retrieved from the energy retailer customer care and billing systems.