Denne funksjonaliteten er under spsifisering. Dvs. dokumentasjonen kan ikke benyttes som grunnlag for implementering enda.
Innledning
PVK inneholder fullmakter en innbygger gir til en annen. Dersom en aktør ønsker å få hendelser fra PVK om fullmakter som opprettes og slettes, er det mulig å abonnere på slike hendelser. Abonnementet vil være knyttet til de type fullmakter aktøren har rett til å abonnere på. Slev om en aktør abonnerer på slike hendelser, vil PVK alltid være master for fullmalktsinformasjon.
Grunnleggende om grensesnittet
Ekstern aktør må ha et REST grensesnitt som er tilgjengelig over HTTPS. Gresesnittet må være tilgjengelig enten på Internett eller på Helsenettet.
PVk vil kalle dette grensesnittet når en fullmakt, av en type aktøren abonnerer på, opprettes eller slettes
Headeren i requesten vil ha et JWT-token utstedt av Helsenorge STS, som aktøren skal validere i henhold til beskrivelsene her: Helsenorge eller PVK som system- på vegne av innbygger
Dersom PVK ikke får postiv respons fra aktøren, vil det gjøres gjentagende forsøk. (Intill 5 ganger med økende tidsintervall)
Endepunkt hos aktør og Payload i request
Ekstern part må ha et API som implementerer dette endepunktet.
TjenesteNavn | HttpVerb | Beskrivelse |
---|---|---|
LagreFullmaktInformasjon | POST | Ekstern part må lagre/slette informasjon om en fullmakt. |
LagreInnbyggersPersonvernInnstilling
Parametere i request
Navn | Type | Lovlige verdier | Kommentar |
---|---|---|---|
fullmaktDefinisjonGuid | string | GUID | GUID for den fullmaktdefinisjon det gjelder |
fullmaktVirkeomradeId | int | Enumverdier (kan utvides) | Angir fullmaktens virkeområde, dvs. hvor den kan benyttes 1 - Helsenorge 2 - Apotek og bandasjister 3 - Hele Helse- og Omsorgssektoren |
fullmaktType | int | Enumverdi (kan utvides) | 1- Ordinær fullmakt 2 - Tildelt fullmakt (fullmaktsgiver er ikke samtykkekompetent) |
handling | int | Enum | 1 - Fullmakt opprettet 2 - Fullmakt slettet |
opprettetTidspunkt | time | Tidspunkt for når fullmakten ble opprettet | Vil alltid være satt, og verdien reflekterer når fullmakten ble opprettet |
opprettetAvType | int | enum (kan utvides) | 1- Innbygger selv (via Helsenorge) 2 - Representant for innbygger (via Helsenorge) 3 - Saksbehandler |
sistEndretTidspunkt | time | Tidspunkt for når fullmakten sist ble endret. | Vil være samme som opprettetTidspunkt dersom en fullmakt opprettes. Vil være når fullmakten ble slettet, dersom en fullmakt slettes. |
endretAvType | int | enum (kan utvides) | 1- Innbygger selv (via Helsenorge) 2 - Representant for innbygger (via Helsenorge) 3 - Saksbehandler |
fullmaktsgiverFnr | string | fødselsnummer (11 siffer) | Dette er fødselsnummer til den innbygger som det er gitt fillmakt for til en annen |
fullmaktshaverFnr | string | fødselsnummer (11 siffer) | Dette er fødselsnummer til den innbygger som har fått fullmakt for en annen |
gyldigFraTidspunkt | time | Kan ikke være tidligere enn fullmakten ble opprettet. | Er alltid satt. |
gyldigTilTidspunkt | time | Må være senere enn da fullmakten gjelder fra | Vil være “null” dersom det ikke er satt noen tidsbegrensning for fullmaktens varighet. |
fullmaktOmfang
| liste string | Verdier som er definert på definisjonen | Liste med “omfangkoder” som er definert for den aktuelle Fullmaktdefinisjon. Må være kjent der fullmakten skal anvendes., dvs. på brukerstedene. Dersom en fullmakt har et fast omfang, og dermed en fast omfangkode, kan brukerstedet forholde seg kun til fullmaktens definisjonsGuid. |
Eksempel - ny fullmakt opprettet
{ "fullmaktDefinisjonGuid":"3FE2A80A-4200-42E2-817B-DA8A6236708A", "fullmaktVirkeomradeId": 2, "fullmaktType":1, "handling":1, "opprettetTidspunkt":"2024-01-16T11:09:38.4871148+01:00", "opprettetAvTypeId": 1, "sistEndretTidspunkt":"2024-01-16T11:09:38.4871148+01:00", "endretAvTypeId": 1, "fullmktGiverFnr":"12045645510", "fullmktHaverFnr": "27018745510", "gyldigFraTidpunkt": "2024-01-16T11:09:38.4871148+01:00", "gyldigTilTidspunkt": "2027-01-16T00:00:00.0000000+01:00", "fullmaktOmfang": [ { "omfangKode": "JOURNALINFO" }, { "omfangKode": "UTLEVERINGRESEPTER" } ] }
Responsparametre (som ekstern part skal sette):
OK, replikering mottatt:
HTTP responskode: 200
og
Body: “returkode”: “ok”
Replikering ikke ok
Enten:
HTTP responskode 200
og
Body:
“returkode”: “ikkeOk”
“feilkode”: “Forklaring på hvorfor feil”
Eller:
HTTP responskode: Annet enn 200