Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

  • Ota yhteyttä
Finnish
FI Finnish
US English (US)
  • Koti
  • AI Commerce Cloud
  • Tuotteet

Bundle-tuotteiden vienti ja tuonti CSV-tiedostoilla

Opi helpot keinot viedä ja tuoda Bundle-tuotteita käyttämällä CSV-tiedostoja!

Written by Petro Mäntylä

Updated at October 18th, 2026

Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

  • AI Commerce Cloud
    Hallinnan etusivu Asiakkuudet Tilaukset Tilausten hallinta Kategoriat Tarjoustyökalu Tuotteet Konfiguraatiot Moduulit Paikallisasetukset ja verot Arvostelut Etusivu FAQ -työkalu Kuvagalleria Työkalut Kassa Lisätoiminnot Svelte Raportit
  • Akeneo
  • WordPress
  • Builder.io
  • Algolia
  • Google
  • Meta
  • Tuki
  • Tehden
  • Partnerit
    Miksi valita AI Commerce?
  • Microsoft
  • Integraatiot
  • Enrerprise Solutions
  • Yleiset sopimusehdot
  • Agentic Commerce
+ Lisää

Sisällysluettelo

Export Bundle Options Export Bundle Selections Import Bundle Options Import Bundle Selections CSV-tiedostojen formaatti ja suositukset Esimerkkitaulukot bundle_options.csv (Export / Import) bundle_selections.csv (Export / Import) Rajoitukset & huomioitavaa Yhteenveto

Bundle-tuotteiden massasiirto käyttää kahta aineistoa

Bundle-tuotteiden massamuokkaus onnistuu turvallisesti, kun käsittelet rakenteen kahdessa järjestyksessä. options-aineisto määrittää pakettivaihtoehdot, niiden otsikot, tyypit ja pakollisuuden. selections-aineisto liittää vaihtoehtoihin lapsituotteet, määrät, hinnat ja järjestyksen. Tuo vaihtoehdot ensin ja valinnat vasta sen jälkeen.

Turvallinen etenemisjärjestys:

  1. Vie sekä options- että selections-aineisto ja säilytä ne muuttamattomina vertailua varten.
  2. Testaa ensin yhdellä bundle-tuotteella, että koodit, kielitekstit, lapsituotteet ja hinnat muodostuvat oikein.
  3. Tuo vaihtoehdot, tarkista tulos ja tuo vasta sitten valinnat.
  4. Varmista lopuksi bundle-rakenne, oletusvalinnat, määrät ja hinnoittelu Hallintapaneelissa.

Vienti auttaa palautusvertailussa, mutta tuonti lisää ja päivittää rivejä eikä poista tiedostosta puuttuvia vaihtoehtoja tai valintoja.

Hallintapaneelissa massasiirrot kuuluvat Data Exchange-työtilaan. Käytä profiileja Pakettien vienti ja Pakettien tuonti. Kummassakin valitaan aineistolajiksi options tai selections.

Luo ensin yksi pieni bundle-tuote käyttöliittymässä ja varmista se verkkokaupassa. Vie sen molemmat aineistot, säilytä alkuperäiset tiedostot muuttamattomina ja tee muokkaukset kopioihin. Vienti toimii rakennepohjana, mutta tuonti ei ole täydellinen palautusmekanismi, koska se lisää tai päivittää rivejä eikä poista tiedostosta puuttuvia rivejä.

Vie pakettivaihtoehdot CSV-tiedostoon

Vie pakettivaihtoehdot avaamalla Data Exchange > Pakettien vienti, valitsemalla bundle-viennin lajiksi options ja käynnistämällä vienti. Lataa valmis CSV-artefakti. Tiedoston nimi alkaa muodolla bundle-options.

Pakettivaihtoehtojen sarakkeet ovat järjestyksessä option_code, parent_sku, required, position, type, language_code, title ja description.

Jokainen rivi kuvaa yhtä vaihtoehdon ja kielen yhdistelmää. Sama option_code ja parent_sku toistuvat jokaiselle kieliversiolle. required kertoo pakollisuuden kokonaislukuna, position järjestyksen, type valintatavan, language_code kielen sekä title ja description asiakkaalle näytettävät tekstit.

Vie bundle-valinnat CSV-tiedostoon

Vie bundle-valinnat samalla Pakettien vienti -profiililla valitsemalla lajiksi selections. Lataa valmis artefakti, jonka nimi alkaa muodolla bundle-selections. Jokainen rivi yhdistää yhden lapsituotteen yhteen pakettivaihtoehtoon ja päätuotteeseen.

Valintojen otsikot ovat täsmälleen:

option_code,parent_sku,sku,position,is_default,selection_price_type,selection_price_value,selection_qty,selection_can_change_qty

sku on lapsituotteen SKU. position ohjaa järjestystä, is_default oletusvalintaa, selection_price_type hinnoittelutapaa, selection_price_value hintalukua, selection_qty oletusmäärää ja selection_can_change_qty asiakkaan oikeutta muuttaa määrää. Jokainen lapsituote on omalla rivillään.

Muokkaa CSV-tiedostoa rikkomatta formaattia

Muokkaa aina viennin kopiota. Vienti ja tuonti käyttävät pilkkua erottimena ja lainausmerkkiä tekstikenttien suojaamiseen. Jos otsikko tai kuvaus sisältää pilkun, CSV-ohjelman pitää lainata kenttä oikein. Älä vaihda tiedostoa puolipiste-erotelluksi.

Tallenna tiedosto UTF-8-muodossa. Tuonti hyväksyy myös UTF-8 BOM -merkin ensimmäisen otsikon alusta, mutta tavallinen UTF-8 ilman BOM-merkkiä on siirrettävin vaihtoehto. Säilytä kaikki vaaditut otsikot. Otsikoiden fyysinen järjestys saa muuttua, koska tuonti kohdistaa arvot nimillä, mutta jokaisella datarivillä pitää olla sama määrä sarakkeita kuin otsikkorivillä.

Pidä SKU:t ja option_code-arvot tekstinä. Älä anna taulukkolaskennan muuttaa koodeja päivämääriksi, poistaa alkunollia tai käyttää desimaalipilkkua numeerisessa hinnassa. Tyhjät rivit ohitetaan, mutta tyhjä tiedosto ja pelkkä otsikkorivi hylätään.

Päivitä pakettivaihtoehdot ja kysymykset options-tuonnilla

options-tuonti lisää ja päivittää sekä tuotteita sisältäviä pakettivaihtoehtoja että paketin Kysymykset-välilehdellä hallittavia asiakaskysymyksiä. Vie ensin nykytila kohdasta Tiedonsiirto > Pakettien vienti valitsemalla Bundle-vienti-arvoksi options. Muokkaa ladatun bundle-options-tiedoston kopiota, jotta pysyvät kysymyskoodit, kielirivit ja nykyiset radiovalinnat säilyvät mukana.

options-tiedoston otsikkorivi on täsmälleen tässä järjestyksessä:

option_code,parent_sku,required,position,type,language_code,title,description,choice_id,choice_position,choice_label,show_when_option_code,show_when_choice_id

Säilytä otsikot ja niiden järjestys muuttumattomina. option_code on pakollinen pysyvä tunniste, parent_sku paketin päätuotteen SKU, required arvo 1 tai 0, position kokonaislukuna annettava järjestys, language_code aktiivisen kauppakielen koodi sekä title ja description kyseisen kielen asiakastekstit. Käytä omaa yksilöllistä koodia, kuten option_putkihattu_001; tyhjää arvoa tai mallimerkintää option_{ID} ei voi tuoda. Sama vaihtoehto tai kysymys kuvataan samalla option_code- ja parent_sku-yhdistelmällä kaikilla sen riveillä.

Tuotteita sisältävä tavallinen pakettivaihtoehto käyttää nykyisiä type-arvoja ja jättää viisi kysymyskohtaista saraketta tyhjiksi. Asiakaskysymyksen tyyppi on jokin seuraavista:

  • input_radio näyttää radiovalinnat. Tee yksi rivi jokaista kielen ja valinnan yhdistelmää kohti. choice_id on pysyvä valintakoodi, choice_position valinnan järjestys ja choice_label kyseisen kielen näkyvä nimi. Toista samat valintakoodit ja järjestykset kaikilla mukana olevilla kielillä. Uudella valinnalla pitää olla nimi vähintään yhdellä kielellä.
  • input_number pyytää positiivisen luvun. Tee yksi rivi jokaista mukana olevaa kieltä kohti ja jätä choice_id, choice_position ja choice_label tyhjiksi.
  • input_note pyytää enintään 200 merkin vapaaehtoisen huomautuksen. Käytä required-arvoa 0, tee yksi rivi jokaista mukana olevaa kieltä kohti ja jätä valintasarakekolmikko tyhjäksi.

Ehdollinen kysymys käyttää sarakkeita show_when_option_code ja show_when_choice_id aina yhdessä. Ensimmäiseen annetaan saman päätuotteen aiempana olevan input_radio-kysymyksen option_code ja toiseen sen olemassa oleva choice_id. Ehtoa ohjaavan radiokysymyksen pitää olla järjestyksessä ennen ehdollista kysymystä eikä se voi itse olla ehdollinen. Jätä molemmat sarakkeet tyhjiksi, kun kysymys näytetään aina.

  1. Avaa Tiedonsiirto > Pakettien tuonti ja valitse muokattu CSV-tiedosto. Tuonti tunnistaa options- ja selections-aineistot niiden täsmällisistä otsikoista.
  2. Valitse Esikatsele valittu CSV. Tarkista lisättäviksi, päivitettäviksi ja virheellisiksi luokitellut rivit. Esikatselu tarkistaa muun muassa päätuotteet, kielet, tyypit, pysyvät koodit, radiovalinnat ja näyttöehdot.
  3. Korjaa kaikki virheet tiedostoon ja esikatsele se uudelleen. Valitse vasta virheettömälle aineistolle Suorita tuonti, vahvista suoritus ja tarkista suoritusraportti.
  4. Vie options-aineisto uudelleen ja tarkista yhden päätuotteen Paketti > Kysymykset -näkymä sekä asiakkaan pakettikonfiguraattori.

Tuonti on lisäävä ja päivittävä: tiedostosta puuttuvaa vaihtoehtoa, kysymystä, kielitekstiä tai radiovalintaa ei poisteta. Olemassa olevan radiokysymyksen päivityksessä jokainen sen nykyinen choice_id pitää kuitenkin sisällyttää vähintään kerran; puuttuva valintakoodi aiheuttaa esikatseluvirheen. Tiedostossa mukana oleva kielirivi päivitetään, mutta pois jätetty olemassa oleva kieli säilyy. Paketin tuotteet, hinnat ja määrät kuuluvat edelleen erilliseen selections-aineistoon, eikä kysymysrivi lisää tuotetta tai muuta paketin hintaa.

Päivitä lapsituotteet selections-tuonnilla

Päivitä vaihtoehtojen lapsituotteet valitsemalla Pakettien tuonti -profiilin lajiksi selections. Jokainen rivi etsii option_code-arvolla olemassa olevan pakettivaihtoehdon, parent_sku-arvolla päätuotteen ja sku-arvolla lapsituotteen.

Jos saman vaihtoehdon, päätuotteen ja lapsituotteen yhdistelmä on jo olemassa, tuonti päivittää järjestyksen, oletusvalinnan, hinnoittelutavan, hinnan, määrän ja määrän muokattavuuden. Muussa tapauksessa se lisää uuden valinnan. selection_price_value ja selection_qty ovat pakollisia numeerisia arvoja; niitä ei voi jättää tyhjäksi tuonnissa.

Tuo options ensin ja selections vasta sen onnistuttua. Valintatuonti ei luo puuttuvaa vaihtoehtoa, päätuotetta tai lapsituotetta. Kaikkien SKU-arvojen pitää viitata ennalta olemassa oleviin tuotteisiin.

Ymmärrä esikatselun ja ajon raja

Esikatselun ja ajon raja kulkee rakenteen ja liiketoimintaviittausten välissä. Esikatselu tarkistaa CSV:n otsikot, sarakemäärät, aineistolajin ja sen, että tiedostossa on rivejä. Se näyttää enintään 100 ensimmäistä riviä. Esikatselu ei ratkaise SKU:ita, kielikoodeja, option_code-viittauksia eikä kaikkien numeroarvojen kelvollisuutta.

Varsinainen Aja-toiminto validoi viittaukset ja arvot kirjoituksen aikana. Tuntematon päätuotteen SKU, lapsituotteen SKU, kielikoodi tai vaihtoehtokoodi aiheuttaa virheen. Myös virheellinen kokonaisluku tai numeerinen arvo keskeyttää ajon. Riviä ei ohiteta hiljaisesti.

Koko tuontiajo suoritetaan yhdessä tietokantatransaktiossa. Jos mikä tahansa rivi epäonnistuu, koko ajo perutaan eikä yksikään sen rivi jää voimaan. Onnistuneen ajon jälkeen järjestelmä laskee jokaisen muutetun päätuotteen bundle-hinnan uudelleen ja tyhjentää tuotekohtaisen välimuistin.

Käytä kenttiä niiden täsmällisen merkityksen mukaan

Käytä kenttiä niiden täsmällisen merkityksen mukaan. Pakettivaihtoehdon required käyttää kokonaislukua 1 pakolliselle ja 0 valinnaiselle. position on kokonaisluku, jossa pienempi arvo näytetään ensin. type tallennetaan tekstinä; käytä vain tuote-editorin tarjoamia tyyppejä, kuten radio, checkbox, select, multi tai dropdown.

Valinnan is_default käyttää arvoja 1 ja 0. selection_can_change_qty käyttää vastaavasti arvoa 1, jos asiakas saa muuttaa määrää, ja 0, jos määrä on lukittu. selection_qty on numeerinen oletusmäärä.

selection_price_type ja selection_price_value tallennetaan suoraan bundle-valinnan hinnoitteluun. selection_price_type-arvojen 0 ja 1 täsmällistä hinnoittelumerkitystä ei ole vahvistettu. Älä muuta näitä arvoja laajasti ennen kuin olet vienyt toimivan esimerkin ja varmistanut hinnan verkkokaupassa.

Käytä vientiä palautusvertailuna, ei sokeana varmuuskopiona

Tallenna ennen muutosta sekä options- että selections-vienti turvalliseen paikkaan. Nimeä tiedostot ympäristön, päivämäärän ja aineistolajin mukaan. Älä tallenna niihin henkilötietoja tai salaisuuksia; tuotetunnisteet voivat silti olla liiketoiminnallisesti luottamuksellisia.

Vienti auttaa vertaamaan ennen- ja jälkeen-tilaa ja palauttamaan muuttuneita rivejä uudella tuonnilla. Tuonti lisää tai päivittää rivejä eikä poista tiedostosta puuttuvia vaihtoehtoja tai valintoja. Tarvittavat poistot tehdään tuotteen Paketti-näkymässä tai erikseen hyväksytyllä poistoprosessilla.

Älä pidä onnistunutta ajotilaa ainoana palautustodisteena. Vie molemmat aineistot ajon jälkeen ja vertaa odotettuihin riveihin. Tarkista myös päätuotteen bundle-rakenne ja hinta verkkokaupassa.

Tarkista pieni koeajo ennen massamuutosta

Tee ensin koeajo yhdellä päätuotteella. Vie toimiva vaihtoehto ja valinta, muuta vain yhtä selkeästi havaittavaa arvoa ja suorita options- tai selections-tuonti sen mukaan. Tarkista ajon onnistuminen, käsitelty rivimäärä ja uusi vienti.

Tarkista seuraavaksi tuotteen Paketti-näkymästä vaihtoehdon koodi, pakollisuus, tyyppi, järjestys, kielitekstit, lapsituotteet, oletusvalinta, määrä ja hinnoittelu. Avaa sama tuote verkkokaupassa ja käy valinnat läpi asiakkaan näkökulmasta.

Laajenna tiedostoa vasta onnistuneen kokeen jälkeen. Koska yksi virhe peruu koko ajon, käsittele suuret muutokset loogisina, tarkistettavina erinä. Säilytä jokaisen erän syöte, ajon pyyntö-ID ja ajon jälkeinen vienti vianrajausta varten.

Esimerkit kahdesta CSV-aineistosta

Esimerkit kahdesta CSV-aineistosta alkavat pakettivaihtoehdoista: ensimmäinen sisältää kaksi kieltä samalle vaihtoehdolle ja yhden valinnaisen vaihtoehdon.

option_5,ABC-123,1,1,radio,fi,Kiinnikkeet,Valitse 2 kpl kiinnikkeitä
option_5,ABC-123,1,1,radio,en,Fixtures,Pick two
option_6,ABC-123,0,2,checkbox,fi,Jalusta,Valitse jalusta

Valintojen esimerkissä jokainen lapsituote on omalla rivillään:

option_code,parent_sku,sku,position,is_default,selection_price_type,selection_price_value,selection_qty,selection_can_change_qty
option_5,ABC-123,KNI-001,1,1,0,0.00,2,1
option_5,ABC-123,KNI-002,2,0,1,1.50,1,0
option_6,ABC-123,JAL-100,1,0,0,0.00,1,1

Esimerkkien SKU:t, koodit ja hinnat ovat malliarvoja. Korvaa ne oman ympäristösi viennistä saaduilla arvoilla. Älä aja esimerkkirivejä sellaisenaan tuotantoon.

Bundle-tuonti on valmis vasta rakenne- ja hintavarmennuksen jälkeen

Bundle-tuonti on valmis, kun molempien aineistolajien ajo on onnistunut, ajon jälkeinen vienti vastaa tarkoitusta, tuote-editorin rakenne on oikea ja asiakkaan valinnat sekä hinta toimivat verkkokaupassa. Tarkista myös lapsituotteiden olemassaolo ja saatavuus.

Jos ajo epäonnistuu, käytä virheen rivinumeroa ja koodia korjauksen lähtökohtana. Älä poista riviä vain saadaksesi ajon vihreäksi, vaan varmista, onko kyse puuttuvasta tuotteesta, kielestä, vaihtoehdosta, numeerisesta arvosta vai väärästä sarakerakenteesta.

Pidä pysyvät option_code-, parent_sku- ja sku-arvot integraatioiden yhteisenä sopimuksena. Näin myöhempi vienti, tuonti ja käsin tehty muokkaus kohdistuvat samoihin tuotteisiin ja vaihtoehtoihin ilman hiljaista ohitusta.

bundle tuotteet tuotepaketit pakettituotteet bundle products csv tuonti csv vienti tuotteiden tuonti tuotteiden vienti tuotetuonti tuotevienti bundle import bundle export csv tiedosto tuontitiedosto bundle tuotteiden csv tuonti

Oliko artikkeli hyödyllinen?

Kyllä
Ei
Anna palautetta tästä artikkelista

Yhteenkuuluvat artikkelit

  • Ryhmätuotteiden hallinta
  • Liittyvien tuotteiden hallinta AI Commerce -hallintapaneelissa
  • Näin luot pakettituotteen AI Commercessa
  • Miten murupolku näyttää oikean tuotekategorian?
  • Suodatettavien ryhmätuotteiden käyttö
AI Commerce Logo

Future-proof eCommerce, built in the EU

AI Commerce Cloud is developed and hosted within the EU, fully compliant with GDPR and all relevant regulations.

Solutions

Service packages Features Integrations Customers

About us

About us Support Vision Contact us

Development

Changelog Blog Implementation Partners System status
AI Commerce Cloud FI0818073-0
Ranta-Tampellan Katu 17, 33180 Tampere, Finland
info@aicommerce.fi
Privacy Policy Licensing Rights Terms of Use
© 2025 AI Commerce Cloud. All rights reserved.
Expand