Ga naar hoofdinhoud

Webhooks & integraties

Rentstuff kan externe systemen automatisch op de hoogte stellen van gebeurtenissen via webhooks. Zodra er iets in het systeem gebeurt, stuurt Rentstuff een HTTP POST-verzoek naar jouw opgegeven URL met de relevante data.

Beknopt​

Via Instellingen → Webhooks registreer je een of meerdere webhook-endpoints. Per endpoint kies je welke event-types worden doorgezonden. Bij leverproblemen bewaar Rentstuff een leveringslog en schakelt een endpoint na 20 mislukte pogingen automatisch uit.

Aan de slag — een webhook toevoegen​

  1. Ga naar Instellingen → Webhooks.
  2. Tik op + om een nieuw endpoint toe te voegen.
  3. Vul de URL in van het externe systeem (bijv. een Make.com-webhook, een Zapier-trigger of een eigen server).
  4. Voeg optioneel een geheim toe. Dit geheim wordt als X-Webhook-Secret header meegestuurd zodat jij kunt verifiëren dat het verzoek echt van Rentstuff komt.
  5. Selecteer de event-types die dit endpoint moet ontvangen.
  6. Tik op Opslaan.

Het endpoint is direct actief.

Beschikbare event-types​

EventTrigger
order.createdNieuwe order of offerte aangemaakt
order.confirmedOrder bevestigd (van Offerte naar Bevestigd)
order.status_changedElke andere statuswijziging van een order
order.cancelledOrder geannuleerd
quote.accepted_by_customerKlant accepteert een offerte in het portaal
invoice.createdNieuwe factuur aangemaakt
invoice.paidFactuur volledig betaald
invoice.overdueFactuur vervallen (betaaltermijn verstreken)
damage_report.openedNieuwe schademelding aangemaakt
damage_report.status_changedStatuswijziging van een schademelding
stock_item.damagedSchademelding aangemaakt voor een stockitem
stock_item.status_changedStatuswijziging van een individueel stockitem
customer.createdNieuwe klant aangemaakt
payment.registeredBetaling geregistreerd op een factuur

Webhook-payload​

Elk webhook-verzoek heeft de volgende structuur:

{
"event": "order.confirmed",
"company_id": "abc-123",
"occurred_at": "2026-04-15T14:23:00Z",
"data": {
"id": "order-uuid",
"order_number": "ORD-2026-0042",
"status": "confirmed",
"customer_name": "Voorbeeld BV",
...
}
}

Rentstuff stuurt een Content-Type: application/json header en verwacht een HTTP 200 OK-antwoord binnen 10 seconden.

HMAC-ondertekening​

Naast het optionele geheim biedt Rentstuff ook HMAC-ondertekening voor webhooks. Elk webhook-verzoek bevat de header:

X-Rentstuff-Signature: sha256=<hmac>

De HMAC wordt berekend over de raw JSON-body met behulp van het geheim van het endpoint (SHA-256). Verifieer aan jouw kant de handtekening om te bevestigen dat het verzoek authentiek is en niet gemanipuleerd:

import hmac, hashlib

def verify(payload_body: bytes, secret: str, signature_header: str) -> bool:
expected = "sha256=" + hmac.new(
secret.encode(), payload_body, hashlib.sha256
).hexdigest()
return hmac.compare_digest(expected, signature_header)
Verifieer altijd de handtekening

Verwerk alleen webhookverzoeken waarvan de handtekening klopt. Zo voorkom je dat kwaadwillende partijen nep-events kunnen injecteren.

Leveringslog​

Elke webhookpoging wordt gelogd in het leveringslog:

  • Geslaagd: HTTP 2xx ontvangen binnen de timeout
  • Mislukt: verbindingsfout, timeout of HTTP 4xx/5xx respons

Het leveringslog is zichtbaar via Instellingen → Webhooks → [endpoint] → Leveringen. Je ziet per poging de datum, HTTP-statuscode en de volledige response-body (handig voor debuggen).

Automatisch uitschakelen

Na 20 opeenvolgende mislukte leveringen wordt het webhook-endpoint automatisch uitgeschakeld. Je ontvangt hierover een melding in de app. Herstel de oorzaak van de fouten en schakel het endpoint daarna handmatig weer in.

SSO-integraties​

Voor SSO-configuratie (SAML of Office365/Azure AD) zie Instellingen → SSO. Beide protocollen worden ondersteund en zijn per bedrijf configureerbaar. SSO is alleen van toepassing op medewerkers-logins.

SAML instellen​

  1. Ga naar Instellingen → SSO → SAML.
  2. Vul de IdP-metadata in: entity ID, SSO URL, het IdP-certificaat.
  3. Stel de attribuutmapping in (hoe SAML-attributen worden vertaald naar Rentstuff-velden).
  4. Activeer de SAML-integratie met de toggle.
  5. Geef de SP-metadata-URL door aan jouw IdP: https://api.rentstuff.io/auth/sso/saml/{company_slug}/metadata.

Office365 instellen​

  1. Ga naar Instellingen → SSO → Office365.
  2. Voer je Azure AD tenant ID, client ID en client secret in.
  3. Stel de toegestane e-maildomeinen in.
  4. Activeer de integratie.
  5. Gebruik de knop Verbinding testen om te verifiëren dat de inloggegevens correct zijn.
Auto-provisioning

Bij beide SSO-methoden kun je "Automatisch aanmaken" inschakelen. Nieuwe medewerkers die via SSO inloggen maar nog geen Rentstuff-account hebben, worden dan automatisch aangemaakt met de standaardrol.