Fluvius

Inleiding

Deze connector laat toe om te communiceren met Fluvius.

Fluvius

Distributienetbeheerder in alle gemeenten van het Vlaams Gewest. Ontstaan uit de fusie van Eandis en Infrax op 1 juli 2018. Fluvius is verantwoordelijk voor elektriciteit, aardgas, riolering, openbare verlichting, en in sommige gemeenten warmtenetten. Sinds 1 januari 2023 is Fluvius verantwoordelijk voor de plaatsing en uitrol van digitale meters voor alle Vlaamse huishoudens. Fluvius zorgt ook voor aansluitingen, meteropnames, beheer van groenestroom, laadpalen, enzovoort.

Benopass

In Vlaanderen is de Benopass (of “Totaalrenovatiebonus”-pass) een digitaal dossier beheerd door netbeheerder Fluvius. Het volgt alle energiebesparende renovatiewerken in je woning van 2017–2020 bij. Wie binnen vijf jaar minstens drie van deze werken uitvoerde, ontving hiervoor een extra bonus. Via de connector kan je een renovatiedossier doorsturen naar Benopass.

Use cases

• Aansluitingsgegevens van een klant ophalen op basis van een EAN-code (bv. adres, tariefstructuur, aanwezige lokale productie-installaties zoals zonnepanelen) om te gebruiken binnen een dossier.

• EPC-informatie van een aansluiting raadplegen.

• Een renovatiedossier (premie) en de bijhorende bewijsstukken doorsturen naar Benopass, in het kader van de Totaalrenovatiebonus.

Setup

Onboardingprocedure

De authenticatie met de Fluvius Assets API gebeurt via client assertion: een JWT die je zelf ondertekent met een privésleutel, in plaats van via een gedeeld secret. Dit vereist een certificaatstraject vóór je effectief kan configureren:

1. Certificaat aanvragen bij GlobalSign: maak lokaal een certificate signing request (CSR) en private key aan. GlobalSign verifieert domeineigenaarschap via een DNS TXT-record dat je in de hosted zone moet plaatsen. Na verificatie stuurt GlobalSign het certificaat naar Skryv.

2. Certificaat laten whitelisten bij Fluvius: stuur het certificaat naar Fluvius, zodat zij het toevoegen aan de firewall van hun Assets API.

3. JWK genereren uit het certificaat:

   • Bundel certificaat + private key in een PKCS12-bestand, en zet dit om naar JWK-formaat.

   • Verwijder de velden use, alg en x5c uit de gegenereerde JWK.

   • Pas het x5t-veld aan: Fluvius vereist de base64url-encoding van de hex-geïnterpreteerde kid-waarde (niet de kid als string). Gebruik hiervoor het door Fluvius aangeleverde Java-hulpprogramma.

   • Het resultaat is een JWK-bestand met enkel kid, kty, n, e, dp, dq, qi, p, q, d, x5t.

Van Fluvius ontvang je: de subscription key, de API-URL, en het app-number. Het certificaat/private key/JWK maak je zelf aan.

Dependency toevoegen aan pom.xml bestand

Om de connector te kunnen gebruiken, voeg je deze eerst als maven dependency toe aan het pom.xml bestand van je applicatie. Deze haalt de code voor de connector op bij het maken van de build voor je app.

<dependency>
   <groupId>com.skryv.connectors</groupId>
   <artifactId>fluvius</artifactId>
   <version>${skryv.version}</version>
</dependency>

Applicatie eigenschappen

Volgende applicatie eigenschappen kunnen ingesteld worden bij de technische setup van de Fluvius-connector.

Services en functies

Overzicht

@RequiredArgsConstructor
public class MyOwnService {
    private final FluviusCamundaConnector fluvius;
}

getConnectionInformation

Workflow expressie 1

${fluvius.getConnectionInformation(String ean)}

Workflow expressie 2 (met refertedatum)

${fluvius.getConnectionInformation(String ean, LocalDate date)}

Java-code

java

ConnectionInformationResponseDto response = fluvius.getConnectionInformation(ean);
// of, met refertedatum:
ConnectionInformationResponseDto response = fluvius.getConnectionInformation(ean, date);

Input

Output

Je krijgt een ConnectionInformationResponseDto-object terug met twee velden: status (ResultStatus) en result (ResultInformation, enkel ingevuld bij SUCCESS).

ResultStatus kan volgende waarden aannemen: WaardeBetekenisSUCCESSAansluiting gevonden, result is ingevuld.EAN_NOT_ELECTRICITYDe opgegeven EAN is geen elektriciteitsaansluiting.EAN_OUTSIDE_FLANDERSDe aansluiting valt buiten het Vlaamse Gewest.EAN_NOT_FOUNDEAN-code niet gevonden.TECHNICAL_ERRORTechnisch probleem bij Fluvius.

ResultInformation bevat: ean, address (straat, huisnummer, busnummer, postcode, plaatsnaam, landcode), rate (tariefstructuur: SINGLE, SINGLE_EXCLUSIVE_NIGHT, DOUBLE, DOUBLE_EXCLUSIVE_NIGHT, EXCLUSIVE_NIGHT), digitalMeterPlacementDate, connectionDateUtc, isEanActive, dnb (distributienetbeheerder), localProductions (lijst van lokale productie-installaties zoals zonnepanelen, elk met type — PV, BIOM, FOSM, PCSM, WIND, WATR, ONBE — en vermogen), accesspointsAmount, isExclusiveNightMeter, aansluitObjectId, superAansluitObjectId.

Error-handling

Deze functie gooit geen exceptie bij een probleem. Controleer altijd zelf het status-veld vóór je result gebruikt:

ConnectionInformationResponseDto response = fluvius.getConnectionInformation(ean);
if (response.getStatus() != ResultStatus.SUCCESS) {
    // result is niet ingevuld -- behandel de specifieke status
}

getEpcInformation

getEpcInformation

Workflow expressie

${fluvius.getEpcInformation(String ean)}

Java-code

java

EpcInformationResponseDto response = fluvius.getEpcInformation(ean);

Input

Output

Je krijgt een EpcInformationResponseDto-object terug met: ean, epclabelVoor/epclabelNa (EPC-label vóór/na renovatie), epcDatumVoor, epcDatumVervallen, dossiernummer, activatiedatum, vervaldatum, en drie velden lapAanw, laaAanw, benoAanw.

Error-handling

In tegenstelling tot getConnectionInformation bevat dit DTO geen status-veld. Op basis van de code (een rechtstreekse RestTemplate-aanroep zonder foutafhandeling) resulteert elk technisch probleem of een niet-gevonden EAN in een niet-opvangbare exceptie en dus een Camunda-incident, niet in een status binnen het antwoordobject zelf.

sendToBenopass

Workflow expressie

${fluvius.sendToBenopass(Premie premie)}

Java-code

java

fluvius.sendToBenopass(premie);

Input

Het Premie-object bevat algemene gegevens (leverpunten, opdrachtgever, contactPersoon, bedragen, facturen, woningType, investeringsType, beschermdeKlant, aantalAppartementen, referentieWoningVlaanderen, rekeningNummer) plus een lijst types (CategorieenType-codes: DAK, MUUR, GLAS, ZONNEBOILER, VLOER, WARMTEPOMP) die aangeeft welke van de volgende secties je invult: glas, kelder, dak, spouwmuur, buitenmuurBinnenkant/buitenmuurBuitenkant, vloer, warmtepomp, zonneboiler. Vul enkel de sectie(s) in die overeenkomen met de opgegeven types. de overige secties laat je leeg.

Output

Geen output (void).

Error-handling

sendBijlageToBenopass

Workflow expressie

${fluvius.sendBijlageToBenopass(String dossierId, BijlageInfo bijlageInfo)}

Java-code

fluvius.sendBijlageToBenopass(dossierId, bijlageInfo);

Input

Output

Geen output (void). Een succesvolle upload resulteert intern in HTTP 202 Accepted (asynchrone verwerking aan Fluvius' kant).

Error-handling