«Неверное значение атрибута» на Ozon: что это значит и как устранить ошибку

• 🚫 В name (название товара) нельзя использовать слова "оригинал", "реплика", "аналог" без подтверждающих документов.
• 🔞 Для товаров is_adult=true (18+) требуется специальная категория и подтверждение возраста.
• 💊 Для лекарств и БАДов обязательны сертификаты и лицензии, указанные в атрибуте certificates.

Если ваш товар попадает под одно из этих ограничений, но атрибуты заполнены неверно, карточка будет отклонена с ошибкой "Неверное значение атрибута" — даже если технически формат данных корректен.

Как найти и исправить ошибку: пошаговая инструкция

Когда вы видите сообщение об ошибке, первое, что нужно сделать — точно определить, какой атрибут вызвал проблему. Для этого:

1. Перейдите в Личный кабинет → Каталог → Ошибки загрузки.
2. Найдите строку с вашим товаром и нажмите Подробнее.
3. В открывшемся окне будет указан конкретный атрибут (например, weight) и причина ошибки (например, "Значение должно быть не менее 0.1").

Если ошибка возникла при массовой загрузке через Excel или API, проверьте лог загрузки — там тоже будет указан проблемный параметр.

Исправление вручную (через Личный кабинет)

Если товаров мало, проще всего править ошибки в интерфейсе:

1. Откройте карточку товара с ошибкой.
2. Найдите поле, указанное в сообщении об ошибке (например, weight).
3. Исправьте значение согласно требованиям:
   • Если ошибка в формате — приведите данные к нужному виду (например, удалите буквы из числового поля).
   • Если ошибка в диапазоне — укажите значение в допустимых пределах.
   • Если ошибка в справочнике — выберите значение из выпадающего списка.

Пример: если ошибка в price из-за символа валюты, просто удалите "руб." и оставьте чистое число.

Массовое исправление (через Excel или API)

Для большого количества товаров ручная правка неэффективна. В этом случае:

1. Экспортируйте список товаров с ошибками в Excel через Каталог → Экспорт.
2. Отфильтруйте строки по столбцу с ошибкой (например, по слову "INVALID_ATTRIBUTE_VALUE").
3. Исправьте значения в проблемных ячейках, следуя правилам из документации Ozon.
4. Импортируйте исправленный файл обратно через Каталог → Импорт.

Для API используйте метод POST /v2/product/import с исправленными данными в теле запроса. Пример корректного JSON:

{
"items": [
{
"offer_id":"12345",
"price":"1999.00", // Исправлено: убраны символы валюты
"weight":"0.5", // Исправлено: вес ≥ 0.1 кг
"color":"черный" // Исправлено: цвет из справочника
}
]
}

Проверка через валидатор Ozon

Перед загрузкой товаров всегда проверяйте их через валидатор Ozon. Этот инструмент:

• 🔍 Показывает все ошибки атрибутов до загрузки.
• 📋 Подсвечивает проблемные поля и предлагает исправления.
• ⚡ Работает с файлами Excel, CSV и JSON.

Как пользоваться:

1. Загрузите файл с товарами в валидатор.
2. Дождитесь анализа (обычно 1–2 минуты).
3. Исправьте отмеченные ошибки.
4. Скачайте исправленный файл и загрузите его в Ozon.

Частые ошибки и как их избежать

Некоторые атрибуты вызывают ошибки особенно часто. Разберём топ-5 проблемных полей и способы их исправления.

1. Ошибки в цене (price)

Типичные проблемы:

• 💰 Указана валюта (1000 руб. → должно быть 1000).
• 💰 Слишком много знаков после запятой (999.999 → должно быть 1000.00 или 999.99).
• 💰 Цена ниже минимальной для категории (например, для электроники минимум — 500 руб.).

Как исправить:

• Используйте формат XXXX.XX (например, 1299.99).
• Проверьте минимальную цену для вашей категории в правилах Ozon.
• Для акционных товаров укажите скидку в отдельном атрибуте old_price.

2. Ошибки в весе (weight) и габаритах (depth/width/height)

Частые ошибки:

• ⚖️ Вес меньше 0.1 кг (например, 0.05 для мелких аксессуаров).
• 📏 Габариты указаны в неправильном порядке (например, высота,ширина,длина вместо длина,ширина,высота).
• 📏 Единицы измерения в поле (30 см → должно быть 30).

Как исправить:

• Для веса менее 100 г укажите 0.1.
• Габариты указывайте в сантиметрах в формате Д×Ш×В (например, 20,15,10).
• Используйте калькулятор габаритов Ozon, чтобы избежать ошибок.

3. Ошибки в штрихкоде (barcode)

Штрихкод должен соответствовать стандартам EAN-13, UPC или ISBN. Типичные ошибки:

• 🔖 Неверная длина (должно быть 8, 12 или 13 цифр).
• 🔖 Пробелы или другие символы (460 7001234567 → должно быть 4607001234567).
• 🔖 Некорректная контрольная цифра (последняя цифра штрихкода рассчитывается по алгоритму).

Как исправить:

• Проверьте штрихкод через онлайн-валидатор.
• Если штрихкода нет, запросите его у производителя или сгенерируйте свой в системе GS1.
• Для книг используйте ISBN (10 или 13 цифр).

4. Ошибки в категории (category_id)

Неправильная категория — одна из самых коварных ошибок, потому что она может блокировать товар даже если все остальные атрибуты верны. Проблемы:

• 🛒 Категория слишком общая (например, "Электроника" вместо "Наушники беспроводные").
• 🛒 Категория не соответствует товару (например, "Игрушки" для бытовой химии).
• 🛒 Указана категория из другого региона (например, категория для Ozon Турция вместо Ozon Россия).

Как исправить:

• Используйте дерево категорий Ozon для поиска точного category_id.
• Если не уверены, выберите категорию через интерфейс добавления товара — система подскажет правильный ID.
• Для кросс-категорийных товаров (например, смарт-часы, которые могут быть и в "Электронике", и в "Аксессуарах") выбирайте ту, которая точнее описывает основное назначение.

5. Ошибки в атрибутах для одежды и обуви

Для этих категорий Ozon предъявляет особо строгие требования. Частые ошибки:

• 👗 Неверный формат размерной сетки (например, S,M,L вместо ["S","M","L"] в JSON).
• 👗 Отсутствует таблица размеров (обязательна для одежды и обуви).
• 👗 Не указан материал (composition) или страна производства (country_of_origin).

Как исправить:

• Для размеров используйте стандартные обозначения из справочника Ozon.
• Укажите состав материала в формате "Хлопок 100%" или "Полиэстер 80%, Эластан 20%".
• Для обуви обязательно укажите shoe_size_system (например, "Русский", "Европейский").

Автоматизация проверки атрибутов

Если вы работаете с большим каталогом (сотни или тысячи товаров), ручная проверка каждого атрибута отнимет слишком много времени. В этом случае поможет автоматизация:

1. Инструменты Ozon для валидации

Ozon предоставляет несколько бесплатных инструментов:

• 🔍 Валидатор файлов — проверяет Excel/CSV перед загрузкой.
• 🤖 API-методы:
  • POST /v1/product/import/validate — проверка без загрузки.
  • GET /v1/product/info — получение текущих атрибутов товара.
• 📊 Отчёты об ошибках — в Личном кабинете можно скачать список товаров с проблемами.

Пример использования API для валидации:

curl -X POST'https://api-seller.ozon.ru/v1/product/import/validate' \
-H'Content-Type: application/json' \
-H'Client-Id: {ваш_client_id}' \
-H'Api-Key: {ваш_api_key}' \
-d'{
"items": [
{
"offer_id":"your_offer_1",
"price":"1999.00",
"weight":"0.5"
}
]
}'

2. Сторонние сервисы для работы с атрибутами

Если стандартных инструментов Ozon недостаточно, можно использовать сторонние решения:

Эти сервисы не только проверяют атрибуты, но и помогают:

• 🔄 Автоматически исправлять типичные ошибки (например, убирать символы валюты из цены).
• 📈 Отслеживать изменения требований Ozon и обновлять данные.
• 📊 Анализировать, какие атрибуты чаще всего вызывают ошибки в вашем каталоге.

3. Самостоятельные скрипты для проверки

Если вы разбираетесь в программировании, можно написать свой скрипт для валидации. Пример на Python:

import json

def validate_attributes(product_data):
errors = 
# Проверка цены
if not isinstance(product_data.get('price'), (int, float)) or product_data['price'] <= 0:
errors.append("Неверная цена. Должно быть число > 0.")

# Проверка веса
if'weight' in product_data:
if not isinstance(product_data['weight'], (int, float)) or product_data['weight'] < 0.1:
errors.append("Неверный вес. Должно быть число ≥ 0.1 кг.")

# Проверка штрихкода
if'barcode' in product_data:
barcode = str(product_data['barcode'])
if len(barcode) not in [8, 12, 13] or not barcode.isdigit:
errors.append("Неверный штрихкод. Должно быть 8, 12 или 13 цифр.")

return errors

Пример использования
product = {
"price":"1000 руб.", # ❌ Ошибка
"weight": 0.05, # ❌ Ошибка
"barcode":"460700123456" # ✅ Корректно
}

print(validate_attributes(product)) # Выведет список ошибок

Такой скрипт можно интегрировать в вашу систему управления товарами или запускать перед загрузкой на Ozon.

Что делать, если ошибка остаётся после исправлений

Бывает, что вы вроде бы