Dokumenthistorik 

Innehåll

Datum

Följande datum gäller för införandet av releasen.

Om Releasen

Releasen är av typen major-release och introducerar en ny domänversion v5 för Personuppgiftstjänsten. Alla befintliga kunder/tjänstekonsumenter behöver genomföra en nyanslutning till de nya versionerna av berörda tjänstekontrakt.

Läs mer om domänversioner och hur länge de äldre domänversionerna v3 och v4 kommer att finnas tillgängliga: https://inera.atlassian.net/wiki/spaces/PU/pages/3353216374

Läs mer om anslutning/uppgradering till nya versioner av tjänstekontrakt: https://inera.atlassian.net/wiki/spaces/PU/pages/3353216099/Anslutningsprocess#Uppgradering-av-tj%C3%A4nstekontrakt

Förändringar av Tjänstekontrakt och REST-tjänster

Detta avsnitt beskriver de tjänstekontrakt och REST-tjänster som förändras i den nya domänversionen. Listan nedan visar vilka tjänstekontrakt som får ett nytt versionsnummer. I samtliga dessa fall rör det sig om major-uppdateringar som kräver att anslutande kund/tjänstekonsument genomgår en ny anslutningsprocess.

Följande tjänstekontrakt har oförändrad version i nya tjänstedomänen och kräver ej ny anslutningsprocess vid uppgradering:

Följande REST-tjänst får en ny version.

Delavsnitten nedan beskriver de specifika förändringar som skett för tjänstekontrakt och REST-tjänst.

Förändrade attribut för att styrka Samordningsnummer

Två nya attribut har lagts till i Navet, och de blir läsbara via tjänstekontrakten samt REST-tjänster i domänversion v5.

Fem attribut levereras inte längre av Navet, och de tas bort ur tjänstekontrakten samt REST-tjänster i domänversion v5.

Bakgrund

I september 2023 införde Skatteverket efter lagändring en förändring av hur styrkt information för Samordningsnummer hanteras. Skatteverkets information om förändringen: https://www.skatteverket.se/offentligaaktorer/informationsutbyte/navethamtauppgifteromfolkbokforing/nyheter/2023/nyheter/informationomkommandeforandringargallandesamordningsnummer.5.fa979e918895f4387d2fa.html

PU Release 4.9.2 gjorde vissa anpassningar av PU-tjänsten för Skatteverkets förändring: https://confluence.cgiostersund.se/display/PU/4.9.2+Release+Notes

Att tillgängliggöra de nya attributen via PU-tjänsten krävde dock en major-release, vilket är den nu aktuella releasen, där PU-tjänsten fullt ut implementerar Skatteverkets förändringar via nya tjänstekontraktversioner.

Förändringen i Navet

Tabellen nedan redovisar, för kontext, vilka av Navets termer/attribut som är påverkade enligt Skatteverkets dokumentation Navet Bilaga 7.

I delavsnitten nedan redovisas hur dessa förändringar har implementerats i Personuppgiftstjänstens domänversion v5.

Förändring av PU personposter: Attribut som inte längre levereras

Följande attribut ingår inte längre i personposter i Personuppgiftstjänsten från och med domänversion v5. Notera att tre av attributen delar samma beskrivande Klass.

I samband med att dessa Styrkt-attribut tas bort så finns inte längre behovet av att samla både huvudattribut (såsom Förnamn) och Styrkt-attribut (såsom Förnamn styrkt) i en gemensam klass (såsom NamePartType). Strukturen plattas därför ut. Se Tjänstekontraktbeskrivning (TKB) för fullständig ny struktur.

Förändring av PU personposter: Attribut som tillkommit

Följande två nya attribut har tillkommit på personposter i Personuppgiftstjänsten från och med tjänstedomän v5. De läggs direkt på personpostens rotnivå, eftersom det är så dessa är införda i Navet.

Påverkade tjänstekontrakt

Följande tjänstekontrakt påverkas av förändringarna av attribut för Samordningsnummer:

• GetPersonsForProfile v5

• GetPersonsForProfileUnrestricted v5

• SearchPersonsForProfile v5

• SearchPersonsForProfileUnrestricted v5

• SearchPersonsForProfileByOrder v5

• SearchPersonsForProfileByOrderUnrestricted v5

Förändring av PU REST-tjänster

Eftersom personposter förändras påverkar det även en REST-tjänst vilken behöver få en ny version som blir anpassad för tjänstedomän v5. Svarsfilerna som genereras av denna nya version kommer att på personposterna kunna innehålla de nya attributen och de gamla är borttagna.

Påverkan hos gamla tjänstedomäner v3 och v4

Ingen förändring av aktuella attribut sker för de äldre domänversionerna v3 och v4. Via dessa versioner av tjänstekontrakt och REST-tjänster kommer de gamla attributen i förekommande fall fortfarande att kunna levereras, i den mån de sedan tidigare finns lagrade i Inera PU-tjänst. Se mer information i https://inera.atlassian.net/wiki/spaces/PU/pages/3353216800. Det är viktigt att understryka att denna data inte underhålls av Skatteverket.

Nytt attribut för kontaktuppgifters aktualitet

Ett nytt attribut har införts för att ge anslutna kunder/tjänstekonsumenter stöd i att bedöma hur aktuella kontaktuppgifter är som finns lagrade i PU-tjänsten. Attributet är en tidsstämpel som sätts vid varje tillfälle som en skrivning av kontaktuppgifter sker till en specifik personpost.

Tidsstämpeln gäller för personpostens kontaktuppgifter i sin helhet, och den säger inte att kontaktuppgifterna nödvändigtvis har förändrats vid detta tillfälle, utan det kan vara så att redan befintliga uppgifter har sparats igen.

Tidsstämpeln kan inte sättas retraktivt för de kontaktuppgifter som redan finns i PU-tjänsten, så i startskedet kommer tidsstämpeln att sakna värde på alla befintliga personposter. I takt med att nya skrivningar av kontaktuppgifter görs av anslutna tjänstekonstumenter så kommer antalet personposter som har ett värde på tidsstämpeln att öka.

Det nya attributet namnges updateTime och införs i klassen Actor, vilket ger möjlighet till framtida utbyggnad att sätta tidsstämplar i andra användningsfall som nyttjar samma klass.

Attributet är endast tillgängligt genom domänversion v5.

Namnbyte för REST-tjänst SearchPersonsByFile till GetPersonsByFile

Genom REST-tjänsten SearchPersonsByFile har en användare kunnat skicka in en lista på personidentiteter och utföra en bulk-slagning på dessa hos PU-tjänsten. Ingen kriteriesökning utförs alltså, utan det är i grund en hämtning av specifika identiteter, vilket är mer analogt med en tjänst av typ Get än av typ Search. Därför byter REST-tjänsten nu namn till GetPersonsByFile.

Namnbytet påverkar ej tidigare domänversioner, så SearchPersonsByFile finns kvar med detta namn för domänversion v3 och v4 utan förändring.

Korrigerad hantering av Namespace i svar från SearchPersonsByFile

I svar från REST-tjänsten SearchPersonsByFile v2 (dvs version kompatibel med domänversion v4) görs en okonventionell hantering av så kallade prefix och namespace i den XML-fil som innehåller svaret. Detta har hos anslutna kunder/tjänstekonsumenter kunnat ge upphov till varningar och valideringsfel i vissa verktyg och system. Detta är nu ändrat i nya REST-tjänsten GetPersonsByFile* så att dessa varningar och valideringsfel ej längre ska förekomma.

Eftersom kunder som anslutit till domänversion 4 redan har anpassat sig till hur namespace hanteras där så görs ingen retroaktiv förändring av domänversion 4, utan endast domänversion 5 påverkas.

*) Notera även att SearchPersonsByFile byter namn till GetPersonsByFile i en separat beskriven förändring.

Stöd för ny Navet aviseringsfil 2024

Skatteverket har meddelat att en förändring kommer att ske i formatet för Navets aviseringsfiler någon gång under Q2 2024. Denna förändring påverkar inte på ett direkt sätt kunder/tjänstekonsumenter till Personuppgiftstjänsten, utan är något som Inera hanterar. Förändringen finns dokumenterad hos Skatteverket på webplats https://www.skatteverket.se/offentligaaktorer/informationsutbyte/navethamtauppgifteromfolkbokforing/nyheter/2023/nyheter/forandringarinavetsaviseringsfiler.5.7da1d2e118be03f8e4f2981.html. Tester har utförts så att PU-tjänsten kan hantera import av både gamla och nya formatet.

Förändringar i PU GUI

I detta avsnitt redovisas de förändringar som införts i Ineras grafiska gränssnitt PU GUI i samband med aktuell release. PU GUI erbjuds inte i flera versioner, utan hålls alltid uppdaterad till att vara gällande för den senaste domänversionen av PU-tjänsten.

Stöd för nya attribut för Samordningsnummer

De två nya attribut rörande styrkta Samordningsnummer som beskrivs under rubrik “Förändrade attribut för att styrka Samordningsnummer” har införts i PU GUI enligt tabell och bild nedan.

Open

Bild: Placering av nya attribut för Samordningsnummer i PU GUI.

Stöd för ny tidsstämpel för kontaktuppgifters aktualitet

Den nya tidsstämpeln updateTime som beskrivs under rubrik “Nytt attribut för kontaktuppgifters aktualitet” har införts i PU GUI under följande plats på personposter. Om data ännu saknas på tidsstämpeln så visas värdet som <okänt>.

Open

Bild: Placering av tidsstämpel för kontaktuppgifters aktualitet, med känt värde.