Зачем нужен запас кодов
Цифровой товар продаётся не остатком на складе, а кодом активации: покупатель получает код, по которому активирует товар у поставщика. Плагин умеет брать такие коды из запаса и передавать их в заказ Маркета автоматически.
Запас ведёт отдельный плагин «Управление товарными кодами». Без него плагин тоже работает, но коды в заказ добавляются вручную, а автопередача и учёт свободных кодов недоступны.
Виды кодов
Коды в запасе разделены по видам — например, «Код активации», «Пин-код», «Ссылка на скачивание». В настройках вкладки «Заказы и статусы» выбирается вид кода, который передаётся в Маркет. Если у товаров разные виды кодов, они должны быть одного вида либо ведутся вручную: настройка одна на аккаунт.
Сколько кодов нужно
Количество кодов определяется позициями заказа: на каждую единицу цифрового товара нужен один код. Если в позиции две единицы, передаются два кода.
Когда кодов не хватает, плагин не передаёт частичный набор: в истории заказа появляется «В заказе не хватает кодов: нужно N, добавлено M», а автопередача считается неудачной и запускает действие из настройки «Действие при неудачной автопередаче». Пополнение запаса решает причину: при следующем опросе коды уйдут.
Свободные коды как остаток
Если в настройке «Источник остатка товара» выбрать «Количество свободных кодов», в Маркет уходит число свободных кодов по артикулу. Это удобно для цифровых товаров: в Маркете видно, сколько покупок ещё можно обслужить.
Такой остаток меняется сам: после каждой передачи кодов их становится меньше, после пополнения запаса — больше. Отдельно обновлять остаток вручную не нужно, команда update отправит изменение при следующем запуске.
Пополнение запаса
- Откройте плагин «Управление товарными кодами» и добавьте коды для товара или артикула — списком, из файла или через API плагина.
- Проверьте, что вид кода совпадает с выбранным в настройках плагина.
- Если коды использовались в тестовых заказах, прибавьте их к запасу: тестовые заказы списывают реальные коды.
Что видно в заказе
В карточке заказа блок Яндекс Маркета показывает, сколько кодов требуется и сколько передано. Сами значения кодов в интерфейсе не отдаются — ни в списке заказов, ни в карточке: они видны покупателю в письме Маркета и в кабинете продавца.

