ABONNEMENT Webservicen udstiller indkomstoplysninger for en fysisk person identificeret med dansk CPR-nummer. Webservicen stiller indkomstoplysninger til rådighed for myndigheder og andre, som iht. eIndkomstlovens § 7 stk. 1, jf. § 15 stk. 1 i eIndkomstbekendtgørelsen, kan anvende oplysninger fra indkomstregistret. Anvendelsen af webservicen er betinget af, at de pågældende har indgået en abonnementsaftale med told- og skatteforvaltningen herom, jf. § 7 stk. 4 i lov om et indkomstregister. Webservicen kan alene anvendes af kendte brugere, dvs. af de myndigheder m.fl., som har indgået abonnementsaftale om adgang. Servicen kan give adgang til alle indkomstoplysninger eller en begrænset mængde af indkomstoplysninger afhængig af abonnent. De oplysninger, som en abonnent ikke har adgang til, filtreres fra (fjernes før udstilling til abonnenten) på grundlag af oplysning om abonnent, abonnement og anvendelsesformål. Servicen kan anvendes til præsentation af oplysninger via en brugergrænseflade for en sagsbehandler eller selvbetjeningsløsning til borgere. Begrænsning i kredsen af indkomstmodtagere, som der stilles oplysninger til rådighed for, sker hos den enkelte abonnent og fastlægges individuelt med abonnenten i den aftale, der skal indgås iht. lov og bekendtgørelse. Eksempelvis begrænser servicen ikke adgangen for en kommune til alene at omfatte de borgere, som bor i kommunen. Denne begrænsning skal ske hos kommunen. Indkomstoplysninger stilles til rådighed ubearbejdet (rå data) som de er indberettet. Eventuel tolkning, sammenstilling, summering o. lign. af indkomstoplysninger sker hos den, som har adgang til indkomstoplysninger på grundlag af den lovgivning, som gælder for området. Indkomstoplysninger, som er tilbageført stilles også til rådighed. SØGEPERIODE Der kan alene hentes indkomstoplysninger ved angivelse af en søgeperiode til det angivne CPR-nr. Søgeperioden angiver det tidsinterval, som indberetninger af indkomstoplysninger er offentliggjort i til myndigheder og andre. Det er alene søgeperioden, der sammen med CPR-nr. og abonnementsaftalen afgør hvilke indkomstoplysninger, der returneres. Der kan således returneres indkomstoplysninger, som vedrører lønperioder fra før den forespurgte indberetningsperiode. Der kan også forekomme indberetninger af fremtidig karakter, dvs. som vedrører en lønperiode efter den angivne søgeperiode. Eksempelvis kan der forekomme tilbageførsler af indberetninger, hvor selve indberetningen ikke er en del af resultatet på forespørgslen. Sluttidspunkt for søgeperioden må ikke være fremtidig. SøgeDatoTidFra returnerer indkomstoplysninger, hvis offentliggørelsestidspunkt er større end (stoerre end) det angivne tidspunkt. SøgeDatoTidTil returnerer indkomstoplysninger, hvis offentliggørelsestidspunkt er mindre end eller lig (mindre end=) det angivne tidspunkt. Når der søges med dato tid, er der risiko for, at der indkomstoplysninger på vej til offentliggørelse med et tidspunkt, som ligger før den i requesten angivne SøgeDatoTidTil. Det er ikke muligt med sikkerhed at definere, hvor lang tid før aktuel tid en SøgeDatoTidTil må være. Det er således nødvendigt pr. CPR-nr. at tage højde for dette ved at returnere den dato og tid, der skal angives ved næste søgning af indkomstoplysninger for et CPR-nr. for at sikre at der ikke opstår 'huller' eller 'dubletter' i fremsøgte indkomstoplysninger. Elementet navngives NySøgeDatoTidFra. Værdien af NySøgeDatoTidFra for et CPR-nr. skal således anvendes som SøgeDatoTidFra ved næste søgning på indkomstoplysninger. KOMPRIMERING Servicen kan returnerer store datamængder, og data bliver derfor pakket på vej ud af SKAT. Mere konkret bliver IndkomstOplysningPersonStruktur pakket med ZIP, base64 encoded og lagt i feltet PakkeStrukturBase64. Modtager systemer har mulighed for at inverterer denne handling og har desuden muligt for at validere servicen både pakket og udpakket. LOGNING En myndigheds (abonnents) anmodning om adgang til oplysninger kan udstilles til den, som oplysningerne vedrører, eksempelvis via Skattemappen for personer. Om der sker udstilling fastlægges i abonnementsaftalen for hver abonnent for hvert adgangsformål. Der stilles ikke oplysninger til rådighed, hvis der ikke kan ske logning af adgangen. NySøgeDatoTidFra Feltet vil altid være angivet som en Zulu tid (bliver også kaldt Den Internationale tid UTC). Der returneres altid med værdifelt.
1.0
r25283