Товари на AliExpress розходяться із залишками в магазині — клієнти замовляють те, чого немає в наявності. Така ситуація призводить до скасувань замовлень, негативних відгуків і втрати виручки. За нашими даними, до 30% замовлень можуть бути скасовані через розсинхронізацію. Це прямий вплив на прибуток. Ми вирішуємо цю проблему через пряму інтеграцію з AliExpress Solution API. У результаті залишки оновлюються автоматично протягом 5–15 хвилин, замовлення потрапляють у CRM без затримок, а ціни синхронізуються в обидві сторони. Наша команда має 5 років досвіду в інтеграціях із маркетплейсами та реалізувала понад 50 успішних проєктів. Середня економія часу на обробку замовлень становить 80%.
Як уникнути розсинхронізації залишків?
Ручне оновлення товарів на маркетплейсі — шлях до помилок і втрат. API-інтеграція усуває людський фактор: після кожного продажу або повернення залишки перераховуються автоматично. Наприклад, при продажу 10 одиниць на AliExpress система зменшує складський запас у вашій обліковій системі за лічені секунди.
Ми використовуємо перевірений стек: Python 3.11, requests, asyncio для паралельних викликів. Аутентифікація — через TOP Protocol з підписом HMAC-MD5. Це стандарт AliExpress Open Platform, який забезпечує захист від підробки запитів.
import hashlib
import hmac
import time
class AliexpressClient:
def __init__(self, app_key: str, app_secret: str, access_token: str):
self.app_key = app_key
self.app_secret = app_secret
self.access_token = access_token
def _sign(self, params: dict) -> str:
sorted_params = sorted(params.items())
sign_string = self.app_secret
for k, v in sorted_params:
sign_string += f"{k}{v}"
sign_string += self.app_secret
return hashlib.md5(sign_string.encode()).hexdigest().upper()
def call(self, method: str, params: dict) -> dict:
base_params = {
'method': method,
'app_key': self.app_key,
'timestamp': str(int(time.time() * 1000)),
'format': 'json',
'v': '2.0',
'session': self.access_token,
**params
}
base_params['sign'] = self._sign(base_params)
resp = requests.post('https://api.taobao.com/router/rest', data=base_params)
return resp.json()
Публікація товару — інтеграція інтернет-магазину
def publish_product(self, product: dict) -> str:
result = self.call('aliexpress.solution.product.schema.get', {
'subject': product['name'],
'local_price': product['price'],
'currency_code': 'USD',
})
return result.get('result', {}).get('product_id')
Синхронізація залишків
def update_inventory(self, product_id: str, sku_list: list) -> None:
self.call('aliexpress.ds.add.info', {
'product_id': product_id,
'sku_stock_info': json.dumps([{
'skuAttr': sku['attributes'],
'quantity': sku['stock'],
'price': sku['price'],
} for sku in sku_list]),
})
Отримання замовлень
def get_orders(self, start_time: str, end_time: str) -> list:
result = self.call('aliexpress.trade.ds.order.get', {
'create_time_start': start_time,
'create_time_end': end_time,
'page_size': 50,
})
return result.get('result', {}).get('order_list', {}).get('order_dto', [])
Чому TOP Protocol кращий за прямі API-виклики?
TOP (Taobao Open Platform) — єдиний шлюз для всіх операцій з AliExpress. На відміну від прямих REST-викликів, TOP забезпечує стандартизований підпис, управління сесіями та версіонування. Це критично для стабільної роботи: при зміні версії API достатньо оновити параметр v, не переписуючи весь клієнт.
| Критерій | Ручне вивантаження | API-інтеграція |
|---|---|---|
| Час оновлення залишків | Години-дні | 5–15 хвилин |
| Помилки в даних | Часті (описки, дублі) | Виключені (автоматика) |
| Витрати часу персоналу | 2–4 години на день | 0 (все автоматично) |
| Масштабування (1000+ товарів) | Неможливо | Легко |
API-інтеграція в 10 разів швидша за ручне оновлення та повністю виключає людські помилки.
Порівняння методів синхронізації: вебхуки vs періодичні запити
| Метод | Затримка | Навантаження на API | Надійність |
|---|---|---|---|
| Вебхуки | Секунди | Мінімальна | Висока (потрібен публічний endpoint) |
| Періодичні запити (polling) | 5–15 хвилин | Залежить від інтервалу | Середня (пропуск при збої) |
Вебхуки кращі для замовлень, polling — для залишків, якщо вебхуки не підтримуються.
Що входить в інтеграцію?
Ми надаємо повний цикл робіт:
- Аудит поточної системи — аналізуємо структуру товарів, замовлень, API вашої платформи.
- Реєстрація в AliExpress Open Platform — допомагаємо оформити заявку, отримати app_key і токен.
- Проектування інтеграції — обираємо методи API, проектуємо схему даних (Product schema, Order schema).
- Розробка адаптера — пишемо код на Python з обробкою помилок, ретраями та логуванням.
- Тестування — прогоняємо 100+ сценаріїв: створення, оновлення, видалення товарів, синхронізація замовлень.
- Деплой та моніторинг — розгортаємо на вашому сервері або в хмарі, налаштовуємо алерти при збоях.
- Навчання — передаємо документацію, доступи, проводимо demo-сесію для ваших менеджерів.
- Гарантійна підтримка — 3 місяці безкоштовних доробок за потреби.
Приклад обробки помилки sign_check
При отриманні помилки sign_check перевірте порядок параметрів: вони мають бути відсортовані лексикографічно. Переконайтеся, що app_secret коректний. Якщо помилка persists, увімкніть логування підпису для налагодження.
import logging
logging.basicConfig(level=logging.DEBUG)
Додайте виведення підпису перед відправкою та порівняйте з прикладом із документації AliExpress.
Які типові помилки виникають при інтеграції?
Помилка аутентифікації sign_check — найчастіше через невірний app_secret або неправильне сортування параметрів. Перевірте, що всі параметри відсортовані в алфавітному порядку і підпис обчислюється коректно. Якщо товар не проходить модерацію, переконайтеся, що заповнені всі обов'язкові поля: категорія, бренд, країна виробництва, сертифікати. Для замовлень, які не приходять у CRM, налаштуйте вебхуки або використовуйте WebSocket від AliExpress. При перевищенні ліміту запитів впровадьте чергу (Celery) і батчинг по 50 товарів.
Терміни орієнтовно
Реєстрація в AliExpress Open Platform — від 1 до 2 тижнів. Розробка та налагодження інтеграції — 14–20 робочих днів. Вартість розраховується індивідуально залежно від складності вашої системи та кількості товарів.
Ми готові взятися за інтеграцію. Зв'яжіться з нами, щоб отримати оцінку проєкту за 1 день. Запишіться на консультацію, щоб обговорити деталі та підібрати оптимальне рішення для вашого бізнесу.