17.07.2013 Views

Teknisk beskrivning 2012-07-24 - Skatteverket

Teknisk beskrivning 2012-07-24 - Skatteverket

Teknisk beskrivning 2012-07-24 - Skatteverket

SHOW MORE
SHOW LESS

Transform your PDFs into Flipbooks and boost your revenue!

Leverage SEO-optimized Flipbooks, powerful backlinks, and multimedia content to professionally showcase your products and significantly increase your reach.

* <strong>Skatteverket</strong><br />

Navet<br />

AVISERING AV<br />

FOLKBOKFÖRINGSUPPGIFTER<br />

TEKNISK BESKRIVNING


*<strong>Skatteverket</strong> 2(72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

TEKNISK BESKRIVNING FÖR AVISERING OCH URVAL FRÅN<br />

AVISERINGSREGISTRET AV FOLKBOKFÖRINGSUPPGIFTER<br />

Innehållsförteckning<br />

1 Media 4<br />

1.1 Filöverföring via datakommunikation ......... 4<br />

1.1.1 Definitioner och förkortningar.......... 4<br />

1.1.2 e-transport............................. 8<br />

1.1.3 SHS..................................... 9<br />

1.2 Magnetmedia ................................ 10<br />

1.3 Utskrifter ................................. 11<br />

2 Utdataformat .................................. 12<br />

3 Datafiler med format termkod/termdata ......... 12<br />

3.1 Teckenrepresentation ....................... 12<br />

3.2 Postmarkering .............................. 12<br />

3.3 Filposter .................................. 12<br />

3.3.1 Konventioner för filnamn m.m. för olika<br />

medietyper............................ 12<br />

3.3.2 Datafil-avisering...................... 15<br />

4 Filstrukturer med termkod/termdata ............ 20<br />

4.1 Specifikation av INFO.NAV - etikettfil ..... 20<br />

4.2 Specifikation av avisering via SHS/e-transport<br />

- Metadatadel ................................... 22<br />

4.3 Specifikation av datafil - avisering ....... <strong>24</strong><br />

5 Exempel på filer med termkod/termdata ......... 26<br />

5.1 Filexempel - Utfiler ....................... 26<br />

5.2 Filexempel – Infiler levererade via SHS/etransport<br />

32<br />

5.3 Infiler – vanliga fel ...................... 33<br />

6 Datafiler med XML-format ...................... 35<br />

6.1 Teckenrepresentation ....................... 35<br />

6.2 Struktur på XML-formatet ................... 35<br />

6.3 Validering mot XML-schema .................. 35<br />

6.4 Filstorlek vid avisering ................... 35<br />

6.5 Konventioner för filnamn ................... 35<br />

6.5.1 Filer med folkbokföringsinformation.... 36<br />

SKATTEVERKET Webbplats: skatteverket.se<br />

Postadress Besöksadress Telefon Telefax E-postadress<br />

171 94 SOLNA 010 - 5748050 08-29 37 44 navet.solna@skatteverket.se


*<strong>Skatteverket</strong> 3 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

6.5.2 Meddelandefiler........................ 36<br />

7 Exempel på filer med XML-Format ............... 38<br />

7.1 Filexempel – Utfiler ....................... 38<br />

8 Beskrivning av element/attribut -<br />

termdata/termkod.................................. 46<br />

8.1 Termförteckning ............................ 47<br />

8.2 Värdeförråd ................................ 50<br />

8.3 Fältnamn, etikettfil ....................... 53<br />

8.4 Fältnamn, metadata SHS/e-transport ......... 53<br />

8.5 Fältnamn, datafil - avisering .............. 55<br />

8.6 Översättningstabell element/attribut/<br />

termkod/termgrupp folkbokföringspost ............ 60<br />

8.7 Kommentarer ................................ 64<br />

8.7.1 Termkod 01004 - Ärendetyp, kod......... 64<br />

8.7.2 Termkod 01045, 01046, 01047 Riksnycklar 65<br />

9 Direktåtkomst ................................. 66<br />

9.1 Web Services - ePersondata ................. 66<br />

9.1.1 Inledning.............................. 66<br />

9.1.2 Inparametrar till Web Service Personpost<br />

...................................... 67<br />

9.1.3 Inparametrar till Web Service Namnsökning<br />

...................................... 68<br />

9.2 Postinnehåll Web Service Personpost ........ 68<br />

9.3 Postinnehåll Web Service Namnsökning ....... 72<br />

Bilaga 1 Termkoder för aviseringstermer<br />

Bilaga 2 Exempelsamling på postutseende i datafil<br />

för olika ärenden<br />

Bilaga 6 <strong>Teknisk</strong> handledning för<br />

Web Service kommunikation<br />

Bilaga 7 XML-struktur<br />

Bilaga 8 <strong>Teknisk</strong> handledning för<br />

demoversion Web Service<br />

Bilaga 9 Testdata för demoversion Web Service


*<strong>Skatteverket</strong> 4 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

1 Media<br />

1.1 Filöverföring via datakommunikation<br />

1.1.1 Definitioner och förkortningar<br />

Autenticering<br />

Teknik för identifiering av en användare. Svag<br />

autenticering består enbart av användaridentitets<br />

och lösenordskontroll. Stark autenticering görs med<br />

hjälp av kryptologiska metoder. Dubbelriktad stark<br />

autenticering innebär att såväl användare som<br />

målsystem/server identifierar sig för varandra genom<br />

kryptologiska metoder. Som hjälp vid stark<br />

autenticering kan smart kort eller smart disk<br />

användas.<br />

Automatiserad hämtning/lämning<br />

Lämning av infil/hämtning av utfil som sker genom<br />

ett batchorienterat förfarande med hjälp av program.<br />

Dekryptering<br />

Göra en fil läsbar igen, se Kryptering.<br />

Digital signatur<br />

En digital signatur åstadskoms genom att ett<br />

kondensat (en checksumma) beräknas för en<br />

informationsmängd (fil eller dokument) med hjälp av<br />

en algoritm (tex MD5). Kondensatet krypteras med<br />

asymmetrisk kryptering (tex RSA) med användarens<br />

hemliga nyckel vilket ger den digitala signaturen,<br />

som placeras i dokumentet. Med kännedom om<br />

användarens publika nyckel kan dokumentets innehåll<br />

och utställare verifieras. Se även Sigillering.<br />

e-transport<br />

SHS:s e-transport ger via webbsidor möjlighet att<br />

lämna och hämta filer till och från ett SHS. Syftet<br />

med webbgränssnittet är att ge certifierade<br />

användare tillgång till SHS funktionalitet, även om<br />

de inte är integrerade i själva SHS-systemet.<br />

Vid inloggning identiferar sig användaren med ett<br />

certifikat. Användaren kan sedan nå <strong>Skatteverket</strong>s<br />

SHS mottagnings- och/eller distributionstjänst


*<strong>Skatteverket</strong> 5 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

beroende på vilket avtal som slutits med<br />

<strong>Skatteverket</strong>. Användaren kan peka ut en fil i<br />

<strong>Skatteverket</strong>s SHS och lagra filen på sin egen dator<br />

eller sitt interna nät som är tillgänglig för<br />

användaren.<br />

SHS:ets e-transport tillhandahåller också<br />

batchkommunikation för automatiserad<br />

meddelandeöverföring.<br />

Interaktiv hämtning/lämning<br />

Lämning av infil/hämtning av utfil som sker med<br />

hjälp av ett klientverktyg.<br />

Internet Draft<br />

Arbetsdokument från the Internet Engineering Task<br />

Force (IETF) som kan användas som referensmaterial.<br />

ISDN<br />

Integrated Services Digital Network, en uppringd<br />

digital höghastighets teleförbindelse. (Kräver AXEanslutning).<br />

Kryptering<br />

Kryptering är ett sätt att förvanska en<br />

informationsmängd så att endast behöriga personer<br />

(dvs de med rätt nyckel) kan ta del av<br />

informationen.<br />

Man skiljer på symmetrisk och asymmetrisk<br />

kryptering. Vid symmetrisk kryptering används samma<br />

nyckel för kryptering och dekryptering. Vid<br />

asymmetrisk kryptering används olika nycklar, en<br />

hemlig (känd av bara en part) och en publik (som kan<br />

vara känd av alla). Det som krypteras med den<br />

hemliga nyckeln kan dekrypteras endast med den<br />

publika nyckeln och vice versa.<br />

Symmetrisk kryptering är väsentligt snabbare än<br />

asymmetrisk kryptering, varför symmetrisk kryptering<br />

används vid kryptering av stora informationsmängder.<br />

Asymmetrisk kryptering används vanligen för att<br />

kryptera checksummor (tex för att skapa digitala<br />

signaturer) eller nycklar för symmetrisk kryptering<br />

(vilka då kan skickas till mottagaren tillsammans<br />

med information).


*<strong>Skatteverket</strong> 6 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

Exempel på symmetrisk kryptering är DES (en<br />

amerikansk metod som blivit de facto standard) och<br />

KA26 (framtagen av svenska försvaret). Exempel på<br />

asymmetrisk kryptering är RSA. Krypteringsnycklar<br />

kan förvaras på smart card eller smart disk.<br />

Linjekryptering används för att skydda mot<br />

avlyssning av datatrafiken.<br />

Metadata<br />

Med metadata menas information om information, d.v.s<br />

information som på något sätt beskriver en datamängd<br />

utan att själv ingå i datamängden.<br />

MIME<br />

Multipurpose Internet Mail Extensions. Ett utökat<br />

Internet Mail protokoll som tillåter multimedial<br />

kommunikation.<br />

RFC<br />

Request For Comments. En samling dokument där<br />

Internet-standarder, föreslagna standarder och<br />

allmänt godtagna idéer dokumenteras och publiceras.<br />

RSA<br />

Rivest, Shamir och Abelsons algoritm för asymmetrisk<br />

kryptering som möjliggör kryptering med en nyckel<br />

och dekryptering med en annan. Krypteringsnyckeln<br />

kan inte räknas ut med hjälp av<br />

dekrypteringsnyckeln.<br />

Sigillering<br />

En teknik att kunna kontrollera att informationen i<br />

en fil eller ett dokument inte blivit förändrad. Med<br />

hjälp av en algoritm och en hemlig nyckel skapas för<br />

en viss informationsmängd en kontrollsumma, ett<br />

sigill. Genom kännedom om algoritmen och den hemliga<br />

nyckeln gör mottagaren samma beräkning.<br />

Erhålls samma sigill är informationen oförändrad.<br />

Jämför också digital signatur. Skillnaden är bl a<br />

att vid sigillering används samma hemliga nyckel,<br />

vilken måste vara känd av både avsändare och<br />

mottagare.


*<strong>Skatteverket</strong> 7 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

SHS<br />

Spridnings- och HämtningsSystem. Dokumenttransportör<br />

för data mellan olika verksamhetssystem.<br />

Genom ett gemensamt format för transport bidrar SHS<br />

till att effektivisera samverkan mellan statliga<br />

myndigheter och med övriga organisationer i den<br />

offentliga sektorn. SHS gör det också möjligt att<br />

förenkla informationsutbytet mellan medborgare,<br />

företag och offentlig sektor.<br />

Med SHS kan aktörer som utbyter information<br />

identifiera sig mot varandra. Funktioner finns för<br />

att avsändaren säkert skall veta att informationen<br />

överförts. Innehållet kan transporteras både<br />

krypterat och okrypterat. Vidare kan transporten<br />

eller enstaka dokument signeras. Vilken<br />

säkerhetsnivå som skall tillämpas bestäms i<br />

överenskommelsen mellan dem som utbyter information.<br />

SSL<br />

Secure Sockets Layer, ett säkerhetsprotokoll för<br />

WWW. Består av två protokoll, SSL Record Protocol<br />

för säker transport och SSL Handshake Protocol för<br />

stark autenticering.<br />

URL<br />

Universal Resource Locator. Pekar unikt ut en<br />

resurs, vanligen ett dataobjekt, samt det protokoll<br />

som skall användas för operationer mot objektet.<br />

X.509 Certifikat<br />

Certifikat som används vid stark autenticering av<br />

både server och klient.<br />

XML<br />

XML, eXtensible Markup Language, är en standard som<br />

utvecklats av W3C. XML är ett sätt att strukturera<br />

data. XML gör det lätt för en dator att generera<br />

data, läsa data och garantera att datastrukturer är<br />

entydiga.<br />

XML-schema<br />

XML-schema är en specifikation för att beskriva


*<strong>Skatteverket</strong> 8 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

strukturen i XML-dokument. En föregångare till XMLschema<br />

är DTD, Document Type Definition. XML-schema<br />

är dock ett mer flexibelt och kraftfull sätt att<br />

beskriva XML-dokument. Ett XML-schema identifierar<br />

bland annat element som kan förekomma i ett XMLdokument,<br />

i vilken ordning de förekommer, vilka<br />

attribut de kan ha och vilka element som är<br />

underordnade.<br />

Web-server<br />

Ett program vars huvuduppgift är att exekvera Webserverprogram.<br />

Web Services<br />

Web Service är en teknik för att direkt utbyta<br />

information och tjänster över Internet. Web Services<br />

är baserat på öppna standarder och protokoll, bland<br />

annat SOAP = Simple Object Access Protocol. Web<br />

Services syftar till att underlätta kommunikation<br />

och informationsutbyte oavsett teknisk plattform<br />

eller programspråk.<br />

Med Web Service är gränssnittet maskinellt vilket<br />

innebär att anrop till tjänsten byggs in i<br />

befintliga IT-system eller i en ny applikation hos<br />

kunden.<br />

1.1.2 e-transport<br />

Se <strong>Skatteverket</strong>s hemsida för information<br />

www.skatteverket.se E-tjänster, E-transport<br />

Adressering för infiler i SHS:et:<br />

Till-adress: 2021005448.NAVET<br />

Produktidentitet: <strong>Skatteverket</strong>.Folkbokföring eller<br />

f6178dea-9b7b-feb6-4f14-5b1b7dc969c8<br />

(Filer som lämnas via webb-gränssnittet ska ha tilladress<br />

2021005448.)<br />

Adressering för utfiler i SHS:et:<br />

Från-adress: 2021005448.Navet<br />

Produktidentitet: <strong>Skatteverket</strong>.Folkbokföring


*<strong>Skatteverket</strong> 9 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

Till-adress: 2121005448.web<br />

Slutmottagare: orgno:Kundens organisationsnummer<br />

(orgno: + 12 tecken)<br />

Metainformation:<br />

BestId=0000XXXX-FOXX-00XX<br />

Filnamn=Navet_<br />

Kundnr=0000XXXX<br />

Underkundnr=0000XXXX<br />

Se Steria för mer information om certifikat<br />

http://eid.steria.se<br />

1.1.3 SHS<br />

Se <strong>Skatteverket</strong>s hemsida för information<br />

www.skatteverket.se E-tjänster, E-transport<br />

Se Statskontorets hemsida för information<br />

http://www.statskontoret.se<br />

Adressering för infiler i SHS:et:<br />

Till-adress: 2021005448.NAVET<br />

Produktidentitet: <strong>Skatteverket</strong>.Folkbokföring eller<br />

f6178dea-9b7b-feb6-4f14-5b1b7dc969c8<br />

Adressering för utfiler i SHS:et:<br />

Från-adress: 2021005448.Navet<br />

Produktidentitet: <strong>Skatteverket</strong>.Folkbokföring<br />

Till-adress: SHS-aktörens organisationsnummer (10<br />

tecken). Här kan man också få en sub-adress om man<br />

så önskar, efter organisationsnumret kan ’.NAMN’<br />

läggas till.<br />

Slutmottagare: orgno:Kundens organisationsnummer<br />

(orgno: + 12 tecken) visas för distributörer.<br />

Metainformation:


*<strong>Skatteverket</strong> 10 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

BestId=0000XXXX-FOXX-00XX<br />

Filnamn=Navet_<br />

Kundnr=0000XXXX<br />

Underkundnr=0000XXXX<br />

Se Steria för mer information om certifikat<br />

http://eid.steria.se<br />

1.2 Magnetmedia<br />

För information om diskett-, CD- och bandformat för<br />

infiler hänvisas till broschyren Mediefakta kapitel<br />

2 och 3.<br />

För information om format för utfiler hänvisas till<br />

broschyren Mediefakta kapitel 4.2.<br />

För att hitta Mediefakta, gå till<br />

www.skatteverket.se. Välj ”Broschyrer” i kolumnen<br />

till vänster. Under ”M-O” hittar du Mediefakta (SKVnummer<br />

274).<br />

Det är viktigt att data på olika media kan<br />

identifieras när det gäller produkt och<br />

medielämnare. Därför skall varje inlämnat/utskickat<br />

media innehålla en etikettfil. För avisering skall<br />

denna fil ha namnet INFO.NAV (se avsnitt 3.3.1).<br />

Teckenprov måste alltid lämnas. Teckenprovet,<br />

ÅÄÖÜåäöüÉé#_@, beskriver hur ingivaren representerar<br />

dessa tecken i datafilen.<br />

Ex. Om man inte kan representera Ü utan att ? i<br />

datafilen betyder Ü så ser teckenprovet ut så här<br />

"ÅÄÖ?åäöüÉé#_@". Om man inte kan representera ett<br />

specifikt tecken så måste (White Space, dvs<br />

blanktecken) läggas in på det berörda stället i<br />

teckenprov för att bibehålla rätt ordning.


*<strong>Skatteverket</strong> 11 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

1.3 Utskrifter<br />

Utskrifter finns endast på vitt A4-format samt<br />

etiketter. Kunden kan välja att få utskrivet en<br />

person per sida eller flera personer per sida.<br />

Utskrifterna innehåller endast de termer som<br />

beställts.<br />

Etiketter tillhandahålls med standardinnehållet namn<br />

och adress. Man kan även välja att få texten ’Till<br />

målsman för’ om personen är under 18 år.


*<strong>Skatteverket</strong> 12 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

2 Utdataformat<br />

Folkbokföringsuppgifter från Navet kan erhållas i<br />

två olika format. Ett taggat format med<br />

termkod/termdata (där varje rad inleds med #,<br />

kapitel 5) eller XML-format (kapitel 7).<br />

Det taggade formatet är tillgängligt för samtliga<br />

typer av överföringar av folkbokföringsuppgifter<br />

från Navet. XML-formatet kan enbart utnyttjas av<br />

användare av onlinetjänsten ePersondata samt av de<br />

kunder som får aviseringsfiler via SHS och e-<br />

Transport, ej vid utskrifter på papper och<br />

magnetmedia.<br />

3 Datafiler med format termkod/termdata<br />

3.1 Teckenrepresentation<br />

Enligt ISO 8859-1, undantaget IBM-lablade magnetband<br />

och kassetter där EBCDIC skall användas.<br />

3.2 Postmarkering<br />

Se <strong>beskrivning</strong> för respektive mediatyp i Mediefakta<br />

2000, RSV 274 utgåva 7, kapitel 5 Svarsmedier vid<br />

förfrågningar. I fortsättningen skrivs endast .<br />

3.3 Filposter<br />

Filerna består av ett antal poster där postnamnet<br />

inleds med tecknet #. Efter postnamnet kommer de<br />

värden som skall redovisas i posten åtskilda av ett<br />

(White Space, dvs blanktecken eller TABtecken).<br />

Av fältnamnstabellen framgår vilka värden<br />

som är tillåtna för respektive uppgift.<br />

3.3.1 Konventioner för filnamn m.m. för olika<br />

medietyper<br />

Etikettfilen INFO.NAV innehåller uppgifter om medieframställare,<br />

samt referenser till datafiler. På<br />

medietypen CD-ROM är detta en fil med namn INFO.NAV.<br />

På denna medietyp skall den alltid lämnas in som en<br />

enskild fil tillsammans med datafilen.


*<strong>Skatteverket</strong> 13 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

Namn och adressuppgifter för medieframställaren<br />

används för återrapporteringar då felaktiga<br />

media/filer mottagits, varför det är av stor<br />

betydelse att de är korrekta.<br />

Referenser till datafiler används för att<br />

identifiera vilka filer som skall användas i det<br />

fallet ytterligare filer finns på mediet.<br />

Om filen saknas eller om obligatoriska uppgifter<br />

saknas kommer mediet i sin helhet att avvisas.<br />

Filen INFO.NAV används inte vid aviseringsfiler som<br />

hämtas via SHS/e-transport. I filer från<br />

SHS/e-transport ligger metadata sist i filen, se<br />

avsnitt 3.3.2.1.<br />

Om infil ligger till grund för avsieringen kan även<br />

en .med-fil levereras med. Den visar vilka<br />

personnummer man inte fått träff på enligt nedan:<br />

Följande personnummer kunde ej sökas fram i<br />

aviseringsregistret pga. de saknades eller<br />

att de inte matchade beställningens villkor:<br />

Följande poster kan förekomma i INFO.NAV:<br />

Post Innehåll<br />

#MEDIELEV_START Markerar att information om/från medielämnare<br />

startar<br />

#TECKENPROV Prov på svenska tecken i använd<br />

teckenuppsättning.<br />

#ORGNR Medielämnarens person/organisationsnummer<br />

#NAMN Medielämnarens namn<br />

#ADRESS Medielämnarens utdelningsadress<br />

#POSTNR Medielämnarens postnummer<br />

#POSTORT Medielämnarens postort<br />

#KONTAKT Kontaktperson<br />

#AVDELNING Kontaktpersons avdelning<br />

#EMAIL Kontaktpersons e-mail adress<br />

#TELEFON Kontaktpersons telefonnummer<br />

#FAX Kontaktpersons faxnummer


*<strong>Skatteverket</strong> 14 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

#PROGRAM Används för att ange namn och version på<br />

det program som skapat mediet<br />

#MEDIELEV_SLUT Markerar att information om/från medielämnare slutar<br />

#DATABESKRIVNING_START Markerar start på information om<br />

datareferenser<br />

#PRODUKT Den produkt som informationen på mediet<br />

tillhör; skall vara<br />

#MEDIAID Medielämnarens identitet på mediet<br />

#SKAPAD Datum och tid då mediet<br />

skapades<br />

#FILTITEL Titel/Rubrik-information för den fil där<br />

aviseringsuppgifter finns.<br />

#EXREF Extern referens, ett löpnummer på fil med<br />

filnamn.<br />

#FILNAMN Namn på den fil där aviseringsuppgifter<br />

finns.Valfritt namn enligt respektive systems<br />

namnregler<br />

#DATABESKRIVNING_SLUT Markerar slut på information om<br />

datareferenser<br />

Posterna i INFO.NAV måste förekomma i följande<br />

ordning:<br />

#MEDIELEV_START<br />

#TECKENPROV (obligatoriskt)<br />

#ORGNR<br />

#NAMN<br />

#ADRESS<br />

#POSTNR<br />

#POSTORT<br />

#KONTAKT (ej obligatoriskt)<br />

#AVDELNING (ej obligatoriskt)<br />

#EMAIL (ej obligatoriskt)<br />

#TELEFON (ej obligatoriskt)<br />

#FAX (ej obligatoriskt)<br />

#PROGRAM (ej obligatoriskt)<br />

#MEDIELEV_SLUT<br />

#DATABESKRIVNING_START<br />

#PRODUKT<br />

#MEDIAID (ej obligatoriskt)<br />

#SKAPAD (ej obligatoriskt)<br />

#FILTITEL (en eller flera förekomster, ej<br />

obligatorisk)


*<strong>Skatteverket</strong> 15 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

#EXREF (ej obligatorisk)<br />

#FILNAMN (en eller flera förekomster)<br />

#DATABESKRIVNING_SLUT<br />

3.3.2 Datafil-avisering<br />

Denna fil kan ha två olika innehåll:<br />

- Utfil, dvs aviseringsfil till mottagare<br />

innehållande en eller flera poster med<br />

personuppgifter. Samma utfilsformat gäller för<br />

samtliga beställningstyper.<br />

- Infil från mottagare innehållande en eller<br />

flera personnummer. Används vid utsökning för<br />

att fastställa vilka personposter som är<br />

aktuella för att avisera i aviseringsfilen till<br />

mottagaren.


*<strong>Skatteverket</strong> 16 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

Postdefinitioner<br />

Post Innehåll<br />

#INFO_START Markerar att informationsdel om filen startar.<br />

#FILTYP Anger om det är en infil till <strong>Skatteverket</strong><br />

eller utfil från <strong>Skatteverket</strong>.<br />

#BESTÄLLNINGSID Anger vilken beställning filen avser.<br />

Består av avtalsnummer samt ett löpnummer för<br />

beställningen.<br />

#BESTÄLLNINGSTYP Anger vilken typ av beställning filen<br />

avser.<br />

#NAMN_INFIL Anger namn på mottagarens infil som ska<br />

användas vid utsökning av personposter. Endast<br />

aktuell i infil från mottagare.<br />

#GILTIG_TOM Anger t.o.m-datum för en kunds infil.Dvs<br />

hur länge en infil är giltig att användas vid<br />

utsökning av kundens aviseringsfil. Endast aktuell<br />

vid infil från mottagare. Ej obligatorisk. Om den<br />

saknas gäller infilen tills vidare.<br />

#EFFEKTUERAD Anger vilket datum filen har skapats.<br />

Endast aktuell vid avisering till mottagare (utfil).<br />

#DATUM_ANDRING Anger det datum eller datumintervall<br />

som personposterna i aviseringsfilen har<br />

registrerats (förändrats) i de lokala<br />

folkbokföringsregistren. Endast aktuell vid<br />

regelbunden avisering till mottagare (utfil).<br />

#INFIL_TILL_GRUND Anger namnet på den eventuella<br />

infil (#NAMN_INFIL) som legat till grund för<br />

utsökning. Endast aktuell vid avisering till<br />

mottagare (utfil).<br />

#INFO_SLUT Markerar att informationsdel om filen slutar.<br />

#DATA_START Markerar att datadelen startar.<br />

#DAG_START Markerar att ny dag startar startar. Endast aktuell<br />

om brytpost valts.<br />

#PNR Personnummer på person som ingår i infilen.<br />

Anges i formatet ÅÅÅÅMMDDNNNK. Endast aktuell vid<br />

infil från mottagare innehållande en eller många<br />

personnummer.<br />

#POST_START Markerar att en post med uppgifter på en person<br />

startar. Aktuell vid personnummersättning (infil)<br />

och avisering till mottagare(utfil).<br />

#POST_ID Unikt löpnummer på posten


*<strong>Skatteverket</strong> 17 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

#UP Den termkod som finns angiven i<br />

fältnamnstabellen. Termkoden kan förekomma en eller<br />

många gånger per personpost beroende på<br />

termkodsvärdet.<br />

Det värde som aktuell termkod<br />

(term)innehåller.Kan saknas för vissa termkoder.<br />

#POST_SLUT Markerar att en post med uppgifter på en person<br />

slutar.Aktuell vid personnummer-sättning (infil) och<br />

avisering till mottagare(utfil).<br />

#DAG_SLUT Markerar att ny dag startar slutar. Endast aktuell<br />

om brytpost valts.<br />

#DATA_SLUT Markerar att datadelen slutar.<br />

#AVST_START Markerar att avstämningsdelen startar.<br />

#ANTAL_POSTER Anger hur många att personposter filen<br />

innehöll.<br />

#AVST_SLUT Markerar att avstämningsdelen avslutar.<br />

#FIL_SLUT Markerar att filen är slut.


*<strong>Skatteverket</strong> 18 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

Posterna i en fil i format termkod/termdata måste förekomma i<br />

följande ordning. (Ordningen för posterna Utfil i XML-format<br />

definieras av schemat Navetavisering.xsd, kapitel 6.3) :<br />

Infil - Personnummer Utfil - avisering<br />

#INFO_START #INFO_START<br />

#FILTYP #FILTYP<br />

#BESTÄLLNINGSID #BESTÄLLNINGSID<br />

#BESTÄLLNINGSTYP #BESTÄLLNINGSTYP<br />

#NAMN_INFIL #EFFEKTUERAD<br />

#GILTIG_TOM (ej<br />

obligatorisk)<br />

#DATUM_ANDRING (endast<br />

aktuell vid<br />

regelb.avisering)<br />

#INFO_SLUT #INFIL_TILL_GRUND<br />

(ej obligatorisk)<br />

#DATA_START #INFO_SLUT<br />

#PNR #DATA_START<br />

#DATA_SLUT #DAG_START<br />

(ej obligatorisk)<br />

#AVST_START #POST_START<br />

#ANTAL_POSTER #POST_ID<br />

#AVST_SLUT #UP<br />

#FIL_SLUT #POST_SLUT<br />

#DAG_SLUT<br />

(ej obligatorisk)<br />

#DATA_SLUT<br />

#AVST_START<br />

#ANTAL_POSTER<br />

#AVST_SLUT<br />

#FIL_SLUT


*<strong>Skatteverket</strong> 19 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

3.3.2.1 Metadatadel i fil via SHS/e-transport<br />

Filen inleds med en SHS-MIMEPART med information om<br />

överföringen och original-filnamn. Därefter kommer<br />

innehåll enligt kap 4.3.<br />

Efter datadelen kommer en kortare SHS-MIMEPART-del<br />

som bland annat beskriver original-filnamn. Därefter<br />

kommer följande metadata.<br />

Post Innehåll<br />

#DATABESKRIVNING_START Markerar start på information om<br />

datareferenser<br />

#PRODUKT Den produkt som informationen på mediet<br />

tillhör; skall vara Navet<br />

#JOBBID Den identitet som jobbet har i Navet<br />

#EFFEKTUERINGSDATUM Anger vilket datum filen har<br />

skapats.<br />

#BESTÄLLNINGSID Anger vilken beställning filen avser.<br />

Består av avtalsnummer samt ett löpnummer för<br />

beställningen.<br />

#FILNAMN Namn på den fil där aviseringsuppgifter<br />

finns.Valfritt namn enligt respektive systems<br />

namnregler<br />

#LOPNR Extern referens, ett löpnummer på fil med<br />

filnamn.<br />

#FILTITEL Titel/Rubrik-information för den fil där<br />

aviseringsuppgifter finns.<br />

#FILSTORLEK Filens storlek.<br />

#DATABESKRIVNING_SLUT Markerar slut på information om<br />

datareferenser<br />

#MEDIEMOTTAGARE_START Markerar att information om mediemottagare<br />

startar<br />

#ORGNR Mediemottagarens organisationsnummer<br />

#KUNDNR Mediemottagarens kundnummer i Navet<br />

#SLUTKUNDNR Om kunden är en distributör anges<br />

slutkundens kundnummer.<br />

#NAMN Medielämnarens namn<br />

#AVDELNING Kontaktpersons avdelning<br />

#KONTAKT Kontaktperson<br />

#MEDIEMOTTAGARE_SLUT Markerar att information om/från<br />

medielämnare slutar


*<strong>Skatteverket</strong> 20 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

3.3.2.2 Lämning av filer via SHS/e-transport<br />

Filer lämnas i samma format som övriga infiler.<br />

Ingen INFO.NAV behövs.<br />

4 Filstrukturer med termkod/termdata<br />

4.1 Specifikation av INFO.NAV - etikettfil<br />

Beskrivning av INFO.NAV m.h.a. BNF-notation. Denna<br />

fil används inte vid leverans av filer via<br />

SHS/e-transport.<br />

::= <br />

::= #MEDIELEV_START <br />

#MEDIELEV_SLUT <br />

::= [] []<br />

[Avdelning>] <br />

[][] [] []<br />

::= #TECKENPROV<br />

; Värde enligt avsnitt 9.3<br />

::= #ORGNR <br />

; Värde enligt avsnitt 9.3<br />

::= #NAMN <br />

; Värde enligt avsnitt 9.3<br />

::= #ADRESS <br />

; Värde enligt avsnitt 9.3<br />

::= #POSTNR <br />

; Värde enligt avsnitt 9.3<br />

::= #POSTORT <br />

; Värde enligt avsnitt 9.3<br />

::= #KONTAKT <br />

; Värde enligt avsnitt 9.3<br />

::= #AVDELNING <br />

; Värde enligt avsnitt 9.3<br />

::= #EMAIL <br />

; Värde enligt avsnitt 9.3<br />

::= #TELEFON <br />

; Värde enligt avsnitt 9.3<br />

::= #FAX <br />

; Värde enligt avsnitt 9.3


*<strong>Skatteverket</strong> 21 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

::= #PROGRAM <br />

; Värde enligt avsnitt 9.3<br />

; Kan användas för att ange namn och version för<br />

det program som skapat<br />

; mediet<br />

::= #DATABESKRIVNING_START <br />

[] <br />

#DATABESKRIVNING_SLUT <br />

::= [] [] []<br />

::= #PRODUKT <br />

; Värde enligt avsnitt 9.3<br />

::= #MEDIAID <br />

; Värde enligt avsnitt 9.3<br />

; Medielämnarens identitet på mediet<br />

::= #SKAPAD <br />

<br />

; Värde enligt avsnitt 9.3<br />

; Datum och tid då mediet skapades<br />

::= [] <br />

::= #FILTITEL <br />

; Värde enligt avsnitt 9.3<br />

; Information om vad som infilen/<br />

; aviseringsfilen innehåller<br />

::= #EXREF <br />

Värde enligt avsnitt 9.3<br />

::= #FILNAMN <br />

; Värde enligt avsnitt 9.3<br />

; Valfritt namn enligt respektive<br />

;operativsystems namnregler


*<strong>Skatteverket</strong> 22 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

4.2 Specifikation av avisering via SHS/etransport<br />

- Metadatadel<br />

Specifikation av filstruktur m h a BNF-notation.<br />

Denna del ligger sist i aviseringsfilerna.<br />

::= <br />

::= #DATABESKRIVNING_START <br />

[] <br />

#DATABESKRIVNING_SLUT <br />

::= <br />

::= #PRODUKT <br />

; Värde enligt avsnitt 8.4<br />

::= #JOBBID <br />

::= #EFFEKTUERINGSDATUM <br />

;EffDatum enligt kolumnen<br />

“fältnamn/ ;termkod” avsnitt 8.4.<br />

::= #BESTÄLLNINGSID <br />

;BestId enligt kolumnen<br />

;“fältnamn/termkod”, avsnitt 8.4.<br />

::= [] <br />

::= #FILNAMN <br />

; Värde enligt avsnitt 8.4<br />

; Valfritt namn enligt respektive<br />

;operativsystems namnregler<br />

::= #LOPNR <br />

Värde enligt avsnitt 8.4<br />

::= #FILTITEL <br />

; Värde enligt avsnitt 8.4<br />

; Information om vad<br />

; aviseringsfilen innehåller<br />

::= #FILSTORLEK <br />

; Värde enligt avsnitt 8.4<br />

::= #MEDIELEV_START <br />

#MEDIELEV_SLUT <br />

::= [] <br />

[][]<br />

::= #ORGNR <br />

; Värde enligt avsnitt 8.4<br />

::= #KUNDNR


*<strong>Skatteverket</strong> 23 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

;Värde enligt avsnitt 8.4<br />

::= #SLUTKUNDNR <br />

;Värde enligt avsnitt 8.4<br />

::= #NAMN <br />

; Värde enligt avsnitt 8.4<br />

::= #AVDELNING <br />

; Värde enligt avsnitt 8.4<br />

::= #KONTAKT <br />

; Värde enligt avsnitt 8.4


*<strong>Skatteverket</strong> <strong>24</strong> (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

4.3 Specifikation av datafil - avisering<br />

Specifikation av filstruktur m h a BNF-notation.<br />

DataFil ::= <br />

<br />

::= #INFO_START <br />

#INFO_SLUT <br />

::= <br />

<br />

| <br />

::= #FILTYP <br />

;FilTyp enligt kolumnen<br />

;”fältnamn/termkod”, avsnitt 8.5.<br />

::= #BESTÄLLNINGSID <br />

;BestId enligt kolumnen<br />

;“fältnamn/termkod”, avsnitt 8.5.<br />

::= #BESTÄLLNINGSTYP <br />

;BestTyp enligt kolumnen<br />

“fältnamn/ ;termkod”, avsnitt 8.5.<br />

::= []<br />

::= #NAMN_INFIL <br />

;NamnInFil enligt kolumnen<br />

;”fältnamn/termkod”, avsnitt 8.5.<br />

::= #GILTIG_TOM <br />

;TomDatum enligt kolumnen<br />

;”fältnamn/termkod”, avsnitt 8.5.<br />

::= []<br />

[]<br />

::= #EFFEKTUERAD <br />

;EffDatum enligt kolumnen<br />

“fältnamn/ ;termkod” avsnitt 8.5.<br />

::= #DATUM_ANDRING <br />

<br />

;FromTomDatum enligt kolumnen<br />

;fältnamn/termkod”, avsnitt 8.5<br />

::= #INFIL_TILL_GRUND <br />


*<strong>Skatteverket</strong> 25 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

::= #DATA_START<br />

|<br />

|<br />

#DATA_SLUT<br />

::= #DAG_START ÅÅÅÅMMDD<br />

::= #DAG_SLUT<br />

::= <br />

<br />

::= *<br />

::= #PNR <br />

::= *<br />

::= #POST_START *<br />

#POST_SLUT <br />

::= *<br />

::= #UP []<br />

[] <br />

;TermKod och TermVärde enligt<br />

;kolumn “fältnamn/termkod”,<br />

;avsnitt 8.5 och bilaga 1. För<br />

;termkoder, som visar att en/ett<br />

;relation/medborgarskap eller<br />

;historisk folkbokföringsadress<br />

;startar resp slutar, saknas<br />

;, se bilaga 1.<br />

::= #AVST_START <br />

#AVST_SLUT 2<br />

::= #ANTAL_POSTER <br />

<br />

;AntalPoster enligt kolumn<br />

;”fältnamn/termkod”, avsnitt 8.5<br />

::= #FIL_SLUT


*<strong>Skatteverket</strong> 26 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

5 Exempel på filer med termkod/termdata<br />

5.1 Filexempel - Utfiler<br />

Exempel på INFO.NAV-fil (Magnetmedia) med<br />

löpnumrering av filer:<br />

#MEDIELEV_START<br />

#TECKENPROV ÅÄÖÜåäöüÉé#_@<br />

#ORGNR 161212121212<br />

#NAMN ABC-BOLAGET<br />

#KONTAKT Kalle Persson<br />

#ADRESS Storgatan 17<br />

#POSTNR 58<strong>24</strong>8<br />

#POSTORT Loholm<br />

#EMAIL kalle@abc.se<br />

#MEDIELEV_SLUT<br />

#DATABESKRIVNING_START<br />

#PRODUKT NAVET<br />

#MEDIAID Qdjbh920Mu<br />

#SKAPAD 19990415 213413<br />

#FILTITEL Urval av 6-åringar i XXXX kommun<br />

#EXREF 00234<br />

#FILNAMN datafil.txt<br />

#DATABESKRIVNING_SLUT<br />

Exempel på INFO.NAV-fil (Magnetmedia) utan<br />

löpnumrering av filer:<br />

#MEDIELEV_START<br />

#TECKENPROV ÅÄÖÜåäöüÉé#_@<br />

#ORGNR 161212121212<br />

#NAMN ABC-BOLAGET<br />

#KONTAKT Kalle Persson<br />

#ADRESS Storgatan 17<br />

#POSTNR 58<strong>24</strong>8<br />

#POSTORT Loholm<br />

#EMAIL kalle@abc.se<br />

#MEDIELEV_SLUT<br />

#DATABESKRIVNING_START<br />

#PRODUKT NAVET<br />

#MEDIAID Qdjbh920Mu<br />

#SKAPAD 19990415 213413<br />

#FILTITEL Urval av 6-åringar i XXXX kommun<br />

#FILNAMN datafil.txt<br />

#DATABESKRIVNING_SLUT


*<strong>Skatteverket</strong> 27 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

Exempel på aviseringsfil utan brytposter:<br />

#INFO_START<br />

#FILTYP UTDATAFIL<br />

#BESTÄLLNINGSID 00000011-FO02-0003<br />

#BESTÄLLNINGSTYP ÄNDRADE_TERMER<br />

#EFFEKTUERAD 19970201<br />

#DATUM_ANDRING 19970130-19970131<br />

#INFO_SLUT<br />

#DATA_START<br />

#POST_START<br />

#POST_ID 2006.000.000.057<br />

#UP 01001 198612182389<br />

#UP 01014 SVENSSON<br />

#UP 02000<br />

#UP 02001 197011299281<br />

#UP 02003 FA<br />

#UP 02008 NY<br />

#UP 02999<br />

#UP 02000<br />

#UP 02002 197011010000<br />

#UP 02003 MO<br />

#UP 02005 JUDITH<br />

#UP 020<strong>07</strong> ANDERSEN<br />

#UP 02008 NY<br />

#UP 02999<br />

#POST_SLUT<br />

#POST_START<br />

#POST_ID 2006.000.000.058<br />

#UP 01001 195505252389<br />

#UP 01014 ERIKSSON<br />

#POST_SLUT<br />

#DATA_SLUT<br />

#AVST_START<br />

#ANTAL_POSTER 00000002<br />

#AVST_SLUT<br />

#FIL_SLUT<br />

Exempel på aviseringsfil med brytposter:<br />

#INFO_START<br />

#FILTYP UTDATAFIL<br />

#BESTÄLLNINGSID 00000039-FO01-0008<br />

#BESTÄLLNINGSTYP TOTALPOST<br />

#EFFEKTUERAD 20000531<br />

#DATUM_ÄNDRING 20000525-20000531<br />

#INFO_SLUT<br />

#DATA_START


*<strong>Skatteverket</strong> 28 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

#DAG_START 20000525<br />

#POST_START<br />

#POST_ID 2006.000.000.059<br />

#UP 01001 194512267743<br />

#UP 01004 40H<br />

#UP 01012 Bettan<br />

#UP 01014 Andersson<br />

#UP 01021 20000215<br />

#UP 01022 01<br />

#UP 01023 80<br />

#UP 010<strong>24</strong> 11<br />

#UP 01025 AXET 3:3<br />

#UP 01033 BACKGATAN 2<br />

#UP 01034 98131<br />

#UP 01035 KIRUNA<br />

#UP 01091 02<br />

#UP 01092 BOO<br />

#UP 01101 20000215<br />

#UP 03000<br />

#UP 03001 SE<br />

#UP 03002 19451226<br />

#UP 03999<br />

#UP 04000<br />

#UP 04001 20000215<br />

#UP 04002 01<br />

#UP 04003 80<br />

#UP 04004 11<br />

#UP 04005 AXET 3:3<br />

#UP 04008 FB<br />

#UP 04999<br />

#POST_SLUT<br />

#DAG_SLUT<br />

#DAG_START 20000526<br />

#POST_START<br />

#POST_ID 2006.000.000.080<br />

#UP 01001 198405312391<br />

#UP 01004 999<br />

#UP 01012 Gregory John<br />

#UP 01014 O Sullivan<br />

#UP 01021 00000000<br />

#UP 01022 01<br />

#UP 01023 80<br />

#UP 010<strong>24</strong> 01<br />

#UP 01025 KLÖVERN 11<br />

#UP 01028 0<br />

#UP 01033 KARL XII:S TORG 2


*<strong>Skatteverket</strong> 29 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

#UP 01034 11147<br />

#UP 01035 STOCKHOLM<br />

#UP 01081 OG<br />

#UP 01091 01<br />

#UP 01092 DOMKYRKO<br />

#UP 02000<br />

#UP 02002 196912150000<br />

#UP 02003 FA<br />

#UP 02010 AV<br />

#UP 02011 19990101<br />

#UP 02999<br />

#UP 02000<br />

#UP 02002 196811010000<br />

#UP 02003 MO<br />

#UP 02999<br />

#UP 03000<br />

#UP 03001 SE<br />

#UP 03002 00000000<br />

#UP 03999<br />

#UP 04000<br />

#UP 04001 00000000<br />

#UP 04002 01<br />

#UP 04003 80<br />

#UP 04004 01<br />

#UP 04005 KLÖVERN 11<br />

#UP 04008 FB<br />

#UP 04999<br />

#POST_SLUT<br />

#DAG_SLUT<br />

#DAG_START 20000529<br />

osv<br />

.<br />

.<br />

#DAG_SLUT<br />

#DATA_SLUT<br />

#AVST_START<br />

#ANTAL_POSTER 00000002<br />

#AVST_SLUT<br />

#FIL_SLUT<br />

Filexempel för en hel fil (levererad via<br />

SHS/etransport) Regelbunden ändringspost<br />

MIME-Version: 1.0<br />

Content-Type: multipart/mixed; boundary="----SHS-<br />

MIMEPART-1089646030-"


*<strong>Skatteverket</strong> 30 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

Subject: SHS document<br />

------SHS-MIMEPART-1089646030-<br />

Content-Type: text/xml; charset=iso-8859-1<br />

Content-Transfer-Encoding: binary<br />

<br />

<br />

<br />

urn:X-shs:2021005448.navet<br />

urn:X-shs:2021005448<br />

urn:X-shs:orgno: 162626262626<br />

<br />

urn:X-shs:d089d9b1-c82d-faf9-3c6c-<br />

0bdc9b851501 <br />

2004-06-02T<strong>07</strong>:31:36<br />

<br />

<br />

<br />

<br />

<br />

------SHS-MIMEPART-1089646030-<br />

Content-Type: application/octet-stream;<br />

name="navet_1000013.0"<br />

Content-Transfer-Encoding: binary<br />

Content-Disposition: attachment;<br />

filename=navet_1000013.0<br />

#INFO_START<br />

#FILTYP UTDATAFIL<br />

#BESTÄLLNINGSID 00000261-FO01-0005<br />

#BESTÄLLNINGSTYP ÄNDRADE_TERMER<br />

#EFFEKTUERAD 20040602<br />

#DATUM_ANDRING 20040529<br />

#INFO_SLUT<br />

#DATA_START<br />

#POST_START<br />

#POST_ID 2006.000.000.060


*<strong>Skatteverket</strong> 31 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

#UP 01001 195206142597<br />

#UP 01004 46H<br />

#UP 01006 OB<br />

#UP 010<strong>07</strong> 20040101<br />

#UP 01101 -1<br />

#POST_SLUT<br />

#POST_START<br />

#POST_ID 2006.000.000.<strong>07</strong>1<br />

#UP 01001 196608253081<br />

#UP 01004 36H<br />

#UP 03000<br />

#UP 03001 XS<br />

#UP 03002 20040101<br />

#UP 03003 NY<br />

#UP 03999<br />

#UP 03000<br />

#UP 03001 SE<br />

#UP 03002 19660825<br />

#UP 03003 AS<br />

#UP 03999<br />

#POST_SLUT<br />

#POST_START<br />

#POST_ID 2006.000.000.<strong>07</strong>3<br />

#UP 01001 196709192642<br />

#UP 01004 64H<br />

#UP 01081 SP<br />

#UP 01082 20040101<br />

#UP 02000<br />

#UP 02001 196608253081<br />

#UP 02003 P<br />

#UP 02008 AS<br />

#UP 02999<br />

#POST_SLUT<br />

#DATA_SLUT<br />

#AVST_START<br />

#ANTAL_POSTER 00000003<br />

#AVST_SLUT<br />

#FIL_SLUT<br />

------SHS-MIMEPART-1089646030-<br />

Content-Type: application/octet-stream;<br />

name="navet_1000013.inf"<br />

Content-Transfer-Encoding: binary<br />

Content-Disposition: attachment;<br />

filename=navet_1000013.inf


*<strong>Skatteverket</strong> 32 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

#DATABESKRIVNING_START<br />

#PRODUKT NAVET<br />

#JOBBID 00009210<br />

#EFFEKTUERINGSDATUM 20040602<br />

#BESTÄLLNINGSID 00000261-FO01-0005<br />

#FILNAMN navet_1000013.0<br />

#LOPNR 00004<br />

#FILTITEL Regelbunden ändring, daglig X kommun<br />

#FILSTORLEK 1012<br />

#DATABESKRIVNING_SLUT<br />

#MEDIEMOTTAGARE_START<br />

#ORGNR 162626262626<br />

#KUNDNR 00000261<br />

#NAMN Testkund för SHS-nod och e-transport<br />

#AVDELNING Grunddataenheten<br />

#KONTAKT Carmen Diaz<br />

#MEDIEMOTTAGARE_SLUT<br />

------SHS-MIMEPART-1089646030---<br />

5.2 Filexempel – Infiler levererade via SHS/etransport<br />

#INFO_START<br />

#FILTYP INDATAFIL<br />

#BESTÄLLNINGSID 00000306-FO01-00<strong>07</strong><br />

#BESTÄLLNINGSTYP URVAL<br />

#NAMN_INFIL Infil.txt (*)<br />

#KOR_STARTTID YYYYMMDDHHMI (**)<br />

#INFO_SLUT<br />

#DATA_START<br />

#PNR 194506218983<br />

#PNR 194501128278<br />

#PNR 194501202388<br />

#PNR 194502<strong>07</strong>3416<br />

#PNR 194502198429<br />

#PNR 194502202395<br />

#PNR 194502278353<br />

#PNR 194503135883<br />

#PNR 19530911<strong>24</strong>89<br />

#PNR 19530911<strong>24</strong>89<br />

#DATA_SLUT<br />

#AVST_START<br />

#ANTAL_POSTER 00000010<br />

#AVST_SLUT


*<strong>Skatteverket</strong> 33 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

#FIL_SLUT<br />

* Denna tagg används för att leverera tillbaka<br />

filnamnet i utfilen, (NAMN_INFIL_TILL_GRUND). Om<br />

NAMN_INFIL inte anges här så sätts<br />

NAMN_INFIL_TILL_GRUND till filens fysiska namn.<br />

Denna är inte obligatorisk för SHS/e-transport men<br />

för övriga mediaformat måste den anges.<br />

** För beställningstyp = ’SD’ ”svar direkt” kan man<br />

i förväg ange vilket datum och vilken tid körningen<br />

ska vara utförd.<br />

Denna är inte obligatorisk för SHS/e-transport. För<br />

övriga mediaformat får den ej anges.<br />

5.3 Infiler – vanliga fel<br />

Om infilen som skickas in innehåller fel skickar vi<br />

i de flesta fall tillbaka infilen till SHSet<br />

tillsammans med en annan fil som heter .med. I .medfilen<br />

finns ett kort meddelande om vad som är fel. I<br />

de fall som vi inte skickar tillbaka infilen samt<br />

.med-fil beror felet på att infilen är helt tom,<br />

beställningsid saknas eller har fel format. I dessa<br />

fall meddelas kunden via mail eller telefon.<br />

För beställningar med andra mediaformat än SHS/etransport<br />

meddelas kunden endast via mail eller<br />

telefon oavsett vad felet är.<br />

Exempel på vanliga fel:<br />

• Beställningsid har fel format.<br />

• Beställningstypen är felaktig. Tex URVAL när<br />

det egentligen ska vara TOTALPOST.<br />

• Det är fel teckenuppsättning. Det här gör att<br />

infilen som vi får in blir fel. Tex:<br />

#BESTÄLLNINGSTYP URVAL<br />

• # saknas framför varje rad eller PNR saknas


*<strong>Skatteverket</strong> 34 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

framför personnumret.<br />

• Personnummer har angivits utan sekelsiffra.<br />

• Antalet personnummer i infilen stämmer inte med<br />

det som står i taggen #ANTAL_POSTER.<br />

• #TOM_DATUM har passerats, ska vara ett datum<br />

framåt i tiden.<br />

• Någon av de obligatoriska taggarna som anges i<br />

kap 3.3.2 saknas eller är felstavade.


*<strong>Skatteverket</strong> 35 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

6 Datafiler med XML-format<br />

6.1 Teckenrepresentation<br />

Enligt ISO 8859-1.<br />

6.2 Struktur på XML-formatet<br />

Den valda strukturen i Navets XML-format är<br />

beskriven i bilaga 7 XML-struktur.<br />

6.3 Validering mot XML-schema<br />

Innehållet i filer med XML-format validerar mot ett<br />

XML-schema som är publicerat här:<br />

http://xmls.skatteverket.se/se/skatteverket/folkbokf<br />

oring/na/avisering/V1/Navetavisering.xsd<br />

6.4 Filstorlek vid avisering<br />

En aviseringsfil med folkbokföringsuppgifter i XMLformat<br />

kan innehålla maximalt 500 000 poster på<br />

grund av av tekniska skäl. När en beställning<br />

genererar fler än 500 000 poster med<br />

folkbokföringsuppgifter kommer resultatet delas upp<br />

i fler svarsfiler där en fil skapas för var<br />

500 000:e svarspost. Exempelvis kommer ett svar om<br />

1 200 000 folkbokföringsposter att generera tre<br />

filer. Dessa filer namnges enligt<br />

navet__1.xml, navet___2.xml<br />

och navet__3.xml.<br />

är ett sjuställigt tal (0000001-9999999)<br />

som representerar en intern sekvens. Löpnumret<br />

skapas vid framställning av filen/filerna som ingår<br />

aviseringen.<br />

6.5 Konventioner för filnamn<br />

Följande konvention används för filnamn vid<br />

avisering av filer i XML-format.


*<strong>Skatteverket</strong> 36 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

6.5.1 Filer med folkbokföringsinformation<br />

1. Färre än 500 000 poster i aviseringen.<br />

Filnamn:<br />

navet_.xml<br />

Ex: navet_1000345.xml<br />

är ett sjuställigt tal som representerar<br />

en intern sekvens. Löpnumret skapas vid<br />

framställning av filen/filerna som ingår<br />

aviseringen.<br />

2. Fler än 500 000 poster i aviseringen.<br />

Filerna delas upp per 500 000 poster.<br />

Filerna namnges då med filnamn:<br />

navet__.xml<br />

Ex: navet_1000345_1.xml, navet_1000345_2.xml, osv<br />

är ett sjuställigt tal (0000001-9999999)<br />

som representerar en intern sekvens. Löpnumret<br />

skapas vid framställning av filen/filerna som ingår<br />

aviseringen.<br />

representerar ordningsnumret på de<br />

svarsfiler som skapats. För varje fil som skapas per<br />

500 000:e post skiljer sig filnamnen åt med avseende<br />

på representationen av filnumret. För den första<br />

filen sätts FILNUMMER till 1, för nästa till 2 och<br />

så vidare vid behov upp till 99.<br />

6.5.2 Meddelandefiler<br />

Vissa beställningar av avisering baseras på av<br />

beställaren levererad fil (infil) innehållande<br />

personnummer. Det förekommer att en eller flera<br />

personnummer i infilen inte finns med i aviseringen.<br />

Bland annat kan en orsak vara att personnumret är<br />

ogiltigt och därför inte existerar. Dessa<br />

personnummer returneras till beställaren i en fil i<br />

XML-format som namnges enligt:<br />

navet__med.xml


*<strong>Skatteverket</strong> 37 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

Ex: navet_1000345_med.xml<br />

är ett sjuställigt tal (0000001-9999999)<br />

som representerar en intern sekvens. Löpnumret<br />

skapas vid framställning av filen. Löpnumret är satt<br />

till samma som i namnet på filen/filerna som<br />

innehåller övriga aviseringar.<br />

Denna fil levereras sist i SHS-meddelandet.


*<strong>Skatteverket</strong> 38 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

7 Exempel på filer med XML-Format<br />

7.1 Filexempel – Utfiler<br />

Regelbunden ändringsavisering (1 totalpost)<br />

<br />

<br />

<br />

<br />

162021005448<br />

<br />

<br />

00000032<br />

162626262626<br />

REGELBUNDEN Ändringskund<br />

Ändringsavdelningen<br />

Kalle Jansson<br />

<br />

<br />

00000032-FO01-0004<br />

UTDATAFIL<br />

ÄNDRADE_TERMER<br />

NAVET<br />

<br />

navet_1000267.xml<br />

20060830<br />

00000001<br />

0000001<br />

001<br />

001<br />

FB ej sekretssmarkerade <br />

00001299<br />

20060614-20060823<br />

<br />

<br />

<br />

<br />

<br />

<br />

2006.000.000.087<br />

46H<br />

<br />

<br />

<br />

200112142393


*<strong>Skatteverket</strong> 39 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

<br />

<br />

OB<br />

20060601<br />

<br />

<br />

Proviva<br />

KrusenstjÄrna<br />

<br />

<br />

20020101<br />

01<br />

82<br />

01<br />

SLUT 1:10<br />

0<br />

<br />

<br />

<br />

OG<br />

<br />

<br />

<br />

AIX-EN-PROVENCE<br />

FRANKRIKE<br />

<br />

<br />

<br />

20020101<br />

<br />

<br />

<br />

<br />

197812110000<br />

<br />

FA<br />

<br />

Thierry<br />

Brouchard<br />

<br />

<br />

<br />

<br />

197812110000<br />

<br />

V<br />

20050608<br />

<br />

Thierry


*<strong>Skatteverket</strong> 40 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

Brouchard<br />

<br />

<br />

<br />

<br />

197912190000<br />

<br />

MO<br />

<br />

MARIE CLAIRE<br />

BRIARD<br />

<br />

<br />

<br />

<br />

FR<br />

20020101<br />

<br />

<br />

<br />

<br />

20060601<br />

01<br />

82<br />

01<br />

SLUT 1:10<br />

OB<br />

<br />

<br />

20020101<br />

01<br />

82<br />

01<br />

SLUT 1:10<br />

FB<br />

<br />

<br />

<br />

<br />


*<strong>Skatteverket</strong> 41 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

Ändringsavisering<br />

Borttagna termer är markerade med fetstil<br />

<br />

<br />

<br />

<br />

162021005448<br />

<br />

<br />

00000031<br />

162626262626<br />

REGELBUNDEN Totalkund<br />

Totalavdelningen<br />

Magnus Ohlsson<br />

<br />

<br />

00000031-FO06-0005<br />

UTDATAFIL<br />

ÄNDRADE_TERMER<br />

NAVET<br />

<br />

navet_1000159.xml<br />

20060814<br />

00000100<br />

000001<br />

001<br />

001<br />

Test 20060608 <br />

00001064<br />

20060330-20060628<br />

<br />

<br />

<br />

<br />

<br />

<br />

2006.000.000.123<br />

356H<br />

<br />

<br />

<br />

195102031753<br />

<br />

<br />

<br />

OG


*<strong>Skatteverket</strong> 42 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

<br />

<br />

<br />

<br />

<br />

195109182187<br />

<br />

M<br />

<br />

<br />

<br />

<br />

<br />

<br />

Regelbunden avisering<br />

Motsvarande brytpost är markerad med fetstil<br />

<br />

<br />

<br />

<br />

162021005448<br />

<br />

<br />

00000031<br />

162626262626<br />

REGELBUNDEN Totalkund<br />

Totalavdelningen<br />

Magnus Ohlsson<br />

<br />

<br />

00000031-FO<strong>07</strong>-0006<br />

UTDATAFIL<br />

TOTALPOST<br />

NAVET<br />

<br />

navet_1000265.xml<br />

20060823<br />

00000001<br />

00000001<br />

001<br />

001<br />

XML - B02-01 R, totalpost och ej särlösningsuppgifter<br />

<br />

00001287


*<strong>Skatteverket</strong> 43 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

20060614-20060628<br />

<br />

<br />

<br />

<br />

<br />

<br />

2006.000.000.086<br />

5H<br />

<br />

<br />

<br />

197505652391<br />

<br />

<br />

Karlsson<br />

Karl<br />

<br />

<br />

<br />

<br />

NORGE<br />

<br />

<br />

<br />

NO<br />

00000000<br />

<br />

<br />

<br />

<br />

<br />

2006.000.000.106<br />

1R<br />

<br />

<br />

<br />

197906082388<br />

<br />

<br />

Agda<br />

Padda<br />

<br />

<br />

20050101<br />

01<br />

80<br />

01<br />

GENERALEN 1:1


*<strong>Skatteverket</strong> 44 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

0<br />

<br />

<br />

<br />

MALMSKILLNADSGATAN 41<br />

11138<br />

STOCKHOLM<br />

<br />

<br />

<br />

RP<br />

20001201<br />

<br />

<br />

<br />

HAAG<br />

NEDERLÄNDERNA<br />

<br />

<br />

<br />

20050101<br />

<br />

<br />

<br />

<br />

200101102382<br />

<br />

B<br />

<br />

<br />

<br />

198006082385<br />

<br />

P<br />

<br />

<br />

<br />

200101102382<br />

<br />

VF<br />

20020608<br />

<br />

<br />

<br />

NL<br />

20050101<br />

<br />

<br />


*<strong>Skatteverket</strong> 45 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

<br />

20050101<br />

01<br />

80<br />

01<br />

GENERALEN 1:1<br />

FB<br />

<br />

<br />

<br />

<br />


*<strong>Skatteverket</strong> 46 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

8 Beskrivning av element/attribut -<br />

termdata/termkod<br />

För de olika typer av filer som finns beskrivna i<br />

avsnitt 4 beskrivs nedan vilka uppgifter som kan<br />

förekomma i filtyperna, vilka värden som tillåts, om<br />

uppgiften är obligatorisk, datatyper för termer samt<br />

övriga upplysningar/regler.<br />

Attribut: Beskriver vad uppgiften/termen avser. En uppgift är<br />

det som ligger i datafilens infodel samt i<br />

mediafilen (se avsnitt 5). Termer motsvarar det som<br />

ligger i posten #UP (se avsnitt 5). Termer är<br />

uppräknade i den ordningsföljd de levereras i<br />

posten.<br />

Termgrupp: Endast aktuell för termer. Visar vilken term-grupp<br />

respektive term tillhör.<br />

Fältnamn/termkod: Här anges fältnamn (namnen inom < >) enligt<br />

<strong>beskrivning</strong> i avsnitt 3.3.1 och avsnitt 3.3.2.<br />

Dessutom anges de termkoder, , som kan<br />

finnas i posten #UP. Det är termvärdet <br />

för termkoden som skall uppfylla kraven i följande<br />

kolumner.<br />

Avser kapitel 8.5.<br />

Element/attribut: Här anges element respektive attribut i XMLformatet.<br />

Avser kapitel 8.6<br />

Datatyp: Anger på vilket sätt värdet anges. Se vidare<br />

avsnitt 8.3 och 8.4<br />

Tkn: Anger hur många tecken attributet/termen kan<br />

innehålla.<br />

Övrigt: Anger övriga regler, undantag mm för<br />

attributet/termen.


*<strong>Skatteverket</strong> 47 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

8.1 Termförteckning<br />

Termgrupp Term<br />

Folkbokföring Datum för folkbokföring<br />

Folkbokföringsadress c/o<br />

Län, kod<br />

Kommun, kod<br />

Församling, kod<br />

Fastighetsbeteckning<br />

Fiktivt nummer<br />

Utdelningsadress 1<br />

Utdelningsadress 2<br />

Postnummer<br />

Postort<br />

Riksnycklar Riksnyckel för fastighet<br />

Särskild postadress c/o<br />

Riksnyckel för adressplats<br />

Riksnyckel för lägenhet<br />

Utdelningsadress 1<br />

Utdelningsadress 2<br />

Postnummer<br />

Postort<br />

Utlandsadress Utdelningsadress 1<br />

Utdelningsadress 2<br />

Utdelningsadress 3<br />

Land<br />

Datum för utlandsadress Datum för utlandsadress<br />

Namn Tilltalsnamnsmarkering, kod<br />

Förnamn<br />

Mellannamn<br />

Efternamn<br />

Aviseringsnamn<br />

Uppgift om förnamn styrkt<br />

Uppgift om mellannamn styrkt<br />

Uppgift om efternamn styrkt<br />

Medborgarskap Medborgarskap, kod<br />

Medborgarskapsdatum<br />

Status på medborgarskap, kod


*<strong>Skatteverket</strong> 48 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

Civilstånd Civilstånd, kod<br />

Uppgift om medborgarskap styrkt<br />

Civilståndsdatum<br />

Avregistrering Avregistreringsorsak, kod<br />

Avregistreringsdatum<br />

Födelsehemort (inom Sverige) Födelselän<br />

Födelseförsamling<br />

Födelseort (i utlandet) Födelseort<br />

Födelseland<br />

Uppgift om födelseort i utlandet styrkt<br />

Relation Personnummer, folkbokförd relation<br />

Historik (aktuell och tidigare folkbokföring) Län, kod<br />

Födelsetid, aldrig folkbokförd relation<br />

Typ av relation, kod<br />

Vårdnadsdatum för vårdnadsrelation<br />

Förnamn, aldrig folkbokförd relation<br />

Mellannamn, aldrig folkbokförd relation<br />

Efternamn, aldrig folkbokförd relation<br />

Status på relation, kod<br />

Datum för avslutad vårdnad<br />

Avregistreringsorsak för relationsperson<br />

Avregistreringsdatum för relationsperson<br />

Kommun, kod<br />

Församling, kod<br />

Fastighetsbeteckning<br />

Folkbokföringsdatum<br />

Folkbokföringstyp<br />

Särlösning Invandringsland, kod<br />

Utvandringsland, kod<br />

Beslutsgrund för TP-personer och personer<br />

med Samordningsnummer<br />

Ingivarenamn vid dödsfall<br />

Avregistrering som obefintlig<br />

Ort i Norden varifrån invandring skett<br />

Särlösningsrelation Personnummer, folkbokförd relation<br />

Födelsetid, aldrig folkbokförd relation<br />

Kön, dödfött barn<br />

Typ av relation, kod


*<strong>Skatteverket</strong> 49 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

Föregående folkbokföringsadress c/o<br />

Fr.o.m.datum för relation<br />

Förnamn, aldrig folkbokförd relation<br />

Mellannamn, aldrig folkbokförd relation<br />

Efternamn, aldrig folkbokförd relation<br />

Antal barn per börd<br />

Personnummer/födelsetid, fader till dödfött barn<br />

Status på relation, kod<br />

Utdelningsadress 1<br />

Utdelningsadress 2<br />

Postnummer<br />

Postort


*<strong>Skatteverket</strong> 50 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

8.2 Värdeförråd<br />

Värdenamn Värdeförråd<br />

Datum_A Korrekt datum, ÅÅÅÅMMDD:<br />

ÅÅÅÅ: 1997 och framåt<br />

MM: 01 – 12<br />

DD: 01 – 31<br />

Datum_B ÅÅÅÅMMDD:<br />

ÅÅÅÅ: 1875 - 1996*<br />

MM: 00 – 12<br />

DD: 00 - 31<br />

* = tom nuvarande år<br />

Kan även ha värdet 00000000 (noll)<br />

Datum_C ÅÅÅÅMMDD[-ÅÅÅÅMMDD]<br />

ÅÅÅÅ: 1997 och framåt<br />

MM: 01 –12<br />

DD: 01 – 31<br />

Datum_D ÅÅÅÅMMDD:<br />

ÅÅÅÅ: 1875 - 2002*<br />

MM: 00 – 12<br />

DD: 00 - 31<br />

Kan även sakna värde<br />

* = tom nuvarande år<br />

Datum_E Korrekt datum, ÅÅÅÅMMDD följt av tid,<br />

HHMMSS:<br />

ÅÅÅÅ: 1997 och framåt<br />

MM: 01 – 12<br />

DD: 01 – 31<br />

HH = 00 – 23<br />

MM = 00 – 59<br />

SS = 00 - 59<br />

Id_A Korrekt personnummer, 12-ställigt<br />

ÅÅÅÅMMDDNNNK<br />

Det kan även förekomma nollor i hela eller<br />

delar av födelsetiden.<br />

Id_B Födelsetid + Nollor:<br />

ÅÅÅÅMMDD0000<br />

eller korrekt personnummer enligt Id_A<br />

Kan även ha nollor i hela eller delar av<br />

födelsetiden<br />

Id_C Personnummer/organisationsnummer:<br />

ÅÅÅÅMMDDNNNK<br />

Id_D Korrekt personnummer, 12-ställigt<br />

ÅÅÅÅMMDDNNNK<br />

eller Samordningsnummer, 12-ställigt<br />

ÅÅÅÅMMDDNNNK där<br />

MM = 00 – 12<br />

DD = 60 – 91<br />

Numeriskt_A Heltal: 01000 - 99999<br />

Numeriskt_B Heltal: 0 – 99 999 999<br />

Värde när term har<br />

tagits bort och inte<br />

ersatt av något nytt<br />

värde.<br />

Endast aktuell i<br />

utfil (aviseringsfil)<br />

-1<br />

-1<br />

-1


*<strong>Skatteverket</strong> 51 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

Numeriskt_C Heltal: 01 – 25 eller 99, där 99 är en signal för<br />

att en sekretessmarkerad person har flyttat ut<br />

från det geografiska område som valts.<br />

-1<br />

Numeriskt_D Heltal: 01 - 99 -1<br />

Numeriskt_E Heltal: 00000 - 99999 -1<br />

Numeriskt_F Heltal: 10 - 99 -1<br />

Numeriskt_H Fiktiva nummer för fastigheter:<br />

0 - 999<br />

Numeriskt_I Löpnummer på filer<br />

0 - 99999<br />

Numeriskt_J Jobbid mm<br />

00000000-99999999<br />

Numeriskt_K Filstorlek<br />

0-9999999999<br />

Numeriskt_L SKMLOK-kod<br />

0000-9999<br />

Numeriskt_M Riksnycklar för adressplats och lägenhet<br />

0-99999999999999<br />

Numeriskt_P Heltal: 00 - 99 -1<br />

Sträng_A Typ av fil:<br />

INDATAFIL (till <strong>Skatteverket</strong>)<br />

UTDATAFIL (från <strong>Skatteverket</strong>)<br />

Sträng_B Kundnummer-’FO’||Avtalsnummer-<br />

Beställningsnummer<br />

Kundnummer: 00000001 - 99999999<br />

Avtalsnummer: 01 – 99<br />

Beställningsnummer: 0001 - 9999<br />

‘FO’ står för Folkbokföring Avisering<br />

Exempel: 00000032-FO01-0002<br />

Sträng_C Beställningstyp kan ha följande värden:<br />

ÄNDRADE_TERMER<br />

TOTALPOST<br />

URVAL<br />

PERSONNUMMERSÄTTNING<br />

Sträng_D 1 - max antal tecken $<br />

Sträng_E Civilståndskoder, 1-2 tecken:<br />

OG = Ogift<br />

G = Gift<br />

Ä = Änka/änkling<br />

S = Skild<br />

RP = Registrerad partner<br />

SP = Skild partner<br />

EP = Efterlevande partner<br />

Sträng_F Statuskoder på medborgarskap, 2 tecken:<br />

NY = Nyregistrerad<br />

RD = Rättad<br />

AS = Avslutad<br />

AN = Annullerad<br />

Sträng_G Sekretessmarkering, kod:<br />

J = Sekretessmarkerad<br />

-1<br />

$<br />

$


*<strong>Skatteverket</strong> 52 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

Sträng_H Kod för avregistreringsorsak, 2 tecken:<br />

AV = Avliden<br />

UV = Utvandrad<br />

GN = Gammalt personnummer<br />

AN = Annan anledning<br />

GS = Gammalt samordningsnummer<br />

OB = Obefintlig<br />

TA = <strong>Teknisk</strong>t avregistrerad<br />

AS = <strong>Teknisk</strong>t avregistrerad<br />

Sträng_I Relationstyp, kod, 1-2 tecken:<br />

B = Barn<br />

MO = Moder<br />

FA = Fader<br />

F = Förälder<br />

V = Vårdnadshavare<br />

VF = Vårdnadshavare för<br />

M = Make/maka<br />

P = Partner<br />

Sträng_J Statuskoder på relation, 2 tecken:<br />

NY = Nyregistrerad<br />

PB = Nyregistrerad pga personnummerbyte<br />

RD = Rättad<br />

AS = Avslutad<br />

AV = Avslutad pga avliden<br />

IV = Avslutad pga invandring<br />

AN = Annullerad<br />

Sträng_K Relationstyp, kod, 2 tecken:<br />

AB = Adoptivbarn<br />

BA=Bortadopterat barn<br />

AF = Adoptivfar<br />

AM= Adoptivmor<br />

AP= Annan person<br />

DF=Dödfött barn<br />

Endast aktuell vid särlösningsuppgifter<br />

Sträng_L ÅÄÖÜåäöüÉé#_@<br />

Sträng_M Skall ha värdet “NAVET”<br />

Sträng_N Kod för kön:<br />

M = man<br />

K = kvinna<br />

Sträng_O Kod som visar att det är en totalpost på<br />

personen som aviseras:<br />

J = totalpost på personen aviseras<br />

Endast aktuell vid regelbunden avisering,<br />

ändrade termer.<br />

Sträng_P Kod som visar att personen har avregistrerats<br />

som obefintlig:<br />

OB = avregistrerad som obefintlig<br />

Sträng_R Kod visar avregistreringsorsak för<br />

relationsperson, 2 tecken. Visar att<br />

relationspersonen har avlidit:<br />

AV = Avliden<br />

Sträng_S Kod visar folkbokföringstyp.<br />

FB = Folkbokförd<br />

UV = Utvandrad<br />

OB = Obefintlig<br />

Sträng_Q Kod som visar om huvuduppgiften är styrkt<br />

eller ej.<br />

J = Uppgiften styrkt<br />

$<br />

Kan vara NULL<br />

$


*<strong>Skatteverket</strong> 53 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

N = Uppgiften ej styrkt<br />

Endast aktuell för personer med gällande<br />

samordningsnummer<br />

Tid_A HHMMSS<br />

HH = 00 – 23<br />

MM = 00 – 59<br />

SS = 00 - 59<br />

Numeriskt_N Postidentitet. Löpande numrering per person<br />

och dag.<br />

8.3 Fältnamn, etikettfil<br />

Detta gäller inte filer från SHS/e-transport.<br />

Attribut Fältnamn Datatyp Tkn Övrigt<br />

Teckenprov TeckenProv Sträng_L 13 Obligatorisk<br />

Organisationsnummer OrgNr Id_C Obligatorisk<br />

Organisationens/företagets namn Namn Sträng_D 40 Obligatorisk<br />

Kontaktperson Kontakt Sträng_D 40<br />

Avdelning för kontaktperson Avdelning Sträng_D 40<br />

Postutdelningsadress Utdelningsadr Sträng_D 40 Obligatorisk<br />

Postnummer PostNr Numerisk_E 5 Obligatorisk<br />

Postort PostOrt Sträng_D 40 Obligatorisk<br />

E-mail Email Sträng_D 40<br />

Telefonnummer Telefon Sträng_D 20<br />

Faxnummer Fax Sträng_D 20<br />

Program (namn och version) som<br />

skapat mediet<br />

Program Sträng_D 40<br />

Produkt som uppgifterna tillhör Produkt Sträng_M 5 Obligatorisk<br />

Medielämnarens identitet på mediet MediaId Sträng_D 40<br />

Datum då mediet skapades DatumSkapad Datum_A 8<br />

Tid då mediet skapades TidSkapad Tid_A 6<br />

Titel/rubrik på infil/aviseringsfil FilTitel Sträng_D 70<br />

Löpnummer på fil ExRef Numeriskt_I 5 Ej obligatoriskt<br />

Namn på fil med aviseringsuppgifter FilNamn Sträng_D 40 Obligatorisk<br />

8.4 Fältnamn, metadata SHS/e-transport<br />

Detta ligger sist i filer från SHS/e-transport.<br />

Attribut Fältnamn Datatyp Tkn Övrigt<br />

Produkt som uppgifterna tillhör Produkt Sträng_M 5 Obligatorisk<br />

Jobbidentitet JobbId Numeriskt_J 8 Obligatorisk<br />

Framställningsdatum på utfil EffDatum Datum_A 8 Obligatorisk<br />

Beställningsnummer BestId Stränb_B 18 Obligatorisk<br />

Namn på fil med aviserings-<br />

uppgifter<br />

FilNamn Sträng_D 40 Obligatorisk<br />

Löpnummer på fil Lopnr Numeriskt_I 5 Ej obligatoriskt<br />

Titel/rubrik på aviseringsfil FilTitel Sträng_D 70 Ej obligatoriskt


*<strong>Skatteverket</strong> 54 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

Filstorlek Filstorlek Numeriskt_K 10 Obligatorisk<br />

Organisationsnummer OrgNr Id_C 12 Obligatorisk<br />

Kundnummer Kundnr Numeriskt_J 8 Obligatorisk<br />

Slutkundnummer Slutkundnr Numeriskt_J 8 Ej obligatoriskt<br />

Organisationens/företagets namn Namn Sträng_D 40 Obligatorisk<br />

Avdelning för kontaktperson Avdelning Sträng_D 40<br />

Kontaktperson Kontakt Sträng_D 40


*<strong>Skatteverket</strong> 55 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

8.5 Fältnamn, datafil - avisering<br />

Attribut/term Termgrupp Fältnamn/termkod Datatyp Tkn Övrigt<br />

Typ av fil FilTyp Sträng_A 10 Indikerar om det är en infil till<br />

<strong>Skatteverket</strong> eller utfil (aviseringsfil)<br />

till mottagare.<br />

Beställningsnummer BestId Sträng_B 18<br />

Typ av beställning BestTyp Sträng_C 20<br />

Namn på infil NamnInFil Sträng_D 30 Endast aktuell i infil från mottagare.<br />

Gäller ännu inte för SHS/e-transport.<br />

Giltighetstid för infil TomDatum Datum_A 8 Endast aktuell i infiler från mottagare.<br />

Ej obligatorisk.<br />

Framställningsdatum på utfil EffDatum Datum_A 8 Endast aktuell i utfil till mottagare.<br />

Datum för ändring på<br />

aviserade personposter<br />

Infil som legat till grund för<br />

utfilen (aviseringsfilen)<br />

FromTomDatum Datum_C 17 Kan vara ett datum eller ett datumintervall.<br />

Endast aktuell i utfil,<br />

regelbunden avisering, till mottagare.<br />

Visar när ändringen registrerades i<br />

det centrala aviseringsregistret.<br />

NamnInfilTillGrund Sträng_D 30 Aktuell när infil från mottagare<br />

använts vid utsökning.<br />

Personnummer PersNr Id_A 12 Endast aktuell i infil med personnummer<br />

från mottagare.<br />

Termkodsnummer TermKod Numeriskt_A 5 Inte aktuell i infil med personnummer<br />

från mottagare.<br />

Dag start för brytpost Dagstart Datum_A 8 Endast aktuell om brytpost valts<br />

Antal poster i infil/utfil AntalPoster Numeriskt_B 8<br />

Postid POST_ID Numeriskt_N 16<br />

Ändringstidpunkt i Navet 01000 Datum_E 14 Endast aktuell i transaktioner via<br />

Webservices Personpost.<br />

Personnummer 01001 Id_A 12 Obligatorisk om inte termkod 01002<br />

finns.<br />

Tilldelat personnummer eller<br />

Samordningsnummer<br />

01002 Id_D 12 Obligatorisk om inte termkod 01001<br />

finns.<br />

Sekretessmarkering, kod 01003 Sträng_G 1<br />

Ärendetyp, kod 01004 Sträng_D 40 Se avsnitt 8.7.1.<br />

Hänvisningsperson -<br />

nummer<br />

01005 Id_D 12<br />

Avregistreringsorsak, kod Avregistrering 01006 Sträng_H 2<br />

Avregistreringsdatum Avregistrering 010<strong>07</strong> Datum_B 8<br />

Totalpost 01008 Sträng_O 1 Endast aktuell vid regelbunden<br />

avisering, ändrade termer. Sätts till ‘J’<br />

när totalpost på personen aviseras.<br />

Dvs när personen anses komma som<br />

ny till mottagarens register.<br />

Tilltalsnamns-markering,<br />

kod<br />

Namn 01011 Numeriskt_F 2<br />

Förnamn Namn 01012 Sträng_D 80<br />

Mellannamn Namn 01013 Sträng_D 40<br />

Efternamn Namn 01014 Sträng_D 60 Kan innehålla ’/’.<br />

Aviseringsnamn Namn 01015 Sträng_D 36 Finns endast för de personer vars<br />

förnamn, mellannamn och efternamn<br />

tillsammans överstiger 36 tecken.


*<strong>Skatteverket</strong> 56 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

Folkbokföringsdatum Folkbokföring 01021 Datum_B 8<br />

Län, kod Folkbokföring 01022 Numeriskt_C 2<br />

Kommun, kod Folkbokföring 01023 Numeriskt_D 2<br />

Församling, kod Folkbokföring 010<strong>24</strong> Numeriskt_D 2<br />

Fastighetsbeteckning Folkbokföring 01025 Sträng_D 40<br />

Fiktivt nummer för fastighet Folkbokföring 01028 Numeriskt_H 3 Värdet 0 (noll) är default-värde.<br />

c/o Folkbokföringsadress<br />

Utdelningsadress 1 Folkbokförings-<br />

adress<br />

Utdelningsadress 2 Folkbokföringsadress<br />

Postnummer Folkbokföringsadress<br />

Postort Folkbokföringsadress<br />

01031 Sträng_D 35<br />

01032 Sträng_D 35<br />

01033 Sträng_D 35 Adressens första 35 tecken läggs i<br />

denna term enligt adresstandard<br />

SS 61 34 01.<br />

01034 Numeriskt_E 5<br />

01035 Sträng_D 27<br />

Riksnyckel för fastighet Riksnycklar 01045 Sträng_D 10<br />

Riksnyckel för adressplats Riksnycklar 01046 Numeriskt_M 14<br />

Riksnyckel för lägenhet Riksnycklar 01047 Numeriskt_M 14<br />

c/o Särskild postadress<br />

Utdelningsadress 1 Särskild postadress<br />

Utdelningsadress 2 Särskild postadress<br />

Postnummer Särskild postadress<br />

Postort Särskild postadress<br />

01051 Sträng_D 35 Kan även innehålla adress för<br />

personer med samordningsnummer<br />

01052 Sträng_D 35 Kan även innehålla adress för<br />

personer med samordningsnummer<br />

01053 Sträng_D 35 Adressens första 35 tecken läggs i<br />

denna term enligt adresstandard<br />

SS 61 34 01.<br />

Kan även innehålla adress för<br />

personer med samordningsnummer<br />

01054 Numeriskt_E 5 Kan även innehålla adress för<br />

personer med samordningsnummer<br />

01055 Sträng_D 27 Kan även innehålla adress för<br />

personer med samordningsnummer<br />

Utdelningsadress 1 Utlandsadress 01<strong>07</strong>1 Sträng_D 35 Kan innehålla c/o-adress<br />

Utdelningsadress 2 Utlandsadress 01<strong>07</strong>2 Sträng_D 35<br />

Utdelningsadress 3 Utlandsadress 01<strong>07</strong>3 Sträng_D 35<br />

Land Utlandsadress 01<strong>07</strong>7 Sträng_D 35<br />

Datum för utlandsadress Datum för<br />

utlandsadress<br />

01<strong>07</strong>8 Datum_B 8<br />

Datum för rösträtt Datum för rösträtt 01<strong>07</strong>9 Datum_B 8<br />

Civilstånd, kod Civilstånd 01081 Sträng_E 2<br />

Civilståndsdatum Civilstånd 01082 Datum_B 8<br />

Födelselän, kod Födelsehemort<br />

(inom Sverige)<br />

Födelseförsamling Födelsehemort<br />

(inom Sverige)<br />

Födelseort i utlandet Födelseort (i utlandet<br />

)<br />

Födelseland Födelseort ( i utlandet)<br />

01091 Numeriskt_P 2<br />

01092 Sträng_D 30<br />

01093 Sträng_D 80<br />

01094 Sträng_D 40 Klartext<br />

Invandringsdatum 01101 Datum_B 8


*<strong>Skatteverket</strong> 57 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

Uppgift om förnamn styrkt Namn 01212 Sträng_Q 1 Aviseras endast för personer med<br />

gällande samordningsnummer. Tillhör<br />

huvuduppgift med termkod 01012.<br />

Uppgift om mellannamn<br />

styrkt<br />

Namn 01213 Sträng_Q 1 Aviseras endast för personer med<br />

gällande samordningsnummer. Tillhör<br />

huvuduppgift med termkod 01013.<br />

Uppgift om efternamn styrkt Namn 01214 Sträng_Q 1 Aviseras endast för personer med<br />

gällande samordningsnummer. Tillhör<br />

huvuduppgift med termkod 01014.<br />

Uppgift om födelseort i<br />

utlandet styrkt<br />

Start på uppgifter om<br />

relationsperson<br />

Personnummer, folkbokförd<br />

relation<br />

Födelsetid, aldrig<br />

folkbokförd relation<br />

Födelseort (i utlandet<br />

)<br />

01293 Sträng_Q 1 Aviseras endast för personer med<br />

gällande samordningsnummer. Tillhör<br />

huvuduppgift med termkod 01093.<br />

02000 Indikerar att uppgifter om en<br />

relationsperson startar. Har inget<br />

annat värde i posten #UP än<br />

termkoden 02000<br />

Relation 02001 Id_A 12<br />

Relation 02002 Id_B 12<br />

Typ av relation, kod Relation 02003 Sträng_I 2<br />

Vårdnadsdatum för<br />

vårdnadsrelation<br />

Förnamn för aldrig<br />

folkbokförd relation<br />

Mellannamn för aldrig<br />

folkbokförd relation<br />

Efternamn för aldrig<br />

folkbokförd relation<br />

Relation 02004 Datum_B 8<br />

Relation 02005 Sträng_D 80<br />

Relation 02006 Sträng_D 40<br />

Relation 020<strong>07</strong> Sträng_D 60<br />

Status på relation, kod Relation 02008 Sträng_J 2 Aviseras endast vid regelbunden<br />

avisering, ändrade termer. Visar<br />

vilken status relationen har vid<br />

avisering.<br />

Datum för avslutad vårdnad Relation 02009 Datum_B 8 Gäller endast Ändringsavisering<br />

Avregistreringsorsak för<br />

relationsperson<br />

Avregistreringsdatum för<br />

relationsperson<br />

Slut på uppgifter om en<br />

relationsperson<br />

Start på uppgifter om ett<br />

medborgarskap<br />

Relation 02010 Sträng_R 2<br />

Relation 02011 Datum_D 8<br />

02999 Indikerar att uppgifter om en<br />

relationsperson slutar. Har inget<br />

annat värde i posten #UP än<br />

termkoden 02999<br />

03000 Indikerar att uppgifter om ett<br />

medborgarskap startar. Har inget<br />

annat värde i posten #UP än<br />

termkoden 03000<br />

Medborgarskap, kod Medborgarskap 03001 Sträng_D 2 Kod enligt ISO-standard.<br />

Medborgarskapsdatum Medborgarskap 03002 Datum_B 8<br />

Status på medborgarskap, Medborgarskap 03003 Sträng_F 2 Aviseras endast vid regelbunden<br />

kod<br />

avisering, ändrade termer. Visar<br />

vilken status medborgarskapet har<br />

vid avisering.<br />

Uppgift om medborgarskap Medborgarskap 03201 Sträng_Q 1 Aviseras endast för personer med<br />

styrkt<br />

gällande samordningsnummer. Tillhör<br />

huvuduppgift med termkod 03001.


*<strong>Skatteverket</strong> 58 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

Slut på uppgifter om ett<br />

medborgarskap<br />

Start på uppgifter om<br />

historik (aktuell och tidigare<br />

folkbokföring)<br />

03999 Indikerar att uppgifter om ett<br />

medborgarskap slutar. Har inget<br />

annat värde i posten #UP än<br />

termkoden 03999<br />

04000 Indikerar att uppgifter om tidigare<br />

folkbokföring startar. Har inget annat<br />

värde i posten #UP än termkoden<br />

04000<br />

Folbokföringsdatum Historik 04001 Datum_B 8<br />

Län, kod Historik 04002 Numeriskt_C 2<br />

Kommun, kod Historik 04003 Numeriskt_D 2<br />

Församling, kod Historik 04004 Numeriskt_D 2<br />

Fastighetsbeteckning Historik 04005 Sträng_D 40<br />

Folbokföringstyp Historik 04008 Sträng_S 2<br />

Slut på uppgifter om historik<br />

04999 Indikerar att uppgifter om en tidigare<br />

(aktuell och tidigare<br />

folkbokföring slutar. Har inget annat<br />

folkbokföring)<br />

värde i posten #UP än termkoden<br />

04999<br />

Invandringsland, kod Särlösning 05001 Sträng_D 2 Kod enligt ISO-standard.<br />

Utvandringsland, kod Särlösning 05002 Sträng_D 2 Kod enligt ISO-standard.<br />

Beslutsgrund för personer<br />

med tilldelat personnummer<br />

och samordningsnummer<br />

Särlösning 05003 Sträng_D 60<br />

Ingivare vid dödsfall Särlösning 05004 Sträng_D 60<br />

Avregistrering som obefintlig Särlösning 05005 Sträng_P 2<br />

Ort i Norden varifrån<br />

invandring skett<br />

Start för särlösningsuppgifter<br />

om en<br />

relationsperson<br />

Personnummer,<br />

folkbokförd relation<br />

Födelsetid, aldrig<br />

folkbokförd relation<br />

Särlösning 05006 Sträng_D 80<br />

Särlösningsrelation <br />

Särlösningsrelation<br />

Kön, dödfött barn Särlösningsrelation<br />

Typ av relation, kod Särlösningsrelation<br />

Fr.o.m.datum för relation Särlösningsrelation<br />

Förnamn för aldrig<br />

folkbokförd relation<br />

Mellannamn för aldrig<br />

folkbokförd relation<br />

Efternamn för aldrig<br />

folkbokförd relation<br />

Särlösningsrelation <br />

Särlösningsrelation <br />

Särlösningsrelation<br />

Antal barn per börd Särlösningsrelation<br />

Personnummer/födelsetid,<br />

fader till dödfött barn<br />

Särlösningsrelation<br />

Status på relation, kod Särlösningsrelation<br />

06000 Indikerar att särlösningsuppgifter om<br />

en relationsperson startar. Har inget<br />

annat värde i posten #UP än<br />

termkoden 06000<br />

06001 Id_A 12<br />

06002 Id_B 12 Endast födelsetid (8-ställig) när<br />

relationstypen är ‘DF’ (Dödfött barn)<br />

06003 Sträng_N 1<br />

06004 Sträng_K 2<br />

06005 Datum_B 8<br />

06006 Sträng_D 80<br />

060<strong>07</strong> Sträng_D 40<br />

06008 Sträng_D 60<br />

06009 Numeriskt_B 2<br />

06010 Id_B 12<br />

06011 Sträng_J 2<br />

Slut på särlösningsuppgifter 06999 Indikerar att särlösningsuppgifter om


*<strong>Skatteverket</strong> 59 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

om en relationsperson en relationsperson slutar. Har inget<br />

annat värde i posten #UP än<br />

termkoden 06999<br />

c/o Föregående<br />

folkbokföringsadress<br />

<strong>07</strong>001 Sträng_D 35<br />

Utdelningsadress 1 Föregående<br />

folkbokföringsadress<br />

Utdelningsadress 2 Föregående<br />

folkbokföringsadress<br />

Postnummer Föregående<br />

folkbokföringsadress<br />

Postort Föregående<br />

folkbokföringsadress<br />

<strong>07</strong>002 Sträng_D 35<br />

<strong>07</strong>003 Sträng_D 35 Adressens första 35 tecken läggs i<br />

denna term enligt adresstandard<br />

SS 61 34 01.<br />

<strong>07</strong>004 Numeriskt_E 5<br />

<strong>07</strong>005 Sträng_D 27


*<strong>Skatteverket</strong> 60 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

8.6 Översättningstabell element/attribut/<br />

termkod/termgrupp folkbokföringspost<br />

Följande tabell beskriver relationen mellan<br />

• elementen och attributen som förekommer i XMLformat,<br />

• termkoder som förekommer i termkod/termdataformat<br />

och<br />

• de termgrupper som väljs av kunden i gjord<br />

beställning.<br />

För att underlätta tolkningen av informationen har<br />

elementen och attributen indenterats. Indenteringen<br />

är baserad på den givna XML-strukturen som är<br />

bestämd och definieras av schemat<br />

Navetavisering.xsd.<br />

Elementen och attributen redovisas i den ordning de<br />

förekommer per folkbokföringspost.<br />

En markering X i kolumnen ”Fler” innebär att<br />

elementen med tillhörande värde ingår i en termgrupp<br />

som per folkbokföringspost kan förekomma fler än en<br />

gång. Övriga element kan förekomma som mest en gång<br />

per folkbokföringspost.


*<strong>Skatteverket</strong> 61 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

Element/attribut Fler Termkod Termgrupp<br />

Folkbokföringspost<br />

01003 Sekretessmarkerade personer<br />

Beskrivning ärendeuppgift<br />

totalpost 01008 Beskrivning ärendeuppgift<br />

utsokningsdatum Beskrivning ärendeuppgift<br />

andringstidpunkt 01000 Beskrivning ärendeuppgift<br />

Beskrivning ärendeuppgift<br />

01004 Beskrivning ärendeuppgift<br />

Personpost<br />

Personid obligatorisk<br />

01001 Personid en obligatorisk<br />

01002 Personid en obligatorisk<br />

01005 Hänvisningspersonnummer<br />

Avregistrering<br />

01006 Avregistrering<br />

010<strong>07</strong> Avregistrering<br />

Namn<br />

01011 Namn<br />

01012 Namn<br />

styrkt 01212 Namn<br />

01013 Namn<br />

styrkt 01213 Namn<br />

01014 Namn<br />

styrkt 01214 Namn<br />

01015 Namn<br />

Folkbokföring<br />

01021 Folkbokföring<br />

01022 Folkbokföring<br />

01023 Folkbokföring<br />

010<strong>24</strong> Folkbokföring<br />

01025 Folkbokföring<br />

01028 Folkbokföring<br />

Adresser (samlingsbegrepp)<br />

Folbokföringsadress<br />

01031 Folbokföringsadress<br />

01032 Folbokföringsadress<br />

01033 Folbokföringsadress<br />

01034 Folbokföringsadress<br />

01035 Folbokföringsadress<br />

Riksnycklar<br />

01045 Riksnycklar<br />

01046 Riksnycklar<br />

01047 Riksnycklar<br />

Särskild postadress<br />

01051 Särskild postadress<br />

01052 Särskild postadress<br />

01053 Särskild postadress<br />

01054 Särskild postadress<br />

01055 Särskild postadress<br />

Utlandsadress (samlingsbegrepp)<br />

01<strong>07</strong>1 Utlandsadress<br />

01<strong>07</strong>2 Utlandsadress<br />

01<strong>07</strong>3 Utlandsadress<br />

01<strong>07</strong>7 Utlandsadress<br />

01<strong>07</strong>8 Datum för utlandsadress


*<strong>Skatteverket</strong> 62 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

Element/attribut Fler Termkod Termgrupp<br />

Civilstånd<br />

01081 Civilstånd<br />

01082 Civilstånd<br />

Födelse (samlingsbegrepp)<br />

Födelsehemort (inom Sverige)<br />

01091 Födelsehemort (inom Sverige)<br />

01092 Födelsehemort (inom Sverige)<br />

Födelseort (i utlandet )<br />

01093 Födelseort (i utlandet )<br />

styrkt 01293 Födelseort (i utlandet )<br />

01094 Födelseort (i utlandet )<br />

Invandringsdatum<br />

01101 Invandringsdatum<br />

Relation<br />

x 02000 Relation<br />

status x 02008 Relation<br />

x Relation<br />

x 02001 Relation<br />

x 02002 Relation<br />

x 02003 Relation<br />

x 02004 Relation<br />

x 02009 Relation<br />

x Relation<br />

x 02005 Relation<br />

x 02006 Relation<br />

x 020<strong>07</strong> Relation<br />

x Relation<br />

x 02010 Relation<br />

x 02011 Relation<br />

03000 Medborgarskap<br />

status 03003 Medborgarskap<br />

03001 Medborgarskap<br />

styrkt 03201 Medborgarskap<br />

03002 Medborgarskap<br />

Historik<br />

x 04000 Historik<br />

x 04001 Historik<br />

x 04002 Historik<br />

x 04003 Historik<br />

x 04004 Historik<br />

x 04005 Historik<br />

x 04008 Historik<br />

Föregående folkbokföringsadress<br />

<strong>07</strong>001 Föregående folkbokföringsadress<br />

<strong>07</strong>002 Föregående folkbokföringsadress<br />

<strong>07</strong>003 Föregående folkbokföringsadress<br />

<strong>07</strong>004 Föregående folkbokföringsadress<br />

<strong>07</strong>005 Föregående folkbokföringsadress


*<strong>Skatteverket</strong> 63 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

Element/attribut Fler Termkod Termgrupp<br />

Särlösning/Särlösningsrelation<br />

Särlösning<br />

05001 Särlösning<br />

05006 Särlösning<br />

Särlösning<br />

x 05002 Särlösning<br />

Särlösning<br />

05005 Särlösning<br />

Särlösningsrelation<br />

06000 Särlösningsrelation<br />

status 06011 Särlösningsrelation<br />

Särlösningsrelation<br />

06001 Särlösningsrelation<br />

06002 Särlösningsrelation<br />

06004 Särlösningsrelation<br />

06005 Särlösningsrelation<br />

Särlösningsrelation<br />

06006 Särlösningsrelation<br />

060<strong>07</strong> Särlösningsrelation<br />

06008 Särlösningsrelation<br />

Särlösningsrelation<br />

06009 Särlösningsrelation<br />

06003 Särlösningsrelation<br />

06010 Särlösningsrelation<br />

05003 Särlösning<br />

05004 Särlösning


*<strong>Skatteverket</strong> 64 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

8.7 Kommentarer<br />

8.7.1 Termkod 01004 - Ärendetyp, kod<br />

Termkod 01004 är ett fält på 40 tecken som visar<br />

vilket ärende som ligger till grund för aviseringen.<br />

Ärendetyperna finns beskrivna i dokumentet "Allmän<br />

<strong>beskrivning</strong>". Fältet innehåller en ärendetyp.<br />

Ärendetypen följs i de flesta fall av "H" eller "R"<br />

för att markera om personen förekommer som huvud-<br />

eller relationsperson i ärendet.<br />

Exempel 1: "#UP 01004 41H"<br />

Ärende för flyttning.<br />

Exempel 2: "#UP 01004 999"<br />

Ärende som består av en teknisk rättelse.<br />

Personposten innehåller normalt termer som direkt<br />

kan kopplas till ärendetypen. Det kan dock i flera<br />

fall vara svårt att utifrån ärendetypen avgöra hur<br />

resten av personposten ser ut<br />

Det finns en mängd faktorer som gör det svårt att<br />

koppla ärendetypen till en viss grupp termer. Det<br />

kan vara allt från tekniska fel till skillnader i<br />

sättet att handlägga ärenden. Personposten kan<br />

alltså i vissa fall innehålla mer eller mindre<br />

uppgifter än vad som är normalt vid en viss<br />

ärendetyp. Dessutom förändras folkbokföringen<br />

kontinuerligt. Detta kan leda till större eller<br />

mindre förändringar i de poster som aviseras. Vi<br />

meddelar alltid om ändringar som påverkar utseendet<br />

i personposten (som den finns beskriven i det här<br />

dokumentet). Mindre ändringar, som faller inom ramen<br />

för "<strong>Teknisk</strong> <strong>beskrivning</strong>", kan dock komma att<br />

genomföras utan något meddelande.<br />

Ärendetyperna i termen 01004 bör ses som ett<br />

komplement till de övriga uppgifterna i<br />

personposten. Vi avråder alla kunder från att<br />

använda ärendetyperna för att avgöra vilken/vilka<br />

händelser som inträffat eller för att "avkoda"<br />

personposten. Det säkraste sättet att använda<br />

personposten är att ersätta alla uppgifter som finns<br />

lagrade på personen (vid totalpost) eller att lägga<br />

in de nya/ta bort de gamla uppgifterna (vid ändrade<br />

termer). Om det är nödvändigt att "se" vad som hänt


*<strong>Skatteverket</strong> 65 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

på personen kan det vara idé att förutom<br />

ärendetyperna även undersöka vilka termer som<br />

förändrats. Det är dock omöjligt att som<br />

aviseringarna idag ser ut komma fram till ett<br />

hundraprocentigt svar.<br />

För XML-format motsvaras termkod 01004 av elementet<br />

. Se kapitel 8.6 Översättningstabell.<br />

8.7.2 Termkod 01045, 01046, 01047 Riksnycklar<br />

Termkoderna 01046 Riksnyckel för adressplats och<br />

01047 Riksnyckel för lägenhet har båda bildats<br />

utifrån två fält hos Lantmäteriverket, ett<br />

riksnyckelprefix och ett riksnyckelid. Eftersom<br />

riksnyckelprefixet alltid består av ett tecken har<br />

<strong>Skatteverket</strong> valt att placera riksnyckelprefix och<br />

riksnyckelid i samma term.<br />

Termkod 01045 Riksnyckel för fastighet har inget<br />

separat prefix hos Lantmäteriverket och har därför<br />

bildats utifrån ett fält hos Lantmäteriverket.<br />

Nedanstående tabell beskriver hur <strong>Skatteverket</strong><br />

levererar Lantmäteriets riksnycklar.<br />

Term Innehåll<br />

01045 Fastighetsnyckel<br />

01046 Riksnyckelprefix adressplats + Riksnyckelid adressplats<br />

01047 Riksnyckelprefix lägenhet + Riksnyckelid lägenhet


*<strong>Skatteverket</strong> 66 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

9 Direktåtkomst<br />

9.1 Web Services - ePersondata<br />

9.1.1 Inledning<br />

Tjänsten ePersondata innebär möjlighet att direkt<br />

hämta en personpost eller söka fram personer ur<br />

Navet via kundens egen applikation. Vilka uppgifter<br />

respektive kund får ta emot via ePersondata regleras<br />

av vilka uppgifter kunden själv får lagra i sina<br />

register.<br />

Tjänsten ePersondata är baserad på tekniken Web<br />

Services och kommunikationen sker via Internet.<br />

I tjänsten ePersondata ingår två Web Services,<br />

Personpost och Namnsökning.<br />

9.1.1.1 Web Service Personpost<br />

Med Web Service Personpost hämtas personuppgifter ur<br />

Navet om efterfrågad person med sökvillkoret<br />

personnummer, tilldelat personnummer eller<br />

samordningsnummer. Vilka uppgifter respektive kund<br />

tar emot anges enligt en kundspecifik mall.<br />

9.1.1.2 Web Service Namnsökning<br />

Med Web Service Namnsökning kan personer sökas fram<br />

i Navet med hjälp av sökbegrepp som till exempel<br />

namn, adress, kön, födelsetid, postnummer och<br />

postort. Flera personposter returneras om<br />

sökvillkoret innebär fler än en träff. Antalet<br />

träffar är maximerat till 100.<br />

Personposten/personposterna som returneras<br />

innehåller personnummer, tilldelat personnummer<br />

eller samordningsnummer, namn och adressuppgifter,<br />

vilket inte är kundspecifikt utan gemensamt för alla<br />

kunder. Syftet med denna tjänst är att hitta en<br />

specifik person utan att känna till en persons<br />

identitet. Om en mer utförlig personpost önskas om<br />

funnen person anropas Web Service Personpost.


*<strong>Skatteverket</strong> 67 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

9.1.2 Inparametrar till Web Service Personpost<br />

De generella uppgifter som kunden behöver för att<br />

kunna utföra förfrågan mot Navet via Web Service<br />

Personpost är:<br />

Term Innehåll<br />

Organisationsnummer Kundens organisationsnummer. Måste matcha<br />

det organisationsnummer som certifikatet<br />

har. 12-ställig sträng. Ex: 162021004748<br />

Obligatorisk<br />

Beställningsid Kundens beställningsidentitet. 18-ställig<br />

sträng. Består av kundnummer, avtalsnummer<br />

samt beställningsnummer.<br />

Ex. 00000346-FO01-0005. Obligatorisk.<br />

Personidentitet Fullständig personidentitet på den person<br />

vars uppgifter ska hämtas. 12-ställig<br />

sträng, ex:<br />

193201082366.<br />

Obligatorisk.<br />

Med detaljerad <strong>beskrivning</strong> finns i <strong>Teknisk</strong><br />

handledning för Web Services, bilaga 6.


*<strong>Skatteverket</strong> 68 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

9.1.3 Inparametrar till Web Service Namnsökning<br />

De generella uppgifter som kunden behöver för att<br />

kunna utföra förfrågan mot Navet via Web Service<br />

Namnsökning är:<br />

Term Innehåll<br />

Organisationsnummer Kundens organisationsnummer. Måste<br />

matcha det organisationsnummer som<br />

certifikatet har. 12-ställig sträng. Ex:<br />

162021004748<br />

Obligatorisk<br />

Beställningsid Kundens beställningsidentitet. 18ställig<br />

sträng. Består av kundnummer,<br />

avtalsnummer samt beställningsnummer.<br />

Ex. 00000346-FO01-0005. Obligatorisk.<br />

Sökvillkor Sökvillkor anges som inparametrar till<br />

tjänsten. De sökvillkor som kan anges<br />

och kombineras valfritt är kön,<br />

födelsetid from, födelsetid tom,<br />

förnamn, mellannamn/efternamn, adress,<br />

postnr from, postnr tom och postort. Det<br />

fungerar dock inte att göra en alltför<br />

omfångsrik sökning eftersom tjänsten är<br />

begränsad till att maximalt returnera<br />

100 personer. Det fungerar till exempel<br />

inte att söka på alla personer med<br />

förnamn Anna som har postort Stockholm.<br />

Sökbegreppen måste då begränsas<br />

ytterligare till exempel genom att<br />

födelsetid, efternamn och/eller adress<br />

anges.<br />

Med detaljerad <strong>beskrivning</strong> finns i <strong>Teknisk</strong><br />

handledning för Web Services, bilaga 6.<br />

9.2 Postinnehåll Web Service Personpost<br />

Personposterna från Web Service Personpost har samma<br />

utseende och format som den vanliga aviseringen.<br />

Samma termkoder används för personuppgifterna.


*<strong>Skatteverket</strong> 69 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

Följande termkoder förekommer i personpost vid<br />

åtkomst via Web Service Personpost, motsvarande<br />

taggar i XML-format finns redovisat i kapitel 8.6<br />

Översättningstabell:<br />

Termkod Aviseringsterm i klartext<br />

01000 Ändringstidpunkt i Navet<br />

01001 Personnummer<br />

01002 Tilldelat personnummer/Samordningsnummer<br />

01003 Sekretessmarkering<br />

01005 Hänvisningspersonnummer<br />

01006 Avregistreringsorsak, kod<br />

010<strong>07</strong> Datum för avregistrering<br />

01008 Indikation att totalpost aviseras<br />

01011 Tilltalsnamnsmarkering, kod<br />

01012 Förnamn<br />

01013 Mellannamn<br />

01014 Efternamn<br />

01015 Aviseringsnamn<br />

01021 Datum, folkbokföring<br />

01022 Län, folkbokföring, kod<br />

01023 Kommun, folkbokföring, kod<br />

010<strong>24</strong> Församling, folkbokföring, kod<br />

01025 Fastighetsbeteckning, folkbokföring<br />

01028 Fiktivt nummer<br />

01031 c/o-adress, folkbokföringsadress<br />

01032 Utdelningsadress 1, folkbokföringsadress<br />

01033 Utdelningsadress 2, folkbokföringsadress<br />

01034 Postnummer, folkbokföringsadress<br />

01035 Postort, folkbokföringsadress<br />

01045 Riksnyckel för fastighet<br />

01046 Riksnyckel för adressplats<br />

01047 Riksnyckel för lägenhet<br />

01051 c/o-adress för särskild postadress; adress<br />

för person med samordningsnummer<br />

01052 Utdelningsadress 1 för särskild postadress;<br />

adress för person med samordningsnummer<br />

01053 Utdelningsadress 2 för särskild postadress;<br />

adress för person med samordningsnummer<br />

01054 Postnummer för särskild postadress; adress<br />

för person med samordningsnummer<br />

01055 Postort för särskild postadress; adress för<br />

peson med samordningsnummer


*<strong>Skatteverket</strong> 70 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

Termkod Aviseringsterm i klartext<br />

01<strong>07</strong>1 Utdelningsadress 1 för utlandsadress<br />

01<strong>07</strong>2 Utdelningsadress 2 för utlandsadress<br />

01<strong>07</strong>3 Utdelningsadress 3 för utlandsadress<br />

01<strong>07</strong>7 Land för utlandsadress<br />

01<strong>07</strong>8 Datum för utlandsadress<br />

01081 Civilstånd, kod<br />

01082 Civilståndsdatum<br />

01091 Födelselän, kod<br />

01092 Födelseförsamling<br />

01093 Födelseort i utlandet<br />

01094 Födelseland<br />

01101 Invandringsdatum<br />

01212 Uppgift om förnamn styrkt<br />

01213 Uppgift om mellannamn styrkt<br />

01214 Uppgift om efternamn styrkt<br />

01293 Uppgift om födelseort i utlandet styrkt<br />

02000 Start av uppgifter om en relationsperson<br />

till huvudpersonen<br />

02001 Personnummer, folkbokförd relationsperson<br />

02002 Födelsetid, aldrig folkbokförd<br />

relationsperson<br />

02003 Typ av relation, kod<br />

02004 Vårdnadsdatum för vårdnadsrelation<br />

02005 Förnamn för aldrig folkbokförd<br />

relationsperson<br />

02006 Mellannamn för aldrig folkbokförd<br />

relationsperson<br />

020<strong>07</strong> Efternamn för aldrig folkbokförd<br />

relationsperson<br />

02010 Avregistreringsorsak för relationsperson<br />

02011 Avregistreringsdatum för relationsperson<br />

02999 Slut på uppgifter om en relationsperson till<br />

huvudpersonen<br />

03000 Start av uppgifter om ett medborgarskap<br />

03001 Medborgarskap, kod<br />

03002 Medborgarskapsdatum<br />

03201 Uppgift om medborgarskap styrkt<br />

03999 Slut på uppgifter om ett medborgarskap<br />

04000 Start av uppgifter om historik (tidigare<br />

folkbokföring)


*<strong>Skatteverket</strong> 71 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

Termkod Aviseringsterm i klartext<br />

04001 Folkbokföringsdatum, historik<br />

04002 Län, historik, kod<br />

04003 Kommun, historik, kod<br />

04004 Församling, historik, kod<br />

04005 Fastighetsbeteckning, historik<br />

04008 Folkbokföringstyp, historik<br />

04999 Slut på uppgifter om historik<br />

För exempel på personposter via Web Service<br />

Personpost se bilaga 6.


*<strong>Skatteverket</strong> 72 (72)<br />

TEKNISK BESKRIVNING<br />

Navet Datum Version<br />

<strong>2012</strong>-<strong>07</strong>-04 3.19<br />

9.3 Postinnehåll Web Service Namnsökning<br />

De poster som erhålls från Web Services Namnsökning<br />

har samma format som den vanliga aviseringen. Till<br />

skillnad från Web Service Personpost kan ingen<br />

kundspecifik inställning göras för de termer som<br />

returneras från Web Service Namnsökning. Det är<br />

alltid en fast mängd termer som erhålls.<br />

Följande termkoder förekommer i Web Service<br />

Namnsökning, motsvarande taggar i XML-format finns<br />

redovisat i kapitel 8.6 Översättningstabell:<br />

Termkod Aviseringsterm i klartext<br />

01001 Personnummer<br />

01002 Tilldelat personnummer/Samordningsnummer<br />

01003 Sekretessmarkering<br />

01011 Tilltalsnamnsmarkering, kod<br />

01012 Förnamn<br />

01013 Mellannamn<br />

01014 Efternamn<br />

01031 c/o-adress, folkbokföringsadress<br />

01032 Utdelningsadress 1, folkbokföringsadress<br />

01033 Utdelningsadress 2, folkbokföringsadress<br />

01034 Postnummer, folkbokföringsadress<br />

01035 Postort, folkbokföringsadress<br />

01051 c/o-adress för särskild postadress; adress<br />

för person med samordningsnummer<br />

01052 Utdelningsadress 1 för särskild postadress;<br />

adress för person med samordningsnummer<br />

01053 Utdelningsadress 2 för särskild postadress;<br />

adress för person med samordningsnummer<br />

01054 Postnummer för särskild postadress; adress<br />

för person med samordningsnummer<br />

01055 Postort för särskild postadress; adress för<br />

peson med samordningsnummer<br />

För exempel på personposter via Web Service<br />

Namnsökning se bilaga 6.

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!