Sähkönumerot.fi -palvelun rajapinta
Sähkönumerot.fi-palvelun tietosisältöä voi helposti hyödyntää rajapintojen avulla kaikki alan toimijat kuten tukut, urakointiliikkeet, rakennuttajat, sähkösuunnittelijat jne. Myös valmistajat ja maahantuojat voivat hakea omia tietojaan esimerkiksi omille tuotekorteilleen, jolloin tuotetietojen ylläpidon (master-tietokanta) voi tehdä Sähkönumerot.fi -palvelussa eikä toimittajan välttämättä tarvitse rakentaa esimerkiksi ETIM-hallintatyökaluja omaan järjestelmäänsä.
Rajapinnan käytöstä tehdään aina sopimus STK:n kanssa. Rajapinnan käytöstä veloitetaan vuosittainen rajapinnan käyttömaksu, mutta itse tuotetiedoista ei peritä maksua.
Rajapinnan dokumentointi on tehty swagger-työkalulla ja se löytyy osoitteesta:
Lataa Digitaalinen tuotetieto rajapinnan kautta hyötykäyttöön -opas ja katso vinkit rajapinnan käytöstä
Oppaasta löydät konkreettisia keinoja, joilla koko rakentamisen arvoketju voi vastata alaa koskettaviin digitalisaation ja kiertotalouden vaatimuksiin. Lue lisää ja lataa opas.
Tuotetietojen haku
Sähkönumerot.fi-palvelun tietosisältö voidaan noutaa REST API -rajapinnan avulla JSON-muodossa. Tiedot tunnistetaan Tuotetietostandardin kenttäkoodien ja ETIM-koodien avulla.
|
Paketti |
Sisältö | |
| 1. Perustiedot | Tuotekoodit, -nimet, toimittajatiedot, logistiikkatiedot, nettikuva ja Sähkönumerot.fi-linkitys | |
| 3. ETIM-tiedot | ETIM-tiedot | |
| 5. Kaikki tiedot | Kaikki Tuotetietostandardin mukaiset tiedot | |
| 6. Arkistoidut tuotteet | Arkistoidut tuotteet | |
|
Paketit, joita ei enää ylläpidetä |
||
| 2. SURA-tiedot | Perustiedot sekä ETIMin mukaiset valaisimien, kaapeliteiden, kaapelien, keskusten, pistorasioiden, kytkinten & painikkeiden, liike- & läsnäolotunnistimien, telerasioiden sekä paloilmoittien & -painikkeiden tekniset avaintiedot. | |
| 4. Kuvat, linkit ja tuotekuvaukset | Kaikki kuvat, dokumentit, linkit ja tuotekuvaukset | |
Tarkempi kuvaus pakettien sisällöstä löytyy tiedostosta: STK_Rajapintapaketit_Tuotetietostandardi.xlsx, joka on ladattavissa tämän ohjesivuston Ladattavat tiedostot -osiosta.
Hinnoittelu
Kaikkien tuotteiden tuotetiedot
Tuotetietojen haku rajapinnasta pakettien määrästä ja laajuudesta riippumatta 1950 € / vuosi (alv 0 %) 1.1.2025 alkaen. Liiton jäsenyrityksille myönnetään hinnasta 50 % alennus.
Omien tuotteiden tuotetiedot
Toimittajilta veloitetaan omien tietojen hausta rajapintamaksuna 420 € / vuosi (alv 0 %) 1.1.2025 alkaen. Liiton jäsenyrityksiltä ei peritä rajapintamaksua omien tietojen hausta.
Rajapinnan käyttöesimerkkejä:
- valmistajat/maahantuojat hyödyntävät omia tietojaan omissa tietojärjestelmissään ja omilla nettisivuillaan
- tukut ja urakoitsijat käyttävät tietoja verkkokaupoissaan ja tuoteluetteloissaan
- ohjelmistotalot hyödyntävät tietoja mm. sähkösuunnittelu-, dokumentointi-, toiminnanohjaus-, määrälaskenta- ja hankintaohjelmistoissa
- energiayhtiöt ja kunnossapitoyritykset käyttävät tietoja varastonhallinnassaan
- talotekniikkayritykset hyödyntävät tietoja kunnossapidossa
Omien tietojen ylläpito (tietojen tuonti)
Valmistajat ja maahantuojat voivat myös ylläpitää omien tuotteidensa Tuotetietostandardin mukaisia tuotetietoja Sähkönumerot.fi-palvelussa rajapinnan avulla.
Tietojen tuonnin dokumentointi löytyy osoitteesta:www.sahkonumerot.fi /doc.
Hinnoittelu
Tuotetietoja ylläpidon rajapintamaksuna peritään 420 € / vuosi (alv 0 %), liiton jäsenyrityksiltä ei peritä rajapintamaksua. Kun käytössä ovat sekä Tuotetietojen ylläpito että Tuotetietojen haku -rajapinnat, annetaan toisesta rajapinnan käyttömaksusta 50 % alennus.
#rajapinta #rajapinnat #API #JSON #hinta
