Hopp til innhold

Veiledning for utviklere

Skatteetaten-API (DM-39)

Hva MVA-meldingen er, hvem som kan fylle ut og levere den, og hvordan et system får tilgang direkte hos Skatteetaten og i Altinn. Apier sender ikke inn: det Apier tilbyr, er fristene og signaturretten.

Hva er Skatteetaten-API-et (DM-39)?

DM-39 er Skatteetatens skjema for MVA-melding (merverdiavgiftsmelding). Den moderniserte MVA-løsningen tar imot meldingen gjennom Altinn 3: et regnskapssystem validerer og sender inn på vegne av virksomheten gjennom en systembruker virksomheten har godkjent, eller en person med rett rolle leverer den selv i skattemeldingsløsningen. Apier er ikke en del av denne kjeden: Apier validerer ikke, lager ikke utkast og sender ikke inn MVA-meldinger.

Hvem kan fylle ut og levere MVA-meldingen?

Det styres av tilgangspakkene i Altinn Autorisasjon. Tilgangspakken Merverdiavgift, eller Regnskapsfører med signeringsrettighet, gir rett til både å fylle ut og å levere. Regnskapsfører uten signeringsrettighet, Ansvarlig revisor og Revisormedarbeider gir rett til å fylle ut, men ikke til å levere. Pakken Merverdiavgift følger automatisk med registerroller som daglig leder og styrets leder. Hvem som har pakken, er en opplysning virksomheten selv ser i Altinn; Apier leser den ikke.

Får systemet 403 fra Skatteetaten ved levering, er det nesten alltid tilgangspakken som mangler: Hvorfor avvises MVA-meldingen min som uautorisert? går gjennom årsakene steg for steg.

Hvordan får et system tilgang til å levere på vegne av en virksomhet?

Systemleverandøren registrerer systemet sitt i Altinn sitt systemregister og setter opp en Maskinporten-klient hos Digdir med Skatteetatens scopes for MVA-melding. Hver virksomhet oppretter og godkjenner deretter en systembruker for systemet i Altinn, med tilgangspakken Merverdiavgift. Alt dette skjer i virksomhetens og leverandørens eget navn, under Digdirs bruksvilkår for sluttbrukersystemleverandører. Apier formidler ikke Maskinporten eller systembrukere.

Autentiseringslaget er forklart på Maskinporten API, og plattformen på Altinn API.

Hva tilbyr Apier rundt MVA?

Fristene og selskapets registrerte signaturregler. GET /api/v1/company/{org}/deadlines gir MVA-terminene (annenhver måned eller årlig, etter skatteforvaltningsloven § 8-3) beregnet i Europe/Oslo med helgejustering, og GET /api/v1/company/{org}/authority gir selskapets registrerte signaturregler slik registeret har kodet dem, og agenten leser reglene selv. Begge henter åpne registerdata fra Brønnøysundregistrene og trenger verken Maskinporten eller Altinn. Apier tilbyr ikke innsending av MVA-melding; den linjen er satt på vent.

Hvordan håndterer jeg feil?

Alle feil fra Apier følger Compliance Explainer-formatet med error_code, en norsk forklaring og konkrete fix_steps. Endepunktene som før tilbød prøveinnsending av MVA-melding gjennom Apier svarer nå 410 CAPABILITY_WITHDRAWN, med en forklaring på at funksjonen ikke tilbys og en henvisning til fristene og signaturretten. Hver respons bærer en X-Correlation-ID du kan oppgi til support.

Kodeeksempel

MVA-terminene for et selskap, og det samme kallet mot sandkassen uten nøkkel.

# MVA-terminene for et selskap, beregnet i Europe/Oslo.
# Bruk en miljøvariabel for nøkkelen, aldri en hardkodet verdi.
curl -H "Authorization: Bearer $APIER_API_KEY" \
  "https://www.apier.no/api/v1/company/999999999/deadlines"
# Sandkasse uten autentisering mot syntetisk org 999999999:
# samme responsform som produksjon, ingen ekte registeroppslag.
curl "https://www.apier.no/api/v1/sandbox/public/company/999999999/deadlines"

Hvor finner jeg API-referansen?

Den fullstendige API-referansen ligger i OpenAPI 3.1-spesifikasjonen på /openapi.json og i utviklerdokumentasjonen under /docs. MVA-fristene for 2026 er forklart i guiden /no/guider/mva-frister-2026.

Kom i gang

Sandkassen kan kjøres med curl uten registrering, og dokumentasjonen dekker endepunktene, scopes og hva som ikke tilbys.