Feature Request adapt API to include Energycommunity dso residual use in HomeAssistant

[W-M-B]

Since Tuesday I have am participating in energycommunity https://energiegemeinschaften.gv.at/erneuerbare-energie-gemeinschaften-eeg/
where I bypass the normal supplier and consume / provide Energy directly from the energy community.
in Wiener Netze Smartmeter Portal I have 2 additional Lines

in the Dev tools I can see I have additional entries for energiegemeinschaften including an additional DeliveryPoint

I would like to see that in the Home Assistant as well.
I am not sure how to provide the data for this in order to include this in wnsm.

[DarwinsBuddy]

Hi @W-M-B

If it's easy to perform the GET request you marked from within the integration, we could create a new sensor for it.

I'd potentially need in (potentially the call to /zaehlwerke) a hint that there is in fact a "energiegemeinschaft" resource to pull
as well as the exact call + headers + response from GET /energiegemeinschaft

could you also check this page https://smartmeter-web.wienernetze.at/verbrauchsdaten/grafische-darstellung
and check in the network tab the calls to /bewegungsdaten?

that's unfortunately something only someone like you can provide, since the API is not documented.

I invested a bit time to research how to share the content of the requests + responses properly.
There is the option usually to export it in HAR format.
Google chrome can do it for ALL requests made (which I'd not recommend doing, since potentially you're credentials will passed as well)
Firefox can export each request + response on a per request level (DevTools -> Network Tab -> right-click on the request in question -> save as HAR)

if you wait for 15min-2 hours (just an estimate on how long Wiener Netze's expiration time for jwt) you might also spare you the hassle of removing the Authorization header from the files. or simply remove it to be on the safe site.

Can you attach the file here?

[DarwinsBuddy]

Let's continue here also with this ticket, I guess it's a duplicate. Seems to be a cool new feature from WN ;)

#304

[W-M-B]

I am a little lost:
Hello I downloaded the xhr response for the "Zählerstand" and "Energiegemeinschaft", but it contains so much, and I have not found if this might include the relevant data set. the File I cannot attach as it contains too much information.

Update: I copied the content of the xhr return, changed the ZP and EEG ID (RC...) and uploaded it here.. Not sure if this helps.

new 12.txt

[W-M-B]

I found some more potentially relevant values, which look like they contain the actual EC allocation.
"[{"egId":"AT00100000000RC199999000000000764","egName":"RC199999","participations":[{"consentFrom":"2025-05-27","consentTo":"2025-05-27","participationFrom":"2025-05-27","participationTo":"9999-12-31","factors":[{"dateFrom":"2025-05-27","dateTo":"2025-05-27","factor":"100","status":""},{"dateFrom":"2025-05-27","dateTo":"9999-12-31","factor":"100","status":"A"}],"share":"0.0000","profiles":[{"dateFrom":"2025-05-27","dateTo":"9999-12-31","profileRole":"G003","profile":"000000001001670997"},{"dateFrom":"2025-05-27","dateTo":"9999-12-31","profileRole":"G03R","profile":"000000001001670998"},{"dateFrom":"2025-05-27","dateTo":"9999-12-31","profileRole":"V02T","profile":"000000001001670999"},{"dateFrom":"2025-05-27","dateTo":"9999-12-31","profileRole":"G01T","profile":"000000001001671000"},{"dateFrom":"2025-05-27","dateTo":"9999-12-31","profileRole":"DG1T","profile":"000000001001671003"},{"dateFrom":"2025-05-27","dateTo":"9999-12-31","profileRole":"G002","profile":"000000002000063014"}]}]}]"

[tschoerk]

It seems to be defined by the RoleTypes, implemented in the function bewegungsdaten. We currently use V001 and V002 for consumption and E001 and E002 for feeding.

Here is an overview over the roles my smartmeter uses with the Energiegemeinschaft:

Endpoint:
https://service.wienernetze.at/sm/api/user/messwerte/bewegungsdaten?geschaeftspartner=123&zaehlpunktnummer=AT00&rolle=XXXX

Roles:

Consumption:

• V001 – Total consumption (daily)
• V002 – Total consumption (quarter-hourly)
• G001 – Grid consumption (quarter-hourly)
• G003 – Consumption from Energiegemeinschaft (quarter-hourly)

Relations:

• G001 + G003 = V002
• Daily sum (G001 + G003) = V001

Feed-in:

• E001 – Total feed-in (daily)
• E002 – Total feed-in (quarter-hourly)
• U001 – Feed-in to the grid (quarter-hourly)
• U01T – Feed-in to the grid (quarter-hourly, seems identical to U001 but with some data gaps)

Derived Metrics:

• E002 - U001 = Electricity sold to Energiegemeinschaft (quarter-hourly)
• E001 - daily sum of U001 = Electricity sold to Energiegemeinschaft (daily)

Contrary to consumption and feed-in there is no daily sum but only quarter-hourly, so it's calculated to daily when using the daily graph.

What's interesting is that @W-M-B has many different roles and they throw some different numbers for me, which I can't seem to fit into the data Wiener Netze provides me. Can you check https://smartmeter-web.wienernetze.at/verbrauchsdaten/grafische-darstellung and just look at the XHR GET calls to bewegungsdaten. You should see in the overview which roles are used for the graph. Also maybe some other users can chime in, to find a consenus in the roles used.

[stefanschramek]

Is there anything I can help to get this implemented?

[AndiVienna91]

I’d like to make a fresh start on this. Which data is missing to make further development possible?

This is the content of the response tab for "energiegemeinschaften"

[
{
"egId": "AT00100000XXXXXXX",
"egName": "FAMILIE",
"participations": [
{
"consentFrom": "2025-10-21",
"consentTo": "2025-10-21",
"participationFrom": "2025-10-21",
"participationTo": "9999-12-31",
"factors": [
{
"dateFrom": "2025-10-21",
"dateTo": "2025-10-21",
"factor": "100",
"status": ""
},
{
"dateFrom": "2025-10-21",
"dateTo": "9999-12-31",
"factor": "100",
"status": "A"
}
],
"share": "0.0000",
"profiles": [
{
"dateFrom": "2025-10-21",
"dateTo": "9999-12-31",
"profileRole": "G003",
"profile": "000000001001723728"
},
{
"dateFrom": "2025-10-21",
"dateTo": "9999-12-31",
"profileRole": "G03R",
"profile": "000000001001723729"
},
{
"dateFrom": "2025-10-21",
"dateTo": "9999-12-31",
"profileRole": "V02T",
"profile": "000000001001723730"
},
{
"dateFrom": "2025-10-21",
"dateTo": "9999-12-31",
"profileRole": "G01T",
"profile": "000000001001723731"
},
{
"dateFrom": "2025-10-21",
"dateTo": "9999-12-31",
"profileRole": "DG1T",
"profile": "000000001001723734"
},
{
"dateFrom": "2025-10-21",
"dateTo": "9999-12-31",
"profileRole": "G002",
"profile": "000000002000080909"
}
]
}
]
}
]

[W-M-B]

I’d like to make a fresh start on this. Which data is missing to make further development possible?

This is the content of the response tab for "energiegemeinschaften"

[
{
"egId": "AT00100000XXXXXXX",
"egName": "FAMILIE",
"participations": [
{
"consentFrom": "2025-10-21",
"consentTo": "2025-10-21",
"participationFrom": "2025-10-21",
"participationTo": "9999-12-31",
"factors": [
{
"dateFrom": "2025-10-21",
"dateTo": "2025-10-21",
"factor": "100",
"status": ""
},
{
"dateFrom": "2025-10-21",
"dateTo": "9999-12-31",
"factor": "100",
"status": "A"
}
],
"share": "0.0000",
"profiles": [
{
"dateFrom": "2025-10-21",
"dateTo": "9999-12-31",
"profileRole": "G003",
"profile": "000000001001723728"
},
{
"dateFrom": "2025-10-21",
"dateTo": "9999-12-31",
"profileRole": "G03R",
"profile": "000000001001723729"
},
{
"dateFrom": "2025-10-21",
"dateTo": "9999-12-31",
"profileRole": "V02T",
"profile": "000000001001723730"
},
{
"dateFrom": "2025-10-21",
"dateTo": "9999-12-31",
"profileRole": "G01T",
"profile": "000000001001723731"
},
{
"dateFrom": "2025-10-21",
"dateTo": "9999-12-31",
"profileRole": "DG1T",
"profile": "000000001001723734"
},
{
"dateFrom": "2025-10-21",
"dateTo": "9999-12-31",
"profileRole": "G002",
"profile": "000000002000080909"
}
]
}
]
}
]

Hello @AndiVienna91 you are sharing the configuration that the EC is configured in your delivery point (Zählpunkt).
What is needed is the details of the consumption data that is added once you have a EC actively.
we get additional data
Eigendeckung
Restnetzbezug
I cannot upload screenshots (blocked by corporate proxy)
the EC data comes in minimum 2 days later, but has lots of missing days that are reloaded up 2 a months later..
but I couldnt extract it from the API call as it is needed. you can follow what @tschoerk wrote above. that would be helpful.

[AndiVienna91]

Hello @W-M-B , for me, the roles exactly match the information from @tschoerk

Consumption:

V001 – Total consumption (daily)
V002 – Total consumption (quarter-hourly)
G001 – Grid consumption (quarter-hourly)
G003 – Consumption from Energiegemeinschaft (quarter-hourly)

Relations:

G001 + G003 = V002
Daily sum (G001 + G003) = V001

There are no additional roles for me. There is also no feed-in yet, as our system currently generates too little to supply all the apartments and still have a surplus.

[DarwinsBuddy]

@AndiVienna91 provided a PR that didn't meet our quality criteria.
If someone having Energiegemeinschaft can verify the PR and condense the changes to a reasonable changeset, we would appreciate it.
#343