Hele account exporteren en de opbouw van de bestanden

Met Hele account exporteren download je alle gegevens van je organisatie in één ZIP-bestand. Daarin staan de instellingen, gateways, Modbus apparaten, registers, alarmen, automatiseringen, dashboards, rapporten, klanten en leden, plus de metingen binnen de bewaartermijn van 365 dagen. De export is gratis en gebruikt open formaten die software kan lezen (CSV en JSON).

Deze pagina beschrijft ook hoe de bestanden zijn opgebouwd. Dat is het overzicht van exportformaten dat de Europese Dataverordening vraagt voor overstappen naar een andere aanbieder.

Export aanvragen

1. Instellingen openen

   Open Instellingen en kies Gegevens exporteren.

2. Export aanvragen

   Klik op Export aanvragen. Het venster Hele account exporteren opent.

3. Kiezen wat erin komt

   Kies het Bestandsformaat (CSV voor Excel of JSON), het detail van de Metingen (elke meting, per 15 minuten, per uur of per dag) en de Periode (alles binnen de bewaartermijn of zelf kiezen). Heb je klanten, dan kies je bij Klanten de hele account of één klant.

4. Export starten

   Klik op Export starten. Het bestand wordt op de achtergrond gemaakt. Je krijgt een e-mail zodra het klaar is.

5. Bestand downloaden

   De knop in de e-mail opent Gegevens exporteren in het portaal. Klik daar op Downloaden bij de export.

Inhoud van het ZIP-bestand

Elk bestand in config/ is een JSON-lijst met één object per rij. Id's zijn UUID's en verbinden de bestanden. device_id verwijst naar een gateway, modbus_dev_id naar een Modbus apparaat en register_id naar een register.

Bewust niet in de export staan geheimen (tokens, API-sleutels en hun hash, wachtwoorden, het geheim van webhooks en de waarden van eigen koppen, de codes van deellinks en uitnodigingen), interne gegevens van de automatische bewaking en IP-adressen in het beheerlog.

Metingen als CSV

Alle CSV-bestanden zijn UTF-8 met een BOM, zodat Excel tekens als °C goed toont. In het Nederlands en Duits staat een puntkomma tussen de kolommen en een komma in getallen. In het Engels een komma tussen de kolommen en een punt in getallen. Tijden zijn lokale tijd van de organisatie als JJJJ-MM-DD UU:MM:SS. Waarden zijn omgerekend met de schaalfactor van het register, zoals het portaal ze toont.

Elke meting

Eén regel per tijdstip en één kolom per register. De kolomkop is Modbus apparaat / Register (eenheid), met [verwijderd] bij een verwijderd register. manifest.json noemt bij elk bestand welk register in welke kolom staat. Heeft een register twee metingen op hetzelfde tijdstip, dan staat de eerste in het bestand.

Per 15 minuten, uur of dag

Eén regel per vak per register met deze kolommen.

Vakken van 15 minuten en een uur liggen op de klok. Een dag loopt van middernacht tot middernacht in de tijdzone van de organisatie, dus 23 of 25 uur bij de wissel van zomer- naar wintertijd.

Metingen als JSON

JSON-bestanden volgen het formaat modbuscloud.readings, versie 1. Eerst de gegevens van de export en de registers, daarna de waarden. Tijden in JSON zijn UTC in ISO 8601.

{
  "format": "modbuscloud.readings",
  "format_version": 1,
  "generated_at": "2026-10-15T09:00:00.000Z",
  "gateway": { "serial": "6008123409", "name": "Kast 1" },
  "timezone": "Europe/Amsterdam",
  "resolution": "day",
  "from": "2026-09-30T22:00:00.000Z",
  "to": "2026-10-15T09:00:00.000Z",
  "truncated": false,
  "row_limit": null,
  "complete_from": null,
  "values_scaled": true,
  "registers": [
    { "id": "53e8429e-...", "name": "Energie import", "unit": "kWh", "modbus_device": "kWh-meter 1",
      "slave_id": 1, "address": 30001, "data_type": "uint32", "scale_factor": 0.1, "counter": true, "retired": false }
  ],
  "buckets": [
    { "start": "2026-09-30T22:00:00.000Z", "end": "2026-10-01T22:00:00.000Z", "register_id": "53e8429e-...",
      "count": 96, "avg": 1452.3, "min": 1447.1, "max": 1457.6, "first": 1447.1, "last": 1457.6, "delta": 10.5, "delta_reset": false }
  ]
}

Verbruik bij tellers

Een register is een teller als het zo is ingesteld of herkend, zoals een kWh-meterstand, een volume of bedrijfsuren. Het verbruik van een vak is de laatste stand van dat vak min de laatste stand van het vorige vak met metingen. Voor het eerste vak telt de laatste stand uit de 7 dagen ervoor. Daalt de stand, omdat de teller is teruggezet of de meter is vervangen, dan is het verbruik van dat vak leeg en staat Teller teruggezet op ja (delta_reset: true in JSON). Dezelfde regel geeft de staafgrafiek met verbruik in een dashboard.

Metingen van één gateway

Bij Metingen downloaden in het menu van een gateway kies je dezelfde formaten en hetzelfde detail. Zo'n bestand bevat hooguit 500 000 metingen. Zijn het er meer, dan krijg je de nieuwste en zegt de eerste regel van de CSV (of complete_from in JSON) vanaf welk tijdstip het bestand volledig is. Zie Metingen downloaden.