Загрузка товаров на AliExpress: карточки, фид, интеграция

Каталог на AliExpress можно завести четырьмя способами: руками в личном кабинете, файлом Excel, по ссылке на YML-фид и через API. Способы не равнозначны: один создаёт полноценные карточки, другой — заготовки без характеристик и без бренда, третий требует программиста. Разбираем, что каждый делает с вашими данными, что площадка проверяет на входе, а что — после создания товара, и как не потерять остатки на первом же обновлении фида.

Если магазина ещё нет, начните с полного разбора площадки — AliExpress для продавцов. Здесь речь только про каталог.

Четыре способа загрузки: что выбрать

Справка площадки называет все четыре равноправными, но по факту они решают разные задачи.

Общее для всех четырёх: после публикации товар появляется на витрине в течение 120 часов. Сама модерация идёт своим чередом и занимает до 48 часов, а при дополнительной проверке специалистом — до семи дней. Всё это время товар лежит на вкладке «На рассмотрении», но купить его по прямой ссылке уже можно.

Что сделать до первой загрузки

Площадка требует три вещи заранее, и без них файл упадёт на валидации:

• Шаблон доставки. Его идентификатор — обязательное поле и в Excel, и в API. Найти можно в разделе «Магазин» → «Шаблоны доставки», в столбце ID.
• Зарегистрированные бренды. Бренда нет в списке магазина — карточка не создастся. Для чужих торговых марок понадобится авторизационное письмо от правообладателя.
• Заявка на специальную категорию. Медицинские изделия и БАДы, продукты питания, парфюмерия, украшения и аксессуары, интимные товары, подгузники, соски и автокресла — публикацию ограничат, пока вы не приложите разрешительные документы.

Требования к карточке, которые проверяются на входе

Часть требований AliExpress проверяет при загрузке — ошибку вы увидите сразу. Часть проверяется после создания, и нарушители уходят на вкладку «Заблокированы». Вторая группа опаснее: файл прошёл, отчёт зелёный, а товаров в продаже нет.

Название

Схема площадки: категория + бренд или производитель + модель или артикул + основные характеристики. Указывать нужно только конечную категорию — «Шкаф-купе», а не «Мебель для спальни». Максимальная длина на русском — 128 символов, на английском — 218. В названии нельзя повторять одно ключевое слово, вставлять чужие бренды, слова вроде «скидка» и «распродажа» и названия других категорий. За переспам карточку блокируют, а не понижают.

Изображения

Здесь у конкурентов в блогах живёт устойчивая ошибка: требование «800 × 800 или 750 × 1000 пикселей» приписывают главному фото. В справке это требование к маркетинговому изображению: 1:1 — от 800 × 800 px, 3:4 — от 750 × 1000 px. Для основного изображения и изображения вариации правило другое: большая сторона от 750 px, меньшая от 100 px.

• Формат — JPEG или PNG, размер файла до 5 МБ.
• Фон белый или светлый, однотонный. Товар занимает не меньше 70 % кадра.
• Главное изображение — фотография товара целиком. Рендеры и графика запрещены.
• Водяных знаков и надписей быть не должно. Исключение — логотип бренда в левом верхнем углу, до 220 × 80 px, с отступом 20 px от краёв.
• Телефоны, почта, адреса, ссылки на соцсети, штрихкоды и QR-коды на фото считаются переманиванием покупателей.

Если грузите фото ссылками, ссылка должна вести прямо на файл: не на страницу с обзором, не на Яндекс Диск или Google Drive, без авторизации, по http или https и без указания порта.

Описание

Описание принимает HTML, но не любой. Работают div, заголовки h1–h6, p, strong, i, em, u, small, pre, br, span, blockquote, списки, sup и sub, img с атрибутами src, width и height, таблицы и ссылки. Всё остальное — цвета и шрифты — вырезается автоматически. В YML-файле разметку кладут внутрь CDATA.

Excel: партия одной категории

Шаблон качается на странице «Товары» → «Массовые операции Excel»: выбираете категорию, нажимаете «Скачать». В файле уже лежат ваши метаданные — их менять нельзя, как и структуру: не добавлять, не удалять и не двигать столбцы. Данные из других шаблонов копировать тоже нельзя, единственное исключение — ссылки на изображения и значения цен.

Вариации задаются тремя правилами: у всех строк одинаковый «Модель (seller SPU ID)», разные «Артикул (seller SKU ID)» и уникальный набор значений в блоке характеристик модификации. Поля «Название цвета в системе продавца» и «Название размера в системе продавца» вариаций не создают: если у двух строк цвет «красный», а ваши названия «алый» и «бордовый», площадка увидит одну вариацию. Продаёте юбку двух цветов в двух размерах — заводите четыре строки.

После загрузки появляется отчёт. Если в колонке «Незагруженные» ненулевое значение, откройте «Подробно», скачайте файл с ошибками, исправьте исходник, удалите из него успешно загруженные товары и залейте заново. Иначе получите дубли — а дублирующие карточки внутри одного магазина площадка блокирует.

Для массового обновления берут расширенный шаблон: «Массовые операции Excel» → «Изменить» → «Скачать и изменить шаблон». Если товаров больше пяти тысяч, файлы придут архивом. Менять в них нельзя три поля: AliExpress SKU ID, AliExpress product ID и язык товара.

YML: удобно, но есть ловушка

YML — стандарт Яндекса, тот же формат, которым вы отдаёте каталог в Маркет. Ссылку на файл добавляют в разделе «Товары» → «Массовые операции YML», там же выбирают шаблон доставки, время подготовки заказа и указывают, что обновлять автоматически: атрибуты, категории, цены, остатки. По умолчанию автообновление выключено.

Дальше — главное, о чём не пишет ни один разбор в блогах агрегаторов. Переключатель «Обнулять остатки, если товаров нет в файлах» по умолчанию стоит в положении «Да». Это значит: всё, что вы раньше завели руками или через Excel и не положили в YML, уедет в ноль. Справка прямо просит добавить в фид и такие товары тоже.

Второе, о чём стоит знать заранее: товары, созданные из YML, приходят без характеристик, специфичных для категории, и с брендом «Нет». Дозаполнять придётся руками или через Excel. Поэтому YML хорош как канал обновления цен и остатков, но плох как способ первичного создания карточек.

Ещё три ограничения: сопоставить вручную можно не больше десяти атрибутов; после нажатия «Продолжить» остановить создание товаров уже нельзя — придётся дождаться конца и выключить фид; перезапускать файл чаще трёх раз в день площадка не рекомендует. Историю загрузок кабинет хранит 30 дней.

API: где реальные пределы

Рабочий адрес — https://openapi.aliexpress.ru. Авторизация по JWT-токену в заголовке x-auth-token. Токен выпускается в кабинете, срока действия у него нет, одновременно активных может быть до пяти. Общий потолок — 400 запросов в секунду.

Создание товаров — метод POST /api/v1/product/create. В одном запросе до 1000 товаров. За четыре часа можно создать или обновить не больше 100 000 товаров, и квота суммируется по всем методам создания и редактирования: если вы залили каталог, а следом погнали массовое обновление цен, они делят один лимит.

Важная деталь, которую пропускают почти все инструкции: ответ 200 OK не означает, что товар создан. Запрос формирует группу заданий с идентификатором group_id, и результат нужно забирать методом GET /api/v1/tasks?group_id=. Без этой проверки вы не узнаете об ошибках вовсе.

Что понадобится собрать до первого запроса:

1. Категорию нижнего уровня. Верхний список — POST /api/v1/categories/top, дальше рекурсивно POST /api/v1/categories/get по children_ids, пока не кончатся дочерние.
2. Атрибуты категории и их значения — те же categories/get и categories/values-dictionary. Обязательные помечены is_required: true. Свой атрибут задаётся значением -1 в полях идентификаторов.
3. Габариты и вес: длина, ширина и высота упаковки от 1 до 700 см, вес от 0,01 до 700 кг. Нули не пройдут.
4. Срок отправки shipping_lead_time — от 1 до 30 дней, площадка рекомендует не больше пяти.
5. Вариации в sku_info_list: артикул, цена, остаток от 0 до 999 999. Максимальная цена в рублях — 5 000 000.

Отдельная особенность: система достраивает вариации сама. Загрузите чёрные джинсы 32-го размера и белые 34-го — появятся ещё белые 32 и чёрные 34, с автоматическими артикулами, но без цены и остатка. Их нужно либо заполнить, либо отключить, иначе карточка соберёт мёртвые модификации.

Цены и остатки обновляются отдельными методами — update-sku-price и update-sku-stock, до 1000 идентификаторов товаров в запросе. Текущие остатки отдаёт POST /api/v1/stocks.

Один источник остатков на все площадки

Проблема начинается не на загрузке, а после неё. Каталог на AliExpress живёт по своим правилам: свои идентификаторы категорий, свой шаблон доставки, свой формат вариаций, своя квота. Если тот же товар продаётся ещё на Wildberries, Ozon и Яндекс Маркете, четыре независимых обмена вручную не удержать — расхождение вылезет первым же перепроданным заказом.

Рабочая схема одна: один справочник товаров в учётной системе, из него — выгрузка в каждую площадку по её протоколу. SelSup держит карточки, цены и остатки в одном месте и синхронизирует их с маркетплейсами по API, включая AliExpress: правки разлетаются по всем подключённым площадкам, а заказы приходят в общую ленту. Квоты, форматы и обязательные поля становятся заботой интеграции, а не вашей таблицы.

Как только каталог загружен, следующий вопрос — куда и в какие сроки отгружать. Про схемы и сроки — в разборе логистики AliExpress для продавца, а про разделы кабинета, где всё это настраивается, — в статье про кабинет селлера AliExpress.

Почему товар загрузился, но не продаётся

Валидацию файл прошёл, а карточки нет в поиске. Частые причины из правил публикации:

• Не та категория. Умышленный выбор неподходящей категории — прямое основание для блокировки.
• Переспам в названии. Повтор ключа, чужой бренд, характеристики, не совпадающие с атрибутами.
• Скопированный контент. Точное копирование изображений, названий или описаний из чужого магазина.
• Дубли внутри своего магазина. Несколько карточек одного товара площадка трактует как манипуляцию выдачей.
• Мёртвые вариации. SKU с нулевым остатком, который занижает минимальную цену карточки в поиске, — отдельное нарушение.
• Контакты на карточке. Телефон, почта, ссылки на соцсети в описании или на фото.
• Страна происхождения. Тайвань, Куба, КНДР, Иран и Сирия запрещены, даже если товар легален и сертифицирован.

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

Частые вопросы

Сколько товаров можно загрузить одним файлом Excel?

Прямого лимита на загрузку справка не устанавливает — распространённая в блогах цифра «до 5000 единиц» первоисточником не подтверждается. Пять тысяч упоминаются в другом контексте: при массовом обновлении, если товаров больше, кабинет предупреждает и отдаёт файлы архивом. Реальное ограничение другое: один файл — одна категория.

Почему после загрузки YML обнулились остатки?

Настройка «Обнулять остатки, если товаров нет в файлах» по умолчанию включена. Всё, чего нет в фиде, площадка ставит в ноль. Либо добавьте недостающие товары в YML, либо переключите настройку в «Нет» при загрузке или позже, через «Изменить параметры».

Можно ли загрузить товары нескольких категорий одним YML?

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

Что делать, если API вернул 200 OK, а товара нет?

Это нормальное поведение. Ответ означает только, что запрос принят и создана группа заданий. Реальный результат забирают методом GET /api/v1/tasks?group_id= — там будут статусы по каждому товару и тексты ошибок.

Сколько ждать появления товара на витрине?

Модерация — до 48 часов, дополнительная проверка специалистом — до семи дней. После публикации товар появляется на витрине и в поиске в течение 120 часов, но по прямой ссылке доступен раньше.

Можно ли поменять ссылку на YML-файл?

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