Kako izvesti množični uvoz izdelkov v WooCommerce

Možnost 1: vgrajeni uvoznik CSV v WooCommerce

WooCommerce vsebuje uvoznik in izvoznik izdelkov CSV. V skrbniškem vmesniku WordPress odprite „Products → All Products“ in izberite „Import“. Naložite CSV, stolpce preslikajte v polja WooCommerce in zaženite uvoz. Če obkljukate „Update existing products“, lahko posodobite izdelke, ki se ujemajo po ID-ju ali SKU, namesto da bi ustvarili dvojnike.

• Najprej izvozite en obstoječi izdelek in to datoteko uporabite kot predlogo — pokaže točna imena stolpcev, ki jih pričakuje vaša trgovina.
• Značilni stolpci so Type, SKU, Name, Published, Short description, Description, Regular price, Categories, Tags, Images in Attribute 1 name / Attribute 1 value(s).
• Slike se uvozijo z URL-jev, zato morajo biti ob zagonu uvoza javno dosegljive.
• Spremenljivi izdelki potrebujejo nadrejeno vrstico tipa „variable“ in po eno vrstico za vsako različico, ki se sklicuje na nadrejeno.
• Zelo velike datoteke lahko na skupnem gostovanju prekoračijo časovno omejitev — razdelite jih na serije po nekaj sto vrstic.

Možnost 2: vtičniki za uvoz

Vtičniki za uvoz tretjih oseb dodajo funkcije, ki jih jedrni uvoznik nima: načrtovane ali ponavljajoče se uvoze iz vira podatkov dobavitelja, podporo za XML, pravila za preoblikovanje polj in boljše ravnanje z zelo velikimi datotekami. Smiselni so, kadar dobavitelj redno pošilja posodobljene datoteke s cenami in zalogo.

Vtičniki še vedno pričakujejo strukturiran vnos. Če vam dobavitelj namesto vira podatkov pošilja PDF-je, vtičnik ne odpravi dela s pretvorbo teh PDF-jev v vrstice.

Možnost 3: WooCommerce REST API

Razvijalci in orodja za integracije lahko izdelke ustvarijo prek WooCommerce REST API, vključno s končno točko za serije, ki v eni zahtevi ustvari ali posodobi veliko izdelkov. To ustreza avtomatiziranim procesom in aplikacijam, ki izdelke ustvarjajo neposredno brez koraka CSV.

Doc2Shelf uporablja to pot: po pregledu pošlje izdelke v WooCommerce kot preproste osnutke izdelkov z dolgim in kratkim opisom, da jih lahko preverite v WooCommerce, preden jih objavite. Globalni atributi za filtre in spremenljivi izdelki se v WooCommerce nastavijo ločeno.

Priprava podatkov o izdelkih za množični uvoz

Ne glede na metodo uvoza kakovost podatkov odloča o rezultatu. Pred uvozom:

• Vsakemu izdelku dodelite enolični SKU — z njim posodobitve pozneje najdejo pravi izdelek.
• Najprej v WooCommerce ustvarite kategorije in globalne atribute, nato se nanje dosledno sklicujte.
• Normalizirajte specifikacije: enake enote, enaka imena atributov, ena vrednost na celico.
• Napišite prave opise, namesto da bi prilepili besedilo dobavitelja; tržnice in iskalniki nagrajujejo edinstveno besedilo.
• Za prvi zagon uvozite kot osnutke — nastavite Published na -1 (0 naredi izdelke zasebne) — nato pred objavo vsega pregledajte vzorec.

Kadar dobavitelj pošilja samo PDF-je

Številni dobavitelji tehnične liste in kataloge zagotavljajo kot PDF-je, ne kot vire podatkov CSV. V tem primeru je ozko grlo pridobivanje podatkov: nekdo mora prebrati vsak PDF, izpolniti stolpce in napisati opis.

To lahko storite ročno ali pa podatke izvlečete z orodjem in jih pregledate. Doc2Shelf prebere PDF-je dobaviteljev, izvleče specifikacije za pregled, pripravi dolge in kratke opise za WooCommerce ter izdelke prek REST API ustvari kot osnutke — nadomešča korak s preglednico pri katalogih, ki izvirajo iz PDF-jev.

Pogoste napake pri uvozu v WooCommerce

Če uvoz ne uspe ali daje nepričakovane rezultate, najprej preverite naslednje:

• Podvojeni ali manjkajoči SKU-ji, zaradi katerih se vrstice preskočijo ali izdelki podvojijo.
• Napačno kodiranje datoteke — CSV shranite kot UTF-8, da se naglašeni znaki pravilno uvozijo.
• URL-ji slik, ki preusmerjajo, zahtevajo prijavo ali kažejo na zelo velike datoteke.
• Nedosledno zapisane poti kategorij (za gnezdene kategorije uporabite „Parent > Child“).
• Različice, katerih vrednosti atributov se ne ujemajo z vrednostmi atributov nadrejenega izdelka.

Referenca stolpcev CSV za izdelke v WooCommerce

Osnovni uvoznik prebere stalen nabor imen stolpcev. Z izvozom enega izdelka iz lastne trgovine dobite natančne glave, ki jih pričakuje vaša različica WooCommerce; spodnja tabela pojasnjuje stolpce, ki so za množično nalaganje najpomembnejši. Zahtevan je samo Name — vsi drugi stolpci so neobvezni, vendar katalog, uvožen brez Type, SKU, cen in kategorij, pozneje pusti veliko ročnega dela.

Stolpci z enoto v glavi, kot sta Weight in tri dimenzije, prikazujejo enoto, nastavljeno v nastavitvah vaše trgovine, zato te glave prekopirajte iz izvoza, namesto da jih tipkate. Podatki po meri brez lastnega stolpca gredo v stolpec, katerega glava se začne z meta:, ki mu sledi ključ polja.

Spremenljivi izdelki v CSV: nadrejene vrstice in vrstice različic

Spremenljivi izdelek je razporejen čez več vrstic: ena nadrejena vrstica, ki opredeli izdelek in vrednosti atributov, ki jih ponuja, ter ena vrstica na različico, ki nosi ceno, SKU in zalogo za posamezno kombinacijo. Nadrejena vrstica ima Type »variable«; vsaka vrstica različice ima Type »variation« in se v stolpcu Parent sklicuje na nadrejeni izdelek s SKU nadrejenega ali z id: in njegovim ID.

Stolpci atributov povezujejo vrstice. V nadrejeni vrstici Attribute 1 value(s) navaja vse vrednosti, ki jih izdelek ponuja, ločene z vejicami. V vsaki različici se pojavi isti Attribute 1 name z natanko eno od teh vrednosti. Črkovanje in velike začetnice se morajo ujemati: različica z »red« pod nadrejenim izdelkom, ki ponuja »Red«, lahko ostane brez uporabne vrednosti atributa.

Attribute 1 global nastavite na 1 v nadrejeni vrstici in njenih različicah, kadar uporabljate atribut za celotno trgovino, ustvarjen v razdelku Izdelki → Atributi — z njim delujeta slojevita navigacija in pripomočki za filtre. Od WooCommerce 11.1 lahko uvoz za posodobitev obstoječemu spremenljivemu izdelku doda tudi nove različice, zato lahko skupino razširite, ne da bi ponovno zgradili nadrejeni izdelek.

• Vsako nadrejeno vrstico hranite nad njenimi različicami, da je datoteko lahko preveriti in da nadrejeni izdelek obstaja, ko se nanj sklicujejo njegove različice.
• Vsaki različici dodelite lasten SKU in ceno; različice brez cene ni mogoče kupiti.
• Z Attribute 1 default v nadrejeni vrstici nadzirate, katera možnost je vnaprej izbrana.

Dodajanje slik izdelkov prek CSV

Stolpec Images sprejme enega ali več URL-jev slik, ločenih z vejicami. Prvi URL postane glavna slika, preostali tvorijo galerijo izdelka v navedenem vrstnem redu. Med uvozom WordPress vsako datoteko prenese v vašo medijsko knjižnico, zato mora biti vsak URL v tistem trenutku javno dosegljiv — brez prijave, brez potekajoče povezave za skupno rabo in brez preusmeritve na spletno stran namesto na datoteko.

Slike so običajno najpočasnejši del uvoza: nekaj sto izdelkov s po petimi slikami pomeni več kot tisoč prenosov. Slike pred gostovanjem pomanjšajte, uporabite opisna imena datotek (kettle-red-front.jpg, ne IMG_0042.jpg) in velike kataloge razdelite na manjše datoteke.

Osnovni uvoznik ne more nastaviti nadomestnega besedila slik (alt). Nadomestno besedilo dodajte pozneje v medijski knjižnici, prek REST API ali z razširitvijo za uvoz, ki to podpira. Različica vsebuje eno samo sliko, zato vsaki vrstici različice dodelite največ en URL.

Množično ustvarjanje izdelkov z WooCommerce REST API

REST API je boljša pot, kadar se uvozi ponavljajo, kadar podatki o izdelkih že živijo v drugem sistemu ali kadar nihče ne bi smel ročno upravljati datoteke CSV. Njegova končna točka za paketno obdelavo izdelkov (POST /wp-json/wc/v3/products/batch) v eni zahtevi sprejme operacije ustvarjanja, posodabljanja in brisanja.

Privzeto je zahteva za paketno obdelavo omejena na 100 objektov skupaj pri ustvarjanju, posodabljanju in brisanju. Ista omejitev velja za končne točke za paketno obdelavo različic, kategorij, atributov in vrednosti atributov. Katalog s 1.000 izdelki zato zahteva vsaj deset zahtev, več pa, ko so dodane različice.

1. Ustvarite ključ REST API z dovoljenjem za branje/pisanje v razdelku WooCommerce → Settings → Advanced → REST API ali pa aplikaciji omogočite, da ga zahteva prek WooCommerceovega zaslona za odobritev.
2. Najprej ustvarite kategorije, globalne atribute in vrednosti atributov ter si zapišite njihove ID-je.
3. Pošljite enostavne in nadrejene izdelke v paketih do 100 s statusom, nastavljenim na draft.
4. Različice vsakega spremenljivega izdelka ustvarite prek končne točke za paketno obdelavo različic tega izdelka.
5. V odgovoru preverite rezultat za vsak element in ponovno poskusite samo tiste, ki niso uspeli.
6. Preverite vzorec osnutkov v skrbniškem vmesniku in jih nato objavite.

Izbira vtičnika ali poti za množično nalaganje izdelkov v WooCommerce

Če osnovni uvoznik ne zadošča, vtičnik ali razširitev za uvoz presojajte po tem, kako obravnava vaše podatke, ne po dolžini seznama funkcij, in ga, preden se zavežete, preizkusite na preizkusni kopiji trgovine z resnično datoteko dobavitelja. Tabela primerja štiri poti, sledijo vprašanja, ki jih je vredno zastaviti vsakemu vtičniku.

• Izvorni formati: samo CSV ali tudi XML, preglednice in oddaljeni viri, prenešeni prek URL.
• Razporejanje: ali lahko uvoz ponovno izvede po urniku, da prevzame nove cene in zalogo.
• Preslikava in pretvorbe: preimenovanje stolpcev, razdelitev vrednosti, pretvorba enot in uporaba cenovnih pravil med uvozom.
• Spremenljivi izdelki: ali zanesljivo gradi nadrejene izdelke, različice in globalne atribute.
• Slike: kako jih prenaša, ali zaznava dvojnike in ali nastavi nadomestno besedilo.
• Velike datoteke: obdelava v ozadju ali po delih, da dolgi uvozi ne potečejo.
• Pravila za posodabljanje: po katerem ključu se ujema (ID, SKU ali GTIN) in katera polja sme prepisati.

Kontrolni seznam pred uvozom in odpravljanje napak

Večina neuspelih uvozov izvira iz izpuščenega koraka priprave. Kontrolni seznam preglejte pred vsakim velikim uvozom, s tabelo pa diagnosticirajte težave, ki se še pojavijo.

1. Naredite varnostno kopijo zbirke podatkov ali izvedite uvoz na preizkusni kopiji trgovine.
2. Izvozite en obstoječ izdelek in njegovo glavno vrstico prekopirajte v svojo datoteko.
3. Ustvarite kategorije, globalne atribute in vrednosti atributov, na katere se datoteka sklicuje.
4. Preverite, da je vsak SKU enoličen in da vrednost Parent vsake različice ustreza obstoječemu SKU nadrejenega izdelka.
5. V stolpcih za ceno, zalogo, težo in mere uporabite navadna števila.
6. Vzorec URL-jev slik odprite v zasebnem oknu brskalnika in potrdite, da se naložijo brez prijave.
7. Nastavite Published na -1, da izdelki prispejo kot osnutki.
8. Datoteko shranite kot CSV v kodiranju UTF-8.
9. Uvozite preizkusno datoteko z desetimi vrsticami, preglejte rezultate, nato preostalo uvozite v paketih.

Preizkus z navideznimi izdelki pred pravim uvozom

Majhna navidezna datoteka odkrije napake pri preslikavi, preden prizadenejo na stotine izdelkov. Zgradite jo iz svoje prave predloge, da so glave enake, in vsakemu preizkusnemu izdelku dodajte očitno oznako — predpono SKU »TEST-« in oznako »test« — da jih lahko pozneje najdete in izbrišete.

Pokrijte vsak primer, ki ga vsebuje vaša prava datoteka, ne samo lahkega. Običajno zadošča okoli deset vrstic:

• En enostaven izdelek z izpolnjenimi vsemi stolpci, ki jih nameravate uporabljati.
• En spremenljiv izdelek z dvema atributoma in vsaj tremi različicami.
• En izdelek z galerijo več slik in en brez slik.
• En izdelek v gnezdeni kategoriji, ki še ne obstaja.
• En izdelek s črkami s strešicami, narekovaji in vejico v opisu.
• Ena vrstica, ki posodobi obstoječi izdelek po SKU.
• Preverite rezultate v skrbniškem vmesniku in na spletni trgovini — cene, spustne sezname različic, vrstni red slik in strani kategorij — nato preizkusne izdelke pred pravim uvozom izbrišite.