Баркоды WB через API: как закрепить выданные коды за размерами товара
Как получить баркоды Wildberries через API и распределить их по размерам: реестр выдачи, повтор после сбоя, проверка карточки и передача подтверждённых кодов на печать.
Содержание статьи
Генерация баркодов через WB API возвращает набор идентификаторов, но не заменяет учёт того, какому товарному варианту назначен каждый код. До печати этикеток нужно связать выданные значения с размерами и подтвердить результат в карточках. Документация проверена 14 октября 2026 года.
Когда нужен генератор
Метод /content/v2/barcodes создаёт уникальные баркоды для размеров карточки, если у продавца нет собственных. В запросе указывают count; за один вызов документация допускает до 5 000 значений. Получение массива само по себе не создаёт карточку и не печатает этикетку.
Сначала составьте перечень новых вариантов. Отделите действительно новые размеры от существующих, которым уже назначены подтверждённые коды. Повторное создание идентификатора для прежнего варианта без рабочей причины усложняет связь каталога, этикеток и поставок.
Как вести реестр распределения
Редакционная рекомендация — сохранять выданный набор до следующих действий. Для каждого значения отметьте внутренний код товара, размер, цвет, дату получения и состояние назначения. Используйте собственный устойчивый идентификатор строки, а не только номер позиции в временно отсортированной таблице.
Например, учебная партия содержит два цвета и три размера каждого цвета. Реестр должен однозначно связывать шесть вариантов и шесть выбранных кодов. Если после сортировки размеров связь изменилась, печатать нельзя, даже когда все шесть чисел по-прежнему присутствуют в файле.
Что делать после неопределённого ответа
Не смешивайте ошибку генерации с ошибкой записи результата в вашу систему. При сбое сначала проверьте, сохранился ли полученный массив и использовались ли какие-либо значения дальше. Автоматический новый запрос без такого разбора способен оставить несколько неучтённых наборов.
Не приписывайте API гарантию повторной выдачи того же набора: в рассмотренном контракте она не заявлена. Внутренний процесс должен уметь фиксировать неизвестный исход и передавать его ответственному. Не назначайте один уже используемый код другому размеру ради быстрого закрытия задания.
Как передать коды в дальнейшую работу
После создания или изменения карточек сопоставьте записанные в них баркоды с реестром. Только подтверждённое соответствие передавайте на печать и подготовку поставки. Длинные цифровые значения храните как текст: Excel может менять идентификаторы при числовом преобразовании.
Печать проверяется отдельным проходом: значение, вариант, физическая этикетка и упакованная единица. Этот этап подробно разобран в проверке баркода перед поставкой. Успешная генерация решает задачу получения кода; правильность его использования подтверждается на каждом следующем шаге.
Материал отражает сведения на указанную дату. Правила и условия работы площадок могут измениться. Редакционные принципы