Medlemskap Domain

Medlemskap (membership) determines whether a person is covered by the Norwegian National Insurance Scheme (folketrygden). The domain handles membership period creation, type determination (pliktig/frivillig), coverage levels (trygdedekning), and synchronization with the central MEDL registry.

Quick Reference

Domain Model Hierarchy

Behandlingsresultat
└── medlemskapsperioder: Set<Medlemskapsperiode>

    Medlemskapsperiode
    ├── id: Long
    ├── fom: LocalDate               # Period start date
    ├── tom: LocalDate?              # Period end date (nullable for open-ended)
    ├── innvilgelsesresultat: InnvilgelsesResultat  # INNVILGET, DELVIS_INNVILGET, AVSLAATT, OPPHØRT
    ├── medlemskapstype: Medlemskapstyper           # PLIKTIG, FRIVILLIG, UNNTATT, ...
    ├── trygdedekning: Trygdedekninger              # FULL_DEKNING_FTRL, FTRL_2_9_*, etc.
    ├── bestemmelse: Bestemmelse                    # FTRL paragraph
    ├── medlPeriodeID: Long?         # Reference to MEDL registry
    └── trygdeavgiftsperioder: Set<Trygdeavgiftsperiode>

Key Enums

Enum	Values	Description
InnvilgelsesResultat	INNVILGET, DELVIS_INNVILGET, AVSLAATT, OPPHØRT	Period outcome
Medlemskapstyper	PLIKTIG, FRIVILLIG, UNNTATT, DELVIS_UNNTATT, IKKE_MEDLEM	Membership type (mandatory/voluntary/exempt)
Trygdedekninger	FULL_DEKNING, FULL_DEKNING_FTRL, FULL_DEKNING_EOSFO, UTEN_DEKNING, the FTRL_2_9_* family, FTRL_2_7_/FTRL_2_7A_, treaty values (TILLEGGSAVTALE_NATO_HELSEDEL, UNNTATT_USA_5_2_G, UNNTATT_CAN_7_5_B)	Coverage type (stored in column trygde_dekning). See kodeverk enum Trygdedekninger for the full set.

Trygdedekninger vs Avgiftsdekning — the HELSEDEL_MED_SYKEPENGER / HELSEDEL_UTEN_SYKEPENGER / PENSJONSDEL_MED_YRKESSKADETRYGD / PENSJONSDEL_UTEN_YRKESSKADETRYGD constants are NOT Trygdedekninger; they are the Avgiftsdekning enum, derived from a Trygdedekninger value via AvgiftsdekningerFraTrygdedekning for trygdeavgift. Don't confuse the two.

Medlemskapstype Determination

Determined by bestemmelse via UtledMedlemskapstype:

PLIKTIG (Mandatory) - Based on FTRL §2-1, §2-2, §2-5:

// From PliktigeMedlemskapsbestemmelser
- FTRL_KAP2_2_1        // Bosatt i Norge
- FTRL_KAP2_2_2        // Arbeidstaker i Norge
- FTRL_KAP2_2_3_ANDRE_LEDD
- FTRL_KAP2_2_5_FØRSTE_LEDD_A through H  // Various §2-5 provisions
- FTRL_KAP2_2_5_ANDRE_LEDD
- Vertslandsavtale_bestemmelser (NATO, etc.)

FRIVILLIG (Voluntary) - FTRL §2-8 and special cases:

- FTRL_KAP2_2_15_ANDRE_LEDD  // Special rule: always FRIVILLIG
- All other bestemmelser not in PLIKTIG list

Trygdedekning Options

Valid trygdedekninger per behandlingstema are defined in GyldigeTrygdedekningerService (then intersected with the bestemmelse via LovligeKombinasjonerTrygdedekningBestemmelse):

Behandlingstema	Available Trygdedekninger
YRKESAKTIV	FULL_DEKNING_FTRL, the full FTRL_2_9_* family, FTRL_2_7_TREDJE_LEDD_B_, FTRL_2_7A_ANDRE_LEDD_B_, TILLEGGSAVTALE_NATO_HELSEDEL
IKKE_YRKESAKTIV	FULL_DEKNING_FTRL, the FTRL_2_9_* family, FTRL_2_7_TREDJE_LEDD_B_*, TILLEGGSAVTALE_NATO_HELSEDEL
PENSJONIST	FULL_DEKNING_FTRL, FTRL_2_9_* (helse/pensjon variants), FTRL_2_7_TREDJE_LEDD_B_*

Service Layer

MedlemskapsperiodeService

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

Key operations:

• hentMedlemskapsperioder(behandlingsresultatID) - Get all periods for treatment
• opprettMedlemskapsperiode(...) - Create new period with validation
• oppdaterMedlemskapsperiode(...) - Update existing period
• slettMedlemskapsperiode(behandlingsresultatID, periodeID) - Delete period
• erstattMedlemskapsperioder(...) - Replace periods on re-assessment
• opprettEllerOppdaterMedlPeriode(...) - Sync to MEDL registry

OpprettForslagMedlemskapsperiodeService

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

Key operations:

• opprettForslagPåMedlemskapsperioder(behandlingID, bestemmelse) - Generate period proposals

Validation checks:

1. Sakstype must be FTRL (validerSakstype)
2. Bestemmelse-trygdedekning combination must be valid (validerBestemmelse)
3. Required vilkår must be fulfilled (validerVilkår)

UtledMedlemskapsperioder

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

Key operations:

• lagMedlemskapsperioder(grunnlag) - Create periods for first-time treatment
• lagMedlemskapsperioderForAndregangsbehandling(...) - Create periods for re-assessment

Logic overview:

• For YRKESAKTIV/IKKE_YRKESAKTIV: Creates periods based on søknadsperiode and mottaksdato
• For PENSJONIST: Creates helsedel periods only
• Handles avslag (rejection) periods before mottaksdato

Period Lifecycle

Creation Flow

Søknad received → Journalføring → Behandling created
                                        │
                                        ▼
                              OpprettForslagMedlemskapsperiodeService
                              (generates period proposals)
                                        │
                                        ▼
                              Saksbehandler review/adjust
                                        │
                                        ▼
                              fattVedtak() → IVERKSETT_VEDTAK_FTRL
                                        │
                                        ▼
                              LAGRE_MEDLEMSKAPSPERIODE_MEDL (saksflyt steg)
                              (writes to MEDL registry)

InnvilgelsesResultat Transitions

From	To	Trigger
(new)	INNVILGET	Positive vedtak
(new)	AVSLAATT	Rejection vedtak
INNVILGET	OPPHØRT	Termination (opphør)

Re-assessment (Ny vurdering)

When creating new behandling for existing fagsak:

1. Original periods are copied/referenced via opprinneligBehandling
2. New periods can modify or extend original periods
3. erstattMedlemskapsperioder() handles:
   • Opphør (terminate) original INNVILGET periods not carried forward
   • Feilregistrer (void) original OPPHØRT periods not carried forward
   • Create/update new periods

Validation Rules

Period Field Validation

// Required fields (always)
- fom: LocalDate         // Must be set
- innvilgelsesResultat   // Must be set
- bestemmelse            // Must be set
- trygdedekning          // Must be set

// tom: LocalDate - Required EXCEPT when:
- Land is only Norway (NOR) AND
- Bestemmelse is FTRL_KAP2_2_1 (bosatt i Norge)

// Period logic
- tom cannot be before fom (PeriodeRegler.feilIPeriode)

Bestemmelse-Trygdedekning Validation

// Via LovligeKombinasjonerTrygdedekningBestemmelse
erBestemmelseGyldigForTrygdedekning(bestemmelse, trygdedekning)

Vilkår Validation

Before creating period proposals, required vilkår must be fulfilled:

// Check via Behandlingsresultat
behandlingsresultat.oppfyllerVilkår(vilkårForBestemmelse)

MEDL Integration

Synchronization Points

Saga Step	When
LAGRE_MEDLEMSKAPSPERIODE_MEDL	After vedtak, writes INNVILGET periods to MEDL
Re-assessment	Updates/terminates existing MEDL periods
Opphør	Changes period status to AVST (terminated)

medlPeriodeID

• Created when period is first synced to MEDL
• Used for subsequent updates
• NULL means period not yet in MEDL (or MEDL write failed)

See Also

Refer to medl skill for detailed MEDL integration patterns.

Debugging Queries

Find Medlemskapsperioder for Behandling

SELECT mp.*, br.behandling_id
FROM medlemskapsperiode mp
JOIN behandlingsresultat br ON mp.behandlingsresultat_id = br.behandling_id
WHERE br.behandling_id = :behandlingId
ORDER BY mp.fom_dato;

Find Periods by Person

-- The person/aktør is not a column on fagsak; it lives in the aktoer table
-- (rolle BRUKER) joined on saksnummer.
SELECT mp.*, b.id as behandling_id, f.saksnummer
FROM medlemskapsperiode mp
JOIN behandlingsresultat br ON mp.behandlingsresultat_id = br.behandling_id
JOIN behandling b ON br.behandling_id = b.id
JOIN fagsak f ON b.saksnummer = f.saksnummer
JOIN aktoer a ON a.saksnummer = f.saksnummer AND a.rolle = 'BRUKER'
WHERE a.aktoer_id = :aktorId
ORDER BY mp.fom_dato DESC;

Check MEDL Sync Status

SELECT mp.id, mp.fom_dato, mp.tom_dato, mp.innvilgelse_resultat,
       mp.medlemskapstype, mp.medlperiode_id
FROM medlemskapsperiode mp
JOIN behandlingsresultat br ON mp.behandlingsresultat_id = br.behandling_id
WHERE br.behandling_id = :behandlingId
AND mp.medlperiode_id IS NULL;  -- Not synced to MEDL

Find Periods with Trygdeavgift

SELECT mp.*, tp.id as avgift_id, tp.trygdeavgift_beloep_mnd_verdi, tp.trygdeavgift_beloep_mnd_valuta
FROM medlemskapsperiode mp
JOIN trygdeavgiftsperiode tp ON tp.medlemskapsperiode_id = mp.id
WHERE mp.behandlingsresultat_id = :behandlingsresultatId;

Check Period Validation Issues

SELECT mp.*, b.beh_tema, f.fagsak_type as sakstype
FROM medlemskapsperiode mp
JOIN behandlingsresultat br ON mp.behandlingsresultat_id = br.behandling_id
JOIN behandling b ON br.behandling_id = b.id
JOIN fagsak f ON b.saksnummer = f.saksnummer
WHERE mp.tom_dato IS NULL
AND mp.bestemmelse != 'FTRL_KAP2_2_1';  -- Open-ended but not bosatt

Common Issues

Issue	Symptoms	Investigation
Wrong medlemskapstype	PLIKTIG shown as FRIVILLIG	Check bestemmelse vs PliktigeMedlemskapsbestemmelser
Missing period proposals	No periods generated	Check vilkår fulfillment, bestemmelse-dekning combo
Invalid trygdedekning	FunksjonellException	Check LovligeKombinasjonerTrygdedekningBestemmelse
tom-dato required error	Can't save open-ended period	Only allowed for FTRL_KAP2_2_1 with land=NO
MEDL sync failed	medlPeriodeID is NULL	Check prosessinstans status, MEDL API logs
Period overlap	Kontroll warning	Check existing periods in MEDL via MedlemskapDokument

Detailed Documentation

• Types: Pliktig/frivillig/trygdedekning details
• Periods: Period management and validation
• MEDL Sync: MEDL synchronization
• Debugging Guide: SQL queries and troubleshooting