GDBN BeFlexible Module¶

Type: GDBN_BEFLEXIBLE Category: Flexibility Maturity: DEVELOPMENT

Development Maturity

This module is currently in DEVELOPMENT maturity. APIs and behaviour may change. Contact the RECreation team before integrating in production environments.

The GDBN BeFlexible module integrates with the external GDBN flexibility market service. Unlike OSTEC, this module does not perform local optimization — instead, the GDBN service computes setpoints and flexibility offers, which are then pushed to RECreation via API.

Integration Flow¶

sequenceDiagram
    participant GDBN as GDBN Service
    participant API as RECreation API
    participant DB as Database

    GDBN->>API: POST /setpoints/external/GDBN_BEFLEXIBLE
    API->>DB: Store EnergySetpoints

    GDBN->>API: POST /offers/external/GDBN_BEFLEXIBLE
    API->>DB: Store FlexibilityOffers

    API->>GDBN: (webhook/callback with meter data)

Capabilities¶

Capability	Supported
`local_optimization`	No
`external_setpoint_reception`	Yes
`external_offer_reception`	Yes
`external_bid_integration`	Yes

Receiving Setpoints¶

The GDBN service authenticates and POSTs setpoints:

POST /core/api/communities/{community_id}/energy_management/setpoints/external/GDBN_BEFLEXIBLE

Accepts a list of ExternalSetpointSchema objects. Batch endpoint also available.

Receiving Flexibility Offers¶

POST /core/api/communities/{community_id}/energy_management/offers/external/GDBN_BEFLEXIBLE

Accepts ExternalFlexibilityOfferSchema. The offer is stored with status PLACED and linked to a FlexibilityZone.

Offer Lifecycle¶

stateDiagram-v2
    [*] --> PLACED: Offer received from GDBN
    PLACED --> ACCEPTED: Flexibility operator accepts
    ACCEPTED --> ACTIVATED: Offer activated (energy curtailed/shifted)
    PLACED --> REJECTED: Operator rejects
    PLACED --> EXPIRED: Time window passes without activation

Offer status can be updated via:

PATCH /core/api/communities/{community_id}/energy_management/offers/{offer_id}