Интеграция 1С-Битрикс с AliExpress

Интеграция 1С-Битрикс с AliExpress

AliExpress для российских продавцов работает через платформу AliExpress Россия (seller.aliexpress.ru). API отличается от глобального AliExpress — используется Solution API с авторизацией через appKey/appSecret и access_token по OAuth 2.0. Формат обмена — JSON поверх HTTPS. Фидовой загрузки нет — весь каталог управляется через API, что делает интеграцию ближе к Ozon, чем к Яндекс.Маркету.

Авторизация и получение токена

Для работы с API нужно зарегистрировать приложение в панели разработчика AliExpress. После регистрации вы получаете appKey и appSecret. Авторизация продавца — через OAuth: редирект на страницу AliExpress, продавец подтверждает доступ, в ответ — access_token с временем жизни (обычно 30 дней) и refresh_token для обновления.

Токен хранится на стороне Битрикс — в опциях модуля (COption::SetOptionString) или в отдельной таблице. Cron-агент обновляет токен до истечения срока.

Создание товаров: aliexpress.solution.product.post

Метод aliexpress.solution.product.post создаёт товар. Структура запроса:

• category_id — категория AliExpress. Дерево категорий получается через aliexpress.solution.seller.category.tree.query.
• product_attributes — массив атрибутов товара. Каждый атрибут имеет attribute_name_id и значение. Обязательные атрибуты зависят от категории — получаются через aliexpress.solution.product.schema.get.
• sku_info_list — массив SKU (вариантов). Каждый SKU содержит: цену, остаток, штрихкод, значения варьируемых атрибутов (цвет, размер), привязку к фотографиям.
• image_url_list — основные фото товара (до 6 штук, минимум 800×800 px).

Маппинг на инфоблок Битрикс:

Особенность описания. AliExpress допускает HTML в описании, включая <img> — можно вставлять инфографику и дополнительные фото прямо в описание. Изображения в описании загружаются через aliexpress.solution.feed.image.upload и возвращают URL на CDN AliExpress.

Категории и атрибуты

Система категорий AliExpress — трёхуровневая. Для каждой конечной категории есть набор обязательных и рекомендованных атрибутов. Атрибуты бывают:

• Текстовые — свободный ввод (модель, материал).
• Справочные — выбор из списка (attribute_value_id). Значения получаются через aliexpress.solution.product.schema.get.
• SKU-атрибуты — варьируются между SKU (цвет, размер). Привязываются к конкретному варианту товара.

При массовом маппинге свойств инфоблока на атрибуты AliExpress создаётся таблица соответствий. Для справочных атрибутов — хранятся пары «значение свойства Битрикс → attribute_value_id AliExpress».

Управление ценами и остатками

Цены. Обновление через aliexpress.solution.product.price.update. AliExpress работает с несколькими валютами — цена указывается в валюте, настроенной для магазина. Скидки задаются через промо-акции в ЛК или через API промоакций.

Остатки. aliexpress.solution.product.inventory.update — обновляет остатки по SKU. Лимит — 200 SKU за запрос. Для магазина с 5000+ позиций синхронизация занимает несколько минут при пакетной обработке.

Cron-агент в Битрикс: каждые 15–30 минут выбирает товары с изменёнными остатками/ценами и отправляет пакетные запросы. Для отслеживания изменений используется поле TIMESTAMP_X элемента инфоблока и b_catalog_store_product.TIMESTAMP_X для остатков.

Обработка заказов

Получение заказов: aliexpress.solution.order.get с фильтром по статусу и дате. Статусы заказов AliExpress:

Отгрузка подтверждается через aliexpress.solution.order.fulfill — передаётся трек-номер и служба доставки. AliExpress строго следит за сроками отгрузки — просрочка ведёт к штрафам и снижению рейтинга.

На стороне Битрикс: заказ создаётся в модуле sale, товары маппятся по SKU-артикулу на торговые предложения. Данные покупателя (имя, адрес) передаются в свойства заказа.

Специфика AliExpress для интеграции

Модерация товаров. AliExpress проверяет каждый товар. Среднее время — 1–2 дня. Причины отклонения: несоответствие фото (водяные знаки, логотипы других площадок), запрещённые товары, некорректный бренд.

Мультиязычность. Если продаёте на несколько стран — товар нужно локализовать через aliexpress.solution.product.translate. Или создавать отдельные листинги для каждого рынка.

Rate limiting. Лимит зависит от уровня приложения: базовый — ~40 запросов в секунду. При массовой синхронизации реализуйте очередь запросов с контролем частоты.

Сроки