Beskrivelse av filformatet for likningsoppgaven tilskudd til vitenskapelig forskning eller yrkesopplæring

Transkript

1 Beskrivelse av filformatet for likningsoppgaven tilskudd til vitenskapelig forskning eller yrkesopplæring Beskrivelsen gjelder likningsoppgaver fra inntektsåret 2013 med første innsending i Versjon desember

2 Innhold 1 Introduksjon Ordliste med sentrale begreper Krav til filvedlegg Pakking av filvedlegg Kryptering av filvedlegg Filnavn Maksimal filstørrelse via Altinn Struktur og format på XML-dokumentet XML Schema Definition Tegnsett UTF Navnerom (Namespace) XML Dokumentstruktur Definerte XSD-Typer Unik identifikasjon av oppgave Korreksjon av oppgaver XML elementbeskrivelser Eksempelfiler Fra gammelt flatfilformat til det nye XML-formatet

3 Endringsoversikt Versjon Dato Beskrivelse av endring Utført av desember 2012 SITS / MAG-prosjektet 1 Introduksjon Dette dokumentet beskriver krav til vedleggsfiler som skal sendes inn ved innrapportering av likningsoppgaver for tilskudd til vitenskapelig forskning eller yrkesopplæring via Altinn. Det forutsettes at filvedleggene er i henhold til de spesifikasjoner skatteetaten her gir for slike filer. Overordnede krav til filene er beskrevet i kapittel 2 og detaljerte formatkrav er beskrevet i kapittel 3. Dette dokumentet beskriver kort innholdet i hvert element i XML-dokumentet. Du vil finne en mer detaljert funksjonell beskrivelse av forventet innhold til de ulike feltene i likningsoppgavene på Skatteetatens internettsider: skatteetaten.no. Målgruppen for dette dokumentet er oppgavegivere og innsendere av likningsoppgaver. 1.1 Ordliste med sentrale begreper Her er noen sentrale ord og begrep benyttet i dette dokumentet beskrevet: Begrep Forklaring UML (Unified Modelling Unified Modeling Language (UML) er en industristandard for Language) datarelatert modellering, forvaltet av et internasjonalt konsortium kalt Object Management Group (OMG). UTF-8 UTF-8 er en standard som definerer et unicode-tegnsett med variabel tegnlengde. Standarden dekker de norske bokstavene og også tegnene i mange av verdens andre språk. De første 128 tegnene av UTF-8 er bakoverkompatibel med US-ASCII-standarden. XML (Extensible Markup Language) XSD (XML Schema Definition) XML er et universelt og utvidbart markeringsspråk. XML er et verktøy for deling av strukturerte data mellom informasjonssystemer, særlig over internett. Filformatet XML organiserer data i en hierarkisk struktur. Formatet er et vanlig tekstformat, leselig for mennesker, der merker ( tagger ), gir informasjon om hva innholdet er. Et XML-format som benyttes til å definere struktur og lovlig innhold for et XML-dokument. XML Schema-dokumentet kan benyttes til å validere et gitt XML-dokument med hensyn til struktur og innholdsformater. 3

4 2 Krav til filvedlegg Her beskrives krav til de filene som skal legges ved som filvedlegg. 2.1 Pakking av filvedlegg Oppgavedata som innsendes (XML-filene) skal pakkes før innsending. Innsender velger selv om flere XML-filer pakkes sammen til en pakket zipfil eller om man velger å pakke hver enkelt XML-fil. Pakket zipfil skal ikke ha katalogstruktur. Prinsippet er vist i figuren under. XML-fil 1 XML-fil 2 XML-fil n Zip-fil Figur 1 : Pakking av (en eller flere) XML filer til en zip-fil Alle filvedlegg skal komprimeres (pakkes) før de lastes opp. Pakking skal utføres i henhold til industristandarden ZIP. Bakgrunnen for pakking er å spare plass ved lagring og overføring. Ved hjelp av et pakkeprogram kan en eller flere filer pakkes sammen til en fil (zipfil). Innholdet blir komprimert slik at størrelsen på filen normalt blir mindre. Ved pakking av XML-filene kan det gi filer som er ned mot % av opprinnelig størrelse. Størrelsen på hver zip-fil må ikke overgå maksimalgrensen for filvedlegg (30MB), se 2.4. Det anbefales at alle XML-filene pakkes til én zip-fil dersom dette ikke gir problemer med maksimal filstørrelse. 4

5 2.2 Kryptering av filvedlegg Filvedlegg skal ikke krypteres. 2.3 Filnavn Filer som sendes inn skal ha unike filnavn innenfor en innsending. Innsender bestemmer selv, utover unike filnavn, hvordan filene som lastes opp navngis. Anbefalt filnavnstandard Skatteetaten anbefaler imidlertid at alle filvedleggene gis et unikt navn på tvers av innsendning og inntektsår slik at samme filnavn aldri forekommer to ganger fra samme innsender. Dette vil lette identifikasjon av filene ved eventuelt problemer både hos innsender og hos skatteetaten. Forslag til navngiving av filer: <Type data>_<oppgaveinnsenders orgnr>_<inntektsår> _<dato_tid(yyyymmddhh24miss)>_<løpenr innenfor dato_tid>.<extension> Eksempel: TilskuddForskningYrkesopplæring_ _2013_ _1.xml Filendelser: Filene som sendes inn skal ha følgende filendelser: XML-filene skal ha filendelsen.xml De pakkede zip-filene skal ha filendelsen.zip. 2.4 Maksimal filstørrelse via Altinn Filene som sendes inn skal være mindre enn 30 MB. Altinn kan per i dag bare motta filer under 30MB (etter pakking til zip). Det er imidlertid mulig å laste opp flere filer slik at samlet størrelse på vedleggene kan overgå denne grensen. 3 Struktur og format på XML-dokumentet 3.1 XML Schema Definition Formatet på XML-dokumentet som skal sendes inn er definert i XML Schema Definition (XSD). For oppgavetypen tilskudd til vitenskapelig forskning eller yrkesopplæring inneholder vedlegget "tilskuddforskningyrkesopplaering<versjon>.xsd" denne definisjonen. Det forutsettes at de XML-filene som innrapporteres validerer mot dette XSD-dokumentet. 3.2 Tegnsett UTF-8 Tegnsettet UTF-8 skal benyttes i kodingen av XML-dokumentet. For å angi at at UTF-8 er benyttet som tegnsett bør følgende ligge i starten av XML-filen: <?xml version="1.0" encoding="utf-8"?> 5

6 3.3 Navnerom (Namespace) Elementet <melding> med alle underliggende typer er definert i navnerommet: xmlns="urn:ske:fastsetting:innsamling:tilskuddforskningyrkesopplaering:v1_0" Referanse til dette navnerommet, samt referanse til standard navnerom for XML-instanser og skjemalokasjon gjøres som attributter på det første elementet i innsendingen; <melding>: <melding xmlns="urn:ske:fastsetting:innsamling:tilskuddforskningyrkesopplaering:v1_0" xmlns:xsi=" xsi:schemalocation="urn:ske:fastsetting:innsamling:tilskuddforskningyrkesopplaering:v1_0 tilskuddforskningyrkesopplaering_v1_0.xsd "> 3.4 XML Dokumentstruktur Diagrammet under er en UML-representasjon av XML-skjemaet og viser strukturen på XMLdokumentet. Diagrammet kan leses på følgende måte: Innsendingen består av et element av type "Melding" (Implementert som elementet <melding> i XML-skjemaet) En Melding består av elementene: <leveranse> (1 eller flere) En Leveranse består av elementene: <oppgavegiver> (obligatorisk) <inntektsaar> (obligatorisk) <oppgavegiversleveransereferanse> (valgfritt) <leveransetype> (obligatorisk) <oppgave> (0 eller flere) <oppgaveoppsummering> (obligatorisk) En Oppgavegiver består av elementene <organisasjonsnummer> (obligatorisk) <organisasjonsnavn> (obligatorisk) <kontaktinformasjon> (valgfritt) En Kontaktinformasjon består av elementene <navn> (obligatorisk) <telefonnummer> (valgfritt) 6

7 <varselepostadresse> (valgfritt) <varselsmsmobiltelefonnummer> (valgfritt) En OppgaveTilskudd består av elementene: <oppgaveeier> (obligatorisk) <beloep> (obligatorisk) En Oppgaveeier består av elementene: Et av følgende identifikatorer for oppgaveeier skal oppgis: <foedselsnummer> (obligatorisk) <organisasjonsnummer> (obligatorisk) <navn> (obligatorisk) En Oppgaveoppsummering består av elementene: <antalloppgaver> (obligatorisk) <sumbeloep> (obligatorisk) Se XML elementbeskrivelser for mer detaljert beskrivelse av hvert element. 3.5 Definerte XSD-Typer XSD-skjemaet definerer typer for alle elementene. De typene som igjen inneholder elementer er definert med complextype, mens de resterende er definert ved simpletype med en standard xml-type som basis. Tekststrenger er definert som xml-type "string" og heltall er definert som xml-type "integer". Hver simpletype definisjon kan igjen ha definerte restriksjoner som ytterliggere innskrenker settet av lovlige verdier Beløpsfelter Alle beløpspostene skal oppgis i hele kroner. Det understrekes at likningsoppgaver skal innberettes, uavhengig av beløpets størrelse. Beløpet skal avrundes til nærmeste hele krone (vanlige avrundingsregler). 3.6 Unik identifikasjon av oppgave En innlevert oppgave identifiseres unikt av oppgavegiver (organisasjonsnummer), inntektsåret og oppgaveeier (fødselsnummer/d-nummer/organisasjonsnummer). 3.7 Korreksjon av oppgaver Ved endring eller sletting av tidligere innrapporterte oppgaver er det viktig at identifikatorfeltene er like som de tilsvarende verdiene i den oppgaven det refereres til Endring En tidligere innsendt oppgave kan korrigeres ved å sende inn en ny oppgave med de korrekte verdiene. Den nye oppgaven vil da erstatte den tidligere innsendte oppgaven Sletting Sletting av en tidligere innsendt oppgave gjøres ved å innrapportere en oppgave med identiske identifikatorfelter som den oppgaven som skal slettes og der beløpsfeltet settes til 0. 7

8 3.8 XML elementbeskrivelser Tabellen under beskriver de ulike elementene (felter) som skal inngå i XML-dokumentet. Første kolonne i tabellen angir hvilken type (complextype) elementet er definert i. Type Element <melding> Melding <leveranse> Leveranse <oppgavegiver> <inntektsaar> Elementsbeskrivelse Innsendingens startpunkt av type "Melding". Elementet <melding> er rot-elementet i XMLdokumentet. En samling oppgaver fra en og samme oppgavegiver, som er levert samtidig. En melding skal bestå av minimum 1 leveranse av type "Leveranse". Institutt som driver vitenskapelig forskning eller yrkesopplæring og som er forhåndsgodkjent av Skatteetaten og dermed har oppgaveplikt. Leveransens oppgavegiver er definert i typen Oppgavegiver. Årstallet som oppgaven/likningen gjelder for. Inntektsåret oppgis med 4 siffer. <oppgavegiversleveransereferanse> En unik referanse til en leveranse som er generert av en gitt oppgavegiver. Oppgavegivers leveransereferanse må være unik for gitt oppgavegiver, inntektsår og oppgavetype. Denne referansen vil stå i kvitteringen fra Skatteetaten og kan benyttes som referanse ved henvendelser. <leveransetype> <oppgave> Elementet er valgfritt. Maks 100 tegn. Angir om leveransen har nye/endrede oppgaver (ordinaer), eller om oppgavegiver ikke har noen oppgaver å rapportere (ingenoppgaver). Lovlige verdier: - ordinaer - ingenoppgaver Sett av oppgaver av type OppgaveTilskudd. Dersom leveransetype er "ingenoppgaver", godtas 0 oppgaver, ellers skal leveransen inneholde minst 1 oppgave. 8

9 Type Element <oppgaveoppsummering> Oppgavegiver <organisasjonsnummer> <organisasjonsnavn> <kontaktinformasjon> Kontaktinformasjon <navn> <telefonnummer> <varselepostadresse> <varselsmsmobiltelefonnummer> OppgaveTilskudd <oppgaveeier> Elementsbeskrivelse Kontrollsummer beregnet på leveransenivå for oppgavene i leveransen. Alle feltene må forekomme (kan ha verdien 0). Se definisjonen av type Oppgaveoppsummering. 9-sifret organisasjonsnummer for oppgavegiveren. Navnet til oppgavegiveren. Maks 100 tegn. Generell kontaktinformasjon for skatteetaten knyttet til innrapportering av denne oppgavetypen. Varsler om meldinger i Altinn vil også bruke denne informasjonen for formidling. Må fylles inn hvis en innsender sender på vegne av flere oppgavegivere, dvs. det sendes flere leveranser. For innsender som kun sender på vegne av seg selv (dvs. innsender = oppgavegiver) vil denne informasjonen være levert i Altinn innsendingsskjema, og kan utelukkes fra filen. Se type Kontaktinformasjon. Navn på oppgavegivers kontaktperson for leveransen. Maks 100 tegn. Telefonnummer der oppgavegivers kontaktperson kan nås. Maks 15 siffer. Epostadresse til oppgavegiver der varsel om melding i altinn (kvitteringer/feilmeldinger) kan sendes. Epostadressen angis på formatet "ola.nordmann@bedrift.no" (anførselstegn skal ikke med) Telefonnummer til oppgavegiver der varsel (SMS) om melding i altinn (kvitteringer/feilmeldinger) kan sendes. Skal bestå av kun tall. I tillegg aksepteres +XX foran for utenlandske numre, der XX er landkode. Maks 15 siffer. Tilskuddsyter som har gitt tilskudd til det godkjente instituttet. Se type Oppgaveeier. 9

10 Type Element <beloep> Oppgaveeier <foedselsnummer> Elementsbeskrivelse Sum tilskuddsbeløp som er gitt av oppgaveeier i løpet av inntektsåret. Oppgavegiver skal oppgi ett summert beløp per oppgaveeier. Beløpet oppgis som et heltall. Oppgaveeiers (gavegivers) fødselsnummer eller d-nummer. Ellevesifret identifikasjonsnummer for personer bosatt i Norge, der de seks første sifrene angir fødselsdato og de fem siste personnummer. <organisasjonsnummer> <navn> Oppgaveoppsummering <antalloppgaver> <sumbeloep> Enten fødselsnummer eller organisasjonsnummer skal oppgis for oppgaveeier. Oppgaveeiers (gavegivers) organisasjonsnummeret dersom oppgaveeier ikke er en person. 9 sifret nummer gitt de som er registrert i Enhetsregisteret. Enten fødselsnummer eller organisasjonsnummer skal oppgis for oppgaveeier. Navnet på oppgaveeier (gavegiver). Valgfri rekkefølge på fornavn og etternavn, men ønsket format er fornavn, mellomnavn og etternavn med blankt tegn imellom hver. Tekststreng på maks 100 tegn. Angir antall oppgaver i leveransen. Sum av alle beløp i tilskuddsoppgavene til en leveranse. Beløpet oppgis som et heltall. 3.9 Eksempelfiler Vedlagt er noen eksempelfiler som kan gi økt forståelse for format og innhold til innrapporteringen. Formål Filnavn Beskrivelse Normal tilskuddforskningyrkesopplae innsending ring_eksempel_ Ingen oppgaver <versjon>.xml tilskuddforskningyrkesopplae ring_eksempel_ingen_oppga ver_<versjon>.xml Et eksempel for normal innsending av nye og endrede oppgaver. Et eksempel som viser hvordan en oppgavegiver kan oppfylle oppgaveplikt uten å ha noen oppgaver å rapportere. 10

11 Formål Filnavn Beskrivelse Sletting tilskuddforskningyrkesopplae ring_eksempel_sletting_<ver sjon>.xml Et eksempel der oppgavegiver nullstiller verdien på tidligere innsendte oppgaver ved å rapportere inn på samme unike nøkkel med 0 i beløpsfelt Fra gammelt flatfilformat til det nye XML-formatet Tabellen under lister de enkelte feltene brukt i det gamle flatfilformatet med feltnummer og feltnavn med knytning til hvilket element i det nye XML-formatet som skal benyttes for denne informasjonen i det nye formatet. Flere av feltene i det gamle recordformatet videreføres ikke i det nye formatet. Dette markeres med "Utgår" i tabellen. For de feltene som har en knytning inn i det nye formatet, så angis dette med type og elementnavn i det nye formatet (<Typenavn> <elementnavn>). Nr Felt i record Kobling til element i nytt XML-format OPPGAVEGIVER-RECORD 1 E06-OPPGAVEGIVER-REC Utgår 2 E06-RECART-1 Utgår 3 E06-RECTYPE-1 Utgår 4 E06-ORGANISASJONSNR-1 Oppgavegiver organisasjonsnummer 5 E06-NAVN Oppgavegiver organisasjonsnavn 6 E06-ADRESSE Utgår 7 E06-POSTSTED Utgår 8 E06-TELEFON Utgår 9 E06-NAVN-KONTAKTPERSON Kontaktinformasjon navn 10 E06-TELEFON-KONTAKTPERSON Kontaktinformasjon telefonnummer 11 E06-INNTEKTSÅR Leveranse inntektsaar 13 E06-DATO-KJØRT Utgår 14 E06-RETTE-KODE Utgår 15 FILLER Utgår PERSON-RECORD 100 E06-PERSON-REC Utgår 101 E06-RECART-5 Utgår 102 E06-RECTYPE-5 Utgår 103 E06-OGANISASJONSNR-5 Utgår (Kun 1 forekomst, se felt4) 104 E06-ID-NR Oppgaveeier foedselsnummer eller Oppgaveeier organisasjonsnummer 105 E06-GAVE-BELØP OppgaveTilskudd beloep 106 E06-GAVE-BELØP-SIGN Utgår 107 FILLER Utgår 108 E06-NAVN Oppgaveeier navn 109 E06-ADRESSE1 Utgår 110 E06-ADRESSE2 Utgår 111 E06-POSTSTED Utgår 112 FILLER Utgår SUM-RECORD 200 E06-SUM-REC Utgår 11

12 Nr Felt i record Kobling til element i nytt XML-format 201 E06-RECART-8 Utgår 202 E06-RECTYPE-8 Utgår 203 E06-ORGANISASJONSNR-8 Utgår (Kun 1 forekomst, se felt4) 204 E06-ANTALL-RECORDS Oppgaveoppsummering antalloppgaver 205 E06-SUM-GAVE-BELØP Oppgaveoppsummering sumbeloep 206 E06-SUM-GAVE-BELØP-SIGN Utgår 207 FILLER Utgår 12