Shopify CSV dokumentacij

CSV failo dokumentacija – „Shopify“ formatas

Svarbi informacija apie struktūrą:
„Shopify“ reikalauja specifinės CSV failo struktūros. Produktai grupuojami pagal stulpelį Handle. Kiekvienas dydžio variantas yra atskira failo eilutė, tačiau visi to paties modelio variantai privalo turėti identišką Handle.

Produktų variantų struktūra

Kiekviena failo eilutė aprašo vieną produkto variantą (konkretų dydį) arba papildomą nuotrauką.

Pagrindinis produkto aprašymas (Title, Body (HTML)) yra tik pirmoje konkretaus modelio eilutėje. Sekančiose eilutėse (kituose dydžiuose) yra tik variantui specifiniai duomenys (pvz., SKU, dydis, sandėlio likutis).

CSV failo struktūros pavyzdys

Žemiau pateikiamas pavyzdinis CSV failo fragmentas. Atkreipkite dėmesį į pasikartojantį identifikatorių stulpelyje Handle.

Handle,Title,Option1 Name,Option1 Value,Variant SKU,Variant Price,Variant Inventory Qty,Image Src
555,"Suknelė su apykakle",Size,S,111-2-S,86.09,15,https://domena.lt/img/foto1.jpg
555,,Size,M,111-2-M,86.09,12,
555,,Size,L,111-2-L,86.09,5,
555,,,,,,,https://domena.lt/img/foto2.jpg

Variantų grupavimas (Pagrindiniai stulpeliai)

Handle – unikalus modelio identifikatorius (sujungia variantus į vieną produktą)

Option1 Name – varianto savybės pavadinimas (šiame faile visada: "Size")

Option1 Value – varianto reikšmė (konkretus dydis: XS, S, M, L)

Title – produkto pavadinimas (užpildytas tik pirmoje eilutėje)

Kad „Shopify“ teisingai sugrupuotų S, M ir L dydžius kaip vieną produktą, šios eilutės privalo turėti identišką reikšmę stulpelyje Handle.

Identifikatoriai ir susiejimas

Norint atnaujinti sandėlio likučius ir kainas „Shopify“ parduotuvėje, rekomenduojame integraciją grįsti šiais laukais:

Variant SKU – unikalus produkto kodas, priskirtas konkrečiam dydžiui

Handle – pastovus pagrindinio produkto identifikatorius

Šiame faile Handle yra skaitmeninis identifikatorius (pvz., 555), kas užtikrina atnaujinimų stabilumą, net jei pakeisite produkto pavadinimą savo parduotuvėje.

Duomenų atnaujinimas ir URL nuorodos (SEO)

Faile kaip URL identifikatorius (Handle) naudojame pastovius produktų ID numerius. Dėl to, net jei pakeisite produktų pavadinimus savo parduotuvėje, mes ateityje galėsime be klaidų atnaujinti jų sandėlio likučius ir kainas.

Nuorodų keitimas (SEO): Jei norite pakeisti URL adresus į draugiškus SEO (su pavadinimais), galite tai padaryti rankiniu būdu produkto redagavimo lange (puslapio apačioje, SEO skiltyje).

Svarbu atnaujinant:
Kito atnaujinimo importo metu privalote pažymėti parinktį 'Overwrite any current products that have the same handle' (Perrašyti esamus produktus). Dėl to sistema susies duomenis pagal SKU arba ID ir atnaujins likučius, užuot kūrusi produktų dublikatus.

Kainos ir prieinamumas

Variant Price – varianto kaina neto/bruto

Variant Inventory Qty – kiekis sandėlyje

Variant Inventory Policy – sandėlio politika (pvz., "deny" - neparduoti esant 0)

Kiekvienas variantas (dydis) turi nuosavą sandėlio likutį ir kainą, apibrėžtą atitinkamoje eilutėje.

Produktų nuotraukos

Image Src – nuoroda (URL) į nuotrauką

Image Position – nuotraukos rodymo tvarka

Image Alt Text – alternatyvus tekstas nuotraukai (SEO)

Dėmesio: Pagrindinė nuotrauka priskirta pirmoje produkto eilutėje. Papildomos nuotraukos (galerija) yra atskirose eilutėse produkto grupės pabaigoje, kur užpildyti tik Handle ir Image Src stulpeliai.