Párujte produkty podle stabilního SKU nebo externího ID, definujte zdroj pravdy pro každé pole a import nejprve spusťte v režimu náhledu na malém vzorku. Neplatné řádky oddělte do reportu, dávky provádějte idempotentně a před produkční aktualizací vytvořte zálohu databáze i médií.
Import produktů do WooCommerce dokáže naplnit nebo aktualizovat katalog rychleji než ruční redakce, ale jedno nesprávné mapování může přepsat ceny, založit duplicitní atributy nebo odpojit varianty. CSV zachycuje dávkový stav, API může přenášet změny průběžně. V obou případech je nejdůležitější stabilní identita záznamu a přesné pravidlo, která pole zdroj vlastní.
Bezpečný import je opakovatelný proces s validací, náhledem změn, dávkami, chybovým reportem a možností návratu. První zkouška patří na staging a malý reprezentativní vzorek, ne na celý produkční katalog. Obrázky, taxonomie a varianty potřebují samostatné mapování, protože textová shoda názvu nestačí k jednoznačnému propojení.
Vyberte CSV, API nebo kombinaci
CSV je vhodné pro jednorázovou migraci, kontrolovanou dávku nebo dodavatelský export s nižší frekvencí. Lze jej ručně zkontrolovat a archivovat, ale samo neřeší konflikt změn. API poskytuje průběžnost a stavové odpovědi, potřebuje však autentizaci, limity, frontu, monitoring a verzi kontraktu. Volba vychází z požadované aktuálnosti dat a z provozu.
Často funguje kombinace: události aktualizují cenu a sklad, ale pravidelný úplný export kontroluje rozdíly. Určete, co se stane při výpadku zdroje a jaké stáří dat je přijatelné. Ruční upload nesmí soupeřit s automatickou synchronizací o stejné pole bez pravidla přednosti.
Vytvořte datovou mapu a stabilní identitu
Ke každému sloupci nebo poli API přiřaďte cíl, typ, povinnost, formát, jednotku, číselník a zdroj pravdy. Rozlišujte prázdnou hodnotu od pokynu ke smazání. SKU nebo externí ID musí zůstat stabilní i po změně názvu. Duplicitu identifikátoru zastavte před zápisem, nikoli až po založení dvou produktů.
Varianty potřebují rodičovské ID a vlastní variantní SKU. Atributy mapujte na existující globální termy přes stabilní slug nebo tabulku synonym, aby import nezakládal `modrá`, `Modra` a `blue`. Kategorie mají vlastní mapu zdrojového kódu na cílovou taxonomii. Volný text nepoužívejte k odvození kritické klasifikace bez kontroly.
- Stabilní SKU nebo externí ID
- Výslovný význam prázdné hodnoty
- Rodič a identita varianty
- Mapování taxonomií a jednotek
Validujte soubor a zobrazte náhled změn
Před importem zkontrolujte kódování, oddělovač, hlavičky, počet sloupců, datové typy, povinné hodnoty a jedinečnost. U ceny validujte desetinný formát a měnu podle procesu, u skladu celé číslo či podporovanou hodnotu. Neplatný řádek má dostat číslo, pole a srozumitelnou chybu, aniž by se zastavily bezpečně nezávislé řádky.
Dry run ukáže počet nových, aktualizovaných, nezměněných, deaktivovaných a chybných produktů a vzorek rozdílů po jednotlivých polích. Nečekané hromadné smazání obrázků nebo cen tak lze zastavit před zápisem. Schvalovatel potvrdí rozsah a uložený vstupní soubor s checksumem umožní později vysvětlit, co se importovalo.
Zpracujte dávky idempotentně a bezpečně
Velký import rozdělte na dávky s checkpointem a časovým limitem. Stejnou dávku lze po přerušení zopakovat bez vytvoření duplicit nebo druhého obrázku. Každý záznam ukládejte podle možností transakčně a výsledek evidujte. Externí obrázky stahujte s timeoutem, povoleným typem, velikostí a kontrolou, že URL nevede do interní sítě.
Během importu zohledněte cache, vyhledávací index, přepočty a webhooky. Nespouštějte drahou následnou akci pro každé pole, pokud ji lze bezpečně provést po dávce. Omezte souběh, aby import neblokoval checkout. Produkční proces má monitoring rychlosti, chyb a stáří fronty a možnost pozastavení bez ztráty stavu.
- Dávky s checkpointem
- Bezpečné opakování stejného vstupu
- Limit a validace externích médií
- Kontrolované následné přepočty
Připravte rollback a následnou kontrolu
Před hromadnou změnou vytvořte obnovitelnou zálohu databáze a v závislosti na importu i nahraných souborů. Rollback může obnovit celý bod nebo použít žurnál starých hodnot, musí však být předem otestován. U živých objednávek může úplná obnova databáze způsobit ztrátu nových transakcí, proto plánujte načasování a oddělení katalogových změn.
Po importu porovnejte počty, náhodný i rizikový vzorek, ceny, sklad, varianty, kategorie, obrázky a produktové URL. Projděte vyhledávání, filtr, košík a export objednávky. Chybné řádky opravte ve zdroji a spusťte import znovu, nikoli ruční úpravou cíle, kterou další dávka přepíše. Report a mapu uchovejte jako provozní dokumentaci.
Časté dotazy
Jak importovat produkty bez vytváření duplicit?
Použijte jedinečné stabilní SKU nebo externí ID a u každého řádku proveďte upsert podle tohoto klíče. Duplicitní či chybějící identifikátory před zápisem odmítněte. Název produktu není spolehlivá identita.
Mohu importovat obrázky z externích URL?
Ano, ale s timeoutem, limitem velikosti, kontrolou typu a ochranou před přístupem do interní sítě. Evidujte původ a práva. Opakovaný import nemá znovu ukládat stejný soubor bez potřeby.
Co znamená dry run importu?
Je to náhled bez zápisu, který validuje vstup a ukáže plánované nové, změněné, nezměněné a chybné záznamy. Umožní odhalit nesprávné mapování nebo hromadný přepis dříve, než ovlivní katalog.
Zdroje a další čtení
Adam Antoni vyvíja weby, aplikácie a softvér na mieru. Prepája firemné systémy, automatizuje procesy a vytvára AI agentov. Pôsobí v Spišskej Novej Vsi a spolupracuje s firmami na celom Slovensku.
