Ny anslutning via API för hämtning av strukturerad data ur Rådgivningsstödets journal

Aktiviteten gäller för Region Dalarna, Region Jönköping, Region Uppsala, Västra Götalandsregionen och Region Sörmland.

Den här sidan innehåller information om det arbete som de regionerna ska göra med att göra en ny anslutning för hämtning av strukturerad data ur Rådgivningsstödets journal.

Informationen riktar sig till regionalt införandeansvariga och andra personer som ska vara involverade i arbetet.

Bakgrund

Region Dalarna, Region Jönköping, Region Uppsala, Västra Götalandsregionen och Region Sörmland har tidigare beställt anslutning till nuvarande Rådgivningsstödet via API ”1177 Vårdguiden på telefon – API för hämtning av strukturerad data ur Rådgivningsstödets journal” för hämtning av journalstatistik. Motsvarande anslutning kommer att vara möjlig till nya Rådgivningsstödet. De regioner som via detta API önskar hämta av journalstatistik från nya Rådgivningsstödet behöver göra en ny anslutning inklusive testning. Ingen ny beställning ska göras.

Beskrivning av API

1177 Vårdguiden på telefon – API för hämtning av strukturerad data ur Rådgivningsstödets journal:

Inera utvecklat det nya Rådgivningsstödets API så att konsumerande system inte ska behöva anpassas, request och response ska vara oförändrade.

Arbete i olika steg

Steg 1 Ansluta och testa mot Ineras testmiljö STAGE

Förberedande aktiviteter för regionerna

  1. Förse Inera med

    1. HSA-id:n för de SITHS-certifikat (klientcertifikat) som kommer att användas för tester mot Ineras STAGE-miljö

    2. de IP-adresser som kommer att användas, så att Inera kan göra nödvändiga brandväggsöppningar

  2. informera Inera om när testning kommer att påbörjas och hur tidplanen för testning ser ut

  3. ange en kontaktperson för testningen för även direkt kommunikation – regionalt införandeansvariga ska dock hållas i loopen hela tiden

Förberedande aktiviteter för Inera

  1. Registrera SITHS klientcertifikat och göra nödvändiga brandväggsöppningar avseende STAGE

  2. Förse regionerna med URL till en testmiljö STAGE-miljö, som Inera förbereder med testdata

Testning

För testning mot mot Ineras testmiljö STAGE finns URL och exempelanrop i mejl “Nya Rådgivningsstödet: Nu testning möjlig - API för hämtning av strukturerad data ur Rådgivningsstödets journal” till regionalt införandeansvariga 2024-04-22.

För att förenkla Ineras hantering av testdata är alla regioner kopplade mot Västernorrland, där bäst testdata finns.

Återkoppla till Inera när testningen är avslutad och har gått igenom eller vid frågor. Först då testningen mot STAGE har gått igenom och regionen anmäler sig klar för anslutning mot produktion gör Inera nödvändig konfigurering i Rådgivningsstödets produktionsmiljö.

Steg 2 Anslutning mot produktionsmiljö

Aktiviteter för regionerna

  • Förse Inera med

    1. HSA-id:n för de SITHS-certifikat (klientcertifikat) som kommer att användas för tester mot Ineras STAGE-miljö

    2. de IP-adresser som kommer att användas, så att Inera kan göra nödvändiga brandväggsöppningar

Aktiviteter för Inera

  1. Registrera SITHS klientcertifikat och göra nödvändiga brandväggsöppningar avseende PROD

  2. Förse regionerna med URL till PROD

Tidplan

Inera registrerar regionens SITHS klientcertifikat och gör nödvändiga brandväggsöppningar så fort som regionen har rapporterat godkänt resultat vid testning mot STAGE.

Go live för nya Rådgivningsstödet är planerad i september, veckorna 36-38.

Om hämtningen av data

Informationsmängder

Om regionen inte kan hantera eller vid behov exkludera nationellt reserv-id kan Inera göra en regionsspecifik konfigurering.

Övergång från nuvarande Rådgivningsstödet till nya Rådgivningsstödet

Under en go live-period om ungefär tre veckor kommer verksamheterna 1177 på telefon att göra en successiv övergång från det nuvarande Rådgivningsstödet till det nya, både av regioner och användare. Under go live-perioden skapas data för hämtning parallellt i båda systemen. Perioden avslutas med att det nuvarande Rådgivningsstödet låses, varefter ingen mer data skapas i det systemet.

Journalhandlingar kommer att migreras från nuvarande Rådgivningsstödet till det nya. Det är dock inte relevant för den aktuella hämtningen, då data som hämtas gäller journaler som har skapats och signerats i ett system.

Nya Rådgivningsstödet håller data för hämtning under 90 dagar, varpå det rensas.

Nuvarande Rådgivningsstödet håller data för hämtning obegränsat länge. Obs! Data från nuvarande Rådgivningsstödet kan dock senast hämtas 2024-10-[TBD], innan systemet avvecklas.

För kontinuerlig och heltäckande hämtning av data rekommenderar Inera att regionen gör parallell hämtning från nuvarande Rådgivningsstödet och nya Rådgivningsstödet, det vill säga implementerar parallella synkjobb.

Möjlig vidareutveckling i förvaltning

Nya Rådgivningsstödet skiljer sig jämfört med det nuvarande på två punkter sett till detta API. Den ena är att nya Rådgivningsstödet håller nationell reservidentitet, här kommer blanka värden för dessa poster att skickas, som idag. Det andra är att nuvarande Rådgivningsstödet håller informationsmängden hänvisningsnivå, medan nya Rådgivningsstödet använder det mer fingranulära hänvisningskoder. Inera kommer att göra en mappning mellan hänvisningsnivåer och hänvisningskoder för att vid den nya anslutningen fortsatt skicka hänvisningsnivåer. I ett senare skede bör/kan detta API anpassas för att hantera den nya informationsstrukturen.

Vid frågor

Vid frågor, kontakta regionalt införandeansvarig (lista finns här).