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

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

Встроенный импорт товаров WooCommerce читает ваш CSV-файл и сопоставляет столбцы по названиям. Каждая строка проверяется по модели данных товара WooCommerce. Если проверка не проходит, WooCommerce пропускает строку и записывает ошибку. После импорта вы видите сводку: сколько строк импортировано, сколько пропущено и почему.

Если WordPress работает на русском, при экспорте используются русские названия столбцов (например, «Тип» вместо Type); импорт распознаёт оба варианта. В этом руководстве указаны английские названия.

Зная правила проверки, можно предотвратить большинство ошибок импорта заранее.

Ошибка: недопустимый или отсутствующий тип товара

Причина: В столбце Type нераспознанное значение, или столбца нет.

Допустимые значения:

| Type | Описание | |---|---| | simple | Простой товар без вариаций | | variable | Товар с вариациями (родительская строка) | | variation | Конкретная вариация вариативного товара (дочерняя строка) | | grouped | Группа связанных товаров | | external | Товар со ссылкой на внешний сайт |

Решение:

• Добавьте столбец Type, если его нет
• Замените собственные или написанные с ошибкой значения на одно из перечисленных
• Variable (с заглавной V) — не то же самое, что variable: используйте строчные буквы

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

Причина: SKU пустой в строке простого или вариативного товара, или один и тот же SKU встречается в двух разных строках.

WooCommerce использует SKU как уникальный идентификатор, чтобы сопоставлять импортируемые строки с существующими товарами. Если SKU пустой, при каждом импорте WooCommerce создаёт новый товар вместо обновления существующего.

Решение:

• Укажите уникальный SKU в каждой строке товара (у простых товаров и родительских строк вариативных)
• Строки вариаций могут наследовать SKU родителя или иметь собственный, но не должны повторять SKU другого товара
• Найти повторяющиеся SKU в Excel поможет СЧЁТЕСЛИ: =СЧЁТЕСЛИ($A:$A; A2) — любое значение больше 1 означает дубликат

Ошибка: недопустимая обычная цена

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

Решение:

• Уберите символы валют: удалите $, €, £ через «Найти и заменить»
• Замените десятичную запятую на точку: 19,99 → 19.99
• Убедитесь, что у каждого простого и вариативного товара есть цена; строки вариаций могут наследовать её от родителя

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

Причина: Логические столбцы WooCommerce (In stock?, Backorders allowed?, Sold individually?, Is featured?) принимают 1 (истина) или 0 (ложь). Значения вроде yes, TRUE или Y вызывают ошибки проверки.

Решение: замените все логические значения:

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

Используйте «Найти и заменить» с включённым параметром «Ячейка целиком».

Ошибка: не найден родительский товар вариации

Причина: Строка с Type: variation ссылается на родительский товар, которого нет ни в файле импорта, ни в базе данных.

Строкам вариаций в WooCommerce нужен родитель. Связь задаётся через столбец Parent (в нём должен быть ID родительского товара из базы данных) или тем, что родительский товар находится в том же файле импорта.

Решение:

• Включите строку родительского товара в тот же CSV-файл
• Укажите в столбце Parent строк вариаций ID родительского товара в WooCommerce (номер в админке WordPress)
• Убедитесь, что в родительской строке Type: variable, а не Type: simple

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

Причина: Названия столбцов атрибутов не соответствуют в точности шаблону именования WooCommerce.

Формат столбцов атрибутов WooCommerce:

• Attribute 1 name — название первого атрибута (например, Color)
• Attribute 1 value(s) — значение или значения для этой строки (например, Blue или Blue | Red, если их несколько)
• Attribute 1 visible — 1, если показывается на странице товара, 0, если скрыт
• Attribute 1 global — 1 для глобального атрибута, 0 для локального

Решение:

• Используйте именно этот формат с пробелами: Attribute 1 name, а не attribute_1_name или Attribute1Name
• Нумеруйте атрибуты по порядку, начиная с 1
• Не оставляйте пропусков (не используйте Attribute 3, если нет Attribute 2)

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

Причина: URL изображения в столбце Images не является общедоступным адресом HTTPS, требует авторизации или использует протокол, отличный от HTTPS.

WooCommerce скачивает изображения во время импорта и сохраняет их в медиатеку.

Решение:

• Откройте каждый URL изображения в браузере — изображение должно открываться сразу, без входа
• Используйте адреса HTTPS (не HTTP)
• Для изображений в Google Диске или Dropbox используйте прямые ссылки на скачивание (не ссылки для общего доступа)
• Если изображения лежат на localhost или тестовом сервере, сначала перенесите их в общедоступное место

Как читать отчёт об ошибках импорта WooCommerce

После импорта WooCommerce показывает сводку:

• «Импортировано товаров: X» — созданы или обновлены успешно
• «Не удалось импортировать: X» — нажмите «Посмотреть журнал импорта», чтобы узнать, какие строки не прошли и почему

В журнале импорта указан номер строки и конкретная ошибка. По номеру найдите строку в своём CSV (помните: строка заголовков — это строка 1, поэтому данные начинаются со строки 2).

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

Загрузите CSV для WooCommerce в StriveFormats. Валидатор проверит типы товаров, SKU, цены, логические значения, столбцы атрибутов и связи между родительскими товарами и вариациями, а безопасные проблемы исправит автоматически.

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