ZorgDomein-koppeling

Inleiding

Met de ZorgDomein-koppeling is het vanaf versie 2.016 mogelijk om elektronische verwijzingen te verwerken in OpenAC.

In onderstaande afbeelding zijn de onderdelen van deze koppeling schematisch weergegeven:

De koppeling bestaat uit de volgende onderdelen:

1. ZorgDomein server - de server van ZorgDomein levert voor AC's bestemde verwijzingen aan bij de FENAC-server (2).
2. FENAC-server - de FENAC-server (OpenACHub) ontvangt alle door ZorgDomein aangeleverde verwijzingen en zet ze klaar in een wachtrij per AGB.
3. OpenAC 3 - deze server staat bij het AC en haalt periodiek voor het AC bestemde verwijzingen op bij de FENAC HL7-server.
4. OpenAC 2 clients - medewerkers van het AC verwerken de binnengekomen verwijzingen in OpenAC.

FENAC-server

De FENAC-server (OpenACHub) is een virtuele Linux server in Microsoft Azure, beheerd door de FENAC en bekostigd door de deelnemende leden. De server luistert naar verwijzingsberichten van ZorgDomein en publiceert een Web service API waarmee AC's voor hun bestemde verwijzingen kunnen ophalen.

OpenAC 3

OpenAC 3 is een server-applicatie die draait op een server van het AC. Periodiek haalt OpenAC 3 verwijzingen op bij OpenACHub. De opgehaalde verwijzingen worden verwerkt in de OpenAC database.

Beveiligde communicatie

De ZorgDomein server levert verwijzingsberichten aan bij de FENAC HL7-server middels een beveiligde VPN-verbinding.

OpenAC 3 vraagt verwijzingen op bij OpenACHub middels een SSL-verbinding beveiligd met een door de FENAC uitgegeven certificaat. Elk AC kan alleen verwijzingen opvragen voor zijn eigen AGB-codes. Een koppeling tussen het certificaat en AGB-codes dwingt dit af.

Beveiliging tegen dataverlies

We hebben de volgende stappen genomen om er zeker van te zijn dat er geen verwijzingen kwijt kunnen raken:

• De volledige communicatie tussen ZorgDomein en OpenACHub, inclusief eventuele fouten, wordt gelogd;
• Alle verwijzingen worden opgeslagen in de bijbehorende AGB-postbus;
• Communicatie tussen OpenAC 3 en OpenACHub, inclusief eventuele fouten, wordt gelogd;
• Verwijzingen blijven in de postbus staan totdat OpenAC 3 een ACK verstuurt dat de verwijzing in goede staat is ontvangen. Bij het ontvangen van een ACK wordt de verwijzing verplaatst naar een ACK-map, maar niet verwijderd.
• Het bericht waarmee OpenAC 3 een verwijzing ophaalt bij OpenACHub is beveiligd met een checksum. Zo weet OpenAC 3 dat de verwijzing onderweg niet is gewijzigd. Pas als de checksum klopt stuurt OpenAC 3 een ACK.
• Het ontvangen van een verwijzing en het verwerken van een verwijzing is uitgesplitst in twee processen. Als OpenAC 3 een verwijzing ontvangt dan controleert het de checksum. Als de checksum klopt dan wordt de verwijzing opgeslagen als JSON-bestand en verstuurt OpenAC 3 een ACK. Pas dan zal OpenAC 3 de verwijzing verwerken. Als hierbij iets fout gaat dan wordt dit gelogd. Omdat de verwijzing als JSON-bestand is opgeslagen kan deze als het probleem is verholpen opnieuw worden verwerkt.

Verwerken verwijzing door OpenAC 3

Op basis van de geconfigureerde AGB-locatie vraagt de lokale servercomponent via de beschikbare API de FENAC-server of er verwijzingen zijn gerelateerd met de geconfigureerde AGB-locatie. Als er verwijzingen zijn dan worden ze naar de lokale servercomponent teruggekoppeld. Het verwerkingsproces zal verder zoals hieronder verlopen:

• Er wordt eerst gecontroleerd of de verwijzing niet al eerder is geregistreerd.
• Daarna wordt de patiënt opgezocht via de meegegeven BSN.
• Als de patiënt niet is gevonden dan wordt de patiënt opgezocht op NAW-gegevens.
• Als de patiënt niet is gevonden dan een nieuwe patiënt record aangemaakt.
• Als de verwijzer niet op basis van zijn AGB-code kan worden gevonden, wordt die aangemaakt.
• Als dat een bestaande patiënt betreft dan wordt gekeken of een open zorgtraject is anders wordt een nieuw zorgtraject aangemaakt.
• De nieuwe verwijzing met het bijgevoegd document wordt toegevoegd aan het zorgtraject.
• Er wordt een actie gemaakt met thema ‘ZorgDomein verwijzing’. Die actie wordt gekoppeld aan een default gebruiker zodat de nieuwe verwijzingen in planlijst overzicht ‘Acties van medewerkers’ terecht komt en daarmee zichtbaar wordt.

Inrichting OpenAC 2 m.b.t. ZorgDomein

Om de ZorgDomein module te activeren de volgende regel in modules.ini opnemen:

kern.d080_zorgdomein = True

Inrichting OpenAC 3 m.b.t. ZorgDomein

Om de ZorgDomein koppeling in te richten moet eerst de lokale OpenAC-server geïnstalleerd worden. Zie Installatie Server? voor de installatiehandleiding. De lokale servercomponent van OpenAC die als een Windows service is geïnstalleerd op het systeem van de AC haalt via de beschikbare API van de FENAC-server de verwijzingen binnen.

De volgende instellingen van de locaties van het AC moeten via het appsettings.json bestand worden geconfigureerd:

• Serieprefix bij een tabelkey (als een tabelkey met de laatste twee cijfers van het jaar moet beginnen of met een bepaalde cijfer dan kan dat per tabel hier worden ingesteld),
• Lengte van de key per tabel (Default keylengte van de meeste tabellen zijn 8. Als men in de praktijk daar wil afwijken dan kan dat bij 'TabelKeyLengtes?' worden ingesteld),
• AGB-code (8 cijfers),
• AGB-locatienaam,
• Locatieletter (de combinatie van letter en AGB-code moet geldig zijn ook in de OpenAC 2 Desktop installatie),
• Bestandsmap (aanbevolen wordt om dit per AGB/locatie gescheiden te houden; dat is in het voorbeeld hieronder niet zo).

Hieronder een voorbeeld van de AGB/locaties instellingen in appsettings.json:

  "Agb": {
    "Serieprefix": {
      "bundel": {
        "default": "{jaar2}97"
      },
      "notaregel": {
        "default": "{jaar2}7"
      },
      "patient": {
        "default": "1"
      },
      "relatie": {
        "default": ""
      }
    },
    "TabelKeyLengtes": {
      "patient": 7,
      "relatie": 6,
      "default": 8
    },
    "AgbLocaties": [
      {
        "Code": "12345678",
        "LocatieNaam": "Groningen",
        "LocatieLetter": "G",
        "Bestandsmap": "C:\\Users\\ugur\\Documents"
      },

      {
        "Code": "87654321",
        "LocatieNaam": "Maastricht",
        "LocatieLetter": "M",
        "Bestandsmap": "C:\\Users\\ugur\\Documents"
      }
    ]
  }

Ook eigenschappen van de ZorgDomein koppeling moeten via het appsettings.json bestand worden geconfigureerd:

• ZorgDomein actief (veld 'InGebruik'),
• Interval van de controles of er nieuwe verwijzingen zijn,
• Per locatie de default medewerker waarmee de acties gekoppeld worden,
• SSL instellingen (certificaat)

Hieronder een voorbeeld van de ZorgDomein instellingen in appsettings.json:

   "Zorgdomein": {
    "InGebruik": false,
    "Locaties": [
      {
        "Identifier": "Hoensbroek",
        "Clusters": [
          {
            "Identifier": "Hoensbroek gehoor",
            "LocatieLetter": "G",
            "Medewerker": "admin",
            "Controleur": "admin"
          },
          {
            "Identifier": "Hoensbroek spraak",
            "LocatieLetter": "T",
            "Medewerker": "admin",
            "Controleur": "admin"
          }
        ]
      },
      {
        "Identifier": "Blerick",
        "Clusters": [
          {
            "Identifier": "Blerick gehoor",
            "LocatieLetter": "V",
            "Medewerker": "admin",
            "Controleur": "admin"
          },
          {
            "Identifier": "Hoensbroek spraak",
            "LocatieLetter": "S",
            "Medewerker": "admin",
            "Controleur": "admin"
          }
        ]
      }
    ],
    "Host": "zd.fenac.nl",
    "Port": "5000",
    "SSL": {
        "Enabled": true,
        "CertificateFile": "D:\\projecten\\OpenACTools\\ssl-ca\\demoCA\\pfx\\F1633F593C632D11_adelante_zorggroep.pfx",
        "CertificatePassword": "password"
    }
  }

Bovenstaand voorbeeld definieert Zorgdomein locaties. De identifier moet overeenkomen met de locatie identifier zoals deze bij Zorgdomein bekend is. Elke locatie definieert één of meerdere clusters. Ook voor clusters geldt dat de identifier hetzelfde moet zijn als de Zorgdomein cluster identifier. Cluster hebben naast een identifier de volgende attributen:

Locatieletter	De locatiecode van een OpenAC locatie. Moet overeenkomen met de locatieletter van een Agb-locatie in de sectie AgbLocaties.
Medewerker	Gebruikerscode van de eigenaar van de actie die de Zorgdomeinmodule aanmaakt bij ontvangst van een verwijzing
Controleur	Gebruikerscode van de eigenaar van de controleactie die de Zorgdomeinmodule aanmaakt

Onderstaand configuratievooorbeeld bevat een sectie met LocatieMedewerkers. Het gebruik van LocatieMedewerkers is verouderd en zal worden uitgefaseerd. Medewerkers worden geconfigureerd in de cluster waar ze bij horen zoals in bovenstaand voorbeeld.

  "Zorgdomein": {
    "InGebruik": true,
    "Interval": 30,
    "LocatieMedewerkers": [
      {
        "LocatieNaam": "Groningen",
        "Naam": "admin",
        "NaamControleur": "jsmith"
      },
      {
        "LocatieNaam": "Maastricht",
        "Naam": "admin",
        "NaamControleur": "jsmith"
      }
    ],
    "Host": "zd.fenac.nl",
    "Port": "5000",
    "SSL": null
  }

De SSL instellingen zijn binnen de ZorgDomein instellingen te regelen en gelden alleen voor de verbinding met de FENAC Server ten behoeve van de ZorgDomein koppeling. De FENAC verstrekt client-certificaten, getekend door de FENAC-ZorgDomein-Koppeling; deze certificaten zijn alleen te gebruiken voor de communicatie met de FENAC server voor deze koppeling. De procedure voor het verstrekken van de certificaten wordt elders beschreven.

De instellingen voor SSL zijn:

• Of SSL gebruikt wordt (voor test-doeleinden kan SSL worden uitgeschakeld; bij de AC's zal dat nooit het geval zijn),
• Bestandsnaam van het certificaat,
• Wachtwoord voor het certificaat.

Omdat het wachtwoord voor het certificaat in "plain text" in het configuratiebestand staat, wordt sterk aangeraden om het goed afgeschermd op de server op te slaan (wat sowieso een goed idee is voor de configuratie van de OpenAC 3 Server). Zowel het certificaat als het wachtwoord hoeven maar op een plek -- bij de OpenAC 3 Server -- opgeslagen te worden; ze zijn niet bedoeld voor gebruik door de werkplek-machines.

  "Zorgdomein": {
    "SSL": {
      "Enabled": true,
      "CertificateFile": "C:\\Users\\Ugur\\certificaten\\ac_utrecht.pfx",
      "CertificatePassword": "geheim!"
    }
  }

Controle werkende koppeling

Dit zijn de twee gebrekkige punten in de OpenACWeb applicatie waardoor de Zorgdomein-koppeling niet goed werkt (Ze zullen in de toekomst verholpen worden)

• Indien men de bestand-map niet goed is geconfigureerd van 1 AGB locatie, bijvoorbeeld doordat er geen schrijfrechten zitten op deze map, dan zal OpenACWeb wel een fout tonen in het rood, echter het periodiek ophalen zal dan NIET werken ook niet voor de WEL goed ingestelde AGB-locaties. De OpenACWeb zal dus wel draaien echter, je zult pas op initiatief van de beheerder achter komen dat er geen verwijzingen zijn opgehaald en dat kan best te laat zijn.

Het gaat om de sectie:

"Agb": {
    "AgbLocaties": []
    "Bestandsmap": "C:\\Users\\Bepaaldepersoon\\Documents" 

• Indien er in appsettings.json een verkeerde configuratie staat, bijvoorbeeld het SSL blok ontbreekt of staat op Enabled: false dan zal OpenACWeb geheel niet opstarten. Zorg voor een correcte setting.

Functionele documentatie

De functionele documentatie van de Zorgdomein koppeling is hier te vinden.

Contactgegevens Zorgdomein

De contactpersoon van de FENAC bij Zorgdomein is:

Lianne Oskam

oskam@…

06 230 20 730

Zorgdomein testomgeving

Zorgdomein heeft een testomgeving om online testverwijzingen aan te kunnen maken op de volgende url: ​https://tio.zorgdomein.nl

FENAC ICT heeft een account om van deze service gebruik te kunnen maken.

Uitleverstraat certificaten Zorgdomein

Hier wordt de procedure gegeven hoe de AC-beheerder een client certificaat kan verkrijgen voor de Zorgdomein-koppeling. In de procedure is het veilig overdragen van een certificaat meegenomen.

De procedure is als volgt:

1) Een AC-beheerder geeft per ticket aan dat ze voor hun gehele organisatie de zorgdomein-koppeling willen gebruiken. Dit houdt in voor alle AGB-locaties.

2) Een AC-beheerder geeft de organisatienaam door, waarvoor hij de koppeling aanvraagt. Bij voorkeur kiest de beheerder de organisatienaam die hieronder staat in de lijst.

3) De beheerder geeft op voor welke AGB locatie en locatienamen deze koppeling bedoeld is. Per AGB nummer een AGB locatienaam opgeven. De locatienaam is hier administratief. In de appsetting van OpenACWeb is de locatienaam WEL weer belangrijk voor het verwerken van een bericht.

4) Standaard gebruiken wij de gegevens zoals hieronder weergegeven in de lijst. We hanteren het kantooradres.

Mits het zeer noodzakelijk is kan de AC-beheerder aanpassingen doorgeven (Liefst zo min mogelijk)

5) Een AC geeft aan op welke manier ze het pfx certificaat verstuurd willen hebben.

Standaard doen wij een winzip met een zip-wachtwoord welke wij los van elkaar per email versturen.

6) Een AC geeft aan op welke manier het pfx-wachtwoord verstuurd moet worden.

Standaard doen wij dat per email adres.

7) Als alle noodzakelijk gegevens binnen zijn dan geven een terugkoppeling in het ticket. Wij werken onze administratie bij, drukken het verzoek af etc.

We zetten in het ticket dat we het verzoek verwerken.

8) We maken een client-certificaat aan met een random pfx wachtwoord.

9) Wij versturen het certificaat-bestand als een zip naar de opgegeven ontvanger.

10) Versturen het pfx wachtwoord per email naar de opgegeven ontvanger.

11) Wij passen onze Zorgdomein-server aan met de nieuwe instellingen.

12) Wij zetten 1 proef bericht klaar met een verwijzing.pdf

13) Als we in de logfile zien dat de server het bericht verwerkt heeft dan gaan we er van uit dat koppeling werkt.

14) Voor de AC zal het proef bericht zijn opgeslagen met een verwijzer.pdf. In dit pdf bestand staat de verwijzer-naam "Henk Burgstra". Als het bericht aanwezig is dan is dit het teken voor de AC-beheerder dat de zorgdomein-koppeling werkt.

Op dit moment zijn de volgende organisaties met de volgende gegevens geregistreerd voor de Zorgdomein-koppeling. Voor de AC-beheerder is het verzoek om de AGBlocaties te controleren bij een aanvraag.

	organisatienaam:   Koninklijke Kentalis
	website:   www.kentalis.nl 
	contactpersoon:  Peter Vorstenbosch 
	e-mailadres:  p.vorstenbosch@kentalis.nl 

	AGB locaties:  19009331, 19009334, 19009348, 19009349, 19009353 
	AGB locatienamen:  AMSTERDAM   SINT-MICHIELSGESTEL   EINDHOVEN   SINT-MICHIELSGESTEL
	straat:   Theerestraat 42 
	stad:   Sint-Michielsgestel 
	provincie:  Noord-Brabant 

	organisatienaam:   Stichting Zorg Koninklijke Auris Groep 
	website:   www.auris.nl 
	contactpersoon:  Angela Muetgeert 
	e-mailadres:  A.Muetgeert@Auris.nl 

	AGB locaties:  19009351, 73732014   
	AGB locatienamen:  AMSTERDAM   
	straat:   Ammanplein 2 
	stad:   Rotterdam 
	provincie:  Zuid-Holland 

	organisatienaam:   Adelante zorggroep 
	website:   www.adelante-zorggroep.nl 
	contactpersoon:  Roger Silverentand 
	e-mailadres:  Roger.Silverentand@adelantegroep.nl
	
	AGB locaties:  19009338, 19009354   40407014   40407017   ,
	AGB locatienamen:  Hoensbroek   ,
	straat:   Zandbergsweg 111 
	stad:   Hoensbroek 
	provincie:  Limburg 

	organisatienaam:   Libra Revalidatie & Audiologie 
	website:   www.libranet.nl 
	contactpersoon:  Linda Gunnewegh 
	e-mailadres:  l.gunnewegh@libranet.nl 

	AGB locaties:  19009335, 19009337, 19009358
	AGB locatienamen:  Eindhoven, Tilburg, Eindhoven
	straat:   Toledolaan 2 
	stad:   Eindhoven 
	provincie:  Noord-Brabant 

	organisatienaam:   Audiologisch Centrum Holland Noord(NSDSK) 
	website:   www.nsdsk.nl 
	contactpersoon:  Tommy Reusse 
	e-mailadres:  treusse@nsdsk.nl 
	
	AGB locaties:  19009332 
	AGB locatienamen:  Amsterdam 
	straat:   De Vliegerstraat 1a 
	stad:   Alkmaar 
	provincie:  Noord-Holland 

	organisatienaam:   Pento Audiologisch Centrum 
	website:   www.pento.nl 
	contactpersoon:  Rutger Bossenbroek 
	e-mailadres:  r.bossenbroek@pento.nl 

	AGB locaties:  19009326, 19009327, 19009328, 19009329, 19009352, 19009356    ,
	AGB locatienamen:  Friesland   TWENTE   Zwolle   Amersfoort   Drenthe   Apeldoorn  
	straat:   Linie 518 
	stad:   Apeldoorn 
	provincie:  Gelderland 

        organisatienaam:   Audiologisch Centrum Hilversum 
	website:   www.ac-hilversum.nl 
	contactpersoon:  Ton Houffelaar 
	e-mailadres:  a.houffelaar@vumc.nl 
	AGB locaties:  9009355
	AGB locatienamen:  Hilversum
	straat:   Van Linschotenlaan 1 
	stad:   Hilversum 
	provincie:  Noord-Holland