Uvoz artikala (CSV)

Ako već negdje vodiš dućan (na WooCommerceu, Shopifyju ili u vlastitoj tablici), cijeli katalog ne moraš prepisivati ručno u WebShopHR. Artikle uvoziš iz CSV datoteke koju izvezeš iz postojeće platforme, jednim uploadom.

Uvoz kroz CMS

U izborniku s lijeve strane otvori Uvoz. Na vrhu ekrana nalaze se upute o podržanim formatima, kolonama koje se čitaju i kvoti. Klikni "Odaberi CSV datoteku", izaberi CSV izvezen iz svoje platforme (do 5 MB), provjeri prikazano ime i veličinu datoteke te zatim klikni "Uvezi".

Ekran Uvoz: upute, podržani formati i odabir CSV datoteke

Nakon uvoza dobiješ rezultat: koliko je artikala uvezeno i koliko je redaka preskočeno (uz nekoliko primjera zašto). Novi artikli pojave se u Artiklima odmah, a u tražilici dućana za nekoliko trenutaka (indeksiranje ide u pozadini).

Rezultat uvoza: broj uvezenih i preskočenih artikala

Formati koje prepoznajemo

Parser sam prepoznaje format po nazivima stupaca u prvom retku CSV-a. Ne moraš ništa posebno označavati. Podržana su tri izvora:

Izvor Kako se prepoznaje Stupci koji se čitaju
WooCommerce header sadrži Name i Regular price Name, Description, Regular price, Stock, SKU, Categories
Shopify header sadrži Handle i Title Title, Body (HTML), Variant Price, Variant Inventory Qty, Handle, Type
WebShopHR (generički) header sadrži name i price_eur name, description, price_eur, stock, slug, category (neobavezan)

Sve ostale stupce iz WooCommerce/Shopify exporta (težina, porezni razred, tagovi, dobavljač…) tiho preskačemo. Uvozimo samo ono što WebShopHR treba za artikl. Ako header ne odgovara nijednom od tri oblika, uvoz staje s porukom da format nije prepoznat i ništa se ne mijenja.

Što se mapira u artikl

Iz svakog retka nastaje jedan artikl s ovim poljima:

Delimiter (zarez ili točka-zarez) prepoznaje se automatski, a UTF-8 BOM koji Excel voli dodati na početak datoteke se ignorira. CSV čitamo kao UTF-8: hrvatski znakovi (č, ć, š, ž, đ) ostaju ispravni.

Varijante kod Shopifyja

Shopify u exportu ponavlja isti Handle za svaku varijantu proizvoda. U ovoj verziji uvoza svaki redak postaje zaseban artikl. Varijante se ne spajaju natrag u jedan proizvod s podvarijantama. Retke koji su samo nastavak varijante (bez Title) preskačemo. Ako želiš prave varijante (veličina/boja pod jednim artiklom), posloži ih nakon uvoza na artiklu (vidi Artikli).

Kategorije u uvozu

Kategorija artikla čita se iz jednog stupca, ovisno o izvoru:

Izvor Stupac
WooCommerce Categories
Shopify Type (ne Product Category)
WebShopHR (generički) category (neobavezan stupac)

Uvoz sam stvara kategorije koje još ne postoje. Razine unutar jedne putanje odvajaš znakom >, na primjer Dom > Kuhinja > Pribor: stvorit će se Dom, pod njom Kuhinja, a pod njom Pribor, i artikl ide u Pribor. Kosa crta (/) nije razdjelnik: Muško/Žensko je jedno ime. Putanja može imati najviše 5 razina, a ako je dulja, višak se odbacuje i artikl ide u zadnju razinu koja je ostala.

Zarez se tumači ovisno o izvoru:

Što još vrijedi:

Odgovor uvoza donosi i broj novostvorenih kategorija (categories_created). Kategorije koje su se samo ponovno iskoristile ne broje se.

Slike se ne uvoze

Uvoz ne donosi slike. Slike WooCommerce/Shopify čuvaju na svojim serverima pa ih ne povlačimo, čime ti katalog ne ovisi o tuđem hostingu slika. Fotografije artikala dodaješ nakon uvoza.

Kvota i sigurnost uvoza

Uvoz preskače retke koji nemaju naziv ili imaju neispravnu cijenu (npr. 0). Takvi retci ne idu u katalog. Na kraju vidiš koliko je redaka uvezeno, a koliko preskočeno, uz nekoliko primjera zašto. Jedan loš redak zato ne ruši ostatak uvoza.

Uvoz je „sve-ili-ništa" samo u dva slučaja:

Ako se slug novog artikla poklopi s postojećim, automatski se dodaje sufiks (-2, -3…) da URL ostane jedinstven. To vrijedi i ako isti CSV uvezeš dvaput: uvoz ne prepoznaje već uvezene artikle nego uvijek stvara nove, pa dobiješ duplikate koje ručno deaktiviraš u Artiklima. Po završetku uvoza dobiješ broj uvezenih i preskočenih artikala (uz nekoliko primjera zašto je redak preskočen), a katalog se osvježi u tražilici dućana automatski.

API za razvojne inženjere

Ekran "Uvoz" u pozadini zove WebShopHR API, koji možeš koristiti i izravno (npr. za skriptirani prijenos):

POST /api/v1/items/import

Datoteku šalješ na dva načina: kao upload datoteke (multipart form polje csv) ili kao sirovo text/csv tijelo zahtjeva. Gornja granica je 5 MB po datoteci (CSV je običan tekst, pa je to i za nekoliko tisuća artikala više nego dovoljno).

Uspješan odgovor (200) je JSON s brojem uvezenih i preskočenih artikala, brojem novostvorenih kategorija te do 10 primjera preskočenih redaka:

{ "imported": 3, "skipped": 0, "categories_created": 2, "errors": [] }

Greške dolaze kao {"error": "..."}: 400 ako datoteka nedostaje, a 422 ako format nije prepoznat, ako nema nijednog valjanog retka ili ako bi uvoz prekoračio kvotu paketa (u tom slučaju se, kao i u CMS-u, ništa ne uvozi).

Povezane stranice