1177 listning - mappning till tjänstedomän 2.0
Den här sidan har flyttats till https://inera.atlassian.net/wiki/spaces/OILT/pages/3587375171. Denna sida uppdateras inte längre och kommer att tas bort den 15 maj 2024. Om du har lagt till sidan som en favorit i webbläsaren eller i Confluence, se till att byta ut den till den rätta länken https://inera.atlassian.net/wiki/spaces/OILT/pages/3587375171. Om du har blivit länkad hit, rapportera gärna till e-tjänsternas support var länken finns så att nationella förvaltningen kan kontakta sidans ägare. Här kan du kontakta supporten: Felanmälan - Inera.
Inloggning - Startsidan
För att presentera invånares aktuella vårdval på startsidan hämtar e-tjänsten i vilken/vilka region(er) som invånaren har vårdval, genom att anropa GetListingCounty, adresserat med länskod = invånares folkbokföringsregion.
1. Anrop - GetListingCounty
Begäran
Attribut | Innehåll |
|---|---|
logicalAddress | Invånares folkbokföringsregion - länskod |
personId | Invånares personnummer |
Svar
Attribut | Innehåll |
|---|---|
listingCounties | Lista med länskoder som listningssystemet i invånares folkbokföringsregion håller reda på och som motsvarar i vilken/vilka region(er) som invånare har aktuell(a) listningar. Normalfallet är att listan innehåller en länskod men listan kan innehålla mer än en länskod. Detta i fallet där invånare listat sig i annan region för öppenvård och där hemregionen erbjuder andra listningstyper inom hemregionen och som invånare har aktuella listningar på. |
2. Anrop - GetListing
För varje länskod i listan som retuneras av GetListingCounty görs vidare ett anrop via GetListing.
Begäran
Attribut | Innehåll |
|---|---|
logicalAddress | Länskod enligt de länskoder som returnerats från anropet GetListingCounty |
personId | Invånares personnummer eller samordningsnummer |
Svar
Svaren från respektive anrop av GetListing innehåller en eller flera listningar. Listningarna summeras och presenteras under kolumnen Vårdval i bild nedan.
Varje listning är av en listningstyp. Det skapas en rubrik för de olika listningstyperna i svaren (nedan Vårdcentral, Tandvård) där listningarna vidare grupperas.
Informationen som returneras per listning är:
Attribut | Innehåll |
|---|---|
validFromDate | Datum då listningen började gälla. 1177 Listning validerar informationen, t ex om all historik av listningar erhålls från regionernas listningssystem visas endast den aktuella i tjänsten. |
validToDate | Datum till när listningen fortfarande gäller. 1177 Listning validerar informationen, t ex om all historik av listningar erhålls från regionernas listningssystem visas endast den aktuella i tjänsten. |
listingType | Listningstyp som förmedlas som en kod (datatypen CVType) och som innehåller flera fält. |
healthcareFacility | Mottagningen/vårdcentralen som listningen gäller för. Attributet är av typen HealthcareFacilityType och innehåller i sig flera attribut. 1177 Listning använder endast fältet healthcareFacility.id som innehåller mottagningens/vårdcentralens HSAId för startsidans visning. Namnet som presenteras för invånaren hämtas från HSA, baserat på HSAId:t. |
healthcarePersonnel | Vårdpersonal kopplad till listningen. Används inte av 1177 Listning på startsidan. Visas på mottagningens startsida. |
isInQueue | Flagga som visar om invånare står i kö för att lista sig på mottagningen/vårdcentralen. Om JA, då visas en röd markering “KÖAR” så som i exempelvyn ovan. |
Ändra vårdval
När invånare väljer att ändra sitt vårdval (länken Välj/ändra vårdval på startsidan) visas följande vy där invånare kan söka fram ny listningsbar mottagning med hjälp av tre filterval:
Region
Denna lista visar de regioner som invånare kan välja att lista sig på. Listan kommer att innehålla olika mängd regioner beroende på hur många regioner som anslutit sitt listningssystem till version 2.0 av tjänstedomänen för listning. En förutsättning för att invånare ska få se filtret för Region är att hemregionen anslutit sig till version 2.0. I annat fall ser inte invånare denna filterlista.
Om hemregionen anslutit sig till version 2.0 kommer hemregionen att väljas som standard. Utöver hemregionen så kommer listan att innehålla alla andra regioner som hittills anslutit sig till version 2.0
Typ av vårdval
Denna lista kommer att innehålla olika val, beroende på vilken region invånare valt i region-vallistan.
Se vidare här om vad “typ av vårdval” innehåller
Typ av vårdval, sk listningstyper, replikeras till 1177 för varje region en gång per dygn mha tjänstekontraktet GetListingTypes. Detta för att få alla korrekta benämningar för typerna och att kunna vara enhetliga med version 1.0 av 1177 listning.
Kommun
Listan med valbara kommuner per region hanteras internt av 1177. Vald kommun matchas mot mottagningens attribut för kommun, baserat på HSA-fältet “municipalityName” - Kommunnamn. 1177 Listningstjänsten har i förväg gjort en slagning för alla listningsbara mottagningar i regionen och sammanfattat denna lista.
Felmeddelanden
I de fall GetListning svara med success = False
Vid Soap-fel
Information om listning på mottagningens sida i 1177
Om en invånare loggar in i 1177 och klickar på en mottagning där hen är listad så syns uppgifterna på mottagningens sida. Uppgifterna som kan visas är vilken listningstyp (listingType) det är och vilken vårdpersonal (healthcarePersonnel) listningen gäller. Om titel skickas med för vårdpersonal så visas denna före namnet. Skickas inte titel med så skrivs texten “Vårdpersonal” ut före vårdpersonalens namn att förtydliga för invånaren att det är vad som avses. Det är upp till varje region att bestämma vilka uppgifter som ska skickas och därför visas tex inte alltid någon information om vårdpersonal.