Servicen udstilles af plannersystemer og anvendes af DFDG for at understøtte borgers selvbooking og ombooking på Jobnet.
...
Table of Contents | ||
---|---|---|
|
Forslag til endpoints/metoder/resourcer/flows:
Resourcer er: Fejlmelding, Moedetilbud, Booking, Sagsbehandler og Straksbookingtilbud.
Hovedflow, booking
Booking ud fra mødetilbud, resourcen er resources: Moedetilbud
GetSelvbookingMoedetilbud - Hent mødetilbud - Get https://kontaktforloebt12.startest.dk/v1/BorgerBooking/Moedetilbud/{body}
GetSelvbookingMoedetider - Hent mødetider og sagsbehandler for et mødetilbud - Get https://kontaktforloebt12.startest.dk/v1/BorgerBooking/Moedetilbud/{MoedetilbudId}/{body}
...
CreateBooking - Opret en booking i det eksterne booking system - Post https://kontaktforloebt12.startest.dk/v1/BorgerBooking/Moedetilbud/{MoedetilbudId}/{body}
CreateFejlmelding- Opret ny fejlmeding - Post https://kontaktforloebt12.startest.dk/v1/BorgerBooking/Fejlmelding
GetSelvbookingMoedetilbud - Hent mødetilbud
Alternativt flow ombooking
Ombooking af en eksisterende booking, resources: Booking og Sagsbehandler
GetOmbookingMoedetider - Hent mødetider og sagsbehandlere ifm ombooking - Get https://kontaktforloebt12.startest.dk/v1/BorgerBooking/MoedetilbudGetSelvbookingMoedetider - Hent mødetider og sagsbehandler for et mødetilbud Booking/{IndkaldelseId}/{body}
GetOmbookingSagsbehandlere - Hent mulige sagsbehandlere for et booket møde - Get https://kontaktforloebt12.startest.dk/v1/BorgerBooking/Moedetilbud/{MoedetilbudId}Sagsbehandler/{…IndkaldelseId}
GetBookingdetaljer - Hent bookingdetaljer og reserver timeslot - Get https://kontaktforloebt12.startest.dk/v1/BorgerBooking/BookingMoedetilbud/{MoedetilbudId}/{…body}
CreateBooking - Opret en booking i det eksterne booking system - Post https://kontaktforloebt12.startest.dk/v1/BorgerBooking/Moedetilbud/Booking{MoedetilbudId}/{…}GetOmbookingMoedetider - Hent mødetider og sagsbehandlere ifm ombooking body}
Alternativt flow straksbooking
Oprettelsen af en booking ud fra et mødetilbug, resource: Moedetilbud
GetStraksbookingMoedetider - Hent tider for en straksbooking - Get https://kontaktforloebt12.startest.dk/v1/BorgerBooking/Moedetilbud/{MoedetilbudId}Straksbookingtilbud/{…} - samme som GetSelvbookingMoedetider?GetOmbookingSagsbehandlere
GetBookingdetaljer - Hent mulige sagsbehandlere for et booket møde bookingdetaljer og reserver timeslot - Get https://kontaktforloebt12.startest.dk/v1/BorgerBooking/SagsbehandlerMoedetilbud/{IndkaldelseId}
CreateOmbooking - Lav en ombooking i det eksterne booking system - Put https://kontaktforloebt12.startest.dk/v1/BorgerBooking/Booking/{…}
GetStraksbookingMoedetider - Hent tider for en straksbooking - Get MoedetilbudId}/{body}
CreateBooking - Opret en booking i det eksterne booking system - Post https://kontaktforloebt12.startest.dk/v1/BorgerBooking/StraksbookingtilbudMoedetilbud/{MoedetilbudId}/{…}body}
Alternativt flow accept booking
Acceptere en booking som borger, resource: booking
SaveIndkaldelsesaccept - Borgers accept af en indkaldelse - Put https://kontaktforloebt12.startest.dk/v1/BorgerBooking/Booking/{IndkaldelseId}/Accept
Alternativt flow slet booking
Sletter en allerede oprettet booking, resource: booking
DeleteIndkaldelse - Slet en indkaldelse i det eksterne booking system - Delete https://kontaktforloebt12.startest.dk/v1/BorgerBooking/Booking/{IndkaldelseId}
Alternativt flow opret fejlmelding
Sender en fejlmeding tilbage til bookingsystemet inden der kastes en fejl til jobnet, resource: fejlmelding
CreateFejlmelding- Opret ny fejlmeding - Post https://kontaktforloebt12.startest.dk/v1/BorgerBooking/Fejlmelding
CreateFejlmelding
Metode til tilbagemeldinger om fejl på Jobnet, booking-tilbud som ikke kan validere i DFDG med mere
...
Id | Navn | Beskrivelse |
---|---|---|
¤ | Ulovligt system angivet som ophav | Kun Id 30 - DFDG og Id 32 - Jobnet er lovlige værdier for system som er ophav til fejl |
¤ | Ukendt borger (¤ genbrug eksisterende kode) | Den angivne borger kendes ikke af plannersystemet |
¤ | Ukendt MødetilbudId | Det angivne id på et mødetilbud findes ikke i plannersystemet |
¤ | Ukendt IndkaldelseId | Det angivne id på en indkaldelse findes ikke i plannersystemet |
¤ | Ukendt fejlkode | Det angivne fejlkodenummer kendes ikke i plannersystemet |
¤flere…? |
GetSelvbookingMoedetilbud (GetSelfbookInterviewOptions)
Operationen anvendes af Jobnet, som via DFDG forespørger de mødetilbud, som udstilles til en specifik borger. Kaldet fra DFDG er stort set en ren viderestilling til og fra Jobnet.
HasExternalOperatorReferral og AbsenceCollection er taget ud af request, som tidligere udmeldt.
Bookings medsendes ved kald til plannersystem, da ikke alle plannersystemerne har en vedligeholdt bestand af borgers bookings.
Input
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
CivilRegistrationIdentifier [Header] | string | Pattern: ((((0[1-9]|1[0-9]|2[0-9]|3[0-1])(01|03|05|07|08|10|12))|((0[1-9]|1[0-9]|2[0-9]|30)(04|06|09|11))|((0[1-9]|1[0-9]|2[0-9])(02)))[0-9]{6})|0000000000 | 0 - 1 |
|
...
Fejlkode | Fejltekst | Beskrivelse |
---|---|---|
1014 | Failed to validate message | The submitted message could not be validated |
4770 | There are no available booking options | There are no available booking options |
8107 | The BookingIdentifier does not correspond to the person civil registration identifier | The BookingIdentifier does not correspond to the person civil registration identifier |
8111 | An error occured when trying to look up the supplied PersonCivilRegistrationIdentifier | An error occured when trying to look up the supplied PersonCivilRegistrationIdentifier |
GetBookingdetaljer (GetBookingDetails) - Booking flow
Metoden bruges ifm. booking og ombooking til at få alle bookingdetaljer fra det eksterne bookingsystem, inden den egentlige booking foretages. Herved kan både det eksterne bookingsystem og DFDG validere, inden booking foretages.
...
Metoden bruges ved straksbooking til at hente et antal mødetidspunkter for alle mødetilbud af den specifikke samtaletype.
HasExternalOperatorReferral er taget ud, som tidligere udmeldt.
Input
[Personnummer i header]
...
Fejlkode | Fejltekst | Beskrivelse |
---|---|---|
1014 | Failed to validate message | The submitted message could not be validated |
4650 | It is not allowed to delete this registration because the startdate lies in the past | It is not allowed to delete this registration because the startdate lies in the past |
4768 | The submitted BookingIdentifier is unknown to the system | The submitted BookingIdentifier is unknown to the system |
4820 | Cancellation is not allowed | Cancellation is not allowed, or cancellation deadline is exceeded |
8107 | The BookingIdentifier does not correspond to the person civil registration identifier | The BookingIdentifier does not correspond to the person civil registration identifier |
9130 | The Booking can not be rescheduled or cancelled by the citizen because it is an immediate booking | The Booking can not be rescheduled or cancelled by the citizen because it is an immediate booking |
SaveBookingList (udfases)
Denne metode skal kaldes, når KSS kalder SaveBookingList i BookingService. På den måde vil det være muligt at overføre indkaldelisterne online til det eksterne bookingsystem.
...