Praktisk infomation om indberetning via Webservice (REST API)

  1. Indberetning foregår i "Rente REST API". 
    Ved masseindlevering skal masseindleveringsfilen overføres til SKATs "S3 Storage REST API".
    API'erne bruger Semantic Versioning 2.0.0 (http://semver.org/).

    Overstående dokumentation vil løbende blive opdateret og offentliggjort på skat.dk/eKapital
    Vælg "Modernisering af Rente"
    Vælg "Teknisk information"
    Se "Udviklerresurser"

    ►Dokumentationen kan nu downloades som en zip med PDF og HTML udgaver for hver API.◄

  2. XML skemaerne ligger offentligt tilgængelige på https://github.com/skat/rente_schemas Se yderligere beskrivelse i bilag 1.

Fremgangsmåde for indberetning

Enkeltindlevering
Ved enkeltindlevering benyttes "Rente RESTful API" udelukkende, og en indlevering resulterer i et svar fra Rente applikationen. "Rente RESTful API" forholder sig ikke til indholdet af XML'en, men videresender til forretningslaget "XML validering", som tilbagesender en besked igennem "Rente RESTful API.

Masseindleveringer
Ved masseindleveringer skal der først overføres en .zip fil gennem "S3 Storage RESTful API", hvorefter der modtages en sti til filen, som er blevet overført. Dernæst bruges "Rente RESTful API" til at sende en masseindlevering, hvori der som parameter benyttes informationerne fra "S3 Storage RESTful API".

Indberetning kvartal og års-ultimo
Der indberettes enten for pr. kvartal eller for et år. Indlån og Pensiondiverse kan kun indberettes pr. år. Periodedato formatet, der angives ved indberetningen, er beskrevet i "Rente RESTful API".

Kvitteringer og fejlhåndteringer
Som det fremgår i navnet, udstiller Rente og S3 Storage API'er baseret på REST, som er baseret på HTTP protokollen, og derfor vil applikationerne på HTTP niveau levere en kvittering eller fejlbesked i form af standard HTTP Status koder så vidt det er muligt.

Oplysninger om de specifikke status koder der kan modtages, og i hvilken tilfælde disse fremkommer, er dokumenteret i Rente- eller S3 Storage RESTful API.

Status på konti
Det er muligt, at få en status for en konto og for de enkelte indleveringer under en given konto. Dette er beskrevet i dokumentationen for "Rente RESTful API".