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.

Opretteles og opdatering af A-kasse

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

• A-kasse kode
• Navn på a-kassen

Nedestående oplysninger kan a-kasse selv indberette, når STAR har oprettet 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 indblaerettes til STAR (via sag til Systemforvaltningen).

Oprettelse og nedlæggelse af et afdelingskontor

Afdelingskontorer kan oprettes og nedlægges uden forudgående varsling og oprettes hhv. nedlægges af A-kassen selv. 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 afdelingskontoret vil blive flyttet automatisk til hoved a-kassen (afdelingskontor xx0000).

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 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 dag 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})

GetAkasseInformation

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 åbningstidSluttidspunkt
• 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-kase skal inden ophør have flytte medlemmer til a-kasse eller andre afdelingskontore
  • Medlemmer som a-kasse ikke har flyttet til a-kasse eller et blivende/overlevende afdelingskontor vil automatisk blive flyttet i DFDG til selve a-kasse. Flytning vil ske på dato for indberetning til DFDG, en evt. historisk ophørsdato tage ikke i betraktning.
• Selvom afdelingskontoret i DFDG er lukket vil DFDG stadig have historikken inkl. historik på medlemmers tilknytning.

For a-kassse og a-kasse afdelingskontor

a-kassse 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 afdelingskontore.