Prerequisites

Recapping so far:

Once an end-user has been provisioned in the system using the Account Management API, end-users are ready to start their registration. Then and once successfully registered (authenticated) with the platform as described in the previous sections, the end-user can proceed to activate the installation(s) of their account.

Following that, and based on the service type of the account, the final step is the activation.

An account is considered activated if at least one installation under this account is activated.

An installation of an account is considered activated depending on the means that the NET2GRID Insight receives data. Specifically in case of:

• Hardware presence in the household of end-user that sends data to the NET2GRID Insight Platform,
  • then the installation is considered activated once the Hardware has been successfully onboarded with the NET2GRID Insight Platform
• Batch import of data to the NET2GRID Insight Platform
  • For datahubs: An installation is considered active once mandate for the end-user has been requested towards the Datahub
  • MFI (Measurement File Importer): An installation is considered active once the first data file for an end-user's installations is sent to the NET2GRID Insight Platform

Once successfully activated, end-users can use all CE-API endpoints that are relevant to the service provided.

Activation per case

Hardware presence

In order to activate an installation, end-users need to onboard their hardware to their account. This Hardware can be NET2GRID devices, smart readers etc.

In the case of a NET2GRID device that streams High Resolution data, end-users need to use the onboard meter call, which requires the hardware to be both online and not associated with any other account currently active in the platform.

An example call in cURL format is described below:

curl --request PUT \
     --url https://<CE_API_BASE_URL>/v2/registration/onboard/<EUI64>/false \
     --header 'accept: application/json'
'

If successful the response of the token call will be like:

{
  "status": "ok",
  "message": "ok"
}

Once this call is completed the end-user is in the active state and is ready to fully use the platform.

Batch import of data

Datahubs

An installation is considered active once mandate for the end-user has been requested towards the Datahub.

📘

Reach out for further details as integration specifications differ per datahub

Measurement File Importer (MFI)

An installation is considered active once the first data file for an end-user's installations is sent to the NET2GRID Insight Platform

📘

Reach out for further details and specifications on utilizing MFI