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>