Table of Contents |
---|
Forretningsbeskrivelse
Denne service gør det muligt at hente og gemme oplysninger om den enkelte a-kasse og de a-kasse kontorer der er knyttet til a-kassen.Der kan ikke oprettes åbningstider i weekender. Disse begrænsninger er lavet af hensyn til brevhoveder, hvor der er / var begrænset plads til åbningstider.
Det er alene STAR, der har rettighed til at opdatere hovedjobcentrets navn. De enkelte jobcentre har rettighed til at opdatere subjobcentres navne.
Det er STAR (Systemforvaltningen), der på bestilling opretter nye (sub)jobcentre. Dette skyldes, at oprettelsen skal ske synkront i de forskellige it-systemer.
Bestilling indgives via jobcentrets egen leverandør til Systemforvaltningen. Bestillingen skal indeholde oplysninger om
- Navn på subjobcenter (max 30 tegn)
- Adresse
- CVR
- p-nummer
- telefon
- åbningstider
- telefontider
- evt. email eller website
- om der er tale om en virksomhedsafdelin
Det er aftalt med KMD, Schultz og a-kasseleverandører, at subjobcentre kan oprettes uden forudgående varsling.
Hovedjobcentrets (xxx00 og xxx01) skal indholde kommunens navn (af hensyn til at kommunernes LBA'er kan rettidghedsstyre på medarbejdercertifkater i AmpAdmin2).
Virksomhedsafdeling (nyt fra 2018-4)
Det udstilles ikke i JobCenterService.GetJobCenterInformation, om der er tale om en virksomhedsafdeling.
Denne type er ikke serviceudstillet i UpdateJobCenterInformation og kan kun ændres ved at kontakte Systemforvaltningen. De resterende informationer vil kunne opdateres ved at kalde UpdateJobCenterInformation, som er uændret (ift. før 2018-4).
Derimod returnerer CompanyRecruitmentService(Version2).GetCompanyJobcenterAffiliation fremadrettet pr. default jobcenterets virksomhedsafdeling, hvis en sådan findes, og hovedjobcenteret, hvis der ikke er oprettet en virksomhedsafdeling.
Oprettelse og nedlæggelse af et subjobcenter
Subjobcentre kan oprettes og nedlægges med TopDesk sag til Systemforvalter eller med metoderne CreateSubjobcenter og DeleteSubjobcenter.
Borgere med åbne sager skal inden lukning være flyttet af jobcenteret til et blivende/overlevende subjobcenter.
Borgere som jobcenteret ikke har flyttet til et blivende/overlevende jobcenter vil blive flyttet af Systemforvalter med et script til det forretningsmæssige hovedjobcenter (xxx01) (eksempel)- og der vil derfor ikke blive dannet WSRM'er for denne flytning af subjobcenter.
Selvom DFDG lukker subjobcenteret vil jobcenterhistorikken i DFDG returnere evt. tilknytninger til de lukkede/slettede subjobcenter (da både jobcenteridentifier og navn gemmes i selve jobcenter-historikken, forbliver den intakt, selvom subjobcentret slettes).
Opdatering af hovedjobcenter xxx01 slår også igennem på xxx00 jobcenteret
Som udgangspunkt findes der forretningsmæssigt kun ét hovedjobcenter og det er pr. definition jobcenter xxx01 og jobcenteret skal derfor også kun opdatere på xxx01 og eventuelle subjobcentre (xxx02-xxx99).
Når det forretnngsmæssige hovedjobcenter xxx01 opdateres af jobcentret vil det fra 2019-4 samtidigt føre til opdatering på xxx00 og der udsendes WSRM på begge rettelser. Rettelsen slår igennem med det samme på xxx00-jobcenteret.
Dvs. ved en opdatering af xxx01, vil samme værdier blive skrevet til xxx00 eksklusiv jobcenter navnet.
Sikkerhedsattributter
Servicen er omlagt til de nye sikkerhedsattributter i 2021-1 - og vil derfor fremgår kaste fejlkode 4575 "You are not authorized", hvis servicen kaldes af en aftagertype, der ikke har rettighed til at kalde den pågældende servicemetode. Der kan evt. tidligere være kastet en mere aftagertype-specifik fejlkode i denne situation.
Introtext og tilmeldekvitteringer
I Tilmeldekvitteringer på Jobnet (DASR-tekster) udgår fra 2023-2 angivelse af jobcenterets adresse og Jobcenter intro-tekst. I stedet indsættes tekst af STAR i DASR tilmeldekvitteringstekst, hvor der henvises til, at jobcentrets adresse fremgår i Højre side, under Kontakt dit jobcenter.
Link til snitfladebeskrivelser
Confluence
Child pages (Children Display) | ||
---|---|---|
|
Swagger
Link fra forretningsbeskrivelser
Search Results spacekey LOG query akasseService type page
Metoder
Rettigheder til at kalde metoderne
UpdateJobCenterInformation
Denne metode benyttes til at gemme ændringer til jobcenterets adresse, kontaktoplysninger, åbningstider og/eller telefontider.
Opdateres oplysninger for et hoved-subjobcenter (id ender på 01) opdateres også oplysningerne på selve hovedjobcenteret (id ender på 00) eksklusiv jobcenter navnet.
Hvis et jobcenter holder lukket en dag, understøttes dette ved at sende et givet WeekDayidentifier element med OpenHours og ClosesHours 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 Jobcentret (og vise at åbningstiden er fra kl. 00:00 til 00:00):
WeekDayIdentifier:
1 = Mandag
2 = Tirsdag
3 = Onsdag
4 = Torsdag
5 = Fredag
Code Block |
---|
((({{<esc>
<JobCenterOpeningHours>
<WeekDayIdentifier xmlns="">5</WeekDayIdentifier>
<OpenHours xmlns="">00:00</OpenHours>
<ClosesHours xmlns="">00:00</ClosesHours>
</JobCenterOpeningHours>
</esc>}}))) |
Som noget nyt i version 5 er der også telefontider for jobcentret.
Der 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:
Code Block |
---|
((({{<esc>
<JobCenterPhoneHoursCollection>
<JobCenterPhoneHours>
<WeekDayIdentifier xmlns="">5</WeekDayIdentifier>
<OpenHours xmlns="">10:30</OpenHours>
<ClosesHours xmlns="">12:00</ClosesHours>
</JobCenterPhoneHours>
<JobCenterPhoneHours>
<WeekDayIdentifier xmlns="">5</WeekDayIdentifier>
<OpenHours xmlns="">13:00</OpenHours>
<ClosesHours xmlns="">14:30</ClosesHours>
</JobCenterPhoneHours>
</JobCenterPhoneHoursCollection>
</esc>}}))) |
'''Husk ved update at det kun er åbningstider og telefontidsintervaller i requested, der gemmes. Tidligere gemte intervaller og dage, der ikke er med i Update-requested, slettes. Hvis telefonnummer og webadresse ikke er med i requested, slettes disse oplysninger også.'''
Generelle forretningsregler
- Et jobcenter må kun opdatere deres egen information (indenfor kommunen).
- Det er alene STAR, der har rettighed til at opdatere hovedjobcentrets navn (hovedjobcentre ender på 00, fx 14700 for Jobcenter Frederiksberg).
- De enkelte jobcentre har rettighed til at opdatere subjobcentres navne.
Åbningstider og telefontider fungerer på samme måde.
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 jobcentrets telefonnummer og webadresse.Hvis man ønsker at sætte en dag til LUKKET, så skal man udelukke denne dag fra kaldet. Hvis man medsender dagen med følgende:
<JobCenterOpeningHours>
<WeekDayIdentifier xmlns="">5</WeekDayIdentifier>
<OpenHours xmlns="">00:00</OpenHours>
<ClosesHours xmlns="">00:00</ClosesHours>
</JobCenterOpeningHours>
så vil det på Jobnet se ud som om der er åbent fra kl. 0:00 til 0:00 (se grafisk eksempel i FB 109602).
Opdatering af telefontiderne skiller sig kun ud fra opdatering af åbningstider ved, at man ikke kan kalde med:
<JobCenterPhoneHours>
<WeekDayIdentifier xmlns="">5</WeekDayIdentifier>
<OpenHours xmlns="">00:00</OpenHours>
<ClosesHours xmlns="">00:00</ClosesHours>
</JobCenterPhoneHours>
da man sp vil man få følgende fejl:
"....FaultException: Valid interval between 00:01 and 23:59 with no overlap and opening hour before closing hour....."
Konklusion:
- undgå at benyt 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.
Lidt om nogle af de enkelte felter i Update-metoden
IntroduktionstekstDet er fra release 2023-2 ikke længere muligt at indskrive et introduktionsafsnit, fx om at kontanthjælps- eller uddannelseshjælpsansøgere skal hanvende sig på en anden adresse en jobcentrets (hvis dette er tilfældet).
WebAddress
Er en tekststreng og kan indeholde oplysninger om jobcentrets webadresse eller e-mail. Der foretages ikke validering på anvendt format, men alene på længden af den indtastede streng (String - Length: 0-50).
PostOfficeBoxIdentifier
Anvendes p.t. (oktober 2017) ikke af nogen jobcentre iflg. registreringerne i DFDG. Inden feltet tages i anvendelse af et jobcenter, skal jobcentret selv tjekke, om jobcentrets forskellige it-løsninger, der anvender JobCenterService, kan håndtere, at feltet er udfyldt.
DistrictSubdivisionIdentifier
Anvendes p.t. (oktober 2017) ikke af nogen jobcentre (iflg. registreringerne i DFDG). Inden feltet tages i anvendelse af et jobcenter, skal jobcentret selv tjekke, om jobcentrets forskellige it-løsninger, der anvender JobCenterService, kan håndtere, at feltet er udfyldt.
CoName
Anvendes p.t. (oktober 2017) ikke af nogen jobcentre (iflg. registreringerne i DFDG). Inden feltet tages i anvendelse af et jobcenter, skal jobcentret selv tjekke, om jobcentrets forskellige it-løsninger, der anvender JobCenterService, kan håndtere, at feltet er udfyldt.
StreetNameForAddressingName
Anvendes p.t. (oktober 2017) ikke af nogen jobcentre (iflg. registreringerne i DFDG). Inden feltet tages i anvendelse af et jobcenter, skal jobcentret selv tjekke, om jobcentrets forskellige it-løsninger, der anvender JobCenterService, kan håndtere, at feltet er udfyldt.
JobCenterOpeningHoursType.
P.t. (oktober 2017) er der ikke jobcentre (iflg. registreringerne i DFDG), der har mere end 2 åbningstider pr. dag. Inden et jobcenter tager flere end 2 åbningstider pr. dag i brug, skal jobcentret selv tjekke, om jobcentrets forskellige it-løsninger, der anvender JobCenterService, kan håndtere flere end 2 åbningstider pr. dag.
JobCenterPhoneHoursType
P.t. (oktober 2017) er der ikke jobcentre (iflg. registreringerne i DFDG), der har mere end 2 telefontider pr. dag. Inden et jobcenter tager flere end 2 telefontider pr. dag i brug, skal jobcentret selv tjekke, om jobcentrets forskellige it-løsninger, der anvender JobCenterService, kan håndtere flere end 2 telefontider pr. dag.
Visning på Jobnet
Når oplysningerne om jobcentret opdateres i DFDG via JobCenterService vil oplysningerne blive synkroniseret til visning på borgernes Min side på Jobnet. Synkroniseringen sker ved batchjob (JN-DB-GetCodeListFromBroker), der afvikles én gang i døgnet (ca. kl. 05.40). Opdateringen af oplysninger i DFDG vil dermed groft sagt blive vist på Jobnet den efterfølgende dag.
Udsendelse af WSRM GetJobcenterContactInfoVersion1
Når JobCenterService.UpdateJobCenterInformation kaldes sendes en WSRM besked til berørte jobcenter (GetJobcenterContactInfoVersion1), dog sendes til alle jobcentre hvis det er navnet for et jobcenter eller et subjobcenter der ændres.
GetJobCenterInformation
Denne metode benyttes til at hente jobcenterets adresse, kontaktoplysninger, åbningstider, telefontider og (indtil release 2023-2 introduktionsafsnit), som kan medsendes til eksempelvis dagpengemodtagere.
GetJobCenterList
Denne metode returnerer en liste indeholdende alle jobcentre, med oplysninger om det enkelte jobcenter. Dog kun jobcentre hvor der også er registreret adresseoplysninger.
GetJobCenterCodeList
Retunere jobcentre og relationen til kommunerne.
Hvis indput "KunJobcentre" sættes til true retuneres kun xxx00 jobcentre ellers retuneres alle
UpdateVirksomhedscenter
Metoden benyttes til at opdatere om et subjobcenter har status af virksomhedscenter.
Der valideres for at 1 hovedjobcenter kun kan have 1 subjobcenter, fejlkode: XXXXX - “Hovedjobcentret har allerede 1 virksomhedscenter. Der må kun være 1 per hovedjobcenter”.
CreateSubjobcenter
Forretningsregler
- Der kan kun oprettes xxxyy subjobcenter, hvis det tekniske hovedjobcenter xxx00 findes
- Hvis xxxyy allerede findes, kastes en fejl
- Jobcentre må max have 4 forskellige åbnings tider
- Ugedagende skal være imellem 1 til 5
- Åbningstidspunkt skal ligge imellem 00:01 og 23:59
- Åbningstidspunkt må ikke overlappe med åbningstidSluttidspunkt
DeleteSubjobcenter
Forretningsregler
Table of Contents |
---|
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 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.
Arbejdsgange
For arbejdsgang omkring oprettelse og opdatering af a-kasse stamoplysninger samt oprettelse, opdatering og lukning af afdelingskontorer se Flow for oprettelse og vedligeholdelse af a-kasse og afdelingskontorer (Efter modernisering 2025-2)
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.
Link til snitfladebeskrivelser
Confluence
Child pages (Children Display) | ||
---|---|---|
|
Swagger
Link fra forretningsbeskrivelser
Search Results spacekey LOG query akasseService type page
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
Code Block |
---|
((({{<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:
Code Block |
---|
((({{<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)
Ny metoder, der returnerer en liste indeholdende alle a-kasse, med oplysninger om den enkelte a-kasse. Dog kun a-kasser, hvor der også er registreret adresseoplysninger. A-kasse afdelingskontor registreres ikke her de anvendes CreateAfdelingskontor (POST /v1/Akasse/Afdelingskontor/{})
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
- Da A-kassens navn (akasseNavn) skal være a-kassens fulde navn
- Da A-kassens navn (akasseNavn) indgår i forskelling informationstekster på Jobnet, skal ændringer i A-kassen navn aftales med STAR
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
Kodeliste med alle a-kasser.
EksterneData.AkasseAfdelingskontorTypeCodeList
Kodeliste med alle a-kasser afdelingskontorer.