Der er forskellige header-informationer, der skal bruges ved kald til løsningen.
Alle B2B snitflade services har altid følgende parametre i kaldet:
x-Aktiesparekontoreference
Referencen kan enten være filnavn eller anvendt transaktions-id. Anvendes filnavn, skal filnavnet overholde navnekonventionen. Se afsnit 4.1.
x-transaktisons-id
Transaktions id er et unikt universelt transaktionidentifikator, der bruges til at spore en samlet handling på tværs af flere kald og systemer. Transaktions id skal være en UUID version 4, jf. ietf RFC 4122 og skal kunne korreleres med logfiler fra det kaldende system for altid at kunne svare på, hvem der er ansvarlig for den handling, der har resulteret i kaldet.
x-request-id
Request id er et requestidentifikator der bruges til at spore et kald og tilhørende svar. Request id skal være en UUID version 4, jf. ietf RFC 4122.
Content-Type
Udfyldes altid med: application/xml.
Feltet er et teknisk felt og fremgår ikke af Open API specifikationen.
Accept
Udfyldes altid med: */*, fordi DUPLA fejlsvar vil være JSON formateret og Aktiesparekonto selv vælger XML i egne svar.
Feltet er et teknisk felt og fremgår ikke af Open API specifikationen.
UFST-Adgangsgrundlag
Udfyldes altid med: urn:ufst:adgangsgrundlag:rolle:IP.EKAP.Akt\xf8r.Aktiesparekonto_Indberetningspligtig.PRG.
Vær opmærksom på at encoding skal være ISO8859-1. Aktør skal derfor angives derfor som "Akt\xf8r".
Feltet er ikke at finde i Open Api specifikationen, da det er et sikkerhedsfelt og angiver en rollebaseret adgang.
Authorization
Adgangsbilletten fra Billetautomaten angives sammen med de øvrige header informationer for B2B snitflade service kaldet. "Authorization: Bearer ${accesstoken}".
Valgfrit parameter:
x-major-version
Servicen versioneres med Semantisk versionering (Major), hvor kun Major versioner indeholder breaking changes til snitfladen. Som udgangspunkt er der kun adgang til den nyeste version af services på et miljø og det er kunderne såvel som service udstillers opgave at finde fejl på de lavere miljøer før en ny release løftes til produktion. Specifikt for nye Major releases kan der aftales en paralleldrift, hvor den gamle version kan tilgås ved at specificere x-major-version. Hvis der kaldes med en x-major-version som ikke er tilgængelig modtages en fejl. Når x-major-version ikke er udfyldt kaldes den nyeste version automatisk.
Eksempel kald i curl:
curl -L -X POST "https://dataudveksling.skat.dk/b2b/aktiesparekonto-modtagelse/AktiesparekontoMasseIndberetningOpret" --header "x-transaktions-id: ${guidt}" --header "x-request-id: ${guidr}" --header "x-AktiesparekontoReference: ${guidx}" --header "accept: */*" --header "Content-Type: application/xml" --header ' UFST-Adgangsgrundlag: urn:ufst:adgangsgrundlag:rolle:IP.EKAP.Aktør.Aktiesparekonto_Indberetningspligtig.PRG ' --header "Authorization: Bearer ${accesstoken}" -d "@12345678_2024_01-initial-konti1.aktiesparekonto-indberetning.xml"
Fejlkoder og Statuskoder
Evt. fejl og status fremgår af B2B snitflade servicens http status kode, se snitfladebeskrivelse på https://dataudveksling.skat.dk (indtil idriftsættelse af Aktiesparekonto kan snitfladebeskrivelse ses på https://dataudveksling.tfe.skat.dk. Læs hvordan I henter snitfaldebeskrivelse i afsnit 3.2.2.1.
HTTP status under 422 indeholder specifikke fejlkoder fra Aktiesparekonto:
Http 422 svar | Fejltekst |
422.1 | Datafil mangler |
422.2 | Filnavn overholder ikke navnekonvention |
422.3 | SE.nr. i filnavn svarer ikke til den pligtige, der indsendes for. |
422.4 | SE.nr. for indberetter i filen svarer ikke til den, der foretager indberetningen |
422.5 | Årstal i filnavn svarer ikke til årstal (indberetningsperiode) oplyst i filen |
422.6 | Der kan ikke indberettes for angivne periode. |
422.7 | Bruges internt i Skattestyrelsen |
422.8 | Transaktion-id mangler |
422.9 | Request-id mangler |
422.10 | AktiesparekontoReference mangler. |
422.11 | Data kunne ikke findes. |
422.12 | Transaktions-ID er anvendt tidligere. |
422.13 | Filnavn er anvendt tidligere. |
422.14 | Filen kan ikke modtages - kontakt Skatteforvaltningen |
422.15 | Fil indholdet kunne ikke læses |
422.16 | Filen kunne ikke genstartes |
422.17 | Header værdi matcher ikke regex: %s |
422.18 | Der er sket en fejl - kontakt skatteforvaltningen |
422.19 | SE.nr. i Fil indhold svarer ikke til den pligtige, der indsendes for |