crm. requeststatus
0.1.0 - CI Build Sweden

crm. requeststatus - Local Development build (v0.1.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Tj??nstedom??nens krav och regler

Tjänstedomänens krav och regler

Dessa gäller alla tjänstekontrakt i hela tjänstedomänen om inte undantag görs för specifika tjänstekontrakt senare i dokumentet.

Informationssäkerhet och juridik

Medarbetarens direktåtkomst

Vid sammanhållen journalföring ansvarar verksamheten som erbjuder sina medarbetare direktåtkomst till sammanhållen journal för att patientdatalagen efterlevs. Det innebär bl.a. att spärrkontroll kan behöva genomföras innan information kan visas. Det innebär också att regelverket för samtycke, vårdrelation och åtkomstloggning måste följas. Dessutom finns krav från integritetsskyddsmyndigheten om ytterligare teknisk åtkomstkontroll.

HSLF-FS 2016:40 ställer också krav (via "Journalföring och behandling av personuppgifter i hälso- och sjukvården", se referens R7) på att medarbetaren är starkt autentiserad om medarbetarens inloggning sker i nät som delas med flera vårdgivare och att uppdragsval görs i samband med autentisering (vårdenhet). Det kompletta regelverket finns i handboken samt i anvisningar för tillgänglig patient.

Observera att tjänstekontrakten i sig inte påtvingar sammanhållen journalföring. Krav rörande sammanhållen journalföring och krav på spärrhantering uppstår först om tjänstekonsumenten (e-tjänsten) för medarbetaren tillgängliggör information som härrör från andra vårdgivare (sammanhållen journalföring) eller andra vårdenheter inom egna vårdgivaren (spärrkrav).

Spärrkontroll

Den spärrkontroll som behöver utföras kan behöva utföras i två nivåer.

På meddelandeposten i sin helhet

Är meddelandeposten spärrad ska hela posten filtreras bort innan presentation för användare.

På delar av en meddelandepost

I vissa tjänstekontrakt finns möjlighet att i en meddelandepost peka ut annan journalinformation (andra meddelandeposter som kan hämtas via samma eller annat tjänstekontrakt), till vilken ett samband finns från meddelandeposten ifråga. Denna utpekade information kan i sig vara spärrad. Den del av meddelandeposten som håller information om relaterad information som är spärrad måste filtreras bort innan presentation för användare.

Patientens direktåtkomst

Alla tjänstekontrakten i denna tjänstedomän har en svarsflagga som anger om verksamheten (informationsägaren) godkänt att informationen får utlämnas till patient. Det kan t.ex. ha skett genom menprövning eller rådrum. Det är varje vårdgivares ansvar att tjänsteproducenten sätter ”kan visas för patient”-flaggan i enlighet med vårdgivarens verksamhetsregler.

Generellt

Tjänsteproducenten ansvarar för att information endast lämnas ut till de tjänstekonsumenter som informationsägaren godkänt. Det är inte ett juridiskt krav, men tydliggörs här eftersom det avviker från T-boken i det att tjänsteplattformen då inte ansvarar för den tekniska åtkomstkontrollen (ej möjligt när systembaserad adressering tillämpas). Om informationsägaren har behov av att reglera åtkomst per tjänstekonsument, ska tjänsteproducenten filtrera svaret enligt informationsägarens önskemål. Observera att det är regionala policyer snarare än lagar och förordningar som styr i vilken grad tjänsteproducenten ska begränsa åtkomst för en viss tjänstekonsument. Kunskapen om tjänstekonsumentens (tjänstens) identitet (d.v.s. ursprunglig tjänstekonsument i anropskedjan) får bara användas för teknisk åtkomstbegränsning på så sätt att svaret blir som om de vårdenheter vars verksamhetschef inte godkänner aktuell tjänstekonsument varit exkluderade i frågan.

Icke funktionella krav

Det är den informationsproducerande vårdgivarens ansvar att endast ett källsystem tillhandahåller informationen via lästjänst och engagemangsindex där patientdata lagras i flera källsystem. Konsumenter som är anslutna till flera majorversioner av samma kontrakt måste hantera dubblettborttagning mellan dessa. Detta sker genom att jämföra identiteter på postnivå och endast behålla en av de poster som returnerats, se R9.

SLA krav

Följande generella SLA-krav gäller för alla tjänsteproducenter som tillhandahåller tjänster. Dessa krav gäller där inget annat anges för ett specifikt tjänstekontrakt.

Kategori Värde Beskrivning
Svarstid Svarstiden för ett anrop får inte överstiga 27 sekunder. Svarstid
Tillgänglighet 24x7, 99,5% Tillgänglighet
Last Tjänsteproducenten ska kunna hantera minst dubbla mängden frågor per dygn i förhållande till antalet journaluppdatering per dygn. Last
Aktualitet Kraven på aktualitet varierar för olika tjänstekonsumenter. Det behöver inte vara absolut aktualitet i förhållande till källsystemet, men ju mindre fördröjning desto bättre. Ett riktmärke är att försöka undvika längre fördröjning än 60 minuter. Fördröjningen avser både journaldata och uppdatering av engagemangsindex.  
Uppdatering av engagemangspost måste ske så att engagemangsposten refererar data som är omedelbart tillgängligt via tjänstekontraktet. Aktualitet  
Robusthet Om komplett tidsintervall inte angivits i frågan kan tjänsteproducenten kan välja att lämna ett delsvar i syfte att uppfylla svarstidskravet. Delsvaret måste då vara avgränsat i tiden genom att det finns äldre men inte nyare data än det äldsta som returnerats. Robusthet
Samtidighet Tjänsteproducenten ska hantera minst 10 samtidiga frågor. Samtidighet

Övriga krav

Gemensamma konsumentregler

R1 (invånartjänster): Filtrera enligt flagga ”approvedForPatient” R2: Tillämpa regelverk enl. PDL R3: Aggregerande sökning förutsätter användning av individens senast gällande huvudidentitet, användning av andra identiteter för individ är enbart tillåten i vid anrop till ett källsystem.

Gemensamma producentregler

R1: Filtrera enligt RIVTA-headern LogicalAddress. Svarsmeddelandet får endast innehålla information som skapats i det källsystem som anges av frågemeddelandets LogicalAddress.

Felhantering

Krav på en tjänsteproducent

Logiska fel

N/A

Tekniska fel

Vid ett tekniskt fel levereras ett generellt undantag (Soap Fault). Exempel på detta kan vara deadlock i databasen eller följdeffekter av programmeringsfel. Tekniska fel får inte förmedla personuppgifter. Istället rekommenderas att ett log-id förmedlas, som ger möjlighet för tjänsteproducentens förvaltning att bistå tjänstekonsumentens förvaltning med felsökning. Ett log-id bör vara en UUID. Ett log-id får under inga omständigheter förmedla information som är spårbar till patienten.

Krav på en tjänstekonsument

Logiska fel

Inga krav på konsument

Tekniska fel

Inga krav på konsument.

Uppdatering av engagemangsindex

Alla källsystem ska uppdatera engagemangsindex. Engagemangsindex ska uppdateras så snart en händelse inträffar som påverkar indexposterna enligt beskrivningen nedan.

All uppdatering av engagemangsindex sker genom att källsystemet anropar engagemangsindex genom tjänstekontraktet urn:riv:itintegration:engagementindex:UpdateResponder:1 (”index-push”).

Ladda hem Engagemangsindex WSDL, scheman och tjänstekontraktsbeskrivning för detaljer.

Följande regler gäller för innehållet i begäran till engagemangsindex för uppdateringar som rör denna tjänstedomän:

Attribut Beskrivning Format Kardinalitet Kodverk/värde-mängd / ev begränsningar Beslutsregler och kommentar
Registered ResidentIdent Identification Invånarens person-nummer Person- eller samordningsnummer enligt skatteverkets definition (12 tecken). 1..1   Del av instansens unikhet
Service domain* Den tjänstedomän som förekomsten avser. URN på formen ::: 1..1 ”riv:crm:requeststatus” Del av instansens unikhet
Categori-zation* Kategori-sering enligt kodverk som är specifikt för tjänste-domänen Text i ASCII 1..1 Värde enligt tabell nedan. Del av instansens unikhet
Logical address* Referens till informationskällan enligt tjänste-domänens definition Logisk adress enligt adresseringsmodell för den tjänstedomän som anges av fältet Service Domain. 1..1 Samma värde som fältet Source System. Del av instansens unikhet
Business object Instance Identifier* Unik identifierare för händelse-bärande objekt Text 1..1 ”NA” – d.v.s. ej tillämpat för tjänstedomänen. Del av instansens unikhet
Clinical process interest Id Hälsoärende-id GUID 1..1 ”NA” (ännu ej tillämpat i tjänstedomänen) Del av instansens unikhet
Most Recent Content* Tidpunkt för senaste uppdatering av den informationstyp och patient i den källa som denna indexpost avser. DT 1..1 Tidpunkt för senaste händelse som matchar indexposten. Kan även avse borttag. Ex: En indexpost representerar 2 bef. dokument. Ett av dem tas bort. Det markeras genom att bef. post uppdateras med tidpunkt för borttagshändelsen.  
Creation          
Time Tidpunkten då index-posten regi-strerades DT 1..1 Sätts automatiskt av EI-instansen. Genereras automatiskt av kontraktets tjänste-producent
Update Time Tidpunkten då index-posten senast upp-daterades DT 0..1 Sätts automatiskt av EI-instansen. Upp-datering innebär ny post som matchar samtliga attribut som är del av en instans unikitet.
Owner Organisation vars index tog emot ”update” från ”source system” Organisationsnummer (HSA-id) för organisationen som äger indexinstansen. Organisationen är en myndighet eller Inera om uppdateringen togs emot direkt av nationellt index. 1..1 Syftet är att skapa förutsättningar för att undvika rundgång mellan notifierande parter. Del av instansens unikhet
Source System Systemet som genererade engagemangsposten Källsystemets HSA-id. Detta HSA-id ska gälla den systeminstans som ansvarar för originalinformationen. Det kan vara ett annat HSA-id än för den tekniska anslutningspunkten. 1..1 Syftet är att underlätta felsökning och ge spårbarhet. Del av instansens unikhet
Data Controller Personuppgiftsansvarig organisation Vårdgivarens organisationsnummer eller HSA-id      
eller inom källsystemet unik identifierare för vårdgivaren. 1..1 ”SE”. Exempel: ”SE5565594230” eller HSA-id, eller      
systemspecifik identitet. Del av instansens unikhet        

Categorization för tjänstekontrakt i denna domän:

Tjänstekontrakt Categorization
GetRequestActivities req-act