Synkrone webservices anvendes i løsninger med en brugergrænseflade hos abonnenten, hvor sagsbehandler afventer svar fra den anvendte service.
Link til alle webservices (før TIN): https://eksternwiki.skat.dk/eindkomst
Link til alle webservices (efter TIN): https://eksternwiki.skat.dk/eindkomst2
Udstilling af indkomstoplysninger sker via følgende synkrone services:
| Webservice | Forkortelse | Du kan få svar på spørgsmål som | Format |
| IndkomstOplysningPersonHent | IOPH | Hvilke indkomstoplysninger har en eller flere fysiske personer for angiven søgeperiode? | OIOXML SKATXML |
| IndkomstOplysningVirksomhedHent | IOVH | Hvilke indkomstoplysninger har en eller flere juridiske personer for en eller flere indberetningspligtige (lønudbetalere) med angivelse af cvr-nr. eller se-nr. samt søgeperiode? | OIOXML SKATXML |
| AnsættelseForholdPersonHent | AFPH | Hvilke ansættelsesforhold har en eller flere fysiske personer for angiven søgeperiode? | OIOXML SKATXML |
| AnsættelseForholdVirksomhedHent | AFVH | Hvilke ansættelsesoplysninger har en eller flere juridiske personer, der har været ansat for angiven søgeperiode? | OIOXML SKATXML |
| AnsættelseForholdPersonKontroller | AFPEK | Har en eller flere personer været ansat hos angivet cvr-nr. for angiven søgeperiode? | OIOXML SKATXML |
| IndkomstOplysningPersonAbonnementAjourfør | IOPAA | Servicen opretter og ajourfører en kreds af fysiske personer, der abonneres oplysninger om. Personkredsen skal opdateres manuelt af kunden. Webservicen hører til disse tre asynkrone webservices: - IndkomstOplysningPersonAdvisBestil - IndkomstOplysningKlassiskAbonnentHent - AnsættelseForholdKlassiskAbonnentHent | OIOXML SKATXML |
| IndkomstOplysningSumHent | IOSUH | Hvilke summerede indkomstoplysninger har en eller flere fysiske personer for angivet cpr-numre samt basismåned? | OIOXML SKATXML |
| ØkonomiskYdelseBerettigetProcentHent | ØYBPH | Servicen udstiller den procentsats og eventuelle beregningsgrundlag ved udbetaling af økonomiske ydelser til en angiven person. Servicen anvendes af Udbetaling Danmark ifm. børne- og ungeydelse. | OIOXML SKATXML |
| IndkomstOplysningPersonTidHent | IOTIH | Hvilke indkomstoplysninger har en eller flere fysiske personer for angiven søgeperiode? Til forskel fra IndkomstOplysningPersonHent har denne service et ekstra felt NySøgeDatoTidFra, som skal sikre, at der ikke opstår huller eller dubletter i fremsøgte indkomstoplysninger. | OIOXML |
| eSkattekortHent | | Viser øjebliksbillede af eSkattekort. | OIOXML SKATXML |
| OIOAbonnentCVRSENummerRelationHent | | Servicen henter relationer mellem se-nr. og evt. cvr-nr. samt virksomhedstype på grundlag af et se-nr. | OIOXML |
| OIOAbonnentVirksomhedStamOplysningHent | | Servicen henter stamoplysninger for en virksomhed. | OIOXML |
Komprimering af response på synkron service
Synkron service:
- IndkomstOplysningPersonTidHent
Servicen kan returnere store datamængder, og data bliver derfor pakket på vej ud af Udviklings- og Forenklingsstyrelsen i Skatteforvaltningen.
IndkomstOplysningPersonStruktur er pakket med ZIP, base64 encoded og lagt i feltet PakkeStrukturBase64. Hvordan feltet bruges i en service kan også ses i AG25 (databooster).
Modtagers systemer har mulighed for at invertere denne handling og har desuden mulighed for at validere servicen både pakket og unzippet.
eSkattekortHent
Webservicen eSkattekortHent giver et øjeblikbillede af skatteoplysninger og er vejledende oplysninger. eSkattekortHent leverer de data der er registreret på skattekortene.
Der er ikke abonnementsoplysninger tilknyttet brugerne på samme måde som resten af Udstilling. Der er derfor ikke mulighed for via Erhvervssystemet at styre hvilke data fra skattekortet, som den enkelte bruger af servicen får retur.
Derudover er det ikke muligt at rekvirere nye skattekort via eSkattekortHent.
En anvender af servicen kan pt. anvende følgende værdier af eSkattekortRekvisitionTypeKode (eSkattekortTypeKode er eSkattekortRekvisitionTypeKode):
01 = hovedkort
02 = bikort
06 = hovedkort uden lønindeholdelse
07 = bikort uden lønindeholdelse
Hvis der er anvendt: eSkattekortRekvisitionTypeKode = 01 (Hovedkort) så kan svaret indeholde følgende værdier af eSkattekortTypeKode:
0 = Intet skattekort
1 = Bruttokort
2 = Hovedkort
3 = Frikort
eSkattekortRekvisitionTypeKode = 02 (Bikort) så kan svaret indeholde følgende værdier af eSkattekortTypeKode:
0 = Intet skattekort
1 = Bruttokort
3 = Frikort
4 = Bikort
eSkattekortRekvisitionTypeKode = 06 (Hovedkort uden lønindeholdelse) så kan svaret indeholde følgende værdier af eSkattekortTypeKode:
0 = Intet skattekort
3 = Frikort (når aktuelt skattekort er med i Frikortindex og IKKE med i Lønindeholdelsesindex. Både eSkattekortTrækProcent, eSkattekortSærskiltForskudTrækProcent og eSkatteFrikortSaldo vil være udfyldt)
5 = Bruttokort uden lønindeholdelse (når aktuelt skattekort er bruttoskattekort eller når aktuelt skattekort er med i både Frikortindex og Lønindeholdelsesindex. Både eSkattekortTrækProcent og eSkattekortSærskiltForskudTrækProcent vil være udfyldt)
6 = Hovedkort uden lønindeholdelse
eSkattekortRekvisitionTypeKode = 07 (Bikort uden lønindeholdelse) så kan svaret indeholde følgende værdier af eSkattekortTypeKode:
0 = Intet skattekort
3 = Frikort (når aktuelt skattekort er med i Frikortindex og IKKE med i Lønindeholdelsesindex. Både eSkattekortTrækProcent, eSkattekortSærskiltForskudTrækProcent og eSkatteFrikortSaldo vil være udfyldt)
5 = Bruttokort uden lønindeholdelse (når aktuelt skattekort er bruttoskattekort eller når aktuelt skattekort er med i både Frikortindex og Lønindeholdelsesindex. Både eSkattekortTrækProcent og eSkattekortSærskiltForskudTrækProcent vil være udfyldt)
7 = Bikort uden lønindeholdelse
I response svarer webservicen med eSkattekortløbenummer, som er et unikt nr. pr. cpr-nr. og indkomstår.