Ви запускаєте продажі на Wildberries і стикаєтеся з нестабільним API. Документація застаріває, методи змінюються без попередження. Кожен збій забирає в середньому 2 години на налагодження. Помилка в маппінгу nmID веде до дублювання карток. За статистикою, 60% збоїв при інтеграції пов'язані з неправильною аутентифікацією або застарілою документацією. За даними маркетплейсу, 80% продавців мають проблеми в перший місяць роботи.
Ми займаємося інтеграцією з маркетплейсами 5 років і на 20+ проектах виробили підхід, що мінімізує ризики. Замість переписування коду під нові версії API ми створили адаптивний шар. Він автоматично обробляє зміни, скорочуючи кількість помилок у 3 рази порівняно з прямим API-викликом. Гарантуємо стабільну роботу після запуску.
Як ми обходимо нестабільність API Wildberries?
Адаптивний інтеграційний шар перехоплює відповіді, перевіряє структуру та при необхідності трансформує дані. Якщо Wildberries змінює поле nmID на nmId, інтеграція не ламається — вона підлаштовується. Це знижує витрати на підтримку до 30%.
Аутентифікація вимагає токенів, що видаються в особистому кабінеті. Для різних доменів потрібні окремі токени: основний (content, prices), статистичний (statistics), маркетплейсовий (marketplace). Приклад класу-клієнта:
class WildberriesClient
{
private string $apiToken;
private string $statsToken;
public function request(string $method, string $url, array $data = []): array
{
return Http::withHeaders([
'Authorization' => $this->apiToken,
'Content-Type' => 'application/json',
])->{strtolower($method)}($url, $data)->json();
}
}
Чому важливий правильний маппінг nmID?
Wildberries використовує внутрішній числовий ідентифікатор nmID для кожного товару. Він відрізняється від vendorCode (артикула). Помилка маппінгу призводить до дублювання карток або неможливості оновлення. Ми автоматично зіставляємо nmID з вашими SKU при першому вивантаженні. Наприклад, для артикула SKU-123 система запам'ятовує nmID 456789 і використовує його в подальших запитах. Це скорочує час налагодження в середньому на 2 години на кожну помилку.
Як налаштовується інтеграція: покроковий план
- Аудит поточної системи обліку — визначаємо дані для синхронізації.
- Налаштування токенів та прав доступу — отримуємо ключі для кожного API-домену.
- Розробка модуля маппінгу nmID — зв'язуємо артикули з внутрішніми ID Wildberries.
- Реалізація завантаження товарів, цін, залишків та замовлень — пишемо код з адаптивним шаром.
- Тестування та запуск — перевіряємо синхронізацію, навчаємо менеджера. Після запуску — місяць безкоштовної підтримки.
Що входить в роботу
- Документація з інтеграції: опис усіх ендпоінтів та маппінгів.
- Налаштування прав доступу та токенів для всіх API-доменів.
- Реалізація адаптивного шару для обробки змін API.
- Навчання вашого менеджера роботі з синхронізацією.
- Місяць безкоштовної підтримки після запуску.
- Гарантія стабільної роботи: якщо щось ламається, лагодимо протягом дня.
Порівняння API-доменів Wildberries
| API | Базовий URL | Призначення |
|---|---|---|
| Content API | https://content-api.wildberries.ru |
Завантаження та оновлення карток |
| Prices & Discounts API | https://discounts-prices-api.wildberries.ru |
Управління цінами та знижками |
| Marketplace API | https://marketplace-api.wildberries.ru |
Залишки, замовлення, поставки |
| Statistics API | https://statistics-api.wildberries.ru |
Аналітика та звіти |
Типові помилки та їх вирішення
| Помилка | Причина | Рішення |
|---|---|---|
Невірний subjectID |
Неправильна категорія товару | Автоматичний підбір subjectID за категорією |
| Неправильний токен | Використання не того домену | Перевірка токена перед запитом |
Невірний dateFrom |
Формат дати не відповідає API | Автоматичне приведення до Unix timestamp |
| Дублювання карток | Помилка маппінгу nmID | Автоматичне зіставлення при першому вивантаженні |
Детальніше про типові помилки
Помилка невірного subjectID виникає, якщо вказано ідентифікатор предмета, що не відповідає категорії товару. Ми автоматично визначаємо subjectID за категорією з вашої системи. Неправильний токен блокує оновлення залишків або замовлень — перед кожним запитом перевіряється валідність токена та його прив'язка до потрібного домену. Невірний dateFrom призводить до того, що замовлення не приходять — ми використовуємо Unix timestamp і перевіряємо його перед відправкою.Завантаження товарів: як уникнути помилок
Картки товарів мають специфічну структуру: предмети (subjectID), характеристики, розміри. Ми автоматично підбираємо subjectID за категорією. Приклад коду завантаження:
public function createCard(Product $product): void
{
$payload = [[
'subjectID' => $this->getSubjectId($product->category),
'variants' => [[
'vendorCode' => $product->sku,
'title' => $product->name,
'description'=> $product->description,
'brand' => $product->brand,
'dimensions' => [
'length' => $product->length_cm,
'width' => $product->width_cm,
'height' => $product->height_cm,
'isValid'=> true,
],
'characteristics' => $this->mapCharacteristics($product),
]],
]];
$this->request('POST', 'https://content-api.wildberries.ru/content/v2/cards/upload', $payload);
}
Оновлення цін та залишків
Як швидко оновити ціни та знижки?
WB розділяє базову ціну та знижку. Помилка в одному запиті може заблокувати всі оновлення. Ми використовуємо пакетну обробку з повторними спробами:
public function setPriceAndDiscount(string $sku, int $basePrice, int $discountPercent): void
{
$this->request('POST', 'https://discounts-prices-api.wildberries.ru/api/v2/upload/task', [
'data' => [[
'nmID' => $this->getNmId($sku),
'price' => $basePrice,
]]
]);
$this->request('POST', 'https://discounts-prices-api.wildberries.ru/api/v2/upload/task', [
'data' => [[
'nm' => $this->getNmId($sku),
'discount' => $discountPercent,
]]
]);
}
Оновлення залишків (FBS)
public function updateStocks(array $items): void
{
$this->request('PUT', 'https://marketplace-api.wildberries.ru/api/v3/stocks/{warehouseId}', [
'stocks' => array_map(fn($item) => [
'sku' => $item['sku'],
'amount' => $item['amount'],
], $items)
]);
}
Отримання замовлень FBS
public function getOrders(string $since): array
{
return $this->request('GET', 'https://marketplace-api.wildberries.ru/api/v3/orders', [
'limit' => 1000,
'next' => 0,
'dateFrom' => strtotime($since),
])['orders'] ?? [];
}
Результати та терміни
Інтеграція з Wildberries (товари + ціни + залишки + замовлення) займає 14–20 робочих днів. Завдяки адаптивному шару ви заощадите до 40% часу на обробці замовлень порівняно з ручним управлінням. У 95% випадків інтеграція завершується вчасно. Зв'яжіться з нами для консультації — оцінимо обсяг робіт та запропонуємо оптимальне рішення. Замовте інтеграцію та отримайте стабільну синхронізацію з гарантією роботи після запуску.