Vejledning til leverandører ifm. CPR-abonnement Dette notat beskriver de forhold, man som leverandør og kommune skal være opmærksom på, når kommunens it-system skal modtage CPR-data i abonnement fra Serviceplatformen. Via Serviceplatformen kan man abonnere på persondata fra CPR-registret, og der leveres persondata med tilhørende 99 års historik. Ændringer af CPR-data for personer videresendes fra Serviceplatformen til et personabonnement for et kommunalt it-system i én deltafil i takt med, at Serviceplatformen modtager data fra CPR-kontoret, forventet 1 gang daglig på hverdage. Forud for modtagelsen udspecificerer kommunen, hvilke personer kommunens it-system skal modtagen persondata for. Det er kommunens ansvar at sikre, at der foreligger et sagligt behov for modtagelse af CPR-data for de personer som er specficeret. Ligeledes er det kommunens ansvar at sikre, at kommunens it-system ikke modtager CPR-data for personer, hvor der ikke længere foreligger et sagligt behov. Sletning af CPR-numre fra CPR-abonnementet kan ske på to måder og er afhængig af den intielle opsætning af abonnementet a) Automatisk fjernelse: vælges abonnementet med filtre som alder, kommunekode, hændelseskode vil it-systemet ikke lænngere modtage CPR-data for personer, der ikke længere opfylder filteret. Fx ved aldersfilter under 18 år vil it-systemet ikke længere modtage CPr-data for personer, der fylder 18 år. Kommunen og itleverandøren skal dermed manuelt fjerne personer, hvor der ikke længere foreligger et sagligt behov. b) Manuel fjernelse: vælges at konkrete CPR-numre er sat i abonnenment skal kommunens it-system efter kommunens anmodning kalde Serviceplatformen med det specifikke CPRnummer, som ønskes fjernet fra abonnementet. I forbindelse med opsætning af CPR-abonnement kan de initielle udgaver af persondata hentes fra Serviceplatformen ved brug af en eller flere opslagsservices mod Serviceplatformens CPRreplika, fx servicen STAM+ eller Person stamdata (lokal). Da der kun anvendes et filtreret udtræk skal Leverandøren efter aftale med kommunen angive én eller flere af følgende filtre: specifikke CPRnumre, aldersfilter, kommunekoder samt hændelsesfilter for de personer man ønsker at modtage ændringsudtræk for. For detaljer vedrørende filtre se afsnit Detaljer vedrørende filter operationer. Serviceplatformen udtynder så CPR-kontorets ændringsudtræk og sender de resulterende filer til it-systemet. Filerne er altså i samme format og indhold som CPRs ændringsudtræk blot med CPR-data for de udspecificerede personer. CPR-numre og filtre angives via Serviceplatformens CPR Abonnement-service. For en generel beskrivelse af fil- og dataformat, leverancetidspunkter osv. henvises til CPR-kontorets hjemmeside: https://cpr.dk/kunder/offentligemyndigheder/udtraek/ For liste af CPR hændelses koder se beskrivelse hos CPR; Søren Frichs Vej 39 8000 Aarhus C Denmark Tel +45 8943 2000 Fax +45 8943 2020 CVR-nr. 78 83 44 12 www.systematic.com 1 af 6 SSE/12746/NOT/0203$Revision: 1.46$ $Date: 31 Aug 2016$
https://cpr.dk/media/150192/udtr_ksvejledning_offentlige_brugere_versi on_10.pdf, side 65. Efter det er blevet muligt at have flere CPR abonnementer for det samme it-system er navngivning af de resulterende filer ændret til; <CPRINFO1>_<KOMCVR>_<ServiceAgreementUUID>_CPRABONNEMENT. <CPRINFO2> Eksempelvis: d160602_11259979_bbc8334e-0e57-11e3-a336-5ad82b4d0328_cprabonnement.l466201 I forhold til eksisterende cpr abonnementer, hvor der kun kunne være et CPR abonnement per it-system er navngivning af de resulterende uændret. Dataleverancer Data videresendes fra Serviceplatformen i takt med at ændringsudtræk modtages fra CPR-kontoret. Ændringsudtræk sendes fra CPR-kontoret på hverdage 1, hvilket betyder at man som modtager kan forvente at modtage filer fra Serviceplatformen med ændrede persondata dagligt. Data leveres i tegnsættet ISO 8859-1. Filerne leveres til kommunens it-system via it-systemets SFTP mappe på Serviceplatformen. Udvidet information om anvendelse af Serviceplatformens SFTP server kan findes på: https://www.serviceplatformen.dk/administration/doc/usm0005%20vejle dning%20til%20serviceplatformens%20sftp%20service.pdf Oprettelse af CPR-abonnement Forudsætning for modtagelsen af CPR-data er, at kommunens it-system er registreret på Serviceplatformen med SFTP tilvalgt, og kommunen har indgået en serviceaftale, der indeholder servicen CPR-abonnement. Trin for oprettelse af CPR-abonnementet er følgende: 1) Leverandøren registerer kommunens it-system på Servieplatformen og tilvælger SFTP og filudvekslingstype simpel. Registreringen foregår på sædvanlig vis via leverandørens selvbetjening på Serviceplatformen. Når registreringen er gennemført opretter Serviceplatformen automatisk en SFTP tilslutning for it-systemet, som sammen med andre SFTP tilslutninger vil fremgå i oversigten over Serviceplatformens samlede SFTP tilslutninger. 2) Leverandøren opretter an anmodning om en serviceaftale for itsystemet som indeholder servicen CPR Abonnement. Anmodning 1 Hverdage mandag til fredag, undtagen 5/6, 24/12 og 31/12 (https://cpr.dk/kunder/offentlige-myndigheder/cpr-services/standardvilkaar-foroffentlige-myndigheders-adgang-til-cpr/) 2 af 6 SSE/12746/NOT/0203$Revision: 1.46$ $Date: 31 Aug 2016$
foregår på sædvanlig vis via leverandørens Selvbetjening på Serviceplatformen. 3) Kommunen modtager en e-mail fra Serviceplatformen, om at der foreligger en ny serviceaftaleanmodning til godkendelse. Kommunen kan herefter godkende serviceaftalen. Godkendelse af serviceaftalen foregår på sædvanlig vis via kommunens selvbetjening på Serviceplatformen. 4) Når kommune har godkendt serviceaftalen kan leverandøren kalde webservicen CPR Abonnement med det eller de filtre, der skal indgå i it-systemets abonnement. Ligeledes kan leverandøren kalde ind med specifikke CPR-numre, for at tilføje dem til abonnementet. Abonnementet udgøre et positiv-filter, dvs. at it-systemet modtager udelukkende CPR-data for de personer, som indgår i abonnementet. Se Servicekataloget 2 for en nærmere beskrivelse af webservicen CPR Abonnement samt øvrige webservices udstillet på Serviceplatformen. Detaljer vedrørende filtre AddPNRSubscriptiontilføjer et personnummer til abonnementet identificeret ved serviceaftalens id (ServiceAgreementUUID) i kaldets invocation context. RemovePNRSubscription fjerner et personnummer fra abonnentens liste. Med dette filter sættes og fjernes det enkelte personnummer. Det er kommunen, som vurderer hvilke CPR-numre, der skal sættes i abonnementet. Information om hvilke personnumre der kunne være relevant at sætte i abonnement kan bl.a. hentes fra Serviceplatformen ved brug af en eller flere opslagsservices mod Serviceplatformens CPRreplika, fx servicenene STAM+ eller Person stamdata (lokal). AddAgeRangeSubscription/RemoveAgeRangeSubscription tilføjer hhv. fjerner et aldersinterval fra abonnementet identificeret ved serviceaftalens id (ServiceAgreementUUID) i kaldets invocation context. Et aldersinterval betyder, at ændringer til persondata for personer indenfor aldersintervallet vil blive sendt med i de CPR-data der afleveres. Med dette filter modtages CPR-data for eksempelvis alle personer under 18 år eller alle personer over 65 år i abonnement. AddMunicipalityCodeSubscription/RemoveMunicipalityCodeSubscription tilføjer hhv. fjerner kommunekoden i abonnementet. Ændringer i CPRdata for personer, der bor i den angivne kommune vil blive modtaget. Bemærk, at dette også inkluderer data for personer, der flytter fra en kommune. Det er muligt at sætte flere kommunekoder i samme abonnement, når kommunen vurderer, at der foreligger et sagligt behov for at modtage ændringer for personer bosat i anden kommune. Med dette filter modtages alle ændringer for personer, som er bosat inden for en given kommunekode herunder tilflyttere. AddChangeCodeSubscription/RemoveChangeCodeSubscription tilføjer hhv. fjerner hændelseskoder for en abonnent. Kun de personer, hvor der er ændringer ift. den/de angivne hændelseskoder, vil blive inkluderet i abonnementet. Med dette filter modtages alle CPR-data for personer, 2 https://www.serviceplatformen.dk/administration/serviceoverview 3 af 6 SSE/12746/NOT/0203$Revision: 1.46$ $Date: 31 Aug 2016$
hvor der er sket ændringer inden for valgte hændelseskoden fx for alle dødsfald eller navneændringer. addnofiltersubscription/removenofiltersubscription tilføjer hhv. fjerner et ufiltreret abonnoment på alle daglige persondata ændringer fra CPR-kontoret. Dvs. at det fulde persondata ændringsudtræk Serviceplatformen dagligt modtager fra CPR-kontoret videresendes ufiltreret. RemoveAll fjerner alle filtre af den angivne type for en abonnement. Med denne operation kan leverandøren eksempelvis fjerne en hændelseskode eller et aldersinterval GetAllFilters lister alle aktuelle filtre for et abonnement, dvs. alle abonnementets tilføjede aldersintervaller (fra AddAgeRangeSubscription), kommunekoder (fra AddMunicipalityCodeSubscription) og hændelseskoder (fra AddChangeCodeSubscription) samt listen af personnumre der specifikt er sat i abonnement (fra AddPNRSubscription). Ved hjælp af dette kan leverandøren og kommuen få et samlet overblik over indholdet i abonnementet, og hvilke ændringer af CPR-data fra CPR-registret for hvilke personer it-systemet kan forvente at modtage. Nedenfor ses en oversigt over de hændelseskoder, som kan benyttes ifm. CPR Abonnement. Bemærk, at det kun er de til enhver tid gældende hændelseskoder fra CPR registeret, som understøttes af CPR Abonnement servicen. 4 af 6 SSE/12746/NOT/0203$Revision: 1.46$ $Date: 31 Aug 2016$
5 af 6 SSE/12746/NOT/0203$Revision: 1.46$ $Date: 31 Aug 2016$
Quick guide Nedenfor er en sammenfatning af alle trin der skal gennemføres for at tage CPR Abonnement servicen i anvendelse. Det er desuden angivet, hvem der har det overordnede ansvar for opgaven. Step Beskrivelse Ansvarlig 1 Register it-systemet med SFTP, filudvekslingstype simpel. Anmod om en serviceaftale hos en/flere kommune/kommuner med servicen CPR abonnement via selvbetjening på Serviceplatformen. Bemærk det registrerede it-system aftalen oprettes med skal have SFTP tilvalgt med filudvekslingtypen simpel. 2 Anmodning om en serviceaftale med servicen CPR Abonnement Leverandør Leverandør 3 Godkend serviceaftalen. Kommune 4 Opsæt abonnementet ved brug af et eller filre filtre 5 Benyt operationen GetAllFilters for at få et samlet overblik over alle aktuelle filtre for abonnement. Kontroler korrekthed sammen med kommunen Leverandør Leverandør/Kommune 6 af 6 SSE/12746/NOT/0203$Revision: 1.46$ $Date: 31 Aug 2016$