Shopify CSV dokumentācija

CSV faila dokumentācija – Shopify formāts

Svarīga informācija par struktūru:
Shopify pieprasa specifisku CSV faila struktūru. Produkti tiek grupēti, pamatojoties uz kolonnu Handle. Katrs izmēra variants ir atsevišķa rinda failā, bet visiem viena modeļa variantiem jābūt identiskam Handle.

Produktu variantu struktūra

Katra rinda failā apraksta vienu produkta variantu (konkrētu izmēru) vai papildu attēlu.

Galvenais produkta apraksts (Title, Body (HTML)) atrodas tikai pirmajā rindā attiecīgajam modelim. Nākamās rindas (nākamie izmēri) satur tikai variantam specifiskus datus (piem., SKU, izmērs, noliktavas atlikums).

CSV faila struktūras piemērs

Zemāk ir CSV faila fragmenta piemērs. Pievērsiet uzmanību atkārtotajam identifikatoram kolonnā Handle.

Handle,Title,Option1 Name,Option1 Value,Variant SKU,Variant Price,Variant Inventory Qty,Image Src
555,"Kleita ar apkakli",Size,S,111-2-S,86.09,15,https://domena.lv/img/foto1.jpg
555,,Size,M,111-2-M,86.09,12,
555,,Size,L,111-2-L,86.09,5,
555,,,,,,,https://domena.lv/img/foto2.jpg

Variantu grupēšana (Galvenās kolonnas)

Handle – unikāls modeļa identifikators (apvieno variantus vienā produktā)

Option1 Name – varianta īpašības nosaukums (šajā failā vienmēr: "Size")

Option1 Value – varianta vērtība (konkrēts izmērs: XS, S, M, L)

Title – produkta nosaukums (aizpildīts tikai pirmajā rindā)

Lai Shopify pareizi sagrupētu izmērus S, M un L kā vienu produktu, šīm rindām jābūt identiskai vērtībai kolonnā Handle.

Identifikatori un kartēšana

Lai atjauninātu noliktavas atlikumus un cenas Shopify veikalā, iesakām integrāciju balstīt uz šiem laukiem:

Variant SKU – unikāls produkta kods, kas piešķirts konkrētam izmēram

Handle – pastāvīgs galvenā produkta identifikators

Šajā failā Handle ir ciparu identifikators (piem., 555), kas nodrošina atjauninājumu stabilitāti, pat ja mainīsiet produkta nosaukumu savā veikalā.

Datu atjaunināšana un URL saites (SEO)

Failā kā URL identifikatorus (Handle) izmantojam pastāvīgus produktu ID numurus. Pateicoties tam, pat ja mainīsiet produktu nosaukumus savā veikalā, mēs nākotnē varēsim bez kļūdām atjaunināt to noliktavas atlikumus un cenas.

Saišu maiņa (SEO): Ja vēlaties mainīt URL adreses uz SEO draudzīgām (ar nosaukumiem), varat to darīt manuāli produkta rediģēšanas lapā (lapas apakšā, SEO sadaļā).

Svarīgi atjauninot:
Nākamajā atjaunināšanas importā jums jāatzīmē opcija 'Overwrite any current products that have the same handle' (Pārrakstīt esošos produktus). Tādējādi sistēma sasaistīs datus pēc SKU vai ID un atjauninās atlikumus, nevis veidos produktu dublikātus.

Cenas un pieejamība

Variant Price – varianta neto/bruto cena

Variant Inventory Qty – pieejamais daudzums noliktavā

Variant Inventory Policy – noliktavas politika (piem., "deny" - nepārdot zem 0)

Katram variantam (izmēram) ir savs noliktavas atlikums un cena, kas definēta attiecīgajā rindā.

Produktu attēli

Image Src – URL saite uz attēlu

Image Position – attēla attēlošanas secība

Image Alt Text – alternatīvais teksts attēlam (SEO)

Uzmanību: Galvenais attēls ir piešķirts pirmajā produkta rindā. Papildu attēli (galerija) atrodas atsevišķās rindās produkta grupas beigās, kur aizpildītas tikai Handle un Image Src kolonnas.