Page History
...
Element | Beskrivelse | Type | Obligatorisk |
|---|---|---|---|
id | Angiver borgerens ID (CPR-nummer uden bindestreg). | string | Ja |
classification | Typen af ID. Gyldige værder er (CPR): 'CPROID:1.2.208.176.1.2' | string | Ja |
Bemærk, person-id'et er type-klassificeret, så der i fremtiden kan understøttes flere person-id typer, f.eks. eCPR, EU person id, etc.
Læs mere om klassifikationer og OID'er her: FSK - Guide til anvendere.
DentistID Element
Element | Beskrivelse | Type | Obligatorisk |
|---|---|---|---|
id | Angiver tandlægeklinikkens ID i den valgte klassifikationet ID hørende til tandlægeklinikken. | string | Ja, og må ikke være None/Null. |
classification | Typen af ID. Gyldige værder er:
| string | Ja, og må ikke være None/Null. |
Bemærk, id'et er type-klassificeret, så der i fremtiden kan understøttes flere id typer.
...
Læs mere om klassifikationer og OID'er her: FSK - Guide til anvendere.
ddtvStatus Element
Element | Beskrivelse | Type | Obligatorisk |
|---|
time
Tidspunkt for afsendelse af besked
exists | Borgeren findes i databasen. | bool |
Ja, og |
må ikke være None/Null. |
type
0: Anmodning om optagelse
1: Påmindelse
2: Ignorer tidligere henvendelser
int
createdTime | Tidspunktet elementet blev dannet i databasen. | DateTime | Betinget. Hvis exists=true, så er den obligatorisk og må ikke |
være None/Null. |
ddtvStatus Element
chosenDentist | Den valgte tandlæge. | DentistID | Betinget. Hvis exists=true, så er elementet obligatorisk. Kan |
Element
Beskrivelse
Type
Obligatorisk
exists
Borgeren findes i databasen.
bool
være None/Null hvis borgeren endnu ikke har valgt tandlæge. |
dentistChoiceStatus | 'noDentist': Borgeren har ikke (valgt) en tandlæge |
' |
dentistChosen': Borgeren har valgt en tandlæge, men tandlægen er ikke blevet kontaktet. 'dentistContacted': Borgeren har valgt og tandlægen er kontaktet. Tandlægen har endnu ikke svaret. 'dentistAccepted': Tandlægen har accepteret og borgeren vil blive kontaktet mhp. kontrol. 'dentistRejected': Tandlægen kan eller ønsker ikke at optage borgeren i sin praksis. 'timedOut': Tandlægen svarede ikke på henvendelsen inden for svarfristen. 'communicationFailure': Der kunne ikke sendes besked til tandlægen. | String |
/ None | Betinget. Hvis exists=true, så er den obligatorisk og må ikke være None/Null. Invariant: Hvis dentistChoiceStatus != noDentist så er chosenDentist != null | ||
dentistMayBeContacted | Den valgte tandlæge må kontaktes af DDTV. | bool | Betinget. Hvis exists=true, så er den obligatorisk og må ikke være None/Null. |
reminderList |
Liste med tidspunkter, hvor borgeren er blevet påmindet om at vælge tandlæge. | Liste af |
DateTime elementer ([DateTime]) | Betinget. Hvis exists=true, så er den obligatorisk. Skal være tom liste ([ ]), hvis der endnu ikke er sendt påmindelse |
dentistContactedList
Tidspunkter og typer af beskeder til den valgte tandlæge
Liste af ddtvDentistContact elementer
. Må ikke være None/Null. | |
noMoreReminders | Borgeren ønsker ikke flere påmindelser |
. | bool | Betinget. Hvis exists=true, så er den obligatorisk og må ikke være None/Null. |
OptOut
Borgeren ønsker ikke at bruge ddtv
dpStatus | Status på afsendelse af digital post til borgeren | String |
Betinget. Hvis exists=true, så er den obligatorisk og må ikke være None/Null. Værdier:
| |||
citizenPhoneNr | Telefonnummer til kontakt til borgeren. | String | Nej |
Operationer / Funktioner
ddtvCheckStatus(...)
...
| Element | Type | Beskrivelse | evt. note |
|---|---|---|---|
| status | [ddtvStatus]Status for Borgerens ddtv forløb | Liste med ddtvStatus elementer der overordnet viser forløbet i valg af tandlæge over tid. | Der returneres en liste af ddtvStatus-elementer i omvendt kronologisk rækkefølge (nyeste først). Elementerne er svarer 1-1 en denormalisering af til kæden af 'DentistChoices' i databasen. Se Se 5. Udkast til ER-model. |
ddtvApplyForNewDentist(...)
Registrerer et tandlægevalg. Hvis borgeren allerede har valgt en registreret tandlæge overskrives denne. Der gemmes historik i databasentandlæge (status ikke lig med 'noDetist'}, oprettes en ny entry i databasen, og status sættes til 'dentistChosen'. Bemærk: requestID og dpStatus skal sættes til 'Null' i det nye element.
Input:
| Element/Parameter | Type | Beskrivelse | evt. note |
|---|---|---|---|
| personID | PersonID | ID på borgeren (CPR) | I normaltilfældet vil personID være lig ID'et i IDWS Identititokenet, hvor der efterspørges status for personen selv. Hvis den kaldende person gør brug af fuldmagt eller forældremyndighed, vil personID være på hhv. fuldmagtsgiver eller barnet. Elementet er type-klassificeret, så der på sigt kan understøttes andre person-id typer (se datatypebeskrivelsen ovenfor). Alle CPR numre skal alle checkes gennem CPR enkeltopslagsservice på NSP. Hvis CPR-nummeret ikke findes eller peger på en død person, skal der returneres en fejl. |
| dentistID | DentistID | ID på tandlægeklinikken (SOR) | SOR-id'et skal kontrolleres for eksistens og gyldighed gennem SOR enkeltopslagsservice på NSP. Findes ID'et ikke, eller peger ID'et på en ikke-aktiv enhed, skal der returneres en fejl. |
| dentistLocationnumber | DentistID | Lokationsnummer til klinikken (Lokationsnummer til EDI forsendelse) | Lokationsnummeret hørende til SOR-enheden (dentistID). Mandatory i DDTV version 1.0 (2025) men vil senere udgå eller blive valgfri. |
| citizenPhoneNr | String | Borgerens telefonnummer. | Kan angives i brugergrænsefladen på "Din Digitale Tandlægevælger" på Sundhed.dk. Feltet er ikke obligatorisk. |
Output:
| Element | Type | Beskrivelse | evt. note | ||
|---|---|---|---|---|---|
| status | ddtvStatus | Status for Borgerens ddtv forløb | bool | OK / Fail | Hvis 'Fail' returneres en beskrivelse af årsagen til at operationen fejlede. status: {exists = true, dentistChosen = dentistID dentistMayBeContacted = true (med mindre andet er valgt) reminderList = None eller [] dentistContactedList = None eller [] (lagt på kø) noMoreReminders = false optOut = false} |
ddtvDisregardApplicationForNewDentist(...)
...
| Element | Type | Beskrivelse | evt. note | ||
|---|---|---|---|---|---|
| status | ddtvStatus | Status for Borgerens ddtv forløb | bool | OK / Fail | Hvis 'Fail' returneres en beskrivelse af årsagen til at operationen fejlede. status: {exists = true, dentistChosen = None dentistMayBeContacted = false reminderList = None eller [] dentistContactedList = None eller [] noMoreReminders = false optOut = false} |
ddtvOptOut(...)
Registrerer at borgeren ikke ønsker at indgå i tandlægevalg løsningen. Der gemmes historik i Alle data om borgeren slettes fra databasen.
Input:
| Element/Parameter | Type | Beskrivelse | evt. note |
|---|---|---|---|
| personID | PersonID | ID på borgeren (CPR) | I normaltilfældet vil personID være lig ID'et i IDWS Identititokenet, hvor der efterspørges status for personen selv. Hvis den kaldende person gør brug af fuldmagt eller forældremyndighed, vil personID være på hhv. fuldmagtsgiver eller barnet. Elementet er type-klassificeret, så der på sigt kan understøttes andre person-id typer (se datatypebeskrivelsen ovenfor). Alle CPR numre skal alle checkes gennem CPR enkeltopslagsservice på NSP. Hvis CPR-nummeret ikke findes eller peger på en død person, skal der returneres en fejl. |
...
| Element | Type | Beskrivelse | evt. note | |||
|---|---|---|---|---|---|---|
| status | ddtvStatus | Status for Borgerens ddtv forløb | status: {exists = true, dentistChosen = None dentistMayBeContacted = false reminderList = None eller [] dentistContactedList = None eller [] noMoreReminders = false optOut = true} | bool | OK / Fail | Hvis 'Fail' returneres en beskrivelse af årsagen til at operationen fejlede. |
ddtvNoMoreReminders(...)
Registrerer at borgeren stadig ønsker at benytte løsningen, men ikke ønsker (flere) reminders.
...
| Element | Type | Beskrivelse | evt. note | |||
|---|---|---|---|---|---|---|
| status | ddtvStatus | Status for Borgerens ddtv forløb | status: {exists = true, dentistChosen = (som i databasen nu) dentistMayBeContacted = (som i databasen nu) reminderList = (som i databasen nu) dentistContactedList = (som i databasen nu) noMoreReminders = true optOut = true} | bool | OK / Fail | Hvis 'Fail' returneres en beskrivelse af årsagen til at operationen fejlede. |
ddtvNewDentistFullStop(...)
Registrerer at borgeren stadig ønsker at benytte løsningen, men ikke ønsker (flere) remindersikke at tandlægen skal kontaktes. 'status' sættes til 3 ('dentistAccepted').
Input:
| Element/Parameter | Type | Beskrivelse | evt. note |
|---|---|---|---|
| personID | PersonID | ID på borgeren (CPR) | I normaltilfældet vil personID være lig ID'et i IDWS Identititokenet, hvor der efterspørges status for personen selv. Hvis den kaldende person gør brug af fuldmagt eller forældremyndighed, vil personID være på hhv. fuldmagtsgiver eller barnet. Elementet er type-klassificeret, så der på sigt kan understøttes andre person-id typer (se datatypebeskrivelsen ovenfor). Alle CPR numre skal alle checkes gennem CPR enkeltopslagsservice på NSP. Hvis CPR-nummeret ikke findes eller peger på en død person, skal der returneres en fejl. |
| dentistID | DentistID | ID på tandlægeklinikken (SOR) | SOR-id'et skal kontrolleres for eksistens og gyldighed gennem SOR enkeltopslagsservice på NSP. Findes ID'et ikke, eller peger ID'et på en ikke-aktiv enhed, skal der returneres en fejl. |
...
| Element | Type | Beskrivelse | evt. note | ||
|---|---|---|---|---|---|
| status | ddtvStatus | Status for Borgerens ddtv forløb | bool | OK / Fail | Hvis 'Fail' returneres en beskrivelse af årsagen til at operationen fejlede. status: {exists = true, dentistChosen = dentistID dentistMayBeContacted = false reminderList = None eller [] dentistContactedList = None eller [] noMoreReminders = true optOut = false} |