Подтверждение маркировки kizMarked в карточках Wildberries
С 9 апреля 2026 года WB API принимает параметр kizMarked в методах создания и обновления карточек. Значение true подтверждает, что на товар нанесён обязательный код маркировки. При значении false, которое используется по умолчанию, карточка товара с обязательной маркировкой отклоняется модерацией и блокируется. Сначала интеграции требуется понять, относится ли правило к конкретной позиции.
Метод POST /content/v2/get/cards/list возвращает поле needKiz: true означает, что товару нужен код маркировки. В том же ответе видно текущее значение kizMarked, поэтому можно найти карточки с расхождением и подготовить исправление. Подтверждение передаётся в POST /content/v2/cards/upload при создании карточек, в POST /content/v2/cards/upload/add при добавлении номенклатуры и в POST /content/v2/cards/update при обновлении.
Мы связываем эти поля с фактическим источником в PIM, ERP или товароучётной системе. Сотрудник отмечает подтверждённое нанесение кода в привычном процессе, а интеграция отправляет true лишь для соответствующей позиции. Спорные товары попадают в отдельный список вместо массовой публикации с одним значением для всего каталога.
В результате компания заранее видит карточки с needKiz, контролирует передаваемый kizMarked и понимает причину ответа Wildberries. Работа относится к карточке и её модерации. Коды конкретного заказа FBS или DBS обрабатываются на другом этапе, поэтому эти процессы остаются раздельными и дают сотрудникам понятные точки контроля.
Когда стоит обратиться
Обычно к нам обращаются в таких ситуациях:
- Маркируемая карточка получает отказ модерации, хотя сведения о товаре и категория заполнены корректно.
- Выгрузка создавалась до появления kizMarked и отправляет значение false по умолчанию для всех товаров.
- Признак нанесённого кода хранится в PIM, ERP или таблице, а в карточках Wildberries подтверждается вручную.
- Команде нужен реестр товаров с needKiz и понятный контроль результата массового обновления.
Что именно мы сделаем
Собираем примеры карточек Wildberries и находим места, где интеграция создаёт, дополняет и обновляет товары.
Загружаем needKiz и текущее kizMarked из списка карточек и связываем данные с номенклатурой клиента.
Добавляем подтверждённый источник признака маркировки и правило передачи kizMarked в нужные методы WB API.
Создаём список исключений, журнал запросов и понятные сообщения для карточек, которым требуется проверка сотрудника.
Проводим публикацию контрольных товаров и передаём протокол модерации, карту полей и порядок повторной отправки.
Что входит в стоимость
39 900 ₽ за всю работу
Проверяем текущую выгрузку карточек и источник сведений о маркировке. Добавляем чтение needKiz через список карточек, правило формирования kizMarked для методов создания и обновления, журнал запросов и контроль спорных позиций. Проводим тесты для новой карточки, дополнения номенклатуры, обновления и повторной выгрузки после ошибки.
Что будет готово
Передадим вам
- Обновлённая интеграция карточек Wildberries с needKiz и передачей kizMarked в методы создания и изменения.
- Правило связи подтверждения маркировки с полем или статусом PIM, ERP либо товароучётной системы.
- Реестр карточек с nmID, артикулом, needKiz, kizMarked, результатом отправки и причиной исключения.
- Протокол контрольных публикаций, карта полей и инструкция повторной проверки через cards/list.
Перед сдачей проверим
- Интеграция получает needKiz и текущее kizMarked для контрольных карточек и правильно связывает их с товарами клиента.
- Карточка с подтверждённым нанесением кода отправляется с kizMarked=true через соответствующий метод WB API.
- После обработки повторное чтение показывает ожидаемое значение, а журнал содержит товар, метод и результат запроса.
- Спорная позиция попадает в реестр исключений и даёт сотруднику достаточно данных для проверки и повторной отправки.
Как это выглядит на практике
Маркируемый товар проходит модерацию после обновления выгрузки
- 01
Интеграция читает карточки и видит needKiz=true при текущем kizMarked=false у товара из каталога.
- 02
Ответственный подтверждает нанесение кода в выбранном поле товароучётной системы.
- 03
Очередь отправляет cards/update с kizMarked=true и сохраняет результат Wildberries рядом с артикулом.
- 04
Повторный cards/list подтверждает новое состояние, а карточка уходит в обычный маршрут модерации.
Что понадобится для работы
От вас
- Доступ к коду или настройкам интеграции, которая создаёт и обновляет карточки Wildberries.
- Персональный или сервисный токен WB API с подходящей категорией доступа для работы с контентом.
- Контрольная выборка товаров: обычный товар, маркируемая позиция, карточка с ошибкой и успешно опубликованный пример.
- Описание источника, которым компания подтверждает нанесение обязательного кода маркировки на товар.
Если у вас немного другая ситуация
Небольшие уточнения, которые помогают довести согласованный результат до рабочего состояния, уже учитываем в цене. Если по ходу работы появится отдельный крупный блок или понадобится платная лицензия, сначала обсудим варианты и стоимость. Расскажите о своей ситуации — подстроим план под неё.
- 3 000 ₽после подписания договора через Диадок
- 36 900 ₽после выполнения, демонстрации и приёмки результата
Предоплата входит в общую стоимость. Оставшуюся сумму оплачиваете после демонстрации и приёмки готовой работы.
Часто спрашивают
Об этой услуге
Что означает поле needKiz в карточке Wildberries?
Поле needKiz в ответе cards/list показывает требование обязательного кода маркировки для товара. Значение true используется интеграцией как сигнал проверить подтверждённый источник перед отправкой kizMarked.
Что подтверждает значение kizMarked=true?
Оно подтверждает Wildberries, что на товар нанесён обязательный код маркировки. Интеграция передаёт это значение после выбранного факта в PIM, ERP, учётной системе или рабочем процессе клиента.
В какие методы добавляется kizMarked?
Параметр поддерживается в POST /content/v2/cards/upload, POST /content/v2/cards/upload/add и POST /content/v2/cards/update. Конкретный метод зависит от создания, дополнения или изменения карточки.
Почему карточка блокируется при значении false?
Для товара с обязательной маркировкой значение false означает отсутствие подтверждения нанесённого кода. По правилам WB API такая карточка отклоняется на модерации и блокируется до корректного обновления.
Можно обновить уже созданные карточки?
Да. Сначала читаем needKiz и текущее состояние, затем формируем обновление для подтверждённых товаров и повторно проверяем результат через cards/list.
Подтверждение в карточке заменяет передачу кодов в заказе?
Эти процессы относятся к разным этапам. kizMarked работает с товарной карточкой и модерацией, а IMEI, УИН, SGTIN и другие данные конкретного заказа передаются в сценариях сборки и отгрузки.
Как избежать массовой отправки ошибочного подтверждения?
Правило требует подтверждённого источника для каждой позиции и учитывает needKiz. Неопределённые товары попадают в реестр исключений, а контрольная выборка проходит до массового обновления.
Как принимается готовая работа?
Проверяем создание, дополнение и обновление контрольных карточек, читаем итог через cards/list и сопоставляем его с журналом. Для каждой позиции видны needKiz, переданный kizMarked и результат обработки.
Цена и изменения по ходу работы
Цена на странице окончательная?
Да. Перед началом мы сверяем исходные данные и фиксируем результат в договоре. Указанная на странице сумма покрывает согласованную работу целиком, даже если её техническая реализация потребует больше времени, чем ожидалось при оценке.
Что означает резерв незапланированных работ?
Это уже включённый в цену запас времени на небольшие связанные уточнения заказчика, которые появляются после старта: например, добавить поле, изменить формат уведомления или учесть ещё одно условие обработки.
Резерв рассчитывается по формуле: стоимость услуги × 30% ÷ 1 500 ₽. Для услуги за 30 000 ₽ это 6 часов. Эти часы относятся только к дополнительным, заранее незапланированным уточнениям. Они не являются сроком проекта и не ограничивают время на основную работу: согласованный результат мы выполняем полностью.
Можно уточнять детали уже во время работы?
Да. Небольшие связанные изменения обычно помещаются во включённый резерв и не требуют доплаты. Если новая идея заметно меняет результат или превращается в самостоятельную задачу, сначала обсудим подход и стоимость. Любое решение согласуем до выполнения.
Начало работы и оплата
Как оформляются договор и оплата?
Подписываем договор через Диадок. Предоплата составляет 3 000 ₽ и входит в общую стоимость услуги. Остаток оплачивается после демонстрации и приёмки готового результата.
Когда начинается срок выполнения?
Срок отсчитывается после согласования задачи, получения необходимых доступов и материалов, подписания договора и поступления предоплаты. Конкретную дату старта и плановый день готовности подтверждаем перед началом.
Как учитываются платные лицензии и внешние сервисы?
До старта проверяем, нужны ли тарифы, лицензии, сертификаты или дополнительные ресурсы внешних систем. Если они потребуются, заранее покажем варианты и стоимость. По возможности аккаунты и лицензии оформляются сразу на заказчика.
Проверка результата и гарантия
Как принимается готовая работа?
Вместе проверяем согласованные сценарии на контрольных данных или тестовой копии, а затем демонстрируем результат. Для интеграций сверяем передачу данных и обработку ошибок, для сайта — работу нужных страниц и действий пользователя, для отчёта — расчёты и обновление данных.
Какая гарантия действует после сдачи?
На выполненные изменения действует гарантия 3 месяца. Если в изменённой нами части обнаружится ошибка нашей реализации, проверим и исправим её без дополнительной оплаты. Переданные материалы, настройки и код остаются у заказчика.
Связанные шаги
- 01Карточки «Честного знака» в Национальном каталоге по API
Подготовить товарные данные в Национальном каталоге
- 02Подтверждение маркировки kizMarked в карточках Wildberries
Передать подтверждение kizMarked в карточки Wildberries
- 03Обновление Wildberries FBS/DBS под IMEI, УИН и маркировку
Настроить IMEI, УИН и маркировку на этапе отгрузки WB