Tento článok je podrobná referencia stĺpcov CSV súboru pre import produktov. Postup samotného importu a exportu nájdete v Import, export a produktové feedy; tu je presný zoznam polí a ich správanie.
Kde to nájdete
Katalóg > Produkty > Import a export na /admin/products/import-export. Šablónu si stiahnete priamo z tejto obrazovky.
Zoznam stĺpcov šablóny
| Stĺpec | Povinné | Formát | Kam sa uloží |
|---|---|---|---|
id | nie | číslo | identifikátor produktu — ak je vyplnený, riadok vždy aktualizuje existujúci produkt |
name | áno | text | názov produktu (jediné povinné pole) |
slug | nie | text | URL adresa produktu; pri novom produkte sa bez vyplnenia vygeneruje z názvu |
description | nie | text | popis produktu |
short_description | nie | text | krátky popis |
price | nie | číslo bez meny | predajná cena; pri novom produkte bez hodnoty sa uloží 0 |
compare_at_price | nie | číslo bez meny | pôvodná (preškrtnutá) cena pre zobrazenie zľavy |
cost_price | nie | číslo bez meny | nákupná cena (interná, nezobrazuje sa zákazníkovi) |
sku | nie | text | skladové číslo produktu; ak id nie je vyplnené, podľa tohto poľa sa hľadá existujúci produkt |
barcode | nie | text | čiarový kód |
weight | nie | číslo | hmotnosť |
stock | nie | celé číslo | zásoba na úrovni produktu; pri novom produkte bez hodnoty sa uloží 0 |
status | nie | active / draft / archived (aj 1/0) | stav produktu; neznáma hodnota sa potichu uloží ako active |
categories | nie | text, mená oddelené čiarkou | priradí produkt k EXISTUJÚCIM kategóriám (hľadané podľa slugu, potom podľa mena); nepridáva chýbajúce kategórie a existujúce priradenia nemaže |
tags | nie | text, mená oddelené čiarkou | priradí štítky; neexistujúci štítok sa vytvorí (štítky sú voľné, na rozdiel od kategórií) |
variant_id | nie | číslo | identifikátor variantu; ak je vyplnený, aktualizuje konkrétny variant |
variant_name | nie | text | názov variantu |
variant_sku | nie | text | SKU variantu; ak variant_id chýba, podľa neho sa hľadá variant v rámci daného produktu |
variant_price | nie | číslo bez meny | cena variantu |
variant_stock | nie | celé číslo | zásoba variantu |
meta_title | nie | text | SEO meta titulok |
meta_description | nie | text | SEO meta popis |
Pozor: Stĺpcecategoriesatagssú symetrické s exportom — sú oddelené čiarkou (Kategoria 1, Kategoria 2). Kategória, ktorá v systéme neexistuje, sa NEVYTVORÍ — riadok sa v polierrorsnahlási ako nenájdená kategória, no zvyšok riadku (produkt, cena, sklad...) sa uloží normálne. Štítok, ktorý neexistuje, sa pri importe rovno založí.
Pravidlo aktualizácie vs. vytvorenia nového produktu
Riadok sa vyhodnotí presne v tomto poradí:
- Ak je vyplnené `id`, aktualizuje sa produkt s daným identifikátorom.
- Inak, ak je vyplnené `sku`, hľadá sa existujúci produkt podľa SKU.
- Ak sa produkt nenašiel ani jedným spôsobom, vytvorí sa nový.
Tip: Pri aktualizácii sa prázdna bunka chápe ako „nemeniť", nie ako „vymazať". Súbor len so stĺpcamiidapriceteda upraví iba cenu a všetky ostatné polia produktu ostanú bez zmeny. Pri vytváraní nového produktu naopak prázdna bunka znamená prázdnu alebo predvolenú hodnotu.
Varianty v CSV
Riadok sa berie ako riadok variantu, ak obsahuje vyplnené variant_id, variant_sku alebo variant_name (stačí ktorékoľvek z nich). Variant sa hľadá najprv podľa variant_id, inak podľa variant_sku v rámci nájdeného produktu. Ak sa nenájde, vytvorí sa nový variant — bez vyplneného mena dostane názov „Default", bez SKU dostane {sku produktu}-V a bez ceny prevezme aktuálnu cenu produktu.
Obmedzenia súboru
- Formát
.csvalebo.txt, kódovanie UTF-8 (BOM sa rozpozná automaticky). - Maximálna veľkosť súboru 10 MB.
- Prvý riadok musí byť hlavička s presnými názvami stĺpcov zo šablóny.
- Súbor sa spracúva po dávkach, chyba v jednom riadku nezastaví zvyšok importu.
Časté chyby
- „Nazov produktu je povinny." — stĺpec
nameje v danom riadku prázdny; toto je jediné pole, bez ktorého sa riadok nedá spracovať. - „nespravny pocet stlpcov" — riadok má iný počet buniek než hlavička (chýbajúca alebo pridaná čiarka, zle uložený súbor).
- „Subor sa nepodarilo otvorit." / „Subor neobsahuje hlavicku." — nahraný súbor je prázdny alebo bez hlavičkového riadka.
- Stav produktu sa po importe nezmenil podľa očakávania. Skontrolujte hodnotu v stĺpci
status— platné sú lenactive,draft,archived(alebo1/0); iná hodnota sa potichu uloží akoactive. - „kategória '...' neexistuje, produkt do nej nebol priradený." — meno v stĺpci
categoriessa nezhoduje so slugom ani menom žiadnej existujúcej kategórie; import ju nezakladá, iba to nahlási. Kategóriu najprv založte (Katalóg > Kategórie) a súbor naimportujte znova.