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.

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.

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.

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

2.5.1.2. Utfärdare i produktionsmiljön

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.

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

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

3. Dokumentation

Följande dokumentation finns för eFrikort 4.1

3.1. Användarhandbok

https://efrikort.atlassian.net/wiki/spaces/EFP/pages/70975490/Anv+ndarhandbok+eFrikort+4.1

3.2. Systemdokumentation

3.2.1. Testrapport

https://proactionsc.ent.cgi.com/confluence/display/SEEFK/4.1+Testrapport

3.3. Fullständig åtgärdslista

Länk kommer när testrapport är klar.