1. Nya funktioner

eFrikort Ã¤r nu ansluten via Ineras HKS och kan nu hÃ¤mta information frÃ¥n Ã¶vriga frikortsystem som anvÃ¤nds i regioner som ej anvÃ¤nder eFrikort.

Patienter kan hÃ¤mta sina uppgifter frÃ¥n eFrikort i 1177 via Ineras HKS.

2. Ãndringar

Nedan Ã¤r en lista pÃ¥ de fÃ¶rÃ¤ndringar som utfÃ¤rdades fÃ¶r att upprÃ¤tthÃ¥lla nya regelverket kring nationell frikortshantering.

2.1. Frikortsuppgifter och avgifter

TjÃ¤nstekontrakten och webbapplikationen kommer fungera pÃ¥ samma sÃ¤tt. Men i bakgrunden kommer eFrikort hÃ¤mta uppgifter via Ineras HKS tjÃ¤nst och slÃ¥ ihop informationen i svaret som eFrikort ger nÃ¤r man sÃ¶ker pÃ¥ frikort och visar avgifter.

PÃ¥ grund av nytt nationellt regelverk kring frikortshantering sÃ¥ mÃ¥ste eFrikort dÃ¶lja information utanfÃ¶r regionen.

DÃ¤rfÃ¶r kommer alla avgifter utanfÃ¶r den egna regionen inte visa detaljerad information pÃ¥ avgifter. Alla avgifter kommer rÃ¤knas med i totalbeloppet pÃ¥ frikortet. Men Ã¤ven om patienten ger samtycke sÃ¥ kommer bara belopp/datum visas pÃ¥ avgifterna som kommer frÃ¥n andra regioner.

Bilden nedan visar en patient som har frikort och alla avgifter utom en Ã¤r registrerad av andra regioner, dÃ¤rfÃ¶r visas vÃ¥rdgivaren som "Extern vÃ¥rdgivare". D.v.s. det gÃ¥r inte avgÃ¶ra vilken vÃ¥rdgivare, vilken vÃ¥rdenhet och vilken region besÃ¶ket har utfÃ¶rts hos. Det kan dock patienten sjÃ¤lv se via 1177 om det skulle behÃ¶vas.

Figur 1: HÃ¤mtat frikort pÃ¥ patient som gett samtycke dÃ¤r flera avgifter Ã¤r registrerad inom annan region Ã¤n vad anvÃ¤ndaren Ã¤r inloggad som.

2.2. Opt-out (UttrÃ¤de)

NÃ¤r uttrÃ¤de/opt-out registreras pÃ¥ en patient Ã¤r skillnaden mellan tidigare version och 4.1 enligt tabellen nedan.

TjÃ¤nstekontraktet och knappen i webbapplikationen Ã¤r ofÃ¶rÃ¤ndrade men resultatet av funktionen Ã¤r annorlunda.

Version 4.0

Version 4.1

Alla aktiva frikortsuppgifter raderas och inga nya uppgifter kan registreras pÃ¥ patienten.

Alla frikortsuppgifter dÃ¶ljs, inget system kan hÃ¤mta uppgifterna och inga nya uppgifter kan registreras pÃ¥ patienten. En registrering av uttrÃ¤de gÃ¤ller fÃ¶r samtliga regioner som anvÃ¤nder eFrikort. D.v.s. det behÃ¶vs bara registreras ett uttrÃ¤de fÃ¶r hela tjÃ¤nsten eFrikort.

(Vid Ã¥terintrÃ¤de/intrÃ¤de sÃ¥ blir frikortsuppgifterna tillgÃ¤ngliga igen)

2.3. Opt-in (IntrÃ¤de eller Ã¥terintrÃ¤de)

Detta Ã¤r en funktion som bara Region Gotland och Region Stockholm anvÃ¤nder idag. TjÃ¤nstekontraktet och flÃ¶det fÃ¶r att registrera ett intrÃ¤de i webbapplikationen Ã¤r ofÃ¶rÃ¤ndrade. Men sjÃ¤lva intrÃ¤det fungerar annorlunda i version 4.1 av eFrikort.

Version 4.0	Version 4.1
IntrÃ¤de behÃ¶vdes endast gÃ¶ras en gÃ¥ng och gÃ¤ller fÃ¶r hela tjÃ¤nsten eFrikort.	IntrÃ¤de mÃ¥ste gÃ¶ras per region, d.v.s. intrÃ¤det gÃ¤ller per region.
Om patienten har gjort opt-out/uttrÃ¤de och Ã¥ngrar sig sÃ¥ behÃ¶vs bara ett Ã¥terintrÃ¤de (intrÃ¤de) registreras sÃ¥ fungerar det i samtliga regioner som anvÃ¤nder tjÃ¤nsten fÃ¶r patienten.	Om patienten har gjort opt-out/uttrÃ¤de och Ã¥ngrar sig sÃ¥ behÃ¶vs Ã¥terintrÃ¤de (intrÃ¤de) registreras av respektive regionÂ (eftersom intrÃ¤det bara gÃ¤ller per region)Â

2.4. Â Samtycke (LÃ¤s-samtycke)

Detta Ã¤r funktionen fÃ¶r att vÃ¥rdgivare ska fÃ¥ se detaljerad information frÃ¥n andra vÃ¥rdgivare.

TjÃ¤nstekontraktet och knappen i webbapplikationen Ã¤r ofÃ¶rÃ¤ndrade, men resultatet av funktionen Ã¤r annorlunda.

Version 4.0	Version 4.1
NÃ¤r ett samtycke registreras sÃ¥ kan alla vÃ¥rdgivare oavsett vÃ¥rdgivare/region se samtliga andra vÃ¥rdgivares avgifter pÃ¥ samma patient.	NÃ¤r samtycke registreras sÃ¥ kan endast den vÃ¥rdgivare som registrerar samtycket se detaljerad information om avgifter som Ã¤r registrerade av andra vÃ¥rdgivare (Men bara inom den egna regionen).

2.5. Â TjÃ¤nstekontrakt Ã¤ndringar

OBS! Alla tjÃ¤nstekontrakt kommer fungera likadant som tidigare. Men tvÃ¥ tjÃ¤nstekontrakt har Ã¤ndrats (Valfri parameter har lagts till i anropet).

2.5.1. Trust

PÃ¥ grund av att eFrikort ansluter till Ineras HKS tjÃ¤nster sÃ¥ blev vi tvungna att byta utfÃ¤rdare av server-certifikat fÃ¶r tjÃ¤nstekontrakten (Ineras tjÃ¤nsteplattform krÃ¤ver att man anvÃ¤nder SITHS-funktions-certifikat). DÃ¤rfÃ¶r kan integrationerna behÃ¶va uppdatera sin "trustStore" fÃ¶r att lita pÃ¥ nya utfÃ¤rdaren (SITHS).

Mest troligtvis borde inte detta vara ett problem eftersom att certifikatet som integrationerna anvÃ¤nder Ã¤r ett SITHS-certifikat.

Tabellerna nedan visar nuvarande utfÃ¤rdare (Version 4.0) samt vilken utfÃ¤rdare av certifikat som gÃ¤ller fÃ¶r version 4.1

Ni kan ocksÃ¥ hÃ¤mta certifikaten hÃ¤r:Â https://inera.atlassian.net/wiki/spaces/IAM/pages/289082989/PKI-struktur+och+rotcertifikat

2.5.1.1. UtfÃ¤rdare i testmiljÃ¶n

Version 4.0

Version 4.1

Entrust Root Certification Authority - G2.crt
Entrust Certification Authority - L1K.crt

TEST SITHS e-id Root CA v2.crt

TEST SITHS e-id Function CA v1.crt

2.5.1.2. UtfÃ¤rdare i produktionsmiljÃ¶n

Version 4.0

Version 4.1

Entrust Root Certification Authority - G2.crt
Entrust Certification Authority - L1K.crt

SITHS e-id Root CA v2.crt

SITHS e-id Function CA v1.crt

2.5.2. Â GetExtendedCardForPerson och GetExtendedCardsForPerson (Version 3)

OBS! Det gÃ¥r fortfarande att anropa tjÃ¤nstekontrakten precis som innan.

Men eftersom samtycket (readConsent) hanteras annorlunda i den nya versionen sÃ¥ kommer man behÃ¶va skicka med den vÃ¥rdgivare som sÃ¶ker pÃ¥ frikortet fÃ¶r att kunna avgÃ¶ra vilka avgifter som fÃ¥r ses.

Detta innebÃ¤r att readConsent alltidÂ kommer bli "false" i svaret frÃ¥n eFrikort om man inte skickar med vÃ¥rdgivarens HSA-id.

Tidigare version exempel pÃ¥ anrop

<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:urn="urn:riv:itintegration:registry:1"
xmlns:urn1="urn:riv:cgi:healthcare:efrikort:GetExtendedCardsForPersonResponder:3">
<soapenv:Header>
<urn:LogicalAddress>?</urn:LogicalAddress>
</soapenv:Header>
<soapenv:Body>
<urn1:GetExtendedCardsForPerson>
<urn1:carePrincipalId>SE2321000016-39KJ</urn1:carePrincipalId>
<urn1:personId>191212121212</urn1:personId>
<urn1:cardTypeId>CARE_VISIT</urn1:cardTypeId>
<!--You may enter ANY elements at this point-->
</urn1:GetExtendedCardsForPerson>
</soapenv:Body>
</soapenv:Envelope>

Ny version exempel pÃ¥ anrop

<soapenv:Envelope 
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 
xmlns:urn="urn:riv:itintegration:registry:1" 
xmlns:urn1="urn:riv:cgi:healthcare:efrikort:GetExtendedCardsForPersonResponder:3">
   <soapenv:Header>
      <urn:LogicalAddress>?</urn:LogicalAddress>
   </soapenv:Header>
   <soapenv:Body>
      <urn1:GetExtendedCardsForPerson>
         <urn1:carePrincipalId>SE2321000016-39KJ</urn1:carePrincipalId>
         <urn1:personId>191212121212</urn1:personId>
         <urn1:cardTypeId>CARE_VISIT</urn1:cardTypeId>
         <!--Optional:-->
         <urn1:careProviderId>SE165560772419-1001</urn1:careProviderId>
      </urn1:GetExtendedCardsForPerson>
   </soapenv:Body>
</soapenv:Envelope>