Denna implementationsguide beskriver hur man bör ange och identifiera vårdpersonal och enheter via HSA-id och organisationsnummer

Status

DEV

Versionshistorik

Bakgrund

Vårdpersonal och organisatoriska enheter inom hälso- och sjukvården identifieras i Sverige med hjälpa av HSA-id (HSA var ursprungligen en akronym men är nu ett egennamn. Tjänsten hos Inera heter Katalogtjänst HSA).

Inera beskriver detta som:

HSA elektronisk katalog som innehåller kvalitetssäkrade uppgifter om personer, enheter och funktioner i Sveriges kommuner, landsting och privata vårdgivare.
Informationen i HSA används av många olika tjänster och utgör viktigt underlag för behörighetsstyrning, olika säkerhetslösningar samt för sök- och jämförelsetjänster. Samlad information gör det möjligt att upprätthålla god kvalitet på uppgifterna, minska dubbeladministration, samt att underlätta åtkomsten till informationen för andra e-tjänster.

HSA-id är en unik identifierare för de objekt som HSA håller information om. HSA-id byggs upp av landskoden (SE), organisationsnummer för direktanslutna producenten,10 tecken utan bindestreck, (t.ex. landstingets organisationsnummer, 2321000131), bindestreck “-” och därefter <valfria bokstäver (A-Z och a-z) och/eller siffror (0-9)>. Observera att tecknen å, ä, ö samt @-tecken inte är tillåtna. HSA-id får inte överskrida 31 tecken totalt.

Organisationsnummer är en identitetsbeteckning för juridiska personer (bolag, föreningar, stiftelser, myndigheter och andra organisationer) på motsvarande sätt som personnummer är en identitetsbeteckning för fysiska personer (läs mer om organisationsnummer hos Skatteverket).

Denna implementationsguide beskriver hur man ska ange HSA-identifierare och organisationsnummer på ett konsekvent sätt inom ramen för openEHR-implementeringar.

I openEHR kan man använda många sorters identifierare inklusive OID och URI. I denna version av implementationsguiden väljer vi att representera OIDar i sin URI/URN-form, dvs som urn:oid:1.2.3.4… eftersom det börjar bli ett vanligt mönster (i t.ex. HL7 FHIR) och många programmerare är mer bekanta med URIer än OIDar.

Diagram och klassbeskrivningar

Inom openEHR används ofta PARTY_PROXY eller någon av dess subklasser (t.ex. PARTY_IDENTIFIED) för att hänvisa till personer, organisationer m.m. Se t.ex. implementationsguiden för PDL och bilderna nedan.

Inuti PARTY_IDENTIFIED finns attributet identifiers som är en lista med DV_IDENTIFIER-objekt

Open

Källa: https://specifications.openehr.org/releases/RM/latest/data_types.html#_data_types_information_model

Fördjupning om HSA-id

• Värdet på HSA-id MÅSTE anges på DV_IDENTIFIER.id i sin helhet.

  • Exempel: SE2321000016-1003

• Att det rör sig om just ett HSA-id MÅSTE anges genom att sätta DV_IDENTIFIER.type=urn:oid:1.2.752.29.4.19 Detta är OID för HSA-id omgjort till en URI

• Eftersom issuer kan slås upp via OID-register och assigner (t.ex. en region) framgår av organisationsnumret i början av ett HSA-id så lämnar vi de två valfria attributen tomma

Exempel på HSA-id

…

Instansexempel

LÄGG TILL EXEMPEL PÅ SERIALISERING (JSON-snutt?) AV en PARTY_IDENTIFIED med namn+identifiers

Fördjupning om Organisationsnummer

• Värdet på organisationsnumret MÅSTE anges på DV_IDENTIFIER.id i sin helhet

• Att det rör sig om just ett organisationsnummer MÅSTE anges genom att sätta DV_IDENTIFIER.type=urn:oid:2.5.4.97 = Svenskt organisationsnummer enligt SKV 709

• Eftersom issuer kan slås upp via OID-register och assigner inte tillför värde i ett svenskt kontext (SCB eller bolagsverket eller annan myndighet brukar vara utgivare) så lämnar vi de två valfria attributen tomma.

Exempel på organisationsnummer

Instansexempel

LÄGG TILL EXEMPEL PÅ SERIALISERING (JSON-snutt?) AV en PARTY_IDENTIFIED med namn+identifiers

Övrigt

• Att dubbelkolla/utreda: I de svenska FHIR-bas-profilerna används ibland URL och ibland OID för att markera typ av identifikation, kan det vara av intresse här med. Exempel:

  • urn:oid:1.2.752.29.4.19 = HSA-ID, Unik identifierare för personer, enheter, funktioner, uppdrag och organisationer inom vård och omsorg

  • urn:oid:1.2.752.29.4.13 = Personnummer eller samordningsnummer enligt SKV 704 respektive SKV 707.

  • urn:oid:2.5.4.97 = Vårdgivares Organisationsnummer Svenskt organisationsnummer enligt SKV 709 -Nej verkar vara en generell internationell organisationsidentifierar-OID

  • urn:oid:1.2.752.29.6.2.1 = Personens HsaId. Notera att en person kan ha flera employeeHsaId utgivna från olika katalogägare inom HSA. Ett employeeHsaId är dock alltid unikt identifierande och spårbart till individen. Typical Use Identifiering av inloggade användare i e-tjänster vård och omsorg

  • urn:oid:1.2.752.116.3.1.2 Personlig förskrivarkod.

  • http://electronichealth.se/identifier/personnummer

  • http://electronichealth.se/identifier/samordningsnummer

  • http://electronichealth.se/identifier/nationelltReservnumer

  • http://sambi.se/attributes/1/organizationIdentifier