Ошибки импорта CSV в Shopify: частые причины и решения

Как Shopify проверяет импорт CSV

Когда вы импортируете CSV с товарами, Shopify пропускает каждую строку через несколько этапов проверки:

1. Проверка заголовков — есть ли обязательные столбцы
2. Группировка по handle — строки с одинаковым Handle объединяются в один товар
3. Проверка полей — типы данных, обязательные и допустимые значения
4. Поиск конфликтов — конфликты handle и SKU с уже существующими товарами

Ошибка на любом этапе приводит к отклонению строк. Shopify часто импортирует корректные строки и пропускает ошибочные, поэтому, если не исправить все ошибки заранее, импорт может оказаться неполным.

Ошибка: нет обязательного столбца

Сообщение: «Your CSV file is missing the following columns: Handle, Title...»

Причина: Одного или нескольких обязательных столбцов нет в строке заголовков, они написаны с ошибкой или в неверном регистре.

Обязательные столбцы Shopify:

| Столбец | Примечание | |---|---| | Handle | Короткое имя для URL; группирует варианты | | Title | Название товара | | Variant Price | Цена для каждой строки варианта |

Решение:

• Сравните строку заголовков с официальным шаблоном CSV товаров Shopify
• Проверьте регистр: Handle, а не handle; Variant Price, а не Variant price
• Поищите пробелы в начале или в конце имён столбцов (откройте файл в текстовом редакторе, а не в Excel)
• Если первый столбец выглядит как Handle (с BOM в начале), пересохраните файл в UTF-8 без BOM

Ошибка: недопустимое логическое значение

Сообщение: Строки импортируются, но в Published, Gift Card или Requires Shipping оказывается неверное значение

Причина: Логические столбцы Shopify ожидают TRUE или FALSE (заглавными). Значения вроде Yes, yes, 1, true или True принимаются не во всех полях.

Затронутые столбцы: Published, Gift Card, Requires Shipping, Taxable

Решение: замените все варианты через «Найти и заменить»:

| Заменить это | На это | |---|---| | Yes, yes, Y, true, 1 | TRUE | | No, no, N, false, 0 | FALSE |

В Excel: Ctrl+H («Найти и заменить») и отметьте «Ячейка целиком», чтобы не заменить текст внутри более длинных значений.

Ошибка: пустая или неверная цена варианта

Сообщение: «Variant Price can't be blank» или цена импортируется как 0.00

Причина: Variant Price пустой, содержит символ валюты ($19.99), использует запятую как десятичный разделитель (19,99) или является текстом.

Решение:

• Заполните Variant Price в каждой строке (и в родительских строках, и в строках вариантов)
• Уберите символы валют: удалите $ через «Найти и заменить»
• Замените десятичную запятую на точку: 19,99 → 19.99
• Перед сохранением задайте столбцу в Excel числовой формат (чтобы символы не вернулись)

Ошибка: структура вариантов / нет столбцов опций

Сообщение: Товары импортируются без вариантов, или варианты появляются как отдельные товары

Причина: Handle используется правильно (одинаковое значение во всех строках товара), но столбцы опций заполнены неверно:

• Option1 Name или Option1 Value отсутствует или пуст в некоторых строках
• Имена столбцов опций различаются в строках одной группы
• В строках, которые должны быть одним товаром, разный handle

Правила для строк вариантов:

• Все строки одного товара должны иметь в точности одинаковый Handle
• В каждой строке должны быть Option1 Name и Option1 Value
• Если опций 3, во всех строках должны быть столбцы Option1, Option2 и Option3
• Option1 Name (например, Size) должен совпадать во всех строках группы; меняется только Option1 Value

Пример правильной структуры вариантов:

Handle,Title,Option1 Name,Option1 Value,Variant Price
blue-shirt,Blue T-Shirt,Size,Small,19.99
blue-shirt,,Size,Medium,21.99
blue-shirt,,Size,Large,21.99

Ошибка: повторяющийся handle

Сообщение: Товары перезаписывают друг друга или ломается группировка вариантов

Причина: Два несвязанных товара имеют одинаковый Handle. Shopify объединяет все строки с одинаковым Handle в один товар, поэтому повторяющийся Handle сливает разные товары.

Решение: Сделайте Handle каждого товара уникальным. Handle должен подходить для URL: только строчные латинские буквы, цифры и дефисы, без пробелов и специальных символов.

Если вы обновляете существующий товар и такой Handle уже есть в Shopify, это ожидаемо: импорт обновит этот товар. Но если новый товар случайно получил Handle существующего, данные существующего товара будут перезаписаны.

Ошибка: конфликты SKU

Сообщение: Товары импортируются, но остатки неверные или SKU помечаются как повторяющиеся

Причина: Один и тот же SKU встречается в двух разных строках (или у двух разных товаров). Shopify использует SKU для учёта остатков, и повторяющиеся SKU приводят к неправильному объединению остатков.

Решение: Убедитесь, что у каждой строки варианта уникальный SKU. Если вы не ведёте учёт остатков по SKU, его можно оставить пустым, но он не должен повторяться в разных строках.

Ошибка: изображение не импортируется

Сообщение: Товары импортируются, но изображений нет

Причина:

• URL в Image Src не является общедоступным адресом HTTPS
• В URL есть пробелы или специальные символы, которые нужно закодировать
• Формат изображения не поддерживается (Shopify принимает JPG, JPEG, PNG, GIF и WEBP)

Решение: Откройте каждый URL изображения в браузере — изображение должно открыться напрямую. Изображения из Google Drive, Dropbox или localhost нужно перед импортом перенести на общедоступный хостинг.

Исправьте автоматически в StriveFormats

Загрузите CSV для Shopify в StriveFormats. Валидатор проверит все обязательные столбцы, форматы логических значений, структуру вариантов, поля цен и уникальность handle — и одним щелчком исправит безопасные проблемы.

Открыть исправитель CSV для Shopify | Посмотреть шаблон Shopify