Categorieën bekijken

Nedap ONS: Webhooks

1 min leestijd

Inhoudsopgave

Webhooks vanuit ONS (Nedap) naar nCare #

Wat is een webhook? #

Met een webhook stuurt ONS automatisch een melding naar nCare zodra er iets verandert in cliënt- of medewerkersgegevens. Hierdoor worden gegevens realtime bijgewerkt, zonder te wachten op de nachtelijke synchronisatie.

Wat heb je eraan? #

  • Nieuwe medewerkers kunnen meteen inloggen met SSO
  • Cliënten die uit zorg gaan worden automatisch geblokkeerd
  • Functioneel beheerders beschikken sneller over actuele gegevens

Ondersteunde webhooktypes #

nCare verwerkt alleen de onderstaande meldingen. De overige types worden genegeerd of via de reguliere nachtelijke synchronisatie bijgewerkt.

Webhook type Verwerkt door nCare Toelichting
user ✅ Ja Directe import van medewerker + SSO-ID
employee ✅ Ja Onderdeel van user, automatisch meegenomen
client ✅ Ja Update van bestaande cliëntgegevens
team ❌ Nee Niet ondersteund
team_assignment ❌ Nee Niet ondersteund
contract ❌ Nee Niet ondersteund
location ❌ Nee Verhuizingen triggeren geen webhook (wel via nachtelijke sync)
location_assignment ❌ Nee Niet ondersteund
external_care_providers_changed ❌ Nee Apotheekkoppelingen triggeren geen webhook

Voor medewerkers #

Bij wijziging van een medewerker (user) ontvangt nCare direct een melding. De medewerker kan daardoor meteen op de eerste werkdag inloggen.

  • Directe toegang via SSO
  • Geen vertraging door nachtelijke synchronisatie
  • Minder kans op fouten bij eerste inlog

Voor cliënten #

Wanneer een cliënt uit zorg gaat, stuurt ONS een webhook (client). Deze wordt direct opgepakt door nCare. De cliënt wordt automatisch geblokkeerd.

Beperkingen:

  • Alleen bestaande cliënten in nCare worden bijgewerkt
  • Verhuizingen en opnames worden nog via de nachtelijke synchronisatie verwerkt

Let op: volgorde bij in zorg nemen in ONS #

Belangrijk: Deze informatie geldt alleen voor omgevingen die werken via synchronisatie. Gebruik je deeplinks? Dan wordt de webhookverwerking overgeslagen en is dit niet van toepassing.

Een cliënt wordt alleen correct bijgewerkt via webhook als in ONS de volgende volgorde wordt aangehouden:

  1. Cliënt aanmaken
  2. Locatie en/of apotheek koppelen
  3. Cliënt in zorg nemen

Als je deze volgorde niet volgt – bijvoorbeeld door de cliënt eerst in zorg te nemen en pas daarna locatie of apotheek te koppelen – mislukt de update via de webhook. De cliënt wordt dan niet goed bijgewerkt in nCare.

Goed om te weten: Tijdens de reguliere nachtelijke synchronisatie worden deze gegevens wél correct verwerkt, ongeacht de volgorde. Webhooks vereisen dus striktere volgordelijkheid.

Advies: werk je met synchronisatie? Volg dan altijd bovenstaande volgorde. Gebruik je deeplinks? Dan is deze volgorde niet van toepassing.

Inrichting (eenmalig) #

Voor gebruik van webhooks moet je als organisatie eerst het volgende instellen:

  1. Vul het ONS-klantnummer in bij de Nedap-instellingen in nCare.
  2. Koppel het NEDAP-certificaat aan een nieuwe connectorversie.

Daarna is webhookverwerking actief.

Fallback: nachtelijke synchronisatie blijft actief #

Webhooks versnellen veel processen, maar de reguliere nachtelijke synchronisatie blijft noodzakelijk voor volledigheid. Deze vangt situaties op die (nog) niet via webhook worden gedekt.

Overzicht: voordelen per doelgroep #

Doelgroep Verbetering
Functioneel beheer Snellere synchronisatie, minder afhankelijk van batches
Medewerkers Directe toegang via SSO
Zorgteams Altijd actuele cliëntstatus zonder handmatig synchroniseren

 

Koppeling, Nedap ONS