Content API Wildberries для сертификатов: как записать номера в карточки и избежать блокировки

Управление тысячами SKU на маркетплейсе — это постоянная работа с данными. Если вы продаёте товары, подлежащие обязательной сертификации, к этой рутине добавляется критически важная задача: своевременное обновление номеров деклараций и сертификатов. Пропустили срок или ошиблись в цифре — и карточка заблокирована. Мы в МЕТЧ знаем, что ручной ввод — прямой путь к потере прибыли. Работа с Content API Wildberries для сертификатов — это единственный масштабируемый способ держать документацию под контролем.

Проблема не в том, чтобы один раз заполнить данные, а в их поддержке, особенно когда каталог насчитывает 5 000, 10 000 или 100 000 SKU.

Почему ручное управление сертификатами на WB — это риск для бизнеса

Каждая карточка, где не указан или неверно указан номер разрешительного документа, — это мина замедленного действия. Модерация Wildberries или первая же жалоба покупателя приводят к блокировке. Для бизнеса с большим оборотом это означает прямые убытки.

Рассмотрим примерный сценарий для каталога в 5000 SKU. Контент-менеджер тратит на каждую карточку в среднем 2 минуты: найти нужный документ, скопировать номер, вставить в поле, сохранить. Это более 160 часов монотонной работы. А если у вас несколько партий с разными документами или истекает срок действия старых? Процесс повторяется.

Что будет, если игнорировать

• Риск: Блокировка карточки товара WB до предоставления корректных данных. Карточка пропадает из выдачи, продажи останавливаются. Считайте упущенную прибыль за каждый день простоя.
• Штраф: Помимо блокировки, Wildberries может применить штрафные санкции, особенно при систематических нарушениях. Площадка не хочет нести репутационные и юридические риски из-за продавцов, нарушающих требования законодательства и ТР ТС.

Это время, которое ваша команда могла бы потратить на анализ продаж, запуск новых позиций или оптимизацию логистики, а не на механическое копирование данных.

Что такое Content API Wildberries и как он решает эту задачу

Content API — это программный интерфейс для управления контентом карточек товаров. Вместо того чтобы кликать по кнопкам в личном кабинете, вы отправляете структурированные запросы на сервер Wildberries. Это позволяет автоматизировать массовое обновление характеристик, включая номера сертификатов соответствия и деклараций.

Многие селлеры полагают, что маркетплейс сам проверяет все документы. Это не совсем так. Wildberries реагирует на отсутствие данных или на жалобы, но не занимается проактивным менеджментом ваших сертификатов. Ответственность за корректность и актуальность информации полностью лежит на вас. API карточек WB — это инструмент, который даёт вам необходимый контроль.

Шаг 1. Получение токена «Контент» для доступа к API

Чтобы начать работу, нужен авторизационный ключ — токен. Он подтверждает, что запросы отправляете именно вы.

Шаги с таймером

1. Зайти в личный кабинет WB. Перейдите в раздел «Профиль». — 5 секунд.
2. Выбрать вкладку «Доступ к API». Она находится в меню настроек. — 3 секунды.
3. Сгенерировать токен «Контент». Если у вас несколько токенов, убедитесь, что вы используете именно тот, который отвечает за управление контентом. Не путайте его с токеном для статистики или маркетплейса. Назовите его понятно, например, «МЕТЧ_Content». — 15 секунд.
4. Сохранить токен. Скопируйте и сохраните его в безопасном месте. Это критично: токен виден только один раз в момент создания. Если вы его потеряете, придётся генерировать новый. — 10 секунд.

Общее время: ~33 секунды.

Токен Контент WB — это ваш ключ к автоматизации. Никогда не передавайте его третьим лицам и не публикуйте в открытом доступе.

Шаг 2. Запись характеристик WB: какие поля отвечают за сертификаты

Получив токен, вы можете отправлять запросы на обновление карточек. Основной метод, который нам понадобится — обновление характеристик товара. Для этого используется POST запрос на соответствующий endpoint API.

В теле запроса вы передаёте массив данных в формате JSON, где для каждого артикула (nmID) указываются обновляемые характеристики. За разрешительные документы обычно отвечают поля с названиями вроде «Декларация о соответствии» или «Сертификат соответствия». Точное название поля можно найти в спецификации категории вашего товара, выгрузив шаблон.

Шпаргалка по API

Метод для обновления характеристик: https://suppliers-api.wildberries.ru/content/v1/cards/update

Пример тела запроса (JSON) для одной карточки:

[
  {
    "nmID": 12345678,
    "characteristics": [
      {
        "id": 9876, // ID характеристики "Декларация о соответствии"
        "value": "ЕАЭС N RU Д-RU.А500C.В.01234/23"
      },
      {
        "id": 9877, // ID характеристики "Срок действия сертификата"
        "value": "2025-12-31"
      }
    ]
  }
]

Чтобы узнать id нужной характеристики («Декларация соответствия», «Отказное письмо»), нужно сначала получить список всех характеристик для вашей категории через метод .../content/v1/directory/charcs.

Это базовый пример. Для массового обновления вы формируете такой JSON для сотен или тысяч карточек и отправляете одним запросом. Возражение «а вдруг сервис сломает карточку» здесь нерелевантно: вы точечно обновляете конкретные поля, не затрагивая описание, фото или цены.

Автоматизация через МЕТЧ: от ручного ввода к автопилоту

Прямая работа с API требует ресурсов разработчика. Нужно написать скрипт, предусмотреть обработку ошибок, логирование, настроить сервер для его запуска. Это долго и дорого.

Мы в МЕТЧ создали сервис, который берёт эту работу на себя. Вы загружаете свои сертификаты и декларации в нашу систему, а мы автоматически связываем их с вашими товарами и прописываем номера в карточки на Wildberries через тот же Content API.

Как это работает в МЕТЧ

1. Подключение. Вы вставляете свой токен Контент WB в настройках МЕТЧ. Сервис получает доступ к вашим карточкам.
2. Загрузка документов. Вы загружаете PDF-файлы сертификатов, деклараций или отказных писем в хранилище МЕТЧ. Система распознаёт их номера и сроки действия.
3. Связывание (мэтчинг). Вы один раз указываете, каким товарам (по артикулу или ТН ВЭД коду) соответствует каждый документ.
4. Автозапись. МЕТЧ формирует запросы к API Wildberries и автоматически прописывает номера документов в нужные поля характеристик.
5. Контроль. Сервис регулярно проверяет, что данные в карточке на WB соответствуют данным в МЕТЧ. Если маркетплейс по какой-то причине сбросил значение, МЕТЧ запишет его снова.

Шаги с таймером (процесс с МЕТЧ на каталоге 5000 SKU)

• Подключение кабинета WB: 1 минута.
• Массовая загрузка 50 сертификатов: 5 минут.
• Автоматическое связывание 5000 SKU с 50 документами по кодам ТН ВЭД: ~10-15 минут.
• Запуск и выполнение задачи на запись данных в WB: ~30 минут (зависит от скорости ответа API WB).

Общее время: менее 1 часа. Вместо 165 часов ручной работы. Вы экономите ~99% времени.

Наш тариф «Селлер» позволяет полностью закрыть эту задачу даже для небольшого каталога, снимая возражение «у нас мало товаров, справимся руками». Посчитайте стоимость одного часа работы вашего сотрудника — и экономия станет очевидной.

Кейс: автоматизация каталога поставщика косметики

Проблема: Клиент, продавец корейской косметики, столкнулся с массовыми блокировками карточек. Каталог из более 10 000 SKU требовал постоянного обновления номеров деклараций соответствия. Контент-менеджер физически не успевал отслеживать сроки и вносить изменения вручную. Продажи падали, а риск получения штрафов рос.

Решение:

1. Клиент подключил свой кабинет Wildberries к МЕТЧ через Content API.
2. В систему были загружены все действующие декларации соответствия.
3. С помощью нашего инструмента для массового связывания все товары были привязаны к соответствующим документам по брендам и первым цифрам артикулов.
4. Была запущена задача автоматической записи номеров ДС в карточки.

Результаты:

• Все карточки были обновлены в течение нескольких часов.
• Время, затрачиваемое на управление сертификатами, сократилось с десятков часов в месяц до одного.
• За последующие 6 месяцев — 0 блокировок карточек по причине отсутствия или некорректного номера ДС.
• Освободившееся время контент-менеджер направил на SEO-оптимизацию карточек, что привело к росту позиций в выдаче.

Сравнение подходов: Ручной ввод vs. Прямая интеграция API vs. МЕТЧ

Для селлера есть три пути решения задачи. У каждого свои плюсы и минусы.

Возражение «у нас 1С, мы не хотим переезжать» снимается просто. МЕТЧ — облачный сервис. Он не требует отказа от вашей учетной системы. Он подключается к маркетплейсу напрямую и работает параллельно.

Если вы устали от рутины, рисков блокировок и потерь продаж из-за просроченных документов, автоматизация — это не опция, а необходимость. Работа через Content API — это стандарт для любого растущего селлера. Вопрос лишь в том, будете ли вы строить это решение с нуля или воспользуетесь готовым инструментом, который уже доказал свою эффективность на тысячах SKU.

Наша задача в МЕТЧ — превратить управление комплаенсом из головной боли в фоновый автоматизированный процесс. Чтобы вы могли сфокусироваться на главном — на развитии вашего бизнеса.

Попробуйте МЕТЧ бесплатно на 7 дней и оцените, сколько времени и ресурсов он высвободит для вашей команды.