Forretningsbeskrivelse

Servicen udstilles af eksterne bookingsystemer, men med en snitflade som er defineret af DFDG.

Se ydermere overordnet forretningsbeskrivelse på It-understøttelse af planlagte samtaler.

I brugtagning

Kan og skal anvendes af plannersystemer fra: 2022-3

Adgang og filtrering

Denne service er kun til brug for DFDG og må ikke benyttes af andre webserviceaftagere.

Forretningsregler om samtaletyper og frister som bookingsystemet skal overholde ved udstilling

Kun 1 jobsamtale eller opfølgningssamtale ad gangen

For at frister (som kan have hårdtslående konsekvenser) og samtaletyper med frist skal være overskuelige og hænge godt sammen for borger, må hver borger kun have enten 1 jobsamtale/opfølgningssamtale eller 1 uindfriet frist. Flere planlagte samtaler af disse typer er ikke lovligt.

Åben kontaktgruppe

Kun borgere med en åben kontaktgruppe kan selvbooke samtaler. Det enkelte planner-system og KSS kan herudover have opsat andre kriterier, der skal være opfyldt for at en selvbooket samtale kan indlæses / falde på plads i planner-systemet eller KSS.

Frister medsendt til eksternt bookingsystem

Frist medsendes til bookingsystem på de kald hvor der skal tages hensyn til den, så længe den kan påvirke borgers booknings- eller ombookningsmuligheder, dvs. fra den er oprettet til den lukkes.

Det der primært skal sikres, er

• At mødet afholdes for sent (max 7 dg. efter fristdatoen)
• At borger ikke får en frist + en mødeindkaldelse, eller to samtidig indkaldelser på
  • Jobsamtale (id 7),
  • Fælles jobsamtale (id 17) eller
  • Opfølgningssamtale (id 4)

Se en fuld gennemgang af hvornår DFDG medsender frist og hvilke forventninger der er til brugen af fristen her:  Spreadsheet

Da DFDG ikke har information om samtaletype til rådighed ved kald til -Moedetid metoder, beriges alle kald til bookingsystem med fristinformation uanset om det er relevant af hensyn til samtaletypen.

Der må kun gives samtaletilbud for den type borgeren har en frist til, p.t. enten Jobsamtale, Fælles jobsamtale (id 17) eller Opfølgningssamtale, hvorpå der vil kunne gives tider indenfor fristen. Der må tilsvarende kun gives tider indenfor fristen. Det enkelte jobcenter beslutter selv om jobcentret vil indkalde til Fælles jobsamtale (id 17) eller give dagpengemodtageren en frist for at selvbooke en Fælles jobsamtale.

Ved bookning og ombookning skal det tilsvarende sikres, at frist ikke overskrides.

Straksbookede møder må hverken ombookes eller aflyses

Bookings lavet som straksbookede møder skal markeres med dette (IsImmediateBooking) og må hverken ombookes eller aflyses.

GetBookingDetaljer brug af Id

DFDG udfylder MoedetilbudId¤=InterviewOptionId ved CreateBooking (og IndkaldelseId¤=BookingIdentifier er tom). Ved ombook (RescheduleBooking) udfyldes BookingIdentifier (og InterviewOptionId er tom). Når BookingIdentifier er tildelt forventes den at være Id for bookingen igennem hele dens levetid. 

Kaldemønster best practise, valideringer i DFDG og forventninger til hvad BookingSystemer afstår fra aht. borgeroplevelsen

Det er vigtigt for STAR og jobcentrene at borgere som selvbooker får en god brugeroplevelse. En væsentlig del af den gode brugeroplevelse er ikke at skulle vente på svar fra interfacet. STAR optimerer løbende på såvel Jobnet som DFDG, men der er behov for at også ExternalBookingService bidrager med så lave svartider som muligt. Et sekundært, men nok så væsentligt aspekt på dette, er at undgå timeouts.

Ifm. CreateBooking bør støttekald til -StatusService og lignende i videst muligt omfang undgås

På en række af flowsne i EBS opretter DFDG en transaction for at sikre at DFDG og PlannerSystem har samme bestand af bookings. Dermed låses en del af tabelgrundlaget for -StatusService, og der vil være blokeret for at PlannerSystem kan kalde ind.

Selv hvis den specifikke tabel ikke er låst af transaktionen, er det imidlertid at foretrække at der ikke spildes tid på at kalde DFDG i forbindelse med kaldet, data bør i stedet prepareres tidligere, fx trigget af kaldet til GetSelfbookInterviewOptions eller GetSelfbookTimeslots (GetBookingDetails er ikke godt nok, her sidder borger allerede og venter på sin booking).

Skemavalidering af request til, og response fra ExternalBookingService

Alle requests fra DFDG til og alle responses fra plannersystemerne bliver skemavalideret mod WDSL kontrakten således at der kastes en valideringsfejl tilbage til Jobnet hvis request eller response ikke overholder kontrakten. Fejlen der kastes er: 9329 "Response from external planner system violated the wsdl contract".

PlannerSystemer kan selv identificere ubrugelige bookings

Bookings med ulovlige data er uhensigtsmæssige for såvel DFDG (som må svare borger at bookingen ikke kunne gennemføres) som PlannerSystemet (som spilder kapacitet på en booking som ingen kan booke, og som sagsbehandlere formodentlig regner med udgør en del af et påkrævet udbud af mødetilbud).

Der findes ingen metode til at DFDG kan kalde PlannerSystemet og gøre opmærksom på den ubrugelige booking, men det bør heller ikke være nødvendigt, de er lette at identificere:

Alle bookings som DFDG henter GetBookingDetails på uden efterfølgende at kalde CreateBooking har data som gør dem ubrugelige. Se evt. sekvensdiagrammerne ovenfor.

Teknisk gæld

Deprecatede collections

Anden aktør information (HasExternalOperatorReferral) og fraværsinformation (AbsenceCollection) er begge deprecatede og kan ikke påregnes udfyldte. De fjernes fra snitfladen ved førstkommende lejlighed (løft til ny serviceversion).

Informationen skal i stedet hentes ved kald til PersonStatusService eller anden -StatusService.

Metoder

metode-xxx