Сколько знаков в коде Ozon: лимиты артикулов и баркодов

Работа с карточками товаров на маркетплейсах требует строгого соблюдения технических регламентов, и Ozon не является исключением. Код товара — это фундаментальный идентификатор, без которого система не сможет корректно отобразить продукт, а склад не примет его на хранение. Часто селлеры сталкиваются с загадочными ошибками при массовой загрузке через Excel или API, когда система отвергает seemingly нормальные данные. Причиной таких сбоев в 90% случаев становится неверное количество символов в полях артикула или штрихкода.

Понимание того, сколько знаков в коде Ozon может быть использовано, критически важно для автоматизации процессов. Если вы планируете использовать собственную систему учета (ERP) или генерировать этикетки программно, вам необходимо знать предельные значения полей. Ошибка даже на один символ может привести к тому, что партия товара застрянет на приемке, а покупатель не сможет найти ваш продукт. В этой статье мы детально разберем структуру идентификаторов, лимиты полей и нюансы, о которых часто молчат в официальных справках.

Стоит отметить, что правила маркировки и требования к длине кодов периодически обновляются. Артикул продавца и баркод Ozon — это разные сущности, имеющие разные технические ограничения. Путаница между ними — распространенная ошибка новичков. Далее мы рассмотрим каждый тип кода отдельно, чтобы у вас сложилась полная картина требований площадки.

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

Артикул продавца (Seller SKU) — это ваш внутренний идентификатор товара. Именно по нему вы ищете позиции в личном кабинете, формируете отчеты и ведете учет на своем складе. Ozon позволяет задавать артикул самостоятельно, но накладывает жесткие ограничения на его формат. Максимальная длина поля составляет 50 символов. Этого вполне достаточно для создания логичной структуры, включающей название бренда, модель и размер.

Однако длина — не единственный параметр, который нужно учитывать. Система Ozon чувствительна к регистру букв и спецсимволам. Артикулы "T-shirt-Red" и "t-shirt-red" будут восприняты как два разных товара, что может привести к дублированию карточек. Кроме того, использование кириллицы в артикуле возможно, но не рекомендуется, если вы планируете интеграцию с зарубежными сервисами или аналитикой.

⚠️ Внимание: Изменение артикула после создания карточки невозможно без удаления товара. Если вы ошиблись в количестве знаков или допустили опечатку, придется создавать новую карточку, что приведет к потере накопленных отзывов и рейтинга.

При формировании артикула старайтесь избегать пробелов, заменяя их на нижнее подчеркивание или дефис. Это упростит работу с файлами выгрузки и снизит риск ошибок при ручном вводе. Также помните, что уникальность артикула должна соблюдаться в рамках всего вашего магазина. Два разных товара не могут иметь одинаковый код, даже если они отличаются только цветом.

Требования к баркодам и штрихкодам

Баркод (штрихкод) — это графическое представление цифрового кода, необходимое для автоматической идентификации товара на складе Ozon. В отличие от артикула, который придумываете вы, баркод должен соответствовать международным стандартам. Чаще всего используются форматы EAN-13, EAN-8, Code-128 или UPC. Длина цифрового значения в этих стандартах строго регламентирована и составляет от 8 до 13 знаков для EAN/UPC и до 48 символов для Code-128.

Если у товара нет заводского штрихкода, Ozon генерирует собственный баркод маркетплейса. Его длина также фиксирована и зависит от алгоритмов генерации системы. При печати этикеток важно соблюдать требования к размеру и читаемости. Нечитаемый штрихкод — одна из главных причин отказа в приемке товара. Сканеры на сортировочных центрах работают с высокой скоростью, и любой дефект печати приводит к браку.

Рассмотрим основные типы штрихкодов, поддерживаемых платформой:

• 🏷️ EAN-13: Самый распространенный стандарт, состоит из 13 цифр. Обязателен для большинства товаров народного потребления.
• 🏷️ Code-128: Используется для логистических нужд, может содержать буквы и цифры, длина варьируется.
• 🏷️ UPC: Американский стандарт, аналог EAN, состоит из 12 цифр. Часто встречается на импортных товарах.

При загрузке товаров через API или Excel убедитесь, что поле barcode содержит только допустимые символы. Лишние пробелы в начале или конце строки — частая техническая ошибка, которая приводит к невалидации данных. Проверку можно выполнить с помощью простых функций в Excel, удаляющих лишние символы.

Лимиты полей при массовой загрузке

Работа с большими объемами данных требует понимания ограничений не только отдельных полей, но и всей структуры файла выгрузки. Когда вы загружаете тысячу товаров, суммарный объем данных и длина строк в CSV или XML файле могут влиять на скорость обработки. Хотя прямое ограничение на количество знаков в файле редко становится bottleneck, оптимизация длины текстовых полей (описаний, названий) косвенно влияет на работу с кодами.

Например, если вы генерируете QR-коды для внутренней маркировки на основе артикула и названия, длина строки будет напрямую влиять на плотность кода. Слишком длинный артикул сделает QR-код мелким и трудным для считывания камерой смартфона или терминалом. Рекомендуется придерживаться разумных пределов, даже если технический лимит позволяет больше.

Ниже приведена таблица с основными ограничениями полей, связанными с идентификацией товара:

Обратите внимание, что для некоторых категорий товаров существуют специфические требования. Например, для продуктов питания или косметики могут требоваться дополнительные коды маркировки (Честный ЗНАК), длина и формат которых регламентируются государством, а не только правилами Ozon.

Генерация кодов через API Ozon

Для крупных селлеров и тех, кто использует автоматизацию, актуален вопрос работы с кодами через API. При отправке запроса на создание или обновление товара (POST /v3/product/import), валидация полей происходит на стороне сервера. Если длина артикула превышает лимит, вы получите ошибку с кодом 400 Bad Request и сообщением о несоответствии формата.

Важно правильно форматировать запрос. Поле offer_id (ваш артикул) передается строкой. Даже если ваш артикул состоит только из цифр, в JSON он должен быть заключен в кавычки. Пример корректного фрагмента кода:

{
"products": [
{
"offer_id": "TECH-PHONE-001",
"name": "Смартфон SuperPhone X",
"barcode": "4601234567890",
"price": 15000
}
]
}

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

⚠️ Внимание: При работе через API частые ошибки валидации (например, постоянная отправка слишком длинных артикулов) могут привести к временной блокировке вашего API-ключа за спам запросами.

Проблемы с кодировкой и спецсимволами

Еще один аспект, который часто игнорируют — кодировка символов. Хотя артикулы рекомендуется делать на латинице, названия товаров и описания содержат кириллицу. При выгрузке прайс-листов в формате CSV или XML важно использовать кодировку UTF-8. Неправильная кодировка может "съесть" часть символов в конце строки или заменить их на кракозябры, что формально изменит длину кода и сделает его невалидным.

Особое внимание стоит уделить спецсимволам, таким как амперсанд (&), кавычки (" ") и знаки валют. В HTML-разметке карточки они должны быть экранированы, но в поле артикула их лучше избегать полностью. Системные ограничения могут трактовать эти символы как управляющие команды, что приведет к обрезке строки.

Как избежать проблем с кодировкой?

Всегда сохраняйте CSV файлы в кодировке UTF-8 с BOM (Byte Order Mark). Это гарантирует, что Excel и другие программы корректно распознают русские буквы и не поломают структуру файла.

Если вы используете сложные формулы в Excel для генерации артикулов, проверьте результат на наличие скрытых символов. Функция ДЛСТР (LEN) поможет убедиться, что реальная длина строки соответствует ожидаемой. Иногда визуально короткий артикул может содержать невидимые символы перевода строки или табуляции.

Частые ошибки и способы их решения

Анализ обращений в поддержку показывает, что большинство проблем с кодами связано с человеческим фактором. Селлеры копируют данные из 1С или других систем, где форматирование отличается от требований Ozon. Например, в учетной системе артикул может быть числом, а при выгрузке в строку добавляются лишние нули или пробелы.

Частая ошибка — попытка использовать один и тот же артикул для товаров с разными вариантами (например, разные цвета). Для Ozon каждая вариация (SKU) должна иметь уникальный идентификатор. Если вы продаете футболку в трех размерах, у вас должно быть три разных артикула, например: TSHIRT-RED-S, TSHIRT-RED-M, TSHIRT-RED-L.

• ✅ Дублирование: Проверьте базу на наличие повторяющихся артикулов перед загрузкой.
• ✅ Формат: Убедитесь, что в числовых полях баркодов нет букв, а в текстовых артикулах — запрещенных символов.
• ✅ Длина: Автоматически обрезайте строки, превышающие 50 символов, до начала загрузки.

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

Можно ли изменить артикул товара после создания карточки?

Нет, техническая архитектура Ozon не позволяет менять артикул (offer_id) существующей карточки. Артикул является первичным ключом в базе данных. Если вам нужно изменить код, придется удалить текущую карточку (что повлечет потерю отзывов и истории продаж) и создать новую с правильным артикулом.

Что делать, если баркод не читается на складе?

Если товар возвращают с пометкой "Нечитаемый баркод", вам необходимо переклеить этикетку. Убедитесь, что принтер печатает с достаточной плотностью (не менее 203 dpi, лучше 300 dpi), используете правильную термоэтикетку и сам штрихкод не заклеен скотчем и не деформирован.

Влияет ли длина артикула на ранжирование в поиске?

Прямой влияния длины артикула на SEO-ранжирование нет, так как покупатели редко ищут товары по внутреннему коду продавца. Однако короткий и понятный артикул помогает вам быстрее находить товар в админке и аналитике, что косвенно влияет на эффективность управления магазином.