30 сентября 2026 года в WB API появились методы получения списка кодов ТН ВЭД, списка ОКПД2 и кода ОКПД2 для предмета. Обновление позволяет разработчикам получать справочные данные программно и использовать их при подготовке товарного каталога.

Что дают новые справочники

Wildberries перечислил три новых адреса: GET /api/content/v2/directory/tnved/all, GET /api/content/v2/directory/okpd и GET /api/content/v2/directory/okpd/all. Они относятся к работе с карточками товаров. Для продавца ключевой результат — возможность встроить справочные значения в собственную форму ввода или проверку данных перед отправкой на площадку.

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

Как использовать обновление в каталоге

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

При наличии ERP или PIM полезно хранить происхождение значения. Для каждой позиции должно быть понятно, кто назначил код, когда его проверяли и на какой документ опирались. Внешний справочник затем используется для валидации формата и наличия значения. Он не должен без согласования переписывать уже подтверждённую классификацию во всей учётной системе.

Почему нужна история изменений

Обновление справочных данных может затронуть большое число карточек. Если интеграция просто перезаписывает локальную таблицу, команда не увидит, какие значения исчезли или изменили связь с предметом. Лучше сначала формировать сравнительный отчёт: новые записи, отсутствующие прежние записи и позиции каталога, на которые это влияет.

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

Проверка перед включением автоматизации

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

После запуска контролируйте возраст локальной копии справочника и число карточек, которые не прошли проверку. Для сотрудника полезно показывать понятную причину: значение отсутствует, связь требует уточнения или недостаёт исходных документов. Такой процесс превращает новый API-доступ в инструмент управления качеством каталога, а не просто ещё одну регулярно скачиваемую таблицу.