Innehållsförteckning

1. Inledning

1.1        Syfte

Dokumentet syftar till att beskriva hur anslutning sker till tjänsten Elektronisk remiss och hur en anslutning till den Nationella tjänsteplattformen (NTjP) skall beställas.

1.2        Målgrupp

Målgrupper för dokumentet är personal hos anslutande parter som ansvarar för beställning av anslutning till tjänsterna för Elektronisk remiss på den Nationella tjänsteplattformen. Läsare förutsätts ha viss kännedom om tjänsterna för Elektronisk remiss och det anslutande systemet i synnerhet.

2. Tjänster för Elektronisk remiss

Tjänsterna för elektronisk remiss definieras av tjänstekontrakt inom tjänstedomänen clinicalprocess:activity:request.

Tjänstedomänen innehåller följande tre tjänstekontrakt:

• ProcessRequest (PR)
  Används för utbyte av remiss

• ProcessRequestConfirmation (PRC)
  Används för remissbekräftelse, kompletteringsbegäran och besked om vidareskickad remiss

• ProcessRequestOutcome (PRC)
  Används för utbyte av remissvar

3. Anslutande system och tjänster

Med anslutande system avses ett system för hantering av remisser som skall anslutas till tjänsterna för Elektronisk remiss framöver kallat Tjänsterna. Typiskt är detta ett journalsystem. Figur 1 visar schematiskt ett anslutande system och de tjänstekontrakt som kan anslutas för hantering av elektroniska remisser samt de vårdenheter som använder systemet för att skicka eller ta emot remisser.

Open

Ett anslutande system tillåts ansluta i olika systemroller; remittentsystem, remissmottagande system eller i båda rollerna. Beroende på i vilken roll det anslutande systemet agerar behöver systemet anslutas till tjänsterna i olika roller; tjänstekonsument (konsument) eller tjänsteproducent (producent). Figur 1 visar på vilket sätt ett remittentsystem resp. remissmottagande system skall anslutas till tjänsterna.

4. Beställning av anslutningar

Anslutning beskrivs här ur NTjP:s perspektiv. Beskrivningen utgår ifrån en komplett anslutning vilket innebär en anslutning till samtliga tre tjänster inom Elektronisk remiss både som konsument och producent av tjänsterna.

Informationen i beställningen gentemot NTjP är beroende av om kommunikationen sker direkt mot NTjP eller via en regional tjänsteplattform eller annan integrationsplattform som används av anslutande part.

Open

Anslutning beställs genom Beställningsstödet. Beställningsstödet är en webapplikation som kräver inloggning och nås på adressen https://bestallningsstod.tjansteplattform.se

En beskrivning om hur beställningsstödet skall användas för beställning av anslutning till Elektronisk finns också tillgänglig här: Instruktioner och filmer.

4.1        Direkt anslutning

Direkt anslutning avses i fall då det anslutande systemet kommunicerar direkt med tjänsterna på NTjP. Vid en direkt anslutning agerar det anslutande systemet konsument resp. producent gentemot den Nationella tjänsteplattformen.

4.1.1        Beställningar för anslutning av tjänstekonsument

Informationen i beställningarna framgår av Tabell 1. Värden är hämtade ur Figur 3.

Tabell 1 Beställningsinformation tjänstekonsument – Direkt anslutning

Förklaring till värden i tabellen:

• Tjänstekontrakt
  Anger det tjänstekontrakt (och version) som beställningen avser

• Systemidentitet
  Anger identitet på anslutande system (eller funktion). Detta är ett HSA-ID som hämtas från funktionscertifikat för det anslutande systemet (eller funktionen).

• Anropsbehörighet
  Anropsbehörigheten skall anges till ”SE”. Detta medför att det anslutande systemet ges behörighet att kommunicera meddelanden till samtliga andra anslutna system. För mer information om standardbehörighet se sidan https://inera.atlassian.net/wiki/spaces/OIER/pages/3339616800  

4.1.2        Beställningar för anslutning av tjänsteproducent

Informationen i beställningarna framgår av Tabell 2. Värden är hämtade ur Figur 3.

Tabell 2 Beställningsinformation tjänsteproducent – Direkt anslutning

Förklaring till värden i tabellen:

• Tjänstekontrakt
  Anger det tjänstekontrakt (och version) som beställningen avser.

• Systemidentitet
  Anger identitet på det anslutande systemet (eller funktion). Detta är ett HSA-ID som hämtas från funktionscertifikat för det anslutande systemet (eller funktionen).

• Logiska adresser
  Anger de logiska adresser i form av HSA-ID för vårdenheter som kan adresseras i det anslutande systemet.
  Detta är en lista på de vårdenheter som tar emot meddelanden i det anslutande systemet. Dessa behöver uppdateras vid förändringar. Typiskt vid införande av Elektronisk remiss på ytterligare vårdenheter

• URL
  Anger URL till respektive tjänst i det anslutande systemet.

4.2        Anslutning via integrationsplattform

Här avses anslutning då anslutande system kommunicera med NTjP via en regional tjänsteplattform eller annan integrationsplattform. Detta visas i Figur 4.

Figur 4 Anslutning via integrationsplattform

4.2.1        Beställningar för anslutning av tjänstekonsument

I detta fall är det den regionala integrationsplattformen som agerar konsument gentemot NTjP. Informationen i beställningarna framgår av Tabell 3. Värden är hämtade ur Figur 4.

Tabell 3 Beställningsinformation tjänstekonsument – Anslutning via integrationsplattform

Förklaring till värden i tabellen:

• Tjänstekontrakt
  Anger det tjänstekontrakt (och version) som beställningen avser

• Systemidentitet
  Anger identitet på integrationsplattform. Detta är ett HSA-ID som hämtas från funktionscertifikat.

• Anropsbehörighet
  Anropsbehörigheten skall anges till ”SE”. Detta medför att det anslutande systemet ges behörighet att kommunicera meddelanden till samtliga andra anslutna system. För mer information om standardbehörighet se sidan https://inera.atlassian.net/wiki/spaces/OIER/pages/3339616800  

4.2.2        Beställningar för anslutning av tjänsteproducent

Informationen i beställningarna framgår av Tabell 4. Värden är hämtade ur Figur 4

Tabell 4 Beställningsinformation tjänsteproducent – Anslutning via integrationsplattform

Förklaring till värden i tabellen:

• Tjänstekontrakt
  Anger det tjänstekontrakt (och version) som beställningen avser.

• Systemidentitet
  Anger identitet på integrationsplattform. Detta är ett HSA-ID som hämtas från funktionscertifikat.

• Logiska adresser
  Anger de logiska adresser i form av HSA-ID för vårdenheter som kan adresseras via tjänsterna integrationsplattformen.
  Detta är en lista på de vårdenheter som tar emot meddelanden i det anslutande systemet. Dessa behöver uppdateras vid förändringar. Typiskt vid införande av Elektronisk remiss på ytterligare vårdenheter

• URL
  Anger URL till respektive tjänst på integrationsplattformen.

4.2.3        Standardvägval i regional tjänsteplattform

I regionala tjänsteplattformar rekommenderas standardvägval för adressering. Se mer information här:
https://inera.atlassian.net/wiki/spaces/OIER/pages/3339845894  

4.3        Information om NTjP

Aktuell systeminformation om NTjP och information om de installerade tjänsterna för Elektronisk remiss på den Nationella tjänsteplattformen finns tillgänglig via

Se även , här finns information om URL:er för tjänsterna inom Elektronisk remiss på NTjP och annan viktig information som är nödvändig för att etablera kommunikation med NTjP.

5. Hantering vid parallella huvudversioner

Varje tjänstekonsumerande och tjänsteproducerande system behöver ta hänsyn till att det kan finnas parallella huvudversioner av tjänstekontrakt. Hur detta fungerar finns beskrivet här:

• RIV Tekniska Anvisningar - Parallella huvudversioner av ett tjänstekontrakt

• Övergång till en ny huvudversion inom en tillämpning

Figur 5 Bild som visar att tjänstekonsumenter och tjänsteproducenter kan vara anslutna till olika huvudversioner av tjänstekontrakt (TKv1 och TKv2)

För kunder till tjänsten Elektronisk remiss innebär detta följande:

• Anslutande kund ska stödja även föregående huvudversion så länge det finns kunder som fortfarande enbart stödjer denna.

  • För helt nya kunder kan denna punkt diskuteras med tjänstens förvaltning, ifall alla tänkta mottagare (tjänsteproducenter) och sändare (tjänstekonsumenter) till ny kund redan har den senaste huvudversionen.

• Tjänstekonsument som är ansluten till ny huvudversion ska veta vilken huvudversion som aktuell tjänsteproducent använder. Detta så att remissen skapas och skickas enligt rätt version:

  • Tjänstekonsumenten ska hålla en aktuell lista med logiska adresser för de tjänsteproducenter som är anslutna till ProcessRequest och vilka huvudversioner de stödjer.

  • Tjänstekonsument bör ansluta till tjänstekontrakt GetLogicalAddresseesByServiceContract v.2.0 (tjänstekontraktet publiceras efter sommaren 2024) som tjänstekonsument (se mer information nedan).

• Bekräftelsemeddelanden (ProcessRequestConfirmation) och remissvarsmeddelanden (ProcessRequestOutcome) ska skickas enligt samma huvudversion som mottaget remissmeddelande (ProcessRequest).

• Vid end-of-life för en huvudversion av ProcessRequest ska mottagande och sändande system kunna hantera bekräftelsemeddelanden (ProcessRequestConfirmation) och remissvar (ProcessRequestOutcome) för denna version X månader efteråt (ej bestämt exakt antal månader ännu) innan även dessa når end-of-life.

5.1 Hämta information om huvudversion

För att kunna veta vilken huvudversion en remissmottagare stödjer bör tjänstekontrakt GetLogicalAddresseesByServiceContract v.2.0 (tjänstekontraktet publiceras efter sommaren 2024) användas. Anropet innehåller tjänstekonsumentens HSA-ID och aktuellt tjänstekontrakt (ProcessRequest v.X). Ett anrop per huvudversion av tjänstekontraktet behöver göras.

Svaret består av en lista med logiska adresser (HSA-ID) för tjänsteproducenter av ProcessRequest som kunden har anropsbehörighet till. Eftersom tjänstekonsumenter av tjänstens tjänstekontrakt har standardbehörighet visas alla tjänsteproducenter av ProcessRequest v.X i listan.