Gå til innhold
  • Det finnes ingen forslag fordi søkefeltet er tomt.

Sette opp FIKS

Her forklarer vi hvordan du setter opp FIKS

Innhold:
Sette opp Aidn som integrasjonspartner
Sette opp SvarUt-integrasjon
Sette opp SvarInn-integrasjon
Sette opp integrasjon for skatt- og inntekt
Arkivering / Fiks protokoll

Sette opp Aidn som integrasjonspartner

For flere av integrasjonene fra FIKS er det påkrevd å ha satt opp en Integrasjon i Fiks-portalen. Det er anbefalt å opprette en integrasjon pr leverandør. Integrasjonen er koblet til Aidn sitt organisasjonsnummer. Dette er 927384302. I Fiks-portalen har hver integrasjon en id og et passord.

Fiks integrasjons-id og integrasjonspassord skal dere registrere i Aidn under Administrasjon → Innstillinger → Fiks innstillinger.

Sette opp SvarUt-integrasjon

For å kunne bruke SvarUt i saksbehandling, må SvarUt integrasjonen settes opp.

Kommunen må ha satt opp en SvarUt konto i Fiks, og en integrasjon for Aidn, som beskrevet over. Dersom kommunen allerede har en SvarUt konto, kan de benytte denne kontoen, men integrasjonen for Aidn må gis tilgang til å sende forsendelser.

Når dette er gjort må man legge verdiene inn i Aidn:

  1. Klikk Administrasjon i hovedmenyen
  2. Velg “Hele <kommunenavn>”
  3. Under Innstillinger, velg Fiks innstillinger
  4. Fyll ut alt innenfor SvarUt boksen:
    1. SvarUt konto id: Kommunen sin SvarUt konto id
    2. Huk av på SvarUt Aktivert

Når alt dette er gjort kan tilkoblingen testes for å være sikre på at alt er satt opp riktig.

Feilsøking av feil ved tilkoblingstest.

Manglende verdier:

En eller flere av SvarUt verdiene mangler. Pass på at alle er satt.

Autentisering feilet:

Dette er antagelig fordi Aidn integrasjonen for kommunen er satt opp feil. Kommunen må følge stegene beskrevet under RestV2 i denne guiden. Organisasjonsnummeret for integrasjonen må samsvare med Aidn sitt integrasjonsnummer. Vær også sikker på at integrasjons-id + integrasjons-passord er riktig.

Ukjent feil:

Kontakt support / casehandling-teamet for hjelp til feilsøking.

Feilsøking av feil ved sending av testbrev

Manglende tilgang for integrasjonen:

Aidn integrasjonen knyttet til kommunens SvarUt mangler forsendelsestilgang.

For å verifisere:

  1. Gå til Tjenester (hovedmeny til venstre eller fra forside)
  2. Velg Fiks Svar Ut
  3. Velg kontoen som tilgangen skal gis på i "Kontoer" listen
  4. Velg "Autentisering og integrasjoner"-fanen
  5. Åpne seksjonen "Integrasjon (API-versjon REST v2)"
  6. Under tilknyttede integrasjoner:
    1. "Legg til" hvis integrasjonen ikke er lagt til tjenesten i det hele tatt
    2. Skru på valget "Kan sende foresendelser"

Det skal da se slik ut:

Ukjent feil:

Kontakt Aidn brukerstøtte for hjelp til feilsøking.

Tidsavbrudd:

Sending tok for lang tid. Kontakt Aidn brukerstøtte for hjelp til feilsøking.

Sette opp SvarInn-integrasjon

For å kunne motta forsendelser fra SvarInn i Aidn (Postmottak) må det settes opp et Mottakersystem i KS SvarUt. Her må det legges inn en offentlig krypteringsnøkkel og hentes ut brukernavn og passord. Den korresponderende private nøkkelen, brukernavn og passord må så legges inn i Aidn. Når det er gjort kan organisasjoner som skal motta forsendelser i Aidn legges inn i mottakersystemet.

Dersom kommunen ikke allerede bruker SvarInn kan denne veilederen følges for å komme i gang: https://ksdigital.no/tjenestene/svarut-tjenesten/svarinn/konfigurasjon-av-svarinn/

Når det er klart, konfigureres mottakersystemet her: https://svarut.ks.no/mottaker

Konfigurere mottakersystem

Først må det genereres et RSA nøkkelpar. Det kan leses mer om dette i KS sin utviklerdokumentasjon: https://developers.fiks.ks.no/tjenester/svarut/svarinn-rest/

I begge eksemplene under genereres filene public.pem og privatekey.pem med en gyldighet på 99999 dager. public.pem lastes opp i mottakersystemet, mens privatekey.pem lastes opp i Aidn.

Unix:

openssl req -x509 -newkey rsa:2048 -nodes -keyout privatekey.pem -out public.pem -days 99999

Windows: For Windows kan for eksempel denne OpenSSL-implementasjonen installeres: https://slproweb.com/products/Win32OpenSSL.html

openssl req -x509 -newkey rsa:2048 -nodes -keyout privatekey.pem -out public.pem -days 99999 -config c:\\\\<opensslinstallmappe>\\\\bin\\\\openssl.cfg

Under fanen Service i mottakersystemet lastes public.pem opp og brukernavn/passord genereres ved å trykke på “Generer nytt servicepassord”.

Når dette er gjort må verdiene legges inn i Aidn:

  1. Klikk Administrasjon i hovedmenyen
  2. Velg “Hele <kommunenavn>”
  3. Under innstillinger, velg Fiks innstillinger
  4. Trykk Rediger og fyll inn verdiene i SvarInn boksen:
    1. SvarInn brukernavn: Brukernavn hentet fra mottakersystemet
    2. SvarInn service passord: Passord hentet fra mottakersystemet
    3. SvarInn PrivateKey: privatekey.pem generert tidligere
    4. Huk av på SvarInn aktivert
    5. Lagre endringene

Til slutt kan organisasjonene som skal motta forsendelser via SvarInn legges inn i fanen Organisasjoner i mottakersystemet. Merk at dette krever “Post/Arkiv”-rollen i Altinn for organisasjonene som skal konfigureres.

Sette opp integrasjon for skatt- og inntekt

Skatt- og inntekt-integrasjon benyttes i Aidn i egenandelsberegning. For å kunne benytte denne integrasjonen må det defineres to roller i Fiks-portalen, og Aidn integrasjonen nevnt over må gis tilgang til disse rollene. Veileder for hvordan rollene skal settes opp finner dere her.

Kopier rolle-id for de to rollene langtidsopphold i institusjon og praktisk bistand inn i skjemaet for Fiks innstillinger. Dersom oppslagene fungerer vises følgende melding.

Dersom integrasjons-id og / eller passord ikke er korrekt satt opp, vil dere få denne feilmeldingen:

Dersom rolle-id ikke er kopiert riktig, får dere denne feilemeldingen:

Dere kan også få andre feilmeldinger.

Feilmeldingen som vises her kan deles med KS brukerstøtte, fiks@ks.no, og de vil hjelpe dere med å finne ut av hva som er problemet. Dersom dere ikke klarer å finne ut av det i samarbeid med KS brukerstøtte tar dere kontakt med Aidn brukerstøtte.

Arkivering / Fiks protokoll:

For å ta i bruk arkivering må kommunen ha en gyldig avtale med en arkivleverandør som støtter Fiks Protokoll, samt en arkivkjerne som er satt opp og klar til bruk.

1. Sett opp klassering (valgfritt)

Når arkivkjernen er på plass, kan du konfigurere primærklassering per IPLOS-tjeneste. Dette gjøres under: Administrasjon → Saksbehandling → Innstillinger → Arkiv

Her kan du legge inn klassering for alle IPLOS-tjenester, basert på hva som er definert i arkivkjernen. Dersom du velger å ikke sette opp klassering, vil alle dokumenter automatisk bli arkivert med primærklassering Helsesak.

2. Gi tilgang til Aidn i Fiks

Før arkivering kan aktiveres, må kommunens system i Fiks være tilgjengelig for andre organisasjoner. Dette gjøres under Konfigurasjon for systemet i Fiks forvaltning, ved å sette Tilgjengelig for andre organisasjoner til Ja.

Aidn sitt system sender deretter en tilgangsforespørsel i Fiks, som kommunen må innvilge.

3. Sette opp arkiv under Fiks innstillinger

Kommunen må oppgi konto-IDen tilknyttet sitt Fiks Protokoll-system. Denne legges inn under: Administrasjon → Fiks innstillinger → Arkiv mottaks-ID.

Velg også riktig arkivkjerne (Documaster / Acos). Når alt er klart fra både arkivkjerne og Aidn, kan man deretter aktivere arkiv.

Hjelp til oppsett i Fiks

Se følgende veiledninger på developers.fiks.ks.no: