Allmänna behandlingsregler

Denna sida är preliminär och kompletteras under hösten 2026 i takt med att utvecklingen av gränssnittsversion 12 framskrider.

Regler för publicering av innehåll

Publicering av innehåll

• Via gränssnittsversion 12 kan endast innehåll med statusen publicerad föras in och uppdateras.
• En språkversion av en tjänst eller en servicekanal kan publiceras endast när tjänstens huvudansvariga organisation eller servicekanalens organisation har publicerats på språkversionen i fråga.

Hämtning av innehåll

• Via gränssnittet kan endast publicerat innehåll hämtas.
• Undantag: Arkiverat innehåll (t.ex. tjänster och servicekanaler) kan hämtas så att integratören kan ta bort det arkiverade innehållet ur sitt eget system.

Innehållets synlighet i webbtjänsten Suomi.fi

• I Suomi.fi visas de organisationer, tjänster och servicekanaler som har publicerats. Om en organisation inte har publicerade tjänster eller servicekanaler visas inte organisationens uppgifter.

Allmänna regler för uppgifter

Regler för innehållets status

• Tillåtna statusövergångar är följande (kompletteras senare)

Språkversioner

• De möjliga språkversionerna för innehåll är finska, svenska, engelska, nordsamiska, enaresamiska och skoltsamiska

Formaterat textfält

• I fältet (t.ex. Beskrivning av tjänsten) kan text matas in med formateringar (t.ex. rubriker, listor och markeringar). Begränsningar: det är inte möjligt att lägga till bilder och hyperlänkar. Gränssnittet tar emot och returnerar formateringar enligt Markdown-syntaxen.

Områdesuppgifter

• Välj ett av följande: Hela landet, Hela landet utom Åland, Avgränsat område
• Om Avgränsat område har valts som områdesuppgift, se punkten Områdesuppgifter -avgränsat område

Områdesuppgifter -avgränsat område

• Välj minst ett alternativ (kommun, landskap eller välfärdsområde)
• Kommun: en eller flera kommuner kan väljas
• Landskap: ett eller flera landskap kan väljas
• Välfärdsområde: ett eller flera välfärdsområden kan väljas
• Du kan välja flera alternativ för alla följande punkter: Kommun, Landskap, Välfärdsområde. Det är alltså möjligt att välja till exempel tre kommuner, ett landskap och ett välfärdsområde.

Servicetid

• se Behandlingsregler för servicetider

Telefonservicekanalens telefonnummer

• Riktnummer är obligatoriskt
• Telefonnummer är obligatoriskt. Telefonnumrets maximilängd är 20 tecken.
• Tilläggsuppgift är valfri. Tilläggsuppgiftens maximilängd är 300 tecken.
• Uppgift om samtalspris är obligatorisk. Välj ett av följande: Avgiftsbelagd, Avgiftsfri, Belagd med tilläggsavgift
• Beskrivning av prisuppgiften är obligatorisk om Belagd med tilläggsavgift har valts som prisuppgift. Beskrivningen av prisuppgiftens maximilängd är 300 tecken.

Webbplats

• Namn är obligatoriskt
• Namnets maximilängd är 100 tecken
• Webbadress är obligatorisk
• Webbadressens maximilängd är 500 tecken.
• Webbadressen ska börja med teckensträngen http:// eller https://.
• Beskrivning är valfri
• Beskrivningens maximilängd är 500 tecken

Platsuppgifter

Kan vara gatuadress, övriga platsuppgift eller utländsk adress

Kontaktuppgifter

Kan vara e-postadress, faxnummer, telefonnummer, webbplats eller postadress.

Postadressen kan vara gatuadress, postboxadress eller utländsk adress.

E-postadress

• E-postadress är obligatorisk
• E-postadressens maximilängd är 100 tecken.
• Tilläggsuppgift är valfri.
• Tilläggsuppgiftens maximilängd är 150 tecken.

Användarstöd - e-postadress

• E-postadress är obligatorisk
• E-postadressens maximilängd är 100 tecken

Faxnummer

• Landsspecifikt riktnummer är obligatoriskt
• Telefonnummer är obligatoriskt
• Telefonnumrets maximilängd är 20 tecken

Telefonnummer

• Är numret ett finskt riksomfattande servicenummer som man inte kan ringa till från utlandet? Ja/Nej
• Riktnummer är obligatoriskt om svaret på "Är numret ett finskt (riksomfattande) servicenummer" är Nej
• Telefonnummer är obligatoriskt. Telefonnumrets maximilängd är 20 tecken.
• Tilläggsuppgift är valfri. Tilläggsuppgiftens maximilängd är 300 tecken.
• Uppgift om samtalspris är obligatorisk. Välj ett av följande: Avgiftsbelagd, Avgiftsfri, Annan
• Beskrivning av prisuppgiften är obligatorisk om Annan har valts som prisuppgift. Beskrivningen av prisuppgiftens maximilängd är 300 tecken.

Gatuadress

• Gatunamn är obligatoriskt
• Gatunamnets maximilängd är 100 tecken
• Adressnummer är valfritt
• Adressnumrets maximilängd är 30 tecken
• Postnummer och postanstalt är obligatoriska
• Postnumrets maximilängd är 5 tecken.
• Tilläggsuppgift om adressen är valfri
• Tilläggsuppgiftens maximilängd är 300 tecken

Postboxadress

• Postboxadress är obligatorisk
• Postboxadressens maximilängd är 30 tecken
• Postnummer och postanstalt är obligatoriska
• Postnumrets maximilängd är 5 tecken
• Tilläggsuppgift om adressen är valfri
• Tilläggsuppgiftens maximilängd är 300 tecken

Övriga platsuppgifter

• Postnummer och postanstalt är valfria
• Postnumrets maximilängd är 5 tecken
• Latitud är obligatorisk
• Longitud är obligatorisk
• Tilläggsuppgift om adressen är valfri
• Tilläggsuppgiftens maximilängd är 300 tecken

Utländsk adress

• Utländsk adress i fri text är valfri
• Maximilängden för den utländska adressen i fri text är 500 tecken
• Land (landskod) där adressen är belägen är obligatoriskt

Kod för SDL:s datainnehåll

Content id – SDL:s interna kod

Kod som specificerar innehållet och som genereras av SDL. Förblir alltid oförändrad även om nya versioner av innehållet skapas.

• Content id är unik inom samma innehållstyp i SDL

Content id – användning vid uppdateringar

• Content id används för att uppdatera innehåll med API:s PUT-metoder

Versionens id -versionskod

En kod som specificerar innehållets version och som genereras av SDL. Alla versioner av samma innehåll har samma content id och olika version id.

Extern kod för SDL:s datainnehåll

ExternalId – extern kod

En kod som specificerar innehållet och som kommer från ett externt källsystem.

• ExternalId är unik inom samma organisation (API-identifierare) och innehållstyp i SDL.
• Om externalId inte ges i samband med skapandet kan det inte läggas till senare.
• Obs. externalId kan inte användas som kod för att uppdatera innehållet med API:s PUT- eller DELETE-metoder.

Exempel enligt innehållstyp:

• Organisation: varje organisation ska ha en egen unik externalId. Det kan vara detsamma som externalId för en tjänst eller kanal.
• Tjänst: varje tjänst ska ha en egen unik externalId. Det kan vara samma som externalId för en organisation eller kanal.
• Servicekanal: varje servicekanal ska ha en egen unik externalId. Det kan vara samma som externalId för en organisation eller tjänst.
• Undantag: olika typer av servicekanaler (t.ex. telefonkanalen och servicestället) får inte användas från samma externalId.