Guide

Sådan masseuploader du produkter til WooCommerce

WooCommerce kan importere hundredvis af produkter ad gangen fra en CSV-fil. Denne guide gennemgår den indbyggede importør, hvornår et plugin eller REST API giver mere mening, og hvordan du får rene data ind i CSV-filen fra starten.

At tilføje produkter ét ad gangen i WooCommerce-administrationen er fint for en lille butik, men at onboarde et leverandørkatalog på den måde kan tage dage. WooCommerce har en indbygget CSV-importør til produkter, og der findes importplugins og et API til større eller tilbagevendende opgaver.

Selve importen er sjældent det svære. Det svære er at lave en korrekt CSV: én række pr. produkt eller variation, de rigtige kolonner, ensartede attributter og beskrivelser, der er værd at publicere.

Mulighed 1: Den indbyggede WooCommerce CSV-importør

WooCommerce leveres med en CSV-importør og -eksportør til produkter. Gå i WordPress-administrationen til Produkter → Alle produkter, og vælg Importér. Upload din CSV, knyt dens kolonner til WooCommerce-felter, og kør importen. Hvis du markerer »Update existing products«, kan du opdatere produkter, der matches på ID eller SKU, i stedet for at oprette dubletter.

  • Eksportér først ét eksisterende produkt, og brug filen som skabelon — den viser de præcise kolonnenavne, din butik forventer.
  • Typiske kolonner er Type, SKU, Name, Published, Short description, Description, Regular price, Categories, Tags, Images og Attribute 1 name / Attribute 1 value(s).
  • Billeder importeres fra URL'er, så de skal være offentligt tilgængelige, når importen kører.
  • Variable produkter kræver en overordnet række af typen »variable« og én række pr. variation, der henviser til den overordnede.
  • Meget store filer kan time ud på delt hosting — del dem op i batches på nogle hundrede rækker.

Mulighed 2: Importplugins

Importplugins fra tredjeparter tilføjer funktioner, som kerneimportøren mangler: planlagte eller tilbagevendende importer fra et leverandørfeed, understøttelse af XML, regler for feltomdannelse og bedre håndtering af meget store filer. De giver mening, når en leverandør jævnligt sender opdaterede pris- og lagerfiler.

Plugins forventer stadig struktureret input. Hvis din leverandør sender PDF'er i stedet for et feed, fjerner et plugin ikke arbejdet med at omsætte PDF'erne til rækker.

Mulighed 3: WooCommerce REST API

Udviklere og integrationsværktøjer kan oprette produkter via WooCommerce REST API, herunder et batch-endpoint, der opretter eller opdaterer mange produkter i én forespørgsel. Det passer til automatiserede pipelines og apps, der opretter produkter direkte uden et CSV-trin.

Doc2Shelf bruger denne vej: efter gennemgang sender det produkter til WooCommerce som simple kladdeprodukter med lange og korte beskrivelser, så du kan tjekke dem i WooCommerce, før de går live. Globale filterattributter og variable produkter konfigureres separat i WooCommerce.

Forberedelse af produktdata til masseupload

Uanset hvilken importmetode du bruger, afgør datakvaliteten resultatet. Før du importerer:

  • Giv hvert produkt en unik SKU — det er sådan, senere opdateringer finder det rigtige produkt.
  • Opret kategorier og globale attributter i WooCommerce først, og henvis derefter konsekvent til dem.
  • Normalisér specifikationer: samme enheder, samme attributnavne, én værdi pr. celle.
  • Skriv rigtige beskrivelser i stedet for at indsætte leverandørens tekst; markedspladser og søgemaskiner belønner unikt indhold.
  • Importér som kladder ved første kørsel — sæt Published til -1 (0 gør produkterne private) — og gennemgå derefter en stikprøve, før du publicerer det hele.

Når din leverandør kun sender PDF'er

Mange leverandører leverer datablade og kataloger som PDF'er, ikke som CSV-feeds. I så fald er flaskehalsen udtrækket: nogen skal læse hver PDF, udfylde kolonnerne og skrive en beskrivelse.

Du kan gøre det manuelt eller udtrække dataene med et værktøj og gennemgå dem. Doc2Shelf læser leverandør-PDF'er, udtrækker specifikationerne til gennemgang, udarbejder lange og korte WooCommerce-beskrivelser og opretter produkterne som kladder via REST API — og erstatter dermed regnearkstrinnet for kataloger, der stammer fra PDF'er.

Almindelige fejl ved WooCommerce-import

Hvis en import mislykkes eller giver uventede resultater, så tjek først disse punkter:

  • Dublerede eller manglende SKU'er, der får rækker til at blive sprunget over eller produkter til at blive duplikeret.
  • Forkert filkodning — gem CSV-filen som UTF-8, så tegn med accenter importeres korrekt.
  • Billed-URL'er, der omdirigerer, kræver login eller peger på meget store filer.
  • Kategoristier skrevet uensartet (brug »Overordnet > Underordnet« til indlejrede kategorier).
  • Variationer, hvis attributværdier ikke svarer til det overordnede produkts attributværdier.

Kolonnereference til WooCommerce-produkt-CSV

Standardimportværktøjet læser et fast sæt kolonnenavne. Hvis du eksporterer ét produkt fra din egen butik, får du de nøjagtige overskrifter, din WooCommerce-version forventer; tabellen nedenfor forklarer de kolonner, der betyder mest ved et masseupload. Kun Name er påkrævet — alle andre kolonner er valgfrie, men et katalog importeret uden Type, SKU, priser og kategorier giver meget manuelt arbejde bagefter.

Kolonner med en enhed i overskriften, såsom Weight og de tre mål, viser den enhed, der er konfigureret i dine butiksindstillinger, så kopiér disse overskrifter fra en eksport i stedet for at skrive dem. Egne data uden en kolonne af sig selv placeres i en kolonne, hvis overskrift begynder med meta: efterfulgt af feltnøglen.

Standardkolonner i WooCommerces CSV-importværktøj (WooCommerce 3.1 og nyere)
KolonneHvad den indeholderEksempelBemærkninger
IDEksisterende WooCommerce-produkt-ID—Lad feltet stå tomt for nye produkter; opdateringsimport matcher først på ID.
TypeProdukttypesimpleOgså variable, variation, grouped eller external. Virtual og downloadable er egenskaber, der føjes til et produkt, ikke selvstændige typer.
SKUDin unikke produktkodeACME-KTL-17Anden matchnøgle ved opdateringer efter ID. Skal være unik i butikken.
GTIN, UPC, EAN eller ISBNGlobal produktidentifikator4006381333931Standardfelt. Siden WooCommerce 11.2 den alternative matchnøgle, når både ID og SKU er tomme.
NameProdukttitelElkedel i rustfrit stål 1,7 LDen eneste påkrævede kolonne.
PublishedStatus efter import-11 = publiceret, 0 = privat, -1 = kladde, 2 = afventer gennemgang.
Regular price / Sale pricePriser49.90Almindelige tal uden valutasymbol.
StockLagerantal25Brug sammen med In stock? og Backorders allowed? efter behov.
Weight (unit), Length (unit), Width (unit), Height (unit)Forsendelsesvægt og -mål1.2Overskriften viser butikkens enhed, f.eks. kg eller cm.
CategoriesProduktkategorierKøkken > Elkedler, GaverKommasepareret; »>« markerer en underkategori.
ImagesBilled-URL'erhttps://cdn.example.com/ktl-front.jpgKommasepareret; det første billede bliver det fremhævede billede.
ParentOverordnet produkt til en variantrækkeACME-KTLDet overordnede produkts SKU eller id: efterfulgt af det overordnede produkts ID.
Attribute 1 name / Attribute 1 value(s)En attribut og dens værdierFarve / Rød, BlåTilføj Attribute 2, Attribute 3 og så videre for flere attributter.
Attribute 1 visible / Attribute 1 globalFlag for den pågældende attribut1 / 1Visible viser den på produktsiden; global bruger en butiksdækkende attribut.
Attribute 1 defaultForudvalgt værdi for et variabelt produktRødAngiv den på den overordnede række.
meta:supplier_codeEt brugerdefineret metafeltD-4471Enhver overskrift, der begynder med meta:, gemmes som brugerdefineret meta.

Variable produkter i en CSV: overordnede rækker og variantrækker

Et variabelt produkt fordeles over flere rækker: én overordnet række, der definerer produktet og de attributværdier, det tilbyder, og én række pr. variant, der indeholder pris, SKU og lager for en enkelt kombination. Den overordnede række har Type »variable«; hver variantrække har Type »variation« og peger tilbage på den overordnede række i kolonnen Parent ved hjælp af den overordnede rækkes SKU eller id: efterfulgt af dens ID.

Attributkolonnerne binder rækkerne sammen. På den overordnede række angiver Attribute 1 value(s) alle de værdier, produktet tilbyder, adskilt af kommaer. På hver variant optræder det samme Attribute 1 name med præcis én af disse værdier. Stavning og store/små bogstaver skal stemme overens: en variant, der angiver »rød«, under et overordnet produkt, der tilbyder »Rød«, kan ende uden en brugbar attributværdi.

Sæt Attribute 1 global til 1 på det overordnede produkt og dets varianter, når du bruger en butiksdækkende attribut oprettet under Produkter → Attributter — det er den, lagdelt navigation og filterwidgets arbejder med. Siden WooCommerce 11.1 kan en opdateringsimport også tilføje nye varianter til et variabelt produkt, der allerede findes, så du kan udvide en serie uden at genopbygge det overordnede produkt.

  • Hold hver overordnet række over sine varianter, så filen er nem at kontrollere, og det overordnede produkt findes, når varianterne henviser til det.
  • Giv hver variant sin egen SKU og pris; en variant uden pris kan ikke købes.
  • Brug Attribute 1 default på det overordnede produkt til at styre, hvilken mulighed der er forudvalgt.
Eksempel: én elkedel solgt i to farver
RækkeTypeSKUParentAttribute 1 nameAttribute 1 value(s)
OverordnetvariableACME-KTL—FarveRød, Blå
Variant 1variationACME-KTL-REDACME-KTLFarveRød
Variant 2variationACME-KTL-BLUACME-KTLFarveBlå

Tilføjelse af produktbilleder via CSV'en

Kolonnen Images accepterer én eller flere billed-URL'er adskilt af kommaer. Den første URL bliver det fremhævede billede, og resten udgør produktgalleriet i den angivne rækkefølge. Under importen henter WordPress hver fil ind i dit mediebibliotek, så hver URL skal være offentligt tilgængelig i det øjeblik — uden login, uden delingslink, der udløber, og uden omdirigering til en webside i stedet for filen.

Billeder er som regel den langsomste del af en import: et par hundrede produkter med fem billeder hver giver over tusind downloads. Tilpas billedstørrelsen, før du hoster dem, brug sigende filnavne (kettle-red-front.jpg, ikke IMG_0042.jpg), og del store kataloger op i mindre filer.

Standardimportværktøjet kan ikke angive alt-tekst til billeder. Tilføj alt-tekst bagefter i mediebiblioteket, via REST API'et eller med en importudvidelse, der understøtter det. En variant rummer ét enkelt billede, så giv hver variantrække højst én URL.

Masseoprettelse af produkter med WooCommerce REST API

REST API'et er den bedste vej, når importer gentages, når produktdata allerede ligger i et andet system, eller når ingen skal håndtere en CSV overhovedet. Dets batch-endpoint for produkter (POST /wp-json/wc/v3/products/batch) accepterer oprettelse, opdatering og sletning i én enkelt forespørgsel.

Som standard er en batch-forespørgsel begrænset til 100 objekter på tværs af oprettelser, opdateringer og sletninger. Samme grænse gælder for batch-endpoints til varianter, kategorier, attributter og attributværdier. Et katalog med 1.000 produkter kræver derfor mindst ti forespørgsler og flere, når varianter tilføjes.

  1. Opret en REST API-nøgle med læse-/skrivetilladelse under WooCommerce → Indstillinger → Avanceret → REST API, eller lad en app anmode om en via WooCommerces godkendelsesskærm.
  2. Opret først kategorierne, de globale attributter og attributværdierne, og notér deres ID'er.
  3. Send enkle og overordnede produkter i batches på op til 100 med status sat til kladde (draft).
  4. Opret varianterne for hvert variabelt produkt via det pågældende produkts batch-endpoint for varianter.
  5. Kontrollér resultatet for hvert element i svaret, og gentag kun de elementer, der fejlede.
  6. Foretag stikprøvekontrol af et udvalg af kladderne i administrationen, og publicér dem derefter.

Valg af plugin eller metode til masseupload af WooCommerce-produkter

Hvis standardimportværktøjet ikke slår til, så bedøm et importplugin eller en udvidelse ud fra, hvordan det håndterer dine data, ikke ud fra længden af funktionslisten, og test det på en staging-kopi af butikken med en rigtig leverandørfil, før du forpligter dig. Tabellen sammenligner de fire metoder, efterfulgt af de spørgsmål, der er værd at stille til ethvert plugin.

  • Kildeformater: kun CSV eller også XML, regnearksfiler og eksterne feeds hentet via URL.
  • Planlægning: om det kan gentage en import efter en tidsplan for at hente nye priser og lagerbeholdning.
  • Mapping og transformationer: omdøbning af kolonner, opdeling af værdier, omregning af enheder og anvendelse af prisregler under importen.
  • Variable produkter: om det pålideligt opbygger overordnede produkter, varianter og globale attributter.
  • Billeder: hvordan det henter dem, om det registrerer dubletter, og om det angiver alt-tekst.
  • Store filer: baggrunds- eller delvis behandling, så lange importer ikke timer ud.
  • Opdateringsregler: hvilken nøgle det matcher på (ID, SKU eller GTIN), og hvilke felter det må overskrive.
Fire måder at masseuploade WooCommerce-produkter på
MetodeBedst tilVær opmærksom på
Standard-CSV-importværktøjEngangsimporter og masseopdateringer foretaget af butikkens medarbejdereServerens upload- og tidsgrænser; ingen alt-tekst til billeder
Importplugin eller udvidelseTilbagevendende leverandørfeeds, XML- eller regnearkskilder, planlagte opdateringerEndnu et plugin, der skal vedligeholdes og holdes kompatibelt
REST API batch-forespørgslerAutomatiserede pipelines og synkronisering fra et andet systemUdviklertid; som standard 100 objekter pr. batch-forespørgsel
App, der opretter produkter for digProduktdata, der starter uden for et regneark, f.eks. leverandørdokumenterTjek, hvilke produkttyper og felter appen faktisk angiver

Tjekliste før import og rettelse af fejl

De fleste mislykkede importer skyldes et sprunget forberedelsestrin. Gennemgå tjeklisten før hver stor import, og brug tabellen til at diagnosticere problemer, der stadig opstår.

  1. Tag en sikkerhedskopi af databasen, eller kør importen på en staging-kopi af butikken.
  2. Eksportér ét eksisterende produkt, og kopiér dets overskriftsrække ind i din fil.
  3. Opret de kategorier, globale attributter og attributværdier, som filen henviser til.
  4. Kontrollér, at hver SKU er unik, og at hver variants Parent-værdi matcher en eksisterende SKU på et overordnet produkt.
  5. Brug almindelige tal i kolonnerne for pris, lager, vægt og mål.
  6. Åbn et udvalg af billed-URL'er i et privat browservindue for at bekræfte, at de indlæses uden login.
  7. Sæt Published til -1, så produkterne kommer ind som kladder.
  8. Gem filen som UTF-8 CSV.
  9. Importér en testfil med ti rækker, gennemgå resultaterne, og importér derefter resten i batches.
Problemer ved WooCommerce-import: årsag og løsning
ProblemSandsynlig årsagLøsning
Produkter duplikeres i stedet for at blive opdateret»Opdater eksisterende produkter« er ikke afkrydset, eller ID'er og SKU'er matcher ikke butikkenSæt kryds i indstillingen; kopiér ID'er eller SKU'er fra en ny eksport
Rækker springes over ved opdateringsimportIntet match på ID eller SKU (GTIN forsøges kun, når begge er tomme, siden 11.2)Tilføj det eksisterende produkts SKU eller ID til hver række
Varianter importeret som separate produkterType er ikke sat til variation, eller kolonnen Parent er tom eller forkert stavetBrug Type »variation« og den nøjagtige SKU for det overordnede produkt
Billeder manglerURL kræver login, omdirigerer, eller værten blokerer downloadHost billederne på offentlige, direkte URL'er, og kør importen igen
Fil afvist ved uploadFilen er større end serverens maksimale uploadstørrelseDel filen op, eller bed din hostingudbyder om at hæve grænsen
Importen stopper undervejsServerens tids- eller hukommelsesgrænse er nåetImportér mindre filer

Test med dummy-produkter før den rigtige import

En lille dummy-fil fanger mappingfejl, før de rammer hundredvis af produkter. Byg den ud fra din rigtige skabelon, så overskrifterne er identiske, og giv hvert testprodukt en tydelig markering — et SKU-præfiks »TEST-« og et tag »test« — så du kan finde og slette produkterne bagefter.

Dæk hvert tilfælde, din rigtige fil indeholder, ikke kun det nemme. Omkring ti rækker er normalt nok:

  • Ét enkelt produkt med alle de kolonner udfyldt, du planlægger at bruge.
  • Ét variabelt produkt med to attributter og mindst tre varianter.
  • Ét produkt med et galleri med flere billeder og ét uden billeder.
  • Ét produkt i en indlejret kategori, der ikke findes endnu.
  • Ét produkt med accenttegn, anførselstegn og et komma i beskrivelsen.
  • Én række, der opdaterer et eksisterende produkt via SKU.
  • Kontrollér resultaterne i administrationen og i butikken — priser, rullemenuer til varianter, billedrækkefølge og kategorisider — og slet derefter testprodukterne før den rigtige import.

Ofte stillede spørgsmål

Har WooCommerce en indbygget masseupload af produkter?
Ja. WooCommerce indeholder en CSV-importør til produkter under Produkter → Alle produkter → Importér samt en tilsvarende eksportør. Der kræves intet plugin til almindelige CSV-importer.
Hvor mange produkter kan jeg importere til WooCommerce ad gangen?
Importøren har ingen fast produktgrænse, men servertimeouts og hukommelsesgrænser hos din hosting afgør, hvad der er praktisk muligt. Det er normalt at dele store kataloger op i batches på nogle hundrede rækker.
Kan jeg opdatere eksisterende produkter med en CSV-import?
Ja. Aktivér »Update existing products« i importøren; rækkerne matches med eksisterende produkter på ID eller SKU, og kun de kolonner, du medtager, opdateres.
Kan jeg importere produkter til WooCommerce direkte fra PDF'er?
Ikke med kerneimportøren, som forventer CSV. Du skal først udtrække produktdataene fra PDF'erne — manuelt eller med et udtrækværktøj — og derefter importere dem via CSV eller oprette produkterne via REST API.
Hvilke kolonner skal en WooCommerce-produkt-CSV have?
Standardimportværktøjet kræver kun Name. For et brugbart katalog bør du som minimum medtage Type, SKU, Published, Regular price, Categories, Images og Description. Eksportér ét produkt fra din butik for at få de nøjagtige overskriftsnavne, din version forventer.
Hvordan importerer jeg variable produkter med en CSV?
Tilføj én overordnet række med Type »variable«, der angiver alle attributværdier, og derefter én række pr. variant med Type »variation«, det overordnede produkts SKU i kolonnen Parent, en enkelt attributværdi og sin egen SKU og pris.
Kan jeg importere produktbilleder og alt-tekst med CSV-importværktøjet?
Billeder, ja: angiv offentlige billed-URL'er i kolonnen Images, adskilt af kommaer, med det fremhævede billede først. Alt-tekst, nej — standardimportværktøjet kan ikke angive den, så tilføj den bagefter, eller brug REST API'et eller en udvidelse.
Hvor mange produkter kan jeg oprette pr. WooCommerce REST API-forespørgsel?
Batch-endpointet accepterer som standard op til 100 objekter pr. forespørgsel, hvor oprettelser, opdateringer og sletninger tælles sammen. Større kataloger sendes som en række batch-forespørgsler.

Flere guides

Gør leverandør-PDF'er til gennemgåede produktdata

Doc2Shelf udtrækker produktdata fra leverandørdokumenter og udarbejder produktlister og compliance-dokumenter til din gennemgang.

Opret din gratis konto