Miten tuoda tuotedata CSV-tiedostolla AI Commerceen?
Käytä CSV-formaattia tuodaksesi tuotteet tehokkaasti ja joustavasti kauppaasi.
Written by Petro Mäntylä
Updated at April 30th, 2025
Sisällysluettelo
Vaiheittainen ohjeistus
Tuotteiden CSV export toimii tuonnin pohjana!
CSV Error"CSV ERROR on line X: found Y columns, expected Z columns." Tämä tarkoittaa, että rivillä on väärä määrä sarakkeita – usein johtuen väärästä delimiterista tai puuttuvista lainausmerkeistä. Tarkistus pysäyttää tuonnin, jotta vain oikein muotoiltu data tallennetaan. CSV-import edellyttää, että sarakkeet erotellaan puolipisteillä (;) ja arvot on sidottu heittomerkeillä ("). Tarkista että käytät ajantasaista pohjatiedostoa!
Mistä editoidaan?
Yhteenveto
Johdannossa käymme läpi, miten CSV-tuonti toimii AI Commercessa ja miten varmistat tuotteiden tietojen oikeellisuuden käyttämällä UTF-8-koodausta ja tarvittaessa ulkoisia PIM-työkaluja (kuten Akeneo). Opit myös, mitkä sarakkeet voit valita tuontiin ja kuinka rajaaminen ainoastaan tarvitsemiisi kenttiin helpottaa sekä nopeuttaa työtäsi. Artikkeli antaa vinkkejä virheiden välttämiseen ja suosittelee aloittamaan pienellä testitiedostolla.
Vaiheittainen ohjeistus
Tuotteiden CSV export toimii tuonnin pohjana!
Tuotteiden CSV-vienti toimii erinomaisena lähtökohtana tuonnille. Voit nopeuttaa prosessia ohittamalla valmisteluvaiheita ja käyttämällä vientitiedostoa pohjana. Huomioithan kuitenkin, että tuonti tukee useampia kenttiä kuin vienti – lisätietoja löydät tästä artikkelista. Vienti tuo tuotteet kansiosta ja sen alakansioista, jossa painat Export Products. Jos haluat kaikki tuotteet vientiin, luo vienti juurihakemistossa.
Valmistele CSV-tiedosto
- Vähimmäisvaatimus on
products_model-kenttä (SKU), joka yksilöi tuotteen. - Lisää vain ne sarakkeet, joita haluat päivittää tai luoda (esim.
products_pricehinnan päivitykseen tai type_id päivittäminen arvoon ”hidden” piilottaaksesi tuotteita). - Voit ladata täydellisen CSV import pohjan CSV Import Products -painikkeen takaa aukeavalta sivulta.
Käytä UTF-8-koodausta
- Tallenna CSV-tiedosto aina UTF-8-muodossa.
- Avattaessa varmista, että ohjelma (esim. Excel tai tekstieditori) käsittelee tiedoston UTF-8:na.
- Näin estät merkistöongelmia, joissa ääkköset tai muut erikoismerkit rikkoutuvat.
Hyödynnä tuotuja kenttiä
-
Tuetut sarakkeet: Esimerkiksi
products_name[fi],products_description[fi],products_imagejne. - Järjestelmä ohittaa kentät, joita ei ole CSV:ssä. Jos sarake on mukana mutta tyhjä, kyseinen tieto tyhjennetään tietokannasta.
Huomioi enimmäisrivit
- Yhdessä CSV-tiedostossa voi olla maksimissaan 10 000 riviä.
- Jos sinulla on enemmän dataa, jaa se useampaan erään.
Hyödynnä PIM-työkaluja (esim. Akeneo)
- Akeneo integroidaan AI Commerceen natiivisti.
- Akeneolla voit hallita ja muotoilla CSV-dataa joustavammin workflow’ssasi.
Tee testisiirto ennen laajempaa päivitystä
- Vie ensin pieni määrä tuotetietoja CSV:llä.
- Vahvista, että tiedot ovat oikein ja että prosessi toimii.
- Tämän jälkeen voit turvallisesti tuoda laajemman datamäärän.
CSV Error
"CSV ERROR on line X: found Y columns, expected Z columns." Tämä tarkoittaa, että rivillä on väärä määrä sarakkeita – usein johtuen väärästä delimiterista tai puuttuvista lainausmerkeistä. Tarkistus pysäyttää tuonnin, jotta vain oikein muotoiltu data tallennetaan. CSV-import edellyttää, että sarakkeet erotellaan puolipisteillä (;) ja arvot on sidottu heittomerkeillä ("). Tarkista että käytät ajantasaista pohjatiedostoa!
CSV-dokumentaatio
Seuraavassa taulukossa on kuvattu jokainen CSV-sarake, sen käyttötarkoitus sekä tyypillinen syöttömuoto. Voit CSV-tiedostoa rakentaessasi sisällyttää vain ne sarakkeet, joita haluat päivittää (esim. pelkän hinnan päivitykseen riittää products_model ja products_price).
Huom. Sarakkeet, joissa näkyy kielikoodi hakasulkeissa (esim.
products_name[fi]), ovat kielispesifisiä.fi= Suomi,sv= Ruotsi,en= Englanti. Voit lisätä tai jättää pois kielisarakkeita tarpeen mukaan.
| Sarake | Kuvaus | Esimerkkiarvo (esim. CSV:ssä) |
|---|---|---|
| products_model | Tuotteen mallikoodi/SKU. Yksilöi tuotteen, joten tätä käytetään tuotteen luomiseen tai päivittämiseen. | 265-22-5932 |
| products_name[fi] | Suomenkielinen tuotenimi. Näkyy mm. tuotelistauksessa ja -sivulla suomeksi. | Sean Gray Neule |
| products_description[fi] | Suomenkielinen tuotekuvaus (pitkä). Näkyy tuotesivun “Kuvaus” -kentässä. | Hieno paita edullisesti |
| products_group | Tuoteryhmän / -perheen nimi, jos halutaan ryhmitellä tuotteet samaan “groupiin”. Jos ryhmä on olemassa, lisätään tähän ryhmään, muuten luodaan uusi. | sean_neuleet |
| categories | Tuotteen kategoriat pilkulla eroteltuna. Nimetys on yleensä category_id -muodossa tai järjestelmän tukemassa muodossa. |
402,403,409 |
| products_image | Tuotteen pääkuvan tiedostonimi tai URL. Jos arvo on URL, se ladataan/viitataan ulkoa. |
sean_neule.jpg tai http://example.com/image.jpg
|
| products_price | Myyntihinta (verottomana tai verollisena riippuen järjestelmäasetuksista). Käytä pistettä desimaalierottimena. | 14.90 |
| products_date_added | Tuotteen lisäämispäivä (muodossa YYYY-MM-DD). Jos jätetään pois, oletuksena käytetään tuontipäivää. |
2020-11-07 |
| products_weight | Tuotteen paino kilogrammoina tai halutussa yksikössä, esim. postituskulujen laskentaan. | 0.90 |
| products_status | Tuotteen julkaisutila: 1 = näytetään (aktiivinen), 0 = piilotettu. |
1 |
| tax_rate | Tuotteen verokanta prosentteina (esim. 24). Järjestelmä muuntaa tarvittaessa verollisen/verottoman hinnan. | 24 |
| manufacturer | Valmistajan / tuotemerkin nimi. Järjestelmä yrittää yhdistää nimen jo olemassa olevaan tai luo tarvittaessa uuden (riippuen logiikasta). | Adidas |
| products_price_sisa | Ostohinta / sisäänostohinta (veroton tai verollinen, kaupan asetuksista riippuen). | 5.20 |
| products_package_size | Pakkauskoko tai vastaava lisätieto (esim. “2.49” = 2,49 litraa/pakkaus). | 2.49 |
| products_location | Sijaintitieto esim. varastopaikasta tai hyllystä. | K01-H02-L03 |
| products_name[sv] | Ruotsinkielinen tuotenimi (vapaaehtoinen). Jos sarake puuttuu, ruotsinkielistä nimeä ei päivitetä. | Sean Gray Knit |
| products_name[en] | Englanninkielinen tuotenimi (vapaaehtoinen). | Sean Gray Knit |
| products_description[sv] | Ruotsinkielinen tuotekuvaus (pitkä). | Jätte bra knit |
| products_description[en] | Englanninkielinen tuotekuvaus (pitkä). | Very nice knit |
| extra_image_1..9 | Enintään 9 lisäkuvaa. Voi olla tiedostonimi tai URL. Aina kun sarake on täytetty, kuva lisätään tuotekuvagalleriaan. |
sean_neule_1.jpg (jne.) |
| attributes_EAN | EAN-/viivakoodi, jos käytössä. (Tässä esimerkissä vain “attributes_EAN” -sarake, ei laajempaa logiikkaa.) | 4274859283744 |
| type_id | Tuotetyyppi kuten simpe tai hidden | simple |
| products_material[fi] | Materiaalitieto suomeksi. | 100% puuvillaa |
| products_material[sv] | Materiaalitieto ruotsiksi. | 100% bomull |
| products_material[en] | Materiaalitieto englanniksi. | 100% cotton |
| products_specs[fi] | Tekniset ominaisuudet tai yksityiskohtaiset lisätiedot suomeksi. | Kiinnitys: Nappi |
| products_specs[sv] | Ruotsiksi vastaavat lisätiedot. | Montering: Knappad |
| products_specs[en] | Englanniksi vastaavat lisätiedot. | Mounting: Buttoned |
| model_option | Mahdollinen lisäkenttä “modelin” tarkentamiseksi. Käyttö riippuu kaupan asetuksista. | 5 |
| products_pdf | Tuotteeseen liittyvän PDF-tiedoston polku. | sean_2020.pdf |
| size_option | Esim. kokovaihtoehtotieto tallennettuna yksittäiseen kenttään (nyt vain merkintänä, ei varianttilogiikkaa). | M |
| types (waist_cut) | Esim. “tyyppi” tai “vyötärön malli” -kenttä. Välimerkkieroteltu, jos useita. | 1,3,4 |
| feature (fitting_option) | Esim. ominaisuudet / istuvuudet (vastaava “feature_option”). | 1 |
| products_bubbles | Voi sisältää tuotekorostuksia / “bubbles” (esim. jokin myyntiviesti). | 2 |
| products_short_description[fi] | Tuotteen lyhyt kuvaus suomeksi. Näkyy mm. listauksissa tai pikakuvauksena. | Lyhyt tuotekuvaus |
| products_short_description[sv] | Tuotteen lyhyt kuvaus ruotsiksi. | Kort produktbeskrivning |
| products_short_description[en] | Tuotteen lyhyt kuvaus englanniksi. | Brief product description |
| availability_in_stock | Järjestelmän ID tai koodi, joka kuvaa “Saatavilla varastossa”. | 1 |
| availability_out_of_stock | Järjestelmän ID tai koodi, joka kuvaa “Loppunut varastosta”. | 2 |
| products_volume_weight | Volumetrinen paino, jos käytössä (esim. 1.5). | 1.5 |
| products_api_model | Integrointeja varten käytettävä sisäinen kenttä (API:lle). | 21242 |
| products_length | Fyysisen tuotteen pituus (esim. millimetreinä). | 400 |
| products_width | Fyysisen tuotteen leveys (mm). | 200 |
| products_height | Fyysisen tuotteen korkeus (mm). | 100 |
| products_price_vatid | B2B-hinta tai verollinen/veroton hinta, jos halutaan erikseen tallentaa eri arvonlisäkannan mukaan (riippuu kaupan logiikasta). | 12.90 |
| products_free_shipping |
1 = tuoteen postikulut = 0, 0 = postikulut normaalisti. |
0 |
| products_sort | Järjestelmän sisäinen järjestysnumero tuotelistaukseen. | 90 |
| products_minimum | Minimitilausmäärä. | 2 |
| products_discount_group | Alennusryhmä, jolla voidaan ohjata määränpohjaisia tai asiakasryhmäpohjaisia alennuksia. | 5 |
| is_customize |
1 = tuote on räätälöitävä (esim. tarve valita ominaisuuksia), 0 = ei. |
1 |
| hide_grouped_products |
1 = piilota tuote “group view” -listauksesta, 0 = näytä. |
1 |
| products_link_href | Ulkoinen linkki tuotesivulta, esim. valmistajan sivu. | https://www.apple.com/fi/iphone-13-pro/ |
| products_price_disc | Mahdollinen “alennettu” tai kampanjahinta, tai muu lisäkenttä. | 190.90 |
| extra_image_top | Yksi ylimääräinen kuva “yläpaikkaan” (esim. korostetulle hero-kuvalle). | 1 |
| products_youtube_link | YouTube-osoite tai embed-linkki. | https://www.youtube.com/embed/befkWAWGDLM |
| products_gallery_id | Gallerian ID, jos käytössä. | 104 |
| related_products |
Pelkät SKU:t pilkulla eroteltuna: SKU100,FILA112Tällöin järjestelmä luo tuoterivin, jossa kaikki nämä SKU:t linkitetään toisiinsa tuotteiden pääkuvilla. SKU + ekstra-ID hakasuluissa: SKU100[12] Jos haluat liittää lisäkuva-ID:n (esim. 12) liittyvälle tuotteelle, lisää se hakasulkeissa SKU:n perään. |
|
Mistä editoidaan?
- Voit tuoda CSV-tiedostosi AI Commerce hallintapaneelissa esimerkiksi kohdassa: Tools > Import (nimike voi vaihdella kaupan asetuksista riippuen).
- Valitse tiedostoksi oma UTF-8-koodattu CSV ja suorita tuonti.
- Tarkista, että halutut sarakkeet (kuten
products_pricetaiproducts_name[fi]) vastaavat kaupan odottamia kenttiä.
Yhteenveto
CSV-tuonti AI Commercessa on joustava ja nopea tapa päivittää tuotteiden perustietoja, hintoja tai kieliversioita. Kun noudatat UTF-8-koodausta ja aloitat pienellä testitiedostolla, minimoit virheet. Tarvittaessa voit laajentaa käyttöä PIM-järjestelmillä, jolloin CSV:n hallinta helpottuu merkittävästi.