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

  • 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-09-24-v2. (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.

    Päivitetyt ohjeet tulossa 10/2019

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

     

  • 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-09-24 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) >