Уявіть: у вас 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+ успішних проєктів, гарантія якості на всі роботи.