Hyppää sisältöön


  • Testauksen tilanne

    Näytä visualisointi suurempana

     

    Kuntien ja kuntayhtymien sekä heidän tietotoimittajiensa testaustilanne syyskuussa.2019. Ensisijaisesti testiaineistoa odotetaan Kuntatalouden tietopalveluun talousarvio ja -suunnitelma -raportointikokonaisuuden osalta (tilanne 14.11.2019).

     

    Alla on kuvattu testauksen tilanne suhteessa tavoiteltuun tilanteeseen. Tavoite on, että marraskuussa 2019 kaikki kunnat ovat onnistuneesti testanneet talousarvio ja -suunnitelma -raportointikokonaisuuden lähettämisen Kuntatalouden tietopalveluun.

    Kuntien, kuntayhtymien ja tietotoimittajien testaustilanne suhteessa tavoitetilanteeseen

  • Kuntien ja kuntayhtymien valmius taloustietojen toimittamiseen

  • Kirjautuminen Kuntatalouden tietopalvelun testipuolelle

    Kuntatalouden tietopalvelun (nk. Hyväksyntäpalvelu) testipuolella kunnat ja kuntayhtymät voivat katsella, hyväksyä ja raportoida testiaineistojaan.

    Kirjaudu Kuntatalouden tietopalvelun testiympäristöön tästä >

    Hae käyttäjätunnukset osoitteesta kuntadata@valtiokonttori.fi. Kerro viestissä nimesi, sähköpostiosoitteesi sekä kunnan / kuntayhtymän nimi ja Y-tunnus. Saat sähköpostiviestin ja toimintaohjeet, kun tunnuksesi on perustettu.

  • Tietopalvelun testausohjeet

    Kunnat voivat lähettää testiaineistoja Kuntatalouden tietopalveluun

    Taloustietojen siirtopalvelu voi vastaanottaa sekä XBRL- että CSV-muotoista taloustietoa testimielessä. Lähetettävän aineiston ei tarvitse olla suuri eikä sen tarvitse olla todenperäistä. Kyseeseen voisi tulla esimerkiksi kunnan tase, tulos- tai rahoituslaskelma.

    yksityiskohtainen ohje testaajille >

    Lähettämisen jälkeen pääset tarkastelemaan aineistoasi Hyväksyntäpalveluun ja toteamaan testilähetyksen onnistumisen.

    Tarkempia tietoja XBRL:stä ja XBRL-taksonomiasta on talousraportoinnin koodistot ja taksonomiat -sivulla.

  • Testiaineiston toimittaminen Excel-lomakkeella

    Kuntien ja kuntayhtymien talousarvio ja -suunnitelma toimitetaan Kuntatalouden tietopalveluun ja hyväksytään tietopalvelussa 15.1.2020 mennessä. Ennen tuotantotoimituksiin siirtymistä tiedon muodostamista ja toimittamista on testattava marraskuu/2019 mennessä.

    Huom. Lomakepohja on päivitetty vastaamaan taksonomiaversiota SBR-2019-12-2. (Tukee sekä 32 että 64 bittisyyttä)

    Excel-lomake on toistaiseksi käytössä ainoastaan raportointikokonaisuudessa:

    • Kuntien ja kuntayhtymien talousarvio ja -suunnitelma (KTAS)

    Excel-lomakkeen voit ladata tästä (KTAS)

    Alla olevassa käyttöohjeessa on ohjeita siihen, kuinka kuntien talousarvio- ja suunnitelmatietojen toimitus Excel-lomakkeella onnistuu.

    Excel-lomakkeen käyttöohjeet voit ladata tästä

    Halutessasi voit ladata myös taksonomian mukaiset kenttätunnukset sisältävän solukartan alta Excel-muodossa.

    Excel-lomakkeen solukartan Voit ladata tästä

  • Testi-tiedostojen toimitus verkkosivun kautta

    Kuntatalouden tietopalveluun voi lähettää tällä hetkellä kuntataloustaksonomian mukaisia XBRL-instanssidokumentteja tai CSV-tiedostoja, joista palvelu osaa muodostaa tarvittavat XBRL-instanssidokumentit.

    Hae käyttäjätunnukset osoitteesta kuntadata@valtiokonttori.fi. Kerro viestissä nimesi, sähköpostiosoitteesi sekä kunnan / kuntayhtymän nimi ja Y-tunnus. Saat sähköpostiviestin ja toimintaohjeet, kun tunnuksesi on perustettu.

    Aineiston lähettäminen palvelun kautta, kun sinulla on käyttäjätunnukset:

    • Aineiston lataussivun osoite: https://sipaapigw.azure-api.net/usertest/index.html
    • Käyttäjätunnus: Kenttään annetaan lähettäjän sähköpostiosoite. Muotoa ei tarkisteta.
    • Salasana: Tällä hetkellä (15.9.2017) salasanaa ei tarkisteta mutta tieto on syötettävä.
    • Aineisto: Lähetettävä tiedosto.
    • Aineisto tyyppi: Lähetettävän aineiston tyyppi.
  • Kuntien talousaineistojen lähettäminen Suomi.fi -testipalveluväylässä

    Perustiedot suomi.fi roolista https://esuomi.fi/palveluntarjoajille/palveluvayla/sanasto/

    Lähetys hoidetaan tyypillisesti ohjelmalla, joka tekee http-lähetyksen (HTTP POST). Aineisto lähetetään lähettäjän omalle liityntäpalvelimelle, joka välittää sen palveluväylän kautta kuntatalouden tietopalveluun.

    Ohje kuntien talousaineistojen lähettämiseen Suomi.fi -testipalveluväylässä

    Ohje Suomi.fi-palveluväylän käyttöönottamiseksi

     

  • Kuntien talousaineistojen lähettäminen Suomi.fi-rajapinnassa (päivitetty 8.10.2018)

    Päivitetyt ohjeet tulossa 10/2019

    Perustiedot Suomi.fi-roolista: https://esuomi.fi/palveluntarjoajille/palveluvayla/sanasto/

    Liityntäkatalogi listaa Suomi.fi-liitynnät: https://liityntakatalogi.suomi.fi/

    Valitse organisaatioksi Valtiokonttori.

    Liityntäkatalogi

    Palvelu tulee näkyville rekisteröinnin jälkeen, ja palvelusta saat haettua WSDL-mallin.

    Liityntäkatalogissa on malli siitä, mitä tietoja sieltä tulee löytymään.

    https://liityntakatalogi.suomi.fi/dataset/kirjastokeski

    Aineiston lähetys hoidetaan tyypillisesti ohjelmalla, joka tekee http-lähetyksen (HTTP POST).

    Lähetysskriptin malli alla

    Lähetysskriptin malli

    envelope Standardi SOAP-viesti.
    client Lähettävän tahon tiedot.
    service Vastaanottavan tahon eli tietopalvelun tiedot. Kuva on testiversiosta. Palvelu rekisteröidään ennen kuntapilotin avausta ja nämä tiedot muuttuvat.
    userid Käyttäjätunnus
    body Viestin sisältö. Tälle on olemassa WSDL-malli. Tiedot ovat samat kuin verkkolähetyssivulla.

     

  • Service Description Language -tiedosto

    Linkin takana on rajapinnan kuvaustiedosto.

    Lähettämisen jälkeen pääset tarkastelemaan aineistoasi Hyväksyntäpalveluun ja toteamaan testilähetyksen onnistumisen.

    Lisätietoja: kuntadata@valtiokonttori.fi

  • Mallitiedostoja aineistojen lähettämiseen

    Taksonomian SBR-2019-12-2 mukaiset csv- ja xbrl -muotoiset mallitiedostot:

    Kunnan talousarvio, KTAS (XBRL)

    Kunnan talousarvio, KTAS (CSV)

  • Tietojen haku rajapinnasta

    Hyväksytyt ja rekisteripalveluun siirtyneet tiedot ovat saatavilla rajapinnan kautta.

    Ohjeet rajapinnan testaamiseen (pdf) >

  • Ohjeistus Kuntatalouden tietopalvelun sisältöihin

    Kuvaus ja toimintokohtainen ohjeistus taloustietojen toimittamisprosessista aina tietojen hyödyntämiseen.

    Ohje tulossa

  • Kirjautuminen Kuntatalouden tietopalveluun

    Kuntatalouden tietopalvelussa (nk. Hyväksyntäpalvelu) kunnat ja kuntayhtymät voivat katsella, hyväksyä ja raportoida taloustietojaan.

    Kirjaudu Kuntatalouden tietopalveluun tästä >

    Käyttäjätunnusten haku

    Kunnat ja kuntayhtymät ovat Valtiokonttorin pyynnöstä ilmoittaneet valtuuttamiensa käyttäjien asiointiroolituksen marras-joulukuussa 2019.Mikäli ilmoitettuihin tietoihin tulee muutoksia tai oikeuksia tarvitaan lisää, ilmoitukset alla olevan kyselylinkin kautta.

    Käyttäjätunnukset luodaan asiointiroolien mukaisille tasoille (raportointi, kommentointi, hyväksyntä).

    Vuoden 2020 talousarvio ja -suunnitelmatietoja ei voi raportoida Kuntatalouden tietopalveluun ilman asianmukaista käyttäjätunnusta.

    Hae käyttäjätunnuksia vastaamalla asiointiroolikyselyyn >

  • Aineiston toimittaminen Excel-lomakkeella

    Kuntien ja kuntayhtymien talousarvio ja -suunnitelma toimitetaan Kuntatalouden tietopalveluun ja hyväksytään tietopalvelussa 15.1.2020 mennessä.

    Excel-lomake on toistaiseksi käytössä ainoastaan raportointikokonaisuudessa:

    • Kuntien ja kuntayhtymien talousarvio ja -suunnitelma (KTAS)

    Excel-lomakkeen voit ladata tästä (KTAS) > (TULOSSA)

    Alla olevassa käyttöohjeessa on ohjeita siihen, kuinka kuntien talousarvio- ja suunnitelmatietojen toimitus Excel-lomakkeella onnistuu.

    EXCEL-LOMAKKEEN KÄYTTÖOHJEET VOIT LADATA TÄSTÄ

    Halutessasi voit ladata myös taksonomian mukaiset kenttätunnukset sisältävän solukartan alta Excel-muodossa.

    EXCEL-LOMAKKEEN SOLUKARTAN VOIT LADATA TÄSTÄ

  • Tiedostojen toimitus verkkosivun kautta

    Kuntatalouden tietopalveluun voi lähettää kuntataloustaksonomian mukaisia XBRL-instanssidokumentteja tai CSV-tiedostoja, joista palvelu osaa muodostaa tarvittavat XBRL-instanssidokumentit.

    Aineiston lähettäminen palvelun kautta, kun sinulla on käyttäjätunnukset:

    • Aineiston lataussivun osoite: xxx
    • Käyttäjätunnus: Kenttään annetaan lähettäjän sähköpostiosoite. Sähköpostiosoitteen on oltava sama kuin myönnetyn käyttöoikeuden sähköpostiosoite.
    • Salasana: Salasana tulee olla sama, kuin käyttöoikeuden rekisteröinnin/aktivoinnin yhteydessä (Hyväksyntäpalveluun) on ilmoitettu.
    • Aineisto: Lähetettävä tiedosto.
    • Aineisto tyyppi: Lähetettävän aineiston tyyppi.
  • Taloustietojen haku

    Tietojen katselu Tutkihallintoa.fi-palvelussa

    Kuntien ja kuntayhtymien taloustiedot julkaistaan avoimessa Tutkihallintoa.fi-palvelussa heti, kun kunta on hyväksynyt ne Kuntatalouden tietopalvelussa. Tutkihallintoa.fi-sivustolla tietoja voi tarkastella visuaalisilta raporteilta ja vertailla eri kuntien tietoja keskenään. Palvelu avautuu vuoden 2020 alussa.

    Tutustu Tutkihallintoa.fi-palvelun testiversioon jo nyt >

    Tietojen haku rajapinnasta

    Hyväksytyt ja rekisteripalveluun siirtyneet tiedot ovat saatavilla rajapinnan kautta.

    Alla oleva ohje päivitettävänä, ei käytössä vielä

    OHJEET RAJAPINNAN TESTAAMISEEN (PDF) >