Takaisin ylös arrow_upward
Kansiossa ei ole tuotteita.

Sähkönumerot.fi -palvelun rajapinta

 

Tietojen haku

Tuotetietoja on mahdollista noutaa REST API -rajapinnan avulla JSON-muodossa. Tiedot tunnistetaan Tuotetietostandardi 2019 kenttäkoodien ja ETIM-koodien avulla.

Rajapintoja voivat hyödyntää kaikki alan toimijat kuten tukut, urakointiliikkeet, rakennuttajat, sähkösuunnittelijat jne. Tietojen hakua rajapinnan avulla voivat hyödyntää myös toimittajat omilla nettisivuillaan, jolloin tuotetietojen ylläpidon (master-tietokanta) voi tehdä Sähkönumerot.fi -palvelussa eikä toimittajan välttämättä tarvitse rakentaa hallintatyökaluja omaan järjestelmäänsä.

Rajapinnan käytöstä tehdään aina sopimus STK:n kanssa ja sovitaan tapauskohtaisesti mihin pakettiin/paketteihin käyttöoikeus annetaan. Rajapinnan käytöstä veloitetaan vuosittainen rajapinnan käyttömaksu, mutta itse tuotetiedoista STK ei peri maksua.

Rajapinnan dokumentointi on tehty swagger-työkalulla ja se löytyy osoitteesta:

www.sahkonumerot.fi /doc

 

Paketti

Sisältö Käyttäjä
1. Perustiedot Tuotekoodit, -nimet, toimittajatiedot, logistiikkatiedot,
nettikuva ja Sähkönumerot.fi-linkitys
urakointi- ja tarjouslaskenta-
ohjelmistot, rakennuttajat,
teollisuus, kiinteistön hoito
2. SURA-tiedot Perustiedot sekä ETIMin mukaiset valaisimien,
kaapeliteiden, kaapelien, keskusten, pistorasioiden,
kytkinten & painikkeiden, liike- & läsnäolotunnistimien, telerasioiden sekä paloilmoittien & -painikkeiden tekniset avaintiedot
sähkösuunnitteluohjelmistot
3. ETIM-tiedot ETIM-tiedot tukut
4. Kuvat, linkit ja tuotekuvaukset Kaikki kuvat, dokumentit, linkit ja tuotekuvaukset tukut
5. Kaikki tiedot Kaikki Tuotetietostandardin mukaiset tiedot + paketti 3 ETIM-tiedot valmistajan/maahantuojan oma käyttö, tukut
6. Arkistoidut tuotteet Arkistoidut tuotteet kaikki edellä mainitut

 

 

Toimittajille omien tietojen haku rajapinnan avulla on hinnoiteltu sähkönumeroiden määrän (aktiiviset ja julkaisemattomat) mukaan seuraavasti,  mainitut hinnat alv 0 %, liiton jäsenyrityksille myönnetään näistä hinnoista 50 % alennus:

alle 1 000 sähkönumeroa                             800 €
1 000–10 000 sähkönumeroa                    1 200 €
yli 10 000 sähkönumeroa                           2 000 €

 

Tarkempi kuvaus pakettien sisällöstä löytyy tiedostosta: STK_Rajapintapaketit_Tuotetietostandardi.xlsx, joka on ladattavissa tämän ohjesivuston Ladattavat tiedostot -osiosta.

 

Tietojen tuonti

Kehitämme parhaillaan järjestelmäämme siten, että vuonna 2021 toimittaja voi myös tuoda tietoja rajapinnan avulla. Tarkemmat rajapintakuvaukset on saatavilla myöhemmin. 

Rajapinnan vuotuinen käyttömaksu tietojen tuonnin yhteydessä määräytyy sähkönumeroiden määrän (aktiiviset ja julkaisemattomat) mukaan seuraavasti:

alle 1 000 sähkönumeroa                             400 €
1 000–10 000 sähkönumeroa                       800 €
yli 10 000 sähkönumeroa                           2 000 €

Hinnat alv 0 %. Sähköteknisen Kaupan Liiton jäsenyrityksille myönnetään näistä hinnoista 50 % alennus.

 #rajapinta #rajapinnat #API #JSON #hinta