Beschrijving van de Madenco NAW-koppeling

Beschrijving van de Madenco NAW-koppeling

Dit artikel beschrijft de werking van de Madenco NAW-koppeling en hoe een functioneel applicatiebeheerder de koppeling beheerd in Medimo.

Omschrijving

Een NAW (Naam, Adres, Woonplaats) koppeling is een koppeling tussen verschillende systemen waarbij persoonsgegevens zoals de naam, adres en woonplaats van een persoon worden uitgewisseld. Dergelijke koppelingen worden vaak gebruikt om de juistheid en consistentie van persoonsgegevens te waarborgen tussen verschillende systemen, bijvoorbeeld tussen systemen van verschillende organisaties die dezelfde persoonsgegevens beheren. Hierdoor wordt voorkomen dat verschillende systemen inconsistenties bevatten en kan er beter worden gewerkt met accurate en up-to-date persoonsgegevens.

Proces

Dit hoofdstuk legt uit welk proces de koppeling doorloopt en wanneer Medimo een mutatie doorvoert.
Medimo doorloopt een aantal stappen om te bepalen of er een mutatie moet worden doorgevoerd. Deze stappen zijn gevisualiseerd in onderstaande afbeelding.

Hieronder per stap een korte toelichting.
  1. Ontvangen van nieuwe cliëntgegevens
    Madenco stuurt na elke relevante mutatie* de cliëntgegevens inclusief de historie naar Medimo. Hiervoor wordt een klantspecifieke URL gebruikt. Hierdoor weet Medimo naar welk koppelvlak er gebruik wordt voor het verwerken van de cliëntgegevens. Bij ontvangst van de gegevens wordt het volgende gecontroleerd: 
    1. Het certificaat - Deze is uitgewisseld met Madenco. Komt het certificaat niet overeen met wat er in het koppelvlak is ingericht, dan weigert Medimo de toegang en genereert de foutmelding 'Acces denied'.
    2. IP-adres - In het koppelvlak wordt opgegeven vanaf welke IP-adressen Medimo gegevens accepteert. Komt het IP-adres niet overeen met wat er in het koppelvlak is ingericht, dan weigert Medimo de toegang en genereert de foutmelding 'Acces denied'. Meer informatie over het koppelvlak leest u in het hoofdstuk 'Koppelvlak'.

  2. Madenco toewijzingen nagaan
    Als Medimo de gegevens accepteert, dan wordt er nagegaan welke toewijzingen de cliënt heeft in Madenco. Medimo gebruikt de volgende data uit de Madenco toewijzing:
    1. AfdelingId
    2. LocatieId
    3. Kamernummer
    4. Begindatum
    5. Einddatum
    6. elvLocation

  3. Matchen Madenco toewijzingen in koppeltabel
    De volgende stap is de betreffende Madenco toewijzingen nagaan in de 'Koppelvlaktabel webservices'. Medimo gebruikt hiervoor het locationId en afdelingId uit Madenco. Hierbij kan het volgende gebeuren:
    1. Er is een match - Medimo gaat na hoe de regel is gekoppeld om te bepalen hoe de cliëntgegevens moeten worden verwerkt.
    2. Er is geen match - Medimo stopt direct met het verwerken van de cliëntgegevens en voert geen mutatie uit. Als er geen match is gaat Medimo er vanuit dat het een nieuw Madenco 'Planeenheid' betreft en voegt deze automatisch toe aan de 'Koppelvlaktabel webservices'. De nieuwe regel dient u te koppelen voordat Medimo de cliëntgegevens kan verwerken.

  4. Verschillen nagaan en muteren
    De laatste stap is de cliëntgegevens uit Medimo vergelijken met de cliëntgegevens uit Madenco aan de hand van de 'Koppelvlaktabel webvervices'. Zijn er verschillen, dan worden de cliëntgegevens in Medimo aangepast. Dit leidt dan bijvoorbeeld tot een opname, ontslag of verhuizing.

Toewijzen apotheek en arts

Het is mogelijk om vanuit Madenco de apotheek en de arts toe te wijzen aan de cliënt in Medimo. Dit biedt een uitkomst voor afdelingen waar cliënten verblijven met verschillende apotheken van inschrijving. In Madenco moet de beheerder een speciale setting (ofwel een 'Variatiepunt') aanzetten om de apotheek mee te sturen tijdens de 'Export Persoonsgegevens'. 

Ontslag cliënt

Er zijn 2 situaties die in Medimo leiden tot een ontslag van een cliënt:
  1. Alle toewijzingen in Madenco hebben een einddatum - Hierdoor krijgen alle locatietoewijzingen in Medimo ook een einddatum wat een ontslag is.
  2. De toewijzingen in Madenco ZONDER einddatum zijn in Medimo gekoppeld met het koppeltype 'Negeer deze locatie'. - Medimo negeert deze actieve toewijzingen en kijkt alleen naar de toewijzingen met een einddatum. Hierdoor krijgen alle locatietoewijzingen in Medimo ook een einddatum wat een ontslag is.

Koppelvlaktabel webservices 

Medimo gebruikt de 'Koppelvlaktabel webservices' om te bepalen of er vanuit de koppeling een wijziging moet worden doorgevoerd. In de 'Koppelvlaktabel webservices' worden de Madenco toewijzingen gekoppeld aan een corresponderende Medimo afdeling.  Alle regels in deze tabel moeten zijn gekoppeld ook de regels die Medimo moet negeren. Het is in Madenco Windows mogelijk om bij teams de export persoonsgegevens niet aan te zetten. Hierdoor worden er geen teams en de planeenheden die daaronder vallen meegenomen in de koppeling. U kunt er dus voor kiezen om afdelingen die genegeerd moeten worden niet te exporteren naar Medimo.

De 'Koppelvlaktabel webservices' vindt u via het 'Zoeken in alles'-veld of vanuit het hoofdmenu via Beheer > Koppelvlak beheer > Koppelvlaktabel webservices.  Onderstaande afbeelding is een voorbeeld van een gevulde 'Koppelvlaktabel webservices'.

Inrichting Koppelvlaktabel webservices

Het inrichten van de 'Koppelvlaktabel webservices' bestaat uit het koppelen van Madenco toewijzingen aan Medimo afdelingen. Bovenstaande afbeelding is een voorbeeld van een gevulde 'Koppelvlaktabel webservices'. Medimo voegt automatisch regels toe aan deze tabel wanneer er 'nieuwe' Id's in de cliëntgegevens staan. Deze 'nieuwe' regels zijn in de 'Koppelvlaktabel webservices' te herkennen aan de kolom 'Medimo afdeling'. Bij nieuw toegevoegde regels staat daar de waarde 'Onbekend'.
Volg onderstaande instructies om een regel te koppelen.
  1. Klik op een regel
    Medimo toont de details van de regel, dit ziet eruit zoals onderstaande afbeelding.
    Externe locatie, locatienaam, afdeling en afdelingnaam zijn gegevens die uit Madenco komen. Dit zijn de namen en ID's van de locaties in Madenco. Bij een mutatie gaat Medimo na op welke Madenco locatie/ID de cliënt verblijft en in hoeverre deze is gekoppeld in de 'Koppelvlaktabel webservices'. Medimo gebruikt hiervoor de velden Externe locatie en Externe afdeling. Medimo raadt aan deze velden NIET aan te passen.

  2. Selecteer de Medimo afdeling
    Klik in het veld achter Medimo afdeling om te zoeken naar de afdeling. Klik vervolgens op de afdeling om deze te selecteren. Bovenstaande afbeelding is een voorbeeld van een regel waarbij een Medimo afdeling is geselecteerd. Ook regels die Medimo moet negeren dient u te koppelen. Vaak is hiervoor een afdeling 'Overig' aangemaakt die u daarvoor kunt gebruiken.

  3. Selecteer het 'Koppeltype'
    Dit bepaald wat Medimo met de gekoppelde regel doet. U heeft keuze uit de volgende opties:
    1. Iedereen - Medimo gebruikt de regel voor het verwerken van cliëntgegevens
    2. Negeer -  Medimo negeert de regel waardoor die niet wordt gebruikt voor het verwerken van cliëntgegevens.

  4. Klik op de knop 'Opslaan'
    Hiermee koppelt u de regel en Medimo toont de 'Koppelvlaktabel webservices.

Niet-gekoppelde regels

Wanneer de cliënt een Madenco toewijzing heeft die niet is gekoppeld in de 'Koppelvlaktabel webservices', dan kan Medimo niet bepalen hoe de Madenco toewijzing verwerkt moet worden. Medimo stopt daardoor met het verwerken van de cliëntgegevens en Medimo logt een foutmelding die u kunt nagaan in de 'Log patient-koppeling (naw)'. Anders gezegd voert Medimo bijvoorbeeld geen verhuizing, ontslag of overlijden door als een toewijzing niet is gekoppeld. Ook regels die Medimo moet negeren dient u te koppelen. Voor deze regels geldt het volgende:
  1. Koppel de regel aan een Medimo afdeling - Vaak is hiervoor een fictieve afdeling 'Overig' aangemaakt die u hiervoor kunt gebruiken.
  2. Gebruik het koppeltype 'Negeer deze locatie'
Nadat de nieuwe regel is gekoppeld dient Madenco opnieuw de gegevens aan te bieden bij Medimo.

Koppelvlak

Voor de NAW-koppeling wordt in Medimo een koppelvlak ingericht. In het koppelvlak worden onder andere de certificaten, IP-adressen en 'Koppelvlak-opties' opgegeven. Medimo gebruikt het koppelvlak om de toegang te valideren en om te bepalen in welke cluster(s) de mutaties vanuit Madenco kunnen worden verwerkt.
U kunt geen aanpassingen doen aan het koppelvlak, maar het koppelvlak is wel inzichtelijk voor u. Gebruik het 'Zoeken in alles'-veld of klik va uit het hoofdmenu op Beheer > Koppelvlak beheer > Koppelvlak.

Gegevensuitwisseling in de koppeling

Cliëntgegevens
Momenteel ondersteunt Medimo de volgende velden uit Madenco:
  1. CliëntID - Dit vult Medimo in het veld ExternId
  2. BSN
  3. Geboortenaam
  4. Geslacht
  5. Initialen
  6. Geboortedatum
  7. Locatietoewijzing - Hieronder vallen de Toewijzing ID, afdeling ID, afdeling naam, begindatum, einddatum.
Thuisgegevens
In de Thuisgegevens wordt vastgelegd wat het (thuis)adres, de huisarts en de apotheek van de cliënt zijn. Deze gegevens worden doorgaans gebruikt in een extramurale setting zoals poliklinische zorg of thuiszorg. Vooralsnog worden deze gegevens niet uitgewisseld in de koppeling.

Hoofdlocaties en bijlocaties
Een cliënt kan in Medimo actieve hoofdtoewijzingen hebben. Hierdoor kan bijvoorbeeld ook dagbesteding met Medimo werken. Vooralsnog wordt het type toewijzing niet uitgewisseld in de koppeling. Een oplossing hiervoor is om de Medimo afdeling te kenmerken als 'Altijd bijlocatie'. Hierdoor kan vanuit de koppeling alsnog een niet-hoofdtoewijzing worden toegewezen.

ELV
De cliënt kan in Medimo een ELV-toewijzing krijgen. Dit is noodzakelijk wanneer de apotheek de ELV-declaratiebestanden vanuit Medimo genereert. Vooralsnog worden deze gegevens niet uitgewisseld in de koppeling. Een oplossing hiervoor is het aanmaken van een extra ELV-afdeling in zowel Medimo als Madenco. In Medimo moet deze afdeling gekenmerkt worden als 'Altijd eerste lijns verblijf (ELV)' en 'Altijd bijlocatie'. Hierdoor kan vanuit de koppeling alsnog ELV worden toegewezen aan de cliënt.

DBC
De cliënt kan in Medimo een ELV-toewijzing krijgen. Dit is noodzakelijk wanneer de apotheek de ELV-declaratiebestanden vanuit Medimo genereert. Vooralsnog worden deze gegevens niet uitgewisseld in de koppeling. Een oplossing hiervoor is het aanmaken van een extra ELV-afdeling in zowel Medimo als Madenco. In Medimo moet deze afdeling gekenmerkt worden als 'Altijd eerste lijns verblijf (ELV)' en 'Altijd bijlocatie'. Hierdoor kan vanuit de koppeling alsnog ELV worden toegewezen aan de cliënt.

Onderscheid tussen cliënten met en zonder behandeling
Vanwege verschillende werkwijzen worden in Medimo de cliënten met behandeling en de cliënten zonder behandeling op verschillende afdelingen opgenomen. Zelfs als de cliënten in Madenco op dezelfde afdeling zitten, heeft het de voorkeur om de cliënten in Medimo te splitsen. Vooralsnog is er geen kenmerk dat gebruikt kan worden in de koppeling om een onderscheid te maken tussen deze cliënten. Als de splitsing toch moet plaatsvinden in Medimo, dan moet dit ook in Madenco worden doorgevoerd.




Medisch Hulpmiddel

Medimo automatiseert het geneesmiddelproces zodat er minder fouten worden gemaakt. Het product omvat functionaliteit zoals het elektronisch voorschrijven, het uitvoeren van medicatiebewaking en het uitvoeren van elektronische toedienregistratie en is als zodanig een medisch hulpmiddel. Medimo wordt in Nederland op de markt gebracht door Enovation Medimo, Soestdijkseweg Zuid 13, 3732 HC De Bilt. Enovation Medimo is gecertificeerd onder ISO 27.001 en NEN 7510. Medimo voldoet aan de Medical Device Regulation (MDR, klasse I). Dit document behoort tot de gebruikershandleiding van versie: 2024-3, productiedatum: 02-07-2024​

CE certificate
    • Related Articles

    • Beschrijving van de Madenco SSO-koppeling

      Dit artikel beschrijft de werking van de Madenco SSO-koppeling en hoe een functioneel applicatiebeheerder de koppeling beheerd in Medimo. Omschrijving Een Single Sign-On (SSO) koppeling is een technologie waarmee een gebruiker zich slechts één keer ...
    • Beschrijving van de Ysis NAW-koppeling

      Dit artikel beschrijft hoe Ysis NAW-koppeling functioneert en hoe een functioneel applicatiebeheerder deze beheert in Medimo. Omschrijving Een NAW (Naam, Adres, Woonplaats) koppeling is een koppeling tussen verschillende systemen waarbij ...
    • Beschrijving van de Careweb NAW-koppeling

      Dit artikel beschrijft hoe Careweb NAW-koppeling functioneert en hoe een functioneel applicatiebeheerder deze beheert in Medimo. Momenteel bestaat er nog geen SSO-koppeling met Careweb. Omschrijving Een NAW (Naam, Adres, Woonplaats) koppeling is een ...
    • Beschrijving van de Pluriform NAW-koppeling

      Dit artikel beschrijft de werking van de Pluriform NAW-koppeling en hoe een functioneel applicatiebeheerder de koppeling beheert in Medimo. Omschrijving Een NAW (Naam, Adres, Woonplaats) koppeling is een koppeling tussen verschillende systemen ...
    • Beschrijving van de SDB NAW-koppeling

      Dit artikel beschrijft de werking van de SDB NAW-koppeling en hoe een functioneel applicatiebeheerder de koppeling beheert in Medimo. Omschrijving Een HL7-ADT (Admission, Discharge and Transfer) koppeling is een gestandaardiseerd berichtformaat voor ...