Kuinka luot Akeneossa tuotemallit ja hallitset variantteja?
Opi luomaan tuotemalleja, joihin voit liittää variantteja. Säästä aikaa, kun perusominaisuudet periytyvät päätuotteelta kaikille varianteille.
Written by Petro Mäntylä
Updated at March 16th, 2026
Sisällysluettelo
Tuotemallit helpottavat tuotteiden hallintaa, kun samasta tuotteesta on useita vaihtoehtoja (esimerkiksi eri koko, väri tai EAN-koodi). Päätuotteelle määritellyt yleiset tiedot, kuten kuvaus, tulevat automaattisesti kaikkien varianttien käyttöön. Näin säästät aikaa ja vähennät virheitä, kun samoja tietoja ei tarvitse syöttää jokaiselle variantille erikseen. Jos taas tarvitset jokaiselle tuotteelle yksilöllisen URL-osoitteen ja yksilölliset tiedot, mutta haluat silti ryhmitellä niitä yhteen, ryhmätuotteet ovat usein parempi ratkaisu kuin pelkkä varianttierottelu.
Alla vaiheittaiset ohjeet tuotemallien ja varianttien luomiseen sekä lisätietoja Perheen (Family) asetuksista, varianttiulottuvuuksien määrittelystä ja ryhmätuotteiden käyttöönotosta Akeneossa ja AI Commercessa.
Tietovirtamalli tuotetyyppien muuntoon
Alla on taulukoita eri vaihtoehdot, joilla tuotemalli ja tuotetyyppi käännetään Akeneon tukemasta tietomallista AI Commercen tukemaan rakenteeseen. Järjestelmien välisistä eroista, ja eri kauppiaden välisistä tarpeista johtuen, rajapintalogiikka toimii monella eri tavalla. Suosittelemme käyttämään vain tiettyjä malleja omassa kaupassasi, esimerkiksi yksi Case perustuotteelle ja toinen Case tuotemalleille. Ryhmätuotteet sopivat tilanteisiin, joissa tarvitset jokaiselle tuotteelle yksilöllisen URL-osoitteen ja yksilölliset tiedot, mutta haluat silti ryhmitellä niitä yhteen.
Taulukko AI Commercen tukemista tuotetyypeistä
| Case | Akeneo-tuotetapaus | Miten järjestelmä päättää | Vanhemman tuotemallin tyyppi | Muunnos AICC:ssä | Myytävää tuotetta vastaava tuoterivi | Vaihtoehto- ja varianttitiedot | Varastorivi | Varaston varianttitunniste |
|---|---|---|---|---|---|---|---|---|
| A | Simple-tuote ilman parentia, eikä yhtään kohdistettavaa option-attribuuttia | Tuote käsitellään itsenäisenä tuotteena, ei lapsituotteena | Ei parentia | Itsenäinen simple-tuote, jolle tehdään lisäksi varianttikäsittely omaan tuotteeseen | Simple-tuote itse | Vaihtoehtotietoja ei synny attribuuteista, jos mikään arvo ei vastaa määriteltyjä vaihtoehtoja | Luodaan tai päivitetään tuotteen omalle tuoteriville | Tyhjä merkkijono |
| B | Simple-tuote ilman parentia, mutta sillä on kohdistettavia option-attribuutteja | Tuote käsitellään itsenäisenä tuotteena, ei lapsituotteena | Ei parentia | Itsenäinen simple-tuote, jolle tehdään lisäksi varianttikäsittely omaan tuotteeseen | Simple-tuote itse | Varianttitiedot syntyvät niistä attribuuteista, jotka vastaavat määriteltyjä vaihtoehtoja; uusia vaihtoehtoryhmiä ei luoda | Luodaan tai päivitetään tuotteen omalle tuoteriville | Rakennetaan vastaavista attribuuteista, esimerkiksi muotoon 1-10,2-3 |
| C | Simple-lapsi tuotemallin alla, käsittely menee varianttipolkuun | Lapsi ohjataan varianttipolkuun eikä omaksi tuotteekseen | Tyypillisesti simple tai oletuksena simple; pelkkä parentin tyyppi ei yksin ratkaise | Lapsi puretaan variantiksi ilman omaa tuoteluontia tässä ajossa | Yleensä parent-tuote; jos tietokannassa on jo samalla tunnisteella vanha lapsirivi, lapsi voi voittaa | Varianttitiedot luodaan sille tuotteelle, jonka järjestelmä valitsee omistajaksi; uusia vaihtoehtoryhmiä ei luoda | Luodaan tai päivitetään saman omistavan tuotteen alle | Rakennetaan kohdistettavista attribuuteista, muuten tyhjä |
| D | Simple-lapsi tuotemallin alla, käsittely menee polkuun jossa lapsi säilyy omana tuotteena | Lapsi käsitellään omana tuotteenaan, mutta sille tehdään myös varianttilogiikka | Tyypillisesti group; käytännössä lapsen tiedot tai oletusasetus ratkaisevat | Lapsi jää omaksi tuotteekseen ja sille tehdään lisäksi varianttikäsittely | Lapsi itse | Varianttitiedot luodaan lapsituotteelle niistä attribuuteista, jotka vastaavat määriteltyjä vaihtoehtoja; uusia vaihtoehtoryhmiä ei luoda | Luodaan tai päivitetään lapsituotteen omalle tuoteriville | Rakennetaan kohdistettavista attribuuteista; jos mitään kohdistettavaa ei löydy, jää tyhjäksi |
| E | Simple-lapsi tuotemallin alla, käsittely menee polkuun jossa lapsi säilyy omana tuotteena | Lapsi käsitellään omana tuotteenaan, mutta sille tehdään myös varianttilogiikka | Tyypillisesti configurable; käytännössä lapsen tiedot tai oletusasetus ratkaisevat | Lapsi jää omaksi tuotteekseen ja sille tehdään lisäksi varianttikäsittely | Lapsi itse | Sama kuin D | Luodaan tai päivitetään lapsituotteen omalle tuoteriville | Rakennetaan kohdistettavista attribuuteista; jos mitään kohdistettavaa ei löydy, jää tyhjäksi |
| F | Simple-lapsi minkä tahansa parentin alla, mutta attribuutit eivät mätsää option-attribuutteihin | Noudattaa ensin C-, D- tai E-tapauksen peruslogiikkaa | Simple, group tai configurable on tässä vain suuntaa antava; childin tiedot tai oletusasetus ratkaisevat | Noudattaa valittua päälogiikkaa | Varianttipolussa yleensä parent, omana tuotteena säilyvässä polussa yleensä lapsi; olemassa oleva lapsirivi voi voittaa | Varianttitietoja ei synny, eikä uusia vaihtoehtoryhmiä luoda | Luodaan tai päivitetään silti sille tuotteelle, jonka järjestelmä valitsee omistajaksi | Tyhjä merkkijono |
| G | Tuotemalli eli top-level parent-rivi itse | Kyseessä on ylätason parent-rivi, jonka jatkokäsittely riippuu valitusta tuotemallista | Group, configurable, simple tai oletusasetus | Group- ja configurable-mallissa parent toimii rakenteellisena ylätasona; simple-mallissa sille voidaan tehdä myös oma varianttikäsittely | Top-level rivi itse | Group- ja configurable-mallissa tälle riville ei yleensä synny varianttitietoja tässä polussa; simple-mallissa niitä voi syntyä | Group- ja configurable-mallissa tämä rivi ei yleensä omista lapsivarianttien varastoa; simple-mallissa oma varastorivi on mahdollinen | Group- ja configurable-mallissa lapsivarianttien tunniste ei yleensä kuulu tälle riville; simple-mallissa arvo voi olla oma tai tyhjä |
| H | Tietokannassa on jo historiallinen väärä lapsirivi samalla tunnisteella | Järjestelmä käyttää ensin olemassa olevaa lapsituotetta, jos se löytyy samalla tunnisteella | Simple, group tai configurable | Uudelleenimportti ei välttämättä korjaa omistajaa täysin nykylogiikan mukaiseksi, vaan voi jatkaa kirjoittamista olemassa olevalle lapsiriville | Olemassa oleva lapsirivi voittaa, jos se löytyy samalla tunnisteella | Päivittyy sille tuotteelle, jonka järjestelmä valitsee omistajaksi | Kohdistuu sille tuotteelle, jonka järjestelmä valitsee omistajaksi | Vastaa nykyisen ajon kohdistettavia attribuutteja, mutta omistaja voi silti olla historiallisesti väärä lapsirivi |
Ryhmätuotteet Akeneosta AI Commerceen
Ryhmätuotteiden avulla voit luoda Akeneosta AI Commerce -alustalle ryhmiä, joissa jokaisella tuotteella on oma URL-osoite ja omat tiedot, mutta tuotteet näkyvät silti yhtenä kokonaisuutena. Tällä tavalla voit esimerkiksi kymmenen eri versiota samasta tuotteesta piilottaa kategorianäkymässä muut versiot ja näyttää vain päätuotteen. Ratkaisusta on hyötyä silloin, kun pelkkä varianttierottelu ei riitä kattamaan erilaisia hintoja ja ominaisuuksia.
Vaiheittainen ohje
Luo (tai varmista, että on olemassa) products_group -attribuutti Akeneossa
- Akeneossa tarvitaan valinta-attribuutti koodilla products_group.
- Jos attribuuttia ei ole, voit luoda sen valinta-attribuutiksi, johon määrittelet kaikki käyttämäsi ryhmien nimet (esim. “Group1”, “Kesätuotteet”, “Alennustuotteet” tms.).
- Jatkossa jokaisen tuotteen kohdalla valitaan, mihin ryhmään se kuuluu.
Määritä tuotteet oikeaan ryhmään
- Kun attribuutti Products Group on luotu, avaa haluamasi tuotekortti Akeneossa.
- Valitse attribuutin arvoksi haluamasi ryhmän nimi (esim. “Group1”).
- Tallenna muutokset ja toista sama kaikille tuotteille, jotka haluat kyseiseen ryhmään.
Ymmärrä päätuote-valinnan logiikka
- Akeneossa ei voi tällä hetkellä määritellä, mikä tuote on ryhmän päätuote.
- AI Commerce valitsee oletuksena päätuotteeksi ensimmäisen luodun tuotteen (pienimmän tuote-ID:n).
- Jos haluat vaihtaa päätuotteen, voit kirjautua AI Commerce -hallintapaneeliin ja tehdä sen sieltä käsin.
Muuta päätuote AI Commercessa (tarvittaessa)
- Mene AI Commercen Products-välilehdelle ja valitse Groups-osio.
- Valitse haluamasi ryhmä ja aseta ryhmälle uusi päätuote.
- Tallenna muutokset, jotta AI Commerce näyttää ryhmän valitun tuotteen oletuksena.
Konfiguroi ryhmiteltyjen tuotteiden näkymä AI Commercessa
- Avaa Configuration > My Store AI Commerce -hallintapaneelissa.
- Etsi asetus Hide Grouped Products by Default. Tämän avulla voit piilottaa muut kuin päätuotteen kategorianäkymässä (vain päätuote näytetään).
- Oletusvalinta ei vaikuta jo olemassa oleviin tuoteasetuksiin, mutta jatkossa uudet ryhmätuotteet seuraavat tätä asetusta automaattisesti.
Lisävinkit
- Mukautettu esitystapa: Jos haluat tuotteiden näkyvän tuotekortilla tietynlaisena valintana (esim. alasvetolista tai muu valikko), kysy tarvittaessa integraatiokumppaniltasi mahdollisesta kustomoidusta ratkaisusta.
- Yksilölliset tuotetiedot: Jokaisella ryhmän tuotteella voi olla oma hinta, varastosaldo ja muut attribuutit. SEO-näkökulmasta jokaisella on myös oma URL.
1. Aloita perheen luomisella (Family)
Avaa Asetukset > Perheet
- Valitse olemassa oleva perhe tai luo uusi.
- Täytä kaikki Ominaisuudet -välilehden kentät
- Siirry Attribuutit -välilehdelle ja valitse perheelle tarvitut attribuutit. Muista että attribuutit tulee luoda ennen perheiden ja tuotemallien perustamista.
Siirry Variantit -välilehdelle
- Paina “Luo variantti”
- Luo varianttiulottuvuus yhdessä tasossa, valitse varianttiattribuutit, ja paina “Luo”.
- Valitse seuraavalla sivulla mitkä attribuutit ovat varianttikohtaisia (esim. hinta).
- Vasemmalle jäävät attribuutit periytyvät päätuotteelta, joten ne ovat yhteisiä kaikkien varianttien kesken.
Huom!
Perheiden ja varianttiperheiden rakentamisesta on kattava erillinen artikkeli. Löydät sen hakemalla “Miten luoda perheitä ja varianttiperheitä Akeneossa?”
2. Luo tuotemalli
Siirry tuotteet sivulle
- Valitse yläkulmasta “Luo”
- Valitse “Tuotemalli”
- Anna uniikki tuotekoodi tuotemallille. Yleensä tuotemalli on alkuosa varianttien tuotekoodeista.
- Valitse perhe jonka olet luonut, ja joka sisältää varianttiulottuvuuksia.
- Valitse varianttiperhe jonka olet luonut ensimmäisessä kohdassa perheelle.
- Paina “Tallenna".
- Syötä päätuotteen perustiedot: nimi, kuvaus, hinta, kuvat yms.
3. Lisää variantit
Lisää variantti
- Variantit lisätään tuotteen hallintasivun yläkulman palkista valitsemalla varianttiulottuvuus varianttiulottuvuuden nimestä esim. “Väri ja Koko”, ja sen jälkeen painamalla ”Luo Uusi”.
- Anna variantille sen omat tiedot, kuten koko, väri, EAN-koodi, tuotekoodi sekä varastosaldo.
- Harmaalla näkyvät attribuutit periytyvät yhteisestä päätuotteesta kaikille varianteille. Jos haluat muokata jonkin päätuotteen attribuutin varianttikohtaiseksi toimi artikkelin “Miten luoda perheitä ja varianttiperheitä Akeneossa?” mukaisesti.
- Lisää niin monta varianttia kuin on tarpeen, esim useampi eri koko- ja väriyhdistelmä.
Määritä variantit myös AI Commerceen!
Variantit tulee lisätä myös AI Commerceen Products > Options sivulla. Code -kenttään tulee Akeneossa varianttina käytettävän attribuutin koodi. Tämä vaihe on välttämätöntä, jotta Akeneo API -rajapinta osaa muodostaa attribuuteista variantteja AI Commerceen.
Mikäli varianttiulottuvuuteen sidottuja attribuutteja on jo muodostunut AI Commerceen attribuuteiksi, suosittelemme tuhoaan ne AI Commercen hallintapaneliissa. Jatkossa Akeneon varianttiulottuvuuden attribuutit muodostuvat AI Commercessa varianteiksi. Näet variantit valitsemalla tuotteen, ja siirtymällä tuotteen Stock -välilehdelle.
Huomioi, että tämä vaihe koskee vain variantteja. Ryhmätuotteissa ryhmittely tehdään products_group-attribuutilla eikä Products > Options -määrityksellä.
4. Integrointi ERP-järjestelmän kanssa (valinnainen)
- Jokainen variantti voidaan siirtää ERP-järjestelmään omana tuoterivinään, jos ERP niin vaatii. Sama koskee ryhmätuotteita, joissa jokainen tuote säilyy omana tuotteena.
- Voit pitää verkkokaupan nimitykset selkeinä asiakkaille, mutta hallita tarkempaa tuotetietoa ERP-järjestelmässä (esim. yksilölliset EAN-koodit, varastotilanteet ja muut tuotekohtaiset tiedot).
Yhteenveto
Tuotemallit auttavat keskittämään yhteiset tiedot päätuotteeseen, jolloin varianttien hallinta on sujuvaa ja tehokasta. Kun määrität varianttiattribuutit perheen asetuksissa, voit helposti luoda eri kokoja, värejä tai muita vaihtoehtoja. Jos taas tarvitset ryhmiteltyjä mutta itsenäisiä tuotteita, voit käyttää products_group-attribuuttia ja hallita päätuotteen valintaa sekä ryhmän näkyvyyttä AI Commercessa. Muista myös hyödyntää ERP-integraatiota, jos tarvitset yksityiskohtaista seurantaa tai myyntiraportointia jokaisesta variantista tai ryhmän tuotteesta.