URL-parameters voor nieuwe koel installaties in de Climatools CRM

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 koel installatie-formulier vooraf invullen. Dit versnelt importflows vanuit andere systemen of spreadsheets.

Info/zelf-documenterend scherm
Ga naar:

koel installaties: https://JOUW_OMGEVING.climatools.nl/installations/add/cooling?form=info

Daar zie je alle ondersteunde parameters, types en voorbeelden.

Snelstart

Voorbeeld van een simpel koel installatie (URL decoded)

https://JOUW_OMGEVING.climatools.nl/installations/add/cooling?tags=VRF,SCIOS&owner_type=companies&owner=Climatools B.V.&owner_address=1012LG, Amsterdam, Damrak, 1&number=1001&active=true&machine_number=5002001&serial=DAI-XYZ-2020-0001&location=Dak A&brand=2865445388033196288&model=2865447996168864000&health_status=2&completed_at=2025-03-01&last_maintenance_at=2025-06-01&maintenance_cycle=3&build_year=2020&notes=Aangemaakt via integratie demo&residential_building=false&category=1&type=9&ped_type=2&ce=true&identification_number=CI-12345&minimum_workload_high_pressure=10&minimum_workload_low_pressure=2&maximum_allowable_temperature=65&minimum_allowable_temperature=-20&workload_hp=40&workload_lp=15&last_leak_test_at=2025-06-01&leak_test_cycle=3&circuit_type=1&refrigerant=2&cooling_power=25.0&heating_power=28.0&eer_cooling=3.8&cop_heating=4.0&cooling_absorbed_power=6.6&heating_absorbed_power=7.0&connection_voltage=400&refrigerant_circuit=[{"factory_charge":5.2,"additional_charge":1.0,"has_leak_detection":true,"leak_detection_type":"vast","compressors":2,"custom_rated_content":6.2,"rated_content_is_calculated":false,"compressor_type":{"id":1,"label":"Scroll"}}]

Voorbeeld van een simpel koel installatie (URL encoded)

https://JOUW_OMGEVING.climatools.nl/installations/add/cooling?tags=VRF%2CSCIOS&owner_type=companies&owner=Climatools%20B.V.&owner_address=1012LG%2C%20Amsterdam%2C%20Damrak%2C%201&number=1001&active=true&machine_number=5002001&serial=DAI-XYZ-2020-0001&location=Dak%20A&brand=2865445388033196288&model=2865447996168864000&health_status=2&completed_at=2025-03-01&last_maintenance_at=2025-06-01&maintenance_cycle=3&build_year=2020&notes=Aangemaakt%20via%20integratie%20demo&residential_building=false&category=1&type=9&ped_type=2&ce=true&identification_number=CI-12345&minimum_workload_high_pressure=10&minimum_workload_low_pressure=2&maximum_allowable_temperature=65&minimum_allowable_temperature=-20&workload_hp=40&workload_lp=15&last_leak_test_at=2025-06-01&leak_test_cycle=3&circuit_type=1&refrigerant=2&cooling_power=25.0&heating_power=28.0&eer_cooling=3.8&cop_heating=4.0&cooling_absorbed_power=6.6&heating_absorbed_power=7.0&connection_voltage=400&refrigerant_circuit=%5B%7B%22factory_charge%22%3A5.2%2C%22additional_charge%22%3A1.0%2C%22has_leak_detection%22%3Atrue%2C%22leak_detection_type%22%3A%22vast%22%2C%22compressors%22%3A2%2C%22custom_rated_content%22%3A6.2%2C%22rated_content_is_calculated%22%3Afalse%2C%22compressor_type%22%3A%7B%22id%22%3A1%2C%22label%22%3A%22Scroll%22%7D%7D%5D

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

tags=VRF,SCIOS
owner_type=companies
owner=Climatools B.V.
owner_address=1012LG, Amsterdam, Damrak, 1
number=1001
active=true
machine_number=5002001
serial=DAI-XYZ-2020-0001
location=Dak A
brand=2865445388033196288        # Daikin (voorbeeld)
model=2865447996168864000        # MUZ-DM25i (voorbeeld)
health_status=2                  # Middel risico
completed_at=2025-03-01
last_maintenance_at=2025-06-01
maintenance_cycle=3              # 1x per 12 maanden
build_year=2020
notes=Aangemaakt via integratie demo
residential_building=false
category=1                       # Comfort airconditioning
type=9                           # VRF/VRV Systeem
ped_type=2                       # PED I
ce=true
identification_number=CI-12345
minimum_workload_high_pressure=10
minimum_workload_low_pressure=2
maximum_allowable_temperature=65
minimum_allowable_temperature=-20
workload_hp=40
workload_lp=15
last_leak_test_at=2025-06-01
leak_test_cycle=3
circuit_type=1                   # Hermetisch gesloten
refrigerant=2                    # R-32
cooling_power=25.0
heating_power=28.0
eer_cooling=3.8
cop_heating=4.0
cooling_absorbed_power=6.6
heating_absorbed_power=7.0
connection_voltage=400
refrigerant_circuit=[{"factory_charge":5.2,"additional_charge":1.0,"has_leak_detection":true,"leak_detection_type":"vast","compressors":2,"custom_rated_content":6.2,"rated_content_is_calculated":false,"compressor_type":{"id":1,"label":"Scroll"}}]

Tags: kommageliste labels (bijv. VRF,SCIOS)
Booleans als string: true / false
IDs invullen voor velden zoals brand, model, category, type, health_status, circuit_type, refrigerant, etc.
JSON-velden zoals refrigerant_circuit 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/cooling?form=info

Key	Betekenis	Type	Opmerkingen
`tags`	Installatie tags	string (labels, komma-gescheiden)	labels, geen IDs
`owner_type`	Eigenaar type	string (ID)	`companies` of `relations`
`owner`	Naam	string	Weergavenaam van eigenaar
`owner_address`	Adresregel	string	Formaat: `zipcode, city, street, house nmr`
`number`	Installatienummer	string (number)	—
`active`	Status	string (`true`/`false`)	Als string
`machine_number`	Machinenummer	string (number)	—
`serial`	Serienummer	string	—
`location`	Locatie	string	—
`brand`	Merk	string (ID)	bijv. Daikin = `2865445388033196288`
`model`	Model	string (ID)	bijv. MUZ-DM25i = `2865447996168864000`
`health_status`	Gezondheid	string (ID)	`1` Hoog, `2` Middel, `3` Laag
`completed_at`	Opleveringsdatum	string (YYYY-MM-DD)	—
`last_maintenance_at`	Laatste onderhoud	string (YYYY-MM-DD)	—
`maintenance_cycle`	Onderhoudscyclus	string (ID)	`1`=3m, `2`=6m, `3`=12m, …
`build_year`	Bouwjaar	string (number)	—
`notes`	Notities	string	—
`residential_building`	Residentieel	string (`true`/`false`)	—
`category`	Type installatie	string (ID)	bijv. `1` Comfort AC
`type`	Soort installatie	string (ID)	bijv. `9` VRF/VRV
`ped_type`	PED categorie	string (ID)	`1` art 4.3 … `5` IV
`ce`	CE	string (`true`/`false`)	—
`identification_number`	CI-ID	string	—
`minimum_`/`maximum_`/`workload_*`	Druk/temperatuur	string (number)	HD/LD waardes
`last_leak_test_at`	Laatste lektest	string (YYYY-MM-DD)	—
`leak_test_cycle`	Lektestcyclus	string (ID)	idem onderhoudscyclus opties
`circuit_type`	Circuit type	string (ID)	`1` Hermetisch, `2` Niet-herm., `3` Onbekend
`refrigerant`	Koudemiddel	string (ID)	bijv. `2` = R-32
`refrigerant_circuit`	Circuitdetails	JSON string	Zie schema
`cooling_power` / `heating_power`	Vermogen	string (number)	kW
`eer_cooling` / `cop_heating`	Rendement	string (number)	—
`cooling_absorbed_power` / `heating_absorbed_power`	Opgenomen vermogen	string (number)	kW
`connection_voltage`	Aansluitspanning	string (number)	V

refrigerant_circuit (JSON) — schema & voorbeeld (niet gecodeerd

[
  {
    "factory_charge": "number",
    "additional_charge": "number",
    "has_leak_detection": "boolean",
    "leak_detection_type": "string",
    "compressors": "number",
    "custom_rated_content": "number",
    "rated_content_is_calculated": "boolean",
    "compressor_type": { "id": "number", "label": "string" }
  }
]

[
  {
    "factory_charge": 5.2,
    "additional_charge": 1.0,
    "has_leak_detection": true,
    "leak_detection_type": "vast",
    "compressors": 2,
    "custom_rated_content": 6.2,
    "rated_content_is_calculated": false,
    "compressor_type": { "id": 1, "label": "Scroll" }
  }
]

Tips & fouten voorkomen

Altijd JSON encoden.
IDs vs. labels: gebruik IDs waar vereist (brand, model, category, type, health_status, …).
Booleans als string: true / false.
Tags: geef labels komma-gescheiden door (geen IDs).
Robuustheid: onbekende keys worden genegeerd; geldige worden geprefilld.

Climatools Support Portaal

Hoe werken de URL Parameters om nieuwe koel installaties aan te maken? Afdrukken

URL-parameters voor nieuwe koel installaties in de Climatools CRM

Snelstart

Kernparameters

Tips & fouten voorkomen

Hoe werken de URL Parameters om nieuwe koel installaties aan te maken? Afdrukken

URL-parameters voor nieuwe koel installaties in de Climatools CRM

ChatGPT said:

Snelstart

Kernparameters

Tips & fouten voorkomen

Gerelateerde artikelen