Submit Measurements
Besides providing data from our integrated metering point operators, you can also submit measurements via our API endpoint /measurements.
Before submitting measurements to our platform, you have to understand the different site types. The site type defines the valid values for the meter field measuring and the required amount of measurings for a successful billing.
You need to set the meters field direction in correlation with measuring correctly so that its OBIS code is configured correctly. Also note that the example timestamps only show HH:mm of the full ISO8601 string.
| Site type site.type | Meter type | Meter measuring type meter.measuring | Required measurings for billing | Example timestamps | OBIS Codes |
|---|---|---|---|---|---|
| Quarter-hourly balanced balanced_accurate | RLM | load_profile_accurate | 96 daily | 15:15 15:30 | 1.29 2.29 |
| iMSys TAF-7 | readings_accurate | 96 daily | 15:15 15:30 | 1.8 2.8 | |
| Monthly balanced balanced_inaccurate | RLM | load_profile_accurate | 96 daily | 15:15 15:30 | 1.29 2.29 |
| iMSys TAF-7 | readings_accurate | 1 daily | 00:00 | 1.8 2.8 | |
| moderne Messeinheit (mME) | readings_inaccurate | 1 daily | 23:14 03:22 | 1.8 2.8 | |
| Billing of fixed prices and time series based pricing unbalanced_accurate | RLM | load_profile_accurate | 96 daily | 15:15 15:30 | 1.29 2.29 |
| iMSys TAF-7 | readings_accurate | 96 daily | 15:15 15:30 | 1.8 2.8 | |
| Manual readings unbalanced_inaccurate | Manual-Read | readings_inaccurate | 1 on the key date | 00:00 | 1.8 2.8 |
Setup
Before submitting measurements we need to setup a custom measuring point operator for you. Please contact our support regarding this matter. After you have setup the site and received the custom point operator ID you can start submitting measurements. The setup process looks like this:
- Create a site with the desired type.
- Create a meter with the desired measuring and direction type using the custom measuring point operator.
- Submit up to 500 measurments at once using the POST /measurements endpoint.
- You are fully responsible for the correctness and completeness of the measurements.
- The platform does not automatically use interpolation to replace missing measurements. You can do that manually in our web app.
- In order to be able to bill a site, the daily required measurings are absolutely necessary.
- Virtual meter measurements cannot be submitted via API, the measurements will be calculated automatically during the balancing process.
- Submitted measurements of type 1.8 and 2.8 must already include the transformer multiplier, if applicable. Our platform is not aware of transformer factors.
- Only measurements corresponding to the specific meter's measuring type can be submitted.