Інтеграція з Яндекс.Маркет через Partner API: посібник

Уявіть: у вас 15 000 товарів, ціни змінюються щогодини, а менеджер витрачає 4 години на день на ручне оновлення в особистому кабінеті Яндекс.Маркета. Помилки при ручному введенні — 5–8% позицій. Після інтеграції через Partner API все автоматизується: товари завантажуються за 2 хвилини, ціни синхронізуються за розкладом, замовлення обробляються без участі людини. Ми маємо понад 5 років досвіду в інтеграції, реалізували 50+ проєктів для магазинів з різним обсягом продажів. Економія часу — до 90% порівняно з ручним керуванням.

Яндекс.Маркет надає Partner API — набір REST-методів для керування товарами, цінами, залишками та замовленнями. API підтримує три моделі роботи: FBS (продавець зберігає товари у себе), FBO (товари на складі Маркета) та DBS (продавець доставляє сам). У цій статті розберемо технічні деталі інтеграції: аутентифікацію, завантаження товарів, оновлення цін і залишків, обробку замовлень через вебхуки.

Чому варто автоматизувати роботу з Яндекс.Маркетом?

Ручне керування асортиментом на маркетплейсі — це не лише довго, а й загрожує помилками. За нашими даними, автоматизація через API скорочує час на оновлення каталогу в 10–15 разів. Наприклад, завантаження 100 товарів вручну займає 30 хвилин, а через API — 2 хвилини. Помилки при ручному введенні трапляються у 5–8% випадків (неправильна ціна, неправильний залишок), при автоматичній синхронізації — менше 0.1%. Крім того, API дозволяє вивантажувати замовлення безпосередньо у вашу облікову систему, виключаючи подвійне введення даних. Ми гарантуємо безпеку даних та працюємо згідно з сертифікованими стандартами.Дані внутрішньої аналітики компанії

Технічна реалізація інтеграції

Partner API використовує OAuth2 токени. Авторизація через Яндекс OAuth:

class YandexMarketClient {
    private string $accessToken;
    private int $campaignId;
    private int $businessId;

    public function request(string $method, string $path, array $data = []): array {
        return Http::withHeaders([
            'Authorization' => "OAuth oauth_token={$this->accessToken}",
            'Content-Type' => 'application/json',
        ])->{strtolower($method)}(
            "https://api.partner.market.yandex.ru{$path}",
            $data
        )->json();
    }
}

Завантаження/оновлення товарів, цін та залишків:

public function updateOffers(array $products): void {
    $offers = array_map(fn($product) => [
        'offerId' => $product['sku'],
        'name' => $product['name'],
        'category' => $product['category_name'],
        'pictures' => $product['images'],
        'vendor' => $product['brand'],
        'description' => $product['description'],
        'price' => ['value' => $product['price'], 'currencyId' => 'RUR'],
        'count' => $product['stock'],
        'barcodes' => [$product['barcode']],
    ], $products);
    $this->request('PUT', "/businesses/{$this->businessId}/offer-mappings", ['offerMappings' => array_map(fn($o) => ['offer' => $o], $offers)] );
}

public function updatePrices(array $items): void {
    $offers = array_map(fn($item) => [
        'id' => $item['sku'],
        'price' => ['value' => $item['price'], 'currencyId' => 'RUR', 'vat' => 'VAT_20'],
    ], $items);
    $this->request('POST', "/campaigns/{$this->campaignId}/offer-prices/updates", ['offers' => $offers] );
}

public function updateStocks(array $items, int $warehouseId): void {
    $skus = array_map(fn($item) => [
        'sku' => $item['sku'],
        'items' => [['count' => $item['stock'], 'type' => 'FIT']],
    ], $items);
    $this->request('PUT', "/campaigns/{$this->campaignId}/offers/stocks", ['skus' => $skus, 'warehouseId' => $warehouseId] );
}

Обробка замовлень та push-сповіщення:

public function getNewOrders(): array
{
    $resp = $this->request('GET', "/campaigns/{$this->campaignId}/orders", ['status' => 'PROCESSING', 'substatus' => 'STARTED', 'pageSize' => 50] );
    return $resp['orders'] ?? [];
}

public function acceptOrder(int $orderId): void
{
    $this->request('PUT', "/campaigns/{$this->campaignId}/orders/{$orderId}/status", ['order' => ['status' => 'PROCESSING', 'substatus' => 'READY_TO_SHIP']] );
}

Route::post('/webhooks/yandex-market', function (Request $request) {
    $events = $request->input('data');
    foreach ($events as $event) {
        match($event['type']) {
            'ORDER_STATUS_CHANGED' => ProcessYandexOrderStatus::dispatch($event['orderId']),
            default => null,
        };
    }
    return response()->json(['status' => 'ok']);
});

Етапи інтеграції під ключ

Інтеграція проходить кілька етапів: аналітика, проєктування, реалізація, тестування, деплой та навчання. У результаті ви отримуєте документацію, доступи, код інтеграції, тестування всіх сценаріїв, навчання для вашої команди (1–2 години вебінару) та 1 місяць технічної підтримки після запуску.

Типові помилки та їх вирішення

На основі нашого досвіду, часті проблеми: перевищення лімітів API (розбивайте запити на пакети до 1000), неправильний формат даних (перевіряйте структуру), проблеми з OAuth-токеном (оновлюйте токен раз на рік), конфлікт версій API (слідкуйте за оновленнями в документації).

Терміни та вартість

Інтеграція з Яндекс.Маркет Partner API: 12–16 робочих днів. Вартість робіт — від 40 000 грн за базову інтеграцію, що в 5 разів вигідніше за найм окремого розробника. Зв'яжіться з нами, щоб оцінити ваш проєкт — ми запропонуємо оптимальне рішення та точні терміни. Замовте інтеграцію, і ваші товари будуть завжди актуальні на Маркеті. Наш досвід — понад 5 років на ринку, 50+ успішних проєктів, гарантія якості на всі роботи.