Koppel je eigen systemen aan Climatools

Werk je naast Climatools met een eigen CRM of een ander systeem voor installatiebeheer? Dan staan dezelfde gegevens al snel op meerdere plekken. Verandert er iets bij een klant of een installatie, dan moet iemand dat op elke plek aanpassen.

Wie dat met de hand doet, voert dingen dubbel in en loopt het risico dat systemen van elkaar afwijken. Dat kost tijd en levert fouten op, juist als je gegevens nodig hebt voor een werkbon, een offerte of een controle.

Met de Climatools API los je dat op. Een API is de technische brug tussen twee systemen. Jouw systeem stuurt een verzoek aan Climatools om gegevens op te halen, toe te voegen, bij te werken of te verwijderen. Alle praktische uitleg vind je in de API-artikelen op onze supportpagina.

‍

Houd je CRM en installaties op één lijn

Via de API kun je gegevens uit Climatools lezen en gegevens naar Climatools schrijven. Dat werkt voor de volgende onderdelen:

• CRM: particuliere relaties en zakelijke klanten, hun adressen en de bijbehorende tags.

• Installaties: koel-, gas- en overige installaties, met merken, modellen, koudemiddelcircuits en tags.

• Referentiegegevens: de beschikbare koudemiddelen.

‍

Per onderdeel kun je gegevens ophalen, aanmaken, bijwerken en verwijderen. Zo kun je bijvoorbeeld een nieuw bedrijf vanuit je eigen CRM aanmaken in Climatools, of een lijst installaties ophalen en filteren. In de supportartikelen lees je welke gegevens je via de API kunt beheren en hoe je een nieuw bedrijf aanmaakt.

Werk je met grote lijsten? Dan helpen paginering en filters om alleen de gegevens op te halen die je nodig hebt.

De API groeit stap voor stap mee. Welke acties er per onderdeel beschikbaar zijn, staat in de API-documentatie.

‍

Laat Climatools je systeem actief inlichten

Je hoeft niet steeds zelf te vragen of er iets is veranderd. Met webhooks stuurt Climatools een bericht naar het adres dat jij opgeeft, zodra er iets gebeurt. Bijvoorbeeld wanneer een bedrijf wordt aangemaakt, bijgewerkt of verwijderd. Voor relaties, adressen en installaties werkt het op dezelfde manier.

Je stelt een webhook in onder Instellingen en kiest zelf welke gebeurtenissen je wilt ontvangen. Elk bericht is ondertekend, zodat je kunt controleren dat het van Climatools komt. Meer over webhooks en hoe je ze instelt lees je in de supportpagina.

‍

‍

‍

‍

Veilig en onder controle

Je regelt de toegang zelf in Climatools, onder Instellingen > API. Daar maak je een API-sleutel aan en geef je die een herkenbare naam, bijvoorbeeld die van de koppeling die hem gebruikt. Je kunt meerdere sleutels tegelijk gebruiken, bijvoorbeeld één per koppeling, en je kunt een sleutel op elk moment verwijderen. Een sleutel is na het aanmaken niet opnieuw te zien. Bewaar hem dus meteen op een veilige plek. De stappen staan in Hoe krijg ik toegang tot de API?

‍

Ook het gebruik houd je zelf in de gaten:

• Verbruik: onder Instellingen > API zie je hoeveel API-credits je hebt gebruikt en hoeveel je nog hebt.
  ‍
• API-logboek: per mislukte aanroep zie je het tijdstip, het endpoint, de statuscode en de responstijd.
  ‍
• Limiet per minuut: elke sleutel mag maximaal 60 verzoeken per minuut doen. Bij een overschrijding krijgt je systeem een melding en probeer je het kort daarna opnieuw. Zie de limiet per minuut en de mogelijke statuscodes.

‍

Voor bedrijven met eigen systemen

De API is bedoeld voor installatiebedrijven die Climatools willen laten samenwerken met hun eigen CRM of een ander systeem waarin ze installaties beheren. Je houdt je gegevens op één lijn, zonder dat iemand ze hoeft over te typen.

Ben je IT-partner of softwareleverancier van een installatiebedrijf? Dan kun je een koppeling op maat bouwen tussen het pakket van je klant en Climatools. Plan een gesprek, dan bespreken we wat je nodig hebt en wat er al kan.

‍

Beschikbaar voor Plus en Enterprise abonnementen

De API is beschikbaar voor Plus- en Enterprise-gebruikers. Heb je een ander pakket? Neem dan contact op met Sales, dan kijken we of een upgrade mogelijk is.

Elke maand heb je een aantal API-credits tot je beschikking: 1.000 bij Enterprise en 500 bij Plus. Elke geslaagde aanroep kost één credit. Een mislukte aanroep, bijvoorbeeld door een authenticatie- of validatiefout, wordt niet afgeschreven. Op de eerste van elke maand wordt je tegoed automatisch aangevuld. Ongebruikte credits vervallen aan het einde van de maand.

Zijn je credits op? Dan worden nieuwe aanroepen geweigerd tot de eerste van de volgende maand. Heb je meer nodig, dan zijn extra credits beschikbaar in pakketten van 500 of 1.000. Neem daarvoor contact op met Sales. Lees meer in Wat zijn API-credits en hoe werken ze? en Wat gebeurt er als mijn credits op zijn?

‍

‍

Aan de slag met de API

1. Controleer je pakket. De API zit in Plus en Enterprise.
   ‍
2. Maak een API-sleutel aan onder Instellingen > API en geef hem een herkenbare naam.
   ‍
3. Open de documentatie via "Bekijk API Documentatie" in dezelfde pagina. Het is de volledige, actuele documentatie (OpenAPI 3.1), waarin je endpoints met je eigen sleutel kunt testen. Zie Waar vind ik de volledige technische documentatie?
   ‍
4. Vraag hulp als je vastloopt. Gebruik de Support-knop in Climatools of mail naar support@climatools.nl. Bekijk eerst het API-logboek, zie Bij wie kan ik terecht met een probleem?

‍

Bouw je eigen koppeling

Met de Climatools API houd je je CRM en installaties automatisch op één lijn en laat je je eigen systemen met Climatools samenwerken. Wil je weten wat dat in jouw situatie betekent? We laten het graag zien in een demo.

CTA: "Plan een demo of gesprek"

‍

Veelgestelde vragen over de Climatools API

Wat is de Climatools API?

De API is de technische brug tussen jouw systemen en Climatools. Je systeem kan gegevens ophalen, toevoegen, bijwerken en verwijderen, zonder dat iemand iets hoeft over te typen.
‍

Welke gegevens kan ik via de API beheren?

CRM-gegevens (relaties, bedrijven en adressen), installaties en koudemiddelen. Alle onderdelen staan in Welke gegevens kan ik via de API beheren?
‍

Welk abonnement heb ik nodig en hoe krijg ik toegang?

De API is beschikbaar in Plus en Enterprise. Je maakt zelf een API-sleutel aan onder Instellingen > API. Zie Hoe krijg ik toegang tot de API?
‍

Wat zijn API-credits en hoe werken ze?

Elke geslaagde aanroep kost één credit. Je krijgt elke maand een tegoed, dat op de eerste van de maand wordt aangevuld. Zie Wat zijn API-credits en hoe werken ze?
‍

Wat gebeurt er als mijn credits op zijn?

Nieuwe aanroepen worden geweigerd tot het tegoed op de eerste van de volgende maand wordt aangevuld. Extra credits zijn te koop via Sales. Zie Wat gebeurt er als mijn credits op zijn?
‍

Is er een limiet op het aantal verzoeken per minuut?

Ja, maximaal 60 verzoeken per minuut per API-sleutel. Zie Is er een limiet op het aantal verzoeken per minuut?
‍

Kan Climatools mij laten weten wanneer er iets verandert?

Ja, met webhooks. Zie Kan de API mij ook actief laten weten wanneer er iets verandert?
‍

Waar vind ik de technische documentatie?

In Climatools zelf, onder Instellingen > API via "Bekijk API Documentatie". Zie Waar vind ik de volledige technische documentatie?
‍

Bij wie kan ik terecht als ik een probleem heb?

Bij het supportteam van Climatools, via de Support-knop of support@climatools.nl. Zie Bij wie kan ik terecht met een probleem?
‍

Meer vragen? Bekijk alle API-artikelen op onze supportpagina of de supportpagina van Climatools.

‍

‍