API Integration between Web Port and Energinet

This tutorial describes how to set up integration to send measurements from Web Port to Energinet. Kiona has developed ready-made report pages to simplify this process.

From Web Port version 2.25.10, a new script engine is used. This means you must use the correct report depending on which Web Port version you are running.

Prerequisites

• Admin-access (or similar level with possibility to add pages) to a Web Port installation
• API-token from Energinet
• Login to Energinet.

Select the correct report

Web Port version 2.25.10 or newer

• Download and use the new Energinet report

Web Port older than version 2.25.10

• Download and use the existing (legacy) Energinet report.

NOTE!

Using the wrong report may cause the export to fail due to incompatibility with the script engine.

Step-by-step guide

1. Download the correct Web Port report according to your version (see above).
2. Upload it to Web Port.
   
   
3. Report will open in edit mode. Go to inputs and enter the token you have received or created in Energinet, into Value on Input ENERGINET_TOKEN.
4. 
5. Create new inputs for the tags you wish to export.
   • Name = Tag name
   • Optional, Custom 2 can be used if you want a different ID than the tag name.
   • Enable Tag Link
     
     
6. Click view and run the report to validate that it works. (report is setup to not run on view).
7. Result is shown together with a status message.
   
   
8. In Energinet:
   1. Create a new meter.
   2. Meter ID, should match the ID you sent from Web Port.
   3. Open the meter and reload the meter data to check that data is being recived correctly.
      
      
9. The report is configured to send data every hour by default. Update this according to specific needs.
   
   
10. Done!

Troubleshooting tip

• The Debug log in System Settings can provide additional information if you encounter any issues.

How do I set up integration to send measurements from Web Port to Energinet?