Praktisk information om indberetning via Webservice (REST API)

  1. Indberetning foregår i "Rente REST API". 
    Ved masseindlevering skal masseindleveringsfilen overføres til Skattestyrelsens "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/rente under
    Vælg "Teknisk vejledning og information"
    Se under "Webservice (REST API)

    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 afsnit 9, 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".

Hente konti
Det er muligt at hente en specifik konto eller hente en liste af konti, der allerede er indberettet om. Dette er beskrevet i dokumentationen for "Rente RESTful API".

Nulindberetning
Det er muligt, at indberette en nulindberetning for en given periode, hvis du ikke har noget at indberette om. Dette er beskrevet i dokumentationen for "Rente RESTful API".

Rapport
Det er muligt at hente en rapport for en given indberetningsperiode pr. indberetningstype. Dette er beskrevet i dokumentationen for "Rente RESTful API".

Enkelt- og massevalidering
Det er muligt at validere før du indberetter. Dette er beskrevet i afsnit 8.2.1.