curl --request POST \
--url https://{host}/v1/process/zuordnungsermaechtigungen/unterbilanzkreis \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"bilanzkreis_eic": "<string>",
"mp_ids": [
"<string>"
],
"bilanzierungsgebiete": [
"<string>"
],
"erneut": false,
"dry_run": true
}
'import requests
url = "https://{host}/v1/process/zuordnungsermaechtigungen/unterbilanzkreis"
payload = {
"bilanzkreis_eic": "<string>",
"mp_ids": ["<string>"],
"bilanzierungsgebiete": ["<string>"],
"erneut": False,
"dry_run": True
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
bilanzkreis_eic: '<string>',
mp_ids: ['<string>'],
bilanzierungsgebiete: ['<string>'],
erneut: false,
dry_run: true
})
};
fetch('https://{host}/v1/process/zuordnungsermaechtigungen/unterbilanzkreis', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://{host}/v1/process/zuordnungsermaechtigungen/unterbilanzkreis",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'bilanzkreis_eic' => '<string>',
'mp_ids' => [
'<string>'
],
'bilanzierungsgebiete' => [
'<string>'
],
'erneut' => false,
'dry_run' => true
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://{host}/v1/process/zuordnungsermaechtigungen/unterbilanzkreis"
payload := strings.NewReader("{\n \"bilanzkreis_eic\": \"<string>\",\n \"mp_ids\": [\n \"<string>\"\n ],\n \"bilanzierungsgebiete\": [\n \"<string>\"\n ],\n \"erneut\": false,\n \"dry_run\": true\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://{host}/v1/process/zuordnungsermaechtigungen/unterbilanzkreis")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"bilanzkreis_eic\": \"<string>\",\n \"mp_ids\": [\n \"<string>\"\n ],\n \"bilanzierungsgebiete\": [\n \"<string>\"\n ],\n \"erneut\": false,\n \"dry_run\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://{host}/v1/process/zuordnungsermaechtigungen/unterbilanzkreis")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"bilanzkreis_eic\": \"<string>\",\n \"mp_ids\": [\n \"<string>\"\n ],\n \"bilanzierungsgebiete\": [\n \"<string>\"\n ],\n \"erneut\": false,\n \"dry_run\": true\n}"
response = http.request(request)
puts response.read_body{
"dry_run": true,
"bilanzkreis_eic": "<string>",
"name": "<string>",
"haupt_bk": "<string>",
"lieferant_mp_id": "<string>",
"valid_from": "<string>",
"zeitreihentypen": [
"<string>"
],
"would_send": [
{
"mp_id": "<string>",
"name": "",
"bilanzierungsgebiet_eic": "",
"zeitreihentypen": [
"<string>"
],
"reason": ""
}
],
"sent": [
{
"mp_id": "<string>",
"name": "",
"bilanzierungsgebiet_eic": "",
"zeitreihentypen": [
"<string>"
],
"reason": ""
}
],
"skipped": [
{
"mp_id": "<string>",
"name": "",
"bilanzierungsgebiet_eic": "",
"zeitreihentypen": [
"<string>"
],
"reason": ""
}
],
"nachgetragen": [
{
"mp_id": "<string>",
"name": "",
"bilanzierungsgebiet_eic": "",
"zeitreihentypen": [
"<string>"
],
"reason": ""
}
]
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Post Zuordnung Unterbilanzkreis
Grant the Zuordnungsermaechtigung of a configured Unterbilanzkreis
(a sub-balance group without schedules, e.g. for the EEG
Marktpraemienmodell) to the named Netzbetreiber: per Bilanzierungsgebiet
in its control areas, with its own Zeitreihentypen, BK = the
Unterbilanzkreis. Same gates as the auto-grant (no exclusion, no
standing rejection, an established PARTIN channel); what is granted
already is not sent again (ledger zoe_unterbilanzkreis). A grant
whose last send failed in transport or was rejected is reported as
such and re-issued only with erneut. dry_run defaults to true
and sends and writes nothing.
curl --request POST \
--url https://{host}/v1/process/zuordnungsermaechtigungen/unterbilanzkreis \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"bilanzkreis_eic": "<string>",
"mp_ids": [
"<string>"
],
"bilanzierungsgebiete": [
"<string>"
],
"erneut": false,
"dry_run": true
}
'import requests
url = "https://{host}/v1/process/zuordnungsermaechtigungen/unterbilanzkreis"
payload = {
"bilanzkreis_eic": "<string>",
"mp_ids": ["<string>"],
"bilanzierungsgebiete": ["<string>"],
"erneut": False,
"dry_run": True
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
bilanzkreis_eic: '<string>',
mp_ids: ['<string>'],
bilanzierungsgebiete: ['<string>'],
erneut: false,
dry_run: true
})
};
fetch('https://{host}/v1/process/zuordnungsermaechtigungen/unterbilanzkreis', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://{host}/v1/process/zuordnungsermaechtigungen/unterbilanzkreis",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'bilanzkreis_eic' => '<string>',
'mp_ids' => [
'<string>'
],
'bilanzierungsgebiete' => [
'<string>'
],
'erneut' => false,
'dry_run' => true
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://{host}/v1/process/zuordnungsermaechtigungen/unterbilanzkreis"
payload := strings.NewReader("{\n \"bilanzkreis_eic\": \"<string>\",\n \"mp_ids\": [\n \"<string>\"\n ],\n \"bilanzierungsgebiete\": [\n \"<string>\"\n ],\n \"erneut\": false,\n \"dry_run\": true\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://{host}/v1/process/zuordnungsermaechtigungen/unterbilanzkreis")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"bilanzkreis_eic\": \"<string>\",\n \"mp_ids\": [\n \"<string>\"\n ],\n \"bilanzierungsgebiete\": [\n \"<string>\"\n ],\n \"erneut\": false,\n \"dry_run\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://{host}/v1/process/zuordnungsermaechtigungen/unterbilanzkreis")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"bilanzkreis_eic\": \"<string>\",\n \"mp_ids\": [\n \"<string>\"\n ],\n \"bilanzierungsgebiete\": [\n \"<string>\"\n ],\n \"erneut\": false,\n \"dry_run\": true\n}"
response = http.request(request)
puts response.read_body{
"dry_run": true,
"bilanzkreis_eic": "<string>",
"name": "<string>",
"haupt_bk": "<string>",
"lieferant_mp_id": "<string>",
"valid_from": "<string>",
"zeitreihentypen": [
"<string>"
],
"would_send": [
{
"mp_id": "<string>",
"name": "",
"bilanzierungsgebiet_eic": "",
"zeitreihentypen": [
"<string>"
],
"reason": ""
}
],
"sent": [
{
"mp_id": "<string>",
"name": "",
"bilanzierungsgebiet_eic": "",
"zeitreihentypen": [
"<string>"
],
"reason": ""
}
],
"skipped": [
{
"mp_id": "<string>",
"name": "",
"bilanzierungsgebiet_eic": "",
"zeitreihentypen": [
"<string>"
],
"reason": ""
}
],
"nachgetragen": [
{
"mp_id": "<string>",
"name": "",
"bilanzierungsgebiet_eic": "",
"zeitreihentypen": [
"<string>"
],
"reason": ""
}
]
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Authorizations
Body
Grant the Zuordnungsermaechtigung of one configured Unterbilanzkreis
to the named Netzbetreiber: one activation per Bilanzierungsgebiet in
its control areas, with its own Zeitreihentypen and validity. Manual
only - never on the timer - and dry_run unless set to false: a dry
run lists what would go out and sends and writes nothing.
EIC of a configured Unterbilanzkreis
1MP-IDs of the Netzbetreiber to grant it to
1Only these Bilanzierungsgebiete (EIC Y); default: every one of the named Netzbetreiber in the Unterbilanzkreis' control areas
Re-issue the Zeitreihentypen whose last activation failed in AS4 transport or was rejected by the Netzbetreiber (CONTRL/APERAK); without it they are only reported in skipped
Response
Successful Response
The main balance group it settles through
The Unterbilanzkreis' types
Dry run: the activations a real run would send
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Grants for this Unterbilanzkreis found only in the audit records (sent before the ledger knew them), taken into the ledger
Show child attributes
Show child attributes