Tjenester :: KS Fiks

Få hjelp og support

Wed, 06 May 2026 00:00:00 +0000

For alle spørsmål om Fiks-tjenestene kan du kontakte oss gjennom følgende kanaler: Kontaktkanaler E-post: fiks@ksdigital.no Slack: #fiks-support - Se under for hvordan få tilgang GitHub Hvis du oppdager en bug eller har forslag til forbedring: GitHub Issues: Mange av KS sine tjenester og klienter er åpen kildekode. Se github.com/ks-no for aktuelle prosjekter Få tilgang til Slack-kanaler Hvis du skal integrere mot Fiks-plattformen og ønsker raskere dialog med utviklerne anbefaler vi Slack-kanalene våre:

Kom i gang som applikasjonstilbyder

Mon, 01 Jan 0001 00:00:00 +0000

Denne veiledningen er for deg som utvikler en applikasjon og ønsker å bruke Fiks tilgangsstyring til eksterne applikasjoner som autorisasjonstjeneste. Tjenesten brukes til å avgjøre om en bruker har tilgang til data for én eller flere kommuner, mens applikasjonen selv driftes og forvaltes i ditt eget miljø. Merk: Tilgang vurderes i dag per kommunenummer. Støtte for andre organisasjonsidentifikatorer (organisasjonsnummer eller tenant-id/FiksOrgId) er planlagt. Forutsetninger Dere har en organisasjon registrert i Fiks-plattformen og har en avtale på at dere kan være tilbyder En applikasjon som kjører i deres eget miljø Administrator-tilgang til Fiks-plattformen Maskinporten-klient opprettet i Samarbeidsportalen Oversikt

Skatte- og inntektsopplysninger

Wed, 20 May 2026 00:00:00 +0000

Kort beskrivelse Fiks register tilbyr skatte- og inntektsopplysninger for kommunalt ansatte via et web-basert grensesnitt for innbyggere som søker om kommunale tjenester. Dette grensesnittet er også tilgjengelig som API for kommunene sine fagsystem. Tilgjengelige grensesnitt Grensesnitt Støtte Web portal Ja Maskin til maskin Api spec Beskrivelse av tjenesten Innbyggertjeneste Gyldige tjenesteområde for rollen Beregningstype Redusert foreldrebetaling SFO/barnehage Foreldrebetaling SFO/barnehage BARNEHAGE_SFO Praktisk bistand og opplæring Helse og omsorg: Praktisk bistand PRAKTISK_BISTAND Langtidsopphold institusjon Helse og omsorg: Langtidsopphold institusjon LANGTIDSOPPHOLD_INSTITUSJON For å bruke API-ene, både proxy og vårt overbygg, må rollen som opprettes være i rett tjenesteområde.

Klientbiblioteker

Mon, 04 May 2026 00:00:00 +0000

KS publiserer offisielle klientbiblioteker for noen få tjenester og felleskomponenter på Fiks-plattformen. Denne siden er en samlet oversikt over disse bibliotekene. Ikke alle tjenester har, eller skal ha, et eget klientbibliotek. For tjenester uten offisiell klient bruker man API-spec’en direkte sammen med den generelle integrasjonsmodellen beskrevet i Integrasjoner. Pakkene distribueres via Maven Central (Java) og nuget.org (.NET). Se risikovurdering for distribuerte pakker for hvordan KS sikrer integriteten i disse. Felles / autentisering Bibliotek Java .NET Maskinporten access token-klient fiks-maskinporten fiks-maskinporten-client-dotnet Fiks IO og Fiks Protokoll Bibliotek Java .NET Fiks IO-klient (motta + send) fiks-io-klient-java fiks-io-client-dotnet Fiks IO send-klient (kun send) fiks-io-send-klient fiks-io-send-client-dotnet Tjenestespesifikke klienter Tjeneste Java .NET Fiks Dokumentlager fiks-dokumentlager-klient – Fiks Digisos fiks-digisos-klient – Lenk kun til denne siden fra en tjenesteside dersom tjenesten faktisk har et relevant offisielt klientbibliotek.

Fiks Nav hjelpemiddel API

Mon, 09 Mar 2026 00:00:00 +0000

Kort beskrivelse Integrasjon mot NAVs hjelpemiddel-API for kommunale lager- og logistikkløsninger. Fiks Nav hjelpemiddel gir kommuner tilgang til NAVs API via Fiks-plattformen. Tjenesten benyttes mot kommunens løsning for lager, logistikk og samhandling på hjelpemiddelområdet. Tjenesten tilbyr: Oversikt over digitale søknader sendt fra kommunen Automatisk opprettelse av mottaksordre ved leveringer fra NAV Kobling mellom brukernummer og fødselsnummer Innsyn i andre bestilleres søknader ved tjenstlig behov Oversikt over hastesaker med begrunnelse API-spesifikasjon: Swagger / OpenAPI

Min kommune - oppgave

Thu, 05 Feb 2026 00:00:00 +0000

Kort beskrivelse Min Kommune Oppgaver er en løsning laget for målrettet tildeling av oppgaver til enkeltinnbyggere, via KS Min kommune. Løsningen består av et web-grensesnitt i Min Kommune brukt av innbyggere til å vise og håndtere oppgavene, ett api for eksterne fag-system til bruk for å opprette og endre oppgaver, samt en konfigurasjons-side i vår forvaltnings-løsning under min kommune.

API: Sending av dokumenter

Sun, 01 Feb 2026 00:00:00 +0000

Send med dokumenter Innsending utføres ved bruk av en multipart HTTP request. Første part må inneholde forsendelsens metadata, og ha navn “forsendelse”. Påfølgende parts skal inneholde dokumentene som skal sendes med forsendelsen. Dokumentene har følgende krav: Filene må være i samme rekkefølge som dokumentene definert i metadata ‘filename’ benyttes som filnavn, og må samsvare navnet i metadata ’name’ ignoreres Ved innsending av forsendelser anbefales det en timeout på 16 minutter. Dette for å håndtere innsending av større filer.

Sende til aktør i Norsk Helsenett

Sun, 01 Feb 2026 00:00:00 +0000

Sende til Norsk Helsenett Vi har i 2025 jobbet med å koble SvarUt til Norsk Helsenett. Behovet har vært å kunne sende elektroniske brev mellom saksbehandlere i kommunale virksomheter og aktører på Norsk Helsenett (NHN). Aktører på helsenettet vil gjerne være fastleger, men er ikke begrenset til det. Kravet er at mottaker skal finnes i NHN sitt adresseregister, enten som en tjeneste eller person. For mer informasjon om hvilke parter som kan adresseres, se NHN dokumentasjon om communicationparty.

Fiks eiendomsavtaler

Wed, 12 Nov 2025 00:00:00 +0000

Kort beskrivelse Fiks eiendomsavtaler er en tjeneste for å tilrettelegge for fakturering av kommunale avgifter. En MVP (Minimum viable product) er planlagt lansert tidlig i 2026. Første pilotkommune er Oslo kommune. Fiks eiendomsavtaler tilbyr: Et register over eiendomsavtaler som består av en lokal kopi med informasjon fra matrikkelen, og flere felter som vi omtaler som «kommunal del» som saksbehandler i kommunen kan legge til mer informasjon på. Et webgrensesnitt hvor saksbehandler kan opprette, oppdatere, søke etter og se informasjon om eiendomsavtaler. Tilgjengelige grensesnitt Det vil komme API-dokumentasjon her på hvordan fagsystemer kan hente ned eiendomsavtaler.

Kontaktregisteret

Mon, 06 Oct 2025 00:00:00 +0000

Kort beskrivelse Kontaktregisteret, tidligere kontakt- og reservasjonsregisteret, er et register som inneholder kontaktinformasjon for personer. Hva må være på plass før man kan integrere Alle steg for å sette opp folkeregister er nødvendig for å kunne integrere mot dette apiet, da folkeregister ligger i bunn for alle registertjenestene på fiksplattformen. Det må være satt opp en rolle for å få lov til å gjøre spørringer.

SvarUt og SvarInn Testmiljø

Fri, 03 Oct 2025 00:00:00 +0000

For å lage integrasjoner mot SvarUt kan en teste mot vårt testmiljø. Testmiljøet har ingen garantier for oppetid, men vi prøver at det er tilgjengelig hele tiden. Testmiljøet inneholder de siste endringene også endringer som ikke er produksjonsatt. Testmiljøet er tilgjengelig på https://test.svarut.ks.no/ Vi ønsker ikke sensitive data i testmiljøet. Vi ønsker primært at det blir benyttet data fra Tenor. Testbrukere Vi anbefaler at man bruker testbrukere fra Tenor: https://www.skatteetaten.no/skjema/testdata/. Her finner man både personer og organisasjoner

Protokoll - Fiks Link

Mon, 16 Dec 2024 00:00:00 +0000

Fiks Link - protokoll som erstatning for GI Link Les mer om protokollen i Github repoet: fiks-link-specification

Protokoll - Fiks Saksfaser

Mon, 16 Dec 2024 00:00:00 +0000

Fiks Saksfaser - protokoll for henting av saksfaser Les mer om protokollen i Github repoet: fiks-saksfaser-specification

Fiks bekymringsmelding V2

Thu, 03 Oct 2024 00:00:00 +0000

Endringer fra forrige versjon til denne Nytt valgfritt felt på offentlig bekymringsmelding andreSynspunkter, se nye protokollen her. Fagsystem som konsument Ved bruk av Fiks IO som leveringskanal må fagsystemet støtte meldingsprotokollen no.ks.fiks.bekymringsmelding.v2, som er definert til bruk av bekymringsmeldinger. Meldingsprotokollen vil inneholde kontrakter i form av JSON-skjema som gjelder både for mottak og svar på Fiks IO-meldinger.

Fiks samtykke

Thu, 12 Sep 2024 00:00:00 +0000

Kort beskrivelse Fiks samtykke er en løsning laget for Norges innbyggere for å kunne ta stilling til ulike samtykker. Løsningen består av en web-portal brukt av innbyggere til å ta stilling til samtykke og et API for eksterne fag-system brukt saksbehandlere til å opprette og endre samtykker. Første iterasjon av denne tjenesten omfatter samtykker knyttet til Barnevern, og det er den løsningen som i hovedsak beskrives her. Den overordnede flyten for opprettelse av et samtykke i forbindelse med barnevern er som følger:

Distribuerte pakker og klienter - risikovurdering

Tue, 19 Sep 2023 00:00:00 +0000

Kort beskrivelse KS leverer pakker for Java og .NET gjennom henholdsvis Maven Central og nuget.org for flere av tjenestene våre. Eksempelvis Fiks-IO klient, Maskinporten klient og pakker til protokollene Fiks-Arkiv, Fiks-Plan osv. Risikovurderinger Det er gjort vurderinger og tiltak for å sikre pakkene som leveres. Risiko kan ligge i kompromitterte pakker i de sentraliserte repositories. Dette kan hende som resultat av:

eDialog

Wed, 13 Sep 2023 00:00:00 +0000

Sikker innsending av brev fra innbyggere til organisasjoner via SvarUt. For å bruke eDialog bør man allerede ha tatt i bruk SvarUt og SvarInn. Dersom SvarInn ikke er konfigurert opp for organisasjonsnummeret som mottar meldingene vil disse bli sendt til Altinn. Beskrivelse Konfigurasjon av eDialog-mottakere skjer via https://forvaltning.fiks.ks.no under «Fiks melding»-tjenesten og «eDialog». Hver mottaker vil ha en SvarUt-konto tilknyttet seg som vil faktureres for alle meldinger som sendes inn.

Fiks eDialog

Thu, 29 Jun 2023 00:00:00 +0000

eDialog er nå en del av Fiks melding. Dokumentasjon for tjenesten finnes her. Svare på forsendelse ved bruk av eDialog Dersom man benytter V6 eller nyere av SOAP-service, eller hvilken som helst versjon av REST, for sending av forsendelser til SvarUt, kan man sende med en lenke til eDialog for å besvare forsendelsen. Denne linken vil da ha forhåndsutfylt avsender, mottaker og tittel. Bruk av denne funksjonaliteten krever ikke at man har konfigurert noen mottakere i eDialog, da svaret på forsendelsen vil bli sendt fra den opprinnelige avsenderen i SvarUt og også faktureres denne.

Protokoll - Barnevern - fagsysteminnrapportering til Barnevernsregisteret

Wed, 22 Mar 2023 00:00:00 +0000

Barnevern - fagsysteminnrapportering til Barnevernsregisteret er en asynkron protokoll over Fiks IO. Meldinger Hver melding består av en zip fil ASIC-E som inneholder payload.json og eventuelle tilhørende vedlegg. Hver melding kan ikke overskride 5GB. Json skjema Finnes i repoet: https://github.com/statisticsnorway/fiks-protokoll-json-schemas Meldingstyper: Type Navn Innrapportering no.ssb.barnevern.fagsystem.v1.innrapportering Valideringsrapport no.ssb.barnevern.fagsystem.v1.valideringsrapport

Fiks del dokument

Fri, 06 Jan 2023 00:00:00 +0000

Kort beskrivelse Fiks del dokument er en felleskomponent som brukes i flere av Fiks tjenestene. En typisk oppgave for Fiks Del dokument er når kommunalt ansatte ønsker å dele dokumenter på en sikker måte med kryptering.

Fiks Send SMS

Fri, 06 Jan 2023 00:00:00 +0000

Kort beskrivelse Fiks Send SMS er en felleskomponent som brukes i flere av Fiks tjenestene. En typisk oppgave for Fiks Send SMS er utsendelse av tekstmelding til innbyggere i kommunen som har til formål å få innbygger til å utføre en handling. Dette kan være alt fra informasjon til innbyggere, til å varsle om flom eller nedetid for vanntjenester.

Skatte- og inntektsopplysninger proxy

Fri, 02 Dec 2022 00:00:00 +0000

Oppslag via proxy Det er mulig å bruke Skatteetatens delingstjeneste for skatte og inntektsopplysninger som en proxy-tjeneste i Fiks register og samtidig benytte seg av roller, rettighetsstyring og dataminimering som Fiks register tilbyr. Oppbygging av URL gjøres så likt som mulig Skatteetatens egen URL. Datamodellen forblir uendret. Summert skattegrunnlag URL for proxy-api (GET): /skatteetaten/formueinntekt/summertskatt/api/v2/{ROLLE_ID}/{STADIE}/{RETTIGHETSPAKKE}/{INNTEKTSAAR}/{PERSONIDENTIFIKATOR}

Veiledning 1 - Huskeliste før man starter å sette opp protokoll

Fri, 23 Sep 2022 00:00:00 +0000

Hvorfor Før man begynner på arbeidet med å sette opp Fiks Protokoll er det lurt å sjekke at man har alt man trenger og personer med riktig tilgang tilgjengelig. Personer Person fra kunden Det må være en person fra kundeorganisasjonen (kommunen) som skal opprette protokoll system/konto, og som da kan logge seg på Fiks forvaltning og gjøre minstekravet for oppsett. Minstekravet for oppsettet er å få opprettet et “system” hvis leverandør(ene) setter opp resten via API. Se mer om dette lenger nede.

Veiledning 2 - Ta i bruk tjenesten

Fri, 23 Sep 2022 00:00:00 +0000

Det første som må gjøres for bruke Fiks Protokoll, er å skrive under på avtale om bruk og ta i bruk tjenesten. Steg 1: Logg inn Logg først inn på forvaltning.fiks.ks.no (forvaltning.fiks.test.ks.no for testmiljø). I produksjon må dette gjøres av en person som har administrasjonstilgang til organisasjonen i Fiks. I test gjøres det med en testbruker som har tilgang til organisasjonen i test. Ta kontakt med brukerstøtte fiks@ksdigital.no om du trenger hjelp med å opprette testbruker og testorganisasjon. Brukerautentisering gjøres via ID-Porten. I test brukes typisk MINID, BANKID eller TESTID.

Veiledning 3 - Opprette system

Fri, 23 Sep 2022 00:00:00 +0000

For å bruke Fiks Protokoll må du opprette et system. Hvert system i kommunen som skal bruke Fiks Protokoll, må opprette et protokollsystem. F.eks fagsystem eller arkiv. Logg først inn på forvaltning.fiks.ks.no (forvaltning.fiks.test.ks.no for testmiljø). Og gå inn på konfigurasjon. Steg 1: Velg Fiks Protokoll Finn Fiks Protokoll i listen over tjenester. Tjenester som er tatt i bruk ligger øverst. Klikk på “Fiks Protokoll”-knappen

Veiledning 4 - Opprette konto

Fri, 23 Sep 2022 00:00:00 +0000

Steg 1: Velg system Velg systemet du skal opprette konto på Steg 2: Velg kontoer Velg fanen kontoer Steg 3: Opprett ny konto Trykk på “Opprett ny konto”

Veiledning 5 - Gi tilgang til system

Fri, 23 Sep 2022 00:00:00 +0000

Steg 1: Velg system Velg systemet som skal gi tilgang. I vårt tilfelle er det Mitt fagsystem som skal ha tilgang til Mitt arkiv. Vi går derfor inn på Mitt arkiv der for å gi tilgang der. Klikk på “Mitt arkiv” Steg 2: Velg kontoer Tilganger gis til systemer på kontoer. Vi må derfor velge “kontoer”-fanen for å finne kontoen som skal gi tilgang til et system.

Veiledning 6 - Generer nytt passord

Fri, 23 Sep 2022 00:00:00 +0000

Det er ikke mulig å hente passordet til integrasjonen som hører til et system etter at systemet er opprettet. Dersom du har mistet passordet må et nytt passord genereres. Under vises steg for steg hvordan dette gjøres. Steg 1: Velg system Velg systemet som du ønsker å generere nytt passord til.

Veiledning 7 - Ny offentlig nøkkel

Fri, 23 Sep 2022 00:00:00 +0000

Fiks IO sender krypterte meldinger. Det krever at kontoen har et offentlig/privat-nøkkelpar. Den offentlige nøkkelen blir tilgjengeliggjort for de som skal sende meldinger til kontoen, slik at de kan kryptere meldingen. Den private brukes for å dekryptere meldingene som kommer inn. Her er en steg for steg gjennomgang for hvordan du endrer offentlig nøkkel gjennom grensesnittet i Fiks Konfigurasjon Steg 1: Velg system Velg systemet som har kontoen du vil laste opp ny offentlig nøkkel til

Min kommune - faktura

Tue, 28 Jun 2022 00:00:00 +0000

Faktura består av flere tjenester som sammen lager faktura visningen. Funksjonalitet levert kun av Innsyn Dette er metadata om fakturaen som blir indeksert i innsyn. For detaljer se Innsyn Faktura og fakturastatus Funksjonaliteten skal gjøre det mulig å vise fakturadetaljer og status på alle fakturaer i Min kommune slik at man kan redusere henvendelser om betalingsstatus på en faktura.

Min kommune - innsyn

Tue, 28 Jun 2022 00:00:00 +0000

Norske kommuner har mengder av informasjon om sine innbyggere. Denne informasjonen er spredd rundt i arkiver, fagsystemer, dokumentlagre og eksterne skyløsninger. Fiks Innsyn lagrer metadata som beskriver denne informasjonen, og gjør den tilgjengelig for innbyggeren via en kraftig søkemotor. Hvordan tar man i bruk Fiks Innsyn? En kommune kan bruke Fiks Innsyn for å gjøre kommunal informasjon (forsendelser, byggesaker, eiendommer, fakturaer osv) tilgjengelig for innbyggere, endten på min.kommune.no eller i kommunens eksisterende løsninger.

Min kommune - kommunale tjenester

Tue, 28 Jun 2022 00:00:00 +0000

Mange kommuner som tar i bruk KS Min kommune har eksisterende innbyggerrettede tjenester, enten egenutviklet eller innkjøpt fra leverandør. “Kommunale tjenester” lar kommunen eksponere disse tjenestene for sine innbyggere på min.kommune.no, som illustrert i skjermbildet under: Når en innbygger logger seg på min.kommune.no vil Fiks-plattformen avgjøre hvilken kommune denne innbyggeren har et forhold til. I første omgang avgjøres dette av hvilke organisasjoner som har sendt innbyggeren post via SvarUt, senere vil Folkeregisteret også benyttes. På forsiden vil innbyggeren se tjenester fra sin primærkommune, men tjenester registrert av andre kommuner vil være tilgjengelig gjennom søk, både ved hovedsøket på min.kommune.no og via “se alle tjenester” lenken.

Min kommune - matrikkel

Tue, 28 Jun 2022 00:00:00 +0000

Min kommune Fiks-plattformen får med denne tjenesten støtte for matrikkelinformasjon. En innbyggers eiendommmer blir eksponert på min.kommune.no, gjennom “Mine Eiendommer” og hovedsøket, og ved at Fiks Innsyn får støtte for å eksponere meldinger for eiere av en eiendom. Tilgang til denne meldingen vil da følge nye eiere av samme eiendom. Ta i bruk tjenesten Matrikkelinformasjon lastes på nasjonalt nivå, det er dermed ikke nødvendig for den enkelte kommune å ta denne tjenesten i bruk, men det er mulig å tilpasse den til kommunens behov. I utgangspunktet benyttes seeiendom.kartverket.no for detaljinformasjon om eiendommer på min.kommune.no, men kommuner som har eksisterende eiendomstjenester kan registrere disse via Matrikkel-tjenesten i Fiks Konfigurasjon - lenker til disse tjenestene vil da være tilgjengelig på eiendommer innenfor kommunen.

Single Sign On

Thu, 23 Jun 2022 00:00:00 +0000

Single sign On (SSO) Bestilling Kommune / IKT samarbeidet sender bestilling med meta-datalenke til fiks@ksdigital.no Grunnoppsett Sertifikater Manuelt importere rot-sertifikatet til KS som ligger nederst under “Legal Person – G3” på https://www.commfides.com/en/cps/. Rot-sertifikatet skal installeres i mappen Trusted Root Certificates Authorities, Microsoft AD FS kan komme til å foreslå Intermediate Certification Authorities. Relaying party trust Sette opp relying party trust basert på provider meta-data link tilsendt i e-post. Eks: https://www.kslaring.no/auth/saml2/sp/metadata.php?idp= Merk at det kan hende kommunesamarbeidet sitt navn skal stå istedet for kommunenavn, etter idp= Oppsett i KS Læring (utføres av KS) Testing a. Teste en pålogging via test-lenke Logg inn via SSO, klikk på linken under. Bytt ut med kommunenavn/kommunesamarbeid. https://www.kslaring.no/auth/saml2/login.php?idp= Hvis det er feil i sertifikat, så får dere en “SAML2 exception: responder”-feil fra KS Læring. Dere må sjekke at nedlastet root-sertifikat er riktig installert og på riktig server hos dere. Hvis det er feil i claims, så får dere «You have logged in succesfully but we could not find your ’eksempel’ attribute to associate you to an account in Moodle.» i KS Læring, men får en feilmelding om feil mapping/attributt. Forsett til steg 3b, sjekk av attributter, via tilsendt lenke for dette. b. – Når du er innlogget, klikk på linken under for å sjekke liste over attributter: (hos kommunen) https://www.kslaring.no/auth/saml2/test.php c. Send den faktiske responsen fra test.php til KS Må sendes som tekst - IKKE skjermbilde! OBS! Faktisk fødselsnummer må fjernes fra teksten! Test på nytt Test pålogging i nettlesere fra flere produsenter - Google Chrome, Apple Safari, Microsoft Internet Explorer, Mozilla Firefox, Opera etc. Dere sjekker at profilen stemmer overens med det som er forventet. Hvis dere får feil i profilen, tar dere kontakt med KS, via opprettet helpdesk-sak i innledense prosess. Meld i fra når ok Gi skriftlig beskjed til KS når alt er OK, slik at saken kan avsluttes. Azure AD Konfigurere SSO med SAML for KS læring Se brukerveildeningen i pdf-format her: https://portal.fiks.ks.no/wp-content/uploads/2023/05/sso_med_fnr.pdf

Protokoll - Fiks plan

Thu, 16 Jun 2022 00:00:00 +0000

Tjenesten er under utvikling/testing/pilotering Fiks Plan er en asynkron protokoll over Fiks IO eller andre transportmekanismer med meldinger på json-format. For implementasjonseksempler, brukerhistorier og teknisk dokumentasjon les mer i wiki på github repoet gi-plan. Meldinger Hver melding består av en zip fil ASIC-E som inneholder payload.json og eventuelle tilhørende vedlegg. Hver melding kan ikke overskride 5GB. .NET bibliotek og prosjekter Prosjekter og evt nuget pakker:

Folkeregister

Fri, 18 Feb 2022 00:00:00 +0000

Kort beskrivelse Fiks folkeregister er en tjeneste for å gjøre oppslag, uttrekk og hente ut hendelseslister fra Skatteetate sitt Folkeregister (FREG). Fiks folkeregister speiler konsument tjenestene til Skatteetaten på Fiks plattformen. Mer informasjon om Fiks folkeregister finner man her. Tilgjengelige grensesnitt Grensesnitt Støtte Web portal Ja Maskin til maskin Api spec Beskrivelse av tjenesten For å ta i bruk Fiks folkeregister må man inngå bruksavtaler både med skatteetaten og KS. Klikk her for mer informasjon.

Fiks IO

Fri, 17 Dec 2021 00:00:00 +0000

Kort beskrivelse Fiks IO er en kanal for sikker maskin-til-maskin integrasjon. Denne kanalen kan benyttes for å bygge prosesser på tvers av systemer og organisasjoner, for eksempel når et fagsystem skal arkivere et dokument i et arkivsystem eller spørre om informasjon som er lagret i et annet system. Fiks IO bruker RabbitMQ som kø-system og forenkler meldingsutvekslingen via køene i RabbitMQ. Les gjerne mer om RabbitMQ og kø-systemer.

Protokoll - Fiks matrikkelføring

Wed, 18 Aug 2021 00:00:00 +0000

Kort beskrivelse Fiks Matrikkelføring er en asynkron protokoll over Fiks IO for å overføre grunnlag til matrikkelføring fra eByggesak til Matrikkelklienter. Den er tilsvarende løsningen som er etablert på Fiks SvarUt/SvarInn http://geointegrasjon.no/nytt-grensesnitt-ebyggesak-og-matrikkel/. Denne løsningen benytter altså Fiks IO for maskin til maskin integrasjon. Tilgjengelige grensesnitt Grensesnitt Støtte Web portal Nei Maskin til maskin Ja Beskrivelse Teknisk oversikt skisse

Protokoll - Fiks arkiv

Thu, 29 Jul 2021 00:00:00 +0000

Tjenesten er under utvikling/testing/pilotering Kort beskrivelse Fiks Arkiv tjenesten er en asynkron protokoll over Fiks IO eller andre transportmekanismer for å søke, arkivere og hente data fra et arkiv. Fiks Protokoll benyttes for meldingstype definisjon på konto. For brukerhistorier fra arbeidet som ble gjort ved kartleggingen av protokollen, les mer i wiki og dokumentasjon i github repoet fiks-arkiv-specification Tilgjengelige grensesnitt Grensesnitt Støtte Web portal Nei Maskin til maskin Ja Begrensninger og regler for protokollen Arkivdel skal være spesifisert i arkivet og håndteres av arkivet, men protokollen støtter ikke henting av arkivdel fra arkiv. Meldingene har mulighet for å sette arkivdel men protokollen har altså ikke egen meldingstype for å hente arkivdeler. Protokollen støtter ikke henting av koder som meldingstype. Vi tilbyr standard kodelister for koder i meldingene som kommer med i nuget/maven pakkene (oversikt over kodelistene vi tilbyr kommer her snart). Fiks Protokoll med Fiks IO som meldingsutvekslings kanal er ikke designet for å kunne brukes ved migrering av store mengder data mellom systemer. Men man må gjerne bruke Fiks Arkiv som dataformat på en annen kanal. Meldinger Hver melding består av en zip fil ASIC-E som inneholder f.eks. arkivmelding.xml eller sok.xml og tilhørende vedlegg som er definert i xml filen. Hver melding kan ikke overskride 5GB. Meldingene skal også ha et sett med headere som blandt annet viser hvem som er avsender, mottaker, om det er et svar på en annen melding osv. Headerene er definert under Fiks-IO og man kan lese mer om de her

Kodeeksempel .Net

Mon, 22 Feb 2021 00:00:00 +0000

Eksempel på Soap integrasjon: kodeeksempel Klient api til rest servicen, laget av dibk: https://bitbucket.org/dibk/ftpb-svarut-client/src/master/

Kodeeksempel Java

Mon, 22 Feb 2021 00:00:00 +0000

Kodeeksempel soap på github kodeeksempel Rest klient for java https://github.com/ks-no/svarut-rest-klient

Fiks Digisos

Tue, 27 Oct 2020 00:00:00 +0000

Kort beskrivelse Tilrettelegger for kommunal behandling av sosialsøknader sendt fra nav.no. Fiks Digisos er en tjeneste for å tilrettelegge for kommunal behandling av sosialsøknader via et brukergrensesnitt på nav.no. Tjenesten sikrer at saksbehandling skjer i kommunens fagsystem, mens innbygger og NAV-veileder får nødvendig innsyn. Tjenesten tilbyr: Enkelt oppsett for den enkelte kommune gjennom Fiks Konfigurasjon. Innbygger får fortløpende oppdatering på saksgang, tilgjengelig på nav.no. Sikker maskin-til-maskin-overføring av søknader og fagsystemets saksoppdateringer. Ansatte/brukerstøtte i NAV kan se utvalgte deler av saken via NAV sine systemer. Grensesnitt: Type Detaljer Web portal fagsystem-integrasjon og nav.no Fiks IO Protokoll no.nav.digisos.fagsystem.v1 Maskin til maskin Sak API-spec Maskin til maskin (NAV) Soknad API-spec Kom i gang Tjenestespesifikke forutsetninger:

KS læring integrasjon

Fri, 16 Oct 2020 00:00:00 +0000

SIDEN ER UNDER UTVIKLING Prosedyre for KS Læring HR API Kommunens representant sender inn en en henvendelse til fiks@ksdigital.no og informerer om at kommunen ønsker å begynne å bruke HR API Med bakgrunn i dette skjemaet, opprettes en sak hos KS. All skriftlig kommunikasjon går via den saken. Teknisk dokumentasjon til kommune og utvikler ks-hrdataapi_v3-20200128.pdf Dette dokumentet inneholder teknisk beskrivelse av KS HR API. Beskrivelsen er utarbeidet av Catalyst.

Maskinporten

Tue, 09 Jun 2020 00:00:00 +0000

Ta i bruk maskinporten For å ta i bruk maskinporten må man gjøre følgende: Avtale med Digdir om bruk av maskinporten Virksomhetssertifikater for test- og produksjonsmiljøet Sendt e-post til fiks@ksdigital.no hvor dere informerer om at det er inngått en avtale med Digdir om bruk av maskinporten og hvilket organisasjonsnummer det gjelder Opprett maskinporten-klient hos Digdir Les videre for beskrivelser om hvordan man kan få dette på plass.

Sikkerhet og personvern i Fiks-plattformen

Fri, 17 Apr 2020 00:00:00 +0000

Denne siden gir en generell innføring i hvordan personvern og informasjonssikkerhet (sikkerhet) er ivaretatt i Fiks-plattformen. Under beskrives hvordan vi har sikret tjenestene på en ovordnet nivå. Generelt om sikkerhet Ivaretakelse av digital sikkerhet i nasjonale felleskomponenter og andre samfunnskritiske systemer som leveres av virksomheter i offentlig sektor, må ha et særskilt fokus. Med økt fokus på innebygget personvern og informasjonssikkerhet blir Fiks-plattformen stadig bedre sikret, og er i seg selv å anse som et godt sikringstiltak for kommunal sektor.

Fiks kjøretøyregister

Wed, 11 Dec 2019 00:00:00 +0000

Kort beskrivelse Fiks kjøretøyregister er en tjeneste for å gjøre oppslag i Statens Vegvesen sitt Kjøretøy register (Autosys). Fiks Kjøretøyregister speiler Kjøretøyoppslag og Kjøretøysøk tjenestene til Statens Vegvesen på Fiks-plattformen. Den gjør det mulig å slå opp et eller flere kjøretøy basert på kjennemerke, kuid (svv-identifikator), eller understellsnummer. Oppslaget vil gi informasjon om kjøretøyet og eierforhold på nåværende tidspunkt, eller på et spesifisert tidspunkt som angis i søket.

Fiks bekymringsmelding V1

Mon, 25 Nov 2019 00:00:00 +0000

Fagsystem som konsument Ved bruk av Fiks IO som leveringskanal må fagsystemet støtte meldingsprotokollen no.ks.fiks.bekymringsmelding.v1, som er definert til bruk av bekymringsmeldinger. Meldingsprotokollen vil inneholde kontrakter i form av JSON-skjema som gjelder både for mottak og svar på Fiks IO-meldinger. Til fagsystem - mottak av bekymringsmeldinger Fagsystemet vil motta enten en privat bekymringsmelding, no.ks.fiks.bekymringsmelding.privat.v1, med en ASiC-E-fil i body eller en offentlig bekymringsmelding, no.ks.fiks.bekymringsmelding.offentlig.v1, med en ASiC-E-fil i body. I tillegg vil det være en header «bydel-ressurs-id», som vil være ID til bydelsressursen, og en header «bekymringsmelding-id» som vil være bekymringsmeldingens unike ID. I de fleste tilfeller kan man se bort fra disse.

Integrasjoner

Thu, 19 Sep 2019 00:00:00 +0000

En integrasjon på Fiks-plattformen er en maskin-til-maskin klient som benytter tjenestelaget for å utføre oppgaver på vegne av en fiks-organisasjon. Dette kan for eksempel være et arkivsystem som sender saker gjennom Fiks SvarInn, eller et fagsystem som oppdaterer meldinger i Fiks Innsyn. Hver Fiks-organisasjon oppretter sine egne integrasjoner - dette gjøres gjennom Fiks forvaltning konfigurasjon. Når man oppretter integrasjonen, definerer man hvilken organisasjon som skal ha rett til å sende forespørseler til Fiks-plattformen på vegne av denne. Organisasjonen kan være Fiks-organisasjonen selv, eller en tredjepart som har driftsansvar. Se under for detaljer om opprettelse av integrasjoner.

API: Integrasjon med SOAP

Tue, 07 May 2019 00:00:00 +0000

NB! Vi planlegger å avvikle støtte for alle gjenværende SOAP-versjoner i løpet av 2026, les mer her. SOAP APIene er deprecated, og det vil ikke komme noen ny versjon av eller ny funksjonalitet til disse. Vi anbefaler bruk av nyeste versjon av REST-APIet for nye integrasjoner. Tilgang For å benytte web-tjenesten må en bruke HTTP Basic autentication med brukernavn(avsendernavn) og service-passord. Avsender opprettes av KS-SvarUt administrator/organisasjons administrator. Service-passordet genereres av avsender-ansvarlig via konfigurasjon-siden.

REST V1

Thu, 11 Apr 2019 00:00:00 +0000

NB! Vi planlegger å avvikle støtte for REST V1 i løpet av 2026, les mer her. Tilgang For å benytte web-tjenesten må en bruke HTTP Basic autentication med brukernavn og service-passord. Avsender opprettes, og passord genereres, av administrator for SvarUt via Fiks konfigurasjon. Nytt i denne versjonen Erstatter SOAP-tjenesten. Endepunkter Base URL: /tjenester/api/forsendelse/v1

Fiks dokumentlager

Mon, 10 Sep 2018 00:00:00 +0000

Kort beskrivelse Dokumentlager-tjenesten lar kommunen og andre Fiks-organisasjoner laste opp dokumenter. Ved opplasting autoriseres en eller flere personer og/eller organisasjoner for tilgang til dokumentet. Det er også mulig å laste opp dokumenter med en begrenset levetid, slik at det blir gjort utilgjengelig når denne tiden utløper. En Fiks-organisasjon kan organisere sine dokumenter ved bruk av det som kalles kontoer. Alle dokumenter som lastes opp vil tilhøre en konto. Om man vil bruke en eller flere kontoer er helt opp til hver organisasjon. Kontoer administreres gjennom konfigurasjonsgrensesnittet, hvor man også finner statistikk for diskbruk, metadata for dokumenter, med mer.

Testmiljø

Tue, 29 May 2018 00:00:00 +0000

Fiks-plattformens testmiljø er tilgjengelig for kommuner,fylkeskommuner og leverandører som ønsker å teste konfigurasjon og integrasjoner. Miljøet er koblet til eksterne testmiljøer for integrerte komponenter: ID-Porten, Altinn og KS-SvarUt. Man kan dermed teste hele løpet, komplett med autentisering og autorisering. Fiks test blir brukt til å verifisere endringer før de går i produksjon, og vil derfor ligge litt foran produksjon. Vi har ingen garantier på oppetid i test, men forsøker å holde eventuell nedetid så kort som mulig.

SOAP V10

Fri, 11 May 2018 00:00:00 +0000

NB! Vi planlegger å avvikle støtte for alle gjenværende SOAP-versjoner i løpet av 2026, les mer her. Tilgang For å benytte web-tjenesten må en bruke HTTP Basic autentication med brukernavn(avsendernavn) og service-passord. Avsender opprettes av KS-SvarUt administrator/organisasjons administrator. Service-passordet genereres av avsender-ansvarlig via konfigurasjon-siden. Nytt i denne versjonen Ny operasjon: retrieveDokumentMetadata. Denne er lagt inn for å kunne hente ut informasjon om bl.a. hvor dokumentet kan lastes ned og eventuelt lenke til signeringsoppdrag. Endret operasjon: setForsendelseLestAvEksterntSystem. Denne er oppdatert til å ta imot objekt av type LestAv. Endret operasjoner: retrieveForsendelsesStatus og retrieveForsendelsesStatuser, begge returnerer nå samme modell-objekt (ForsendelsesStatus). Sistnevnte operasjon har pakket resultatet i en liste. Forsendelsesid og organisasjonsnummer er kapslet inn i egne typer. Modell-objektet StatusResult heter nå ForsendelsesStatus. Gamle ForsendelseStatus heter nå Status og blir returnert som en del av ForsendelsesStatus. Modell-objektet Brevpost er ikke lenger i bruk og er fjernet. Modell-objektet PrintKonfigurasjon heter nå UtskriftsKonfigurasjon. Alle modell-objektene er oppdatert til å bruke camelCase på felt og attributter. Tjenester Forsendelsesservicet tilbyr følgende funksjonalitet:

Kodeeksempel MottaksserviceV1