Met URL-parameters vul je het formulier Nieuwe gasinstallatie 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 gasinstallatie vooraf in?
- Welke kernparameters zijn er?
- Hoe ziet het veld safety_systems 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 gasinstallaties zie je alle ondersteunde parameters, types en voorbeelden. Ga hiervoor naar:
Hoe vul ik een nieuwe gasinstallatie vooraf in?
Hieronder zie je een eenvoudige gasinstallatie. Eerst de leesbare versie (URL decoded):
En dezelfde URL in de versie die je daadwerkelijk gebruikt (URL encoded):
Voor de leesbaarheid staan dezelfde parameters hieronder onder elkaar. Wat na het #-teken staat, is toelichting en hoort niet in de URL:
Let hierbij op het volgende:
- tags is een komma-gescheiden lijst met labels (bijvoorbeeld SCIOS,GAS).
- Booleans geef je door als string: true of false.
- Vul IDs in voor velden zoals brand, model en health_status.
- JSON-velden zoals safety_systems 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 gasinstallatie. Voor alle beschikbare parameters gebruik je het infoscherm hierboven.
| Key | Betekenis | Type | Opmerkingen |
|---|---|---|---|
tags | Installatie tags | string (label, komma-gescheiden) | labels, geen IDs |
owner_type | Eigenaar type | string | companies of relations |
owner | Eigenaar (naam) | string | Weergavenaam bedrijf/persoon |
owner_address | Adres | 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. Remeha = 2865455241325707520 |
model | Model | string (ID) | bijv. Model X = 2865448242693275904 |
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 | — |
sub_type | Gasverbrander | string | central_heating_boiler / separate_tank / separate_burner / other |
gas_type | Type gas | string (ID) | 1=Aardgas, 2=Propaan, 3=Overige |
burner_type | Type brander | string (ID) | 1=Atmosferisch, 2=Premixbrander, … |
device_code | Codering toestel | string (ID) | bijv. 10 = C12 (ventilator in rookgasafvoer) |
co_certification_code | CI-installatiecode | string | — |
operating_mode | Soort meting | string (ID) | modulating, on_off, etc. |
operating_modes | Aantal bedrijfsstanden | string (number) | bijv. 3 |
maintenance_based_on_burn_hours | Onderhoud op branduren | string (true/false) | — |
power | Nominaal vermogen | string (number) | kW |
power_ratio | Vermogensverhouding | string | bijv. 12/06 |
lower_charge_value | Belasting onderwaarde (Qn Hi) | string (number) | — |
upper_charge_value | Belasting bovenwaarde (Qn Hs) | string (number) | — |
ce | CE-keur | string (true/false) | — |
safety_systems | Veiligheidssystemen | JSON string | Zie schema hieronder |
Hoe ziet het veld safety_systems eruit?
Het veld safety_systems is een JSON-array. Dit is het schema, nog niet URL-gecodeerd:
En een voorbeeld:
Hoe voorkom ik fouten?
- Encode JSON altijd.
- IDs of labels? Gebruik IDs waar vereist (brand, model en health_status).
- 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.