Генерация штрихкодов Маркета через API: как сохранить готовые коды и разобрать частичный результат
Как применять generateOfferBarcodes Яндекс Маркета, не создавать код поверх штрихкода производителя и проверить unprocessedOfferIds после ответа 200.
Содержание статьи
Метод генерации штрихкодов помогает заполнить недостающие идентификаторы, но успешный HTTP-ответ ещё не означает обработку каждого товара. Интеграция должна проверять список неготовых SKU и сохранять связь полученных кодов с реальными упаковками.
Сначала проверьте, нужен ли новый код
Документация рекомендует передавать существующий штрихкод производителя через поле barcodes метода обновления товаров. Генерировать новый поверх него не нужно. Генерация выполняется для кабинета по businessId, а список offerIds содержит от 1 до 100 уникальных SKU.
Перед запуском разделите позиции с реальным кодом на упаковке и товары без него. Сверяйте не только базовую модель, но и продаваемую единицу: отдельный предмет и набор могут требовать разных записей в учёте. Не запускайте массовую генерацию как средство исправить любые ошибки распознавания карточки.
Сохраните смысл skipIfExists
Параметр skipIfExists по умолчанию равен true: генерация применяется только к товарам без штрихкода. При false обрабатываются все переданные позиции. Это существенная настройка задания, которую нельзя менять ради повторной попытки без понимания результата.
Сохраните список SKU и выбранный режим перед запросом. Для первого запуска возьмите небольшую контрольную группу с разными исходными состояниями. Проверьте, что уже согласованный код остался связан с нужным товаром, а интеграция не заменила собственную таблицу соответствий пустыми значениями.
Читайте содержимое ответа, а не только 200
Успешный ответ может быть пустым, если все товары обработаны, либо содержать result.unprocessedOfferIds. Для перечисленных позиций код создать не удалось. Документация предлагает проверить offerId и обратиться в поддержку при повторяющейся ошибке.
Записывайте результат по каждому SKU. Не отправляйте весь пакет повторно с другим режимом, если проблема касается двух строк. Сначала проверьте существование этих товаров и правильность идентификаторов. Пакетное задание удобно считать завершённым только после распределения всех позиций на обработанные и требующие решения.
Свяжите результат с печатью этикеток
После обработки перечитайте данные каталога и передайте актуальные соответствия в используемую систему печати. Проверьте физический образец сканером: считанное значение должно относиться к тому же товару и упаковке, что указаны в задании. Это самостоятельная складская проверка, которой ответ API не заменяет.
Если параллельно меняются артикулы, используйте порядок согласования SKU между системами. Генерация штрихкода и переименование артикула решают разные задачи. Их результаты нужно связать явно, иначе правильный новый код может оказаться напечатан на этикетке другой позиции.
Справка проверена редакцией 12 октября 2026 года. Это дата проверки действующих инструкций, а не запуска функции.
Материал отражает сведения на указанную дату. Правила и условия работы площадок могут измениться. Редакционные принципы