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

...

Web Service - ConsentAdministration

Denne administrative snitflade kan kun tilgåes af en administrativ bruger med den rette  nationale rolle.

Operation – ConsentRegistrationsGetV2

Name: ConsentRegistrationsGet

Beskrivelse:

Henter alle registreringer for en given borger.

Forespørgsel:

ConsentRegistrationsGetRequest der består af:

PatientPersonCivilRegistrationIdentifier Identifikation af borger der forespørges på.

Svar:

ConsentRegistrationsGetResponse der består af:

ConsentRegistrations Liste af alle aktive og inaktive registreringer for borgeren.

Fejlhåndtering:

Se den generelle beskrivelse af fejlhåndtering.

Roller:

Administrativ medarbejder

Forudsætninger:

Brugeren skal have den rette nationale rolle

Operation – ConsentAddPositiveV2

Name: ConsentAddPositiveV2

Beskrivelse:

Tilføjer et eller flere samtykker for den givne borger.

Forespørgsel:

ConsentAddPositiveV2Request der består af:

ConsentAdds Liste af samtykker, der skal tilføjes. Bemærk, at borgeren er identificeret i ConsentAdds.

Svar:

Ingen

Fejlhåndtering:

Se den generelle beskrivelse af fejlhåndtering.

Roller:

Administrativ medarbejder

Forudsætninger:

Brugeren skal have den rette nationale rolle

Operation – ConsentAddConstraintV2

Name: ConsentAddPositiveV2

Beskrivelse:

Tilføjer en eller flere spærringer for den givne borger.

Forespørgsel:

ConsentAddConstraintV2Request der består af:

ConsentAdds Liste af spærringer, der skal tilføjes. Bemærk, at borgeren er identificeret i ConsentAdds.

Svar:

Ingen

Fejlhåndtering:

Se den generelle beskrivelse af fejlhåndtering.

Roller:

Administrativ medarbejder

Forudsætninger:

Brugeren skal have den rette nationale rolle

Operation – ConsentModifyPositiveV2

Name: ConsentModifyPositiveV2

Beskrivelse:

Modificerer et eller flere samtykker for en borger.

Forespørgsel:

ConsentModifyPositiveV2Request der består af:

ConsentModifications Liste af samtykker som ønskes rettet. Bemærk, at borgeren er identificeret i ConsentModification.

Svar:

Ingen

Fejlhåndtering:

Se den generelle beskrivelse af fejlhåndtering.

Roller:

Administrativ medarbejder

Forudsætninger:

Brugeren skal have den rette nationale rolle

Operation – ConsentModifyConstraintV2

Name: ConsentModifyConstraintV2

Beskrivelse:

Opdaterer en eller flere spærringer for en borger.

Forespørgsel:

ConsentModifyConstraintV2Request der består af:

ConsentModifications Liste af spærringer som ønskes rettet. Bemærk, at borgeren er identificeret i ConsentModification.

Svar:

Ingen

Fejlhåndtering:

Se den generelle beskrivelse af fejlhåndtering.

Roller:

Administrativ medarbejder

Forudsætninger:

Brugeren skal have den rette nationale rolle

Operation – ConsentRevokeV2

Name: ConsentRevoke

Beskrivelse:

Tilbagekalder en eller flere registreringer i MinSpærring.  Dette finder sted ved inaktivering af givne registreringer.

Forespørgsel:

PatientConsentRevokeRequest der består af:

ConsentRevocations Liste af registreringer der skal tilbagekaldes.

Svar:

Ingen

Fejlhåndtering:

Se den generelle beskrivelse af fejlhåndtering.

Roller:

Administrativ medarbejder

Forudsætninger:

Brugeren skal have den rette nationale rolle

Web Service - ConsentAdministration

Dette er den oprindelige version af administrationssnitfladen.

...

Navn: ConsentRegistrationsGet

Beskrivelse:

Henter alle registreringer for en given borger.

Forespørgsel:

ConsentRegistrationsGetRequest der består af:

PatientPersonCivilRegistrationIdentifier Identifikation af borger der forespørges på.

Svar:

ConsentRegistrationsGetResponse der består af:

ConsentRegistrations Liste af alle aktive og inaktive registreringer for borgeren.

Fejlhåndtering:

Se den generelle beskrivelse af fejlhåndtering.

Roller:

Borger, person på vegne af borger.

Forudsætninger:

Både bruger og brugersystem skal godkendes som beskrevet i afsnitet Web Service Sikkerhed.Brugeren skal have den rette nationale rolle

Operation – ConsentAdd

Navn: ConsentAdd

Beskrivelse:

Tilføjer en eller flere samtykker eller spærringer for en given borger.

Forespørgsel:

ConsentAddRequest der består af:

ConsentAdds liste af beskrivelser af registreringer af samtykker/spærringer, der skal tilføjes. Bemærk, at borgeren er identificeret i ConsentAdds.

Svar:

Ingen

Fejlhåndtering:

Se den generelle beskrivelse af fejlhåndtering.

Roller:

Borger, sundhedsfaglig, person på vegne af borger.

Forudsætninger:

Både bruger og brugersystem skal godkendes som beskrevet i afsnitet Web Service Sikkerhed. Gentagne kald med identiske parametre vil der blive oprettet flere identiske spærringer eller samtykker.

...

Dette er en nyere version af administrationssnitfladen.

Operation – ConsentRegistrationsGetV2

Name: ConsentRegistrationsGet

Beskrivelse:

Henter alle registreringer for en given borger.

Forespørgsel:

ConsentRegistrationsGetRequest der består af:

PatientPersonCivilRegistrationIdentifier Identifikation af borger der forespørges på.

Svar:

ConsentRegistrationsGetResponse der består af:

ConsentRegistrations Liste af alle aktive og inaktive registreringer for borgeren.

Fejlhåndtering:

Se den generelle beskrivelse af fejlhåndtering.

Roller:

Borger, person på vegne af borger.

Forudsætninger:

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

Operation – ConsentAddPositiveV2

Name: ConsentAddPositiveV2

Beskrivelse:

Tilføjer et eller flere samtykker for den givne borger.

Forespørgsel:

ConsentAddPositiveV2Request der består af:

ConsentAdds Liste af samtykker, der skal tilføjes. Bemærk, at borgeren er identificeret i ConsentAdds.

Svar:

Ingen

Fejlhåndtering:

Se den generelle beskrivelse af fejlhåndtering.

Roller:

Borger, sundhedsfaglig, person på vegne af borger.

Forudsætninger:

Både bruger og brugersystem skal godkendes som beskrevet i afsnitet Web Service Sikkerhed. Gentagne kald med identiske parametre vil der blive oprettet flere identiske spærringer eller samtykker.

Operation – ConsentAddConstraintV2

Name: ConsentAddPositiveV2

Beskrivelse:

Tilføjer en eller flere spærringer for den givne borger.

Forespørgsel:

ConsentAddConstraintV2Request der består af:

ConsentAdds Liste af spærringer, der skal tilføjes. Bemærk, at borgeren er identificeret i ConsentAdds.

Svar:

Ingen

Fejlhåndtering:

Se den generelle beskrivelse af fejlhåndtering.

Roller:

Borger, sundhedsfaglig, person på vegne af borger.

Forudsætninger:

Både bruger og brugersystem skal godkendes som beskrevet i afsnitet Web Service Sikkerhed. Gentagne kald med identiske parametre vil der blive oprettet flere identiske spærringer eller samtykker.

Operation – ConsentModifyPositiveV2

Name: ConsentModifyPositiveV2

Beskrivelse:

Modificerer et eller flere samtykker for en borger.

Forespørgsel:

ConsentModifyPositiveV2Request der består af:

ConsentModifications Liste af samtykker som ønskes rettet. Bemærk, at borgeren er identificeret i ConsentModification.

Svar:

Ingen

Fejlhåndtering:

Se den generelle beskrivelse af fejlhåndtering.

Roller:

Borger eller person på vegne af borger.

Forudsætninger:

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

Operation – ConsentModifyConstraintV2

Name: ConsentModifyConstraintV2

Beskrivelse:

Opdaterer en eller flere spærringer for en borger.

Forespørgsel:

ConsentModifyConstraintV2Request der består af:

ConsentModifications Liste af spærringer som ønskes rettet. Bemærk, at borgeren er identificeret i ConsentModification.

Svar:

Ingen

Fejlhåndtering:

Se den generelle beskrivelse af fejlhåndtering.

Roller:

Borger eller person på vegne af borger.

Forudsætninger:

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

Operation – ConsentRevokeV2

Name: ConsentRevoke

Beskrivelse:

Tilbagekalder en eller flere registreringer i MinSpærring.  Dette finder sted ved inaktivering af givne registreringer.

Forespørgsel:

PatientConsentRevokeRequest der består af:

ConsentRevocations Liste af registreringer der skal tilbagekaldes.

Svar:

Ingen

Fejlhåndtering:

Se den generelle beskrivelse af fejlhåndtering.

Roller:

Borger

Forudsætninger:

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

...