Товарные коды в API Маркета: как различать ОКПД2 и ТН ВЭД при обмене
Как проверить commodityCodes в API Яндекс Маркета: тип и значение кода, формат ОКПД2 и замена устаревшего customsCommodityCode без потери данных.
Содержание статьи
Товарный код в API Маркета передаётся вместе с его типом. Одной колонки «код товара» недостаточно, если в ней смешаны ОКПД2 и ТН ВЭД. Руководство редакционно проверено 15 октября 2026 года и описывает техническую сверку уже подтверждённых сведений.
Проверьте структуру обмена
Массив commodityCodes содержит объекты с полями type и code. CUSTOMS_COMMODITY_CODE обозначает ТН ВЭД, OKPD2_CODE — ОКПД2. Тип IKPU_CODE относится к классификатору продукции и услуг Узбекистана: его наличие в общей схеме API не делает этот код российским требованием. Документация запрещает несколько кодов одного типа.
Редакционная рекомендация — разделить в учётной системе идентификатор SKU, вид классификатора и его значение. При передаче в интеграцию сохраняйте все три элемента. Правильная последовательность цифр с неверным type описывает другие данные, даже если исходный файл выглядит заполненным.
Сохраните формат подтверждённого кода
Для ТН ВЭД документация указывает 10 или 14 цифр без пробелов. ОКПД2 допускает 2, 3, 4, 5, 6 или 9 цифр с точками между установленными группами. Поддержку необязательного OKPD2_CODE Маркет добавил в описание методов 10 сентября 2026 года; это не объявление нового обязательного реквизита для всех товаров.
До загрузки сравните значение с документом или справочником, по которому его подтвердил ответственный специалист. Не выбирайте классификацию автоматически по похожему названию позиции. Задача интегратора — сохранить согласованные сведения, а вопрос их применимости к конкретной продукции решается отдельно.
Проверьте замену старого поля
В документации customsCommodityCode отмечен как устаревший с указанной датой отключения 12 октября 2026 года. Его замена — commodityCodes с типом CUSTOMS_COMMODITY_CODE. Это описание контракта API; редакция не проверяла реальный ответ метода после даты отключения.
Попросите разработчика показать, откуда программа берёт значение и куда его записывает. Для контрольного SKU сравните исходные сведения и прочитанный ответ каталога. Отсутствие старого поля не должно превращаться в удаление известного кода из внутренней базы или в подстановку другого классификатора.
Как принять результат переноса
Редакционная рекомендация — выбрать товары с разными подтверждёнными типами кодов и позицию без соответствующих сведений. Проверьте, что программа сохраняет тип, формат и отсутствие данных там, где они действительно отсутствуют. Отдельно обработайте конфликт двух значений одного типа: не выбирайте первое без выяснения причины.
Не смешивайте такую проверку с учётом РНПТ и ГТД по партиям. Там задача — связать документы с конкретными единицами и количеством; здесь проверяется классификация товара в каталоге. Результатом должна стать понятная карта полей обмена и список исключений, которые переданы ответственному за товарные сведения.
Материал отражает сведения на указанную дату. Правила и условия работы площадок могут измениться. Редакционные принципы