I afsnit 2.1.1 for danske virksomheder og afsnit 2.2.1 for udenlandske virksomheder, nævnes en række tekniske forudsætninger, der er nødvendige for at kunne indberette. I dette bilag bliver disse uddybet.

De tekniske forudsætninger, der bliver nævnt i vejledningen er flg.:

1)    Webservice & URL-opbygning (platformId, filingReference, m.fl.)
2)    Payload - JSON-skema
3)    Angivelse af headere
4)    Brug af certifikat
5)    Brug af unik identifikationskode

Webservice og URL

For at kunne indberette skal I have adgang til Webservice (REST API). 

Webservice (REST API) til indlevering kan tilgås på flg. adresser fordelt på miljø:

Indberetningsformatet skal være dannet på denne URL-syntaks:

<hostnavn>/platforms/<platformId>/years/<paymentYear>/<assetType>-filings/<filingReference>

Dette betyder, at ovenstående adresser er Hostnavn, men at URL’en uanset skal indeholde de fem nedenstående elementer:

Hostnavn: https://api.del.skat.dk

PlatformsID: PlatformsID'et er et ID, der benyttes til at identificere platformen, og som bliver givet af Skatteforvaltningen under onboarding.   

PaymentYear (Betalingsår): Betalingsåret er det år, hvor betalingen er foretaget. 

AssetType (AktivType): AktivTypen er den type aktiv, der er udlejet iflg. indberetningen e.g. bolig, køretøj mv. eller båd. Hvis AktivTypen eksempelvis er "accommodation-filing" i payloaden, skal den samme type indgå i URL'en.  

FilingReference: Platformen giver indberetningen et indberetningsidentifikationsnummer, så sagen har et referencenummer.  

Payload - JSON-skema

Indberetningen sker i JSON-api-formatet og skal overholde JSON valideringskriterier. Læs mere om datastruktur og indberetningsdata i afsnit 3 Foretag indberetning, især afsnit 3.4 Datastruktur

Header

Hver anmodning til API’et skal have følgende to overskrifter:
-    X-Transaktions-ID
-    X-Request-ID
Hvert af disse ID skal være en unik UUIDv4.

Brug af certifikat

Certifikater skal bestilles og registreres. Læs mere for danske virksomheder i afsnit 2.1.2 Bestil virksomhedscertifikat til indberetning, afsnit 2.1.3 Bestil testcertifikat og afsnit 2.1.4 Tildeling af rettigheder og roller.
Læs mere for udenlandske virksomheder i afsnit 2.2.2 Bestil "Extended validation certificate" (EVSSL), afsnit 2.2.3 Bestil certifikat til test og afsnit 2.2.4 Registrér EVSSL-certifikater.

Brug af unik identifikationskode

I skal på alle indberetninger benytte udlejers unikke identifikationskode og aldrig cpr-nr. Læs mere om den unikke identifikationskode i bilag 5 - Vejledning om overførelse af udlejers unikke identifikationskode. I nævnte bilag kan I læse mere om flowet og implementering af den redirect på jeres platform, hvor udlejeren bliver videresendt til TastSelv Borger (TSB).