> For the complete documentation index, see [llms.txt](https://docs.smart-stuff.nl/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.smart-stuff.nl/dsmr-api/gebruik/productie-zonne-energie.md).

# Productie (Zonne-energie)

De dongle kan ook gekoppeld worden aan uw omvormer. Dit om de dag en actuele productie te kunnen zien. Helaas alleen nog voor deze merken:

* SolarEdge
* Enphase
* SMA

### Koppelen <a href="#koppelen" id="koppelen"></a>

Via menu > Settings > Solar Setup kunt u bij de configuratie komen. Via dit scherm wordt de configuratie ingegeven. Dit kan ook voor beide systemen.

{% hint style="warning" %}
Voor SMA dient er een bestand geupload te worden
{% endhint %}

<figure><img src="/files/tk7cbQlDZm3OluPGeoul" alt="" width="375"><figcaption></figcaption></figure>

#### Multi vendor systeem <a href="#multi-vendor-systeem" id="multi-vendor-systeem"></a>

Heeft u zonnepanelen met omvormers van Enphase + SolarEdge dan worden deze beide ondersteund. De opwekking van beide systemen worden los van elkaar gelezen en gecombineerd (opgeteld) weergegeven. Lekker makkelijk toch ... alles in 1 overzicht.

#### SMA <a href="#enphase-iq-gateway" id="enphase-iq-gateway"></a>

De SMA omvormers worden uitgelezen op basis van het uitlezen van WebConnect. De omvormer dient dit te ondersteunen.

Er dient een `sma.json` bestand te worden aangemaakt en op de dongle te worden gezet\
{\
"gateway-url": "\<ip adres van de sma omvormer>",\
"token": "\<SMA\_USER\_WACHTWOORD>",\
"wp": 0,\
"siteid": 0,\
"refresh-interval": 15\
}

Alleen gateway-url en token dienen ingevuld te worden. Wilt u de sma.json wijzigen dan kunt u de gewijzigde file uploaden. Daarna de dongle rebooten.

#### Enphase IQ Gateway <a href="#enphase-iq-gateway" id="enphase-iq-gateway"></a>

Voor Enphase dient minimaal het Token ingevuld te worden.

| gateway-url      | <https://envoy/api/v1/production> | url van de lokale IQ Gateway. Mocht deze niet op envoy te bereiken zijn dan kan voor envoy ook het ip-adres ingevuld worden |
| ---------------- | --------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| wp               | 3300                              | systeemvermogen in Wp. deze wordt gebruikt voor het bepalen van het benuttig van het totaal.                                |
| expire           | 0                                 | waarde 0 is geen check. Indien gevuld zal de Monitor checken of het token verlopen is.                                      |
| refresh-interval | 60                                | per x seconde zal de data uit de IQ Gateway worden opgehaald. Deze kan ingesteld worden.                                    |
| token            | geheim per gebruiker/site         | ​                                                                                                                           |

\
**STAP 1: Verkrijgen van Token**

Dit gaat nogal omslachting bij Enphase ... het normale token is 12uur geldig en dat werkt niet.

Via onderstaande procedure krijgt u een 1 jaar geldig token.

1\) ga naar uw lokale envoy systeem via : <https://envoy/home>

<figure><img src="https://docs.smart-stuff.nl/~gitbook/image?url=https%3A%2F%2F51680982-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FOLi8uKVPCtT26B5HWACG%252Fuploads%252FxS4KuAdhnopGhid7Kj4P%252FScreenshot%25202025-01-26%2520at%252010.44.55.png%3Falt%3Dmedia%26token%3D2f97f999-4678-4d9a-908c-b98c6e8e9027&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=ccfeeb0d&#x26;sv=2" alt=""><figcaption></figcaption></figure>

2\) druk op login with Enphase

<figure><img src="https://docs.smart-stuff.nl/~gitbook/image?url=https%3A%2F%2F51680982-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FOLi8uKVPCtT26B5HWACG%252Fuploads%252FcAw1vNNGTQLZ3gokeyR9%252FScreenshot%25202025-01-26%2520at%252010.45.01.png%3Falt%3Dmedia%26token%3D369c2e89-cb80-48bd-a769-1dda488a6d5d&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=ee9422c0&#x26;sv=2" alt=""><figcaption></figcaption></figure>

3\) vul username en password in en druk op log in

U krijgt het ingelogd scherm en dient even te wachten voordat u terug gaat naar uw lokale envoy

4\) kopieer Serial Number

5\) in dezelfde browser (ander tab) plakt u onderstaande url + na het "=" het serienummer uit stap 4

<https://enlighten.enphaseenergy.com/entrez-auth-token?serial_num=>\<serienummer uit stap 4>

6\) Kopieer het access token. Aan de verlooptijd (einde van het data pakket) kunt u zien dat deze 1 jaar geldig is.

{% hint style="warning" %}
De tokens zijn maximaal 1 jaar geldig. Na een jaar dient u de handeling te herhalen.
{% endhint %}

#### SolarEdge <a href="#solaredge" id="solaredge"></a>

De verschillende waardes dienen ingevuld te worden waarbij "token" en "SiteID" de belangrijkste zijn.

| gateway-url      | niet van toepassing       | niet gebruikt                                                                                                                            |
| ---------------- | ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| wp               | 3300                      | systeemvermogen in Wp. deze wordt gebruikt voor het bepalen van het benuttig van het totaal.                                             |
| expire           | 0                         | waarde 0 is geen check. Indien gevuld zal de Monitor checken of het token verlopen is.                                                   |
| refresh-interval | 300                       | per x seconde zal de data worden gelezen. v1 koppeling mag maximaal 300 keer per dag worden gelezen dan is ca elke 5 minuten een update. |
| token            | geheim per gebruiker/site | Deze kunt u van uw installateur opvragen of heeft u al een keer ontvangen. Dit wordt ook wel de X-API-Key genoemd.                       |
| siteid           | geheim per gebruiker/site | Deze kunt u van uw installateur opvragen of heeft u al een keer ontvangen.                                                               |

{% hint style="info" %}
Om het SolarEdge token te kunnen opvragen/maken dient u admin te zijn op uw systeem. Mocht u dat niet zijn dan dient u SolarEdge/Installateur te vragen om dit te doen.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.smart-stuff.nl/dsmr-api/gebruik/productie-zonne-energie.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.