URL-parameters voor nieuwe overige 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 overige installatie-formulier vooraf invullen. Dit versnelt importflows vanuit andere systemen of spreadsheets.


Info/zelf-documenterend scherm
Ga naar:

overige installaties: https://JOUW_OMGEVING.climatools.nl/installations/add/other?form=info

Daar zie je alle ondersteunde parameters, types en voorbeelden.


Snelstart

Voorbeeld van een simpel overige installatie (URL decoded)

https://JOUW_OMGEVING.climatools.nl/installations/add/other?tags=TEST,OVERIG&owner_type=companies&owner=Climatools BV&owner_address=1012LG, Amsterdam, Damrak, 1&number=3001&active=true&machine_number=OVR-2025-001&serial=SN-OTHER-001&location=Machinekamer 1&brand=2865455241325707520&model=2865448242693275904&health_status=3&completed_at=2024-10-01&last_maintenance_at=2025-07-01&maintenance_cycle=3&build_year=2022&notes=Aangemaakt via integratie test&connection_voltage=400


Voorbeeld van een simpel overige installatie (URL encoded)

https://JOUW_OMGEVING.climatools.nl/installations/add/other?tags=TEST%2COVERIG&owner_type=companies&owner=Climatools%20BV&owner_address=1012LG%2C%20Amsterdam%2C%20Damrak%2C%201&number=3001&active=true&machine_number=OVR-2025-001&serial=SN-OTHER-001&location=Machinekamer%201&brand=2865455241325707520&model=2865448242693275904&health_status=3&completed_at=2024-10-01&last_maintenance_at=2025-07-01&maintenance_cycle=3&build_year=2022&notes=Aangemaakt%20via%20integratie%20test&connection_voltage=400


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

tags=TEST,OVERIG
owner_type=companies
owner=Climatools BV
owner_address=1012LG, Amsterdam, Damrak, 1
number=3001
active=true
machine_number=OVR-2025-001
serial=SN-OTHER-001
location=Machinekamer 1
brand=2865455241325707520              # Remeha
model=2865448242693275904              # Roelant Model X
health_status=2                        # Middel risico
completed_at=2024-10-01
last_maintenance_at=2025-07-01
maintenance_cycle=3                    # 1x per 12 maanden
build_year=2022
notes=Aangemaakt via integratie test
connection_voltage=400
  • Tags: kommageliste labels (bijv. TEST,OVERIG)
  • Booleans als string: true / false
  • IDs invullen voor velden zoals brand, model, health_status
  • 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/other?form=info


KeyBetekenisTypeOpmerkingen
tagsInstallatie-tagsstring (label, komma-gescheiden)labels, geen IDs
owner_typeEigenaarstypestringcompanies of relations
ownerEigenaar (naam)stringWeergavenaam van de eigenaar
owner_addressAdresstringFormaat: postcode, stad, straat, huisnummer
numberInstallatienummerstring (number)—
activeStatusstring (true/false)—
machine_numberMachinenummerstring (number)—
serialSerienummerstring—
locationLocatiestring—
brandMerkstring (ID)bijv. Remeha = 2865455241325707520
modelModelstring (ID)bijv. Roelant 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—
connection_voltageAansluitspanningstring (number)—


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.