Hier vindt u alle informatie voor ontwikkelaars
Aansluiten op Zorgplatform
Aanvragen van een aansluiting voor de toepassing
Ontwikkelen en testen van de app aansluiting
De app beschikbaar stellen
Aansluitvoorwaarden
Certification Practice Statement
Aansluiten op Zorgplatform
Aanvragen van een aansluiting voor de toepassing
Ontwikkelen en testen van de app aansluiting
De app beschikbaar stellen
Aansluitvoorwaarden
Certification Practice Statement
Om een integratie te realiseren, dienen er een aantal voorbereidingen te worden getroffen; er moeten aansluitingen aangevraagd worden, de aansluitingen moeten ontwikkeld worden door de app en de applicatie moet gepubliceerd worden door ChipSoft. Er zijn in totaal vier aansluitingen/integratiefases:
- Ontwikkelaansluiting; voor de initiële ontwikkelfase op developer.zorgplatform (op het officiële cluster van Zorgplatform)
- Testaansluiting; voor testen in HiX zonder klant (op het testcluster van Zorgplatform)
- Acceptatieaansluiting; voor testen door zorginstellingen met een acceptatieomgeving van HiX (op het officiële cluster van Zorgplatform)
- Productieaansluiting; (op het officiële cluster van Zorgplatform)
Alle gespecificeerde voorbereidingen van de partnerapplicatie worden door ChipSoft gebruikt ten behoeve van het inrichten van Zorgplatform én de inrichting van de XIS. Indien een applicatie gepubliceerd wordt, wordt deze middels standaard content uitgeleverd in de XIS in-house store. Alle zorgaanbieders hebben hierdoor dezelfde inrichting voor digitale zorgapplicaties.
Aanvragen van een aansluiting voor de toepassing
Aanvragen van een aansluiting voor de toepassing
Aansluitingen voorbij de ontwikkelaansluiting worden op projectbasis en in opdracht van een zorginstelling gerealiseerd. Indien een aanbieder van een bestaande of nieuwe app deze app wil integreren met een EPD via Zorgplatform, zal daartoe een opdracht moeten worden verstrekt aan ChipSoft door een zorgaanbieder.
Een geldige aanvraag bevat een opsomming van de use cases en de door de app vereiste permissies:
- Welke use cases ondersteunt de applicatie via Zorgplatform?
- Wat zijn de requirements per use case? Denk bijvoorbeeld aan:
- Welke Zorgplatform-gegevensdiensten gebruikt de app? Zie ook API's en FHIR specificaties.
- Welke gegevensdiensten mag de app gebruiken als er een zorgverlener is ingelogd?
- Welke gegevensdiensten mag de app gebruiken als er een patiënt is ingelogd?
- Welke gegevensdiensten mag de app gebruiken als niemand is ingelogd? Dit gaat bijvoorbeeld om automatische handelingen zonder dat er een gebruiker is ingelogd.
- Maakt de app gebruik van Single-sign-on ten behoeve van visuele integratie in het XIS van de zorgverlener? Zie ook Authenticatie.
Per aansluiting dient de partnerapplicatie aan te geven welke omgeving gebruikt kan worden. Voor de testaansluiting (die gebruikt wordt voor onderlinge tests) kan het bijvoorbeeld nuttig zijn om een omgeving beschikbaar te stellen die representatief is aan de omgeving waar klanten mee testen.
Aansluitingen voorbij de ontwikkelaansluiting worden op projectbasis en in opdracht van een zorginstelling gerealiseerd. Indien een aanbieder van een bestaande of nieuwe app deze app wil integreren met een EPD via Zorgplatform, zal daartoe een opdracht moeten worden verstrekt aan ChipSoft door een zorgaanbieder.
Een geldige aanvraag bevat een opsomming van de use cases en de door de app vereiste permissies:
- Welke use cases ondersteunt de applicatie via Zorgplatform?
- Wat zijn de requirements per use case? Denk bijvoorbeeld aan:
- Welke Zorgplatform-gegevensdiensten gebruikt de app? Zie ook API's en FHIR specificaties.
- Welke gegevensdiensten mag de app gebruiken als er een zorgverlener is ingelogd?
- Welke gegevensdiensten mag de app gebruiken als er een patiënt is ingelogd?
- Welke gegevensdiensten mag de app gebruiken als niemand is ingelogd? Dit gaat bijvoorbeeld om automatische handelingen zonder dat er een gebruiker is ingelogd.
- Maakt de app gebruik van Single-sign-on ten behoeve van visuele integratie in het XIS van de zorgverlener? Zie ook Authenticatie.
Per aansluiting dient de partnerapplicatie aan te geven welke omgeving gebruikt kan worden. Voor de testaansluiting (die gebruikt wordt voor onderlinge tests) kan het bijvoorbeeld nuttig zijn om een omgeving beschikbaar te stellen die representatief is aan de omgeving waar klanten mee testen.
Ontwikkelen en testen van de app aansluiting
Ontwikkelen en testen van de app aansluiting
Om toegang te krijgen tot de ontwikkelaansluiting dient de applicatie een account aan te maken en verschillende certificaten, endpoints, en een HL7 OID aan te leveren. De certificaten worden gebruikt per aansluiting (ontwikkel&test / acceptatie / productie) en per doeleinde (client authentication / encryption / signing). Voor de ontwikkel- en test-aansluiting worden dezelfde certificaten, endpoints en OID's gebruikt. Voor meer informatie over certificaten zie Certification Practice Statement
Er kan getest worden met een vaste reeks testpatiënten (met door VZVZ uitgegeven test-BSNs). Deze vaste reeks testpatiënten wordt door ChipSoft aangeleverd.
Ook kan de applicatie alvast de gegevens aanleveren voor de acceptatie- en productieaansluiting, zodat de applicatie beschikbaar gesteld kan gaan worden. Meer over de aansluitingen en de aan te leveren informatie staat omschreven op de pagina 'Testen'.
Om toegang te krijgen tot de ontwikkelaansluiting dient de applicatie een account aan te maken en verschillende certificaten, endpoints, en een HL7 OID aan te leveren. De certificaten worden gebruikt per aansluiting (ontwikkel&test / acceptatie / productie) en per doeleinde (client authentication / encryption / signing). Voor de ontwikkel- en test-aansluiting worden dezelfde certificaten, endpoints en OID's gebruikt. Voor meer informatie over certificaten zie Certification Practice Statement
Er kan getest worden met een vaste reeks testpatiënten (met door VZVZ uitgegeven test-BSNs). Deze vaste reeks testpatiënten wordt door ChipSoft aangeleverd.
Ook kan de applicatie alvast de gegevens aanleveren voor de acceptatie- en productieaansluiting, zodat de applicatie beschikbaar gesteld kan gaan worden. Meer over de aansluitingen en de aan te leveren informatie staat omschreven op de pagina 'Testen'.
De app beschikbaar stellen
De app beschikbaar stellen
Het beschikbaar stellen van een app voor de zorgverlener gebeurt door de app op te nemen in de ‘in-house store’ van een zorginstelling. Het beschikbaar stellen kan alleen gebeuren in opdracht van een zorginstelling. De zorginstelling sluit hiertoe een verwerkersovereenkomst af met de aanbieder van de app en geeft vervolgens ChipSoft opdracht om de app op te nemen in haar in-house store.
Een app kan alleen beschikbaar worden gesteld in de in-house store van een zorgaanbieder als het EPD (of een andere XIS toepassing) van de zorginstelling is aangesloten op Zorgplatform en de door de app benodigde gegevensdiensten en andere Zorgplatform-opties ondersteunt.
Ter voorbereiding van het beschikbaar stellen dient de app verschillende certificaten aan te leveren voor de acceptatie- en productieaansluiting voor klanten. Deze certificaten dienen in een Zip-bestand in het .cer formaat aangeleverd te worden aan ChipSoft. De gegevens over de aansluiting dienen in de Checklist aangeleverd te worden aan ChipSoft ter voorbereiding op de publicatie. Ook worden er afspraken gemaakt met betrekking tot beschikbaarheid tijdens de implementatie.
Het beschikbaar stellen van een app voor de zorgverlener gebeurt door de app op te nemen in de ‘in-house store’ van een zorginstelling. Het beschikbaar stellen kan alleen gebeuren in opdracht van een zorginstelling. De zorginstelling sluit hiertoe een verwerkersovereenkomst af met de aanbieder van de app en geeft vervolgens ChipSoft opdracht om de app op te nemen in haar in-house store.
Een app kan alleen beschikbaar worden gesteld in de in-house store van een zorgaanbieder als het EPD (of een andere XIS toepassing) van de zorginstelling is aangesloten op Zorgplatform en de door de app benodigde gegevensdiensten en andere Zorgplatform-opties ondersteunt.
Ter voorbereiding van het beschikbaar stellen dient de app verschillende certificaten aan te leveren voor de acceptatie- en productieaansluiting voor klanten. Deze certificaten dienen in een Zip-bestand in het .cer formaat aangeleverd te worden aan ChipSoft. De gegevens over de aansluiting dienen in de Checklist aangeleverd te worden aan ChipSoft ter voorbereiding op de publicatie. Ook worden er afspraken gemaakt met betrekking tot beschikbaarheid tijdens de implementatie.
Aansluitvoorwaarden
Aansluitvoorwaarden
De Aansluitvoorwaarden Zorgplatform zijn automatisch en te allen tijde van toepassing op de leverancier van een zorgapplicatie op het moment dat de applicatie gebruikmaakt van de aansluiting op Zorgplatform. De leverancier van de zorgapplicatie draagt zorg voor kennisneming van de actuele aansluitvoorwaarden. De aansluitvoorwaarden bevatten informatie over, maar is niet beperkt tot, (gegevens)beveiliging, onderhoud, wijzigingen, support, aansprakelijkheid en bereikbaarheid met betrekking op de aansluiting van zorgapplicaties.
De Aansluitvoorwaarden Zorgplatform zijn automatisch en te allen tijde van toepassing op de leverancier van een zorgapplicatie op het moment dat de applicatie gebruikmaakt van de aansluiting op Zorgplatform. De leverancier van de zorgapplicatie draagt zorg voor kennisneming van de actuele aansluitvoorwaarden. De aansluitvoorwaarden bevatten informatie over, maar is niet beperkt tot, (gegevens)beveiliging, onderhoud, wijzigingen, support, aansprakelijkheid en bereikbaarheid met betrekking op de aansluiting van zorgapplicaties.
Certification Practice Statement
Certification Practice Statement
Indien er certificaten aangevraagd, gewisseld of ingetrokken moeten worden, dient ChipSoft hiervan op de hoogte te worden gebracht. In het Certification Practice Statement staan operationele eisen met betrekking tot de levenscyclus van certificaten omschreven. Ook staan de eisen die gesteld worden aan certificaten omschreven. Indien certificaten niet voldoen aan deze eisen, worden deze door ChipSoft geweigerd en dienen er nieuwe certificaten aangeleverd te worden.
Indien er certificaten aangevraagd, gewisseld of ingetrokken moeten worden, dient ChipSoft hiervan op de hoogte te worden gebracht. In het Certification Practice Statement staan operationele eisen met betrekking tot de levenscyclus van certificaten omschreven. Ook staan de eisen die gesteld worden aan certificaten omschreven. Indien certificaten niet voldoen aan deze eisen, worden deze door ChipSoft geweigerd en dienen er nieuwe certificaten aangeleverd te worden.