/ Recent content in KS Fiks dokumentasjon on KS Fiks Hugo -- gohugo.io nb-no Mon, 23 Mar 2020 00:00:00 +0000 /tjenester/fiks-tilgangsstyring-til-eksterne-applikasjoner/tilbyder/ Mon, 01 Jan 0001 00:00:00 +0000 /tjenester/fiks-tilgangsstyring-til-eksterne-applikasjoner/tilbyder/ 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 1. /tjenester/fiks-nav-hjelpemiddel-api/ Mon, 09 Mar 2026 00:00:00 +0000 /tjenester/fiks-nav-hjelpemiddel-api/ Kort beskrivelse Fiks Nav hjelpemiddel gir tilgang til api hos nav via Fiks plattformen. Tjenesten benyttes mot kommunens løsning for lager, logistikk og samhandling på hjelpemiddelområdet. Tilgjengelige grensesnitt Grensesnitt Støtte Web portal Nei Maskin til maskin Api-spec Produktbeskrivelse Om Fiks Nav hjelpemiddel Integrasjon (API) for å dele data fra NAV til kommunen sitt fagsystem. Dele status på utleveringer tilbake til NAV) For å ta i bruk dette apiet må mottakerløsning innfri de juridiske kravene nedfelt i avtale med Nav. /tjenester/minkommune/oppgave/ Thu, 05 Feb 2026 00:00:00 +0000 /tjenester/minkommune/oppgave/ 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. Tilgjengelige grensesnitt Grensesnitt Støtte Web portal Ja Maskin til maskin Ja Beskrivelse av api Oppgave En oppgave fungerer som en referanse, og kan omfatte flere forskjellige typer av offentlige oppgaver. /tjenester/svarut/sendmeddokumenter/ Sun, 01 Feb 2026 00:00:00 +0000 /tjenester/svarut/sendmeddokumenter/ 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. /tjenester/svarut/sendenhn/ Sun, 01 Feb 2026 00:00:00 +0000 /tjenester/svarut/sendenhn/ 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. /tjenester/eiendomsavtaler/ Wed, 12 Nov 2025 00:00:00 +0000 /tjenester/eiendomsavtaler/ 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. /tjenester/register/kontaktregisteret/ Mon, 06 Oct 2025 00:00:00 +0000 /tjenester/register/kontaktregisteret/ 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. Miljøer OpenAPI/Swagger og oppbygging av endepunkter** Miljø URL Test (Integrasjon) http​s://api. /tjenester/svarut/testmiljo/ Fri, 03 Oct 2025 00:00:00 +0000 /tjenester/svarut/testmiljo/ 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 /tjenester/fiksprotokoll/protokoll-link/ Mon, 16 Dec 2024 00:00:00 +0000 /tjenester/fiksprotokoll/protokoll-link/ Fiks Link - protokoll som erstatning for GI Link Les mer om protokollen i Github repoet: fiks-link-specification /tjenester/fiksprotokoll/protokoll-saksfaser/ Mon, 16 Dec 2024 00:00:00 +0000 /tjenester/fiksprotokoll/protokoll-saksfaser/ Fiks Saksfaser - protokoll for henting av saksfaser Les mer om protokollen i Github repoet: fiks-saksfaser-specification /tjenester/bekymringsmelding/bekymringsmelding_v2/ Thu, 03 Oct 2024 00:00:00 +0000 /tjenester/bekymringsmelding/bekymringsmelding_v2/ 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. Til fagsystem - mottak av bekymringsmeldinger Fagsystemet vil motta enten en privat bekymringsmelding, no. /tjenester/samtykke/ Thu, 12 Sep 2024 00:00:00 +0000 /tjenester/samtykke/ 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: /tjenester/register/skatteoginntektsopplysninger_ny/ Tue, 13 Aug 2024 00:00:00 +0000 /tjenester/register/skatteoginntektsopplysninger_ny/ 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. /tjenester/klientpakker/ Tue, 19 Sep 2023 00:00:00 +0000 /tjenester/klientpakker/ 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: Tredjepart laster opp kompromitterte pakker til Maven Central eller nuget. /tjenester/fiksmelding/edialog/ Wed, 13 Sep 2023 00:00:00 +0000 /tjenester/fiksmelding/edialog/ 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. /tjenester/svarut/edialog/ Thu, 29 Jun 2023 00:00:00 +0000 /tjenester/svarut/edialog/ 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. /tjenester/fiksprotokoll/protokoll-ssbbarnevern/ Wed, 22 Mar 2023 00:00:00 +0000 /tjenester/fiksprotokoll/protokoll-ssbbarnevern/ 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 /tjenester/fiksmelding/del_dokument/ Fri, 06 Jan 2023 00:00:00 +0000 /tjenester/fiksmelding/del_dokument/ 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. /tjenester/fiksmelding/fiks-sms/ Fri, 06 Jan 2023 00:00:00 +0000 /tjenester/fiksmelding/fiks-sms/ 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. Bruk av Fiks SMS Swagger-dokumentasjon: https://editor-next.swagger.io/?url=https://developers.fiks.ks.no/api/varsling-sms-api-v2.json Viktig angående meldingstekst for SMS: /tjenester/register/skatteoginntektsopplysninger_gammel/ Fri, 02 Dec 2022 00:00:00 +0000 /tjenester/register/skatteoginntektsopplysninger_gammel/ 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. API-grensesnittet er ikke ferdig utviklet og endringer kan fortsatt forekomme. Tilgjengelige grensesnitt Grensesnitt Støtte Web portal Ja Maskin til maskin Api spec v2 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. /tjenester/register/skatteoginntektsopplysninger_proxy/ Fri, 02 Dec 2022 00:00:00 +0000 /tjenester/register/skatteoginntektsopplysninger_proxy/ 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): <MILJØ_URL>/skatteetaten/formueinntekt/summertskatt/api/v2/{ROLLE_ID}/{STADIE}/{RETTIGHETSPAKKE}/{INNTEKTSAAR}/{PERSONIDENTIFIKATOR} API-dokumentasjon Skatteetaten har lagt ut dokumentasjon her Summert skattegrunnlag og Swagger Eksempel { "personidentifikator": "03870349520", "inntektsaar": "2021", "skjermet": false, "grunnlag": [ { "tekniskNavn": "samledeOpptjenteRenterIInnenlandskeBanker", "beloep": 19015, "kategori": "inntekt" }, { "tekniskNavn": "samletPensjonFraFolketrygden", "beloep": 894828, "kategori": "inntekt" }, { "tekniskNavn": "samletAvkastningAvKapitalforsikringsavtale", "beloep": 286299, "kategori": "inntekt" } ], "skatteoppgjoersdato": "2022-02-10", "stadie": "oppgjoer", "ajourholdstidspunkt": "2022-02-10T15:17:37Z" } Beregnet skatt URL for proxy-api (GET): <MILJØ_URL>/skatteetaten/formueinntekt/beregnetskatt/api/v1/{ROLLE_ID}/{RETTIGHETSPAKKE}/{INNTEKTSAAR}/{PERSONIDENTIFIKATOR} /tjenester/fiksprotokoll/veiledning_1_huskeliste_for_opprette_protokoll/ Fri, 23 Sep 2022 00:00:00 +0000 /tjenester/fiksprotokoll/veiledning_1_huskeliste_for_opprette_protokoll/ 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. /tjenester/fiksprotokoll/veiledning_2_ta_ibruk_protokoll/ Fri, 23 Sep 2022 00:00:00 +0000 /tjenester/fiksprotokoll/veiledning_2_ta_ibruk_protokoll/ 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. /tjenester/fiksprotokoll/veiledning_3_opprette_system/ Fri, 23 Sep 2022 00:00:00 +0000 /tjenester/fiksprotokoll/veiledning_3_opprette_system/ 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 Steg 2: Klikk opprett system Her vil det være en liste over systemer. /tjenester/fiksprotokoll/veiledning_4_opprette_konto/ Fri, 23 Sep 2022 00:00:00 +0000 /tjenester/fiksprotokoll/veiledning_4_opprette_konto/ 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” Steg 4: Navn og beskrivelse Fyll ut navn og beskrivelse. Dette vil identifisere kontoen for andre Steg 5: Velg protokoll Velg protokoll fra nedtrekksmenyen. Dette bestemmer hvilken meldingsprotokoll kontoen hører til, og den vil kun kommunisere med kontoer i samme protokoll. Steg 6: Velg Protokollpart Velg protokollpart fra nedtrekksmenyen. /tjenester/fiksprotokoll/veiledning_5_gi_tilgang_til_system/ Fri, 23 Sep 2022 00:00:00 +0000 /tjenester/fiksprotokoll/veiledning_5_gi_tilgang_til_system/ 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. Steg 3: Velg Konto Velg kontoen i arkivet som fagsystemet skal få tilgang til. /tjenester/fiksprotokoll/veiledning_6_nytt_passord/ Fri, 23 Sep 2022 00:00:00 +0000 /tjenester/fiksprotokoll/veiledning_6_nytt_passord/ 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. Steg 2: Velg konfigurasjon Velg “konfigurasjon”-fanen. Steg 3: Trykk på generer passord Trykk på knappen “Generer nytt passord”. Det kan hende du må skrolle ned på siden for å finne knappen. /tjenester/fiksprotokoll/veiledning_7_laste_opp_ny_offentlig_nokkel/ Fri, 23 Sep 2022 00:00:00 +0000 /tjenester/fiksprotokoll/veiledning_7_laste_opp_ny_offentlig_nokkel/ 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 Steg 2: Velg kontoer Velg kontoer for å komme til oversikten over kontoer Steg 3: Velg konto Velg kontoen du ønsker å laste opp ny offentlig nøkkel til Steg 4: Velg konfigurasjon Velg konfigurasjon Steg 5: Velg endre Gå til seksjonen for offentlig nøkkel og trykk på “endre” Steg 6: Last opp offentlig nøkkel Trykk på “Velg en fil” under “Last opp offentlig nøkkel”. /tjenester/minkommune/faktura/ Tue, 28 Jun 2022 00:00:00 +0000 /tjenester/minkommune/faktura/ 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. Fakturadata Funksjonaliteten skal gjøre det mulig å dra ut fakturadetaljer og presentere dem enklere, i tillegg til pdf-versjonen for å tilby bedre informasjon til innbyggere som ikke har PC /tjenester/minkommune/innsyn/ Tue, 28 Jun 2022 00:00:00 +0000 /tjenester/minkommune/innsyn/ 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. /tjenester/minkommune/kommunaletjenester/ Tue, 28 Jun 2022 00:00:00 +0000 /tjenester/minkommune/kommunaletjenester/ 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. /tjenester/minkommune/matrikkel/ Tue, 28 Jun 2022 00:00:00 +0000 /tjenester/minkommune/matrikkel/ 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. /tjenester/kslering/singlesignon/ Thu, 23 Jun 2022 00:00:00 +0000 /tjenester/kslering/singlesignon/ 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. /tjenester/fiksprotokoll/protokoll-plan/ Thu, 16 Jun 2022 00:00:00 +0000 /tjenester/fiksprotokoll/protokoll-plan/ 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: Type Nuget Github Json skjema og spesifikasjonen - https://github. /tjenester/register/folkeregister/ Fri, 18 Feb 2022 00:00:00 +0000 /tjenester/register/folkeregister/ 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. /tjenester/fiksprotokoll/fiksio/ Fri, 17 Dec 2021 00:00:00 +0000 /tjenester/fiksprotokoll/fiksio/ 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. Meldingstyper defineres i Fiks Protokoll /tjenester/fiksprotokoll/protokoll-matrikkelfoering/ Wed, 18 Aug 2021 00:00:00 +0000 /tjenester/fiksprotokoll/protokoll-matrikkelfoering/ 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 Hvordan ta i bruk Fiks Matrikkelføring For at eByggesak eller annet fagsystem skal få tilgang til å sende grunnlag for matrikkelføring til matrikkelklienter, så må kommunen aktivere tjenesten Fiks IO i Fiks Konfigurasjon. /tjenester/fiksprotokoll/protokoll-arkiv/ Thu, 29 Jul 2021 00:00:00 +0000 /tjenester/fiksprotokoll/protokoll-arkiv/ 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. /tjenester/svarut/integrasjon/kodeeksempeldotnet/ Mon, 22 Feb 2021 00:00:00 +0000 /tjenester/svarut/integrasjon/kodeeksempeldotnet/ Eksempel på Soap integrasjon: kodeeksempel Klient api til rest servicen, laget av dibk: https://bitbucket.org/dibk/ftpb-svarut-client/src/master/ /tjenester/svarut/integrasjon/kodeeksempeljava/ Mon, 22 Feb 2021 00:00:00 +0000 /tjenester/svarut/integrasjon/kodeeksempeljava/ Kodeeksempel soap på github kodeeksempel Rest klient for java https://github.com/ks-no/svarut-rest-klient /tjenester/digisos/ Tue, 27 Oct 2020 00:00:00 +0000 /tjenester/digisos/ Kort beskrivelse Fiks Digisos er en tjeneste for å tilrettelegge for kommunal behandling av sosialsøknader via et brukergrensesnitt på nav.no. Fiks Digisos tilbyr: Enkelt oppsett for den enkelte kommune gjennom Fiks Konfigurasjon. Innbygger får fortløpende oppdatering på saksgang, tilgjengelig på nav.no. Innbygger får tilgang til alle dokumenter og mulighet til å sende inn nye søknader basert på data fra tidligere søknader. Ansatte/brukerstøtte i NAV kan se utvalgte deler av saken via NAV sine systemer. /tjenester/kslering/integrasjon/ Fri, 16 Oct 2020 00:00:00 +0000 /tjenester/kslering/integrasjon/ 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. Presentasjon API. /felles/difiidportenklient/ Tue, 09 Jun 2020 00:00:00 +0000 /felles/difiidportenklient/ 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. Godkjenne bruksvilkår for bruk av maskinporten En må først ha godkjent bruksvilkår hos Digdir. /felles/sikkerhet/ Fri, 17 Apr 2020 00:00:00 +0000 /felles/sikkerhet/ 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. /tjenester/kjoretoyregister/ Wed, 11 Dec 2019 00:00:00 +0000 /tjenester/kjoretoyregister/ 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. Tilgjengelige grensesnitt Grensesnitt Støtte Web portal Nei Maskin til maskin Api spec Hvordan tar jeg i bruk Fiks Kjøretøyregister Fiks Kjøretøyregister er en tjeneste for maskin-til-maskin integrasjon. /tjenester/bekymringsmelding/bekymringsmelding_v1/ Mon, 25 Nov 2019 00:00:00 +0000 /tjenester/bekymringsmelding/bekymringsmelding_v1/ 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. /felles/integrasjoner/ Thu, 19 Sep 2019 00:00:00 +0000 /felles/integrasjoner/ 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. /tjenester/svarut/integrasjon/soapv11/ Tue, 07 May 2019 00:00:00 +0000 /tjenester/svarut/integrasjon/soapv11/ 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. /tjenester/svarut/integrasjon/restv1/ Thu, 11 Apr 2019 00:00:00 +0000 /tjenester/svarut/integrasjon/restv1/ 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 Url Method Input Utdata Kort beskrivelse /sendForsendelse POST Forsendelse ForsendelsesId Hovedtjeneste som sender inn forsendelse til ekspedering av KS-SvarUt. /tjenester/dokumentlager/ Mon, 10 Sep 2018 00:00:00 +0000 /tjenester/dokumentlager/ 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. /felles/testmiljo/ Tue, 29 May 2018 00:00:00 +0000 /felles/testmiljo/ 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. /tjenester/svarut/integrasjon/soapv10/ Fri, 11 May 2018 00:00:00 +0000 /tjenester/svarut/integrasjon/soapv10/ 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. /tjenester/svarut/integrasjon/kodeeksempelmottakerrest/ Sun, 01 Jan 2017 00:00:00 +0000 /tjenester/svarut/integrasjon/kodeeksempelmottakerrest/ Maven dependencies <dependency> <groupId>org.apache.httpcomponents</groupId> <artifactId>httpclient</artifactId> <version>4.3.5</version> </dependency> <dependency> <groupId>org.apache.httpcomponents</groupId> <artifactId>httpmime</artifactId> <version>4.3.5</version> <scope>compile</scope> </dependency> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>4.10</version> <scope>test</scope> </dependency> Maven plugin <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-compiler-plugin</artifactId> <version>2.5.1</version> <configuration> <source>1.7</source> <target>1.7</target> <encoding>UTF-8</encoding> </configuration> </plugin> 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. /tjenester/svarut/signeringstjeneste/ Sun, 01 Jan 2017 00:00:00 +0000 /tjenester/svarut/signeringstjeneste/ 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. Følgende eksisterende felter må fylles ut: /sendForsendelse/forsendelse/krevNiva4Innlogging - Angir hvilket nivå som skal brukes på signeringen /sendForsendelse/forsendelse/svarSendesTil[@Type=organisasjon]/orgnr - Organisasjonsnummer til enhenten som skal ha det signerte dokumentet i retur /sendForsendelse/forsendelse/mottaker[@Type=privatPerson]/fodselsnr - Fødselsnummer på mottaker av signeringsoppdraget Følgende nye felter må også fylles ut: /tjenester/svarut/forsendelser-og-sikkerhet/ Sun, 01 Jan 2017 00:00:00 +0000 /tjenester/svarut/forsendelser-og-sikkerhet/ 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). /tjenester/svarut/integrasjon/soapv4/ Sun, 01 Jan 2017 00:00:00 +0000 /tjenester/svarut/integrasjon/soapv4/ 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. Tjenester Forsendelsesservicet tilbyr følgende funksjonalitet: sendForsendelse Hovedtjeneste som sender inn forsendelse til ekspedering av KS-SvarUt. Følgende metadata inkluderes: /tjenester/svarut/integrasjon/soapv5/ Sun, 01 Jan 2017 00:00:00 +0000 /tjenester/svarut/integrasjon/soapv5/ 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. Tjenester Forsendelsesservicet tilbyr følgende funksjonalitet: sendForsendelse Hovedtjeneste som sender inn forsendelse til ekspedering av KS-SvarUt. Følgende metadata inkluderes: /tjenester/svarut/integrasjon/soapv6/ Sun, 01 Jan 2017 00:00:00 +0000 /tjenester/svarut/integrasjon/soapv6/ 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. /tjenester/svarut/integrasjon/soapv7/ Sun, 01 Jan 2017 00:00:00 +0000 /tjenester/svarut/integrasjon/soapv7/ 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. /tjenester/svarut/integrasjon/soapv8/ Sun, 01 Jan 2017 00:00:00 +0000 /tjenester/svarut/integrasjon/soapv8/ 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. /tjenester/svarut/integrasjon/soapv9/ Sun, 01 Jan 2017 00:00:00 +0000 /tjenester/svarut/integrasjon/soapv9/ 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. /tjenester/svarut/svarinn-mottakservice/ Sun, 01 Jan 2017 00:00:00 +0000 /tjenester/svarut/svarinn-mottakservice/ 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. /tjenester/svarut/svarinn/svarinnv1/ Sun, 01 Jan 2017 00:00:00 +0000 /tjenester/svarut/svarinn/svarinnv1/ 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. Tjenester Forsendelser er tilgjengelig for direkte import til sakssystem i uendelig tid. /tjenester/svarut/svarut-svarinn-adressering/ Sun, 01 Jan 2017 00:00:00 +0000 /tjenester/svarut/svarut-svarinn-adressering/ 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. /_header/ Mon, 01 Jan 0001 00:00:00 +0000 /_header/ /tjenester/svarut/svarinn-rest/ Mon, 01 Jan 0001 00:00:00 +0000 /tjenester/svarut/svarinn-rest/ 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. /tjenester/svarut/rest/ Mon, 01 Jan 0001 00:00:00 +0000 /tjenester/svarut/rest/ 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. Endepunktet for sending i versjon 3 er delt opp basert på hvilken type mottaker forsendelsen skal sendes til. /tjenester/svarut/api-versjoner/ Mon, 01 Jan 0001 00:00:00 +0000 /tjenester/svarut/api-versjoner/ 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. API Versjon Status Dato for avvikling Endringer Send (spec) V3 Stabil - Sending av forsendelser til mottakere i Norsk Helsenett (NHN)Separate endepunkter for sending til forskjellige mottakertyper (person, organisasjon, NHN, direkte til print) Send (spec) V2 Erstattet - Benytter Fiks integrasjonsautentisering og MaskinportenEndepunkter gruppert slik at de kan versjoneres hver for seg Lest (spec) V2 Stabil - Benytter Fiks integrasjonsautentisering og MaskinportenEndepunkter gruppert slik at de kan versjoneres hver for seg Slett (spec) V2 Stabil - Benytter Fiks integrasjonsautentisering og MaskinportenEndepunkter gruppert slik at de kan versjoneres hver for seg Status (spec) V3 Stabil - Lagt til nye statuser for V3 API.