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.

Figur 1 Anslutande system

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.

Figur 2 Anslutningstopologi

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 i beställningsstödet.

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.

Figur 3 Direkt anslutning mot NTjP

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 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.

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 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 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.

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 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.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 https://inera.atlassian.net/wiki/spaces/NTJPP/overview?homepageId=400557227

Se https://skl-tp.atlassian.net/wiki/spaces/NTJP/pages/6815748/FAQ+Teknik

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.