Párujte produkty podľa stabilného SKU alebo externého ID, definujte zdroj pravdy každého poľa a import najprv spustite v režime náhľadu na malej vzorke. Neplatné riadky oddeľte do reportu, dávky robte idempotentne a pred produkčnou aktualizáciou vytvorte zálohu databázy aj médií.
Import produktov do WooCommerce dokáže naplniť alebo aktualizovať katalóg rýchlejšie než ručná redakcia, no jedna nesprávna mapa môže prepísať ceny, založiť duplicitné atribúty alebo odpojiť varianty. CSV zachytáva dávkový stav, API môže prenášať zmeny priebežne. V oboch prípadoch je najdôležitejšia stabilná identita záznamu a presné pravidlo, ktoré polia zdroj vlastní.
Bezpečný import je opakovateľný proces s validáciou, náhľadom zmien, dávkami, chybovým reportom a možnosťou návratu. Prvá skúška patrí na staging a malú reprezentatívnu vzorku, nie na celý produkčný katalóg. Obrázky, taxonómie a varianty potrebujú osobitné mapovanie, pretože textová zhoda názvu nestačí na jednoznačné spojenie.
Vyberte CSV, API alebo kombináciu
CSV je vhodné pre jednorazovú migráciu, kontrolovanú dávku alebo dodávateľský export s menšou frekvenciou. Dá sa manuálne skontrolovať a archivovať, no nerieši samo konflikt zmien. API poskytuje priebežnosť a stavové odpovede, ale potrebuje autentifikáciu, limity, front, monitoring a verziu kontraktu. Výber vychádza z požadovanej čerstvosti a prevádzky.
Často funguje kombinácia: udalosti aktualizujú cenu a sklad, no pravidelný úplný export kontroluje rozdiely. Určte, čo sa stane pri výpadku zdroja a aký vek dát je prijateľný. Manuálny upload nesmie súťažiť s automatickou synchronizáciou o rovnaké pole bez pravidla prednosti.
Vytvorte dátovú mapu a stabilnú identitu
Ku každému stĺpcu alebo API poľu priraďte cieľ, typ, povinnosť, formát, jednotku, slovník a zdroj pravdy. Rozlíšte prázdnu hodnotu od pokynu zmazať. SKU alebo externé ID musí zostať stabilné aj po zmene názvu. Duplicitu identifikátora zastavte pred zápisom, nie po založení dvoch produktov.
Varianty potrebujú rodičovské ID a vlastné variantné SKU. Atribúty mapujte na existujúce globálne termy cez stabilný slug alebo tabuľku synonym, aby import nezakladal `modrá`, `Modra` a `blue`. Kategórie majú vlastnú mapu zdrojového kódu na cieľovú taxonómiu. Voľný text nepoužívajte na odvodenie kritickej klasifikácie bez kontroly.
- Stabilné SKU alebo externé ID
- Výslovný význam prázdnej hodnoty
- Rodič a identita variantu
- Mapovanie taxonómií a jednotiek
Validujte súbor a zobrazte náhľad zmien
Pred importom skontrolujte kódovanie, oddeľovač, hlavičky, počet stĺpcov, dátové typy, povinné hodnoty a jedinečnosť. Pri cene validujte desatinný formát a menu podľa procesu, pri sklade celé číslo či podporovanú hodnotu. Neplatný riadok má dostať číslo, pole a zrozumiteľnú chybu bez zastavenia bezpečne nezávislých riadkov.
Dry run ukáže počet nových, aktualizovaných, nezmenených, deaktivovaných a chybných produktov a vzorku rozdielov po poliach. Nečakané hromadné vymazanie obrázkov alebo cien tak možno zastaviť pred zápisom. Schvaľovateľ potvrdí rozsah a uložený vstupný súbor s checksumom umožní neskôr vysvetliť, čo sa importovalo.
Spracujte dávky idempotentne a bezpečne
Veľký import rozdeľte na dávky s checkpointom a limitom času. Rovnakú dávku možno po prerušení zopakovať bez vytvorenia duplicít alebo druhého obrázka. Každý záznam uložte transakčne podľa možností a výsledok evidujte. Externé obrázky sťahujte s timeoutom, povoleným typom, veľkosťou a kontrolou, že URL nevedie do internej siete.
Počas importu zohľadnite cache, vyhľadávací index, prepočty a webhooky. Nespúšťajte drahú následnú akciu pre každé pole, ak ju možno bezpečne urobiť po dávke. Obmedzte súbeh, aby import neblokoval checkout. Produkčný proces má monitoring rýchlosti, chýb a veku frontu a možnosť pozastavenia bez straty stavu.
- Dávky s checkpointom
- Bezpečné opakovanie rovnakého vstupu
- Limit a validácia externých médií
- Kontrolované následné prepočty
Pripravte rollback a následnú kontrolu
Pred hromadnou zmenou vytvorte obnoviteľnú zálohu databázy a podľa importu aj uploadov. Rollback môže obnoviť celý bod alebo použiť žurnál starých hodnôt, no musí byť vopred otestovaný. Pri živých objednávkach úplná obnova databázy môže stratiť nové transakcie, preto plánujte čas a oddelenie katalógových zmien.
Po importe porovnajte počty, náhodnú aj rizikovú vzorku, ceny, sklad, varianty, kategórie, obrázky a produktové URL. Prejdite vyhľadávanie, filter, košík a export objednávky. Chybové riadky opravte v zdroji a spustite znova, nie ručnou úpravou cieľa, ktorú ďalšia dávka prepíše. Report a mapu uchovajte ako prevádzkovú dokumentáciu.
Časté otázky
Ako importovať produkty bez vytvorenia duplicít?
Použite jedinečné stabilné SKU alebo externé ID a pri každom riadku vykonajte upsert podľa tohto kľúča. Duplicitné či chýbajúce identifikátory pred zápisom odmietnite. Názov produktu nie je spoľahlivá identita.
Môžem importovať obrázky z externých URL?
Áno, ale s timeoutom, limitom veľkosti, kontrolou typu a ochranou pred prístupom do internej siete. Evidujte pôvod a práva. Opakovaný import nemá znova ukladať rovnaký súbor bez potreby.
Čo znamená dry run importu?
Je to náhľad bez zápisu, ktorý validuje vstup a ukáže plánované nové, zmenené, nezmenené a chybné záznamy. Umožní odhaliť nesprávne mapovanie alebo hromadný prepis skôr než ovplyvní katalóg.
Zdroje a ďalšie čítanie
Web developer zo Spišskej Novej Vsi. Venuje sa WordPressu, WooCommerce, vlastným pluginom, API integráciám, webovým aplikáciám a praktickým AI automatizáciám.
