Vejledning til leverandører ifm. CPR-abonnement

Transkript

1 Vejledning til leverandører ifm. CPR-abonnement Dette notat beskriver de forhold som man som leverandør og kommune skal være opmærksom på når man ønsker at 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. Persondata videresendes fra Serviceplatformen som en filtreret udgave af ændringsudtræk i én deltafil i takt med at Serviceplatformen modtager data fra CPR-kontoret, forventet 1 gang daglig på hverdage. en skal specificere de personer man ønsker at modtage persondata for. Initielle udgaver af persondata hentes fra Serviceplatformen ved brug af en eller flere opslagsservices mod Serviceplatformens CPRreplika, fx servicen STAM+ eller Person stamdata (lokal). Der er som nævnt tale om et filtreret udtræk, dvs. en skal angive én eller flere af følgende filtre; CPR-numre, 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 data for færre personer. CPRnumre og filtre angives via Serviceplatformens CPR Abonnement-service. For en generel beskrivelse af fil- og dataformat, leverancetidspunkter osv. henvises til CPR-kontorets hjemmeside: For liste af CPR hændelses koder se beskrivelse hos CPR; on_10.pdf, side 65. 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 Frem til udgangen af 2015 sender Serviceplatformen filerne til kommunens SFTP-server. Herefter forventes filerne blive leveret til Serviceplatformens SFTP-server til afhentning for it-systemet. en skal oplyse akkreditiver til SFTP-server samt netværksmæssige informationer. Samtidig skal en sammen med kommunen sikre, at der åbnes i eventuelle firewalls for at Serviceplatformen kan levere data. 1 Hverdage mandag til fredag, undtagen 5/6, 24/12 og 31/12 ( Søren Frichs Vej Aarhus C Denmark Tel Fax CVR-nr af 5 SSE/12746/NOT/0203$Revision: 1.19$ $Date: 08 Sep 2015$

2 Oprettelse af CPR-abonnement Når man som leverandør/kommune ønsker at modtage CPR-data som deltafiler via CPR Abonnement servicen henvender man sig til Serviceplatformens helpdesk 2. Herefter modtager man en blanket (NOT0314) som udfyldes med bl.a. nedenstående informationer: Information om en (navn, CVR-nummer mv.) Information om leverandørens SFTP-server: IP-adresse, postnummer, akkreditiver (brugernavn/password), mappe, information om kontaktperson, eventuelle faste servicevinduer osv. SFTP-serveren skal tillade adgang fra Serviceplatformens eksterne IPadresse. Hvis en i den sammenhæng har behov for at ændre sin netværkskonfigurering, fx foretage åbninger i sin firewall oplyses Serviceplatformens aktuelle eksterne IP-adresse af Serviceplatformens helpdesk. en skal anmode kommunerne om indgåelse af serviceaftale(r) for de webservices der skal kaldes, typisk CPR Abonnement og Person stamdata. Serviceaftalerne indgås med den eller de kommuner der er aftalepart. Serviceaftalerne indgås på sædvanlig vis via Serviceplatformens Selvbetjening. NB. Skal flere kommuner på samme it-system benytte CPR Abonnement, skal du registrere ét it-system pr. kommune (navngiv fx X-system Y-kommune ) og indgå serviceaftaler med pågældende kommune på det pågældende system. Helpdesk informerer en når it-systemet er oprettet i Serviceplatformen som CPR-abonnent. Først herefter giver det mening at lægge personnumre samt eventuelt filter ind ved kald til CPR Abonnement servicen. en kalder webservicen CPR Abonnement for hver person og/eller filter der skal indgå i vedkommendes abonnementslisten. Abonnementslisten udgøre et positiv-filter, dvs. at en modtager udelukkende data for de personer, som indgår i abonnementet. NB. Skal flere kommuner på samme it-system benytte CPR Abonnement, skal du som ovenfor beskrevet registrere ét it-system pr. kommune (fx X-system Y- kommune ). Når Helpdesk har informeret om, at it-systemet er oprettet i Serviceplatformen som CPR-abonnement kan den pågældende kommunes personnumre lægges ind. Se Servicekataloget 3 for en nærmere beskrivelse af webservicen CPR Abonnement samt øvrige webservices udstillet på Serviceplatformen. Detaljer vedrørende filter operationer Operationen AddPNRSubscription tilføjer et personnummer til abonnementslisten for en abonnent identificeret ved it-systemets id (UserSystemUUID) i kaldets invocation context. RemovePNRSubscription fjerner et personnummer fra abonnentens liste. Med denne operation sættes dermed det enkelte personnummer i 2 Se serviceplatformen.dk under FAQ og kontakt af 5 SSE/12746/NOT/0203$Revision: 1.19$ $Date: 08 Sep 2015$

3 Abonnement. Information om hvilke personnumre bør sættes 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). Operationerne AddAgeRangeSubscription og RemoveAgeRangeSubscription tilføjer hhv. fjerner et aldersinterval for en abonnent it-systemets id (UserSystemUUID) 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 denne operation modtager man alle ændringer eksempelvis for alle personer under 18 år eller alle personer over 65 år i abonnement, Operationerne AddMunicipalityCodeSubscription og RemoveMunicipalityCodeSubscription tilføjer hhv. fjerner kommunekoder for abonnementslisten. Ændringer i persondata for personer der bor i den angivne kommune vil blive sendt med i de filtrerede persondata. Bemærk at dette ikke inkluderer data for personer der flytter fra en kommune, da de så har deres nye kommunekode. Det er muligt at sætte flere kommunekoder i samme abonnement så længe den kommunekoden er relevant for den kommunale sagsbehandling for pågældende it-system. Med denne operation modtager man alle ændringer inden for en given kommunekode herunder tilflyttere. Operationerne AddChangeCodeSubscription og RemoveChangeCodeSubscription tilføjer hhv. fjerner hændelseskoder for en abonnent. Persondata for ændringer markeret med den / de angivne hændelseskoder vil blive inkluderet i de filtrerede CPR data. Med denne operation modtages alle ændringer når der sker ændringer inden for valgte hændelseskoden fx for alle dødsfald eller navneændringer. Den nuværende oversigt over hændelseskoder består af nedenstående. Bemærk, at det kun er de til enhver tid gældende hændelseskoder fra CPR registeret som understøttes 3 af 5 SSE/12746/NOT/0203$Revision: 1.19$ $Date: 08 Sep 2015$

4 Operationen RemoveAll fjerner alle filtre af den angivne type for en abonnement Med denne operation kan man eksempelvis fjerne en hændelseskode eller et aldersinterval Operationen GetAllFilters lister alle aktuelle filtre for et abonnement, dvs. alle abonnementets tilføjede (og ikke siden fjernede) aldersintervaller (fra AddAgeRangeSubscription), kommunekoder (fra AddMunicipalityCodeSubscription) og hændelseskoder (fra AddChangeCodeSubscription), samt listen af personnumre der eksplicit er sat i abonnement (fra AddPNRSubscription). Med denne operation kan it-systemet få et samlet overblik over indholdet i vedkommendes abonnement og hvilke ændringer it-systemet kan forvente at modtage. 4 af 5 SSE/12746/NOT/0203$Revision: 1.19$ $Date: 08 Sep 2015$

5 Quick guide Nedenfor er en sammenfatning af alle de 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. Forudsætninger Før Step 4, kan udføres kræves det at der er opsat en SFTP server. Det er vigtigt at denne FTP server er en SFTP server, da data der overføres er fortrolige data. Step Beskrivelse Ansvarlig 1 Anmod om en serviceaftale hos en/flere kommune/kommuner med servicen CPR abonnement via selvbetjening på Serviceplatformen 2 Den/de pågældende Kommune/kommuner skal godkende serviceaftalen via selvbetjening på Serviceplatformen. 3 Anmod om NOT0314 CPR Abonnementsadgang hos Helpdesk ([email protected]) 4 Udfyld blanketten, og send denne til Helpdesk ([email protected]) 5 I vil herefter blive kontaktet af en medarbejder fra KOMBIT support, for udveksling af password til jeres SFTP server. 6 Når disse konfigurationer er gennemført på Serviceplatformen, vil I få en mail fra Helpdesk, om at jeres abonnement er klar til ibrugtagning. Kommune KOMBIT support KOMBIT support 5 af 5 SSE/12746/NOT/0203$Revision: 1.19$ $Date: 08 Sep 2015$