Mitä hakemistopalvelun ylläpitäjä tarvitsee ohjelmistolta
Yrityshakemisto on juuri niin hyvä kuin sen data. Ylläpitäjä tarvitsee päivittäisen noudon rekisteristä, joka päivittää vain muuttuneet tietueet, näyttää jokaisen tiedon lähteen ja päiväyksen ja kestää muutokset, kuten siirtymän uuteen toimialaluokitukseen. Hakijan pitää voida rajata yrityksiä kunnan, toimialan ja yhtiömuodon mukaan nopeasti ja kirjautumatta.
Yritykset tarvitsevat tavan omistaa profiilinsa ja lisätä siihen sen, mitä rekisterissä ei ole, kuten kuvauksen ja aukioloajat, ilman että ne voivat muuttaa rekisteritietoja. Kehittäjät ja kumppanit haluavat saman datan rajapinnasta selkein käyttörajoin ja lisenssiehdoin. Avoimen datan käyttöön liittyy lähdemerkintä, eikä palvelu saa näyttää rekisteriviranomaisen omalta palvelulta. Hakemiston pitää myös kertoa selvästi, mitä avoin data ei sisällä, kuten puhelinnumerot.
Näin Firmalyhty-esittely toimii
Haku suodattaa kunnan, toimialan ja yhtiömuodon mukaan, lajittelee ja sivuttaa tulokset ja pitää haun osoitteessa, joten sen voi jakaa linkkinä. Jokaisessa profiilissa on rekisteripaneeli, jossa näkyvät Y-tunnus, yhtiömuoto, päätoimiala, rekisterimerkinnät ja viimeisin muutospäivä, ja yrityksen oma kuvaus ja aukioloajat on merkitty erikseen eri värillä.
Profiilin omistaminen etenee neljässä vaiheessa: valitse yritys ja tunnistaudu, vahvista roolisi, muokkaa kuvausta ja aukioloaikoja, esikatsele ja julkaise. Tunnistautuminen on merkitty esimerkkivaiheeksi, ja tulos tallentuu vain selaimeesi. Rajapintasivu näyttää esimerkkivastaukset hausta, yksittäisestä yrityksestä ja muutosvirrasta käyttörajoineen ja kokeiluineen, ja jokaisessa profiilissa on kehittäjän JSON-näkymä.
Tilastosivu piirtää uudet yritykset kuukausittain sekä yritykset toimialoittain ja maakunnittain kaavioiksi, joissa on työkaluvihjeet ja taulukkonäkymät. Kaikki yritykset ja Y-tunnukset ovat keksittyjä, ja tunnukset ovat käyttämättömältä alueelta, vaikka tarkistusmerkki on oikein. Toimialat näytetään TOL 2025 -koodeilla, joihin rekisteri siirtyi vuoden 2026 alussa.
Mitä tuotantoversio suomalaiselle yritykselle sisältää
Oikea palvelu noutaa rekisterin avoimen datan joka yö rajapinnasta, vertaa muutospäiviä ja tallentaa muutoshistorian. Lisäämme hakuindeksin, joka pysyy nopeana koko aineistolla, lisenssin vaatiman lähdemerkinnän ja vanhojen toimialakoodien ohjauksen uusiin. Muita tietolähteitä, kuten omat jäsen- tai asiakasrekisterinne, voi yhdistää, kun teillä on oikeus käyttää niitä. Noutoa valvotaan, ja jos se epäonnistuu, ylläpitäjä saa hälytyksen ennen kuin vanhentunut tieto ehtii näkyä hakijoille.
Profiilin omistaminen käyttää vahvaa sähköistä tunnistautumista ja tarkistaa henkilön roolin yrityksessä ennen julkaisua. Ylläpitäjä saa moderointityökalut yritysten sisällöille, käyttäjien ja rajapinta-avainten hallinnan sekä tapahtumalokin jokaisesta muutoksesta ja hyväksynnästä. Rajapinta toimii avaimin, käyttörajoin ja käyttöraportein.
Yritysten rekisteritiedoissa voi olla henkilötietoja, joten suunnittelemme GDPR:n mukaisen käsittelyn kanssasi: mitä näytetään, kuinka kauan tietoja säilytetään ja miten poistopyynnöt hoidetaan. Palvelu toimii suomeksi sekä englanniksi tai ruotsiksi, täyttää saavutettavuusvaatimukset ja käyttää analytiikkaa vasta suostumuksen jälkeen. Oma tiimimme huolehtii noudosta, tietoturvapäivityksistä ja valvonnasta.
