Mappning av personuppgifter i tilläggstjänst Personec

(1)

Quality ID

Mappning av

personuppgifter i

tilläggstjänst Personec

(2)

Innehållsförteckning

1 Releasehantering ... 3

2 Förkortningar ... 3

3 Inledning ... 4

4 Mappning av personuppgifter ... 4

4.1 Ändringsavisering ... 4

4.1.1 Kopplingar ... 4

4.1.2 Omvandlingar ... 5

4.1.2.1 Personnummer ... 5

4.1.2.2 Sekretessmarkering ... 5

4.1.2.3 Förnamn ... 5

4.1.2.4 Mellannamn och efternamn ... 6

4.1.2.5 c/o adress ... 6

4.1.2.6 Gatuadress ... 6

4.2 Direktslagning ... 9

(3)

1 Releasehantering

Version Beskrivning Författare Datum

0.1 Grunddokument skapat. Max Ocklind 2016-04-21

1.0 Första version. Max Ocklind 2016-05-04

1.1 Justering av

omvandlingar för långa adresser med

gatunummer.

Max Ocklind 2016-05-30

1.2 Alternativ hantering av förnamn när

tilltalsmarkering saknas.

2.0 Valbart om mellannamn ska användas och

information om anpassad direktslagning.

2.1 Justering för QID-661 (mellan- och efternamn slås ej samman vid direktslagning).

2 Förkortningar

Förkortning Beskrivning

Navet Skatteverkets system för avisering av personuppgifter Pulsen Pulsen Integration AB, 556353-7579

Q-ID Quality ID

(4)

3 Inledning

Syftet med detta dokument är att förklara hur personuppgifter från Navet och Q-ID mappas, det vill säga kopplas och omvandlas, innan dessa importeras av Personec, samt hur den anpassade direktslagningen fungerar.

4 Mappning av personuppgifter

4.1 Ändringsavisering

Personec uppdateras automatiskt genom de nattliga ändringsaviseringar som Skatteverket skapar helgfri tisdag-lördag.

4.1.1 Kopplingar

Nedanstående tabell ger en översikt över hur fälten för personuppgifterna kopplas mellan Q-ID och Personec. Personuppgifter som inte står med i tabellen importeras inte till Personec, och fält i Personec-importen som inte står med i tabellen lämnas tomma.

Personuppgift Fält i Q-ID (termkod i Navet)

Fältlängd i Q-ID (och Navet)

Fält i Personec- import

Fältlängd i Personec- import Personnummer TK01001 12 InsuranceId 10 Sekretessmarkering TK01003 1 OptionalStr 2000 Tilltalsmarkering

Förnamn

TK01011 TK01012

2 80

FirstName 20

Mellannamn Efternamn

TK01013 TK01014

40 60

LastName 255

c/o adress TK01031 35 CoAddress 30

Gatuadress TK01033 35 Street 30

Postnummer TK01034 5 ZipCode 10

Postort TK01035 27 City 30

Värt att notera är att utöver eventuella omvandlingar enligt nedan så lagrar Q-ID (och Navet) alltid innehållet för personuppgifterna gatuadress, c/o adress och postort med stora bokstäver, varför dessa även kommer att ha stora bokstäver när de importeras till Personec.

(5)

4.1.2 Omvandlingar

Nedanstående omvandlingar av personuppgifter görs av Q-ID innan dessa skickas till Personec, till exempel i de fall då längden för ett fält i Personec är kortare än för motsvarande fält i Q-ID. Uppgifter som inte beskrivs nedan omvandlas inte.

4.1.2.1 Personnummer Sekelsiffror utelämnas alltid.

Exempel:

190102031234 omvandlas till 0102031234

4.1.2.2 Sekretessmarkering

Sätts till ANONYM=1 om sekretessmarkering finns, annars till ANONYM=0.

4.1.2.3 Förnamn

Om personen saknar tilltalsmarkering och förnamn innehåller flera namn och är längre än 20 tecken så ersätts det sista namnet med sin initial, alternativt dubbelinitial med bindestreck om det är ett dubbelnamn med bindestreck. Om det omvandlade förnamnet fortfarande är längre än 20 tecken så upprepas proceduren med det näst sista namnet, och så vidare.

Det finns även möjlighet att istället välja att enbart det första förnamnet skall användas om tilltalsmarkering saknas.

Om det omvandlade förnamnet av någon anledning fortfarande är längre än 20 tecken efter det att samtliga namn har ersatts med initialer, eller om tilltalsnamn eller förnamn med enbart ett namn är längre än 20 tecken, så används enbart de första 20 tecknen av förnamnet (och eventuellt

avslutande mellanslag tas bort).

Exempel:

Birgitta Maria Gunnarsdtr omvandlas till Birgitta Maria G

Ingrid Gunnel Marie-Louise omvandlas till Ingrid Gunnel M-L

Bha Aldan Nasruldeen Abdul-Rahman omvandlas till

(6)

Amiteera Birina Simantiye Singyemma Pulanvvia Angiriyata Immeruna Veruna omvandlas till

A B S S P A I V

Cristina-Doruta-Maria omvandlas till Cristina-Doruta-Mari

4.1.2.4 Mellannamn och efternamn

Om mellannamn finns läggs detta (och ett mellanslag om inte efternamn saknas) på framför efternamnet. Detta sker dock enbart vid löpande avisering/uppdatering via integrationen, och inte vid direktslagning via REST-gränssnittet.

Exempel:

Mellannamn Nilsson och efternamn Svensson omvandlas till Nilsson Svensson

Det finns även möjlighet att välja att helt utelämna eventuellt mellannamn.

Exempel:

Mellannamn Nilsson och efternamn Svensson omvandlas till Svensson

4.1.2.5 c/o adress

Enbart de första 30 tecknen används (och eventuellt avslutande mellanslag tas bort) om c/o adress finns, annars lämnas fältet tomt.

Exempel:

ANDREAS SVENSSON/STINA JOHANSSON omvandlas till ANDREAS SVENSSON/STINA JOHANSS

4.1.2.6 Gatuadress

Om gatuadress är längre än 30 tecken sker nedanstående kedja av

omvandlingar i angiven ordning; (1 och 2) ta bort lägenhetsnummer, (3) ta bort trappnummer, (4) korta VÄG och VÄGEN, (5) korta GATA och GATAN, (6) kapa gatuadress före nummer, samt (7) kapa vid 30 tecken. Kedjan av omvandlingar går enbart vidare till nästa steg om den omvandlade

gatuadressen fortfarande är längre än 30 tecken efter omvandlingen i det aktuella steget.

(7)

1. Om LGH finns; ta bort detta inklusive direkt föregående mellanslag, eventuellt direkt efterföljande mellanslag, samt direkt efterföljande siffror i slutet av gatuadressen.

Exempel:

TEGELSLAGAREGATAN 41 A LGH 1102 och

TEGELSLAGAREGATAN 41 A LGH1102 omvandlas till TEGELSLAGAREGATAN 41 A

2. Om LÄG finns; ta bort detta inklusive direkt föregående mellanslag, eventuellt direkt efterföljande mellanslag, samt direkt efterföljande siffror och tecken i gatuadressen.

Exempel:

DALSJÖVÄGEN 25 RÖNNGÅRD 1 LÄG 338 och DALSJÖVÄGEN 25 RÖNNGÅRD 1 LÄG 338A och DALSJÖVÄGEN 25 RÖNNGÅRD 1 LÄG338 och

DALSJÖVÄGEN 25 RÖNNGÅRD 1 LÄG338A omvandlas till DALSJÖVÄGEN 25 RÖNNGÅRD 1

3. Om TR finns i slutet av gatuadressen; ta bort detta inklusive direkt eventuellt föregående mellanslag, direkt föregående siffror (eller 1/2) och framför siffrorna direkt föregående mellanslag.

Exempel:

SÖDRA ENGELBREKTSGATAN 107 A 4 TR och SÖDRA ENGELBREKTSGATAN 107 A 4TR och SÖDRA ENGELBREKTSGATAN 107 A 1/2 TR och

SÖDRA ENGELBREKTSGATAN 107 A 1/2TR omvandlas till SÖDRA ENGELBREKTSGATAN 107 A

4. Om en av gatuadressens delar är längre än tre sammanhängande tecken (utan avbrott för mellanslag eller bindestreck) och slutar på VÄG eller VÄGEN ersätts detta suffix med V.

Exempel:

NORD-VÄSTRA HUNNETORPSVÄGEN 102 A och

NORD-VÄSTRA HUNNETORPSVÄG 102 A omvandlas till NORD-VÄSTRA HUNNETORPSV 102 A

NORD-VÄSTRA HUNNETORPS VÄGEN 102 A eller

(8)

NORD-VÄSTRA HUNNETORPS VÄG 102 A eller NORD-VÄSTRA HUNNETORPS-VÄGEN 102 A eller NORD-VÄSTRA HUNNETORPS-VÄG 102 A eller NORD-VÄSTRA HUNNETORPS ÅVÄGEN 102 A eller NORD-VÄSTRA HUNNETORPS ÅVÄG 102 A eller NORD-VÄSTRA HUNNETORPS-ÅVÄGEN 102 A eller

NORD-VÄSTRA HUNNETORPS-ÅVÄG 102 A omvandlas inte av steg 4

5. Om en av gatuadressens delar är längre än tre sammanhängande tecken (utan avbrott för mellanslag eller bindestreck) och slutar på GATA eller GATAN ersätts detta suffix med G.

Exempel:

NORD-ÖSTRA FOGDELYCKEGATAN 127 D och

NORD-ÖSTRA FOGDELYCKEGATA 127 D omvandlas till NORD-ÖSTRA FOGDELYCKEG 127 D

NORD-ÖSTRA FOGDELYCKE GATAN 127 D eller NORD-ÖSTRA FOGDELYCKE GATA 127 D eller NORD-ÖSTRA FOGDELYCKE-GATAN 127 D eller NORD-ÖSTRA FOGDELYCKE-GATA 127 D eller NORD-ÖSTRA FOGDELYCKE BYGATAN 127 D eller NORD-ÖSTRA FOGDELYCKE BYGATA 127 D eller NORD-ÖSTRA FOGDELYCKE-BYGATAN 127 D eller

NORD-ÖSTRA FOGDELYCKE-BYGATA 127 D omvandlas inte av steg 5

6. Om gatuadressen är längre än 30 tecken och börjar med minst ett tecken före ett mellanslag följt av en eller flera siffror (eventuellt följt av flera tecken) så kapas gatuadressen före siffrorna (och eventuella extra mellanslag tas bort).

Exempel:

VÄRMLANDS-SÄBY TRÄDGÅRDSVILLAN 1 omvandlas till VÄRMLANDS-SÄBY TRÄDGÅRDSVILL 1

NORD-VÄSTRA STORFORSENS ÅVÄG 102 B och

NORD-VÄSTRA MELLANSTORA ÅVÄGEN 102 B omvandlas till NORD-VÄSTRA STORFORSENS 102 B

NORD-VÄSTRA STORFORSENS-ÅVÄG 102 B och

NORD-VÄSTRA MELLANSTORA-ÅVÄGEN 102 B omvandlas till NORD-VÄSTRA STORFORSENS- 102 B

(9)

NORD-VÄSTRA STORFORSENS ÅGATA 102 C och

NORD-VÄSTRA MELLANSTORA ÅGATAN 102 C omvandlas till NORD-VÄSTRA STORFORSENS 102 C

NORD-VÄSTRA STORFORSENS-ÅGATA 102 C och

NORD-VÄSTRA MELLANSTORA-ÅGATAN 102 C omvandlas till NORD-VÄSTRA STORFORSENS- 102 C

7. Enbart de 30 första tecken av gatuadressen används (och eventuellt avslutande mellanslag tas bort).

Exempel:

VÄRMLANDS-SÄBY STORA TRÄDGÅRDSVILLAN omvandlas till VÄRMLANDS-SÄBY STORA TRÄDGÅRDS

4.2 Direktslagning

Direktslagning, eller personnummerslagning som det också kallas, sker genom REST-anrop mot Q-ID enligt dokumentationen på

http://wiki.pulsen.se/qid/index.php?title=REST#GET_PERSON.

Svaret för direktslagningen kan anpassas för Personec genom att skicka med värdet ”personec” (utan citattecken) i antingen http-header Accept- System eller query-parameter system. Svaret kommer då att behålla samma format och struktur som annars, men förnamn, mellannamn och

efternamn, c/o adress och gatuadress kommer att omvandlas på samma sätt som beskrivs i kapitel 4.1.2 Omvandlingar. Om det är konfigurerat att enbart det första förnamnet skall användas om tilltalsmarkering saknas så kommer fältet för tilltalsmarkering att tas bort ur svaret.