v1

latestOpenAPI 3.0.02026-07-263365201.7 KB

Grid Fee Reductions

Create a grid fee reduction

Create a new grid fee reduction for §14a EnWG modules. Not applicable for feed-in subscriptions, which do not pay grid fees.

Grid fee reduction status:

If the subscription is active: grid fee reduction is created with ordered status. Order is submitted immediately
If the subscription is pending: grid fee reduction is created with intended status. Order will be submitted once the subscription is confirmed

Re-ordering after rejection: Re-ordering is allowed if the previous grid fee reduction was rejected or ended.

post/grid-fee-reductions

Request body

subscriptionstring required

ID of the subscription

type'enwg-14a-module-1' | 'enwg-14a-module-2' | 'enwg-14a-module-3' required

Grid fee reduction module type according to §14a EnWG

Example request

{
  "subscription": "sub_mi4f0oda6x9m7gcsvjk0ole1",
  "type": "enwg-14a-module-1"
}

Response

The newly created grid fee reduction.

object'grid_fee_reduction' required

Type of the object, always 'grid_fee_reduction'

idstring required

Unique identifier for the grid fee reduction

subscriptionstring required

ID of the subscription

type'enwg-14a-module-1' | 'enwg-14a-module-2' | 'enwg-14a-module-3' required

Grid fee reduction module type according to §14a EnWG

status'intended' | 'ordered' | 'rejected' | 'activated' | 'ended' required

Current status of the grid fee reduction order

valid_fromstring date-time nullable required

Start date of the grid fee reduction validity period

valid_untilstring date-time nullable required

End date of the grid fee reduction validity period

created_atstring date-time required

Timestamp when the grid fee reduction was created

updated_atstring date-time required

Timestamp when the grid fee reduction was last updated

customerstring required

ID of the customer the grid fee reduction belongs to

Example response

{
  "id": "gfr_mi4f0oda6x9m7gcsvjk0ole1",
  "subscription": "sub_mi4f0oda6x9m7gcsvjk0ole1",
  "type": "enwg-14a-module-1",
  "status": "intended",
  "valid_from": "2024-03-14T12:00:00Z",
  "valid_until": "2024-03-14T12:00:00Z",
  "created_at": "2024-03-14T12:00:00Z",
  "updated_at": "2024-03-14T12:00:00Z",
  "customer": "cus_mi4f0oda6x9m7gcsvjk0ole1"
}