Уявіть: у вас 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-специфікація, інструкція для менеджерів |
| Доступи | OAuth-токени, campaignId, businessId, налаштування вебхуків |
| Код інтеграції | Модулі обміну товарами, цінами, залишками, замовленнями |
| Тестування | Перевірка всіх сценаріїв: оформлення, скасування, повернення |
| Навчання | 1–2 години вебінару для вашої команди |
| Підтримка | 1 місяць технічної підтримки після запуску |
Типові помилки та їх вирішення
На основі нашого досвіду, часті проблеми: перевищення лімітів API (розбивайте запити на пакети до 1000), неправильний формат даних (перевіряйте структуру), проблеми з OAuth-токеном (оновлюйте токен раз на рік), конфлікт версій API (слідкуйте за оновленнями в документації).
Терміни та вартість
Інтеграція з Яндекс.Маркет Partner API: 12–16 робочих днів. Вартість робіт — від 40 000 грн за базову інтеграцію, що в 5 разів вигідніше за найм окремого розробника. Зв'яжіться з нами, щоб оцінити ваш проєкт — ми запропонуємо оптимальне рішення та точні терміни. Замовте інтеграцію, і ваші товари будуть завжди актуальні на Маркеті. Наш досвід — понад 5 років на ринку, 50+ успішних проєктів, гарантія якості на всі роботи.