Kako uvesti katalog iz WooCommercea ili Shopifyja?
Trgovci koji već imaju shop na WooCommerceu ili Shopifyju ne žele gubiti dane na ručno prepisivanje artikala. WebShopHR omogućuje uvoz cijelog kataloga jednim CSV-om, bez mapiranja stupaca i bez brige o hrvatskim znakovima koje Excel inače pokvari.
Prepoznaje tri formata po zaglavlju
Uvoznik sam prepoznaje izvor datoteke po imenima stupaca u zaglavlju. Ako pronađe Name i Regular price, radi se o WooCommerceu. Ako pronađe Handle i Title, radi se o Shopifyju. Ako pronađe name i price_eur, radi se o generičkom WebShopHR formatu. Trgovac ne mora ništa mapirati. Dovoljno je uploadati datoteku onakvu kakvu je dobio iz postojeće platforme.
Podržani načini slanja i veličina
CSV se može poslati kao multipart datoteka u polju csv ili kao sirovo text/csv tijelo zahtjeva. Oba načina imaju istu gornju granicu od 5 MiB, što je dovoljno za nekoliko tisuća artikala. Ako datoteka premaši veličinu, sustav odbija prijenos prije bilo kakve obrade.
Briše BOM i otkriva delimiter
Excel exporti često na početak CSV-a dodaju UTF-8 BOM i koriste točka-zarez kao delimiter umjesto zareza. Uvoznik automatski uklanja BOM, a zatim pregleda prvi redak i otkriva radi li se o zarezu ili točka-zarezu, pri čemu zanemaruje navodnike. Rezultat je da hrvatski znakovi č, ć, š, ž i đ ostaju ispravni bez obzira kako je datoteka nastala.
Čita hrvatske i engleske cijene
Cijene se mogu zapisati u hrvatskom obliku 1.234,56 € ili u engleskom obliku 1234.56. Uvoznik prepoznaje točku kao tisućicu kad postoji zarez, a kao decimalni separator kad nema zareza. Rezultat se zaokružuje na cijele cente, a negativne cijene se odbacuju. Redovi bez naziva ili s neispravnom cijenom se preskaču, a API vraća koliko je redaka uvezeno, koliko preskočeno i do deset primjera zbog čega su preskočeni.
Čisti Shopify HTML opis
Shopify izvozi opis proizvoda s HTML oznakama. Uvoznik ih uklanja, dekodira HTML entitete poput & i normalizira razmake, tako da opis u WebShopHR katalogu bude čist tekst. Time se izbjegava da se HTML oznake pojave u kratkom opisu artikla ili u tražilici.
Tolerantan parser za nepravilne exporte
Vanjski exporti znaju biti nepravilni: neki redci imaju više polja, drugi manje, a navodnici su ponekad pogrešno postavljeni. Uvoznik koristi tolerantne postavke koje dopuštaju varijabilan broj polja po retku i nepropisno quotane vrijednosti. To znači da će veliki broj „prljavih“ CSV-ova uspješno proći bez ručnog čišćenja.
URL slug iz naziva, SKU-a ili handlea
Za svaki redak se gradi URL slug. Ako postoji SKU, služit će kao izvor, inače se koristi naziv ili Shopify handle. Hrvatska dijakritika se prebacuje u osnovna slova, a razmaci i posebni znakovi u crtice. Ako unutar istog uploada postoje istoimeni slugovi, sustav ih rješava dodavanjem -2, -3 i tako dalje. Pri tome gleda i postojeće slugove u istoj kategoriji, pa se neće dogoditi kolizija ni s već objavljenim artiklima.
Atomski „sve ili ništa“ uz kvotu paketa
Cijeli uvoz odvija se unutar jedne transakcije. Prije nego što se bilo koji artikl upiše, sustav provjeri bi li novi artikli premašili kvotu paketa. Ako bi premašili, cijeli uvoz se poništava i trgovac dobiva poruku koliko još artikala stane u trenutni paket.
Ako je sve u redu, upisuju se svi valjani artikli u kategoriju Ostalo, a nakon uspješnog uvoza se automatski pokreće pretraživanje kataloga da bi novi artikli odmah bili vidljivi u tražilici.
Što uvoz ne prenosi
CSV import nosi samo osnovne podatke o artiklu: naziv, opis, cijenu i zalihu. Kategorije iz WooCommercea ili Shopifyja se ne prenose. Svi uvezeni artikli slijeću u zajedničku kategoriju Ostalo, odakle ih trgovac sam premješta u prave kategorije. Slike i varijante artikala uvoz ne prenosi, kao ni narudžbe i kupce iz izvorne platforme. Uvoz radi isključivo s katalogom artikala.
Ponovni uvoz istog CSV-a ne prepoznaje već uvezene artikle. Svako pokretanje stvara nove zapise, pa isti CSV pušten dvaput ostavlja katalog s duplikatima, ne s osvježenim postojećim artiklima.
Jasno izvješće bez pola uvezenog kataloga
Nakon uvoza API vraća tri broja: broj uvezenih artikala, broj preskočenih redaka i popis razloga. Neispravni se redovi ne preskaču tiho. Trgovac vidi zbog čega određeni red nije ušao. Budući da je uvoz atomski, ništa se ne završi s pola kataloga: ili je cijeli batch uvezen, ili ništa.
Zaključak
Uvoz kataloga iz WooCommercea ili Shopifyja stoga trgovcu štedi vrijeme: prepoznaje format sam, čisti hrvatske znakove i HTML, rješava kolizije slugova i poštuje kvotu paketa bez da ostavi dućan u pola prebačenog stanja.
Više o temi: Katalog i zalihe.
Česta pitanja.
Moram li ručno mapirati stupce iz WooCommercea ili Shopifyja?
Ne. Uvoznik sam prepoznaje izvor po imenima stupaca u zaglavlju CSV-a. Dovoljno je uploadati datoteku onakvu kakva je izvezena iz postojeće platforme.
Hoće li mi se hrvatska slova pokvariti nakon uvoza?
Ne. Uvoznik uklanja Excelov UTF-8 BOM, sam otkriva delimiter i čita hrvatske
cijene poput 1.234,56 € jednako dobro kao engleske 1234.56.
Što ako CSV premašuje broj artikala dopušten mojim paketom?
Ništa se ne uveze. Prije bilo kakvog upisa provjerava se kvota paketa, pa ako je CSV prevelik, cijeli uvoz se poništava i dobiješ poruku koliko još artikala stane.
Hoće li se pola kataloga uvesti ako neki redak ima grešku?
Ne. Redovi bez naziva ili s neispravnom cijenom se preskaču, ali sam uvoz je atomski: ili je cijeli valjani batch uvezen, ili ništa, uz do 10 konkretnih primjera zašto su redovi preskočeni.
Rade li novi artikli odmah u internoj tražilici?
Da. Nakon uspješnog uvoza katalog se automatski reindeksira za pretraživanje, bez dodatnog koraka.
Prenosi li uvoz i kategorije, slike, varijante, narudžbe ili kupce?
Ne. Uvoz prenosi samo naziv, opis, cijenu i zalihu artikla. Kategorije se ne
prenose (sve slijeće u Ostalo), a slike, varijante, narudžbe i kupci se
uopće ne dotiču ovim putem.
Ažurira li ponovni uvoz istog CSV-a već uvezene artikle?
Ne. Uvoznik ne prepoznaje već uvezene artikle, pa svako pokretanje stvara nove zapise. Isti CSV pušten dvaput ostavlja katalog s duplikatima, ne s osvježenim postojećim artiklima.