Denne service benyttes til at en sagsbehandler kan registrere sig for gæsteadgang til en borger aht. at kunne se eller opdatere data, der er registreret i DFDG på en borger, også selv om borgeren er fraflyttet. F.eks. af journal-, refusions- og revisionsmæssige årsager.
Metoder
GetGaestadgange (GET /gaestadgang/)
Denne metode benyttes til at hente alle gaestadgange, for en given borger.
Operation | Endpoint |
---|---|
GET | v1/gaestadgang/ |
Input
[Personnummer i header]
Output
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
Gaestadgange | IEnumerable<GaestadgangDto> |
| 1 | Samling af generelle statuskommentarer tilknyttet personen ud fra (populært kaldet AMP kommentarfeltet). |
(PersonCommentType) | GaestadgangDto |
| 0 - * |
|
(MessageIdentifier) | guid | 1 | Unik nøgle | |
(CommentText) | string | Length: 1-1000 | 1 | Kommentartekst |
(EventDate) | dateTime |
| 1 | Hændelsesdato for registreringen |
(CaseWorkerStructure) | RegistrerendeBrugerDto |
| 1 | Registrerende sagsbehandler. |
| string | Length: 1-140 | Sagsbehandlers fulde navn, ved systemkald angives systemets og jobbets navn her. | |
(CaseWorkerGivenName) | string | Length: 1-50 | 1 | Sagsbehandlerens fornavn |
(CaseWorkerMiddleName) | string | MaxLength: 40 | 0 - 1 | Sagsbehandlerens mellemnavn. |
(CaseWorkerSurname) | string | Length: 1-40 | 1 | Sagsbehandlerens efternavn. |
(CaseWorkerRID) | string | Length: 1-64 | 1 | Sagsbehandlerens RID fra medarbejder OCES certifikatet. |
(AuthorityStructure) | RegistrerendeMyndighedDto |
| 1 | Detaljer på myndigheden. |
(AuthorityCode) | string | Pattern: [-][1]|[0-9]{1,8} | 1 | Myndighedskode. |
(OrganisationTypeIdentifier) |
| 1 | Myndighedsnavn. | |
| string |
| 1 | Myndighedsnavn. |
GetGaestadgang (GET /gaestadgang/{gaestadgangId})
Denne metode benyttes til at hente en specifik gaestadgang, for en given borger.
Operation | Endpoint |
---|---|
GET | v1/gaestadgang/{gaestadgangId} |
Input
[Personnummer i header]
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
GaestadgangId | Guid | 1 |
Output
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
GaestadgangId (MessageIdentifier) | guid | 1 | Unik nøgle | |
(CommentText) | string | Length: 1-1000 | 1 | Kommentartekst |
(EventDate) | dateTime |
| 1 | Hændelsesdato for registreringen |
(CaseWorkerStructure) | RegistrerendeBrugerDto |
| 1 | Registrerende sagsbehandler. |
| string | Length: 1-140 | Sagsbehandlers fulde navn, ved systemkald angives systemets og jobbets navn her. | |
(CaseWorkerGivenName) | string | Length: 1-50 | 1 | Sagsbehandlerens fornavn |
(CaseWorkerMiddleName) | string | MaxLength: 40 | 0 - 1 | Sagsbehandlerens mellemnavn. |
(CaseWorkerSurname) | string | Length: 1-40 | 1 | Sagsbehandlerens efternavn. |
(CaseWorkerRID) | string | Length: 1-64 | 1 | Sagsbehandlerens RID fra medarbejder OCES certifikatet. |
(AuthorityStructure) | RegistrerendeMyndighedDto |
| 1 | Detaljer på myndigheden. |
(AuthorityCode) | string | Pattern: [-][1]|[0-9]{1,8} | 1 | Myndighedskode. |
(OrganisationTypeIdentifier) |
| 1 | Myndighedsnavn. | |
| string |
| 1 | Myndighedsnavn. |
GetHistoriskeGaestadgange (GET /gaestadgang/historik)
Denne metode benyttes til at hente historik for alle gaestadgange, for en given borger.
Operation | Endpoint |
---|---|
GET | v1/gaestadgang/historik |
Input
[Personnummer i header]
Output
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
GaestadgangshistorikResponse | GaestadgangshistorikResponseDto | |||
(CommentHistoryCollection) | IEnumerable<GaestadgangshistorikDto> |
| 0 - 1 | Liste af historiske gaestadgange. |
(CommentIdentifier) | guid | 1 | Identifier for gaestadgang | |
(CommentText) | string | Length: 1-1000 | 1 | Gaestadgangskommentartekst |
(EventDate) | dateTime |
| 1 | Hændelsesdato for registreringen |
(CorrectionComment) | string |
| 0 - 1 | Kommentar til berigtigelse af en registrering. |
| ServiceModelBase |
| 1 |
|
| RegistreringsmetadataDto |
| 1 |
|
| boolean |
| 1 | Angiver om registreringen er en sletning |
| boolean |
| 1 | Det er en række som er aktuel (kan typisk også ses i PSS). |
| RegistrerendeMyndighedDto |
| 0 - 1 |
|
|
| 1 |
| |
| string | Length: 1-20 | 1 | Identifikation af organisation / myndighed |
| RegistrerendeBrugerDto |
| 0 - 1 |
|
| KaldendeBrugerDto |
| 1 |
|
| string | Length: 1-140 | 1 | Sagsbehandlers fulde navn, ved systemkald angives systemets og jobbets navn her. |
|
| 1 |
| |
| string | Length: 1-255 | 1 | Unik identifikation af brugeren, f.eks. en GUID, et medarbejder ID, system ID, bruger ID, certifikat ID, cpr-nummer, email (hvis den er unik) o.l. |
|
| 0 - 1 | Brugers e-mail. | |
| BrugerOrganisationDto |
| 1 |
|
|
| 1 |
| |
| string | Pattern: [-][1]|[0-9]{1,8} | 1 | Organisationskode for den registrerende bruger. |
| date-time |
| 1 | Tidspunkt for registrering i DFDG |
GetGaestadgangeshistorik (GET /gaestadgang/{gaestadgangId}/historik)
Denne metode benyttes til at hente historik for en given gaestadgang, for en given borger.
Operation | Endpoint |
---|---|
GET | v1/gaestadgang/{gaestadgangId}/historik |
Input
[Personnummer i header]
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
PersonkommentarId | Guid | 1 |
Output
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
GaestadgangshistorikResponse | GaestadgangshistorikResponseDto | |||
(CommentHistoryCollection) | IEnumerable<GaestadgangshistorikDto> |
| 0 - 1 | Liste af historiske gaestadgange. |
(CommentIdentifier) | guid | 1 | Identifier for gaestadgang | |
(CommentText) | string | Length: 1-1000 | 1 | Gaestadgangskommentartekst |
(EventDate) | dateTime |
| 1 | Hændelsesdato for registreringen |
(CorrectionComment) | string |
| 0 - 1 | Kommentar til berigtigelse af en registrering. |
| ServiceModelBase |
| 1 |
|
| RegistreringsmetadataDto |
| 1 |
|
| boolean |
| 1 | Angiver om registreringen er en sletning |
| boolean |
| 1 | Det er en række som er aktuel (kan typisk også ses i PSS). |
| RegistrerendeMyndighedDto |
| 0 - 1 |
|
|
| 1 |
| |
| string | Length: 1-20 | 1 | Identifikation af organisation / myndighed |
| RegistrerendeBrugerDto |
| 0 - 1 |
|
| KaldendeBrugerDto |
| 1 |
|
| string | Length: 1-140 | 1 | Sagsbehandlers fulde navn, ved systemkald angives systemets og jobbets navn her. |
|
| 1 |
| |
| string | Length: 1-255 | 1 | Unik identifikation af brugeren, f.eks. en GUID, et medarbejder ID, system ID, bruger ID, certifikat ID, cpr-nummer, email (hvis den er unik) o.l. |
|
| 0 - 1 | Brugers e-mail. | |
| BrugerOrganisationDto |
| 1 |
|
|
| 1 |
| |
| string | Pattern: [-][1]|[0-9]{1,8} | 1 | Organisationskode for den registrerende bruger. |
| date-time |
| 1 | Tidspunkt for registrering i DFDG |
CreateGaestadgang (POST /gaestadgang/)
Operation | Endpoint |
---|---|
POST | v1/Gaestadgang/ |
Input
[Personnummer i Header]
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
CreateGaestadgangRequest | CreateGaestadgangRequestDto | 1 | ||
- Gaestadgangskommentar | string | Length: 1-900 | 1 | Begrundelse for behovet for adgang til borger |
Output
Task<Guid> hvor guid er gæstadgangens id.
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
CreateGaestadgangResponse | CreateGaestadgangResponseDto | 1 | ||
- Servicekvittering | ServicekvitteringDto | 1 | ||
- - Registreringstidspunkt | dateTime | 1 | Tidspunkt for transaktionen eller registrering. | |
- - RegistreringsId | guid | 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} | 1 | Unik identifikation af transaktion eller registrering. |
Fejlkoder
Nye fejlkoder | Fejlkode | Fejltekst | Beskrivelse |
---|---|---|---|
Findes allerede i BorgerKommunikation med en anden kode | 4405 | The person with specified cpr is dead | The person with specified cpr is dead |
4933 | The comment text cannot contain html tags | The comment text cannot contain html tags | |
4922 | User is not allowed to access the specified person | User is not allowed to access the specified person |