Versie 0.1 — concept, commentaar welkom

Open Meterkastpaspoort

Een open specificatie voor de toestand van de meterkast, vastgelegd in een QR-code die bij de kast blijft.

Status: concept (v0.1) Datum: augustus 2026 Initiatief & auteur: Martin Schut, BlauweVisie B.V. (YourWkb.nl) Licentie: CC BY 4.0

1. Waarom een meterkastpaspoort

De meterkast is het hart van de woning geworden: zonnepanelen, laadpaal, warmtepomp en thuisbatterij komen er allemaal samen. Tegelijk neemt het aantal meterkast-incidenten toe en pleiten deskundigen voor een "APK van de meterkast". Het probleem van elke keuring is echter dat het rapport in een la verdwijnt — terwijl de kennis nodig is bij de kast, op het moment dat de volgende monteur er iets aan wijzigt.

Het meterkastpaspoort (MKP) draait dat om: de actuele toestand van de kast — aansluiting, capaciteit, aangesloten verbruikers en opwekkers, begrenzingsinstellingen en de wijzigingshistorie — wordt vastgelegd in een QR-code op een sticker aan de binnenzijde van de kastdeur. Elke monteur die de kast opent, scant en weet wat er hangt. Elke monteur die iets wijzigt, schrijft het paspoort bij en plakt een nieuwe sticker.

2. Ontwerpprincipes

  1. De data reist in de QR-code zelf. Het paspoort staat niet in een database maar in de code op de sticker. Scannen werkt daardoor ook in een kelder zonder bereik, en er bestaat geen centraal register dat op adres doorzoekbaar is.
  2. Privacy door architectuur. De data staat in het URL-fragment (het deel achter #). Fragmenten worden door browsers nooit naar een server verzonden; het paspoort verlaat de meterkast dus alleen als iemand die er fysiek staat het scant.
  3. Leveranciersonafhankelijk. Ieder softwareproduct mag het formaat lezen en schrijven (zie licentie). Een paspoort gemaakt met de ene applicatie is leesbaar voor de andere.
  4. Voorwaarts compatibel. Lezers moeten onbekende velden negeren en het versieveld respecteren, zodat oude stickers leesbaar blijven en het formaat kan groeien.
  5. Opgave, geen garantie. Het paspoort is een opgave van de laatste installateur. Het vervangt geen inspectie en geen vakmanschap; bij twijfel controleert de monteur ter plekke.

3. Technische drager

Een MKP-QR-code codeert een URL van de vorm:

https://meterkastpaspoort.nl/p#<data>

waarin <data> het paspoort is: een JSON-object, gecomprimeerd met deflate-raw en gecodeerd als base64url. Het domein leidt door naar een referentie-implementatie; omdat de data in het fragment zit, reist zij automatisch mee met de doorverwijzing en bereikt zij nooit de server. Elke andere implementatie kan dezelfde payload lezen door het fragment te decoderen.

Richtwaarde: een gevuld paspoort comprimeert tot ± 200–400 bytes en past daarmee ruim in een QR-code die op een sticker van 40–50 mm scherp afdrukbaar is.

4. Datamodel v0.1

Veldnamen zijn kort gehouden om de QR-code compact te houden. Alle velden zijn optioneel tenzij anders vermeld; lezers negeren onbekende velden.

4.1 Wortelobject

VeldTypeBetekenis
vgetalVerplicht. Specificatieversie, voor dit document 1.
dtekstDatum laatste bijwerking, JJJJ-MM-DD.
pc, nrtekstPostcode en huisnummer(-toevoeging) van het adres.
eantekstEAN-code van de elektriciteitsaansluiting (18 cijfers, NL begint met 87; laatste cijfer is GS1 modulo-10-controlecijfer). Vindbaar via eancodeboek.nl.
ean2tekstEAN van een eventueel secundair allocatiepunt (bijv. apart bemeten laadpaal).
bjtekstBouwjaar of aanlegperiode van de kast, desnoods geschat ("1998", "±1990"). Relevant voor het normregime van aanleg (rechtens verkregen niveau).
haobjectHoofdaansluiting — zie 4.2.
kamobjectOntwerpstroom verdeler — zie 4.3.
grplijstAfgaande en voedende groepen — zie 4.4.
lbobjectLoad balancing / vermogenssturing — zie 4.5.
chkobjectLaatste belastingcheck — zie 4.6.
loglijstInstallateurs-logboek — zie 4.7.

4.2 Hoofdaansluiting ha

VeldTypeBetekenis
fgetalAantal fasen: 1 of 3.
agetalWaarde hoofdzekering in ampère per fase (bijv. 25, 35).
hsgetalNominale stroom hoofdschakelaar in ampère, indien afwijkend of bekend.

4.3 Ontwerpstroom verdeler kam

VeldTypeBetekenis
mm2getalDoorsnede kam/rail in mm² (praktijk: 10 ≈ max 40 A, 16 ≈ max 63 A).
agetalMaximale stroom van de kam in ampère. Onbekend? Conservatief 40 A aanhouden.

Toetsregel: de som van de voedende groepen, op het deel van de kam waar hun stromen kunnen cumuleren, mag de kamcapaciteit niet overschrijden. Advies: voedende groepen zo dicht mogelijk bij het voedingspunt plaatsen.

4.4 Groepen grp[]

VeldTypeBetekenis
ttekstType: alg (algemene groep), kook, wp (warmtepomp), lp (laadpaal), pv (PV-omvormer), bat (thuisbatterij), ov (overig).
roltekstaf = afgaande groep (neemt stroom af), voed = voedende groep (levert stroom aan de kam: PV, ontladende batterij). Een batterij kan beide rollen hebben; noteer de rol met de hoogste stroom of twee regels.
kwgetalVermogen in kW (bij voed: maximale teruglever-/ontlaadstroom omgerekend).
fgetalFase(n): 1, 3, of fasenummer bij 1-fase op een 3-fase-installatie.
ntekstVrije korte omschrijving (bijv. "zolder PV 12 panelen").

4.5 Load balancing lb

VeldTypeBetekenis
aanja/neeIs er vermogenssturing actief?
typtekststat (statisch: vaste begrenzing) of dyn (dynamisch: meet en regelt live, bijv. via P1).
maxgetalIngestelde grenswaarde in ampère (statisch) of maximaal toegestane huisstroom (dynamisch).
regtekstRegisseur: welk systeem stuurt (bijv. "evcc", "HEMS fabrikant X", "laadpaal intern"). Meerdere onafhankelijke begrenzers zonder gezamenlijke regisseur verdienen een waarschuwing in de lezende applicatie.

Let op: load balancing is een software-instelling, geen veiligheidsmaatregel. De installatie behoort ook bij falende of opgeheven begrenzing veilig te zijn. Zonder aantoonbare gezamenlijke begrenzer is een gelijktijdigheidsfactor van 0,6 over de grote verbruikers een bruikbare conservatieve rekenbasis (richtlijn ontleend aan de belastingsfactoren uit de NEN-EN-IEC 61439-serie).

4.6 Laatste belastingcheck chk

VeldTypeBetekenis
rtekstUitkomst: groen, oranje (begrenzing vereist en vastgelegd) of rood (verzwaring geadviseerd).
dtekstDatum van de check, JJJJ-MM-DD.

4.7 Installateurs-logboek log[]

De laatste 5–10 wijzigingen, nieuwste eerst. Oudere regels vervallen om de QR-code compact te houden.

VeldTypeBetekenis
dtekstDatum, JJJJ-MM-DD.
btekstBedrijfsnaam van de installateur.
wtekstKorte omschrijving van de wijziging.
ctekstOptioneel contactgegeven (telefoon/e-mail), uitsluitend met instemming van de betreffende installateur.

5. Voorbeeld

{
  "v": 1, "d": "2026-08-06",
  "pc": "2801AB", "nr": "12",
  "ean": "871685900012345678", "bj": "±1995",
  "ha": { "f": 3, "a": 25 },
  "kam": { "mm2": 10, "a": 40 },
  "grp": [
    { "t": "pv",  "rol": "voed", "kw": 4.2, "f": 1, "n": "12 panelen zuid" },
    { "t": "lp",  "rol": "af",   "kw": 11,  "f": 3 },
    { "t": "wp",  "rol": "af",   "kw": 3.5, "f": 1 }
  ],
  "lb": { "aan": true, "typ": "dyn", "max": 25, "reg": "HEMS" },
  "chk": { "r": "oranje", "d": "2026-08-06" },
  "log": [
    { "d": "2026-08-06", "b": "Installatiebedrijf Jansen", "w": "Laadpaal 11 kW + belastingcheck" },
    { "d": "2024-03-11", "b": "PV Totaal", "w": "PV 12 panelen, groep 7" }
  ]
}

Dit object wordt gecomprimeerd (deflate-raw), gecodeerd als base64url en achter https://meterkastpaspoort.nl/p# geplaatst; van die URL wordt de QR-code gegenereerd.

6. Versiebeheer & bijdragen

Wijzigingsvoorstellen op deze concept-specificatie zijn welkom; het veld v wordt verhoogd bij niet-neerwaarts-compatibele wijzigingen. Lezers behoren paspoorten met een hogere versie zo goed mogelijk weer te geven en onbekende velden te negeren. De referentie-implementatie van deze specificatie is YourWkb.