Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Det er anvendersystemets ansvar at sikre, at de anvendte ID'er er unikke, så de kan skelnes på den returnerede liste. Tjenesten bruger ikke ID'erne til andet end returlisten.

Web Service - ConsentVerification

Nedenstående operationer er udstillet af MinSpærring Verifikation.

Operation – ConsentForUserCheck

Navn: ConsentForUserCheck

Beskrivelse:

Undersøger om en borger har oprettet generelt samtykke, spærring eller data specifik spærring for en bruger.

Forespørgsel:

ConsentForUserCheckRequest består af:

PatientPersonCivilRegistrationIdentifier Identifkation af den borger samtykke/spærring ønskes undersøgt.

HealthcareProfessionalIdentifier
Identifkation af den sundhedsfaglige.

HealthcareProfessionalIdentifierOnBehalfOf
Identifikation af en sundhedsfaglig person på hvis vegne der træffes handling (udfyldes kun, hvis den udførende person er en sundhedsfaglig, der handler på vegne af en sundhedsfaglig med tilladelse i Sundhedsstyrelsens autorisationsregister).

HealthcareProfessionalOrganization
Identifikation af den sundhedsfaglige tilknyttede organisation.

Svar:

ConsentForUserCheckResponse består af:

ConsentIndication Samtykke, spærring eller dataspecifkt samtykke i nedenstående form:

Positive – betyder at den sundhedsaglige har adgang til data.

Negative – betyder at den sundhedsfaglige, eller dennes tilknyttede organisation, ikke har adgang til borgerens data.

DataSpecificConsent - betyder at der er registreret dataspecikt samtykke eller spærring. Derfor er det ikke muligt at afgøre om den sundhedsfaglige har adgang til data. Derfor skal der laves opfølgende kald til operationen ConsentForDataCheck.

Error handling:

Se afsnit 4.7.

Roles:

Sundhedsffaglig.

Prerequisites:

Både bruger og brugersystem skal godkendt som beskrevet i afsnitet Web Service Sikkerhed.

Operation – ConsentForDataCheck

Navn: ConsentForDataCheck

Beskrivelse:

Undersøger om en borger har oprettet data specifikke spærringer eller samtykker.

Forespørgsel:

ConsentForDataCheckRequest består af:

PatientPersonCivilRegistrationIdentifier Identifkation af den borger samtykke/spærring ønskes undersøgt.

HealthcareProfessionalIdentifier
Identifkation af den sundhedsfaglige.

HealthcareProfessionalIdentifierOnBehalfOf
Identifikation af en sundhedsfaglig person på hvis vegne der træffes handling (udfyldes kun, hvis den udførende person er en sundhedsfaglig, der handler på vegne af en sundhedsfaglig med tilladelse i Sundhedsstyrelsens autorisationsregister).

HealthcareProfessionalOrganization
Identifikation af den sundhedsfaglige tilknyttede organisation.

ConsentForDataRegistrations
Liste af datalementer der skal tjekkes for spærring eller samtykke registrering.

Svar:

ConsentForDataCheckResponse består af:

PositiveConsentDataRegistrations Liste af dokument ID fra forespørgsel som den sundhedsfaglige har lov til at se. professional.

Fejlhåndtering:

Se afsnit 4.7.

Roller:

Sundhedsfaglig.

Forudsætninger:

Både bruger og brugersystem skal godkendt som beskrevet i afsnitet Web Service Sikkerhed.

MinSpærring Verifikation Web Service Skemaer

Dette afsnit giver en generel beskrivelse af nøgleelementerne i XML-skemaerne, som sammen med WSDL-filer definerer de webservicefunktioner, der er beskrevet i 3.2. Derudover gives kardinalitet, når et element ikke er obligatorisk.

HealthcareProfessionalIdentifierOnBehalfOf

Element-navn

Beskrivelse

HeathcareProfessionalIdentifierOnBehalfOf

Identifikation af den sundhedsfaglige der arbejdes på vegne af.  Feltet er optionelt og kan angives uden samtykke.

ConsentForDataRegistrations

Element-navn

Beskrivelse

ConsentDataRegistration[0..n]

Liste af data elementer der skal laves verifikation på.

ConsentDataRegistration

Element-navn

Beksirvelse

Identifier[1]

Unik identifikation af data element (nøgleværdi) som angivet af kalende system.

Origin[1]

SOR, SHAK eller yder nummer der angiver hvilken organisation datalementet stammer fra.

CreationDateTime[1]

Tidspunkt hvor dataelement blev oprettet.

ConsentIndication

Element-navn

Beskrivelse

ConsentIndication

Positim, negativ eller data specifikt. Nedenstående værdisæt anvendes:

Positive, Negative, DataSpecificConsent

ConsentForDataResponse

Element-navn

Beskrivelse

DataIdentifiers[0..n]

Liste af unikke id af data element (nøgleværdi) som angivet af det kalende system.

ConsentForForeigners

Element-navn

Beskrivelse

ConsentForForeigners

Positiv eller negativ med nedenstående værdisæt:

Positive, Negative


Samtykkeservicen Administration

...

Dette afsnit giver en generel beskrivelse af nøgleelementerne i XML-skemaerne, der sammen med WSDL definerer de services der er beskrevet tidligere Hvor eksisterende OIO-typer identificeres, angives den i parentes efter elementnavnet. Derudover tilvejebringes kardinalitet, når et element ikke er obligatorisk.

ConsentItem

Element-navn

Beskrivelse

CitizenCPR

borgerens CPR nummer.

ConsentId

Unik ID på registreringen

PositiveConsent

Sandt hvis der er tale om et samtykke.

What[0..1]

Beskrivelse af hvilke data registreringen dækker.

Who [0..1]

Beskrivelse afsundhedsfaglig person eller organisation som registreringen dækker.

ValidFrom

Hvornår registreringen er gyldig. Bemærk at dette kun er en dato.

ValidTo [0..1]

Hvornår registreringen ikke længere er gyldt. Bemærk at dette kun er en dato.

WhatItem

Element-navn

Beskrivelse

OrganizationIdentifier

Identifikation af specifik sundhedsorganisation, muligvis med underorganisationer, hvorfra data stammer

IncludeSuborganizations

Om data fra underorganisationer for den angivne organisation også er inkluderet i registreringen.

ReferralStartDate [0..1]

Startdato fra hvor data er gældende.

ReferralEndDate [0..1]

Slutdato fra hvor data er gældende.

WhoItem

Element-navn

Beskrivelse

HealthcareProfessionalIdentifier

Identifikation af en bestemt sundhedsfaglig ved hjælp af CPR-nummer.

Eller


OrganizationIdentifier

Identifikation af specifik sundhedsorganisation, muligvis inkluderende underorganisationer.

Eller


ForeignHealthcareProfessionals

Angiver med værdien sandt, at samtykke dækker udenlandske sundhedspersonale (epSos).

IncludeSuborganizations

Om data for underorganisationer for den angivne organisation også er inkluderet i registreringen. Kun relevant, hvis OrganizationIdentifier er udfyldt.

ConsentAdds

Element-navn

Beskrivelse

ConsentItems

Liste af ConsentItem.

ConsentRegistrations

Element-navn

Beskrivelse

ConsentRegistrations

Liste af ConsentItem.

ConsentModification

Element-navn

Beskrivelse

ConsentItems

Liste af ConsentItem

ConsentRevocation

Element-navn

Beskrivelse

ConsentRevocations

Liste af ConsentItem.


Eksempler

I dette afsnit gives eksempler på, hvordan man kan bruge et Java-baseret systemet til at kalde de to services.

...