Page History
...
Numbered Headings | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
ServicenDenne service er en realisering af MedCom-standarden for 'Det Gode CPR Opslag’ og findes tilgængelig på alle instanser på platformen. Der findes desuden realiseret en variant af 'Det Gode CPR Opslag’ i denne service, som beriger snitfladen med en udvidet række søgeparametre. CPR-dataData indlæses på platformen , dagligt fra mandag til fredag begge dage incl., dog med undtagelse af dagligt på hverdage. Der indlæses ikke CPR-data weekend og helligdage. Datasættet indeholder en mængde personlige oplysninger, som navn og postadresse, om borgere i Danmark. Der kan være særlige begrænsninger knyttet til adgang på data for en borger eller sundhedsfaglig person, som eksempelvis navne- og adressebeskyttelse. Denne begrænsning skal forhindre misbrug, så det eksempelvis er umuligt at få oplyst CPR-nummer alene udfra et navn eller en fødselsdato. Anvendere anbefales at aflæse værdien for elementet 'PersonInformationProtectionIndicator' i svar, som angiver om indhold i svaret er beskyttet. I tilfælde af beskyttede felter kan svaret indeholde erstatningsværdier for autentiske værdier, som eksempelvis 'ADRESSEBESKYTTET', '0000' eller '1'. Se endvidere Det Centrale Personregisters definition af CPR-nummer. Sundhedsfaglig informationFor personer med tilknyttet sundhedfaglig information, dvs. oplysninger om sikringsgruppe og tilknyttet læge eller anden sundhedsfaglig person med et ydernummer, kan denne information udlæses fra servicen. Adgang til servicenSCES er tilgængelig på alle NSP-installationer. Servicen er udstillet som en DGWS-service. Alle kald til servicen logges. WhitelistingServicen er underlagt whitelistningbegrænsning. Denne whitelistning er baseret på CVR-nummeret, der er indeholdt i anvendte ID-kort. Der skal anmodes om whitelistning hos NSP-operatøren gennem en supporthenvendelse. SikkerhedsniveauServicen kræver ID-kort af niveau 3, dvs. ID-kort udstillet med et VOCES- eller FOCES-certifikat. ReplikeringDer vil være en kort forsinkelse efter modtagelse af en ny udgave af register indtil ændringerne kan hentes ud via servicen. Grunden til dette er at data skal replikeres ud til alle NSP-installationer fra centralt hold. Der er ikke nogen garanti for hvor aktuel datagrundlaget er. Testdata og -miljøServicen er ligeledes installeret på de eksterne testmiljøer, hvor den er fungerende i testføderationen, men er underlagt samme adgangskrav som i produktion. Adgang til testmiljøer er beskrevet her. Servicens datagrundlag er baseret på data specifik generet til testmiljøerne. En beskrivelse af og adgang til testdata findes her. ServicekaldDer findes to versioner af snitfladen til denne service. Den første version, som har namespace Omstændigheder ved svarDer eksisterer en række omstændigheder, som gør at et svar kan være ændret eller begrænset. Udeladelse af adresseoplysningerServicen vil udelade adresseoplysninger om en borger når elementet 'PersonCivilRegistrationStatusCode' antager én af følgende værdier:
Erstatning for ukendt kommunekodeServicen vil erstatte værdien for en regionskode baseret på en ukendt kommunekode med regionskoden '1099'. Manglende sundhedsfaglig informationServicen vil svare med sundhedsfaglig information, der har værdier svarende til 'ukendt' i det tilfælde af, at den sundhedsfaglige association mangler i datagrundlaget. EndpointsDer findes 3 endpoints på platformen for denne service, som i det følgende beskrives:
Endpoint 'stamdata-cpr-ws/service/DetGodeCPROpslag-1.0.4'Dette endpoint er en realisering af 'Det Gode CPR Opslag'.
Operation getPersonInformationDenne operation bruges til at hente personlige informationer om en borger. Operationen vil udelade autentiske værdier for beskyttede felter i svaret. Et eksempel på en SOAP-besked i et kald til denne operation:
Det væsentlige indhold i svaret findes under SOAP Body elementet og indeholder her autentiske værdier fra et testdata-sæt:
Operation getPersonWithHealthCareInformationDenne operation bruges til at hente personlige informationer om en borger samt dennes sundhedsfaglige informationer (egen læge og sygesikring). Operationen vil udelade autentiske værdier for beskyttede felter i svaret. Dette kan gælde for både værdier i borgerens felter samt sundhedsfaglige felter. Et eksempel på en SOAP-besked i et kald til denne operation:
Det væsentlige indhold er naturligvis under SOAP body elementet. Svaret fra dette kald er følgende:
Indholdet af svaret indeholder her autentiske værdier for borgeren, som kommer fra et testdatasæt. I tilfælde af beskyttede felter kan svaret indeholde erstatningsværdier for autentiske værdier, som eksempelvis 'ADRESSEBESKYTTET', '0000' eller '1'. Svaret her indeholder erstatningsværdier, som eksempelvis 'UKENDT' eller '0000', i nogle sundhedsfaglige felter af den årsag, at de sundhedsfaglige værdier er ukendte. Dette må ikke forveksles med beskyttede felter. Endpoint 'stamdata-cpr-ws/service/StamdataPersonLookup-1.1.0'Dette endpoint er en variant af 'Det Gode CPR Opslag' Operation getPersonDetailsDenne operation giver mulighed for søgning på informationer om en borger udfra CPR-nummer, en liste af CPR-numre, fødselsdato eller navn. Der kan være særlige begrænsninger knyttet til adgang på data for en borger eller sundhedsfaglig person, som eksempelvis navne- og adressebeskyttelse, der opsummeret er følgende:
Søgning på CPR nummerSøgning om information for en borger udfra CPR-nummer:
Svaret fra dette kald er følgende:
Søgning på liste af CPR-numreSøgning på informationer om en eller flere borgere udfra en liste af CPR-numre:
Svaret fra dette kald er følgende:
Søgning på fødselsdatoSøgning på information om en eller flere borgere udfra fødselsdato:
Svaret fra dette kald er følgende:
Søgning på navnSøgning på information om en eller flere borgere udfra navn:
Svaret fra dette kald er følgende:
EksempelkodeTilhørende eksempelkode kan findes på http://svn.nspop.dk/public/guides/latest, specielt under modulet
Eksemplerne anvender følgende FOCES-certifikat:
CVR-nummer indeholdt i det benyttede certifikat er whitelistet på testmiljøerne. |