Je data in PVOutput krijgen

Eens je een PVOutput-account hebt aangemaakt, een systeem hebt gedefinieerd en een API-sleutel hebt aangevraagd, begint het echte werk: hoe krijg je de productiedata van je installatie automatisch in dat account? Dit artikel loopt door de praktische opties in 2026, gegroepeerd per soort installatie, met de praktische voor- en nadelen van elk.

Voor ik begin, één belangrijke verduidelijking. PVOutput is ontworpen om herhaaldelijk data te ontvangen, niet om data op te halen van de omvormer. Het is altijd jouw kant van de configuratie die naar PVOutput pusht, nooit andersom. Dat is een ontwerpkeuze die het hele platform veel betrouwbaarder maakt: PVOutput hoeft niet voor honderdduizenden inverters te authenticeren of fabrikantenkennis te onderhouden. Maar het betekent ook dat er ergens in jouw setup een component moet zijn die zegt: "Hier is de huidige status van mijn installatie, sla dit op alstublieft."

Die component kan zijn:

1. De omvormer zelf, als hij ingebouwde PVOutput-ondersteuning heeft (zeldzaam).
2. Een cloud-service van de fabrikant, die regelmatig naar PVOutput pusht via een ingebouwde brug.
3. Een brug die draait op je thuisnetwerk, zoals Home Assistant, Solar Assistant of IoTaWatt, die data lokaal verzamelt en doorstuurt.
4. Een script of utility op een server of computer, dat de fabrikantencloud ondervraagt en zelf naar PVOutput pusht.
5. Handmatige invoer, via de webinterface, als laatste redmiddel.

Welke optie het beste is, hangt af van het merk van je omvormer, hoe technisch je je voelt, en of je toch al andere thuisautomatiseringsdingen draait. Laat ik door de meest voorkomende scenario's lopen.

Optie 1: directe push vanuit de omvormer

Sommige omvormers hebben native PVOutput-ondersteuning. Het is geen courante feature, maar wel een prachtige als ze er is. Fronius heeft het ingebouwd in zijn oudere Datamanager 2.0 hardware: je vult je systeem-ID en API-sleutel in op de web-interface van de omvormer, en het ding pusht elke vijf minuten zonder verdere tussenkomst. Het gebeurt allemaal direct vanuit de omvormer naar pvoutput.org, zonder cloud-tussenstap.

Recente Fronius-modellen (Symo GEN24, Primo GEN24) hebben deze functionaliteit niet meer ingebouwd, ironisch genoeg. De motivatie is dat Fronius zijn klanten naar Solar.web wil sturen. Het feature kan herwonnen worden via een soort tussenoplossing zoals een Home Assistant brug, maar de tijden van pure "klik en pusht" zijn voor nieuwere Fronius helaas voorbij.

Andere merken met directe PVOutput-push, voor zover ik weet: oudere SMA Webconnect omvormers, oudere Enphase Envoy modellen. Voor de meeste moderne omvormers in 2026 is dit geen realistische optie meer, en moet je naar één van de andere oplossingen.

Optie 2: een fabrikantencloud die naar PVOutput pusht

Dit is de schoonste oplossing als ze beschikbaar is. PVOutput maakt zelf de PVOutput Auto Uploader beschikbaar, een gratis dienst die data van bepaalde fabrikantenclouds ophaalt en in jouw PVOutput-account zet. Ondersteunde merken zijn op het moment van schrijven: SolarEdge, Enphase, GoodWe SEMS, Solis SolisCloud, SMA Sunny Portal, Huawei FusionSolar (gedeeltelijk), en een paar kleinere merken.

De installatie verloopt typisch zo: je logt in op de PVOutput Auto Uploader-pagina, voegt je systeem toe, geeft de credentials van de fabrikantencloud (jouw login of API-token bij SolarEdge bijvoorbeeld), en koppelt het aan een PVOutput-systeem. Vanaf dat moment loopt het automatisch. Geen scripts, geen serverbeheer, geen kopzorgen.

Er zijn een paar praktische punten. SolarEdge limiteert API-toegang tot 300 calls per dag, wat ruim voldoende is voor één PVOutput-koppeling maar een probleem kan worden als je ook Home Assistant uit dezelfde API laat trekken. Enphase heeft zijn eigen limieten en eigenaardigheden. De Auto Uploader is een gratis service, maar sommige geavanceerde functies zoals het uploaden van omvormertemperatuur vereisen een PVOutput-donatie. De meeste gebruikers redden het prima op de gratis tier.

Voor de meeste residentiële installaties met een mainstream merk omvormer is de Auto Uploader het juiste antwoord. Hij vraagt een halfuur configuratie, draait jaren door zonder onderhoud, en doet exact wat je zou willen dat het deed.

Optie 3: een brug op je thuisnetwerk

Dit is waar het interessanter wordt voor wie iets meer wil dan alleen PVOutput. Een lokale brug op je netwerk haalt data uit je omvormer (vaak via lokale Modbus TCP, lokale API of een andere protocol), verzamelt het, en stuurt het door naar PVOutput. Het grote voordeel boven optie 2 is dat de data lokaal bij jou staat en dat je niet afhangt van de fabrikantencloud. Als die cloud uitvalt of de fabrikant beslist morgen je toegang in te trekken, jij hebt de data nog.

Home Assistant is de open-source gigant in deze ruimte. Bijna elk groot merk omvormer heeft een officiële of community-gemaakte integratie: SolarEdge (lokaal Modbus TCP, geen cloud nodig), Enphase (lokale Envoy, sub-minute updates), Fronius (lokale API, zeer snel), SMA (Speedwire), Huawei FusionSolar, GoodWe, Growatt, Solis, Victron, en nog veel meer. Eens Home Assistant de data heeft, stuur je het door naar PVOutput hetzij via een community add-on die om de paar minuten naar de API post, hetzij via een eenvoudige automatisering die volgens schema draait. Dit is de optie die ik persoonlijk gebruik, en het voordeel is dat je een lokale kopie hebt van al je data naast de PVOutput-upload, plus de mogelijkheid om in real time op die data te reageren (de vaatwasser aanzetten, de auto laden, de warmtepomp doen draaien). Voor wie al om andere redenen Home Assistant draait, is zonne-energie integreren een zaterdagnamiddagproject.

Solar Assistant is een commercieel alternatief gericht op DIY-zonne-installaties, vooral hybride omvormers van LuxPower, Deye, Growatt, MPP Solar en gelijkaardige merken. Hij draait op een Raspberry Pi, kost rond de €54 eenmalig, en biedt een nette webdashboard plus MQTT-output voor integratie in Home Assistant. Solar Assistant heeft momenteel geen ingebouwde PVOutput-uploader, ondanks dat dit al jaren op de wenslijst staat, dus de typische opstelling is Solar Assistant naar MQTT naar Home Assistant naar PVOutput. Meer onderdelen, maar elk onderdeel is op zich betrouwbaar.

IoTaWatt is een open-source CT-clamp-meter die je in je zekeringkast installeert. Hij meet productie en verbruik tegelijk en stuurt data naar PVOutput. De hardware kost ongeveer €350 zonder CT-klemmen of €450 inclusief klemmen voor een 3-fase huishouden. Dit is een aparte oplossing van Optie 2 omdat IoTaWatt rechtstreeks met de elektrische installatie praat, niet met de omvormer. Voordeel: je hebt ook consumptiemonitoring in één klap, wat we in een ander artikel verder bespreken.

Optie 4: een eigen script

Voor wie technisch genoeg is om Python of een andere scripttaal te schrijven, biedt PVOutput een open HTTP-API die het mogelijk maakt om zelf data te pushen. De API is gedocumenteerd op pvoutput.org/help. Een typische opstelling: een script draait elke vijf minuten op een server (een Raspberry Pi, een VPS, een Synology NAS), haalt data uit de fabrikantencloud of uit een lokaal Modbus-apparaat, en post naar addstatus.jsp op pvoutput.org.

Voor merken zonder Auto Uploader-ondersteuning is dit vaak het meest pragmatische pad. Voor de SBFspot-software (open source, oorspronkelijk voor SMA-omvormers via Bluetooth, ondertussen ook voor Speedwire) is er een PVOutput-integratie die out-of-the-box werkt. Voor Growatt-omvormers bestaan diverse community-scripts die de Growatt-cloud-API ondervragen en doorpushen naar PVOutput. Hetzelfde voor Deye, Sungrow, en andere merken zonder officiële Auto Uploader-ondersteuning.

Dit pad vraagt onderhoud. Scripts breken, fabrikantencloud-API's veranderen onaangekondigd, certificaten verlopen. Wie weinig zin heeft om een paar keer per jaar een uurtje te besteden aan iets dat is omgevallen, kiest beter optie 2 of 3. Wie het script schrijven oké vindt en de controle apprecieert, kan met optie 4 vaak een setup hebben die over jaren zonder ingreep door blijft draaien.

Optie 5: handmatige invoer

PVOutput laat je ook gewoon dagelijks de cijfers invoeren via de webinterface. Veel mensen denken dat dit een verloren tijd is, en voor de meeste setups is dat ook zo. Maar als je een hele oude installatie hebt zonder enige slimme uitlezing, of een omvormer waar geen integratie voor bestaat, dan kan je gewoon eens per dag of eens per week de daglezing aflezen op de schermpje van de omvormer en intypen.

Daar is geen schaamte over te hebben. De data is op die manier minder gedetailleerd (je krijgt geen vermogenscurve, alleen dagelijkse totalen), maar het is wel voldoende voor de langetermijntrends, de jaar-op-jaar-vergelijkingen, en de specifieke yield. Voor sommige eigenaars, met name van oudere installaties, is dit gewoon hoe ze het al jaren doen, en het werkt.

Een paar veelvoorkomende valkuilen

Een paar dingen die ik mensen meer dan eens heb zien tegenkomen:

Verwarring tussen "system size" en geïnstalleerd vermogen. PVOutput vraagt bij configuratie naar de DC-piekcapaciteit (in W) van je systeem. Dat is het paneelvermogen, niet het omvormervermogen. Een 6 kWp installatie met een 5 kVA omvormer voer je in als systeem-grootte 6000, niet 5000. PVOutput gebruikt dit voor de Specific Yield berekeningen die in Reading your solar charts: what the numbers actually mean verder uitgelegd worden.

Tijdzone-issues. PVOutput werkt met UTC of met de tijdszone van het account. Als de tijdszone fout staat, krijg je curves die er raar uitzien (productie 's nachts, lege uren overdag). Controleer de instelling op je accountpagina en check dat de tijdstempels die je upload op dezelfde basis lopen.

Rate limit-fouten. Als je in één keer veel historische data probeert te uploaden, kan je tegen rate limits aanlopen. De vrije tier heeft 60 calls per uur, donateurs hebben 300. Een script dat één bulk-upload doet van een heel jaar historiek, hits dat plafond in seconden. Spreid bulk-uploads over meerdere uren als je geen donatie hebt gemaakt.

Dubbele systemen. Wie experimenteert kan per ongeluk twee verschillende clients tegelijk dezelfde data laten uploaden (bijvoorbeeld de Auto Uploader EN een eigen script). PVOutput accepteert beide, en de data wordt simpelweg overschreven door wie het laatst pushed, wat soms tot rare effecten leidt waarbij dezelfde waarden lijken te schommelen. Stop één van de twee.

Welke optie voor wie?

De beslisboom is korter dan het artikel doet vermoeden. Als je een oudere Fronius hebt met een Datamanager 2.0, gebruik de ingebouwde push en stop met lezen. Als je een SolarEdge of Enphase hebt, gebruik de Auto Uploader. Als je al Home Assistant draait om andere redenen, plug je omvormerintegratie in en stuur door naar PVOutput. Als je een DIY-zonne-enthousiasteling bent met een hybride omvormer en een Raspberry Pi, kijk naar Solar Assistant of een eigen script. Als je een omvormer hebt die zo oud is dat hij dateert van voor het internet, typ de cijfers in.

Voor de meeste residentiële Belgische en Nederlandse installaties in 2026 zal de Auto Uploader of een Home Assistant brug het juiste pad zijn. Beide werken jaren door zonder veel aandacht, en beide brengen je data in een vorm die door eender welke app op je telefoon, tablet of computer kan gelezen worden. Eens het draait, is het effectief af. Je kan dan doorgaan naar het stuk waar het werkelijk om gaat: de data lezen en begrijpen.