Altinn Søknad Skill
Expert knowledge of Altinn electronic A1 application processing for posted workers (utsendte arbeidstakere) in EU/EEA.
Quick Reference
Key Components
| Component | Location | Purpose |
|---|
AltinnSoeknadService | service/src/main/java/.../altinn/ | Main service processing Altinn applications |
SoeknadMapper | service/src/main/java/.../altinn/ | Maps Altinn XML to internal Soeknad domain |
SoknadMottattConsumer | service/src/main/java/.../soknad/ | Kafka entry point; consumes soknad-mottak topic and starts the saga |
SoknadMottakClient | integrasjon/src/main/kotlin/.../soknadmottak/ | Fetches applications from soknad-mottak API |
soknad-altinn module | soknad-altinn/ | XSD schema and JAXB bindings for form |
OpprettFagsakOgBehandlingFraAltinnSøknad | saksflyt/src/.../steg/behandling/ | Saga step for processing |
Form Structure (MedlemskapArbeidEOS_M)
Innhold
├── arbeidsgiver # Employer information
│ ├── virksomhetsnummer # Org number
│ ├── kontaktperson # Contact person
│ ├── samletVirksomhetINorge # Norwegian operations stats
│ └── offentligVirksomhet # Is public sector?
├── arbeidstaker # Employee information
│ ├── foedselsnummer # Norwegian ID
│ ├── utenlandskIDnummer
│ ├── barn # Children (medfølgende)
│ └── fødested/fødeland
├── midlertidigUtsendt # Posted worker details
│ ├── arbeidsland # Work country
│ ├── arbeidssted # Work location (LAND/OFFSHORE/SKIPSFART/LUFTFART)
│ ├── utenlandsoppdraget # Assignment details
│ └── loennOgGodtgjoerelse # Salary info
└── fullmakt # Power of attorney
├── fullmektigVirksomhetsnummer # Advisory firm org number
└── fullmaktFraArbeidstaker
Processing Flow
1. Altinn form submitted
↓
2. melosys-skjema-api receives and stores in PostgreSQL
↓
3. Kafka event triggers melosys-api
↓
4. MOTTAK_SOKNAD_ALTINN saga starts
↓
5. OpprettFagsakOgBehandlingFraAltinnSøknad step:
- Fetches XML from soknad-mottak API
- Creates Fagsak and Behandling
- Maps form data to MottatteOpplysninger
↓
6. OpprettOgFerdigstillAltinnJournalpost step:
- Archives documents in Joark
↓
7. Behandling ready for saksbehandler
Behandlingstema Determination
if (offentligVirksomhet == true) {
Behandlingstema.ARBEID_TJENESTEPERSON_ELLER_FLY
} else {
Behandlingstema.UTSENDT_ARBEIDSTAKER
}
ArbeidsstedType Mapping
| Type | Description | Mapped To |
|---|
LAND | Work on land | ArbeidPaaLand with fysiske arbeidssteder |
OFFSHORE | Offshore platforms | MaritimtArbeid with innretningstype |
SKIPSFART | Ships/maritime | MaritimtArbeid with flaggland |
LUFTFART | Aviation | LuftfartBaser with hjemmebase |
Domain Model
Soeknad (Internal Representation)
Soeknad (domain/.../mottatteopplysninger/Soeknad.kt, Kotlin) is a thin subclass of
MottatteOpplysningerData. It declares only four fields of its own:
class Soeknad : MottatteOpplysningerData() {
var loennOgGodtgjoerelse: LoennOgGodtgjoerelse? = LoennOgGodtgjoerelse()
var arbeidsgiversBekreftelse = ArbeidsgiversBekreftelse()
var utenlandsoppdraget = Utenlandsoppdraget()
var arbeidssituasjonOgOevrig = ArbeidssituasjonOgOevrig()
}
The remaining data lives on the inherited MottatteOpplysningerData
(domain/.../mottatteopplysninger/MottatteOpplysningerData.java):
class MottatteOpplysningerData {
Soeknadsland soeknadsland; // Target country/countries
Periode periode; // Application period
OpplysningerOmBrukeren personOpplysninger;
ArbeidPaaLand arbeidPaaLand; // If type=LAND
List<ForetakUtland> foretakUtland; // Foreign companies
OppholdUtland oppholdUtland;
SelvstendigArbeid selvstendigArbeid;
JuridiskArbeidsgiverNorge juridiskArbeidsgiverNorge;
List<MaritimtArbeid> maritimtArbeid; // If OFFSHORE/SKIPSFART
List<LuftfartBase> luftfartBaser; // If LUFTFART
Bosted bosted;
}
Key Mappings
| Altinn Field | Domain Field | Notes |
|---|
arbeidsland | Soeknadsland.landkoder | ISO-2 country code |
periodeUtland | Periode | fom/tom LocalDate |
loennNorskArbg | LoennOgGodtgjoerelse.norskBruttoLoennPerMnd | Salary in NOK |
erstatterTidligereUtsendte | Utenlandsoppdraget.erstatter | Replacement worker |
Common Debugging
Check Received Application
-- Find søknad by fagsak (behandling joins fagsak via saksnummer, not fagsak_id)
SELECT mo.id, mo.type, mo.data
FROM mottatteopplysninger mo
JOIN behandling b ON mo.behandling_id = b.id
JOIN fagsak f ON b.saksnummer = f.saksnummer
WHERE f.gsak_saksnummer = '123456789'
AND mo.type = 'SØKNAD_A1_UTSENDTE_ARBEIDSTAKERE_EØS';
-- Check original XML (stored in original_data; JSON is in data)
SELECT original_data
FROM mottatteopplysninger
WHERE behandling_id = :behandlingId;
Trace Application Processing
-- Find prosessinstans for søknad.
-- prosess_steg is a kode/navn lookup table, so don't join it - prosessinstans
-- carries data and sist_fullfort_steg (last completed step) directly.
SELECT uuid, prosess_type, sist_fullfort_steg, data, registrert_dato, endret_dato
FROM prosessinstans
WHERE prosess_type = 'MOTTAK_SOKNAD_ALTINN'
AND data LIKE '%søknadRef%'
ORDER BY endret_dato DESC;
Detailed references
Related Skills
- saksflyt: Saga pattern for processing
- journalforing: Document archiving
- fagsak: Case creation
- behandling: Case treatment lifecycle
External Documentation