Hoppa till innehållet
ErsviaErsviaSystemarkitekturdokument

3. Kontext och avgränsning

3.1 Nuläge: applikationslandskapet i dag#

Figur 1 i uppsatsen visar dagens IT-stöd. Huvudflödet går från journalsystemen via GVR till ERSMO (val av ersättningsmodell), HEJ (prissättning) och Vårdfaktura (sammanställning, godkännande och överföring till Raindance). AF ger avstämning. ListOn levererar listning till GVR och kapiteringsunderlag till VF. FUMS och FUL hanterar medicinsk diagnostik och läkemedel. VAL-databasen tar emot data från nästan alla system.

ArchiMateApplikationslandskap i nuläget (uppsatsens Figur 1, kompletterad med sidosystemen)Ladda ned SVG: Applikationslandskap i nuläget (uppsatsens Figur 1, kompletterad med sidosystemen)Ladda ned PUML: Applikationslandskap i nuläget (uppsatsens Figur 1, kompletterad med sidosystemen)

Nulägesprocessen (TestViora process 7) är: vårdgivaren rapporterar till GVR eller manuellt i RAPP → ERSMO avgör ersättningsmodell och produkter → HEJ sätter pris → VF sammanställer med kapitering från ListOn och kostnadsansvar från FUMS → vårdgivaren godkänner → Raindance betalar ut → AF visar avstämning. Målrelaterad ersättning och många tillägg görs i Excel och bifogas i VF.

3.2 Avgränsning#

Inom Ersvia: all ersättning i pengar till vårdgivare, oavsett vilken form av avtal och vilket område av vården det gäller. Det gäller hela vägen från att en vårdhändelse eller listning tas emot till utbetalning, avstämning och uppföljning. Ersvia tar också hand om listning (ersätter ListOn), väntande (ersätter CVR) och manuell rapportering (ersätter RAPP). Dit hör även kontroll mot fel i utbetalningar och underlag till Migrationsverket (KRAV-39).

Utanför Ersvia: Det här ligger utanför:

  • att föra journal
  • VeraAsyl som system (hälsoundersökningar och barnhälsovård)
  • bokföring och betalning i ekonomisystemet
  • regionens datalager och verktyg för analys
  • stödet för upphandling i avtalssystemet
  • sjukresor och att beställa hjälpmedel.

System som ersätts#

System Funktion i dag Ersätts av (modul) Status Paritet
GVR (Gemensamt vårdregister), inkl. väntandetjänsten Insamling och validering av vårdhändelser, REST v1.9.5/v2.0.0, SNOD-XML Vardhandelser, Vantande, Kompatibilitet Ersätts 59 operationer i GVR v2, felkoder 0000–0950 och errorCode 0–1099
ListOn Personlistning, kapiteringsunderlag, listningsstatistik Listning Ersätts Listningstyper, tak, kö, omlistning, HUSLVAL-export
CVR Väntetidsregister (semikolonfiler) Vantande, Kompatibilitet (CVR-SFTP) Ersätts Posttyperna M och B
RAPP Manuell rapportering, kassa, reservnummer Rapportering, Portal Ersätts Besök, vårdperiod, slutenvård med DRG, MVC, kassa, reservnummer
ERSMO Val av ersättningsmodell och produkter Berakning (steg 2), Regelverk Ersätts ER-01 till ER-11, felkoder AF100–AF330
HEJ Prissättning och faktureringsunderlag Berakning (steg 3–6), Regelverk Ersätts HJ-01 till HJ-09, felkoder H0xx–H1xx
AF (Avstämningsfunktionen) Avstämning per vårdhändelse Avstamning, Kompatibilitet (AF-rapport i Excel) Ersätts AF-01 till AF-10, statusar OK, Mak, LF, RF, BeEj, Anm, Prel
Vårdfaktura (VF) Fakturaunderlag, godkännande, Raindance, bokföringsfil Fakturering, Portal, Kompatibilitet (VF-bokföringsfil .prn) Ersätts VF-01 till VF-22, felkoder 0000–4225 och 9999
FUMS Fakturaunderlag för medicinsk diagnostik MedicinskService Ersätts FM-01 till FM-10
FUL Fakturaunderlag för läkemedel Lakemedel Ersätts FL-01 till FL-06
Arv-portalen (LOL/LOF) Arvoden enligt nationella taxan Rapportering, Berakning (mall 39) Sannolikt, ska bekräftas
Symfoni (vuxentandvård N, S, F) Förhandsbedömning, e-faktura Berakning (mall 36–37), Fakturering Sannolikt, ska bekräftas
Libretto (barn- och ungdomstandvård) Tandvårdspeng, behovstillägg Berakning (mall 38), Listning Sannolikt, ska bekräftas
Vaccinera Ersättning per signerad vaccination Vardhandelser, Berakning (mall 1) Sannolikt, ska bekräftas
Res (regionägd vårds fakturering av asyl och utomläns) Faktura med storkundskod och LMA Fakturering Sannolikt, ska bekräftas
Excel-tillägg i VF Manuella tillägg (urologi, logopedi, PVR m.fl.) Fakturering (tillägg med fyra ögon), Regelverk Ersätts

Vi har listat vad systemen som ersätts gör. Listorna kommer ur beskrivningarna av systemen i docs/underlag/system/. De ligger i paritetsmatrisen docs/plan/paritet.yaml, som visar vad Ersvia måste kunna för att göra lika mycket som de gamla systemen. Där finns 128 funktioner i 10 system. Var och en har källa, målmodul, fas, krav och status för test. Sammanställningen per system finns i bilaga D.2. Testerna ligger i tests/Compatibility/, och CI visar hur mycket som är täckt.

Förvaltning och pågående ärenden i regionen (diariet, planen 4l)#

  • Förvaltning i dag: Tietoevry sade 2024-09-04 upp förvaltningen av VF, AF, HEJ och ERSMO. Förvaltningen ligger nu i funktionsområdet Vårdbeställarens systemstöd (BEST) hos Sopra Steria (RS 2023-0050 och avtal RS 2024-0280, som blev HSN 2025-0495). Avtalet har bilagor med instruktioner för AF, ERSMO, FUMS, FUL, ListON, VF, CVR, GVR och RAPP. HSN tog över ägarskapet för avtalet 2025-05-06.
  • Modernisering: ett resursavtal om att modernisera BEST-systemen tecknades 2026-03-06 (HSN 2025-0605-10). HSN 2026-0799 (2026-09-23) är ett avrop av konsulter för en samlad plan för vårdersättning och uppföljning. Målarkitekturen, kraven i TestViora och referensimplementationen kan bli underlag till planen. Men det är ett beslut för verksamheten.
  • Ärenden att ta hänsyn till: regelverket för rapportering 2027 (HSN 2026-0911). Handboken för hur ersättningsmodeller i avtal ska utformas (HSN 2026-0907). Förstudien om NVID, där kombika ska avvecklas (HSN 2026-0204). Breddinförande av GVR väntande (HSN 2026-0459). Avveckling av RAPP (HSN 2024-0770). Analysen av risker för välfärdsbrott (HSN 2026-0804). Upphandlingen av ett system för kontroll av leverantörer (HSN 2026-0081). Ett eget Raindance-företag för Psykiatrinämnden (HSN 2026-0884). Kontroll av betalningar till leverantörer genom Payified (HSN 2026-0645).
  • Ersättningsmodeller utan publicerade villkor: diariet ger 604 träffar på rapporteringsanvisningar med ERSMO-modellnummer (t.ex. vuxenpsykiatri 011/163/205/207/267). Därför får ersättningsgrunderna fältet legacyModellnummer. Då går det att spåra hur de hänger ihop med ERSMO-modellerna.
  • DRG: målvolym och poängpris fastställs genom protokoll per sjukhusavtal (t.ex. Capio S:t Göran 55 338 poäng 2026).

3.3 Verksamhetskontext#

C4Systemkontext (C4 nivå 1): användare och externa system runt ErsviaLadda ned SVG: Systemkontext (C4 nivå 1): användare och externa system runt ErsviaLadda ned PUML: Systemkontext (C4 nivå 1): användare och externa system runt Ersvia

Part Utbyte med Ersvia Riktning
Vårdgivare (privata, idéburna, egen regi) Rapporterar vård och väntande, ser villkor, avstämning och fakturaunderlag, godkänner eller invänder, ansöker om målrelaterad ersättning In och ut
Beställaren (HSF för HSN och PVN, KSON för Norrtälje, och från 2027 eventuellt Psykiatrinämnden) Överenskommelser, regler, granskning, attest, uppföljning In och ut
Utförare i egen regi (SLSO, Karolinska, Akutsjukhusnämnden, Ambulanssjukvårdsnämnden) Vårduppdrag i budgeten, rapporterad vård, intern budgetjustering i stället för faktura In och ut
Invånare via 1177 Listning och omlistning In
Ekonomifunktionen Tar emot e-faktura och budgetjustering, skickar kvittens Ut och in
Andra regioner Utomlänsfakturering i båda riktningar In och ut
Migrationsverket Underlag för återsökning Ut
Försäkringskassan Faktura per person för EU/EES och konvention Ut
Socialstyrelsen Patientregistret och väntetidsdatabasen Ut
SKR KPP Ut

3.4 Teknisk kontext: externa gränssnitt#

Varje gränssnitt har en port i kärnan och en adapter per region i src/Integrations/ (ADR 0010). Alla adaptrar har en mock för test och demo.

# Externt system Gränssnitt och protokoll Riktning Frekvens Adapter Krav
G1 Journalsystem och PAS (TakeCare, Cosmic, privata) Nytt REST /api/vardhandelser/v1/vardhandelser och GVR v2-fasaden (/v2/besok …) över HTTPS med mTLS och SITHS funktionscertifikat. SNOD-XML (GVRX*) In Löpande, stopp 24.00 sista vardagen Kompatibilitet (fasad) KRAV-6, KRAV-72
G2 Vårdgivare utan direktintegration Webbformulär och filuppladdning i Portal mot samma API In Löpande Rapportering KRAV-11
G3 Vårdgivarnas väntandesystem CVR-semikolonfiler via SFTP (<vg>_<system>_<M|B|MB>_<YYYYMMDD>.txt), inläsning 07.00 In Dagligen Kompatibilitet KRAV-14
G4 1177 listning (Inera) supportprocess:logistics:carelisting v2.1 via NTjP/RTP, Ersvia är producent In Löpande Ersvia.Integrations.Listning1177 KRAV-12
G5 Folkbokföringen (Navet eller PU, SPAR) Avisering och slagning In Dagligen Ersvia.Integrations.Folkbokforing KRAV-18
G6 Regionens avtalssystem Import av överenskommelser och ersättningsbilagor (format beställs) In Dagligen Ersvia.Integrations.Avtalssystem KRAV-4
G7 Utbudstjänsten healthcareoffering v3 In Dagligen Ersvia.Integrations.Utbudstjanst KRAV-4
G8 Ek/HSA infrastructure:directory:organization v5.0.1 In Dagligen Ersvia.Integrations.EkHsa KRAV-16
G9 Kodserver XML över SFTP eller Integrationstjänsten (format beställs), tabellerna AVD, SAMVERKS, PRODUKT, BTYP, TAXA m.fl. In Vid ändring Ersvia.Integrations.Kodserver KRAV-17
G10 Socialstyrelsen och E-hälsomyndigheten (klassifikationer) ICD-10-SE som TSV, KVÅ och NordDRG som xlsx In Årligen Kodverk-import KRAV-17
G11 DRG-grupperare Utbytbart gränssnitt (licensierad grupperare) In och ut Vid beräkning Ersvia.Integrations.Drg KRAV-28
G12 E-hälsomyndigheten (läkemedel) Fakturaunderlag för läkemedelsförmånen In Månadsvis Ersvia.Integrations.Ehalsomyndigheten KRAV-13
G13 Leverantörer av medicinsk service Fakturaunderlag (filer, format beställs från FUMS-förvaltningen) In Månadsvis Ersvia.Integrations.MedicinskServiceLev KRAV-13
G14 Ekonomisystemet (Raindance; Unit4, Visma, SAP i andra regioner) Peppol BIS Billing 3 med kontering, kvittens tillbaka Ut och in Efter godkännande Ersvia.Integrations.Raindance KRAV-54
G15 VAL-databasen Utfall per vårdgivare, vårdenhet, ersättningsslag och period (från ersättningszonen, utan personer); validerade vårdhändelser och listning med personnummer, samordningsnummer eller reservnummer i klartext från patientdatazonens VAL-export, eftersom VAL pseudonymiserar själv (som HUSLVAL/IDNR i dag). Ändamålskontroll och åtkomstloggning per uttag (ADR 0020, tillägg) Ut Efter stängd period, listning 2–3 dagar efter månadsskiftet Uppfoljning (utfall), Valexporttjanst i patientdatazonen (vårdhändelser och listning) KRAV-62
G16 Migrationsverket Underlag för återsökning (kvartalsvis) Ut Kvartalsvis Ersvia.Integrations.Migrationsverket KRAV-39
G17 Andra regioner financial:billing:claim v1.1 (ProcessClaimSpecification) In och ut Månadsvis Ersvia.Integrations.Billing KRAV-40
G18 Högkostnadsskydd financial:patientfees:exemption 1.0 In Vid beräkning Ersvia.Integrations.Frikort KRAV-34
G19 Regionens identitetstjänst (SLL IDP), e-legitimation, SITHS OIDC/SAML In Vid inloggning Identitet KRAV-66
G20 E-arkiv FGS Paketstruktur 2.0 (E-ARK SIP) Ut Enligt dokumenthanteringsplan Drift KRAV-75
G21 Socialstyrelsen (patientregistret, väntetidsdatabasen), SKR (KPP) Filer via Filip eller SFTP Ut Månadsvis, årligen Uppfoljning KRAV-62
G22 Vårdgivarnas ekonomisystem VF-bokföringsfil .prn (V1, V2, med kontering) och AF-rapport i Excel Ut Månadsvis Kompatibilitet KRAV-60, KRAV-72
G23 AI-klienter (controllers) MCP över HTTPS med OIDC In Vid behov Ersvia.Mcp ADR 0007

3.5 Målbild#

I målbilden finns en plattform med två zoner. Kompatibilitetsfasaden gör att journalsystemen och vårdgivarnas ekonomisystem kan fortsätta som i dag under övergången.

ArchiMateApplikationslandskap i målbildenLadda ned SVG: Applikationslandskap i målbildenLadda ned PUML: Applikationslandskap i målbilden

TestVioras tre öppna arkitekturbeslut besvaras så här (se kapitel 9):

  • TV-ADR 1 (drift): containrar på Kubernetes/OpenShift, som fungerar både i regionens datacenter och hos en leverantör.
  • TV-ADR 2 (källa för avtal): avtalssystemet är källa för överenskommelser och vårdutbud. Ersvia äger ersättningsgrunder och regelversioner.
  • TV-ADR 3 (VAL): Ersvia levererar både validerade vårdhändelser och listning (från patientdatazonen, med personnummer i klartext, eftersom VAL pseudonymiserar själv) och utfall (från ersättningszonen, utan personer) i separata exporter. Rättat krav i F12a: i F10 levererades vårdhändelser och listning pseudonymiserade från ersättningszonen; användaren har rättat att VAL behöver identiteten för att länka mot andra källor (ADR 0020, tillägg).
Ersvia SAD · version b706ca6 (2026-11-11) (med ändringar som inte är incheckade) · byggd 2026-11-11 · Ändringslogg · Diagramgalleri · Källa: docs/arkitektur/kapitel/03-kontext-och-avgransning.md

Sök i dokumentet

100 % Ladda ned SVG