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 August 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-tuotteen rakenne siirretään kahdessa erillisessä CSV-aineistossa. options sisältää pakettivaihtoehdot, kuten otsikon, tyypin ja pakollisuuden. selections sisältää vaihtoehtoon liitetyt lapsituotteet, määrät, hinnan ja järjestyksen. Valinnat voidaan tuoda vasta, kun niiden vaihtoehdot ja kaikki pää- sekä lapsituotteet ovat olemassa.

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 options-tuonnilla

Päivitä vaihtoehdot avaamalla Data Exchange > Pakettien tuonti, valitsemalla lajiksi options ja lataamalla tai liittämällä CSV CSV-sisältö -kenttään. Valitse Esikatsele ennen ajoa ja tarkista enintään 100 näytettävää riviä sekä kokonaisrivimäärä.

Jos option_code vastaa olemassa olevaa vaihtoehtoa, tuonti päivittää sen päätuotteen, pakollisuuden, järjestyksen ja tyypin. Samalla se lisää tai päivittää kyseisen language_code-kielen otsikon ja kuvauksen. Jos koodia ei löydy, tuonti luo uuden vaihtoehdon annetulla koodilla.

Tyhjä option_code luo uuden vaihtoehdon ja antaa sille ajon aikana muodon option_{ID}. Käytä mieluummin omaa pysyvää ja yksilöllistä koodia, kuten option_putkihattu_001, jotta myöhempi valintatuonti ja päivitys kohdistuvat ennakoitavasti. Vie aineisto ajon jälkeen uudelleen, jos järjestelmä loi koodin.

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