Skip to content

Commit

Permalink
Develop (#38)
Browse files Browse the repository at this point in the history
* Set "_QUERY_SPARE_CAPACITY_TS=0",
 if res.status ==200
* Update DEVELOPER_DOCUMENTATION.md
Added details, how to get and set peak shaving information
  • Loading branch information
io-debug authored Oct 17, 2023
1 parent 327b78a commit 513d5dd
Showing 1 changed file with 52 additions and 0 deletions.
52 changes: 52 additions & 0 deletions DEVELOPER_DOCUMENTATION.md
Original file line number Diff line number Diff line change
Expand Up @@ -1035,3 +1035,55 @@ Information represented by the V_STECA-Object:
|percent#v|0.0||
|percent#vf|0.0|||
|percent#f|0|||

## Web API
The following Information can be accessed via the Web-API (mein-senec.de).

### Peak Shaving

#### Read/Get Information
When logged in, call the following URL via GET: ```https://mein-senec.de/endkunde/api/peakshaving/getSettings?anlageNummer=0```

_Response_

```JSON

{
"einspeisebegrenzungKwpInPercent": 100, #export limit in kwh in percent
"peakShavingMode": "DEACTIVATED", #Current mode DEACTIVATED, MANUAL, AUTO
"peakShavingCapacityLimitInPercent": 0, #Battery capacity limit in percent
"peakShavingLocalEndTime": [
0,
0
],
"bearbeitungsdatum": 1665062808000,
"bearbeiter": {
"id": 111111,
"geloescht": false,
"userRole": "STUB",
"aktiv": false
},
"valid": true,
"peakShavingEndDate": 1696723200000 #END time of peak shaving
}
```

#### URL to set Settings
To set the changed configuration call ("GET") the following URL and set the respective query string parameter:
```https://mein-senec.de/endkunde/api/peakshaving/saveSettings?anlageNummer=0&mode=AUTO&capacityLimit=0&endzeit=1697414400000```


#### Definition of variables

##### Mode ("peakShavingMode" in response to read the current data, "mode" in request to save changes)
- Deactivated = no peak shaving, only dynamic export limit. Defined as "DEACTIVATED" in get and save Settings
- Manual = manual peak shaving parameter assignment. Defined as "MANUAL" in get and save Settings
- Automatic = forecast-based peak shaving parameter assignment (BETA). Defined as "AUTO" in get and save Settings

##### Capacity limit ("peakShavingCapacityLimitInPercent" in response to read the current data,"capacityLimit" in request to save changes)
- Temporarily limits the capacity of the battery storage, so that the remaining capacity can be used for potential losses due to the export limit.

##### End ("peakShavingEndDate" in response to read the current data, "endzeit" in request to save changes)
- Time of the day on which the capacity limitation should switch off again.


0 comments on commit 513d5dd

Please sign in to comment.