A-kasse bestandskørsel via webservices Styrelsen for Arbejdsmarked og Rekruttering Version 1.0 Dato: 23. juni 2014 Release: Forfatter: STAR: Kirsten Vestergaard, Rune Gram-Madsen, Anders Ellegaard Dahl Visma: Peter Tilsted
Dokumentversioner Version Dato Initialer Afsnit Ændringer 0.1 25/3-2014 RGM Alle Første version 0.2 27/3-2014 AEH Alle Review samt tilføjelse af afsnit 1.1.3 0,3 30/3-2014 KIV Alle Review 0.4 8/4-2014 RGM Alle Gennemskrevet efter møde 0.5 29/4-2014 RGM Alle Indskrevet mulighed for asynkrone bestandskørsler 0.5 30/4-2014 AEH Alle Review 0.6 30/4-2014 RGM Alle Den fulde bestandskørsel udgår 0.7 1/5-2014 AEH Alle Review og gennemskrivning samt tilføjet afsnit 2.1 0.8 13/5-2014 AEH Alle Afsnit 2.0 - krav om løbende bestandskørsler 0.8.1 13/6-2014 RGM Alle 0.8.2 18/6-2014 PTI 2 Leverancebeskrivelse 1.0 23/6-2014 AEH Ophøjet til version 1.0 A-kasse bestandskørsel via webservices Side 2 af 10
Indholdsfortegnelse Dokumentversioner... 2 1 Baggrund og indhold... 4 2 Løbende medlemsbestandskørsel... 5 2.1 Forsat onlineindberetning af medlemstilgang eller medlemsadgang... 5 2.2 Teknisk... 6 2.3 Snitflade mellem KMD og A-kasserne... 6 3 Løbende medlemsopdatering... 9 4 Metrikker for medlemsbestand... 10 A-kasse bestandskørsel via webservices Side 3 af 10
1 Baggrund og indhold Denne specifikation giver en beskrivelse af hvordan: 1) hver A-kasse selvstændigt kan iværksætte egen bestandskørsel for at sikre, at A- kassens medlemsregister og det tilsvarende register i DFDG er (rimeligt) synkrone. 2) medlemsbestanden i DFDG fremadrettet kan holdes løbende opdateret af a-kasserne. Det er forretningsmæssigt vigtigt at medlemsregistret i DFDG holdes korrekt opdateret da det både anvendes ved kommunikation mellem kommune og a-kasse samt mellem a-kasser i forbindelse med medlemsoverflytning. Der beskrives følgende strategier for synkronisering af medlemsbestanden: 1) Løbende bestandskørsel 2) Løbende medlemsopdatering 3) Metrikker for medlemsbestand Ønsket er at det gøres simplere at køre en bestandskørsel, bl.a. ved at a-kasserne selvstændigt kan iværksætte synkronisering af egen medlemsbestand og ved at den løbende registrering af medlemstilgang og afgang gøres mere smidig. Dette dokument er en afløser for tidligere specifikationer af bestandskørsler udført via den filbaserede a-kassemotor. A-kasse bestandskørsel via webservices Side 4 af 10
2 Løbende medlemsbestandskørsel Med den løbende medlemsbestandskørsel får den enkelte a-kasse mulighed for selv at initiere synkronisering af egen medlemsbestand i DFDG. A-kasserne gives adgang til udtræk af den fulde medlemsbestand fra DFDG. Forretningsgangen vil være: 1) A-kassen henter bestandsfilen via SFTP (ComsService hos KMD (tidligere AT&T postkassen)), se format beskrevet nedenfor. 2) A-kassen vurderer om der er behov for at gennemføre en medlemssynkronisering (Medlemsbestanden leveres i en csv-fil hvor det fremgår af filnavnet hvornår udtrækket er dannet, denne oplysning kan genbruges i Akassens kontrol af eget register). 3) For medlemmer som ikke er i bestanden fra DFDG indsendes medlemstilgang med oprindelig dato, hvis oprindelig dato ikke kan anvendes grundet overlap med efterfølgende hændelser, foretages registreringen med optagelsesdato dagen efter den forrige a-kasses optagelsesdato. 4) For borgere som er med i bestanden fra DFDG men ikke er medlem af A-kassen gøres følgende: a. For medlemmer der har forladt a-kassen uden at være overflyttet til en ny meldes medlemsafgang til DFDG med oprindelig dato b. For medlemmer som er overflyttet til en ny a-kasse må der ikke sendes medlemsafgang til DFDG, med mindre det er mere end 30 dage (fra a- kassens registreringstidspunkt for udmeldelse) siden, overflytningen angiveligt fandt sted, og borger fortsat står som medlem af fraflytter a- kassen. Medlemsafgangen indmeldes med oprindelig dato. 5) Hvis der er uoverensstemmelse med den Forsikringsgrad eller Dato for dagpengeret, der er registreret i DFDG medlemsregister kan medlemsregistreringen gentages med de korrekte oplysninger. Det er et krav, at alle A-kasser gennemfører ovennævnte procedure ultimo september 2014 (trin 1-5). Herefter vil det være et krav at den enkelte a-kasse som minimum gennemføre en medlemssynkronisering hvert kvartal (trin 1-5). 2.1 Forsat onlineindberetning af medlemstilgang eller medlemsadgang A-kasserne skal som hidtil foretage onlineindberetning af medlemstilgang eller medlemsafgang via webservicen UnemploymentFundMembershipService. For medlemstilgang (MT) gælder det, at A-kassen skal registrer hændelsen, når denne optager et nyt medlem. Hvis medlemmet i forvejen er medlem af en anden A-kasse, vil denne A-kasse modtage en WSRM notifikation om medlemsafgang. Hvis medlemmet i forvejen var tilmeldt i DFDG som dagpengemodtager, vil den afgivende A-kasse modtage en WSRM-notifikation om medlemsafgang samt en WSRM notifikation om afmelding. Den registrerende A-kasse vil i denne situation modtage en WSRM notifikation om hændelser som ligger på og efter dato for medlemstilgang, samt notifikation om tilmelding. For medlemsafgang (MA) gælder det, at A-kassen registrerer hændelsen, når et medlem afslutter et medlemskab hos A-kassen uden umiddelbart at melde sig ind i en ny A-kasse. A-kasse bestandskørsel via webservices Side 5 af 10
I forbindelse med et a-kasseskift er det ikke tilladt for den gamle A-kasse at initiere a- kasseskift vha. registrering af en MA-hændelse via UnemploymentFundMembershipService. Det er den nye A-kasse, der skal initiere a-kasseskift vha. registrering af en MT-hændelse. Hvis denne procedure ikke følges, kan det få betydning for beregning af personens dagpenge. 2.2 Teknisk Medlemsbestanden udtrækkes ugentligt (fredag) og kopieres til SFTP postkassen, så hver A- kasse får adgang til egen medlemsbestand. Medlemsregistreringen foretages af A-kassen via følgende eksisterende services (se også afsnit 3): UnemploymentFundMembershipService.MembershipRegistration(..) UnemploymentFundMembershipService.MembershipCancellation(..) For dokumentation af servicen og de konkrete metoder (MembershipRegistration og MembershipCancellation) henvises til http://starwswiki.amstest.dk/ Medlemsbestanden afhentes af KMD. Der benyttes en leverancefolder på det SAN, der er tilknyttet SAS-serveren BITAPP203D. Filerne skrives til E:\Eksterne_Leverancer\Bestandkoersel. Navngivningen af filerne er som følger (se også følgende afsnit): AKASNNN_ÅÅÅÅUU_BESTAND_ ÅÅÅÅMMDDTTMMSS.txt NNN A-kasse hovednummer med foranstillet 0 ÅÅÅÅUU angiver ugenummer for leverancen BESTAND Identificerer indholdet, Bestandkørsel ÅÅÅÅMMDDTTMMSS unikt leverance-timestamp KMD afhenter data med KFSLAN, når datafilerne for en given uge er leveret. Efter leverancen er gennemført sletter STAR folderens indhold. Leverancen arkiveres af STAR. 2.3 Snitflade mellem KMD og A-kasserne A-kasse bestandskørsel via webservices Side 6 af 10
Til leverancen benyttes de eksisterende ComsService-postkasser, der administreres af KMD. Filerne beriges ikke af KMD. Hver A-kasse modtager data i \FromKMD\ Bestandkoersel. Filens struktur er givet ved: 1 startrække Et antal datarækker 1 Slutrække For filens formater gælder at: Rækkelængden er fast 38 karakterer Tegnsættet er ISO8559-1 Numeriske felter højrestilles med foranstillede nuller Alfanumeriske felter venstrestilles med efterfølgende blanke. Navngivningen for en leverance til en specifik A-kasse i en måned er som følger: AKASNNN_ÅÅÅÅUU_BESTAND_ ÅÅÅÅMMDDTTMMSS.txt NNN A-kasse hovednummer med foranstillet 0 ÅÅÅÅUU angiver ugenummer for leverancen BESTAND Identificerer indholdet, Bestandkørsel ÅÅÅÅMMDDTTMMSS unikt leverance-timestamp Det vil sige at en leverance til Ledernes A-kasse for januar 2014, der er leveret til leverancefolderen den 2. januar kl. 23.52:12 navngives som: AKAS067_201401_BESTAND_20140102235212.txt En genleverance til samme A-kasse fra den 4. januar 16.16:21 vil adskille sig på timestampdelen af filnavnet: AKAS067_201401_ BESTAND_20140102161621.txt Der leveres ikke filer for A-kassenumre, der ikke er knyttet borgere til. En leverance leveres som: Tabel 1. Startrække til A-kasserne Feltnummer Betegnelse Type Indhold 1 Filler N(10) 0000000000 2 Kørselsdato N(8) ÅÅÅÅMMDD A-kasse bestandskørsel via webservices Side 7 af 10
3 A- kassenummer N(3) 4 Reserveret AN(89) Blanke A-kassens hovednummer Tabel 2. Datarækker til A-kasserne Kolonnenavn Type Beskrivelse PersonCivilRegistrationIdentifier Char(10) Personnummer (PNR) UnemploymentFundCode Int A-kasse nummer på den A-kasse hvor borger er tilknyttet. Medsendes kun til kontrol. Gyldige værdier kan hentes via GetUnemploymentFundList metoden i CodeList servicen. UnemploymentFundMembershipRegistrationDate Date (yyyy-mm-dd) Datoen hvor personen er registreret som medlem af A- kassen. UnemploymentInsuranceCategoryTypeIdentifier Int Forsikringsgrad i A-kassen. Gyldige værdier kan hentes via GetUnemploymentInsuranceCategoryTypeIdentifierCo delist metoden i CodeList servicen. UnemploymentBenefitRigthsStartDate Date (yyyy-mm-dd) Startdato for dagpengeret. Oplyses hvis kendt i A- kassen, skal oplyses for Dimittend Tabel 3. Slutrække til A-kasserne Feltnummer Betegnelse Type Indhold 1 Filler N(10) 9999999999 2 Antal rækker N(10) Antal rækker inklusive start- og slutrækker med foranstillede nuller. 3 Reserveret AN(90) Blanke A-kasse bestandskørsel via webservices Side 8 af 10
3 Løbende medlemsopdatering I dag registrerer A-kasserne medlemstilgang og medlemsafgang i DFDG. Hvis medlemmet skifter til en anden A-kasse, må den afgående A-kasse ikke indsende medlemsafgang, da borger i dette tilfælde vil risikere at blive afmeldt, hvis denne står som tilmeldt. Dette virker rimeligt, men giver det problem, at nogle borgere ender med at stå som medlem af den afgivne kasse, hvis de beslutter ikke at blive medlem af en ny kasse. Derfor ændres forretningsgangen ud fra følgende: 1) Når et medlem optages i en A-kasse, registres medlemstilgang via webservicen: UnemploymentFundMembershipService.MembershipRegistration(..) 2) Når et medlem forlader A-kassen, registreres medlemsafgangen via webservicen: UnemploymentFundMembershipService.MembershipCancellation(..) a. For medlemmer, der har forladt A-kassen uden at være overflyttet til en ny, meldes medlemsafgang med det samme til DFDG med dato for udmeldelse samt gyldig årsagskode: i. Slettet på grund af kontingentrestance ii. Slettet på grund af svig over for A-kassen iii. Slettet af andre årsager iv. Udmeldt v. Flyttet til udlandet vi. Uoplyst vii. Udmeldt grundet død viii. Udmeldt i forbindelse med bestandskørsel b. For medlemmer, som er overflyttet til en ny A-kasse, må der ikke sendes medlemsafgang til DFDG med mindre, det er mere end 30 dage siden overflytningen angiveligt fandt sted, og borger fortsat står som medlem af fraflytter A-kassen. Medlemsafgangen indmeldes med oprindelige dato for udmeldelse samt en af de gyldige årsagskoder. 3) Hvis der er uoverensstemmelse med den Forsikringsgrad eller Dato for dagpengeret, der er registreret i DFDG medlemsregister kan medlemsregistreringen gentages med de korrekte oplysninger. A-kasse bestandskørsel via webservices Side 9 af 10
4 Metrikker for medlemsbestand Indberetning af de nuværende metrikker enten via webservice eller via Arbejdsmarkedsportalen udgår. I stedet vil STAR generere et ugentligt udtræk af hver A-kasses medlemsbestand som placeres på ComsService hos KMD. A-kassen kan sammenligne denne bestand med eget medlemsregister og initiere en løbende medlemsopdatering. A-kasse bestandskørsel via webservices Side 10 af 10