# Fluid Synoptic

De sectie Fluid Synoptic beheert de energie-meetinfrastructuur van het gebouw en registreert bezoeken ter plaatse. Het biedt een gestructureerd register van alle nutsmeters (Water, Elektriciteit, Gas, Verwarming en Koeling) gekoppeld aan de betreffende huurders en bediende gebieden, samen met een volledig Identiteitsprofiel dat vastlegt wie het gebouw beheert en bezoekt.

***

## Overzicht

De sectie Fluid Synoptic is verdeeld in twee afzonderlijke gebieden:

| Sectie                   | Beschrijving                                                                                              |
| ------------------------ | --------------------------------------------------------------------------------------------------------- |
| **Identiteitsprofiel**   | Registreert de geschiedenis van bezoeken ter plaatse en de belangrijkste beheercontacten voor het gebouw. |
| **Fluid Synoptic-tabel** | Register van alle energie- en nutsmeters, hun locaties, huurders en validatiestatus.                      |

***

## Identiteitsprofiel

De Identiteitsprofiel-tabel biedt een geconsolideerd overzicht van wie het gebouw beheert en wanneer het is bezocht. Dit is met name belangrijk voor faciliteitenbeheer, auditing en naleving van regelgeving.

### Tabelkolommen

| Kolom                     | Beschrijving                                                                            |
| ------------------------- | --------------------------------------------------------------------------------------- |
| **Vastgoedbeheerder**     | De naam van de vastgoedbeheerder die verantwoordelijk is voor het gebouw.               |
| **Energiebeheerder**      | De naam van de energiebeheerder die toezicht houdt op het nutsverbruik.                 |
| **Faciliteitenbeheerder** | De naam van de faciliteitenbeheerder die de dagelijkse werkzaamheden afhandelt.         |
| **Huurders**              | De lijst van huurders die aanwezig waren of werden vertegenwoordigd tijdens het bezoek. |
| **Oppervlakte**           | Het totale oppervlak dat tijdens het bezoek werd gedekt.                                |
| **Bezoekdatum**           | De datum waarop het bezoek ter plaatse werd uitgevoerd.                                 |
| **Adressen**              | Het adres of de adressen bezocht tijdens de inspectie ter plaatse.                      |

### Een bezoek toevoegen

Klik op **Bezoek toevoegen** om een nieuw bezoek ter plaatse te registreren. Het formulier bevat de volgende velden:

| Veld                      | Type                 | Verplicht | Opmerkingen                                                                               |
| ------------------------- | -------------------- | --------- | ----------------------------------------------------------------------------------------- |
| **Bezoekdatum**           | Datumkiezer          | Ja        | De datum van het bezoek.                                                                  |
| **Huurders**              | Meervoudige selectie | Nee       | Selecteer alle huurders die aanwezig waren of werden vertegenwoordigd tijdens het bezoek. |
| **Vastgoedbeheerder**     | Selecteer / Tekst    | Ja        | De vastgoedbeheerder die verantwoordelijk was voor het uitvoeren van het bezoek.          |
| **Energiebeheerder**      | Selecteer / Tekst    | Nee       | De energiebeheerder die aanwezig was tijdens het bezoek.                                  |
| **Faciliteitenbeheerder** | Selecteer / Tekst    | Nee       | De faciliteitenbeheerder die aanwezig was tijdens het bezoek.                             |

Elk bezoekrecord wordt toegevoegd aan de Identiteitsprofiel-tabel en is onveranderlijk zodra opgeslagen — de volledige geschiedenis van bezoeken wordt bewaard.

***

## Fluid Synoptic-tabel

De Fluid Synoptic-tabel is een uitgebreid register van alle nutsmeters in het gebouw. Het bijhoudt welke huurder elke meter bedient, de fysieke locatie van de meter, bijbehorende submeters en validatiestatus.

### Ondersteunde energietypes

| Energietype       | Beschrijving                                        |
| ----------------- | --------------------------------------------------- |
| **Water**         | Meters voor koud- en warmwatertoevoer.              |
| **Elektriciteit** | Meters voor elektrisch stroomverbruik.              |
| **Gas**           | Meters voor aardgastoevoer.                         |
| **Verwarming**    | Meters voor district- of centrale verwarming.       |
| **Koeling**       | Meters voor district- of centrale koeling/chilling. |

### Tabelkolommen

| Kolom                      | Beschrijving                                                                                |
| -------------------------- | ------------------------------------------------------------------------------------------- |
| **Energietype**            | Het type gemeten energie (Water, Elektriciteit, Gas, Verwarming, Koeling).                  |
| **Meter-ID-nummer**        | De unieke identificator van de fysieke meter (zoals gemarkeerd op het apparaat).            |
| **Meterlocatie**           | De fysieke locatie van de meter in het gebouw, uitgedrukt in het standaardformaat.          |
| **Huurderbedrijf**         | Het bedrijf dat wordt gefactureerd voor het verbruik gemeten door deze meter.               |
| **Huurder**                | Het individuele huurdercontact dat is gekoppeld aan deze meter.                             |
| **Gefactureerde entiteit** | De juridische entiteit die verantwoordelijk is voor betaling (kan afwijken van de huurder). |
| **Bediend gebied**         | De lotcodes van alle gebieden bediend door deze meter.                                      |
| **Bijbehorende submeter**  | Een gekoppeld submeter-ID, als deze meter een stroomafwaartse submeter heeft.               |
| **Validator**              | De stakeholder die is toegewezen om dit meterrecord te valideren.                           |
| **Status**                 | Huidige validatiestatus (PENDING\_VALIDATION / VALIDATED / REJECTED).                       |

***

## Meterlocatieformaat

Meterlocaties moeten een gestandaardiseerde naamgevingsconventie volgen om consistentie en traceerbaarheid in het gebouw te waarborgen:

```
STAD.VERDIEPING.LOT
```

**Voorbeeld:** `RNS.2.12`

Dit geeft aan: Stadscode **RNS**, Verdieping **2**, Lot **12**.

Dit formaat koppelt de fysieke locatie van de meter aan het lot- en verdiepingssysteem van het gebouw, waardoor kruisverwijzing met de Lot Division-records eenvoudig is.

***

## Een meter toevoegen

Klik op **+ Meter toevoegen** om het formulier voor het aanmaken van een meter te openen.

### Formuliervelden

| Veld                       | Type                 | Verplicht      | Opmerkingen                                                                                                                              |
| -------------------------- | -------------------- | -------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| **Energietype**            | Selecteer            | Ja             | Water, Elektriciteit, Gas, Verwarming of Koeling.                                                                                        |
| **Meter-ID-nummer**        | Tekst                | Ja             | Het fysieke ID van de meter zoals gedrukt op het apparaat.                                                                               |
| **Meterlocatie**           | Tekst                | Ja             | Formaat: `STAD.VERDIEPING.LOT` (bijv. `RNS.2.12`).                                                                                       |
| **Is leegstaande teller**  | Schakelaar           | Nee            | Indien ingeschakeld, is de meter gekoppeld aan een leegstaande ruimte en wordt **automatisch gevalideerd** zonder validateurgoedkeuring. |
| **Huurderbedrijf**         | Tekst                | Voorwaardelijk | Verplicht als Is leegstaande teller UIT is.                                                                                              |
| **Huurder**                | Selecteer            | Voorwaardelijk | Verplicht als Is leegstaande teller UIT is. Selecteer uit de geregistreerde stakeholders van het gebouw.                                 |
| **Gefactureerde entiteit** | Tekst                | Voorwaardelijk | Verplicht als de gefactureerde entiteit afwijkt van het huurderbedrijf.                                                                  |
| **Bediend gebied**         | Meervoudige selectie | Nee            | Selecteer een of meer lotcodes bediend door deze meter.                                                                                  |
| **Bijbehorende submeter**  | Tekst                | Nee            | Voer het ID in van een stroomafwaartse submeter die is gekoppeld aan deze meter.                                                         |
| **Validator**              | Selecteer            | Nee            | Selecteer een enkele validator voor dit meterrecord.                                                                                     |

### Schakelaar Is leegstaande teller

Vergelijkbaar met de schakelaar Is leegstaand in Lot Division, wanneer **Is leegstaande teller** is ingeschakeld, is het meterrecord gekoppeld aan een onbezette ruimte. Het record wordt **automatisch gevalideerd** zonder dat validateurreview vereist is, waardoor de gegevensinvoer voor leegstaande units wordt vereenvoudigd.

***

## Validatieworkflow

### Statuslevenscyclus

Meterrecords doorlopen de volgende statussen:

```
(Aangemaakt) → PENDING_VALIDATION → VALIDATED
                                  → REJECTED
```

| Status                  | Beschrijving                                                            |
| ----------------------- | ----------------------------------------------------------------------- |
| **PENDING\_VALIDATION** | Het meterrecord is ingediend en wacht op beoordeling door de validator. |
| **VALIDATED**           | De toegewezen validator heeft het record goedgekeurd.                   |
| **REJECTED**            | De validator heeft het record afgewezen met een reden.                  |

### Afwijzing

Wanneer een validator een meterrecord afwijst, is een **afwijzingsreden** verplicht. Deze reden wordt opgeslagen in het auditspoor en is zichtbaar voor de indiener. Na het corrigeren van de informatie kan de indiener opnieuw indienen, wat een nieuwe versie aanmaakt en de status reset naar PENDING\_VALIDATION.

***

## Versiegeschiedenis

Elke update van een meterrecord maakt een **nieuwe versie** aan. De vorige versie wordt gearchiveerd (vervangen) en bewaard. Elke versie registreert:

* De veldwaarden op dat moment.
* Wie de wijziging heeft aangebracht en wanneer.
* De validatiestatus op dat moment.

Dit zorgt voor een volledige, fraudebestendige geschiedenis van alle metergegevenswijzigingen.

***

## Takenintegratie

De Fluid Synoptic-functie genereert automatisch de volgende taaktypen:

| Taaktype                            | Trigger                                                                                  |
| ----------------------------------- | ---------------------------------------------------------------------------------------- |
| **VALIDATE\_ENERGY\_METER**         | Een meterrecord wordt ingediend voor validatie. Aangemaakt voor de toegewezen validator. |
| **UPDATE\_REJECTED\_ENERGY\_METER** | Een meterrecord wordt afgewezen. Aangemaakt voor de indiener van het meterrecord.        |

Deze taken verschijnen in het [Takenpaneel](/magma-documentation/nl/functies/tasks.md) en in de [Activiteitsfeed](/magma-documentation/nl/functies/activity-feed.md).

***

## Tips en aanbevolen werkwijzen

* Onderhoud het **Identiteitsprofiel** consequent na elk bezoek ter plaatse — dit creëert een permanent record van gebouwbeheeractiviteiten dat waardevol is voor audits, due diligence en rapportage aan toezichthouders.
* Gebruik de **schakelaar Is leegstaande teller** direct wanneer een unit leeg komt te staan om te voorkomen dat een verouderde huurdertoewijzing op een actieve meter staat — dit houdt uw energiedata schoon en vermindert validatieoverhead.
* Wijs **submeters** nauwkeurig toe via het veld Bijbehorende submeter — dit maakt nauwkeurige factuurreconciliatie mogelijk tussen hoofdmeters en individuele unit-submeters.
* Houd **lotcodes van bediende gebieden** actueel wanneer huurders veranderen of lottoewijzingen worden gewijzigd. Verouderde data over bediende gebieden kan discrepanties veroorzaken in rapporten over energiekostentoewijzing.
* Kruis-refereer meterlocaties met de Lot Division-records om te verzekeren dat de `STAD.VERDIEPING.LOT`-codes die worden gebruikt in Fluid Synoptic overeenkomen met die welke zijn geregistreerd in Lot Division.


---

# Agent Instructions: 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.mymagma.com/magma-documentation/nl/functies/fluid-synoptic.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.
