Hvordan fungerer klientdelegering for regnskapsførere og revisorer i Altinn 3?

Hvor kommer klienttilgangen fra i Altinn 3?

Fra registeret, ikke fra et delegeringsskjermbilde. Når et klientselskap registrerer et regnskapsbyrå i Enhetsregisteret, oppstår regnskapsførerpakkene automatisk fra registreringen: regnskapsfører med signeringsrettighet, regnskapsfører uten signeringsrettighet og regnskapsfører lønn. En registrert revisor får samme mekanisme med pakkene for ansvarlig revisor og revisormedarbeider. Tildelingen følger det registrerte forholdet, så den overlever utskiftninger på begge sider og opphører når forholdet avregistreres.

Dette er delen som er mest endret fra Altinn 2, der klienttilgang ble båret av roller delegert per tjeneste og per person. Pakkemodellen flytter buntingen inn i en felles katalog og knytter proffpakkene til registeret. De gamle tildelingene følger ikke med i det uendelige: Skatteetatens overgangsveiledning dokumenterer at roller og delegering av roller i Altinn 2 fjernes ved inngangen til 2027, med noen tildelinger som utgår tidligere og må delegeres på nytt.

Hvilke pakker som erstattet hvilke roller, og hvorfor sensitive pakker ikke har forhåndstildelte roller i det hele tatt, eies av veiledningen om rollemapping. Denne siden forutsetter at pakkene finnes, og stiller det operative spørsmålet som følger: hvordan et byrå gjør registertildelt myndighet om til programvare som opptrer for hundre klienter.

Hvem i byrået gir klienttilgangen videre?

Klientadministratoren. Altinns administratorroller skiller byråets egne tilganger fra tilgangene det har på vegne av andre, og klientadministratoren eier den andre halvdelen: å forvalte hva organisasjonen kan gjøre for sine klienter og kunder, enten myndigheten oppstår fra et registrert forhold i Enhetsregisteret eller fra en delegering. Portalflyten for å tildele klienter til et system krever nettopp denne rollen eller daglig leder.

Selve flyten er kort og skjer per klient. Fra oversikten over systemtilganger åpner administratoren agent-systembrukeren, velger å legge til kunder, og legger dem til en om gangen før bekreftelsen. Listen tilbyr bare klienter der forholdet faktisk er etablert: sluttbrukerveiledningen sier uttrykkelig at en tom klientliste betyr at klientforholdet ikke er satt opp, som gjør den tomme modalen til et registersymptom og ikke en portalfeil.

Det er verdt å stoppe ved hva denne halvdelen er til for. Pakkene finnes allerede, tildelt av registeret, og byråets folk har dem allerede. Tildelingssteget finnes fordi et SYSTEM som opptrer for en klient, er en større beslutning enn at en person gjør det: det er punktet der byrået velger, klient for klient, hvilke deler av porteføljen programvaren får røre, og det kan reverseres klient for klient også.

Hvordan autoriseres en agent-systembruker per klient?

Agent-systembrukeren er den klientvendte varianten av systembrukermodellen: der en vanlig systembruker opptrer for den ene organisasjonen som opprettet den, representerer agent-systembrukeren klienter, og bærer en brukertype agent for å si det. Ett registrert system, én agent-systembruker i byrået, og så én delegering per klient hengende på den. Delegeringene er knyttet til tilgangspakkene arbeidet krever, de samme regnskapsfører- og revisorpakkene registeret tildelte.

Tildelingshalvdelen kan også nås som API i stedet for portalflyt. Klientdelegerings-API-et lister organisasjonens agent-systembrukere, klientene som er tilgjengelige for delegering, og klientene som alt er delegert, og legger til eller fjerner klienter programmatisk; operasjonene er beskyttet av egne lese- og skrivescopes. En leverandør som betjener regnskapsbyråer, kan derfor bygge klient-onboarding inn i sitt eget produkt i stedet for å sende administratorer til portalen for hvert nye oppdrag. Mekanikken i å sette opp det underliggende systemet og dets første token eies av oppsettsgjennomgangen.

Apiers rolle i dette bildet er lesesiden: å gjøre porteføljens autoritetstilstand til noe byrået spør om i stedet for å oppdage. list_acting_capacity avgjør hvilke registerroller en person har for en klientorganisasjon og hva rollene tillater, og fullmakt-endepunktene svarer på delegeringstilstanden per klientorg med gapene navngitt og norske fix_steps vedlagt. Samme målgruppe som denne siden betjener, går bruksområdet for regnskapsbyråer gjennom fra ende til ende.

Gjør det første kallet

Sandkassekallet svarer på hvem som kan opptre for ett selskap, uten nøkkel. TypeScript-eksempelet er porteføljeutgaven: delegeringstilstanden per klientorg, lest i en løkke før noe klientarbeid planlegges, med gapene og fix_steps i svaret i stedet for i en avvisning nedstrøms.

# Nøkkelløs sandkasse: hvem som kan opptre for et selskap, fra registeret.
curl -s https://www.apier.no/api/v1/sandbox/public/company/999999999/authority

// Porteføljesjekk: delegeringstilstanden per klientorg, lest med én
// Apier-nøkkel mot apier.no, før noe klientarbeid planlegges.
const clients = ["999999999"]; // dine klienters organisasjonsnumre

for (const org of clients) {
  const res = await fetch(`https://www.apier.no/api/v1/fullmakt/${org}`, {
    headers: { Authorization: `Bearer ${process.env.APIER_API_KEY}` },
  });

  if (!res.ok) {
    // Alle ikke-2xx-svar bruker den samme strukturerte konvolutten.
    const { error_code, explanation } = await res.json();
    throw new Error(`${org}: ${error_code}: ${explanation.summary}`);
  }

  const { data } = await res.json();
  // "full" | "partial" | "none", med norske fix_steps per gap.
  console.log(org, data.overall_status, data.fix_steps);
}

Ofte stilte spørsmål

Hva er en klientadministrator?

Administratorrollen for klientsiden av byråets tilganger. Der de vanlige tilgangsstyrerne håndterer byråets egne rettigheter, forvalter klientadministratoren tilgangene organisasjonen har på vegne av klienter og kunder, enten de oppstår fra et registrert forhold i Enhetsregisteret eller fra en delegering. Å tildele klienter til en agent-systembruker utføres av en klientadministrator eller daglig leder.

Trenger vi delegering fra hver klient når vi er registrert regnskapsfører?

Ikke for selve pakkene. Når en klient registrerer byrået ditt som regnskapsfører eller revisor i Enhetsregisteret, oppstår de tilhørende tilgangspakkene automatisk fra registreringen, uten noe delegeringsskjermbilde. Det som forblir en bevisst handling, er å peke et SYSTEM mot klienten: å tildele klienten til agent-systembrukeren deres gjøres i byrået, av en klientadministrator eller daglig leder.

Hva er en agent-systembruker?

En systembruker opprettet for å representere klienter i stedet for byrået selv. En vanlig systembruker opptrer for én organisasjon; agent-systembrukeren er varianten for regnskapsførere og revisorer, der ett registrert system opptrer for mange klientorganisasjoner, og hver klient delegeres til den enkeltvis. Klientdelegerings-API-et lister agentene, klientene som er tilgjengelige, og klientene som alt er tildelt.

Hva er endret fra klientroller i Altinn 2?

Tilgangsenheten og levetiden til gamle tildelinger. Klienttilgang i Altinn 3 bæres av tilgangspakker som oppstår fra det registrerte forholdet, ikke av roller delegert per tjeneste. Skatteetatens overgangsveiledning dokumenterer at roller og delegering av roller i Altinn 2 fjernes ved inngangen til 2027, og at noen gamle tildelinger utgår tidligere og må delegeres på nytt etter den nye modellen.

Hvordan tjener Apier et regnskapsbyrå her?

Ved å gjøre porteføljetilstanden lesbar. list_acting_capacity avgjør hvilke registerroller en person har for en klientorganisasjon og hva rollene tillater. Fullmakt-endepunktene svarer på delegeringstilstanden per klientorg: full, partial eller none, med de manglende scopene navngitt og norske fix_steps du kan gi klienten. Begge kjører bak én Apier-nøkkel, så autoritetsspørsmålet per klient blir en løkke i stedet for en supporttråd.