Takaisin ylös arrow_upward
Kansiossa ei ole tuotteita.

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:

www.sahkonumerot.fi/doc

 

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 1800 € / vuosi (alv 0 %). Liiton jäsenyrityksille myönnetään hinnasta 50 % alennus.

Omien tuotteiden tuotetiedot
Toimittajilta veloitetaan omien tietojen hausta rajapintamaksuna 300 € / vuosi (alv 0 %), 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 300 € / 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