Представьте: у вас 15 000 товаров, цены меняются каждый час, а менеджер тратит 4 часа в день на ручное обновление в личном кабинете Яндекс.Маркета. Ошибки при ручном вводе — 5–8% позиций. После интеграции через Partner API всё автоматизируется: товары загружаются за 2 минуты, цены синхронизируются по расписанию, заказы обрабатываются без участия человека. Мы реализовали более 50 таких проектов для магазинов с оборотом от 500 тыс. до 50 млн рублей в месяц.
Яндекс.Маркет предоставляет Partner API — набор REST-методов для управления товарами, ценами, остатками и заказами. API поддерживает три модели работы: FBS (продавец хранит товары у себя), FBO (товары на складе Маркета) и DBS (продавец доставляет сам). В этой статье разберём технические детали интеграции: аутентификацию, загрузку товаров, обновление цен и остатков, обработку заказов через вебхуки.
Почему стоит автоматизировать работу с Яндекс.Маркетом?
Ручное управление ассортиментом на маркетплейсе — это не только долго, но и чревато ошибками. По нашим данным, автоматизация через API сокращает время на обновление каталога в 10–15 раз. Например, загрузка 100 товаров вручную занимает 30 минут, а через API — 2 минуты. Ошибки при ручном вводе встречаются в 5–8% случаев (неверная цена, неправильный остаток), при автоматической синхронизации — менее 0.1%. Кроме того, API позволяет выгружать заказы напрямую в вашу учётную систему, исключая двойной ввод данных.
Какие данные синхронизируются через API?
Partner API предоставляет методы для работы с ключевыми сущностями:
- Товары: создание, обновление, удаление; обязательные поля — offerId, name, price, count. Можно загружать до 1000 товаров за один запрос.
- Цены и остатки: регулярное обновление (например, каждый час) через POST /campaigns/{id}/offer-prices/updates и PUT /campaigns/{id}/offers/stocks.
- Заказы: получение новых заказов, изменение статусов, отмена. Вебхуки уведомляют об изменениях в реальном времени.
Важно учитывать лимиты API: не более 5000 запросов в день на кампанию, поэтому рекомендуется использовать пакетную обработку.
Аутентификация
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]
);
}
// Обновление остатков FBS
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]
);
}
Обработка заказов
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']]
);
}
Push-уведомления о заказах
Яндекс.Маркет поддерживает push-уведомления через настройки в кабинете продавца:
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']);
});
Процесс интеграции под ключ
Интеграция проходит в несколько этапов:
- Аналитика: изучаем текущую систему учёта, ассортимент, бизнес-процессы.
- Проектирование: выбираем модель (FBS/FBO/DBS), проектируем архитектуру обмена.
- Реализация: пишем код для синхронизации товаров, цен, остатков, заказов; настраиваем вебхуки.
- Тестирование: проверяем на песочнице Маркета, затем на боевом контуре.
- Деплой и обучение: разворачиваем решение, проводим вебинар для сотрудников, передаём документацию.
Что входит в работу под ключ?
| Компонент | Описание |
|---|---|
| Документация | API-спецификация, инструкция для менеджеров |
| Доступы | OAuth-токены, campaignId, businessId, настройка вебхуков |
| Код интеграции | Модули обмена товарами, ценами, остатками, заказами |
| Тестирование | Проверка всех сценариев: оформление, отмена, возврат |
| Обучение | 1–2 часа вебинара для вашей команды |
| Поддержка | 1 месяц технической поддержки после запуска |
Сравнение ручного и автоматического управления
Ручное обновление товаров на Маркете (через личный кабинет) занимает в среднем 30 минут на 100 позиций. Автоматическая интеграция через API — 1–3 минуты на весь каталог. Ошибки при ручном вводе встречаются в 5–8% случаев, а при автоматической синхронизации — менее 0.1%.
Типичные ошибки при интеграции
На основе нашего опыта, частые проблемы:
- Превышение лимитов API: при попытке загрузить более 1000 товаров за раз API возвращает 429. Решение — разбивать на пакеты по 1000.
- Неверный формат данных: например, неправильный формат штрихкода или отсутствие обязательного поля. Всегда проверяйте структуру запроса.
- Проблемы с OAuth-токеном: токен может истечь (срок жизни — 1 год), нужно предусмотреть его обновление.
- Конфликт версий: при изменении API со стороны Яндекса — следите за обновлениями в документации Partner API.
Сроки
Интеграция с Яндекс.Маркет Partner API: 12–16 рабочих дней. Свяжитесь с нами, чтобы оценить ваш проект — мы предложим оптимальное решение и точные сроки. Закажите интеграцию, и ваши товары будут всегда актуальны на Маркете.