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 samthæ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 Filerne leveres via Serviceplatformens SFTP server. Dette kræver at leverandøren opretter et it-system med SFTP tilvalgt og med filudvekslingstypen simpel tilvalgt. Serviceaftalen til CPR abonnements servicen skal indgåes med dette it-system. Information omkring anvendelse af Serviceplatformens SFTP server kan findes på: dning%20til%20serviceplatformens%20sftp%20service.pdf 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.26$ $Date: 13 Nov 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 it-system med SFTP tilvalgt som filer skal leveres til: Serviceplatformen skal bruge det System UUID som it-systemet er blevet tildelt for at kunne levere filer. 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 Abonnement. Information om hvilke personnumre bør sættes i abonnement kan bl.a. hentes fra Serviceplatformen ved brug af en eller 2 Se serviceplatformen.dk under FAQ og kontakt af 5 SSE/12746/NOT/0203$Revision: 1.26$ $Date: 13 Nov 2015$

3 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. Operationerne addnofiltersubscription og 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. 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.26$ $Date: 13 Nov 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.26$ $Date: 13 Nov 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. Step Beskrivelse Ansvarlig 1 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 Den/de pågældende Kommune/kommuner skal godkende serviceaftalen via selvbetjening på Serviceplatformen. 3 Anmod om NOT0314 CPR Abonnementsadgang hos Helpdesk (helpdesk@serviceplatformen.dk) 4 Udfyld blanketten, og send denne til Helpdesk (helpdesk@serviceplatformen.dk) 5 Når konfigurationen af CPR abonnementet er gennemført på Serviceplatformen, vil I få en mail fra Helpdesk, om at jeres abonnement er klar til ibrugtagning. Kommune KOMBIT support 5 af 5 SSE/12746/NOT/0203$Revision: 1.26$ $Date: 13 Nov 2015$