...
Datum | Version | Namn | Förändring |
|---|---|---|---|
21 | 1.0 | Jimmy Fridh | Dokument publicerat |
...
Läs mer om anslutning/uppgradering till nya versioner av tjänstekontrakt: Anslutningsprocess 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.
Tjänstekontrakt | Ny tjänstekontraktsversion |
|---|---|
GetPersonContactInformation | 4.0 |
GetPersonContactInformationUnrestricted | 4.0 |
GetPersonForProfile | 5.0 |
GetPersonForProfileUnrestricted | 5.0 |
LinkPersonIdentity | 4.0 |
SearchPersonsForProfile | 5.0 |
SearchPersonsForProfileByOrder | 5.0 |
SearchPersonsForProfileByOrderUnrestricted | 5.0 |
SearchPersonsForProfileUnrestricted | 5.0 |
UnlinkPersonIdentity | 4.0 |
UpdatePerson | 5.0 |
UpdatePersonContactInformation | 4.0 |
UpdatePersonContactInformationUnrestricted | 4.0 |
Följande REST-tjänst får en ny version.
REST-tjänst | Ny version |
|---|---|
SearchPersonsByFile (v2) | GetPersonsByFile |
Följande delavsnitt 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
...
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: Information om kommande förändringar gällande samordningsnummer | Skatteverket: 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 - Inera - PU
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.
Förändring i Navet | Grupp | Termnamn | Termkod | Datatyp | Värderymd i Navet |
Borttagen | Namn | Fornamn styrkt | 01212 | Boolean | true/false |
Borttagen | Namn | Mellamnamn styrkt | 01213 | Boolean | true/false |
Borttagen | Namn | Efternamn styrkt | 01214 | Boolean | true/false |
Borttagen | OrtUtlandet | FodelseortUtland styrkt | 01293 | Boolean | true/false |
Borttagen | Medborgarskap | MedborgarskapslandKod styrkt | 03201 | Boolean | true/false |
Tillagd | Personid | Identitetsniva | 01311 | Str | STYRKT |
Tillagd | Personid | Identitetsnivadatum | 01312 | Num | ÅÅÅÅMMDD: ÅÅÅÅ: 2000 - 2023* MM: 00 – 12 DD: 00 - 31
|
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.
Navet termnamn | Påverkad Klass i PU-tjänsten | Påverkat attribut på angiven Klass i PU | Påverkat attribut på PersonRecord i PU |
Fornamn styrkt | urn:riv:strategicresourcemanagement:persons:person:5:NamePartType | attested | name.givenName.attested |
MedborgarskapslandKod styrkt | urn:riv:strategicresourcemanagement:persons:person:5:CitizenshipCountryCodeType | attested | citizenship.citizenshipCountryCode.attested |
FodelseortUtland styrkt | urn:riv:strategicresourcemanagement:persons:person:5:PlaceOfBirthAbroadType | attested | birth.birthAbroad.attested |
...
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.
Navet term | Implementerad i PU Klass | Nytt attribut på angiven Klass i PU | Nytt attribut på PersonRecord i PU | Datatyp i PU | Värderymd i PU |
Identitetsniva | urn:riv:strategicresourcemanagement:persons:person:5:PersonRecordType | identityLevel | identityLevel | Sträng | STYRKT |
Identitetsnivadatum | urn:riv:strategicresourcemanagement:persons:person:5:PersonRecordType | identityLevelDate | identityLevelDate | PartialDate | ÅÅÅÅMMDD: ÅÅÅÅ: 2000 - 2023* MM: 00 – 12 DD: 00 - 31 * = tom nuvarande år |
Påverkade tjänstekontrakt
Följande tjänstekontrakt påverkas av denna förändringav förändringarna av attribut för Samordningsnummer:
GetPersonsForProfile (blir v5)
GetPersonsForProfileUnrestricted (blir v5)SearchPersonsForProfileByOrder (blir
SearchPersonsForProfile v5)SearchPersonsForProfileByOrderUnrestricted (
blir SearchPersonsForProfileUnrestricted v5)SearchPersonsForProfile (blir
SearchPersonsForProfileByOrder v5)SearchPersonsForProfileUnrestricted (
blir SearchPersonsForProfileByOrderUnrestricted v5)
Förändring av PU REST-tjänster
Eftersom personposter förändras påverkar det även en REST-tjänst som 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.
...
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.
...