Интеграция интернет-магазина с eBay (API)

Интеграция интернет-магазина с eBay (API)

eBay предоставляет несколько API: Trading API (legacy), Sell API (современный REST). Для новых интеграций используем Sell API. Актуально для продавцов, работающих на международных рынках: US, UK, DE, AU.

Аутентификация (OAuth2)

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 API

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'],
        }
    )

Получение заказов

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', [])

eBay Notifications

// Обработчик eBay Platform Notifications
Route::post('/webhooks/ebay', function (Request $request) {
    // eBay отправляет XML уведомления
    $xml = simplexml_load_string($request->getContent());
    $eventType = (string) $xml->BuyerUserID;  // зависит от типа уведомления
    // ... обработка
    return response('');
});

Сроки

Регистрация приложения в eBay Developer Program: 1–3 дня. Интеграция (листинги + заказы): 14–20 рабочих дней.