Vårdenheter > Hantering HSA-id vårdenheter

Hantering HSA-id vårdenheter

Syfte med kartläggningen

(Kartläggning slutförd 2012-10-26)

Att kartlägga på vilka ställen som HSA-id för vårdenheter används i TakeCare samt att beskriva hur HSA-id används på dessa ställen (eventuell formatering etc). Utöver det beskrivs även vilka eventuella problem som finns eller kan uppstå i TakeCare och i olika integrationer, om formateringen på ett HSA-id för en vårdenhet ändras i vårdenhetsregistret.

Moduler i TakeCare som berörs av HSA-id

Ett hundratal moduler/funktioner i TakeCare har undersökts med avseende på HSA-id för vårdenheter. Nedan listas funktionalitet som skulle kunna påverkas av förändringar av HSA-id.

Nya externa enhetsregistret

Det Nya externa enhetsregistret används för närvarande bara i Dalarna och VGR, men kan vara relevant även för Stockholm längre fram, se t.ex. konsultationsremiss. Användarna lägger själva in HSA-id, samt eventuella andra id:n för vårdenheterna, i en textfil (semikolonseparerad) via t.ex. Excel. Informationen importeras sedan till TakeCare, varvid inledande och avslutande mellanslag tas bort (utom för Kombika). Vid hämtning av HSA-id till TakeCare-klient, görs det om till versaler och eventuella mellanslag tas bort.

Stockholm använder AVDCSYVER/KOMBIKAREG, som inte innehåller HSA-id. Det finns en batch XTPREPARE under utveckling, som fyller Nya externa enhetsregistret från samma källmaterial som den som fyller gamla externa enhetsregistret.

Konsultationsremiss

Den nya funktionen E-remiss är beroende av att både HSA-id och Kombika finns för remissmottagande vårdenheter i vårdenhetsregistret och/eller i det gamla externa enhetsregistret i TakeCare.  Funktionen kräver även att formatet på HSA-id och Kombika är samma i TakeCare som i övriga system (som också ska använda E-remiss). Enligt nuvarande design kommer inte E-remissen att komma fram till mottagaren, om formatet på HSA-id:t ej är identiskt i de olika systemen.

HSA-id saknas i det gamla externa enhetsregistret i Stockholm, men finns i det Nya externa enhetsregistret som används i Dalarna och VGR.

I det centrala mottagarregistret i TakeCare (som används när remisser skapas i TakeCare) lagras HSA-id från vårdenhetsregistret, nya externa enhetsregistret eller så anges det manuellt av administratör.

Externa tjänster – konfigureras av kund

I modulen ”Externa tjänster” har kunden möjlighet att lägga upp och konfigurera egna uthopp till externa system och tjänster. Om variabeln $UNITHSAID$ används i något av uthoppen, skickas HSA-id:t exakt så som det är inskrivet för den aktuella vårdenheten i vårdenhetsregistret.

Eftersom CGM ej är involverade i konfigureringen av externa tjänster, måste kunden själv ansvara för att undersöka vilka uthopp som använder HSA-id samt hur de skulle påverkas vid en eventuell förändring av HSA-id:t i vårdenhetsregistret.

Om olika externa tjänster kräver olika format på HSA-id, kan flera variabler för HSA-id läggas till (kräver utveckling av CGM). Förutsättningen för detta är dock ett enhetligt format på alla HSA-id:n i vårdenhetsregistret, annars är en formatering till olika format inte alltid möjlig.

Externa system och tjänster – hårdkodade

* betyder att det externa systemet/tjänsten behandlas i ett separat avsnitt längre ner i dokumentet.

*Picsara-Mobilesync

I Picsara finns det en mappningstabell, där en TakeCare-vårdenhet mappas mot en Picsara-avdelning. En Picsara-avdelning kan omfatta flera TakeCare-vårdenheter. Denna mappning kan antingen bygga på TakeCare-vårdenhetens HSA-id eller Kombika. Alla HSA-id:n i mappningstabellen måste överensstämma exakt med alla HSA-id:n i TakeCares vårdenhetsregister, för att integrationen med Picsara ska fungera (skifteslägeskänsligt, blanksteg etc).

Alla förändringar av HSA-id i vårdenhetsregistret för vårdenheter som använder Picsara, t.ex. tillägg/borttag av bindestreck, kan göra att integrationen mellan TakeCare och Picsara slutar att fungera. Alla sådana förändringar borde därför stämmas av med Picsara-förvaltningen innan de genomförs.

SLSO har enligt uppgift använt HSA-id med minustecken (-) för alla vårdenheter som använder Picsara. HSA-id:t har kopierats direkt från EK. SLLIT har enligt uppgift hittills använt Kombika i Picsara-integrationen, men ska övergå till HSA-id.  

PI-dos (dosdispensering)

I anropet från TakeCare till PI-dos används HSA-id för den aktuella vårdenheten oförändrat från vårdenhetsregistret. Max 17 tecken accepteras av dosapoteket och både HSA-id med och utan bindestreck fungerar högst troligt.

Alla förändringar av HSA-id i vårdenhetsregistret för vårdenheter som använder PI-dos, t.ex. tillägg/borttag av bindestreck, kan göra att integrationen mellan TakeCare och PI-dos slutar att fungera. Alla sådana förändringar måste därför meddelas dosapoteket i god tid. De behöver enligt uppgift få information om vilken vårdenhet förändringen gäller, vad HSA-id:t ändras till samt vilken dag ändringen kommer att genomföras. Dosapoteket måste gå in och göra en manuell ändring hos sig samma dag, annars kommer anropen att hamna i fail.

Elektroniska sjukintyg och ”Ställ fråga”-uthopp

För elektroniska sjukintyg och i uthoppet ”Ställ fråga” skickas HSA-id för vårdenheten med oförändrat från vårdenhetsregistret i TakeCare. Försäkringskassan eller Nationella Tjänstplattformen skulle kunna använda HSAID:t för att göra uppslag mot HSA-katalogen för att verifiera enheten eller hämta uppgifter, det är idag okänt om det görs.

Alla förändringar av HSA-id i vårdenhetsregistret för vårdenheter som använder dessa tjänster mot Försäkringskassan, t.ex. tillägg/borttag av bindestreck, kan göra att integrationen mellan TakeCare och Försäkringskassan slutar att fungera. Alla sådana förändringar borde därför stämmas av med Försäkringskassan och Nationella Tjänsteplattformen innan de genomförs.

Xchange generellt webbtjänster

Vid anrop av alla Xchanges webbtjänster kan HSA-id användas för att identifiera en vårdenhet. Ändringar av HSA-id i vårdenhetsregistret kan därmed påverka alla webbtjänsteanrop. (Eventuella förändringar i vårdenhetsregistret kan ta upp till 10 minuter innan de får effekt på Xchange, p.g.a. cachning.) Det är dock även möjligt att identifiera en vårdenhet med Kombika, EAN eller internt vårdenhetsid.

Då HSA-id används vid anrop av Xchanges webbtjänster, görs en sökning av inkommande HSA-id i vårdenhetsregistret. Innan sökningen görs, tas eventuella inledande och avslutande mellanslag bort från inkommande HSA-id samt från alla HSA-id:n i vårdenhetsregistret. Gemener konverteras även till versaler. Om HSA-id:t i anropet inte får någon träff i vårdenhetsregistret enligt ovan beskrivna jämförelse, returneras en felkod till det anropande systemet.

För externa system som anropar Xchange webbtjänster med HSA-id, kan alla förändringar av HSA-id i vårdenhetsregistret, innebära att integrationen mellan TakeCare och det externa systemet slutar att fungera för de förändrade vårdenheterna. Alla sådana förändringar borde därför stämmas av med ansvariga för de externa systemen innan de genomförs.

Vårdenhets-id anges med wsdl-parametrarna 4 (typ av id) och 5 (själva id:t) i anropet. Vissa webbtjänster, t.ex. webbtidboken, vill även ha information om vårdenheten i wsdl-parametern 6 (xml-dokumentet).

Exakt hur (med vilket id och id-typ för vårdenheterna) externa system anropar Xchanges webbtjänster styr inte CGM över. Det ska vara en överenskommelse mellan drift och anropande system. Enligt Xchanges driftsmanual gäller: ”Xchanges driftansvarige tillhandahåller värden för vårdenhets-idtyp och vårdenhets-id”.

Befintliga webbtjänster:

▪Hämta data från Akutliggaren – GetTodaysEfficiencyStats

▪Hämta vårdengagemang – CareEngagementGet (NPÖ)

▪Hämta diagnoser – DiagnosesGet (NPÖ)

▪Hämta patientinformation – PatientInfoGet (NPÖ)

▪Hämta vårdkontakter – ContactsGet (NPÖ)

▪NPÖ-webbtjänsterna ovan loggar in vid en viss vårdenhet som vanligt, men hämtar data från en viss spärrgrupp, inte vårdenhet. Det som i TakeCare kallas för spärrgrupp, kallas i NPÖ för vårdenhet.

▪Hämta remisstatus – GetRequestStatuses

▪Hämta tid från servern – GetTimeOnServer (testtjänst)

▪Labbindex – GetLabIndex

▪Skriva journaltext – CaseNoteWrite

▪Webbtidbok – GetTimeTypes, GetAvailableDates, GetAvailableTimeslots, MakeBooking, RescheduleBooking, CancelBooking, GetBookings

Labbeställningar

I Stockholm används bara Kombika för labbeställningar. Alla labremissinställningar är dock anpassade för att kunna hantera data, inklusive HSA-id, från Nya externa enhetsregistret, vilket för närvarande används i Dalarna och VGR.

Labsvar

I Stockholm används bara Kombika för labsvar. Nedanstående inläsare är dock anpassade för att kunna hantera data, inklusive HSA-id, från Nya externa enhetsregistret, vilket för närvarande används i Dalarna och VGR.

▪Ambulans: Ambulance journal system CAK-net MEDAMB

▪Röntgen: TakeCare internt format

▪Röntgen: Sectraformat

▪Multisvar: Safirformat

Listningsuppgifter via SNOD (HVALRIKS, HVAL5)

HSA-id för vårdenhet hämtas från listningssystemen och visas i fliken ”Listning” i Patientuppgifter. Dessa HSA-id:n används dock ej för närvarande av TakeCare.

PAS – ekonomi mm

I Stockholm används endast Kombika för PAS/ekonomi. I VGR och Dalarna används dock det Nya externa enhetsregistret som innehåller HSA-id.

Intelligence

HSA-id finns i ett flertal kolumner i Intelligence, dock aldrig som en del av primärnyckeln. Rapporter och uttag kan komma att påverkas vid eventuella ändringar av HSA-id:t.