Teknisk beskrivning 2012-07-24 - Skatteverket
Teknisk beskrivning 2012-07-24 - Skatteverket
Teknisk beskrivning 2012-07-24 - Skatteverket
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.