| Table of Contents |
|---|
...
Forretningsregler
GetInterviewInfo
Metode til at hente den fulde InterviewInfo (i modsætning til at der kun vil være et status-udsnit i den nye statusservice PersonEngagementStatusService)
Der vil være filtrering på servicen jf. filtreringskravene på PersonStatusService
Samtaler a-kasse har adgang til at se
...
(20 er afhængig af den valgte implementering i 935.4 a-kasse forsøget)
...
CreateInterview
Denne servicemetode benyttes til at oprette en afholdt samtale samt registrering af deltagere på denne.
Tilladte samtaletyper pr. kontaktgruppe: Indkaldelser, samtaleregistrering og kontaktgrupper
Forretningsregler vedrørende registrering af afholdte samtaler
Generelle forretningsregler:
- Afholdelsestidspunktet kan ikke ligge tidligere end senest afholdte nulstillende samtale.
- Der kan ikke registreres flere nulstillende samtaler som værende afholdt på præcist samme tidspunkt (det betyder at hvis fx en a-kasse vil registrere en CV-samtale og en rådighedssamtale som værende afholdt på samme dag, så kan indberetningen til DFDG ske, hvis der er fx 1 minut mellem samtaletidspunktet for de 2 samtaler).
- Samtalen skal på afholdelsesdagen være tilladt for kontaktgruppen (i forhold til EventTime på kontaktgruppen).
- Samtaler med samme samtaletype og afholdelsestidspunkt er ikke tilladt.
- Nulstillende samtaler kan ikke registreres samtidigt eller før en anden nulstillende samtale.
- For samtaler, hvor InterviewWithMoreAuthorities er sat til True, skal ParticipationStatusTypeIdentifier også være angivet.
- For samtaler, hvor der er angivet en BookingIdentifier, skal denne i forvejen være kendt på borgeren i DFDG.
- "Møde direkte på arbejde" (InterviewContactTypeIdentifier id 6) anvendes forretningsmæssigt alene ved henvisningsamtaler (InterviewTypeIidentifer id 8). DFDG validerer ikke teknisk for dette.
...
- Jobcentre kan kun registrere samtaler på borgere, der har jobcentertilknytning i pågældende jobcenter.
- For samtaletypen "Samtale i rehabiliteringsteam" (id 18) kan det angives om borgeren har deltaget. Hvis det angives skal ParticipationStatusTypeIdentifier være 5 eller 6, ellers returneres fejlkode 9125.
UpdatePersonInterview
Denne servicemetode benyttes til at opdatere en afholdt samtale. Der gælder de samme valideringsregler som ved CreatePersonInterview.
AddInterviewParticipant
Metoden tilføjer en deltager til en eksisterende afholdt samtale.
UpdateInterviewParticipant
Metoden opdaterer en given deltager på en eksisterende afholdt samtale. Det vil være muligt at opdatere navnet samt det eksterne ID på deltageren.
WSRM-beskeden GetPersonInterview fremsendes ikke ved opdatering eller sletning af deltagere på det afholdte interview.
DeleteInterviewParticipant
Metoden sletter en given deltager fra en eksisterende afholdt samtale.
WSRM-beskeden GetPersonInterview fremsendes ikke ved opdatering eller sletning af deltagere på det afholdte interview.
Servicesnitflade
CreatePersonInterview
Input
Element | Type | Detaljer | Forekomst | Beskrivelse |
|---|---|---|---|---|
| CreatePersonInterviewRequest | CreatePersonInterviewRequestType | 1 | ||
| - PersonCivilRegistrationIdentifier | PersonCivilRegistrationIdentifierType Base: string | (CPR nr pattern) | 1 | CivilRegistrationNumber (PNR) (... forkortet her af praktiske årsager ) |
| - PersonInterview | PersonInterviewType | 1 | ||
| - - PersonInterviewIdentifier | guid Base: string | Pattern: [0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12} | 0 - 1 | Unik identifikation af transaktion eller registrering. |
| - - InterviewTypeIdentifier | InterviewTypeIdentifierType | 1 | Samtaletype. | |
| - - BookingIdentifier | guid Base: string | Pattern: [0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12} | 0 - 1 | Mulighed for at angive guid på samtale indkaldelsen. |
| - - ResponsibleAuthority | ResponsibleAuthorityType | 1 | Angivelse af den ansvarlige sagsbehandler. | |
| - - - AuthorityStructure | AuthorityStructureType | 1 | Detaljer på myndigheden. | |
| - - - - AuthorityCode | AuthorityCodeType Base: string | Pattern: [-][1]|[0-9]{1,8} | 1 | Myndighedskode. |
| - - - - AuthorityName | AuthorityNameType Base: string | Length: 1-100 | 1 | Myndighedsnavn. |
| - - - - OrganisationTypeIdentifier | OrganisationTypeIdentifierType | 1 | Organisationstype. | |
| - - - CaseWorker | ResponsibleCaseWorkerStructureType | 1 | Detaljer på sagsbehandleren. | |
| - - - - CaseWorkerGivenName | PersonGivenNameType Base: string | Length: 1-50 | 1 | Sagsbehandlerens fornavn. |
| - - - - CaseWorkerMiddleName | PersonMiddleNameType Base: string | Length: 1-40 | 0 - 1 | Sagsbehandlerens mellemnavn. |
| - - - - CaseWorkerSurname | PersonSurnameNameType Base: string | Length: 1-40 | 1 | Sagsbehandlerens efternavn. |
| - - - - TelephoneNumberIdentifier | TelephoneNumberIdentifierType Base: string | Pattern: (\+)?[0-9]{3,20} | 0 - 1 | Sagsbehandlerens ID. |
| - - - - EmailAddressIdentifier | EmailAddressIdentifierType Base: string | Pattern: ([^>\(\)\[\]\\,;:@\s]{0,191}@[^>\(\)\[\]\\,;:@\s]{1,64}) | 0 - 1 | Sagsbehandlerens telefon nummer. |
| - - - - CaseWorkerIdentifier | CaseWorkerIdentifierType Base: string | Length: 1-255 | 1 | Sagsbehandlerens email adresse. |
| - - InterviewTime | dateTime | 1 | Mødeafholdelsestidspunkt. Kan variere fra det planlagte tidspunkt og registreringstidspunkt. | |
| - - InterviewContactTypeIdentifier | InterviewContactTypeIdentifierType | 1 | Angiver om mødet er personligt fremmøde, telefonisk, per mail eller andet. | |
| - - InterviewWithMoreAuthorities | boolean | 1 | Angiver at samtalen er indkaldt med deltagelse af anden myndighed. | |
| - - ParticipationStatusTypeIdentifier | ParticipationStatusTypeIdentifierType | 0 - 1 | Angiver status på deltagelse. | |
| - - InterviewParticipantCollection | InterviewParticipantCollectionType | 0 - 1 | Øvrige deltagere på mødet der ikke borger eller ansvarlig sagsbehandler. | |
| - - - InterviewParticipant | InterviewParticipantType | 1 - * | ||
| - - - - MessageIdentifier | guid Base: string | Pattern: [0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12} | 0 - 1 | Unik identifikation af transaktion eller registrering. |
| - - - - InterviewParticipantName | String_1_256 Base: string | Length: 1-256 | 1 | Navn på deltageren. |
| - - - - InterviewParticipantContactTypeIdentifier | InterviewContactTypeIdentifierType | 1 | Hvordan deltageren deltager på mødet. | |
| - - - - InterviewParticipantTypeIdentifier | CodeListItemIdentifierType | 1 | Deltagerens rolle på mødet. | |
| - - - - - CodeListItemIdentifier | CodeListItemIdentifierSimpleType Base: int | MinInclusive: 0 MaxInclusive: 100000000 | 1 | |
| - - - - ExternalAuthorityParticipantId | String_1_256 Base: string | Length: 1-256 | 0 - 1 | Eksternt id på deltageren. |
| - - AgreementDescription | AgreementDescriptionType Base: string | Length: 1-3000 | 1 | Beskrivelsesfelt til at beskrive aftalen mellem sagsbehandler og ledig. |
...
Fejlkode | Fejltekst | Beskrivelse |
|---|---|---|
| 1001 | Invalid cpr | The submitted cpr is either to long or short or contains data not interpretable as a date |
| 1010 | Unknown cpr | The submitted cpr is unknown to the system |
| 1014 | Failed to validate message | The submitted message could not be validated |
| 4385 | The client does not have an unemploymentfund registration | The client does not have an unemploymentfund registration |
| 4404 | The person with specified cpr does not exist | The person with specified cpr does not exist |
| 4405 | The person with specified cpr is dead | The person with specified cpr is dead |
| 4511 | The External operator is not allowed to view data for the person | The External operator is not allowed to view data for the person |
| 4575 | You are not authorized | You are not authorized to execute the operation |
| 4589 | Unknown identifier | The submitted Identifier is unknown to the system |
| 4734 | The agreement description must contain text | The agreement description must contain text |
| 4857 | Citizen belongs to different unemployment fund | Citizen belongs to different unemployment fund |
| 6005 | The person with specified cpr does not belong to the jobcenter specified in ActiveOrganisationHeader | The person with specified cpr does not belong to the jobcenter specified in ActiveOrganisationHeader |
| 8183 | You not allowed to update InterviewContactTypeIdentifier | You not allowed to update InterviewContactTypeIdentifier |
| 8184 | You are not allowed to update InterviewTime | You are not allowed to update InterviewTime |
| 8185 | You are not allowed to update BookingIdentifier | You are not allowed to update BookingIdentifier |
| 8186 | You are not allowed to update InterviewIdentifier | You are not allowed to update InterviewIdentifier |
| 8187 | You are not allowed to update InterviewTypeIdentifier | You are not allowed to update InterviewTypeIdentifier |
| 8188 | You are not allowed to update InterviewWithMoreAuthorities | You are not allowed to update InterviewWithMoreAuthorities |
| 8189 | You are not allowed to update ParticipationStatusTypeIdentifier | You are not allowed to update ParticipationStatusTypeIdentifier |
GetInterviewInfo
Den fulde information om registrerede samtaler (i modsætning til det overblik som kommer i den nye status-service, se 935.4 - PersonEngagementStatusService (Version 1))
...
Fejlkode | Fejltekst | Beskrivelse |
|---|---|---|
| 1001 | Invalid cpr | The submitted cpr is either to long or short or contains data not interpretable as a date |
| 1010 | Unknown cpr | The submitted cpr is unknown to the system |
| 1014 | Failed to validate message | The submitted message could not be validated |
| 4405 | The person with specified cpr is dead | The person with specified cpr is dead |
| 4589 | Unknown identifier | The submitted Identifier is unknown to the system |
| 8197 | Participant is not found for the specified person | Participant is not found for the specified person |
| 8198 | Participant is not found for the specified person interview | Participant is not found for the specified person interview |