weScan import

Met de importfunctie kun je gebouwelementen (gevels, vloeren en daken) vanuit een weScan JSON-bestand importeren in het opnameformulier. Dit bespaart handmatig invoerwerk voor de afmetingen en oriëntatie van de bouwschil.

Hoe te gebruiken

1. Open het opnameformulier van de klant.
2. Klik op de importknop bij het gebouwobject.
3. Selecteer het weScan JSON-exportbestand.
4. Kies of de elementen geïmporteerd worden in een bestaande rekenzone of in een nieuwe rekenzone.
5. Bevestig de import.

Meerdere rekenzones

Een weScan bestand kan meerdere rekenzones bevatten (zie het JSON schema). Bevat het bestand rekenzone-entries, dan wordt per zone een nieuwe rekenzone aangemaakt (Rekenzone A, Rekenzone B, …). Bestanden met meerdere rekenzones worden altijd als nieuwe rekenzones toegevoegd — ze worden niet samengevoegd met een bestaande rekenzone. Een bestand zonder rekenzone-entries (alleen gebouwelementen) wordt zoals voorheen in één rekenzone geïmporteerd.

Niet-rechthoekige elementen

De geïmporteerde surface_area is de gemeten oppervlakte en is leidend. Komt de oppervlakte overeen met width × height (het element is rechthoekig), dan wordt de vorm Rechthoek gebruikt en blijven hoogte en breedte zichtbaar. Wijkt de gemeten oppervlakte daarvan af, dan wordt de vorm Overig (m²) gebruikt, zodat de gemeten oppervlakte behouden blijft en niet wordt overschreven door een rechthoekberekening.

Dit geldt voor gevels, daken, deuren en panelen. Bij deuren is het belangrijk omdat weScan het glas al van het deuroppervlak afhaalt (zie Ramen in deuren). Vloeren staan altijd al op Overig.

Na de import: verplicht controleren

Het weScan exportbestand bevat niet alle gegevens die nodig zijn voor het isolatieplan. Elk geïmporteerd element (gevel, vloer, dak, dakkapel, raam, deur en paneel) krijgt een validatiefout-indicatie om aan te geven dat er nog velden ingevuld of gecontroleerd moeten worden. Open elk element met een validatiefout en controleer de onderstaande velden.

Hellingshoek

Bevat het weScan bestand een hellingshoek, dan wordt deze overgenomen. Hellingshoeken met decimalen (bijvoorbeeld 52.0) worden automatisch afgerond op hele graden — je hoeft dit niet meer handmatig te corrigeren. Een dak met hellingshoek 0° wordt automatisch als plat dak ingelezen.

Ontbreekt het veld, dan wordt de hellingshoek bepaald op basis van het elementtype:

• Gevel → 90°
• Hellend dak → 45°
• Vloer of plat dak → 0°

Ramen, deuren en panelen erven de hellingshoek van het bovenliggende element (gevel of dak). Controleer de hellingshoek bij elk element en pas deze aan indien nodig.

Grenzend aan

Het weScan bestand kan een waarde voor de aangrenzende ruimte bevatten via het veld adjacency. Naast de exacte waarden worden ook de Nederlandse labels en de afkortingen AOR, ASGR, AVR, AOS en AOK herkend (elke afkorting staat voor de ruimte waar hij letterlijk voor staat — AOR en ASGR zijn dus verschillende waarden). Als het veld ontbreekt of een onbekende waarde bevat, krijgt het element automatisch de waarde Buitenlucht. Controleer dit voor elk element en pas het aan indien nodig, bijvoorbeeld:

• Een vloer op de kruipruimte → kies Kruipruimte
• Een vloer op de grond → kies Grond
• Een gevel grenzend aan een aangebouwde onverwarmde garage → kies Aangrenzende onverwarmde ruimte

Isolatiegegevens

Als het weScan bestand isolatiegegevens bevat, worden deze overgenomen (zie het JSON schema). weScan levert deze aan in het insulation-object per element (de oudere naam isolation wordt ook nog gelezen):

• isolatie_aanwezig (Ja / Nee / Onbekend) bepaalt of er isolatie aanwezig is.
• isolatiedikte_mm wordt overgenomen zodra er een dikte groter dan 0 in staat. Een gemeten dikte gaat voor: staat er bijvoorbeeld 200 mm terwijl isolatiedikte_onbekend waar is of isolatie_aanwezig op "Onbekend" staat, dan wordt die 200 mm alsnog overgenomen. Alleen als er geen bruikbare dikte in staat, komt het element binnen als "ja, dikte onbekend" of "onbekend".
• spouw_aanwezig zet de spouw bij gevels en panelen. Een gevel zonder spouw komt nu binnen met de spouw uitgeschakeld — voorheen stond deze standaard aan met een dikte op basis van het bouwjaar, wat de berekening beïnvloedde.

Dit geldt ook voor panelen: isolatie én spouw van een paneel worden nu overgenomen. Voorheen werd het isolatie-object van een paneel genegeerd, waardoor de standaard van het formulier gold.

De oudere velden rc_value, insulation_thickness, has_cavity en cavity_depth worden nog steeds ondersteund.

Bevat het bestand geen isolatiegegevens voor een element, vul dan zelf in:

• Is er isolatie aanwezig? (ja / nee / onbekend)
• Indien ja: isolatiedikte en isolatietype

Ramen in deuren

Zit er glas in een deur (bijvoorbeeld een voordeur met raampje), dan levert weScan het dichte deuroppervlak aan — het glas is er al van afgehaald — en staat het raam als los element bij dezelfde gevel.

Voorheen werd zo'n deur als rechthoek geïmporteerd, waardoor het opnameformulier het oppervlak opnieuw berekende uit hoogte × breedte en de deur veel te groot werd (een deur van 0,9 × 2,35 m met een raampje kwam op 2,12 m² uit in plaats van de gemeten 1,27 m²). Deuren en panelen waarvan het gemeten oppervlak afwijkt van hoogte × breedte krijgen nu de vorm Overig (m²), zodat het gemeten oppervlak blijft staan.

Controleer bij deuren met glas of het oppervlak klopt met de bron.

Oriëntatie voorgevel

De oriëntatie van de voorgevel staat op de rekenzone, niet op een gevel. Levert het weScan bestand deze mee — front_facade_orientation in de root, of cardinal_point per rekenzone — dan wordt hij overgenomen; zo niet, vul hem zelf in. Deze waarde wordt nooit uit de geometrie afgeleid: de oriëntatie van elke gevel in de berekening wordt namelijk ten opzichte van de voorgevel bepaald, dus een gok zou alle gevels in de zone verschuiven.

Overige elementspecifieke velden

Afhankelijk van het type element kunnen er aanvullende velden zijn die ingevuld moeten worden, zoals het daktype bij een dak of de spouwmuurinstelling bij een gevel. Controleer alle velden bij elk element totdat de validatiefout-indicatie verdwenen is.

Wat wordt wel overgenomen

De volgende gegevens worden direct overgenomen vanuit het weScan bestand:

• Oppervlakte van gevels, vloeren en daken
• Oriëntatie (windrichting) van gevels en daken
• Omtrek van vloeren
• Hellingshoek (indien opgegeven via het veld inclination), afgerond op hele graden
• Plat dak per dakelement (bij een hellingshoek van 0°)
• Type dak van het object (plat dak / hellend dak / deels plat dak), afgeleid uit de geïmporteerde daken
• Grenzend aan (indien opgegeven via het veld adjacency; standaard Buitenlucht)
• Isolatie en spouw van gevels, vloeren, daken en panelen (indien aanwezig in het bestand)
• Dakkapellen met hun eigen gevels, dak en ramen
• Oriëntatie voorgevel (indien aanwezig in het bestand)
• Gemeten oppervlak van deuren en panelen, ook als het glas er al van afgehaald is
• Kozijnsoort van ramen en panelen (indien opgegeven via het veld windowFrameKind)
• Glastype van ramen (indien opgegeven via het veld glass_insulation)
• Bouwjaar en gebouwhoogte (indien aanwezig in het bestand)
• Bouwlagen en vloeroppervlakten per verdieping

Optionele velden per elementtype

De volgende velden kunnen per element worden meegegeven in additionalFields. Zie ook het volledige JSON schema voor alle velden.

Hellingshoek (inclination)

Van toepassing op: gevel, vloer, dak. De waarde is in graden (0 = plat, 90 = loodrecht). Decimalen zijn toegestaan en worden afgerond op hele graden. Ramen, deuren en panelen erven de hellingshoek van het bovenliggende element.

Als het veld ontbreekt, gelden de volgende standaardwaarden:

Type	Standaard
Gevel	90°
Hellend dak	45°
Vloer / plat dak	0°

Grenzend aan (adjacency)

Van toepassing op: gevel, vloer, dak. Als het veld ontbreekt of onbekend is, wordt automatisch Buitenlucht ingevuld.

Waarde	Omschrijving	Afkorting
buitenlucht	Buitenlucht (standaard)
water	Water
grond	Grond
kruipruimte	Kruipruimte
aangrenzendeOnverwarmdeRuimte	Aangrenzende onverwarmde ruimte	AOR
aangrenzendeOnverwarmdeSerre	Aangrenzende onverwarmde serre	AOS
aangrenzendeSterkGeventileerdeRuimte	Aangrenzende sterk geventileerde ruimte	ASGR
aangrenzendeOnverwarmdeKelder	Aangrenzende onverwarmde kelder	AOK
aangrenzendeVerwarmdeRuimte	Aangrenzende verwarmde ruimte	AVR

De Nederlandse labels uit de tweede kolom worden ook herkend. Let op: AOR en ASGR zijn verschillende ruimtes met een andere temperatuurfactor in de berekening. Gebruik AOR voor een aangrenzende onverwarmde ruimte en ASGR alleen voor een sterk geventileerde ruimte. Gebruik bij twijfel de exacte waarde.

Isolatie (insulation)

Van toepassing op: gevel, vloer, dak en paneel. Niet op ramen en deuren (daar bepalen glastype en kozijnsoort de waarde) en niet op een dakkapel zelf (die zet je op de gevels en het dak van de dakkapel).

Veld	Omschrijving
isolatie_aanwezig	Ja / Nee / Onbekend
isolatiedikte_mm	Isolatiedikte in mm — gaat voor op de velden hieronder zodra hij groter dan 0 is
isolatiedikte_onbekend	Is de dikte onbekend? Werkt alleen als er geen bruikbare isolatiedikte_mm is
spouw_aanwezig	Is er een spouw aanwezig? (gevels en panelen)
bouwjaar	Wordt niet overgenomen; gebruik building_year op het hoogste niveau

Dakkapellen

Een dakkapel is een dakkapel-element in het dak waarop hij staat, met daarin zijn eigen gevels en dak. De gevels en het dak van de dakkapel gedragen zich als elk ander element: aangrenzing, isolatie, spouw, plat dak en ramen werken er allemaal. Een dakkapeldak met hellingshoek 0° wordt als plat dak ingelezen en telt mee voor het type dak van het object.

Op de dakkapel zelf hoort alleen de maatvoering — geen aangrenzing en geen isolatie, die zitten op de gevels en het dak eronder. Ontbreekt de hellingshoek, dan neemt de dakkapel die van het bovenliggende dak over (en anders 45°).

Oriëntatie voorgevel (front_facade_orientation)

Van toepassing op: het hoogste niveau van het bestand via front_facade_orientation, of per rekenzone via cardinal_point (die gaat dan voor). Zowel de Nederlandse als de Engelse afkortingen en volledige namen worden geaccepteerd, in elke schrijfwijze: NO, NE, Noord-Oost, noordoost en North East betekenen allemaal hetzelfde. Als het veld ontbreekt of onleesbaar is, blijft de oriëntatie leeg en moet deze handmatig worden ingevuld na de import.

Kozijnsoort (windowFrameKind)

Van toepassing op: raam, paneel.

Waarde	Omschrijving
woodOrPlastic	Hout of kunststof
metalThermallyBroken	Metaal thermisch onderbroken
metalNonThermallyBroken	Metaal niet thermisch onderbroken

Als het veld ontbreekt, moet de kozijnsoort handmatig worden ingevuld na de import.

Glassoort (glass_insulation)

Van toepassing op: raam.

Waarde	Omschrijving
enkelGlas	Enkel glas
dubbelGlas	Dubbel glas
hrGlasdubbelGlasMetCoating	HR glas
hrPlusGlas	HR+ glas
hrPlusPlusGlas	HR++ glas
tripleHrGlas	Driedubbel glas

Voorbeeldbestand

{
  "building_year": "1978",
  "building_height": "6.2",
  "building_layers": ["48.0", "44.0"],
  "front_facade_orientation": "ZW",
  "childrenGroups": [
    {
      "type": "walls",
      "name": "Voorgevel",
      "additionalFields": {
        "surface_area": "28.0",
        "height": "5.4",
        "width": "5.2",
        "cardinal_point": "s",
        "adjacency": "buitenlucht",
        "insulation": {
          "spouw_aanwezig": false,
          "isolatie_aanwezig": "Ja",
          "isolatiedikte_onbekend": false,
          "isolatiedikte_mm": 80
        }
      },
      "childrenGroups": [
        {
          "type": "window",
          "name": "Raam woonkamer",
          "additionalFields": {
            "surface_area": "3.6",
            "height": "1.5",
            "width": "2.4",
            "glass_insulation": "hrPlusPlusGlas",
            "windowFrameKind": "woodOrPlastic"
          }
        },
        {
          "type": "door",
          "name": "Voordeur",
          "additionalFields": {
            "surface_area": "1.98",
            "height": "2.2",
            "width": "0.9"
          },
          "childrenGroups": [
            {
              "type": "window",
              "name": "Raam voordeur",
              "additionalFields": {
                "surface_area": "0.33",
                "height": "0.44",
                "width": "0.76",
                "glass_insulation": "enkelGlas",
                "windowFrameKind": "woodOrPlastic"
              }
            }
          ]
        }
      ]
    },
    {
      "type": "roof",
      "name": "Hellend dak voor",
      "additionalFields": {
        "surface_area": "30.0",
        "cardinal_point": "s",
        "inclination": "52.0",
        "insulation": {
          "isolatie_aanwezig": "Ja",
          "isolatiedikte_onbekend": false,
          "isolatiedikte_mm": 200
        }
      },
      "childrenGroups": [
        {
          "type": "window",
          "name": "Dakraam",
          "additionalFields": {
            "surface_area": "0.9",
            "glass_insulation": "dubbelGlas",
            "windowFrameKind": "metalThermallyBroken"
          }
        }
      ]
    },
    {
      "type": "roof",
      "name": "Plat dak achter",
      "additionalFields": {
        "surface_area": "8.0",
        "inclination": "0.0"
      }
    },
    {
      "type": "floor",
      "name": "Begane grondvloer",
      "additionalFields": {
        "surface_area": "48.0",
        "perimeter": "28.0",
        "adjacency": "kruipruimte"
      }
    }
  ]
}

Een paar dingen om op te merken in dit voorbeeld:

• Het dakraam erft automatisch de hellingshoek van het bovenliggende dak (52°). Je hoeft inclination dus niet apart op te geven voor ramen, deuren en panelen — tenzij je een afwijkende waarde wilt meegeven.
• De hellingshoek 52.0 wordt afgerond naar 52°.
• Het platte dak (inclination 0.0) wordt automatisch als plat dak ingelezen. Omdat er ook een hellend dak in het bestand zit, wordt het type dak van het object deels plat dak.
• Het raam in de voordeur staat als deelvlak in de deur, zodat het dichte deel van de deur klopt.
• De voorgevel heeft geen spouw (spouw_aanwezig: false), dus de spouw staat na de import uit.