Forretningsbeskrivelse

Denne service gør det muligt at hente og gemme oplysninger om den enkelte a-kasse og de a-kasse afdelingskontorer, der er knyttet til a-kassen samt deres indbyrdes relation.

Det er STAR (Systemforvaltningen), der på bestilling opretter nye a-kasser. Dette skyldes, at oprettelsen skal ske synkront i de forskellige it-systemer.

Oprettelse og opdatering af (hoved) a-kasse

Bestilling indgives via a-kassen eller a-kassens egen leverandør til Systemforvaltningen. Bestillingen skal indeholde oplysninger om:

• A-kasse kode (efter aftale med Tilsynskontoret i STAR)
• Navn på a-kassen

Nedestående oplysninger kan a-kasse selv indberette, når STAR har oprettet (hoved) a-kassen: 

• Adresse
• CVR
• p-nummer
• telefon
• åbningstider
• telefontider
• evt. email eller website
• Logo
• Dybe links

Hvis a-kassen ikke selv opretter disse, skal de indberettes til STAR (via sag til Systemforvaltningen).

Oprettelse og nedlæggelse af et afdelingskontor

Afdelingskontorer kan oprettes og nedlægges uden forudgående varsling. A-kassen kan selv oprette hhv. nedlægge afdelingskontorer. Der dannes WSB om oprettelsen hhv. nedlæggelsen.

Medlemmer med åbne medlemskaber tilknyttet et afdelingskontor skal inden lukning af afdelingskontorret være flyttet af a-kassen til et blivende/overlevende a-kasse afdelingskontor.

Medlemmer som a-kassen ikke har flyttet til et blivende/overlevende afdelingskontor, inden lukning af et afdelingskontor, vil blive flyttet automatisk fra det pågældende afdelingskontor til hoved a-kassen (afdelingskontor xx0000). Flytningen vil ske pr. dags dato.

Udsendelse af WSB

Der sendes ikke WSB på a-kasse oprettelse af hoved a-kasser.

Der dannes WSB på oprettelse og nedlæggelse af a-kasse afdelingskontorer.

Metoder

UpdateAkasseOplysninger (PUT /v1/Akasse/Afkasse/{akassekode})

Denne metode benyttes til at gemme ændringer til a-kassens adresse, kontaktoplysninger, åbningstider og/eller telefontider.

Forretningsregler

• Da A-kassen navn anvendes i forskellige sammenehænge skal det aftales med STAR hvornår en navneændring skal ske.
• Et a-kasse må kun opdatere deres egen information.

Bemærk: Ved update at det kun data f.eks. åbningstider og telefontidsintervaller indeholdt i det aktuelle i request, der gemmes. Tidligere gemte intervaller og dage, der ikke er med i de pågældende Update-requested, slettes. Hvis telefonnummer og webadresse ikke er med i  det aktuelle request, slettes disse oplysninger også. 

Hvis man vil opdatere en enkelt dag, så er det vigtigt, at man også medsender al øvrig info i kaldet - ellers forsvinder de øvrige dages åbningstider og telefontider samt a-kassens telefonnummer og webadresse.

Hjælpe til udfyldning

Hvis et a-kasse holder lukket en dag, understøttes dette ved at sende et givet ugedag element med aabningstidspunkt og lukketidspunkt felter sat til "00:00" eller ved at undlade at udfylde åbningstider for det pågældende ugedagsnummer. Et kald som nedenstående vil fjerne åbningstiderne i a-kassen (og vise at åbningstiden er fra kl. 00:00 til 00:00):

ugedag:

1 = Mandag
2 = Tirsdag
3 = Onsdag
4 = Torsdag
5 = Fredag
6 = Lørdag
7 = Søndag

((({{<esc>
<akasseAabningstider>
<ugedag xmlns="">5</ugedag>
<aabningstidspunkt xmlns="">00:00</aabningstidspunkt>
<lukketidspunkt xmlns="">00:00</lukketidspunkt>
</akasseAabningstider>
</esc>}})))

For telefontider kan som for åbningstider være flere tidsintervaller med telefontider per ugedag. Der anbefales max 2 åbningstidsintervaller og max 2 telefontidsintervaller pr. dag. Der skal ikke angives telefontidsintervaller for dage, hvor telefonerne er lukkede. Nedenstående er et eksempel på en fredag med 2 telefontidsintervaller:

((({{<esc>
<akasseTelefontider>
<akasseTelefontid>
<ugedag xmlns="">5</ugedag>
<aabningstidspunkt xmlns="">10:30</aabningstidspunkt>
<lukketidspunkt xmlns="">12:00</lukketidspunkt>
</akasseTelefontid>
<akasseTelefontid>
<ugedag xmlns="">5</ugedag>
<aabningstidspunkt xmlns="">13:00</aabningstidspunkt>
<lukketidspunkt xmlns="">14:30</lukketidspunkt>
</akasseTelefontid>
</akasseTelefontider>
</esc>}})))

Tip for åbningstider:

• Undgå at benyttte 00:00 angivelse - benyt i stedet at udelade dagen fra kaldet.
• Husk altid at sende al data med i Update-requested (som ønskes vist / gemt) - ellers forsvinder oplysninger, der tidligere er gemt.

GetAkasseOplysninger (GET /v1/Akasse/{akasseKode})

Denne metode benyttes til at hente a-kassens adresse, kontaktoplysninger, åbningstider, telefontider, logo og dybe links.

GetAkasseListe (GET /v1/Akasse)

Denne metode returnerer en liste indeholdende alle a-kasse, med oplysninger om den enkelte a-kasse. Dog kun a-kasser og a-kasseafdelinger hvor der også er registreret adresseoplysninger.

GetAkasseAfdelingskontorRelation (GET /v1/Akasse/AkasseAfdelingskontorRelation)

Retunerer a-kasse og deres relation til afdelingskontorer.

UpdateAkasseOplysninger (PUT /v1/Akasse/Afkasse/{akassekode})

Metode til at opdaterer stamoplysninger, åbningstider m.v. for en a-kasse.

Forretningsregler

• En a-kasse på kun vedligeholde oplysninger på egen a-kasse
• Ugedagene skal være imellem 1 til 7
• Åbningstidspunkt skal ligge imellem 00:01 og 23:59
• Åbningstidspunkt  må ikke overlappe med lukketidspunkt
• A-kasse logo skal opfylde XXXXXX

GetAfdelingskontor (GET /v1/Akasse/Afdelingskontor)

Metode til at hente oplysninger omkring et afdelingskontor i en a-kasses.

CreateAfdelingskontor (POST /v1/Akasse/Afdelingskontor/{})

Metode til at oprette et afdelingskontor under en A-kasse.

Forretningsregler

• Der kan kun oprettes afdelingskontorer til en a-kasse, der er oprettet
• Der kan kun eksistere et afdelingskontor med et given afdelingskontorKode.  
• De enkelte a-kasser har rettighed til at oprette afdelingskontorer under sig selv, dvs. på egen akassekode

UpdateAfdelingskontor (PUT /v1/Akasse/Afdelingskontor/{AfdelingskontorKode})

Metode til at opdatere oplysninger omkring et afdelingskontor i en a-kasse.

Forretningsregler

• En ophørsdato skal være dagsdato eller historisk.
• En ophørsdato må kun angives hvis der ikke er flere medlemmer tilknyttet til afdelingskontoret, A-kassen skal inden ophør have flyttet medlemmer til a-kasse eller andre afdelingskontorer.
  • Medlemmer som a-kassen ikke har flyttet til a-kasse eller et blivende/overlevende afdelingskontor vil automatisk blive flyttet i DFDG til selve (hoved) a-kassen. Flytning vil ske på dato for indberetning til DFDG, en evt. historisk ophørsdato tage ikke i betragtning.
• Selvom afdelingskontoret i DFDG er lukket, vil DFDG stadig have historikken inkl. historik på medlemmers tilknytning.

For a-kasse og a-kasse afdelingskontor

A-kasse og a-kasse afdelingskontor er etableret som almindelige kodelister i EksterneData.CodeLists.

EksterneData.AkasseTypeCodeList (Skift link når fysisk side opdateret)

Kodeliste med alle a-kasser.

EksterneData.AkasseAfdelingskontorTypeCodeList (Skift link når fysisk side opdateret)

Kodeliste med alle a-kasser afdelingskontorer.