Интеграция с eBay: автоматизация продаж через Sell API

Автоматизация продаж на 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 позволяет реагировать мгновенно.

Как настроить интеграцию: пошаговая инструкция

1. Регистрация в eBay Developer Program — создайте аккаунт и приложение для получения Client ID и Client Secret.
2. Настройка OAuth2 — реализуйте получение токена с помощью client credentials grant (пример кода ниже).
3. Создание inventory items и offers — сопоставьте товары с категориями и атрибутами.
4. Обработка заказов — используйте Fulfillment API для получения и обновления статусов.
5. Подключение вебхуков — настройте 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('');
});

Почему стоит обновить интеграцию на Sell API?

По данным eBay Developer, использование Sell API сокращает время ответа в 3 раза по сравнению с Trading API. Он предоставляет доступ к новым возможностям (рекламные кампании, аналитика). Многие клиенты мигрируют на него, и eBay стимулирует это программой Incentive. В результате — снижение операционных затрат на 40% и увеличение продаж на 25% за счёт точных остатков.

Сравнение API: Trading vs Sell

Процесс работы

Мы работаем по прозрачной схеме:

Сроки и стоимость

Стандартная интеграция занимает от 14 до 25 рабочих дней. Стоимость рассчитывается индивидуально. Ориентировочно проект окупается за 2–3 месяца за счёт автоматизации. Средняя экономия на операционных затратах составляет 40%.

Что входит в работу

• Документация по интеграции
• Настройка доступа к eBay Developer Portal
• Модуль аутентификации (OAuth2)
• Модуль синхронизации товаров с маппингом категорий
• Модуль обработки заказов
• Вебхуки для уведомлений
• Обучение команды (1–2 часа)
• 30 дней технической поддержки

Закажите интеграцию под ключ и забудьте о ручном управлении листингами. Свяжитесь с нами для бесплатной консультации — мы оценим ваш проект и подберём оптимальное решение.

Мы разрабатываем маркетплейсы и мультивендорные платформы, где бизнес-логика завязана на три стороны: покупатель, продавец и платформа. Ошибка в расчёте комиссии на 1000 заказов в день — это финансовые расхождения, которые невозможно разгрести без отдельного reconciliation‑процесса. Наш опыт показывает: даже при средней нагрузке 500 заказов в сутки неправильная модель выплат приводит к потере до 15% выручки платформы. Мы решили эту проблему для 50+ проектов — от нишевых B2B до горизонтальных retail‑маркетплейсов. Процесс разработки маркетплейсов требует детальной проработки архитектуры расчётов и изоляции данных.

Как избежать расхождений в расчётах комиссий

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

Модели комиссий (используем одну из или комбинируем):

Мы используем Stripe Connect как базовый стандарт. Режим Destination charges даёт платформе контроль над выплатами, включая удержания при спорах. Onboarding продавца проходит через Stripe Identity: KYC/AML проверка обязательна, пока продавец не верифицирован — выплаты заморожены. Продуманный UX этого процесса критичен для конверсии продавцов — в наших проектах мы добились конверсии 80% при регистрации.

Почему архитектура мультиарендности критична для изоляции данных

Первый шаг — выбор архитектуры мультиарендности. В shared‑schema режиме все продавцы в одних таблицах с vendor_id. Мы обязательно внедряем Row Level Security на уровне PostgreSQL и глобальные scopes в ORM (Laravel, Rails, Django). Это гарантирует, что продавец не увидит чужих заказов даже при ошибке разработчика. Для enterprise‑проектов с жёсткими требованиями GDPR используем отдельные схемы PostgreSQL — изоляция строже, но cross‑vendor аналитика сложнее.

Как реализовать складские остатки без race condition

Два покупателя одновременно добавляют последний товар в корзину. Кто его купит? Применяем optimistic locking при создании заказа:

UPDATE inventory 
SET reserved = reserved + 1 
WHERE product_id = ? AND (quantity - reserved) >= 1

Атомарная операция — второй запрос вернёт 0 затронутых строк и получит ошибку «товар закончился». Типичная схема для высоконагруженных маркетплейсов.

Сравнение подходов к каталогу товаров

Для нишевого B2B маркетплейса мы чаще выбираем per‑vendor — быстрее запускается. Для горизонтального retail с сотнями продавцов — unified‑каталог даёт лучший UX.

Пайплайн модерации: автоматика и ручная верификация

Маркетплейс несёт ответственность за контент продавцов. Типовые проблемы: поддельные товары, запрещённые категории, манипуляция ценами, фейковые отзывы. Выстраиваем трёхуровневый пайплайн:

1. Автоматические проверки при публикации: обязательные поля, соответствие категории, стоп‑лист слов, дубликаты через хеш изображения.
2. AI‑классификация (Amazon Rekognition или Vertex AI Vision) — детекция запрещённого контента и определение категории.
3. Очередь ручной проверки для flagged товаров.

Статусная машина: draft → pending_review → active / rejected → suspended. Каждый переход — событие с причиной и модератором. Продавец получает уведомление с конкретной причиной отказа, а не «нарушение правил». Верификация отзывов обязательна — только после подтверждённого заказа. Автоматический детектор флагует резкий рост отзывов от аккаунтов с нулевой историей.

Поиск и рекомендации

Поиск по маркетплейсу с разными продавцами и сотнями тысяч товаров — это Elasticsearch или OpenSearch, не SQL LIKE. Векторный поиск для семантики, фасетная фильтрация через агрегации. Персонализированная лента на основе коллаборативной фильтрации. A/B тестирование алгоритмов ранжирования обязательно — интуиция здесь плохой советчик.

Процесс работы

Маркетплейс — итеративная разработка. MVP: регистрация продавцов, каталог товаров, корзина и checkout через Stripe Connect, базовая модерация. После запуска — данные о реальном использовании определяют приоритеты следующих итераций.

Типичный порядок:

• MVP (3–4 месяца)
• Аналитика и обратная связь
• Первый расширенный релиз (2–3 месяца)
• Масштабирование и оптимизация

Сроки и стоимость

• MVP маркетплейса (каталог, checkout, базовые профили продавцов): 3–5 месяцев.
• Полнофункциональный маркетплейс с модерацией, расширенной аналитикой, мобильным приложением: 8–18 месяцев.
• Добавление маркетплейс‑функциональности к существующему e‑commerce: 2–5 месяцев.

Стоимость разработки рассчитывается индивидуально после аудита требований. Ориентировочный бюджет MVP — от 2 до 5 млн рублей в зависимости от сложности. Точную оценку дадим на бесплатном предпроектном обследовании.

Что входит в работу

• Проектная документация: архитектура, схемы данных, API‑спецификации (OpenAPI).
• Доступы к репозиторию, CI/CD, документации по развёртыванию.
• Обучение команды заказчика работе с платформой.
• Техническая поддержка в течение первого месяца после запуска.

Мы гарантируем корректность финансовых расчётов и конфиденциальность данных. Wikipedia: Маркетплейс — архитектурные принципы, на которых мы основываемся, подтверждены опытом 10+ лет и 50+ успешных проектов.

Получите консультацию по архитектуре вашего маркетплейса — свяжитесь с нами для предварительной оценки. Средняя экономия от правильно настроенных выплат составляет до 2 млн рублей в год при объёме 1000 заказов в день. Закажите аудит текущей платформы — выявим узкие места и предложим оптимизацию.