ftrl

name

ftrl

description

Expert knowledge of Folketrygdloven (National Insurance Act) processing in melosys-api. Use when: (1) Understanding FTRL bestemmelser (§2-5 to §2-13), (2) Debugging yrkesaktiv/ikke-yrkesaktiv/pensjonist processing flows, (3) Understanding trygdedekning options and combinations, (4) Investigating vilkår for each bestemmelse, (5) Understanding medlemskapsperiode generation logic, (6) Debugging frivillig vs pliktig membership determination.

Folketrygdloven (FTRL) Domain

Folketrygdloven (National Insurance Act) Chapter 2 governs membership in the Norwegian social insurance scheme for persons outside treaty/EU contexts. This domain handles §2-1 through §2-13, managing pliktig (mandatory) and frivillig (voluntary) membership applications.

Quick Reference

Domain Model Hierarchy

Behandlingsresultat
├── medlemskapsperioder: List<Medlemskapsperiode>
│   ├── fom/tom: LocalDate
│   ├── bestemmelse: Medlemskapsbestemmelser
│   ├── medlemskapstype: Medlemskapstyper (PLIKTIG/FRIVILLIG)
│   ├── trygdedekning: Trygdedekning
│   ├── arbeidsland: String?
│   ├── innvilgelsesresultat: Innvilgelsesresultater
│   ├── skatteforholdTilNorge: Set<SkatteforholdTilNorge>
│   ├── inntektsperioder: Set<Inntektsperiode>
│   └── trygdeavgiftsperioder: Set<Trygdeavgiftsperiode>
└── trygdeavgiftType: Trygdeavgift_typer?

FTRL Bestemmelser (Paragraphs)

Paragraph	Type	Description
§2-1	Pliktig	Bosatt i Norge - grunnregel
§2-2	Pliktig	Arbeidstaker i Norge
§2-5.a-g	Pliktig	Offentlig ansatte (statsforvaltning, forsvaret, etc.)
§2-5.h	Pliktig	Student med lån/stipend
§2-6	Pliktig	Sjømenn på norskregistrerte skip
§2-7.1	Frivillig	Opphold i Norge (ikke bosatt)
§2-7.4	Frivillig	Familiemedlemmer §2-7
§2-7a	Frivillig	Sjømenn bosatt i Norge, utenlandsk skip
§2-8.1.a	Frivillig	Utsendt arbeidstaker
§2-8.1.b	Frivillig	Student utenlands
§2-8.1.c	Frivillig	Offentlig oppdrag/stipend
§2-8.1.d	Frivillig	Pensjonist/uføretrygdet
§2-8.2	Frivillig	Andre yrkesaktive (rimelighetsvurdering)
§2-8.4	Frivillig	Familiemedlemmer §2-8
§2-13	Unntak	Unntak fra medlemskap

Behandlingstema

Tema	Description	Bestemmelser
YRKESAKTIV	Working persons	§2-1, §2-2, §2-5, §2-6, §2-7.1, §2-7a, §2-8.1.a, §2-8.2
IKKE_YRKESAKTIV	Non-working persons	§2-1, §2-5.h, §2-7.1, §2-7.4, §2-8.1.b, §2-8.1.c, §2-8.4
PENSJONIST	Pensioners/disabled	§2-8.1.d

Trygdedekning (Coverage)

Code	Description	Use Case
FULL_DEKNING	Full coverage in folketrygden	Standard for pliktig
HELSEDEL	Health coverage only	Pensjonister utenlands
UTEN_DEKNING	No coverage	Avslag/unntak
FTRL_2_9_FØRSTE_LEDD_A_HELSE	§2-9 health only	Special cases

Medlemskapstype

Type	Description
PLIKTIG	Mandatory membership - automatic by law
FRIVILLIG	Voluntary membership - by application

Service Layer

FtrlBestemmelser

Location: service/src/main/kotlin/.../ftrl/bestemmelse/FtrlBestemmelser.kt

Defines valid FTRL bestemmelser and their properties.

YrkesaktivBestemmelser / IkkeYrkesaktivBestemmelser / PensjonistBestemmelser

Location: service/src/main/kotlin/.../ftrl/bestemmelse/

Separate files defining valid bestemmelser for each behandlingstema.

MedlemskapsperiodeService

Location: service/src/main/kotlin/.../ftrl/medlemskapsperiode/MedlemskapsperiodeService.kt

Key operations:

• hentMedlemskapsperioder() - Get periods for behandling
• opprettMedlemskapsperiode() - Create new period
• oppdaterMedlemskapsperiode() - Update existing period
• erstattMedlemskapsperioder() - Replace periods (ny vurdering)

OpprettForslagMedlemskapsperiodeService

Location: service/src/main/kotlin/.../ftrl/medlemskapsperiode/OpprettForslagMedlemskapsperiodeService.kt

Creates suggested membership periods based on søknadsperiode and rules.

UtledMedlemskapsperioder

Location: service/src/main/kotlin/.../ftrl/medlemskapsperiode/UtledMedlemskapsperioder.kt

Logic for deriving membership periods from input data.

GyldigeTrygdedekningerService

Location: service/src/main/kotlin/.../ftrl/GyldigeTrygdedekningerService.kt

Returns valid trygdedekning options for given context.

LovligeKombinasjonerTrygdedekningBestemmelse

Location: service/src/main/kotlin/.../ftrl/bestemmelse/LovligeKombinasjonerTrygdedekningBestemmelse.kt

Defines valid combinations of trygdedekning and bestemmelse.

Vilkår System

Vilkår Structure

Location: service/src/main/kotlin/.../ftrl/bestemmelse/vilkaar/

VilkårForBestemmelse (interface)
├── VilkårForBestemmelseYrkesaktiv
├── VilkårForBestemmelseIkkeYrkesaktiv
└── VilkårForBestemmelsePensjonist

Each bestemmelse has associated vilkår (conditions) that must be evaluated.

AvklarteFaktaForBestemmelse

Location: service/src/main/kotlin/.../ftrl/bestemmelse/avklartefakta/

Defines which avklarte fakta are required for each bestemmelse.

Processing Flows

Yrkesaktiv Flow (§2-8)

┌─────────────────────┐
│ Søknad mottas       │
│ (behandlingstema:   │
│  YRKESAKTIV)        │
└─────────┬───────────┘
          │
          ▼
┌─────────────────────┐
│ Velg bestemmelse    │
│ (§2-8.1.a, §2-8.2)  │
└─────────┬───────────┘
          │
          ▼
┌─────────────────────┐
│ Avklar vilkår       │
│ (arbeidsgiver,      │
│  arbeidsland, etc.) │
└─────────┬───────────┘
          │
          ▼
┌─────────────────────┐
│ Opprett medlemskaps-│
│ periode med avgift  │
└─────────┬───────────┘
          │
          ▼
┌─────────────────────┐
│ Fatt vedtak         │
│ IVERKSETT_VEDTAK_   │
│ FTRL                │
└─────────────────────┘

Pensjonist Flow (§2-8.1.d)

┌─────────────────────┐
│ Søknad mottas       │
│ (behandlingstema:   │
│  PENSJONIST)        │
└─────────┬───────────┘
          │
          ▼
┌─────────────────────┐
│ Bestemmelse:        │
│ §2-8.1.d automatisk │
└─────────┬───────────┘
          │
          ▼
┌─────────────────────┐
│ Trygdedekning:      │
│ HELSEDEL            │
│ (kun helsedel)      │
└─────────┬───────────┘
          │
          ▼
┌─────────────────────┐
│ Betalingsvalg:      │
│ FAKTURA/KONTONUMMER │
└─────────┬───────────┘
          │
          ▼
┌─────────────────────┐
│ Fatt vedtak         │
└─────────────────────┘

Saksflyt Integration

IVERKSETT_VEDTAK_FTRL

LAGRE_MEDLEMSKAPSPERIODE_MEDL →
OPPRETT_FAKTURASERIE →
AVSLUTT_SAK_OG_BEHANDLING →
SEND_MELDING_OM_VEDTAK →
RESET_ÅPNE_ÅRSAVREGNINGER

Debugging Queries

Find Medlemskapsperiode by Behandling

SELECT mp.*, br.id as br_id, b.status
FROM medlemskapsperiode mp
JOIN behandlingsresultat br ON mp.behandlingsresultat_id = br.id
JOIN behandling b ON br.behandling_id = b.id
WHERE b.id = :behandlingId;

Check Bestemmelse and Dekning

SELECT mp.id, mp.fom, mp.tom,
       mp.bestemmelse, mp.trygdedekning,
       mp.medlemskapstype, mp.arbeidsland,
       mp.innvilgelsesresultat
FROM medlemskapsperiode mp
WHERE mp.behandlingsresultat_id = :behandlingsresultatId;

Find FTRL Cases for Person

SELECT f.saksnummer, f.type, b.id, b.status, b.tema
FROM fagsak f
JOIN behandling b ON b.fagsak_id = f.id
WHERE f.bruker_aktor_id = :aktorId
AND f.type = 'FTRL'
ORDER BY b.registrert_dato DESC;

Check MEDL Registration

SELECT mp.medl_periode_id, mp.bestemmelse, mp.fom, mp.tom
FROM medlemskapsperiode mp
WHERE mp.behandlingsresultat_id = :brId
AND mp.medl_periode_id IS NOT NULL;

Common Issues

Issue	Symptoms	Investigation
Wrong bestemmelse	Incorrect paragraph in vedtak	Check vilkårsvurdering flow
Invalid dekning	Validation error	Check LovligeKombinasjonerTrygdedekningBestemmelse
Period overlap	Cannot save medlemskapsperiode	Check existing periods for fagsak
Missing MEDL	medl_periode_id is NULL	Check LAGRE_MEDLEMSKAPSPERIODE_MEDL step
Avgift calculation fail	No trygdeavgiftsperiode	Verify skatteforhold and inntekt set

Bestemmelse Details

§2-8 First Paragraph (Frivillig Yrkesaktiv)

a) Utsendt arbeidstaker

• Norwegian employer sends to work abroad
• Employer has substantial activity in Norway
• Previously subject to Norwegian legislation

b) Student utenlands

• Studying abroad with Norwegian loan/stipend
• Enrolled at recognized institution

c) Offentlig oppdrag/stipend

• Government assignment abroad
• Research stipend from Norwegian sources

d) Pensjonist/uføretrygdet

• Receiving pension from folketrygden
• Only helsedel coverage available

§2-8 Second Paragraph

• Other workers where "særlige grunner" make it reasonable
• Discretionary evaluation (rimelighetsvurdering)

§2-13 Unntak

• Exception from mandatory membership
• Used when person should not be member despite §2-1/§2-2

Detailed Documentation

• Bestemmelser: All FTRL paragraphs and conditions
• Trygdedekning: Coverage types and combinations
• Flows: Processing flows per arbeidssituasjon
• Debugging Guide: SQL queries and troubleshooting