Вы запускаете продажи на 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% случаев интеграция завершается в срок. Свяжитесь с нами для консультации — оценим объём работ и предложим оптимальное решение. Закажите интеграцию и получите стабильную синхронизацию с гарантией работы после запуска.