SAL-tuotteet kaupassa

ApteekitTarkistettu 18.11.2026

Tämä ohje kertoo, miten SAL-integraatio tuo ja päivittää tuotteet verkkoapteekkiin. Ohjeessa on myös tuotekohtaiset asetukset, tuoteryhmät ja suodattimet, joilla rajaat tuotavia tuotteita.

Ennen kuin aloitat

SAL-integraatio on otettu käyttöön. Katso SAL-tuotetietokannan käyttöönotto.

Tuotteiden tuonti kauppaan

Kun SAL-integraatio on käytössä, tuotetiedot päivitetään kauppaan ajastetusti.

  • Aineistosta tuodaan vain tuotteet, joita kaupassa ei vielä ole.
  • Jos tuote on jo tuotu esimerkiksi vanhan SAL-integraation kautta, sitä ei tuoda uudelleen eikä sen tietoja päivitetä SAL-tuotetietokannan aineistosta.
  • Tuotteelle tallennetaan kaikki tiedot, jotka aineistossa on.

SAL-integraation yleisissä asetuksissa kohta Tuotetiedot tuotu kertoo, milloin tuotteet on viimeksi tuotu. Seuraavalla kerralla SAL-tuotetietokannasta haetaan vain tuotteet, jotka on päivitetty tai lisätty sen jälkeen.

Hae kaikki tuotteet uudelleen

Kun tuotetiedot on tuotu onnistuneesti, sivulla näkyy painike Päivitä kaikki tuotteet. Kun valitset sen, seuraavassa ajossa haetaan kaikki SAL-tuotetietokannan tuotteet, ei vain viimeisimmän ajon jälkeen päivittyneitä.

Valitse Päivitä kaikki tuotteet aina, kun olet:

  • muuttanut SAL-integraation asetuksia
  • muuttanut tuotteiden SAL-asetuksia
  • poistanut kaupasta vanhoja tuotteita, jotka haluat jatkossa hakea SAL-integraation kautta
  • muokannut tuotetietoja, mutta haluat tuotteille takaisin SAL-tuotetietokannan tiedot.

Tuotteiden päivittäminen

SAL-integraatio päivittää vain tuotteet, jotka on lisätty kauppaan SAL-integraation kautta. Muita tuotteita integraatio ei päivitä.

  • Integraation kautta lisätyille tuotteille päivitetään aina ne tiedot, jotka aineistossa on.
  • Poikkeus: hintojen, tuotenimien, tuotekuvausten ja tuotekuvien päivittymistä voit säätää asetuksilla.
  • Muihin kenttiin voit tallentaa tiedot vapaasti.

Tuotekohtaiset asetukset

Tuotteen välilehdellä SAL-tuotetietokanta on asetuksia, joilla säädät yksittäisen tuotteen päivittymistä. Integraatio käyttää ensisijaisesti näitä asetuksia. Jos tuotteelle ei ole annettu omia asetuksia, käytetään SAL-integraation yleisiä asetuksia.

Asetus Mitä se tekee
Päivitä tuote Päivitetäänkö tuote SAL-tuotetietokannasta.
Päivitä hinta Päivitetäänkö tuotteen hinta aineistosta.
Tukkuhintakerroin Kerroin, jolla hinta lasketaan tukkuhinnasta. Jos kenttä on tyhjä, käytetään SAL-integraation asetusten yleistä kerrointa. Hinta lasketaan tukkuhinnasta vain vapaan kaupan tuotteille ja vapaan hinnoittelun itsehoitolääkkeille.
Päivitä tuotekuvat Päivitetäänkö tuotteen tuotekuvat.
Päivitä tuotenimi Päivitetäänkö tuotteen nimi. Asetus on kielikohtainen. Jos annat nimen itse esimerkiksi englanniksi tai venäjäksi, estä sen päivittyminen tässä.
Päivitä tuotekuvaukset Päivitetäänkö tuotekuvaukset aineistosta. Asetus on kielikohtainen. Jos aineistossa ei ole kuvausta jollain kielellä, kauppaan annettua kuvausta ei korvata tyhjällä.
Estä kentän “Vaatii yhteydenoton ennen tilausta” tallennus aineistosta Tallennetaanko aineistosta tieto pakollisesta yhteydenotosta.
Päivitä lääkemerkintä Päivitetäänkö tieto siitä, onko tuote itsehoitolääke. Voit estää päivityksen esimerkiksi joillakin perusvoiteilla, jotta niillä ei näy lääkemerkintää. Asetus on käytössä vain Akeneon kanssa.
Päivitä valmistaja Päivitetäänkö tuotteen valmistaja. Asetus on käytössä vain Akeneon kanssa.
Piilota copyright-merkintä Piilottaa Apteekkariliiton copyright-merkinnän tuotesivulta. Voit piilottaa merkinnän, jos tuotekuvaustekstejä ei tuoda SAL-tuotetietokannasta.

Välilehdellä näkyy myös päivämäärä, jolloin tuote on viimeksi päivittynyt SAL-integraation kautta. Kaikkia tuotteita ei päivitetä jokaisessa ajossa. Jos tuote ei ole muuttunut SAL-tuotetietokannassa pitkään aikaan, päivämäärä voi olla vanha.

Ruotsinkieliset tuotekuvaukset

Ruotsinkielinen tuotekuvaus tallennetaan myös lisäkenttään Tuotekuvaus (Ruotsi). Jos haluat näyttää sen suomenkielisellä tuotesivulla:

  1. Avaa Tuotteet > Tuotetyypit.
  2. Valitse tuotetyyppi, jota SAL-integraatio käyttää.
  3. Avaa Lisäkentät.
  4. Etsi taulukosta kenttä, jonka tunniste on ApteekkituubiProductDescriptionSV.
  5. Laita kenttä näkyville sarakkeessa Näkyvissä.
  6. Jos haluat näyttää tekstin omalla välilehdellään, valitse myös Näytä omassa välilehdessä.

Linkki pakkausselosteeseen

Linkki pakkausselosteeseen tallennetaan kenttään Pakkausseloste. Jos haluat näyttää linkin asiakkaille:

  1. Avaa Tuotteet > Tuotetyypit.
  2. Valitse tuotetyyppi, jota SAL-integraatio käyttää.
  3. Avaa Lisäkentät.
  4. Etsi taulukosta kenttä, jonka tunniste on ApteekkituubiPackageInformation.
  5. Laita kenttä näkyville sarakkeessa Näkyvissä.

Tuotteen merkitseminen lääkkeeksi tuoteluokan perusteella

Osa SAL-aineiston tuotteista on jo merkitty lääkkeiksi. Ne merkitään kaupassa lääkkeiksi automaattisesti.

Osa tuotteista on aineistossa yleistä kauppatavaraa, mutta haluat ehkä käsitellä niitä lääkkeinä. Tyypillinen esimerkki ovat perinteiset kasvirohdosvalmisteet eli SAL-tuoteluokat 1901 ja 1905. Merkitse tietyn tuoteluokan tuotteet lääkkeiksi näin:

  1. Avaa Asetukset > SAL-integraation asetukset.
  2. Avaa välilehti Päivitysasetukset.
  3. Etsi sivun alaosasta rivi Tuoteluokat, jotka merkitään lääkkeiksi.
  4. Valitse Näytä asetukset.
  5. Valitse tuoteluokat, joiden tuotteet merkitään lääkkeiksi, esimerkiksi 1901 ja 1905. Lääkkeiden tuoteluokkia ei tarvitse valita.
  6. Avaa yleiset asetukset ja valitse Päivitä kaikki tuotteet. Silloin lääkemerkinnät päivittyvät tuotteille heti seuraavassa ajossa.

Tuotteen poistaminen integraatiosta

Integraatio päivittää SAL-integraation kautta lisättyä tuotetta niin kauan kuin integraatio on käytössä. Jos et halua, että tuotetta päivitetään enää, määritä tuotteen välilehdellä SAL-tuotetietokanta, että tuotetta ei päivitetä (asetus Päivitä tuote).

Tuoteryhmät

SAL-integraatio luo kauppaan aineiston mukaiset tuoteryhmät vain, jos asetus Automaattinen tuoteryhmien luonti on valittu. Silloin tuoteryhmien nimet tuodaan SAL-tuotetietokannan aineistosta.

  • Tuoteryhmäliitokset tehdään uusille tuotteille.
  • Vanha tuote liitetään tuoteryhmään päivityksen yhteydessä vain, jos sitä ei ole liitetty yhteenkään tuoteryhmään.
  • Integraatio ei poista vanhoja tuoteryhmäliitoksia. Voit liittää tuotteet haluamiisi tuoteryhmiin.

Vilkas voi tarvittaessa tuoda tuoteryhmäliitokset kaikille tuotteille, joita integraatio päivittää. Silloin uudet liitokset tulevat myös vanhoille tuotteille, joilla on jo tuoteryhmäliitos. Toiminto ei poista olemassa olevia tuoteryhmiä. Toiminnosta on hyötyä, jos haluat vaihtaa itse luodun tuoteryhmärakenteen SAL-tuotetietokannan tuoteryhmähierarkiaan. Tarkistettava: onko Vilkkaan tekemä tuonti lisämaksullinen ja miten sitä pyydetään

Suodatukset

Suodattimilla rajaat, mitä tuotteita SAL-tuotetietokannan aineistosta tuodaan kauppaan. Avaa Asetukset > SAL-integraation asetukset > Suodatus.

Suodattimissa, joissa on linkki, valitse linkki. Avautuu lista aineiston arvoista. Valitse listalta arvot, joiden tuotteita et halua kauppaan.

Suodatin Mitä se tekee Oletus
Tuoteryhmät, joiden tuotteet tuodaan Valitse tuoteryhmät, joiden tuotteet tuodaan kauppaan.
Tuoteluokat, joiden tuotteita ei tuoda kauppaan Valitse tuoteluokat, joiden tuotteita ei tuoda. Kaikkien tuoteluokkien tuotteet tuodaan.
Tukkuliikkeet, joiden tuotteita ei tuoda kauppaan Valitse tukkuliikkeet, joiden tuotteita ei tuoda. Kaikkien tukkuliikkeiden tuotteet tuodaan.
Lääkemuodot, joita ei tuoda kauppaan Valitse lääkemuodot, joita ei tuoda. Kaikki lääkemuodot tuodaan.
Markkinoijat, joiden tuotteita ei tuoda kauppaan Valitse markkinoijat, joiden tuotteita ei tuoda. Kaikkien markkinoijien tuotteet tuodaan.
Myyntiluvanhaltijat, joiden tuotteita ei tuoda kauppaan Valitse myyntiluvanhaltijat, joiden tuotteita ei tuoda. Käytössä vain vanhan Apteekkituubin rajapinnan kanssa. Kaikkien myyntiluvanhaltijoiden tuotteet tuodaan.
Säilytyslämpötilat, joiden tuotteita ei tuoda kauppaan Valitse säilytyslämpötilat, joiden tuotteita ei tuoda. Käytössä vain Akeneon kanssa. Kaikki tuotteet tuodaan säilytyslämpötilasta riippumatta.
Ostorajoitukset, joihin liittyviä tuotteita ei tuoda kauppaan Valitse ostorajoitukset, joihin liitettyjä tuotteita ei tuoda. Kaikki tuotteet tuodaan ostorajoituksista riippumatta.
Erityiskorvattavat sairaudet, joiden tuotteita ei tuoda kauppaan Valitse erityiskorvattavat sairaudet, joihin liitettyjä tuotteita ei tuoda. Kaikki tuotteet tuodaan erityiskorvattavista sairauksista riippumatta.

Omat suodattimet

Kun käytössä on vanhan Apteekkituubin rajapinta, voit määrittää myös omia yksinkertaisia suodattimia. Tarkistettava: onko vanha Apteekkituubin rajapinta enää käytössä, koska lähteen mukaan se poistui käytöstä loppuvuodesta 2023

Kirjoita suodatin muodossa kenttä_aineistossa vertailuoperaattori arvo1,arvo2. Jos suodattimia on useampi, erota ne puolipisteellä.

Esimerkki:

medicinalInfo.trafficDanger is true; priceInfo.retailPriceInclVat > 10000; priceInfo.retailPriceInclVat < 10; productNumber not 1662207,000108;
Suodatin Vaikutus
medicinalInfo.trafficDanger is true; Tuotteita, joihin liittyy liikennevaara, ei tuoda.
priceInfo.retailPriceInclVat > 10000; Tuotteita, joiden hinta on yli 10 000, ei tuoda. Tarkistettava: hinnan yksikkö, euroa vai senttiä
priceInfo.retailPriceInclVat < 10; Tuotteita, joiden hinta on alle 10, ei tuoda.
medicinalInfo.lviMedicine not true; Tuodaan vain tuotteet, jotka ovat lisäneuvontaa vaativia itsehoitolääkkeitä. Tarkistettava: suodatin puuttuu esimerkkirivistä, ja selitys vaikuttaa käänteiseltä
productNumber not 1662207,000108; Tuotteita, joiden tuotenumero on 1662207 tai 000108, ei tuoda. Tarkistettava: lähteessä “joiden tuotenumero ei ole”; kumpi on oikein

Liittyvät ohjeet

Etkö löytänyt vastausta?

Tuki auttaa arkisin klo 9–16.

Ota yhteyttä tukeen