Asynkrone services er services, hvor der bestilles større datamængder til senere afhentning for en kendt kreds af Indkomstmodtagere eller Indkomstudbetalere.

Link til alle webservices (efter TIN): https://eksternwiki.skat.dk/eindkomst2

Udstilling af indkomstoplysninger sker via følgende asynkrone (bestilling af leverance) services:

Webservice Forkortelse Du kan få svar på spørgsmål som Format

IndkomstOplysningPersonAbonnentBestil

 IOPAB

Hvilke indkomstoplysninger har en eller flere fysiske personer?

Fladfil via MQ

IndkomstOplysningVirksomhedAbonnentBestil

 IOVAB

Hvilke indkomstoplysninger har en eller flere indberetningspligtige (lønudbetalere) indberettet for en eller flere juridiske personer?

Fladfil via MQ

IndkomstOplysningPersonAdvisBestil

 IOPAD Servicen anvendes ifm. IndkomstOplysningPersonAbonnementAjourfør.

OIOXML

SKATXML

Fladfil via MQ

IndkomstOplysningSumAbonnentBestil

 IOSAB

Hvilke summerede oplysninger har en eller flere fysiske eller juridiske personer eller for en eller flere indberetningspligtige for angiven søgeperiode?

Fladfil via MQ

IndkomstOplysningPersonTidAbonnentBestil

 IOTAB

Hvilke indkomstoplysninger har en eller flere fysiske personer for angiven søgeperiode?

OIOXML

Fladfil via MQ

  

Asynkrone webservices består af tre metoder

Asynkrone services indeholder tre metoder. Hver metode er et synkront servicekald. Asynkrone bestillinger af oplysninger afvikles året rundt, døgnet rundt. Afviklingen af asynkrone bestillinger har i Business Hours lavere prioritet end synkrone services.

Når der integreres til en asynkron service, gælder integrationen alle tre metoder:

  1. Bestilling. Databehandler bestiller oplysninger. Der kvitteres synkront med et bestillingsnummer.

  2. BestillingHent. Databehandler henter synkront bestilte oplysninger. Response er komprimeret via GZIP.

  3. BestillingModtaget. Databehandler kvitterer for modtagelse af de bestilte oplysninger, hvorefter 'pakken' med bestilte oplysninger slettes.

De asynkrone services består hver af tre metoder med synkront svar.

Nedenstående beskriver de tre metoder fra IndkomstOplysningKlassiskAbonnentHent og gælder, medmindre andet fremgår for alle asynkrone services.

1. Bestilling af leverance

IndkomstOplysningPersonAbonnentBestilt_I_I:

Elementet AbonnentBestillingCallBackReference er optionelt, men skal angives, da servicekald ellers fejler.

IndkomstOplysningPersonAbonnentBestilt _I_O:

Der kvitteres med en nøgle for den afgivne bestilling (AbonnentBestillingIdentifikator). Nøglen skal bruges ved hentning af og kvittering for modtagelse af bestillingen.

2. BestillingHent

IndkomstOplysningPersonAbonnentBestilt _O_I:

Der kan "polles" på grundlag af AbonnentBestillingIdentifikator.

Se tillige afsnittet 'Hentning af og kvittering for modtaget leverance' og 'GZip af response'.

IndkomstOplysningPersonAbonnentBestilt_O_O:

Responce leveres som en fil med formatet GZip.

3. BestillingModtaget

IndkomstOplysningPersonAbonnentBestilt _OK_I:

Når en leverance er hentet, skal der i umiddelbar forlængelse heraf kvitteres for leverancen. Se afsnittet 'Hentning af og kvittering for modtaget leverance'.

IndkomstOplysningPersonAbonnentBestilt _OK_O

 

Asynkrone services er services, hvor der bestilles oplysninger til senere afhentning for en kendt kreds af Indkomstmodtagere eller Indkomstudbetalere. Asynkrone services indeholder tre metoder. Hver metode er et synkront servicekald. Asynkrone bestillinger af oplysninger afvikles året rundt, døgnet rundt. Afviklingen af asynkrone bestillinger har i Business Hours lavere prioritet end synkrone services.

Når der integreres til en asynkron service, gælder integrationen alle tre metoder:

  1. Bestilling - Databehandler bestiller oplysninger. Der kvitteres synkront med et bestillingsnummer.

  2. BestillingHent - Databehandler henter synkront bestilte oplysninger. Response er komprimeret via GZIP.

  3. BestillingModtaget - Databehandler kvitterer for modtagelse af de bestilte oplysninger, hvorefter 'pakken' med bestilte oplysninger slettes.

De asynkrone services består hver af tre metoder med synkront svar.

Nedenstående beskriver de tre metoder fra IndkomstOplysningKlassiskAbonnentHent og gælder, medmindre andet fremgår for alle asynkrone services.

Bestilling af leverance

IndkomstOplysningPersonAbonnentBestilt_I_I:

Elementet AbonnentBestillingCallBackReference er optionelt, men skal angives, da servicekald ellers fejler.

IndkomstOplysningPersonAbonnentBestilt _I_O:

Der kvitteres med en nøgle for den afgivne bestilling (AbonnentBestillingIdentifikator). Nøglen skal bruges ved hentning af og kvittering for modtagelse af bestillingen.

BestillingHent

IndkomstOplysningPersonAbonnentBestilt _O_I:

Der kan "polles" på grundlag af AbonnentBestillingIdentifikator.

Se tillige afsnittet "Hentning af og kvittering for modtaget leverance" og "GZip af response".

IndkomstOplysningPersonAbonnentBestilt_O_O:

Responce leveres som en fil med formatet GZip.

BestillingModtaget

IndkomstOplysningPersonAbonnentBestilt _OK_I:

Når en leverance er hentet, skal der i umiddelbar forlængelse heraf kvitteres for leverancen. Se afsnittet "Hentning af og kvittering for modtaget leverance".

IndkomstOplysningPersonAbonnentBestilt _OK_O

Hentning af og kvittering for modtaget leverance

Metoderne "BestillingHent" og "BestillingModtaget"

Følgende information skal benyttes af "BestillingHent" og "BestillingModtaget" services:

  • AbonnentBestillingIdentifikator
  • AbonnentTypeKode
  • AbonnementTypeKode
  • AdgangFormålTypeKode

I servicekaldet til "BestillingHent" og "BestillingModtaget" indlægges herudover følgende i requestens header. Dette gælder både for OIOXML og SKATXML:

 

Det er alene , der skal udfyldes med cvr-nummer fra det anvendte virksomhedscertifikat. Udfyldes cvr-nummer ikke korrekt, sker der afvisning.

GZip af response (BestillingHent for services med ordet 'Bestil' eller 'Klassisk' i navn)

Abonnenten skal i accept-headers angive, at response skal gzippes (Angives dette ikke, bliver resultat leveret unzippet).

For response af typen gzip, sættes følgende header:

  • Accept-Encoding" lig "gzip