URL-parameters voor nieuwe bedrijven 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, koelinstallatie of overige installatie. Dit maakt integraties eenvoudiger en vermindert handmatig invoerwerk.


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


Info/zelf-documenterend scherm
Ga naar:

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

Daar zie je alle ondersteunde parameters, types en voorbeelden.


Snelstart (met adres)

Voorbeeld van een simpel CRM bedrijf (inclusief adres) (URL decoded)

https://JOUW_OMGEVING.climatools.nl/companies/add?name=Climatools BV&email=info@climatools.nl&website=https://www.climatools.nl&phone_country=NL&phone=+31201234567&notes=Aangemaakt via integratie&addresses=[{"type_id":1,"name":"Hoofdkantoor","street":"Damrak","street_number":"1","zipcode":"1012LG","city":"Amsterdam","country":"NL"}]


Voorbeeld van een simpel CRM bedrijf (inclusief adres) (URL encoded) 

https://JOUW_OMGEVING.climatools.nl/companies/add?name=Climatools%20BV&email=info%40climatools.nl&website=https%3A%2F%2Fwww.climatools.nl&phone_country=NL&phone=%2B31201234567&notes=Aangemaakt%20via%20integratie&addresses=%5B%7B%22type_id%22%3A1%2C%22name%22%3A%22Hoofdkantoor%22%2C%22street%22%3A%22Damrak%22%2C%22street_number%22%3A%221%22%2C%22zipcode%22%3A%221012LG%22%2C%22city%22%3A%22Amsterdam%22%2C%22country%22%3A%22NL%22%7D%5D
  • Minimaal één adres (addresses) is verplicht.
  • JSON-velden moeten URL-gecodeerd worden (gebruik encodeURIComponent).
  • country en phone_country gebruiken ISO alpha-2 codes (NL, BE, DE, etc.).
  • Onbekende of fout getype parameters worden genegeerd.

 

Kernparameters

Voor alle beschikbare parameters ga dan via de volgende URL: 

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

KeyBetekenisTypeOpmerkingen
nameBedrijfsnaamstring—
client_numberKlantnummerstring (number)Optioneel
emailE-mailadresstring—
websiteWebsitestring (URL)—
phoneTelefoonnummerstring—
phone_countryLandcode telefoonstring (alpha-2)Bijv. NL, BE, DE
notesNotitiesstring—
addressesAdressenJSON string (URL-gecodeerd)Minimaal 1 vereist
customer_typesKlanttypesJSON stringZie schema in info/zelf-documenterend scherm
relationsRelatiesJSON stringZie schema info/zelf-documenterend scherm


Minimaal adresobject (niet-gecodeerd)

[
  {
    "type_id": 1,
    "street": "Damrak",
    "street_number": "1",
    "zipcode": "1012LG",
    "city": "Amsterdam",
    "country": "NL"
  }
]

Tips & fouten voorkomen

  • Altijd JSON encoden: gebruik encodeURIComponent(JSON.stringify(obj)).

  • Gebruik ISO-landcodes voor alle landvelden.

  • Eén adres minimaal verplicht, anders opent het formulier met een foutmelding.

  • Onbekende keys worden genegeerd, zodat de URL altijd veilig blijft.

  • Meerdere adressen of relaties kunnen in één JSON-array worden meegegeven.