EksterneData.JobcenterService (2024-3)

Forretningsbeskrivelse

Denne service gør det muligt at hente og gemme oplysninger om det enkelte jobcenter som adresse, telefonnummer, åbningstider og telefontider. De oplysninger, der er registreret i denne service benyttes til gennerering af breve m.m.

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 100 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.

Metoder

Rettigheder til at kalde metoderne

Jobcentre, kommuner og anden aktør

A-kasser

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

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:

'''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

Introduktionstekst

Det 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

Retunerer jobcentre og relationen til kommunerne.

Hvis input "KunJobcentre" sættes til true returneres kun xxx00 jobcentre ellers returneres 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 et subjobcenter under et allerede eksisterende hovedjobcenter

• Der kan højst være 98 subjobcentre under et hovedjobcenter

• Jobcentre må max have 4 forskellige åbningstider

• Ugedagene skal være imellem 1 til 5

• Åbningstidspunkt skal ligge imellem 00:01 og 23:59

• Åbningstidspunkt  må ikke overlappe med åbningstidSluttidspunkt

DeleteSubjobcenter

Forretningsregler

• 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 automatisk blive flyttet til det forretningsmæssige hovedjobcenter (xxx01) (eksempel)- og der vil blive dannet WSRM'er for denne flytning af subjobcenter fsva, borgere med åben KG.

• 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). (ud fra en forventning om at KSS ikke ønsker at modtage WSRM/WSB for borger med lukket sag).

• Kun STAR må slette xxx00 og xxx01 jobcentre

• Man kan ikke slette xxx00 så længe der er sub-jobcentre under det.

CreateTilmeldekvittering

Oprettelse af en tilmeldekvittering. Det er muligt at gøre kvitteringen specifik for en klientkategori, hvis ingen klientkategori angives, gælder den for alle klientkategorier

UpdateTilmeldekvittering

Opdatering af en tilmeldekvittering