Hoe werken de URL Parameters om nieuwe koelinstallaties aan te maken? : Climatools Support Portaal

Met URL-parameters vul je het formulier Nieuwe koelinstallatie in Climatools vooraf in. Dat versnelt importflows vanuit andere systemen of spreadsheets. In dit artikel lees je hoe dat werkt.

INHOUDSOPGAVE

Wat zijn URL-parameters?
Waarvoor gebruikt Climatools URL-parameters?
Waar vind ik alle ondersteunde parameters?
Hoe vul ik een nieuwe koelinstallatie vooraf in?
Welke kernparameters zijn er?
Hoe ziet het refrigerant_circuit eruit?
Hoe voorkom ik fouten?

Wat zijn URL-parameters?

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.

Waarvoor gebruikt Climatools URL-parameters?

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, gasinstallatie, koelinstallatie of overige installatie. Dit maakt integraties eenvoudiger en vermindert handmatig invoerwerk.

In de voorbeelden hieronder staat JOUW_OMGEVING. Vervang dit door de naam van jouw eigen Climatools-omgeving.

Waar vind ik alle ondersteunde parameters?

Op het zelf-documenterende infoscherm voor koelinstallaties zie je alle ondersteunde parameters, types en voorbeelden. Ga hiervoor naar:

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

Hoe vul ik een nieuwe koelinstallatie vooraf in?

Hieronder zie je een eenvoudige koelinstallatie. Eerst de leesbare versie (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"}}]

En dezelfde URL in de versie die je daadwerkelijk gebruikt (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

Voor de leesbaarheid staan dezelfde parameters hieronder onder elkaar. Wat na het #-teken staat, is toelichting en hoort niet in de URL:

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"}}]

Let hierbij op het volgende:

tags is een komma-gescheiden lijst met labels (bijvoorbeeld VRF,SCIOS).
Booleans geef je door als string: true of false.
Vul IDs in voor velden zoals brand, model, category, type, health_status, circuit_type en refrigerant.
JSON-velden zoals refrigerant_circuit moet je altijd URL-encoden.
Encode speciale tekens: @ wordt %40, + wordt %2B en een spatie wordt %20.

Welke kernparameters zijn er?

Dit zijn de belangrijkste parameters voor een nieuwe koelinstallatie. Voor alle beschikbare parameters gebruik je het infoscherm hierboven.

Key	Betekenis	Type	Opmerkingen
`tags`	Installatie tags	string (labels, komma-gescheiden)	labels, geen IDs
`owner_type`	Eigenaar type	string	companies of relations
`owner`	Naam	string	Weergavenaam van eigenaar
`owner_address`	Adresregel	string	Formaat: postcode, stad, straat, huisnummer
`number`	Installatienummer	string (number)	—
`active`	Status	string (true/false)	—
`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, enz.
`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

Hoe ziet het refrigerant_circuit eruit?

Het veld refrigerant_circuit is een JSON-array. Dit is het schema, nog niet URL-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" }
  }
]

En een voorbeeld:

[
  {
    "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" }
  }
]

Hoe voorkom ik fouten?

Encode JSON altijd.
IDs of labels? Gebruik IDs waar vereist (brand, model, category, type, health_status, enz.).
Geef booleans door als string: true of false.
Geef tags door als labels, komma-gescheiden (geen IDs).
Onbekende keys worden genegeerd. Geldige velden worden vooraf ingevuld.

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