Faktablad: Årsopgørelser

Servicen kræver en liste af IndkomstÅr og returnerer de i dataudvekslingsaftalen specificerede data fra den gældende årsopgørelse, for de udvalgte IndkomstÅr og for de eventuelt udvalgte PersonCPRNummer.

Hvis der kaldes med SelvstændigVirksomhedOverskudFra og/eller SelvstændigVirksomhedOverskudTil, returneres kun personer, der er registreret med et beløb, som ligger indenfor intervallet.

Med udgangspunkt i DIGST Fælles Retningslinjer for webservices R19, R21 og R22 er der yderligere søgeparametre, som kan benyttes.

Der kan defineres en periode ved at bruge UdstillingRegistreringFra og/eller UdstillingRegistreringTil, som vil resultere i, at der kun leveres årsopgørelser der i den periode, er registreret som udstillet på DUPLA og dermed gjort tilgængelig for serviceanvenderne. Dette kan fx bruges til at hente årsopgørelser, der er blevet tilgængelige siden der sidst blev forespurgt på løsningen, ved at udfylde UdstillingRegistreringFra med tidspunktet der sidst blev forespurgt.

Som udgangspunkt leveres kun aktuelle årsopgørelser, men ved brug af ÅrsopgørelseGyldigFra og/eller ÅrsopgørelseGyldigTil kan der defineres en periode, som vil resultere i at servicen leverer alle årsopgørelser, som har en gyldighedsperiode der helt eller delvist overlapper med denne periode.

En given årsopgørelse med tilhørende ÅrsopgørelseOpgørelseNummer ændres ikke med den undtagelse, at der tilføjes en ÅrsopgørelseGyldigTil, hvis der dannes en ny årsopgørelse for det aktuelle IndkomstÅr, som gør at denne årsopgørelse ikke længere er den gældende. Det er altså muligt at se om en årsopgørelse er den gældende årsopgørelse for den aktuelle person i det specifikke år, ved at se om ÅrsopgørelseGyldigTil er sat.Vær opmærksom på, at en ny årsopgørelse ikke nødvendigvis resulterer i synlige ændringer, da aftalen specificeret i aftalemodulet ikke nødvendigvis omfatter de felter som er påvirkede.