Інтеграція 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 запитів на секунду. При масовій синхронізації реалізуйте чергу запитів з контролем частоти.

Терміни