Kodeverk System

Kodeverk manages all enums and validates legal combinations of case types, treatment types, and statuses. Enums are defined in the external melosys-internt-kodeverk library.

Quick Reference

Module Structure

melosys-internt-kodeverk (external library)
└── no.nav.melosys.domain.kodeverk.*   # All enum definitions

service/lovligekombinasjoner/
├── LovligeKombinasjonerSaksbehandlingService.kt  # Validation service
├── LovligeSakskombinasjoner.java                  # Valid case combinations
├── LovligeBehandlingsKombinasjoner.java           # Valid treatment combinations
└── LovligeBehandlingstatus.kt                     # Valid statuses

service/kodeverk/
└── KodeverkService.kt                # External kodeverk (Landkoder, etc.)

Core Enums

Case Level:

Enum	Values	Description
Sakstyper	EU_EOS, FTRL, TRYGDEAVTALE	Case type
Sakstemaer	MEDLEMSKAP_LOVVALG, TRYGDEAVGIFT, UNNTAK	Case theme
Saksstatuser	UNDER_BEHANDLING, HENLAGT, AVSLUTTET, OPPHØRT, ANNULLERT	Case status

Treatment Level:

Enum	Values	Description
Behandlingstyper	FØRSTEGANG, NY_VURDERING, KLAGE, HENVENDELSE, ÅRSAVREGNING	Treatment type
Behandlingstema	YRKESAKTIV, PENSJONIST, UTSENDT_ARBEIDSTAKER, ARBEID_FLERE_LAND, ...	Treatment theme
Behandlingsstatus	UNDER_BEHANDLING, AVVENT_DOK_PART, AVVENT_DOK_UTL, AVVENT_FAGLIG_AVKLARING	Treatment status

Actor Level:

Enum	Values	Description
Aktoersroller	BRUKER, VIRKSOMHET	Actor role

Legal Combinations

Validation Service

LovligeKombinasjonerSaksbehandlingService validates all combinations:

// Get valid options
val sakstyper = service.hentMuligeSakstyper(saksnummer)
val sakstemaer = service.hentMuligeSakstemaer(hovedpart, sakstype, saksnummer)
val behandlingstemaer = service.hentMuligeBehandlingstemaer(hovedpart, sakstype, sakstema, aktivBehandlingID, sistBehandlingstema)
val behandlingstyper = service.hentMuligeBehandlingstyper(hovedpart, sakstype, sakstema, behandlingstema)

// Validate (note param order: behandlingstema before behandlingstype)
service.validerOpprettelseOgEndring(hovedpart, sakstype, sakstema, behandlingstema, behandlingstype)

Combination Structure

Sakstype (EU_EOS, FTRL, TRYGDEAVTALE)
└── Sakstema (MEDLEMSKAP_LOVVALG, TRYGDEAVGIFT)
    └── Behandlingstema (YRKESAKTIV, PENSJONIST, ...)
        └── Behandlingstype (FØRSTEGANG, NY_VURDERING, ...)

Actor Role Dependencies

Different combinations for BRUKER vs VIRKSOMHET:

// BRUKER (individual)
EU_EOS + MEDLEMSKAP_LOVVALG → [YRKESAKTIV, PENSJONIST, UTSENDT_*, ...]

// VIRKSOMHET (organization)
EU_EOS + MEDLEMSKAP_LOVVALG → [VIRKSOMHET]
FTRL + TRYGDEAVGIFT → [VIRKSOMHET]

Behandlingstema Reference

EU/EØS Cases

Tema	Description
YRKESAKTIV	Employed person
IKKE_YRKESAKTIV	Non-employed
PENSJONIST	Pensioner
UTSENDT_ARBEIDSTAKER	Posted worker (Art. 12)
UTSENDT_SELVSTENDIG	Posted self-employed
ARBEID_FLERE_LAND	Multi-state worker (Art. 13)
ARBEID_TJENESTEPERSON_ELLER_FLY	Civil servant or flight crew

Exceptions and Lovvalg Registrations

(Only ANMODNING_OM_UNNTAK_HOVEDREGEL is the genuine Art. 16 exception request; the REGISTRERING_UNNTAK_* themes are lovvalg registrations — UTSTASJONERING under Art. 12, ØVRIGE under Art. 11/15.)

Tema	Description
ANMODNING_OM_UNNTAK_HOVEDREGEL	Exception request (Art. 16)
REGISTRERING_UNNTAK	Register exception
REGISTRERING_UNNTAK_NORSK_TRYGD_UTSTASJONERING	Posting registration (Art. 12)
REGISTRERING_UNNTAK_NORSK_TRYGD_ØVRIGE	Other lovvalg registration (Art. 11/15)

Decision/Designation

Tema	Description
BESLUTNING_LOVVALG_NORGE	Norway designated
BESLUTNING_LOVVALG_ANNET_LAND	Other country designated

Behandlingstyper Reference

Type	Description	When Used
FØRSTEGANG	First-time treatment	New case
NY_VURDERING	Re-assessment	Changed circumstances
KLAGE	Appeal	Dispute decision
HENVENDELSE	Inquiry	Question/info request
ÅRSAVREGNING	Annual settlement	Yearly reconciliation
ENDRET_PERIODE	Changed period	Period modification
MANGLENDE_INNBETALING_TRYGDEAVGIFT	Missing payment	Payment follow-up

Special Rules

ÅRSAVREGNING Restrictions

// Only allowed for:
// FTRL + YRKESAKTIV (with feature toggle)
// EU_EOS + PENSJONIST (with feature toggle)

// Cannot combine with other behandlingstyper

Second Treatment Rules

After certain themes, only limited types allowed:

val BEHANDLINGSTEMA_FOR_ANNENGANGS_BEHANDLING = setOf(
    REGISTRERING_UNNTAK_NORSK_TRYGD_UTSTASJONERING,
    REGISTRERING_UNNTAK_NORSK_TRYGD_ØVRIGE,
    BESLUTNING_LOVVALG_NORGE,
    BESLUTNING_LOVVALG_ANNET_LAND,
    ANMODNING_OM_UNNTAK_HOVEDREGEL
)
// → Only NY_VURDERING, KLAGE, HENVENDELSE allowed

Inactive Case Handling

For closed cases, only HENVENDELSE allowed:

val TILLATTE_SAKSSTATUSER_HENVENDELSE = setOf(
    HENLAGT, AVSLUTTET, OPPHØRT, ANNULLERT, HENLAGT_BORTFALT
)

Code Mappings

SED → Behandlingstema

// SedTypeTilBehandlingstemaMapper
A001 → ANMODNING_OM_UNNTAK_HOVEDREGEL
A003 → BESLUTNING_LOVVALG_NORGE / BESLUTNING_LOVVALG_ANNET_LAND
A009 → REGISTRERING_UNNTAK_NORSK_TRYGD_UTSTASJONERING
A010 → REGISTRERING_UNNTAK_NORSK_TRYGD_ØVRIGE

Behandlingstype → Document Code

// BehandlingstypeKodeMapper
FØRSTEGANG → SOEKNAD
KLAGE → KLAGE
NY_VURDERING → NY_VURDERING
ENDRET_PERIODE → ENDRET_PERIODE

Oppgave Codes

// OppgaveBehandlingstype
EOS_LOVVALG_NORGE → "ae0112"

External Kodeverk

KodeverkService handles external NAV registries:

// Decode external code
val beskrivelse = kodeverkService.dekod(FellesKodeverk.LANDKODER, "NOR")

// Get valid codes
val landkoder = kodeverkService.hentGyldigeKoderForKodeverk(FellesKodeverk.LANDKODER)

FellesKodeverk Types

Type	Description
LANDKODER	Country codes
YRKER	Occupations
SIVILSTANDER	Marital status
KJØNNSTYPER	Gender types
POSTNUMMER	Postal codes
SKIPSTYPER	Ship types

Feature Toggles

Kodeverk availability controlled by toggles:

Toggle	Controls
MELOSYS_ÅRSAVREGNING	Årsavregning availability
MELOSYS_ÅRSAVREGNING_UTEN_FLYT	FTRL årsavregning
MELOSYS_ÅRSAVREGNING_EØS_PENSJONIST	EØS pensjonist årsavregning
BEHANDLINGSTYPE_KLAGE	Klage availability

Common Issues

Invalid Combination Error

Symptom: FunksjonellException: "Ugyldig kombinasjon av ..."

Investigation:

// Check valid combinations
val gyldige = service.hentMuligeBehandlingstemaer(hovedpart, sakstype, sakstema, aktivBehandlingID, sistBehandlingstema)
log.info("Valid temaer: $gyldige")

Missing Enum Value

Symptom: Treatment option not available

Check:

1. Is enum in melosys-internt-kodeverk?
2. Is combination in LovligeBehandlingsKombinasjoner?
3. Is feature toggle enabled?

Detailed Documentation

• Enums: Complete enum reference
• Combinations: Legal combination tables
• Debugging: Troubleshooting invalid combinations, SQL queries, toggle checks