Hvordan sjekker jeg om et selskap er registrert i Merverdiavgiftsregisteret via API?

Hva er grensen for MVA-registrering?

Registrering utløses av at avgiftspliktig omsetning passerer en grense innenfor en rullerende tolvmånedersperiode, ikke av et kalenderår eller av en beslutning virksomheten tar ved oppstart. Den ordinære grensen oppgis vanligvis som 50 000 kroner, med et høyere beløp for visse veldedige og allmennyttige aktiviteter. Bekreft gjeldende beløp hos Skatteetaten før du bygger på dem i kode: de er fastsatt i lovgivning og de endrer seg, og denne siden er ikke autoriteten på dem.

Det rullerende vinduet er den delen som spenner ben på automatisert resonnement. En virksomhet kan passere grensen midt i året og bli pliktig til å registrere seg fra det tidspunktet, noe som betyr at MVA-status er en egenskap som endrer seg gjennom et selskaps liv og ikke et fast kjennetegn satt da det ble stiftet. Ethvert mellomlagret svar om MVA-status har derfor en holdbarhet, og et system som leser det én gang ved onboarding vil ta feil om noen kunder i løpet av måneder.

Fordi grensen handler om avgiftspliktig omsetning og ikke inntekt generelt, kan du ikke pålitelig utlede MVA-status fra finansielle tall du tilfeldigvis har. Les det registrerte flagget i stedet for å slutte deg til det. Det er nettopp derfor mva_registered eksponeres som et åpent felt: registeret svarer allerede på spørsmålet, og å rekonstruere det fra omsetning ville vært både vanskeligere og feil.

Hvorfor er et selskap registrert, men ikke MVA-registrert?

Fordi de to registreringene svarer på ulike spørsmål. Å komme inn i Enhetsregisteret fastslår at en juridisk enhet finnes. Å komme inn i Merverdiavgiftsregisteret fastslår at enheten krever inn og betaler merverdiavgift. Et selskap opprettes før det driver, så det finnes normalt en periode, og for noen virksomheter en permanent tilstand, der det første er sant og det andre ikke er det.

Tre situasjoner står for det meste av det du vil se. Et nytt selskap har ennå ikke nådd grensen. En liten virksomhet når den aldri. Eller aktiviteten faller utenfor MVA-ordningen, noe som gjelder visse unntatte bransjer uansett størrelse. Sett fra API-et er disse ikke til å skille fra hverandre: mva_registered er false i alle tre tilfellene, og flagget bærer ingen begrunnelse.

Behandle en false-verdi som opplysning og ikke som et faresignal. Den er helt vanlig, og å lese den som et varsku vil gi falske positiver nettopp på de små og nye selskapene der signalet betyr minst. De virkelig nyttige negative signalene er konkursflaggene dekket i veiledningen om å sjekke om et selskap er aktivt, som betyr noe helt annet.

Hvordan endrer MVA-registrering pliktene?

Den legger til en fast rapporteringssyklus selskapet ikke hadde før. En MVA-registrert virksomhet leverer MVA-melding etter en plan, ordinært over seks terminer i året, og rapporterer merverdiavgift krevd inn og betalt. Et selskap som ikke er MVA-registrert leverer den meldingen ikke i det hele tatt, så dette er en forskjell i art og ikke i mengde.

Det gjør mva_registered til en nyttig inngangsverdi i all frist- og pliktlogikk du bygger. Det kanoniske fristsettet for et år, inkludert de seks MVA-terminene, er tilgjengelig uten nøkkel fra /api/v1/public/deadlines, og den generiske pliktmalen for en organisasjonsform kommer fra /api/v1/public/obligations. Begge svarer på malspørsmålet og ikke på det selskapsspesifikke, og det er riktig arbeidsdeling: hva som generelt gjelder er offentlig, mens hva et bestemt selskap skylder avhenger av fakta om det selskapet.

Én asymmetri er verdt å huske når du designer datamodellen. Om et selskap er MVA-registrert er åpent og gratis å lese, men datoen det ble registrert ligger i det lukkede kommersielle nivået og krever en aktiv delegering for organisasjonen. Avhenger logikken din av når registreringen skjedde og ikke av om den skjedde, er det et krav om delegering, og å oppdage det sent er en mer forstyrrende overraskelse enn det ser ut som.

Gjør det første kallet

Forespørselen om samlet status under er reelt nøkkelløs og returnerer MVA-flagget per rad. TypeScript-snutten leser det fra selskapskonteksten og viser hvor det lukkede nivået begynner.

# Nøkkelløst: mva_registered kommer tilbake per rad, uten nøkkel.
curl -s "https://www.apier.no/api/v1/public/company-status?org_numbers=999999999"

// mva_registered er et ÅPENT felt. Ingen delegering kreves for å lese det.
const res = await fetch(
  "https://www.apier.no/api/v1/company/999999999/context",
  { headers: { Authorization: `Bearer ${process.env.APIER_API_KEY}` } },
);

if (!res.ok) {
  const { error_code, explanation } = await res.json();
  throw new Error(`${error_code}: ${explanation.summary}`);
}

const { data } = await res.json();

if (data.mva_registered) {
  // MVA-registrert: forvent MVA-meldingsplikter på de seks terminene.
} else {
  // Registrert som selskap, men under eller utenfor MVA-ordningen.
}

// RegistreringsDATOEN er et lukket Tier 2-felt, i motsetning til flagget over.
console.log(data.data_tier, data.tier_2 === null ? "ingen delegering" : "tier 2");

Ofte stilte spørsmål

Hvordan sjekker jeg om et norsk selskap er MVA-registrert?

Les den boolske verdien mva_registered. Det er et åpent felt, tilgjengelig uten delegering, på selskapskonteksten, blant verifiseringssignalene og per rad på det nøkkelløse samleendepunktet. En true-verdi betyr at selskapet står i Merverdiavgiftsregisteret; false betyr at det ikke gjør det.

Hva betyr MVA-endelsen på et organisasjonsnummer?

Den markerer nummeret som en MVA-registrering. Det samme 9-sifrede organisasjonsnummeret skrives med MVA lagt til når det brukes som MVA-identifikator, for eksempel på en faktura. Det er ikke et eget nummer nummer to, så fjern endelsen før du bruker verdien som oppslagsnøkkel.

Hvorfor er et selskap registrert, men ikke MVA-registrert?

Som regel fordi det ennå ikke har passert registreringsgrensen, eller fordi det det selger faller utenfor MVA-ordningen. Registrering i Enhetsregisteret og registrering for MVA er to ulike hendelser med to ulike utløsere, så et nytt eller lite selskap står ofte i det første registeret og ikke i det andre.

Kan jeg lese datoen for MVA-registrering gjennom API-et?

Ikke fra den åpne flaten. Om et selskap er MVA-registrert er et åpent felt som ikke krever delegering, men når det ble registrert ligger i det lukkede kommersielle nivået og krever en aktiv delegering for organisasjonen. Den delingen overrasker mange, fordi de to faktaene føles som om de hører sammen.

Endrer MVA-registrering hva et selskap må levere?

Ja. En MVA-registrert virksomhet rapporterer merverdiavgift i en fast syklus, ordinært over seks terminer i året, som er en plikt et ikke-registrert selskap ikke har i det hele tatt. Det kanoniske fristsettet for et gitt år, inkludert de terminene, er tilgjengelig fra det nøkkelløse fristendepunktet.