SAL-tuotetietokanta: virheet ja siirtyminen uuteen integraatioon

ApteekitTarkistettu 18.11.2026

Tämä ohje kertoo, mitä tapahtuu, kun SAL-integraation ajo epäonnistuu tai aineistossa on virheitä. Ohjeessa on myös siirtyminen Apteekkituubista tai vanhasta SAL-integraatiosta uuteen SAL-tuotetietokannan rajapintaan (Akeneo).

Kun ajo epäonnistuu

Jos aineiston haku epäonnistuu, Vilkas saa virheestä ilmoituksen. Vilkas voi käynnistää ajon tarvittaessa uudelleen. Jos virhe johtuu kaupan asetuksesta, asetus on korjattava ennen kuin ajo voi onnistua.

Jos olet ottanut käyttöön SAL-integraation sähköpostitapahtuman, saat ilmoituksen virheestä myös itse. Katso SAL-tuotetietokannan käyttöönotto.

Virheet aineistossa

Jos SAL:n tuotetiedoissa on virheitä, ota yhteyttä Apteekkariliittoon tai suoraan tuotteen toimittajaan. Esimerkiksi puuttuvista kuvista tai virheellisistä tuotetiedoista voit ottaa yhteyttä suoraan toimittajaan, jonka rajapinnoista tuotetiedot tulevat taksaan.

Apteekkituubin päivittäminen käyttämään uutta SAL-integraatiota

Vanha Apteekkituubin käyttämä rajapinta poistui käytöstä loppuvuodesta 2023. Apteekkituubiin on tehty liityntä uuteen SAL-tuotetietokannan rajapintaan (Akeneo), josta tuotedata haetaan. Tarkistettava: onko tämä siirto-ohje yhä tarpeen, kun vanha rajapinta on jo poistunut

Jos verkkoapteekissa on ollut käytössä Apteekkituubi, siirry uuteen rajapintaan näin:

  1. Pyydä Vilkasta ajamaan kaupassa skripti, joka päivittää tuotetyypin tiedot. Tee tämä ennen kuin muutat kaupan asetuksia.
  2. Odota, että tuotetyyppi on päivittynyt. Skripti on hidas, joten se ajetaan taustalla, ja tuotetiedot päivittyvät sillä aikaa nykyisestä järjestelmästä.
  3. Avaa Asetukset > SAL-integraation asetukset.
  4. Ota käyttöön asetus SAL-integraatio käytössä.
  5. Valitse Tallenna.
  6. Tarkista integraation asetukset. Tarkista erityisesti uudet asetukset, jotka on lueteltu alla.
  7. Kun kaikki asetukset on tarkistettu, valitse yleisellä välilehdellä Päivitä kaikki tuotteet. Silloin Akeneosta haetaan kaikki tuotedata.

Tarkista nämä asetukset

Asetus Mitä tarkistat
Kauppaan tuodaan Valitse tuotetyypit, jotka kauppaan tuodaan. Oletuksena valitaan nykyisiä valintoja vastaavat.
Automaattinen tuoteryhmien luonti Jos kaupassa on jo haluamasi tuoteryhmät, ota asetus pois käytöstä.
Tuo vain valitut tuoteryhmät Valitse, mitkä tuoteryhmät kauppaan luodaan aineiston perusteella.
Piilota tyhjät tuoteryhmät Kun asetus on käytössä, integraatio piilottaa tyhjät tuoteryhmät. Valinta Akeneosta tulleet tuoteryhmät piilottaa vain tuoteryhmät, jotka on luotu kauppaan Akeneon datan perusteella.
Vanhat SAL-tuotetietokannan tuotteet Valitse siirron ajaksi ilmoitus tai piilotus. Silloin tuotteita ei poisteta ennen kuin olet varmistanut, että siirto uuteen rajapintaan onnistui. Tarkistettava: käyttöönotto-ohjeessa asetus on jaettu kahteen, lääkkeisiin ja vapaan kaupan tuotteisiin
Päivitysasetukset Tarkista uudet asetukset Tallenna valmistaja, Tallenna brändi, Tallenna brändi valmistajaksi, jos valmistaja puuttuu ja Tallenna GTIN-koodi. GTIN-koodi tallennetaan tuotteen kenttään Tuotekoodi (esim. EAN).
Veroluokat Aineistossa on joillekin tuotteille useampi arvonlisäveroprosentti, esimerkiksi 24 % ja 10 %. Valitse, mikä niistä tallennetaan tuotteelle oletukseksi. Tarkistettava: esimerkin verokannat ovat vanhoja
Suodatus Tarkista suodatusasetukset.

Asetusten tarkemmat kuvaukset ovat ohjeessa SAL-tuotetietokannan käyttöönotto.

Siirtyminen vanhasta SAL-integraatiosta

Jos verkkoapteekissa on ollut käytössä vanha SAL-tuoteintegraatio, ota uusi SAL-integraatio (Akeneo) käyttöön näin. Tarkistettava: lähteen mukaan vanha SAL-integraatio ei ole enää käytössä; onko tämä ohje yhä tarpeen

  1. Luo kokonaan uusi tuotetyyppi.
  2. Valitse se SAL-integraation asetuksissa integraation tuotetyypiksi.
  3. Ota SAL-integraation asetuksissa käyttöön uusi rajapinta.
  4. Määritä integraation asetukset.

Kaupassa jo olevat SAL-tuotteet päivittyvät edelleen vanhan SAL-integraation kautta. Uudet tuotteet tulevat jo uuden SAL-tuotetietokannan datasta.

Vanhat tuotteet uuteen integraatioon

Jos haluat, että vanhat SAL-tuotteet päivittyvät jatkossa uuden SAL-tuotetietokannan datasta, Vilkas voi ajaa skriptin, joka merkitsee tuotteet päivittymään uuden integraation kautta.

  • Skripti vaihtaa tuotteiden tuotetyypiksi sen, joka on määritetty uuden SAL-integraation asetuksissa.
  • Vanha SAL-integraatio teki variaatiotuotteita. Uusi rajapinta ei tee niitä. Halutessasi päätuote–variaatio-rakenteet voidaan purkaa skriptillä.
  • Vanhan SAL-integraation kautta tuli paljon enemmän tuotteita kuin uudesta rajapinnasta tulee.

Liittyvät ohjeet

Etkö löytänyt vastausta?

Tuki auttaa arkisin klo 9–16.

Ota yhteyttä tukeen