Tämän ohjeen avulla hallitset AI Commercen varastorivejä ja varianttiarvoja nopeasti CSV‑tiedostoilla. Opit viemään ja tuomaan varastotiedot, tekemään massapoistoja sekä päivittämään option arvot turvallisesti niin, että tuotteiden saldo ja historia pysyvät synkronissa.

Mistä editoidaan

• Avaa Hallintapaneelissa Products › Stock valitulle tuotteelle.
• Oikean yläkulman työkalut: CSV Import Stock, CSV Export Stock, CSV Delete Stocks, CSV Import Option Values, CSV Export Option Values

1) CSV Export Stock (varaston vienti)

• Paina CSV Export Stock. Järjestelmä lataa UTF‑8‑koodatun, puolipisteillä (;) erotellun products_stock_export.csv‑tiedoston, jossa jokainen varastorivi on omalla rivillään ja mukana on myös tuotteen SKU.
• Sarakkeet ovat aina samassa järjestyksessä — käytä otsikkoriviä tuontien mallipohjana.

Sarakkeiden järjestys

1. id (vain luku)
2. products_model
3. products_stock_model
4. products_stock_variants
5. products_stock_quantity
6. products_dropshipping_stock
7. products_restock
8. products_stock_barcode
9. products_stock_price
10. products_stock_price_original
11. products_api_id
12. products_stock_api_id
13. products_stock_shelf
14. products_stock_center

2) CSV Import Stock (varaston tuonti)

• Paina CSV Import Stock avataksesi latauspaneelin. Näkymä ohjaa hakemaan malliviennin, tarjoaa valinnaisen Debug Mode ‑valinnan ja tiedoston valinnan.

Latauksen jälkeen

• Tiedosto validoidaan puolipiste‑CSV:nä ja tallennetaan lokiin /products_stock_import-<timestamp>.csv.
• Tuonti ajetaan heti täytenä prosessina (ei erillistä “debug”‑ajoa).

Kohdistusjärjestys

1. id: Jos rivillä on numeerinen id, päivitetään suoraan kyseinen varastorivi. Määrämuutokset kirjataan historiaan toimenpiteellä “CSV stock import”.
2. products_stock_model: Muussa tapauksessa etsitään varaston SKU kirjainkoosta riippumatta, päivitetään osuma ja kirjataan määrähistoria.
3. products_model + products_stock_variants: Jos SKU on uusi, ratkaistaan products_model → tuotteen ID, yhdistetään varianttisignatuuriin ja päivitetään se yhdistelmä tai lisätään uusi varastorivi. Lisäys vaatii products_stock_model‑arvon — puuttuvat SKU:t ohitetaan ja merkitään virheeseen.

Hyväksyttävät kentät

• Kaikki sarakkeet, jotka alkavat products_stock_
• Lisäksi: products_restock, products_dropshipping_stock, products_api_id, products_stock_api_id

Arvojen normalisointi

• Hinnat: pilkut muutetaan pisteiksi ennen numeerista muunnosta.
• Miinusmerkit: Unicode‑miinus korvataan tavallisella ennen lukuarvoksi valua.

Lokitus ja synkronointi

• Jokaisesta käsitellystä rivistä tallennetaan merkintä products_stock_history‑tauluun.
• Tuonnin jälkeen tuotteen products_quantity päivitetään vastaamaan varastorivien summaa.
• Onnistumisviesti kertoo lisätyt, päivitetyt ja ohitetut rivit (syineen), minkä jälkeen näkymä päivitetään ja välimuistit merkitään uudelleenrakennettaviksi.

3) CSV Delete Stocks (varastorivien massapoisto)

• Paina CSV Delete Stocks → Step 1 näyttää palautumattomuusvaroituksen ja linkin vahvistusvaiheeseen.

Step 2: Poistotiedosto

• Lataa poistettava CSV. Otsikon on oltava täsmälleen:

products_stock_model;delete 

• Jokaisella poistettavalla rivillä on oltava sananmukaisesti CONFIRM.

Taustatoiminta

• Tiedosto arkistoidaan muiden CSV:iden rinnalle ja luettavuus sekä otsikko tarkistetaan.
• Duplicaatit, tuntemattomat SKU:t, tyhjät rivit tai rivit ilman CONFIRM ohitetaan ja listataan varoitusyhteenvedossa.
• Onnistunut poisto poistaa varastorivin ja lisää historiaan merkinnän “Destroyed stock via CSV”.
• Valmistumisviesti kertoo poistettujen varianttien määrän ja mahdolliset ohitetut SKU:t, minkä jälkeen näkymä palaa varastonäkymään ja välimuistit virkistetään.

4) CSV Export Option Values (varianttiarvojen vienti)

• CSV Export Option Values lataa products_variants_export.csv (puolipiste‑CSV).
• Jokainen rivi sisältää tuotteen SKU:n, option koodin (options_code), option arvokoodin (options_values_code), hinnan etumerkin (price_prefix) ja API ID:n — näitä voi muokata tai kääntää offline‑tilassa.

5) CSV Import Option Values (varianttiarvojen tuonti)

• Valitse CSV Import Option Values avataksesi latauspaneelin (mallivienti, Debug Mode, tiedoston valinta).

Tuontivaatimukset

• Puolipiste‑CSV tallennetaan validoinnin jälkeen logiin /products_variants_import-<timestamp>.csv.
• products_model pitää löytyä kannasta.
• options_code ja options_values_code pitää vastata ennalta määriteltyjä koodeja. Puuttuvat/tuntemattomat ohitetaan.
• Tuonti estää päällekkäiset yhdistelmät (tuote + optio + arvo). Annettu id päivitetään suoraan, jos sellainen on.
• Uusille riveille asetetaan options_values_price = 0, ja annetut price_prefix sekä options_api_id säilytetään.

Lopputulos

• Selaimeen tulostuu pelkistetty yhteenveto (lisätty/päivitetty/ohitettu) ja prosessi päättyy. Päivitä varastonäkymä jatkaaksesi työskentelyä.

6) Käytännön vinkit

• Aloita viennistä. Käytä aina vastaavan työkalun export‑tiedostoa mallina — takaat oikean otsikkojärjestyksen ja erotinmerkin.
• Älä muuta otsikoita tai järjestystä. Pienikin muutos johtaa sarakemäärä‑/otsikkovirheisiin tuonnissa.
• UTF‑8 + ;. Tallenna CSV UTF‑8‑muodossa ja puolipiste‑erottimella. Tarvittaessa vaihda erotin vientipohjan mukaiseksi ennen latausta.
• Historiakirjaukset ovat odotettuja. Kaikki määrien ja rivien muutokset näkyvät varastohistoriassa (mm. “CSV stock import”, “Destroyed stock via CSV”).
• Poistot varmistuksella. Jaa Step 1 ‑varoitussivu tiimin kanssa ennen varsinaista poistotiedostoa, jotta CONFIRM‑suoja ymmärretään.
• Testaa pienellä erällä. Ennen isoa päivitystä aja 1–5 riviä ja tarkista yhteenvedot.
• Hinnat ja miinusmerkit. Pilkut normalisoidaan pisteiksi ja erikois‑miinukset tavallisiksi; voit toimittaa hinnat myös suoraan pisteellä.

7) Pikaohje (suositeltu työnkulku)

1. Lataa mallivienti (Stock tai Option Values).
2. Muokkaa vain tarvittavat sarakkeet — pidä otsikot ja järjestys.
3. Tuo CSV ja tarkista lisätty/päivitetty/ohitettu‑yhteenveto.
4. Toista tarvittaessa, ja käytä Delete‑työkalua erillisellä, vahvistetulla CSV:llä massapoistoihin.

Yhteenveto

Nopein ja turvallisin tapa hallita varastorivejä ja varianttiarvoja on aloittaa viennillä, tehdä tarvittavat muutokset CSV:hen ja tuoda se takaisin. Testaa aina pienellä erällä, seuraa yhteenvedot ja hyödynnä massapoistoihin erillinen, vahvistettu Delete‑CSV.

Hakusanat

• CSV Import Stock
• CSV Export Stock
• CSV Delete Stocks
• Products Stock
• products_stock_model
• varianttiarvot
• Option Values
• varastorivit
• tuotteen SKU
• AI Commerce