E-mail Integration between Web Port and Energinet

In addition to API integration, Web Port offers an e-mail integration option for sending data to Energinet. This method is particularly useful when dealing with large volumes of data, including large amounts of historical data. Which can sometimes be challenging for API integration. Unlike API submissions, e-mail integration has no restrictions on how often data can be sent, making it easier for importing historical data.

The e-mail report is designed to send data once per day for the previous day’s data in the standard es_2 format that Energinet can process. Users can also send historical data by specifying a start and end date.

Additionally, the report allows the inclusion of multiple tags and the selection of data frequency at 15, 20, or 60 minutes, even for historical imports.

NOTE!

This report is only compatible with Web Port versions 2.25.10 and later.

Prerequisites

• Admin-access (or similar level with possibility to add pages) to a Web Port installation
• Login to Energinet and access to setup API-Imports

Download the report

• Energinet E-mail Report

Prepare Energinet for E-mail Import

Before configuring the report in Web Port, you need to set up the e-mail import in Energinet. This ensures you have a valid e-mail destination for the data.

1. Login to Energinet and setup an API import
   
2. Click on "Create"
   
3. Give the import a name
4. Change the "Type" to "E-mail"
5. Enter a receiver address (Where the data is going to be sent)
6. Select the recipient object(s) of the data (top-level / building / folder)
7. Click on 'Create and add allowed senders'
   
8. Give the sender a name
9. Enter email address that will be used when sending from Web Port
10. Change format to "es_2"
11. Copy email address to where data will be sent to for sutup in Web Port
12. Click on "Create"
    

Setup Report in Web Port

1. Upload the report in Web Port
2. Go to "Sendings" and and edit the sending that is added
3. Enter the email address to where data will be sent (The one you copied on step 11 above)
4. Use default e-mail settings or add Custom SMTP-settings
   (If e-mail settings is not enabled on Web Port, continue here)
   
5. Go to "Inputs" and create new inputs for the tags you wish to export.
   • Name = Tag name
   • Optional, Custom 1 can be used if you want a different ID than the tag name.
   • Optional, Custom 2 can be used if you want a different data frequency. Add 15, 20, or 60 for the wanted minute data frequency. If left empty 60 minutes is used.
   • Enable Tag Link
     
6. Continue adding all inputs you wish to export.
7. When done with adding inputs click on "View report"
8. Click on "Run report" (report is setup to not run on view).
9. enable all options, Init report, Run report and Run Sendings
10. Click on Run
    
11. Result is shown in es_2 format that is sent to Energinet
12. Now the report is set up to run automatically once each day. If you wich to edit or see when next run will be. Go back into edit mode of report. Click on "Parameters" and select "General settings" Here we see the interval and date and time of next run. Edit if wanted and save.

For data to be successfully submitted to Energinet, a meter must be set up with a Meter Data ID so that the incoming data can be linked to the correct meter in Energinet. If this has not yet been configured, please follow this guide: Creating a new meter

Send historical data

If you wish to send historical data add a new input in the report called: SEND_HISTORY
Enter the start date (YYYY-MM-DD) in Custom 1
Enter the end date (YYYY-MM-DD) in Custom 2 (if not filled in, today's date is used as end date)

Then save and run report again as step 10 above.

NOTE!

After the data has been sent to Energinet, remember to remove the SEND_HISTORY input. Otherwise, the report will resend all historical data again the next day when it runs automatically.