Shopify CSV Документация

Документация за CSV файл – формат Shopify

Важна информация за структурата:
Shopify изисква специфична структура на CSV файла. Продуктите се групират въз основа на колоната Handle. Всеки вариант на размер е отделен ред във файла, но всички варианти на един и същ модел трябва да имат идентичен Handle.

Структура на продуктовите варианти

Всеки ред във файла описва единичен вариант на продукта (конкретен размер) или допълнително изображение.

Основното описание на продукта (Title, Body (HTML)) се намира само в първия ред за дадения модел. Следващите редове (следващите размери) съдържат само специфични данни за варианта (напр. SKU, размер, складова наличност).

Пример за структура на CSV файл

По-долу е примерен фрагмент от CSV файл. Обърнете внимание на повтарящия се идентификатор в колоната Handle.

Handle,Title,Option1 Name,Option1 Value,Variant SKU,Variant Price,Variant Inventory Qty,Image Src
555,"Рокля с яка",Size,S,111-2-S,86.09,15,https://domain.bg/img/foto1.jpg
555,,Size,M,111-2-M,86.09,12,
555,,Size,L,111-2-L,86.09,5,
555,,,,,,,https://domain.bg/img/foto2.jpg

Групиране на варианти (Ключови колони)

Handle – уникален идентификатор на модела (свързва вариантите в един продукт)

Option1 Name – име на характеристиката на варианта (в този файл винаги: "Size")

Option1 Value – стойност на варианта (конкретен размер: XS, S, M, L)

Title – име на продукта (попълнено само в първия ред)

За да може Shopify правилно да групира размерите S, M и L като един продукт, тези редове трябва да имат идентична стойност в колоната Handle.

Идентификатори и Картографиране

За актуализиране на складовите наличности и цените в магазина Shopify, препоръчваме интеграцията да се базира на полетата:

Variant SKU – уникален код на продукта, присвоен на конкретен размер

Handle – постоянен идентификатор на основния продукт

В този файл Handle е цифров идентификатор (напр. 555), което гарантира стабилност на актуализациите, дори ако промените името на продукта във вашия магазин.

Актуализация на данни и URL връзки (SEO)

Във файла използваме постоянни номера ID като идентификатори за URL (Handle). Благодарение на това, дори ако промените имената на продуктите в магазина си, ние ще можем в бъдеще да актуализираме техните складови наличности и цени без грешки.

Промяна на връзки (SEO): Ако искате да промените URL адресите на по-подходящи за SEO (с имена), можете да направите това ръчно в редакцията на продукта (най-долу в секция SEO).

Важно при актуализация:
При следващ импорт за актуализация трябва да изберете опцията 'Overwrite any current products that have the same handle' (Презапиши съществуващите продукти). Така системата ще свърже данните по SKU или ID и ще актуализира наличностите, вместо да създава дубликати.

Цени и Наличност

Variant Price – цена нето/бруто на варианта

Variant Inventory Qty – налично количество на склад

Variant Inventory Policy – складова политика (напр. "deny" - не продавай под 0)

Всеки вариант (размер) притежава собствена складова наличност и цена, дефинирани в съответния ред.

Снимки на продукти

Image Src – URL връзка към снимката

Image Position – ред на показване на снимката

Image Alt Text – алтернативен текст за снимката (SEO)

Внимание: Основната снимка е присвоена в първия ред на продукта. Допълнителните снимки (галерия) се намират в отделни редове в края на групата на продукта, където са попълнени само колоните Handle и Image Src.