Servicebeskrivelse
Servicebeskrivelse
Servicebeskrivelse
|
||||
Momsangivelser |
||||
System: |
Encyclopedia: |
Version: |
Oprettet: |
Ændret: |
"GUL DP API" |
GUL |
2018-12-19 |
2020-06-13 |
|
Formål: |
||||
Formålet med servicen er at levere udvalgte data for en liste af momsangivelser om én til flere virksomheder. Serviceanvender skal ved hjælp af en aftale i DUPLA Aftalemodul specificere de nødvendige felter, i forhold til det konkrete anvendelsesformål. Servicen returnerer udelukkende de felter til serviceanvender, som er specificeret i denne aftale. |
||||
Overordnet beskrivelse af funktionalitet: |
||||
Servicen er baseret på REST og modtager et GET Request med query parameters til at specificere output. Data er repræsenteret som JSON og til servicen findes der en OpenAPI-specifikation. Komplethed Der udstilles på nuværende tidspunkt kun de felter, der har været et konkret behov for. Nye felter kan løbende tilføjes.
Korrekthed Der udstilles kun godkendte momsangivelser, men en gyldig momsangivelse kan på et senere tidspunkt erstattes af en ny momsangivelse som betyder, at den tidligere momsangivelse ikke længere er gyldig. En momsangivelse er som udgangspunkt baseret på indsamlede data kombineret med oplysninger fra borgerne.
Aktualitet Vær opmærksom på, at der går tid fra at der rettes i data, der ligger til grund for momsangivelsen, til der dannes en ny gyldig momsangivelse i D/R-systemet, og der yderligere kan gå op til en dag før den gyldige momsangivelse bliver tilgængelig via denne service.
Historik I tabellen herunder er det anskueliggjort, Hvilke dataelementer der er tilføjet til de forskellige versioner, samt hvilke anvendere, der benytter sig af de forskellige dataelementer.
Til version 1.0 er tilføjet: AfregningPeriodeForholdPeriodeStartDato (til STAR/a-kasser) AfregningPeriodeForholdPeriodeSlutDato (til STAR/a-kasser) AfregningPeriodeForholdUnderkontoArtKode (til STAR/a-kasser) MomsAngivelseKøbsMomsBeløb (til STAR/a-kasser) MomsAngivelseSalgsMomsBeløb (til STAR/a-kasser) MomsAngivelseMomsEUKøbBeløb (til STAR/a-kasser) MomsAngivelseMomsEUYdelserBeløb (til STAR/a-kasser) UdstillingRegistreringFra (til STAR/a-kasser) UdstillingRegistreringTidspunkt (til STAR/a-kasser) UdstillingRegistreringTil (til STAR/a-kasser) VirksomhedSENummer (til STAR/a-kasser) AngivelseTilsvar (til STAR/a-kasser) AngivelseLøbenummer (til STAR/a-kasser) AngivelseTransaktionsart (til STAR/a-kasser) MomsAngivelseOlieAfgiftBeløb (til STAR/a-kasser) MomsAngiveseElAfgiftBeløb (til STAR/a-kasser) MomsAngivelseGasAfgiftBeløb (til STAR/a-kasser) MomsAngivelseKulAfgiftBeløb (til STAR/a-kasser) MomsAngivelseCO2AfgiftBeløb (til STAR/a-kasser) MomsAngivelseVandAfgiftBeløb (til STAR/a-kasser) |
||||
Datastrukturer |
||||
Input: |
||||
MomsangivelseHent_I |
||||
*QueryParameters* [ *VirksomhedSENummerListe* 1{ VirksomhedSENummer } AfregningPeriodeForholdPeriodeStartDato AfregningPeriodeForholdPeriodeSlutDato (AngivelseGyldigFra) (AngivelseGyldigTil) (UdstillingRegistreringFra) (UdstillingRegistreringTil) ] |
||||
Servicen kræver en liste af VirksomhedSENumre, og returnerer en liste af samlede momsangivelser, der hver især dækker en afregningsperiode. Det betyder, at der kan være flere samlede momsangivelser for ét SENummer. Der skal angives en afregningsperiode, og der kan desudem defineres en periode ved at bruge UdstillingRegistreringFra og/eller UdstillingRegistreringTil, som vil resultere i, at der kun leveres de momsangivelser, som er registreret som udstillet på DUPLA og dermed gjort tilgængelig for serviceanvenderne. Dette kan fx bruges til at hente momsangivelser, der er blevet tilgængelige siden der sidst blev forespurgt på løsningen, ved at udfylde UdstillingRegistreringFra med tidspunktet der sidst blev forespurgt. Her skal man dog være opmærksom på, at leverancen skal samstilles med tidligere hentet data, hvis der skal være et samlet overblik over en samlet momsangivelse for en periode. |
||||
Output: |
||||
MomsangivelseHent_O |
||||
*SamletMomsangivelseListe* 0{ VirksomhedSENummer ( * AfregningPeriode * [ (AfregningPeriodeForholdPeriodeStartDato) (AfregningPeriodeForholdPeriodeSlutDato)
] ) *MomsangivelseListe* 0{ UdstillingRegistreringTidspunkt AngivelseLøbenummer (AngivelseGyldigFra) (AngivelseGyldigTil) AngivelseTransaktionsart (AfregningPeriodeForholdUnderkontoArtKode) ( *SalgsMoms* [ (MomsAngivelseSalgsMomsBeløb) (MomsAngivelseMomsEUKøbBeløb) (MomsAngivelseMomsEUYdelserBeløb)
] ) ( *KøbsMoms* [ (MomsAngivelseKøbsMomsBeløb) (MomsAngivelseOlieAfgiftBeløb) (MomsAngiveseElAfgiftBeløb) (MomsAngivelseGasAfgiftBeløb) (MomsAngivelseKulAfgiftBeløb) (MomsAngivelseCO2AfgiftBeløb) (MomsAngivelseVandAfgiftBeløb) ] ) (AngivelseTilsvar) ( *SupplerendeOplysninger* [ (SupplerendeOplysningerVarekøbEUVærdi) (SupplerendeOplysningerYdelseskøbEUVærdi) (SupplerendeOplysningerVaresalgEUVærdi) (SupplerendeOplysningerVaresalgEUVærdiUdenIndberetning) (SupplerendeOplysningerYdelsessalgEUVærdi) (SupplerendeOplysningerAndreVarerYdelserVærdi) ] ) } } |
||||
Fejlkoder: - 422.1 VirksomhedSENummer i input er angivet i forkert format. - 422.3 VirksomhedSENummer i input overstiger det maksimalt tilladte. - 422.4 UdstillingRegistreringFra er angivet i forkert format. - 422.5 UdstillingRegistreringFra er efter UdstillingRegistreringTil. - 422.6 UdstillingRegistreringTil er angivet i forkert format. - 422.7 AfregningPeriodeForholdPeriodeStartDato er angivet i forkert format. - 422.9 AfregningPeriodeForholdPeriodeSlutDato er angivet i forkert format. - 422.11 AfregningPeriodeForholdPeriodeStartDato er efter AfregningPeriodeForholdPeriodeSlutDato. - 422.12 AngivelseGyldigFra er angivet i forkert format. - 422.13 AngivelseGyldigFra er efter AngivelseGyldigTil. - 422.14 AngivelseGyldigTil er angivet i forkert format. |
||||
Referencer fra use case(s) |
||||
|
||||
Tekniske krav |
||||
Sikkerhed Der er krav om tovejs TLS med OCES-certifikat samt et gyldigt aftaleID. Aftaler oprettes i Dataudvekslingsplatformen, og certifikatet skal tildeles Aktør.Aftager-system.PRG i DCS.
Yderligere er det et krav, at alle forespørgsler ledsages af RequestID og TransaktionID.
Der må fra servicen kun hentes data nødvendigt for aktuelle sager i henhold til aftalen, og der må kun hentes den nødvendige data der skal bruges til sagen. Data må ikke efterfølgende genbruges til andre formål, og må alene gemmes til at dokumentere rigtigheden af en afgørelse, eller i forbindelse med aktindsigt. Information fra servicen må kun gemmes så længe lovgivning vedrørende logning, aktindsigt eller klagesager tillader det, i forhold til det formål informationer er hentet til.
Versionering Til versionering af servicen bruges der semantisk versionering. Major og minor defineres af informationsarkitekten mens patch defineres af udvikleren. Det giver udvikleren mulighed for at lave fejlrettelser, der ikke kræver ændringer til specifikationen. En wordrapport indeholder derfor kun major- og minor-versionsnummer, mens Open API-specifikationen indeholder det fulde versionsnummer. Første major-version defineres når den første anvender har gennemført acceptancetest. Efterfølgende vil alle ændringer til specifikationen, der bryder med bagudkompatibilitet, resultere i en ny major-release. |
||||
Dataelementer
Dataelement |
Datatype |
Beskrivelse/værdisæt |
AfregningPeriodeForholdPeriodeSlutDato |
base: date |
Angiver slutdato for en periode.
|
AfregningPeriodeForholdPeriodeStartDato |
base: date |
Angiver startdato for en periode.
|
AfregningPeriodeForholdUnderkontoArtKode |
base: integer totalDigits: 3 pattern: [0-9]{3} |
Angiver typen af afregning, f.eks. månedlig, kvartal osv
Første ciffer angiver angivelsestypen, f.eks. er 9 = Moms, 7 = Lønsum og 2 = A-skat Koden vil altid for momsangivelser ligge mellem 900-999, og have følgende værdier: 900 - Kvartalsafregning 901 - Månedsafregning 908 - Kreditbegrænsning, obligatorisk ordning 916 - 1/2 årafregning 940 - Angivelser fra for sent registrerede virksomheder 945 - Virksomheder i betalingsstandsning 950 - Efterangivelser dækkende et eller del af et regnskabsår 960 - Efterangivelser dækkende flere regnskabsår 970 - Efterangivelse fra en kvartalsafregnende momsvirksomhed 971 - Efterangivelse fra en månedsafregnende momsvirksomhed 978 - Efterangivelse kreditbegrænset by 985 - Efterangivelse fra for sent registrerede virksomheder 986 - Efterangivelse for kreditbegrænset land
Grundlæggende værdisæt: 001-999
|
AngivelseGyldigFra |
base: dateTime totalDigits: 14 |
AngivelseGyldigFra skal ses i sammenhæng med AngivelseGyldigTil, og siger hvornår en momsangivelse er gyldig, og dermed ikke er korrigeret af anden momsangivelse.
|
AngivelseGyldigTil |
base: dateTime totalDigits: 14 |
AngivelseGyldigTil skal ses i sammenhæng med AngivelseGyldigFra, og siger hvornår en momsangivelse er gyldig, og dermed ikke er korrigeret af anden momsangivelse.
|
AngivelseLøbenummer |
base: integer totalDigits: 18 maxInclusive: 999999999999999999 minInclusive: 1 |
Angiver fortløbende nummering ved flere versioner af en momsangivelse.
|
AngivelseTilsvar |
base: integer totalDigits: 13 fractionDigits: 0 maxInclusive: 9999999999999 minInclusive: -9999999999999 |
Angivelsens samlede beløb, som der dannes en fordring på til opkrævning/udbetaling, eller det beregnede beløb for en Foreløbig Fastsættelse (FF)
|
AngivelseTransaktionsart |
base: string maxLength: 10 |
Kode som angiver, hvordan en momsangivelse er angivet.
Koderne kan være følgende:
(null) 20805 - Benyttes til at rette baser ifb rapporter 51166 - Opdatering af fordring, som ikke påvirker regnskabskonti. 52406 - Gebyr oprettet i forbindelse med udskrivning af FF. 54018 - Sletning af anmodning om fremskyndet tilbagebetaling af energiafgift. 69100 - Beregnet FF 74362 - Momsangivelse 0/positiv uden beregn afgfh. 74364 - Efterangivelse - pos. 74365 - Efterangivelse - neg. 74368 - Momsangivelse - neg. uden beregn afgfh. 74370 - Korrektionsangivelse 74375 - Sletning af momsangivelse pos. 74376 - Sletning af momsangivelse negativ 74378 - Fremskyndet tilbagebetaling af energiafgift 74382 - Indsættelse/ændring af FF 90200 - Momsangivelse skannet hos BG-bank 90300 - Momsangivelse modtaget via internettet 90350 - Negativ momsangivelse modtaget via internettet 90370 - Korrektionsangivelse - NTSE 90373 - Efterangivelse - pos. - NTSE 90374 - Efterangivelse - neg. - NTSE
|
MomsAngivelseCO2AfgiftBeløb |
base: integer totalDigits: 13 fractionDigits: 0 maxInclusive: 9999999999999 minInclusive: -9999999999999 |
Godtgørelse af CO2-afgift på energiafgiftspligtige produkter, som fx mineralolier, gas og kul.
|
MomsAngivelseGasAfgiftBeløb |
base: integer totalDigits: 13 fractionDigits: 0 maxInclusive: 9999999999999 minInclusive: -9999999999999 |
Godtgørelse af gasafgift på fx naturgas, biogas og bygas.
|
MomsAngivelseKulAfgiftBeløb |
base: integer totalDigits: 13 fractionDigits: 0 maxInclusive: 9999999999999 minInclusive: -9999999999999 |
Godtgørelse af kulafgift på fx stenkul, brunkul og koks mv.
|
MomsAngivelseKøbsMomsBeløb |
base: integer totalDigits: 13 fractionDigits: 0 maxInclusive: 9999999999999 minInclusive: -9999999999999 |
Indgående Afgift
|
MomsAngivelseMomsEUKøbBeløb |
base: integer totalDigits: 13 fractionDigits: 0 maxInclusive: 9999999999999 minInclusive: -9999999999999 |
Moms af EU-varekøb
|
MomsAngivelseMomsEUYdelserBeløb |
base: integer totalDigits: 13 fractionDigits: 0 maxInclusive: 9999999999999 minInclusive: -9999999999999 |
Moms af ydelseskøb i udlandet (byggeydelser og arbejdsudleje)
|
MomsAngivelseOlieAfgiftBeløb |
base: integer totalDigits: 13 fractionDigits: 0 maxInclusive: 9999999999999 minInclusive: -9999999999999 |
Godtgørelse af mineralolieafgift på fx benzin, bioolie, dieselolie, fuelolie, gasolie mv.
|
MomsAngivelseSalgsMomsBeløb |
base: integer totalDigits: 13 fractionDigits: 0 maxInclusive: 9999999999999 minInclusive: -9999999999999 |
Udgående afgift
|
MomsAngivelseVandAfgiftBeløb |
base: integer totalDigits: 13 fractionDigits: 0 maxInclusive: 9999999999999 minInclusive: -9999999999999 |
Godtgørelse af vandafgiften på en virksomheds vandforbrug, inkl. drikkevandsbeskyttelsesbidraget.
|
MomsAngiveseElAfgiftBeløb |
base: integer totalDigits: 13 fractionDigits: 0 maxInclusive: 9999999999999 minInclusive: -9999999999999 |
El-afgift
|
SupplerendeOplysningerAndreVarerYdelserVærdi |
base: integer totalDigits: 13 fractionDigits: 0 maxInclusive: 9999999999999 minInclusive: -9999999999999 |
Rubrik C:
Værdien af andre varer og ydelser, der leveres uden afgift i Danmark, i andre EU-lande og i lande uden for EU.
|
SupplerendeOplysningerVarekøbEUVærdi |
base: integer totalDigits: 13 fractionDigits: 0 maxInclusive: 9999999999999 minInclusive: -9999999999999 |
Rubrik A - varer:
Værdien uden moms af varekøb i andre EU-lande (EU-erhvervelser).
|
SupplerendeOplysningerVaresalgEUVærdi |
base: integer totalDigits: 13 fractionDigits: 0 maxInclusive: 9999999999999 minInclusive: -9999999999999 |
Rubrik B - varer:
Værdien af varesalg uden moms til andre EU-lande. Indberettes til EU-salg uden moms.
|
SupplerendeOplysningerVaresalgEUVærdiUdenIndberetning |
base: integer totalDigits: 11 fractionDigits: 0 maxInclusive: 99999999999 minInclusive: 0 |
Rubrik B - varer:
Værdien af fx installation og montage, fjernsalg og nye transportmidler til ikke-momsregistrerede til andre EU-lande. Indberettes ikke til EU-salg uden moms.
|
SupplerendeOplysningerYdelseskøbEUVærdi |
base: integer totalDigits: 13 fractionDigits: 0 maxInclusive: 9999999999999 minInclusive: -9999999999999 |
Rubrik A - ydelser:
Værdien uden moms af ydelseskøb i andre EU-lande.
|
SupplerendeOplysningerYdelsessalgEUVærdi |
base: integer totalDigits: 13 fractionDigits: 0 maxInclusive: 9999999999999 minInclusive: -9999999999999 |
Rubrik B - ydelser:
Værdien af visse ydelsessalg uden moms til andre EU-lande. Indberettes til EU-salg uden moms.
|
UdstillingRegistreringFra |
base: dateTime whitespace: collapse |
Angiver det tidspunkt, data tidligst må være registreret i udstillingsløsningen. Benyttes til udsøgning af ny/opdateret data.
|
UdstillingRegistreringTidspunkt |
base: dateTime whitespace: collapse |
Angiver det tidspunkt, data er registreret i udstillingsløsningen
|
UdstillingRegistreringTil |
base: dateTime whitespace: collapse |
Angiver det tidspunkt, data senest må være registreret i udstillingsløsningen. Benyttes til udsøgning af ny/opdateret data.
|
VirksomhedSENummer |
base: integer totalDigits: 8 pattern: [0-9]{8} |
8-cifret nummer, der entydigt identificerer en registreret virksomhed i SKAT.
|
13. juni 2020 Momsangivelser Side 3 af 7