| 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 behandlingopprettMedlemskapsperiode() - Create new periodoppdaterMedlemskapsperiode() - Update existing perioderstattMedlemskapsperioder() - 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
