URL-parameters voor nieuwe gas installaties in de Climatools CRM

ChatGPT said:

URL-parameters zijn kleine stukjes informatie die aan het einde van een webadres (URL) worden toegevoegd om gegevens van de ene pagina of het ene systeem naar het andere door te geven. Ze komen na een vraagteken (?) en worden geschreven als sleutel-waardeparen, bijvoorbeeld: ?name=Jan&age=30. Elke sleutel staat voor een veld (zoals “name”), en elke waarde voor de bijbehorende gegevens (“Jan”). Meerdere parameters worden gescheiden door een ampersand (&). Ze worden vaak gebruikt om zoekresultaten te filteren, formulieren vooraf in te vullen of gegevens automatisch tussen systemen door te geven zonder handmatige invoer.


Bij Climatools gebruiken we URL-parameters om velden automatisch vooraf in te vullen bij het aanmaken van nieuwe items, zoals een CRM-relatie, CRM-bedrijf, gas installatie, koel installatie of overige installatie. Dit maakt integraties eenvoudiger en vermindert handmatig invoerwerk.


Met URL-parameters kun je het nieuwe gas installatie-formulier vooraf invullen. Dit versnelt importflows vanuit andere systemen of spreadsheets.


Info/zelf-documenterend scherm
Ga naar:

gas installaties: https://JOUW_OMGEVING.climatools.nl/installations/add/gas-boiler?form=info

Daar zie je alle ondersteunde parameters, types en voorbeelden.


Snelstart

Voorbeeld van een simpel gas installatie (URL decoded)

https://JOUW_OMGEVING.climatools.nl/installations/add/gas-boiler?tags=SCIOS,GAS&owner_type=companies&owner=Climatools B.V.&owner_address=1012LG, Amsterdam, Damrak, 1&number=2001&active=true&machine_number=GB-12345&serial=REM-2021-001&location=Technische ruimte A&brand=2865455241325707520&model=2865448242693275904&health_status=2&completed_at=2024-09-01&last_maintenance_at=2025-06-01&maintenance_cycle=3&build_year=2021&notes=Aangemaakt via integratie test&sub_type=central_heating_boiler&gas_type=1&burner_type=2&device_code=10&co_certification_code=CI-GAS-2025&operating_mode=modulating&operating_modes=3&maintenance_based_on_burn_hours=false&power=80&power_ratio=12/06&lower_charge_value=70&upper_charge_value=85&ce=true&active=true&safety_systems=[{"action_by_intervention":"Automatische afsluiting","safety_measure":"Overdrukbeveiliging","setting_tripping_point":"2.0","unit_of_measure":"bar"}]


Voorbeeld van een simpel gas installatie (URL encoded)

https://JOUW_OMGEVING.climatools.nl/installations/add/gas-boiler?tags=SCIOS,GAS&owner_type=companies&owner=Climatools%20B.V.&owner_address=1012LG%2C%20Amsterdam%2C%20Damrak%2C%201&number=2001&active=true&machine_number=GB-12345&serial=REM-2021-001&location=Technische%20ruimte%20A&brand=2865455241325707520&model=2865448242693275904&health_status=2&completed_at=2024-09-01&last_maintenance_at=2025-06-01&maintenance_cycle=3&build_year=2021&notes=Aangemaakt%20via%20integratie%20test&sub_type=central_heating_boiler&gas_type=1&burner_type=2&device_code=10&co_certification_code=CI-GAS-2025&operating_mode=modulating&operating_modes=3&maintenance_based_on_burn_hours=false&power=80&power_ratio=12%2F06&lower_charge_value=70&upper_charge_value=85&ce=true&active=true&safety_systems=%5B%7B%22action_by_intervention%22%3A%22Automatische%20afsluiting%22%2C%22safety_measure%22%3A%22Overdrukbeveiliging%22%2C%22setting_tripping_point%22%3A%222.0%22%2C%22unit_of_measure%22%3A%22bar%22%7D%5D


Parameters hierboven in multi-line vorm (voor beter leesbaarheid)

tags=SCIOS,GAS
owner_type=companies
owner=Climatools BV
owner_address=1012LG, Amsterdam, Damrak, 1
number=2001
active=true
machine_number=GB-12345
serial=REM-2021-001
location=Technische ruimte A
brand=2865455241325707520          # Remeha
model=2865448242693275904          # Roelant Model X
health_status=2                    # Middel risico
completed_at=2024-09-01
last_maintenance_at=2025-06-01
maintenance_cycle=3                # 1x per 12 maanden
build_year=2021
notes=Aangemaakt via integratie test
sub_type=central_heating_boiler
gas_type=1                         # Aardgas
burner_type=2                      # Premixbrander
device_code=10                     # C12 - ventilator in rookgasafvoer
co_certification_code=CI-GAS-2025
operating_mode=modulating          # Modulerend (Hoog/Tussen/Laag)
operating_modes=3
maintenance_based_on_burn_hours=false
power=80
power_ratio=12/06
lower_charge_value=70
upper_charge_value=85
ce=true
safety_systems=[{"action_by_intervention": "Automatische afsluiting","safety_measure": "Overdrukbeveiliging","setting_tripping_point": "2.0","unit_of_measure": "bar"}]
  • Tags: kommageliste labels (bijv. VRF,SCIOS)
  • Booleans als string: true / false
  • IDs invullen voor velden zoals brand, model,
  • JSON-velden zoals safety_systems altijd URL-encoden
  • Speciale tekens encoden (bijv. @ → %40, + → %2B, spatie → %20)

 

Kernparameters

Voor alle beschikbare parameters ga dan via de volgende URL: 

https://JOUW_OMGEVING.climatools.nl/installations/add/gas-boiler?form=info


KeyBetekenisTypeOpmerkingen
tagsInstallatie-tagsstring (label, komma-gescheiden)labels, geen IDs
owner_typeEigenaarstypestringcompanies of relations
ownerEigenaar (naam)stringWeergavenaam bedrijf/persoon
owner_addressAdresstringFormaat: postcode, stad, straat, huisnummer
numberInstallatienummerstring (number)—
activeStatusstring (true/false)—
machine_numberMachinenummerstring (number)—
serialSerienummerstring—
locationLocatiestring—
brandMerkstring (ID)bijv. Remeha = 2865455241325707520
modelModelstring (ID)bijv. Model X = 2865448242693275904
health_statusGezondheidstring (ID)1 Hoog, 2 Middel, 3 Laag
completed_atOpleveringsdatumstring (YYYY-MM-DD)—
last_maintenance_atLaatste onderhoudstring (YYYY-MM-DD)—
maintenance_cycleOnderhoudscyclusstring (ID)1=3m, 2=6m, 3=12m, enz.
build_yearBouwjaarstring (number)—
notesNotitiesstring—
sub_typeGasverbranderstringcentral_heating_boiler / separate_tank / separate_burner / other
gas_typeType gasstring (ID)1=Aardgas, 2=Propaan, 3=Overige
burner_typeType branderstring (ID)1=Atmosferisch, 2=Premixbrander, …
device_codeCodering toestelstring (ID)bijv. 10 = C12 (ventilator in rookgasafvoer)
co_certification_codeCI-installatiecodestring—
operating_modeSoort metingstring (ID)modulating, on_off, etc.
operating_modesAantal bedrijfsstandenstring (number)bijv. 3
maintenance_based_on_burn_hoursOnderhoud op brandurenstring (true/false)—
powerNominaal vermogenstring (number)kW
power_ratioVermogensverhoudingstringbijv. 12/06
lower_charge_valueBelasting onderwaarde (Qn Hi)string (number)—
upper_charge_valueBelasting bovenwaarde (Qn Hs)string (number)—
ceCE-keurstring (true/false)—
safety_systemsVeiligheidssystemenJSON stringZie schema hieronder



safety_systems  (JSON) — schema & voorbeeld (niet-gecodeerd)

[
  {
    "action_by_intervention": "string",
    "safety_measure": "string",
    "setting_tripping_point": "string",
    "unit_of_measure": "string"
  }
]
[
  {
    "action_by_intervention": "Automatische afsluiting",
    "safety_measure": "Overdrukbeveiliging",
    "setting_tripping_point": "2.0",
    "unit_of_measure": "bar"
  }
]


Tips & fouten voorkomen

  • Altijd JSON encoden.

  • IDs vs. labels: gebruik IDs waar vereist (brand, model, health_status).

  • Booleans als string: true / false.

  • Tags: geef labels komma-gescheiden door (geen IDs).

  • Robuustheid: onbekende keys worden genegeerd; geldige worden geprefilld.