Veiledninger :: KS Fiks

Før du starter

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

Sjekkliste over hva og hvem du må ha klart før du setter opp Fiks Protokoll. Oppsettet av Fiks Protokoll involverer flere personer, roller, sertifikater og nøkler. Får du alt på plass i forkant, kan du følge veiledningene 2–6 uten å stoppe opp underveis. Personer og roller Oppsettet gjøres som regel av en person fra kundeorganisasjonen alene. Er fagsystemet fra leverandøren ikke selvbetjent for Fiks Protokoll-oppsett, må også én eller flere personer fra leverandøren involveres.

Ta i bruk tjenesten

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

Slik signerer du avtalen og aktiverer Fiks Protokoll for organisasjonen din. Det første du må gjøre for å bruke Fiks Protokoll er å signere avtalen om bruk og ta tjenesten i bruk. Dette gjøres i Fiks Forvaltning. Sjekk først at du har det du trenger klart — se Før du starter. Hvem kan gjøre dette? I produksjon må dette gjøres av en person med administrasjonstilgang til organisasjonen i Fiks, og signeringen må gjøres av noen som har rett til å signere avtale på vegne av kundeorganisasjonen. I test bruker du en testbruker som har tilgang til testorganisasjonen. Trenger du hjelp med å opprette testbruker og testorganisasjon, kontakt fiks@ksdigital.no.

Opprett system

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

Slik oppretter du et protokollsystem for fagsystemet eller arkivet ditt. For å bruke Fiks Protokoll må du opprette et protokollsystem. Hvert system i kundeorganisasjonen som skal bruke Fiks Protokoll — for eksempel et fagsystem eller et arkiv — trenger sitt eget protokollsystem. Logg inn på forvaltning.fiks.ks.no (forvaltning.fiks.test.ks.no for testmiljøet) og gå til 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.

Opprett konto

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

Slik oppretter du en protokollkonto med protokoll, part og offentlig nøkkel. En protokollkonto er en part i en protokoll. Et protokollsystem kan ha flere kontoer. Du må ha opprettet et system før du kan opprette en konto. Steg 1: Velg system Velg systemet du skal opprette kontoen på. Steg 2: Velg fanen Kontoer Velg fanen Kontoer.

Gi og få tilgang

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

Slik lar du et annet system sende meldinger til kontoen din. Tilganger gis per protokollkonto: en konto kan gi et annet system tilgang til å sende meldinger til seg. Det skal to til Dette steget forutsetter at det finnes et motpart-system med en konto i samme protokoll. I eksempelet under skal Mitt fagsystem sende meldinger til Mitt arkiv — begge systemene må altså være opprettet på forhånd. Eier du bare det ene systemet, må eieren av det andre opprette sitt før dere kan gi tilgang. En mer detaljert oversikt over forvaltning og API finner du under Tilgangsstyring.

Generer nytt passord

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

Slik genererer du et nytt integrasjonspassord hvis du har mistet det gamle. Integrasjonspassordet kan ikke hentes fram igjen etter at systemet er opprettet. Har du mistet det, må du generere et nytt. Husk å oppdatere klientkonfigurasjonen Når du genererer et nytt passord, blir det gamle ugyldig. En klient som allerede er tilkoblet, fortsetter å fungere så lenge tilkoblingen står — men neste gang klienten kobler til på nytt (ved omstart eller etter et tilkoblingsbrudd), vil den feile dersom den fortsatt bruker det gamle passordet. Leverandøren må derfor oppdatere klientkonfigurasjonen med det nye passordet og starte instansen på nytt.

Last opp ny offentlig nøkkel

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

Slik bytter du ut den offentlige nøkkelen som brukes til å kryptere meldinger til en konto. Fiks IO sender krypterte meldinger. Det krever at kontoen har et offentlig/privat nøkkelpar. Den offentlige nøkkelen gjøres tilgjengelig for de som skal sende meldinger til kontoen, slik at de kan kryptere meldingene. Den private nøkkelen brukes til å dekryptere innkommende meldinger. Denne veiledningen viser hvordan du bytter offentlig nøkkel gjennom Fiks Forvaltning. Steg 1: Velg system Velg systemet som har kontoen du vil laste opp ny offentlig nøkkel til.

Koble til klienten

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

Slik konfigurerer du Fiks IO-klienten med verdiene fra oppsettet og begynner å utveksle meldinger. Når systemet, kontoen og tilgangene er på plass i Fiks Forvaltning, er siste steg å koble fagsystemet ditt til kontoen. Det gjøres med en Fiks IO-klient. KS tilbyr offisielle klienter for .NET og Java som håndterer autentisering, signering, kryptering og kø-kobling for deg. Verdier du trenger Klienten konfigureres med verdier fra de tidligere stegene:

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:

Fiks Arkiv

Thu, 28 May 2026 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

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

Beste praksis for meldingshåndtering

Thu, 21 May 2026 00:00:00 +0000

Slik håndterer en klient korrekt asynkron meldingsutveksling i Fiks Protokoll — hold tilkoblingen åpen, og bekreft hver melding med ack(). Fiks Protokoll er asynkron og kø-basert. Den vanligste feilen hos nye integrasjoner er at klienten ikke konsumerer meldinger riktig: meldinger blir liggende, leveres på nytt, havner i dead-letter-køen og går ut på tid. Denne siden samler reglene som gjelder alle protokoller og all meldingsutveksling over Fiks Protokoll. Hvem er dette for? Dette er for utviklere av klienter — både fagsystem og arkivsystem. Begge rollene både sender og mottar meldinger: et arkiv mottar forespørsler og sender kvitteringer, et fagsystem sender forespørsler og mottar mottatt-meldinger, kvitteringer og svar. Reglene under gjelder derfor begge.

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:

Tilgangsstyring

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

Hvordan gi og be om tilgang til å sende meldinger mellom systemer i Fiks Protokoll. Tilganger til Fiks Protokoll-systemer styres per konto. En konto kan gi et annet system tilgang til å sende meldinger til seg. Når et system opprettes vil det kun være synlig for kontoer under egen organisasjon. Skal systemet være synlig for kontoer i andre organisasjoner, må Tilgjengelig for andre organisasjoner slås på (per nå kun mulig via API).

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

Konfigurere systemet via API

Thu, 21 May 2026 00:00:00 +0000

Etter at protokollsystemet er opprettet, anbefaler vi at leverandøren konfigurerer resten via Fiks Protokoll Konfigurasjons-API — det er raskere, automatiserbart og enkelt å gjenta. Arbeidsdeling: GUI én gang, API resten Å opprette selve protokollsystemet kan kun gjøres av en administrator i kundens Fiks-organisasjon, i Fiks Forvaltning. Når systemet opprettes, er API-konfigurasjon aktivert som standard. Alt det videre oppsettet kan — og bør — leverandøren gjøre via Konfigurasjons-API-et i stedet for webgrensesnittet. Da slipper leverandøren manuell klikking i GUI for hver konto, og oppsettet blir enkelt å gjenta — for eksempel for nye kunder eller i testmiljøet.

Overvåking

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

Anbefalinger og APIer for å overvåke koblingsstatus og meldingskøer i Fiks Protokoll. Det anbefales at man overvåker at man har en fungerende mottakende komponent som henter meldinger fra køen. Siden meldinger har en time-to-live kan man risikere at de går ut på tid og ikke blir hentet. Det er også i ens egen interesse å svare på meldinger så fort som mulig. Hvordan man overvåker at man kan sende og motta meldinger er opp til en selv, men vi anbefaler at man i det minste overvåker koblingsstatus til Fiks IO for henting av meldinger.

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 IO

Thu, 28 May 2026 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.

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

Feilsøking

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

Sjekkliste for vanlige feilsituasjoner i Fiks Protokoll — symptom, årsak og løsning. Finn symptomet som passer, og følg løsningen. Får du ikke løst problemet, ta kontakt via kanalene nederst på siden. Kontoen viser «mangler kobling»-advarsel Symptom: I Fiks Forvaltning vises en advarsel om at én eller flere kontoer mangler kobling. Årsak: Ingen klient lytter på kontoens kø — kontoen har ikke et fagsystem «bak» seg som henter meldinger.

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

Ofte stilte spørsmål

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

Svar på spørsmål som ofte dukker opp ved oppsett og bruk av Fiks Protokoll. Hva er forskjellen på et protokollsystem og en protokollkonto? Et protokollsystem representerer et system som skal sende og motta meldinger — for eksempel et fagsystem eller et arkiv. Et system kan ha flere protokollkontoer, og hver konto er en part i én protokoll. Du oppretter først systemet, deretter én eller flere kontoer på systemet. Se Termer.

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

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.

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}

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

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.

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

Sun, 01 Jan 2017 00:00:00 +0000

Maven dependencies org.apache.httpcomponents httpclient 4.3.5 org.apache.httpcomponents httpmime 4.3.5 compile junit junit 4.10 test Maven plugin org.apache.maven.plugins maven-compiler-plugin 2.5.1 1.7 1.7 UTF-8 Kall av tjenesten public class TestMottakerService { public static String host = "https://svarut.ks.no"; public static String mottakerid = "AAAAAAA-AAAA-AAAA-AAAA-AAAAAAAAAAAA"; public static String passord = "AAAAAAAAAAA^AAAAAAAA(BBBBBBBBBBBB.BBBBBBBBB"; public static String forsendelsesId = "BBBBBBB-BBBB-BBBB-BBBB-BBBBBBBBBBBB"; @Test public void testMottakerServiceHentNyeForsendelser(){ String urlHentNyeForsendelser = "/tjenester/svarinn/mottaker/hentNyeForsendelser"; HttpGet request1 = new HttpGet(host+urlHentNyeForsendelser); System.out.println("Tester pendingForsendelser"); int statusCode = MottakerService.executeHttpsRequest(request1, mottakerid, passord); Assert.assertEquals("Forventet statuskode 200 fikk "+statusCode, 200, statusCode); } @Test public void testMottakerServiceHentForsendelseFil(){ String urlForsendelseFiler = "/tjenester/svarinn/forsendelse/"+forsendelsesId; HttpGet request2 = new HttpGet(host+urlForsendelseFiler); System.out.println("Tester getForsendelseFil"); int statusCode = MottakerService.executeHttpsRequest(request2, mottakerid, passord); Assert.assertEquals("Forventet statuskode 200 fikk "+statusCode, 200, statusCode); } @Test public void testMottakerServiceKvitterMottak(){ String urlKvitterMottak = "/tjenester/svarinn/kvitterMottak/forsendelse/"+forsendelsesId; HttpPost request3 = new HttpPost(host+urlKvitterMottak); System.out.println("Tester kvitterMottak"); int statusCode = MottakerService.executeHttpsRequest(request3, mottakerid, passord); Assert.assertEquals("Forventet statuskode 200 fikk "+statusCode, 200, statusCode); } }` Underliggende klient public static void executeHttpsRequest(HttpRequestBase request, String mottakerid, String passord){ DefaultHttpClient client = getDefaultClient(); CredentialsProvider credentialsProvider = new BasicCredentialsProvider(); credentialsProvider.setCredentials( AuthScope.ANY, new UsernamePasswordCredentials(mottakerid, passord)); client.setCredentialsProvider(credentialsProvider); try{ HttpResponse response = client.execute(request); byte[] responseBody = EntityUtils.toByteArray(response.getEntity()); if(response.getStatusLine().getStatusCode() != HttpStatus.SC_OK){ System.err.println("HTTP kallet feilet med kode: " + response.getStatusLine()); } else { System.out.println("HTTP kallet suksess med kode: " + response.getStatusLine()); System.out.println("Respons har data av type "+response.getEntity().getContentType()); } System.out.println("Respons meldingen er:"); System.out.println(new String(responseBody)); System.out.println(); } catch (ClientProtocolException e) { System.err.println("Fatal protocol violation: " + e.getMessage()); e.printStackTrace(); } catch (IOException e) { System.err.println("Fatal transport error: " + e.getMessage()); e.printStackTrace(); } finally { request.releaseConnection(); } }`

Signeringstjeneste

Sun, 01 Jan 2017 00:00:00 +0000

Aktivering Avtale om bruk av signeringstjenesten må gjøres med Digdir og forutsetter at dere allerede har avtale om DPI (Digital Post til Innbygger). Når avtalene er inngått må dere aktivere bruken av signeringstjenesten inne på konfigurasjon. Dette må gjøres på hver enkelt SvarUt-konto som skal benytte seg av signeringstjenesten. API Bruker operasjonen sendForsendelse, i ForsendelseServiceV7 eller senere.

Sikkerhet

Sun, 01 Jan 2017 00:00:00 +0000

Generelt om forsendelser Forsendelser kan, men må ikke, krypteres før de sendes inn til SvarUt. Forsendelsesfiler lagres kryptert på SvarUt sine servere. Forsendelser som lastes ned via SvarInn overføres kryptert og må dekrypteres før de blir importert til sakssystemet. Forsendelsesfiler som blir lastet ned av mottaker dekrypteres ellers i det de overføres til mottaker. Forsendelser på nivå 4 Det er mulig å sende forsendelser som inneholder sensitive persondata via SvarUt (ikke gradert informasjon). Dette kan være brev som sendes fra sikker sone.

SOAP V4

Sun, 01 Jan 2017 00:00:00 +0000

NB! Vi planlegger å avvikle støtte for alle gjenværende SOAP-versjoner i løpet av 2026, les mer her. Her beskrives funksjonalitet for ForsendelseServiceV4 WSDL Tilgang For å benytte webservicen må en bruke HTTP Basic autentication med brukernavn(avsendernavn) og service-passord. Avsender opprettes av KS-SvarUt administrator/organisasjons administrator og service-passordet genereres av avsender ansvarlig via konfigurasjon-siden.

SOAP V5

Sun, 01 Jan 2017 00:00:00 +0000

NB! Vi planlegger å avvikle støtte for alle gjenværende SOAP-versjoner i løpet av 2026, les mer her. Her beskrives funksjonalitet for ForsendelseServiceV5 WSDL Tilgang For å benytte webservicen må en bruke HTTP Basic autentication med brukernavn(avsendernavn) og service-passord. Avsender opprettes av KS-SvarUt administrator/organisasjons administrator og service-passordet genereres av avsender ansvarlig via konfigurasjon-siden.

SOAP V6

Sun, 01 Jan 2017 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. Tjenester Forsendelsesservicet tilbyr følgende funksjonalitet: Operasjon Inndata Utdata Kort beskrivelse sendForsendelse Forsendelse forsendelsesid Hovedtjeneste som sender inn forsendelse til ekspedering av KS-SvarUt. retrieveForsendelseStatus forsendelsesid ForsendelseStatus Henter status for en forsendelse. retrieveForsendelseStatuser List List Henter status for flere forsendelseer. Returnerer liste med status, når status oppstod og forsendelseid. retrieveForsendelseHistorikk forsendelsesid ForsendelseHistorikk Henter historikk for en forsendelse, tilsvarer ekspederingsloggen i forsendelsesoversikten. retrieveForsendelseIdByEksternRef eksternref List Henter liste med forsendelseider som har denne eksternRef. setForsendelseLestAvEksterntSystem forsendelsesid, lestAvFodselsnummer, navnPaEksterntSystem, datoLest (Ingen retur) Benyttes for å sette status til lest når dokumentet har blitt lest utenfor vårt system. Definisjonsfil (WSDL) for tjenesten finnes her https://svarut.ks.no/tjenester/forsendelseservice/ForsendelsesServiceV6?wsdl

SOAP V7

Sun, 01 Jan 2017 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. Tjenester Forsendelsesservicet tilbyr følgende funksjonalitet: Operasjon Inndata Utdata Kort beskrivelse sendForsendelse Forsendelse forsendelsesid Hovedtjeneste som sender inn forsendelse til ekspedering av KS-SvarUt. retrieveForsendelseStatus forsendelsesid ForsendelseStatus Henter status for en forsendelse. retrieveForsendelseStatuser List List Henter status for flere forsendelseer. Returnerer liste med status, når status oppstod og forsendelseid. retrieveForsendelseHistorikk forsendelsesid ForsendelseHistorikk Henter historikk for en forsendelse, tilsvarer ekspederingsloggen i forsendelsesoversikten. retrieveForsendelseIdByEksternRef eksternref List Henter liste med forsendelseider som har denne eksternRef. setForsendelseLestAvEksterntSystem forsendelsesid, lestAvFodselsnummer, navnPaEksterntSystem, datoLest (Ingen retur) Benyttes for å sette status til lest når dokumentet har blitt lest utenfor vårt system. Definisjonsfil (WSDL) for tjenesten finnes her https://svarut.ks.no/tjenester/forsendelseservice/ForsendelsesServiceV7?wsdl

SOAP V9

Sun, 01 Jan 2017 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. Tjenester Forsendelsesservicet tilbyr følgende funksjonalitet: Operasjon Inndata Utdata Kort beskrivelse sendForsendelse Forsendelse forsendelsesid Hovedtjeneste som sender inn forsendelse til ekspedering av KS-SvarUt. retrieveForsendelseStatus forsendelsesid ForsendelseStatus Henter status for en forsendelse. retrieveForsendelseStatuser List List Henter status for flere forsendelseer. Returnerer liste med status, når status oppstod og forsendelseid. retrieveForsendelseHistorikk forsendelsesid ForsendelseHistorikk Henter historikk for en forsendelse, tilsvarer ekspederingsloggen i forsendelsesoversikten. retrieveForsendelseIdByEksternRef eksternref List Henter liste med forsendelseider som har denne eksternRef. setForsendelseLestAvEksterntSystem forsendelsesid, lestAvFodselsnummer, navnPaEksterntSystem, datoLest (Ingen retur) Benyttes for å sette status til lest når dokumentet har blitt lest utenfor vårt system. retreiveForsendelseTyper List Henter alle forsendelseTyper som kan brukes i SvarInn. retrieveMottakerSystemForOrgnr organisasjonsnr Liste med orgnr, forsendelseType, nivå, mottakersystem, mottakersystemid Henter alle konfigurerte mottakersystem for orgnr Definisjonsfil (WSDL) for tjenesten finnes her https://svarut.ks.no/tjenester/forsendelseservice/ForsendelsesServiceV8?wsdl

SOAP V9

Sun, 01 Jan 2017 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. Tjenester Forsendelsesservicet tilbyr følgende funksjonalitet: Operasjon Inndata Utdata Kort beskrivelse sendForsendelse Forsendelse forsendelsesid Hovedtjeneste som sender inn forsendelse til ekspedering av KS-SvarUt. retrieveForsendelseStatus forsendelsesid ForsendelseStatus Henter status for en forsendelse. retrieveForsendelseStatuser List List Henter status for flere forsendelseer. Returnerer liste med status, når status oppstod og forsendelseid. retrieveForsendelseHistorikk forsendelsesid ForsendelseHistorikk Henter historikk for en forsendelse, tilsvarer ekspederingsloggen i forsendelsesoversikten. retrieveForsendelseIdByEksternRef eksternref List Henter liste med forsendelseider som har denne eksternRef. setForsendelseLestAvEksterntSystem forsendelsesid, lestAvFodselsnummer, navnPaEksterntSystem, datoLest (Ingen retur) Benyttes for å sette status til lest når dokumentet har blitt lest utenfor vårt system. retreiveForsendelseTyper List Henter alle forsendelseTyper som kan brukes i SvarInn. retrieveMottakerSystemForOrgnr organisasjonsnr Liste med orgnr, forsendelseType, nivå, mottakersystem, mottakersystemid Henter alle konfigurerte mottakersystem for orgnr retrieveSigneringshistorikk forsendelsesid Signeringshistorikk Henter signeringshistorikk (logg) på en forsendelse som er markert for signering. retrieveSigneringshistorikkForFlereForsendelser List List Henter signeringshistorikk for opp til 10 forsendelser. Definisjonsfil (WSDL) for tjenesten finnes her https://svarut.ks.no/tjenester/forsendelseservice/ForsendelsesServiceV9?wsdl

SvarInn

Sun, 01 Jan 2017 00:00:00 +0000

Mottaksservice tilsvarer svarinn og gjør det mulig å laste ned og kvittere ut forsendelser før de varsles gjennom Altinn og sendes til eventuell printing. Hva er Mottaksservice? Primært brukes Mottaksservice til å automatisere nedlasting og import av forsendelser direkte i sakssystemer. Fra en forsendelse er mottatt i SvarUt er den tilgjengelig for nedlasting via mottaksservicen. Dersom forsendelsen ikke blir lastet ned innen 2 timer vil mottakersystem få en advarsel mail.

SvarInn V1

Sun, 01 Jan 2017 00:00:00 +0000

Her beskrives funksjonalitet for Mottaksservice V1. For å sikre bakoverkompatibilitet for klientene så vil denne versjonen ikke endres. Tilgang Tjenesten bruker HTTP Basic autentication med brukernavn og generert service-passord. Mottakersystem opprettes av KS-SvarUt administrator og service-passordet genereres av person med tilgang via mottakersystem-siden. Dersom autentiseringen feiler returneres HTTP-status 401 Unauthorized, og ukjent URL gir HTTP-status 404. Detaljerte feilmeldinger følger også ved feil.

SvarUt - SvarInn adressering

Sun, 01 Jan 2017 00:00:00 +0000

Tidligere hadde vi kun orgnr-adressering på forsendelser. Nå har SvarUt fått støtte for ForsendelseType. ForsendelseType skal beskrive hvilken type forsendelse dette er. Det er KS som styrer hvilken typer en kan benytte til adressering, hvis det er ønskelig med ny type sendes ønske om dette til fiks@ksdigital.no. Mottakersystem kan nå filtrere på 3 felt, orgnr, forsendelseType og nivå. For å konfigurere to mottakersystem på samme orgnr, kan en derfor filtrere videre på forsendelseType.

API: SvarInn REST

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

Her beskrives funksjonalitet for bruk av SvarInn V2. Dokumentasjon for tidligere versjoner finnes i versjonsoversikten. Tilgang Tjenesten bruker HTTP Basic autentication med brukernavn og generert service-passord. Mottakersystem opprettes av administrator hos KS Digital. Service-passordet genereres av person med tilgang via mottakersystem-siden. Dersom autentiseringen feiler returneres HTTP-status 401 Unauthorized, og ukjent URL gir HTTP-status 404. Detaljerte feilmeldinger følger også ved feil. Henting og kvittering av forsendelser Forsendelser er tilgjengelig for direkte import til sakssystem helt til de kvitteres ut. Dersom en forsendelse markeres som permanent feilet vil den gå videre i det normale løpet med varsling i Altinn og eventuelt fysisk post dersom den ikke leses digitalt og avsender har sagt at post til virksomheter skal ettersendes.

API: SvarUt REST

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

Tilgang Autentisering og autorisering skjer ved bruk av OAuth 2.0 med Fiks-integrasjoner og Maskinporten, som beskrevet her. Tilganger må tildeles integrasjoner på alle kontoene de skal ha lov til å utføre operasjoner for. Tilgang til en forsendelse autoriseres via avsenderkontoen. Feilmeldinger Generell informasjon om feilmeldinger på Fiks-plattformen finnes her. Forsendelse Send Sending av forsendelser: OpenAPI spec For mer detaljer om sending av dokumenter, se her.

API: Versjonsoversikt

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

REST API-er NB! Vi planlegger å avvikle støtte for REST V1 i løpet av 2026, les mer her. Det kommer ikke ny funksjonalitet for SOAP-servicen etter V11. Nye endringer og features vil komme i REST-servicene. Dersom JSON-strukturen bli forandret vil det komme en ny versjon av servicen. Alle implementasjoner må takle at det kan legges til nye JSON-felt, og at eksisterende ikke-obligatoriske felt kan forsvinne.