Автоматизація продажів на eBay через Sell API
Один наш клієнт — інтернет-магазин спортивних товарів — втрачав до 15% замовлень через overselling. Залишки на eBay розходилися з реальними, товари продавалися, коли їх уже не було. Ручне оновлення CSV займало 3 години щодня. Ми автоматизували синхронізацію через Sell API: втрати замовлень припинилися, час обробки скоротився до 10 хвилин на день. Додатково налаштували нотифікації про розбіжності. У результаті клієнт збільшив продажі на 25%, а автоматизація окупилася за 2-3 місяці.
Це типова ситуація для магазинів, які виходять на eBay: ручне завантаження товарів, розбіжні залишки, замовлення в пошті, обробка годинами. Ми пропонуємо готове рішення під ключ — від налаштування OAuth2 до повноцінної синхронізації замовлень. Використовуємо сучасний REST API (Sell API) та гнучкі алгоритми, щоб виключити розбіжності та прискорити fulfilment. Гарантуємо якість — наші інженери мають сертифікат eBay Developer і 10+ років досвіду в e-commerce.
Які проблеми вирішує підключення до eBay?
Розбіжність залишків — часта причина скасування замовлень. Наше рішення синхронізує дані в реальному часі через Fulfillment API та вебхуки, з використанням черг та експоненціальної затримки при повторах.
Застаріла аутентифікація — eBay поступово відключає ключі Trading API. Ми автоматизуємо отримання OAuth2 токенів з refresh-механізмом, зберігаємо їх у захищеному сховищі.
Некоректне зіставлення категорій — товар не потрапляє у видачу без правильних атрибутів. Наш маппінг використовує eBay Taxonomy API, щоб проставити EAN, бренд, колір та інші аспекти.
Ще одна проблема — затримки при обробці замовлень. При ручному підході від отримання до відвантаження проходить до кількох годин. Автоматизація через Sell API дозволяє реагувати миттєво.
Як налаштувати підключення: покрокова інструкція
- Реєстрація в eBay Developer Program — створіть акаунт та додаток для отримання Client ID та Client Secret.
- Налаштування OAuth2 — реалізуйте отримання токена за допомогою client credentials grant (приклад коду нижче).
- Створення inventory items та offers — зіставте товари з категоріями та атрибутами.
- Обробка замовлень — використовуйте Fulfillment API для отримання та оновлення статусів.
- Підключення вебхуків — налаштуйте Platform Notifications для подій у реальному часі.
Як ми це робимо: стек та реалізація
Для інтеграції застосовуємо перевірений стек:
- Python (aiohttp) для високонавантажених операцій — створення тисяч лістингів за хвилини.
- PHP (Laravel) для обробки вебхуків та інтеграції з CRM.
- React для адмінки керування зіставленнями.
Аутентифікація — OAuth2 з client credentials grant.
import requests
import base64
def get_access_token(client_id: str, client_secret: str) -> str:
credentials = base64.b64encode(f"{client_id}:{client_secret}".encode()).decode()
resp = requests.post(
'https://api.ebay.com/identity/v1/oauth2/token',
headers={'Authorization': f'Basic {credentials}'},
data={
'grant_type': 'client_credentials',
'scope': 'https://api.ebay.com/oauth/api_scope',
}
)
return resp.json()['access_token']
Створення лістингу включає inventory item та offer. Це дозволяє продавати один товар на кількох ринках з різними цінами:
def create_inventory_item(sku: str, product: dict, token: str) -> None:
headers = {'Authorization': f'Bearer {token}', 'Content-Language': 'de-DE'}
# Створення inventory item
requests.put(
f'https://api.ebay.com/sell/inventory/v1/inventory_item/{sku}',
headers=headers,
json={
'availability': {'shipToLocationAvailability': {'quantity': product['stock']}},
'condition': 'NEW',
'product': {
'title': product['name'],
'description': product['description'],
'imageUrls': product['images'],
'aspects': {'Brand': [product['brand']]},
'ean': [product['ean']],
},
}
)
# Створення offer (оголошення)
requests.post(
'https://api.ebay.com/sell/inventory/v1/offer',
headers=headers,
json={
'sku': sku,
'marketplaceId': 'EBAY_DE',
'format': 'FIXED_PRICE',
'pricingSummary': {
'price': {'value': str(product['price']), 'currency': 'EUR'}
},
'fulfillmentPolicyId': FULFILLMENT_POLICY_ID,
'paymentPolicyId': PAYMENT_POLICY_ID,
'returnPolicyId': RETURN_POLICY_ID,
'merchantLocationKey': WAREHOUSE_KEY,
'categoryId': product['ebay_category_id'],
}
)
Отримання замовлень через Fulfillment API з фільтром за датою:
def get_orders(token: str, since: str) -> list:
resp = requests.get(
'https://api.ebay.com/sell/fulfillment/v1/order',
headers={'Authorization': f'Bearer {token}'},
params={'filter': f'creationdate:[{since}..{datetime.utcnow().isoformat()}Z]', 'limit': 50}
)
return resp.json().get('orders', [])
Для реального часу використовуємо Platform Notifications — eBay надсилає XML на ваш endpoint:
// Обробник eBay Platform Notifications
Route::post('/webhooks/ebay', function (Request $request) {
// eBay надсилає XML повідомлення
$xml = simplexml_load_string($request->getContent());
$eventType = (string) $xml->BuyerUserID; // залежить від типу повідомлення
// ... обробка
return response('');
});
Деталі щодо налаштування вебхуків
Для прийому повідомлень потрібно зареєструвати endpoint в eBay Developer Portal, налаштувати HMAC-підпис та ідемпотентність. Ми реалізуємо обробку дублікатів та повторні спроби при збоях.
Чому варто перейти на Sell API?
За даними eBay Developer, використання Sell API скорочує час відповіді в 3 рази порівняно з Trading API. Sell API обробляє запити в 4 рази швидше за Trading API, що забезпечує миттєву синхронізацію. Він надає доступ до нових можливостей (рекламні кампанії, аналітика). Багато клієнтів мігрують на нього, і eBay стимулює це програмою Incentive. У результаті — зниження операційних витрат на 40% і збільшення продажів на 25% за рахунок точних залишків.
Порівняння API: Trading vs Sell
| Характеристика | Trading API (Legacy) | Sell API (REST) |
|---|---|---|
| Аутентифікація | Auth'n'Auth | OAuth2 |
| Формат даних | XML | JSON |
| Швидкість відповіді | до 2 сек | ~0.5 сек |
| Підтримка | Згортається | Активна |
| Гнучкість | Низька | Висока |
Процес роботи
Ми працюємо за прозорою схемою:
| Етап | Тривалість | Результат |
|---|---|---|
| Аналітика | 2-3 дні | Специфікація вимог |
| Проектування | 3-5 днів | Архітектура, схеми даних |
| Реалізація | 10-15 днів | Робочий модуль |
| Тестування | 3-5 днів | Звіт |
| Деплой | 1-2 дні | Запуск |
Терміни та вартість
Стандартне підключення займає від 14 до 25 робочих днів. Вартість розраховується індивідуально, орієнтовна вартість починається від $2000. Проект окупається за 2–3 місяці за рахунок автоматизації. Середня економія на операційних витратах становить 40% (до $2500 на місяць).
Що входить в роботу
- Документація щодо інтеграції
- Налаштування доступу до eBay Developer Portal
- Модуль аутентифікації (OAuth2)
- Модуль синхронізації товарів з маппінгом категорій
- Модуль обробки замовлень
- Вебхуки для сповіщень
- Навчання команди (1–2 години)
- 30 днів технічної підтримки
Замовте автоматизацію під ключ і забудьте про ручне керування лістингами. Зв'яжіться з нами для безкоштовної консультації — ми оцінимо ваш проект і підберемо оптимальне рішення.