Склад ключей для маркетплейсов: как исключить двойную выдачу

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

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

Почему таблицы приводят к повторной выдаче ключей

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

Типичная ошибка выглядит так: продавец загрузил одну партию кодов в два кабинета, чтобы продавать один товар на Ozon и Wildberries. После первого заказа площадка списала код только в своём кабинете, а во втором этот же код остался доступным. Следующий покупатель получил уже использованную комбинацию.

Даже если склады разделены вручную, остаются другие риски:

• сотрудник скопировал код, но забыл удалить строку или изменить статус;
• два менеджера одновременно открыли таблицу и выбрали одну позицию;
• фильтр скрыл часть строк, из-за чего использованный ключ снова попал в рабочий диапазон;
• после отмены заказа код вернули в продажу без проверки, был ли он показан покупателю;
• резервная копия таблицы случайно стала новым рабочим файлом;
• ключи из одной партии загрузили в разные товары или вариации.

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

Если ошибки уже происходят не только со складом, полезно проверить и остальные этапы обработки заказа. Основные сценарии разобраны в материале про проблемы с заказами на маркетплейсе.

Как устроить склад ключей для маркетплейсов

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

Для каждого кода нужен как минимум следующий набор данных:

• уникальный внутренний идентификатор - не зависит от текста ключа и не меняется при импорте;
• товар - карточка или внутренний SKU, для которого разрешена выдача;
• значение - ключ, промокод, логин с паролем или другой цифровой товар;
• статус - свободен, зарезервирован, выдан, заблокирован или требует проверки;
• партия - поставщик, дата поступления или внутренний номер закупки;
• заказ - площадка и номер заказа, которому выдан код;
• время изменения - когда позиция была зарезервирована или окончательно списана.

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

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

Как подготовить коды перед загрузкой

Хранение ключей активации в исходной партии

До импорта сохраните исходный файл отдельно от рабочего склада. Он нужен для сверки с поставщиком, но не должен использоваться менеджерами для выдачи заказов. Ограничьте доступ и не пересылайте такой файл в общие чаты.

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

Перед загрузкой выполните четыре проверки:

1. Удалите пустые строки, заголовки, комментарии поставщика и случайные пробелы в начале или конце значения.
2. Найдите полные дубликаты внутри партии и сравните её с ранее загруженными кодами.
3. Проверьте допустимые символы, регистр и разделители. Не преобразуйте ключи в числа, иначе таблица может убрать начальные нули.
4. Отберите несколько позиций и вручную сверьте их с исходным файлом.

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

Как оформить базу кодов для продажи

Не помещайте в одну строку несколько ключей, если покупатель должен получить только один. Исключение возможно для комплекта, который всегда продаётся целиком: например, логин, пароль и резервный код. Тогда весь комплект считается одной складской позицией.

Добавьте к партии понятное внутреннее имя. Например: Антивирус-1-год-2026-10-поставщик-А. Это пример формата, а не обязательное правило. По такому имени проще найти источник спорного ключа и временно остановить выдачу всей партии.

Секретные значения не стоит хранить в описании товара, заметках к заказу или документах с открытым доступом. Рабочее хранилище должно ограничивать права сотрудников и защищать данные от просмотра теми, кому они не нужны.

Как разделить запас между товарами и вариантами

Каждая карточка маркетплейса должна быть связана с конкретным внутренним товаром. Нельзя направлять заказы разных продуктов в общий список только потому, что ключи выглядят одинаково. Отличаться могут срок действия, регион, платформа, номинал, версия программы или состав комплекта.

Для примера, ключ на 30 дней и ключ на 365 дней нужно завести как два товара, даже если их выпустил один поставщик. То же относится к вариантам для Windows и macOS, разным регионам активации и номиналам подарочных карт.

Используйте внутренний SKU, который не меняется при редактировании названия карточки. Затем составьте карту соответствий:

• внутренний SKU товара;
• площадка;
• идентификатор или артикул карточки на площадке;
• вариант товара, если он существует;
• склад или группа кодов, из которой разрешено списание.

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

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

Как загрузить ключи списком и проверить импорт

Массовый импорт безопаснее ручного копирования, если перед подтверждением система показывает количество строк, дубликаты и ошибки формата. Сначала загрузите небольшую тестовую партию. Например, 5 кодов, а не сразу весь запас из нескольких тысяч позиций.

Порядок загрузки выглядит так:

1. Создайте внутренний товар и проверьте его название, SKU, вариант и инструкцию покупателю.
2. Выберите формат импорта: вставка списка или загрузка XLSX.
3. Укажите, какая колонка содержит выдаваемое значение. Если импортируется комплект, проверьте порядок полей.
4. Запустите предварительную проверку и изучите сообщения о пустых строках, совпадениях и неверном формате.
5. Подтвердите импорт и сравните число новых свободных позиций с количеством уникальных строк в файле.
6. Оформите тестовый заказ или используйте предусмотренный системой режим проверки, затем убедитесь, что выданная позиция исчезла из свободного остатка.

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

Для регулярных продаж удобнее единый склад КОВАЛС.iO: сервис поддерживает массовый импорт ключей списком или из XLSX, а общий запас можно использовать для заказов с Яндекс Маркета, Wildberries, Ozon и Etsy. Через регистрацию можно настроить выдачу ключей без ручной работы и не копировать одну партию в несколько кабинетов.

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

Как безопасно выдавать ключи на нескольких площадках

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

Безопасный сценарий выдачи состоит из следующих действий:

1. Система получает оплаченный заказ от площадки.
2. Проверяет, не был ли этот заказ обработан ранее.
3. Находит товар по заранее настроенному соответствию.
4. Резервирует одну свободную позицию только за этим заказом.
5. Передаёт ключ покупателю предусмотренным для площадки способом.
6. Фиксирует результат выдачи, время, канал и идентификатор заказа.

Если передача покупателю временно не удалась, нельзя сразу возвращать зарезервированный ключ в свободный остаток. Сначала нужно выяснить, мог ли клиент увидеть значение. Безопаснее оставить позицию в резерве или перевести её в статус проверки, чем повторно продать потенциально раскрытый код.

При отмене действует тот же принцип. Если ключ ещё не был показан покупателю, его можно освободить после проверки журнала. Если значение уже передано, возврат на склад создаёт риск двойной продажи, даже когда сам заказ формально отменён.

Способ доставки отличается у разных маркетплейсов, а их требования могут меняться. Перед запуском сверяйтесь с актуальной справкой площадки и проверяйте реальный путь покупателя. Общий принцип автоматической обработки подробнее описан в статье про автовыдачу цифровых товаров.

Как контролировать использованные позиции и остатки

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

В журнале полезно видеть:

• какой товар заказал покупатель;
• какая складская позиция была зарезервирована;
• с какой площадки поступил заказ;
• когда ключ передали покупателю;
• была ли повторная попытка обработки;
• кто вручную менял статус, если такое действие разрешено;
• из какой партии пришёл код.

Остаток нужно контролировать не только общим числом. Смотрите свободные, зарезервированные, выданные и заблокированные позиции отдельно. Большое число зависших резервов может означать ошибку интеграции, а рост заблокированных кодов - проблему с конкретной партией.

Установите порог предупреждения для каждого товара с учётом обычной скорости продаж и времени пополнения. Например, уведомление при остатке 20 кодов является лишь примером: для товара с одним заказом в неделю это избыточный запас, а при десятках заказов в день предупреждение придёт слишком поздно.

В КОВАЛС.iO остатки и заказы с подключённых площадок собираются в одном кабинете, а уведомления и ежедневный отчёт можно получать в Telegram или MAX. Это помогает контролировать единый запас и автовыдачу, не сверяя вручную несколько кабинетов после каждого заказа.

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

Практическая проверка склада перед запуском

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

1. Подготовьте небольшую партию уникальных тестовых значений.
2. Загрузите её в один внутренний товар и проверьте число свободных позиций.
3. Свяжите товар с одной карточкой площадки.
4. Проведите тестовый заказ допустимым правилами площадки способом.
5. Убедитесь, что выданный ключ получил статус выданного и связан с номером заказа.
6. Повторите обработку того же события и проверьте, что новый ключ не списался.
7. Смоделируйте два почти одновременных заказа и убедитесь, что они получили разные позиции.
8. Подключите остальные площадки к тому же внутреннему товару и повторите проверку.

Дополнительно проверьте права сотрудников. Менеджеру может быть нужен просмотр заказов, но не экспорт полного склада или возврат выданных кодов в продажу. Чем меньше ручных действий доступно без подтверждения, тем ниже риск случайной повторной выдачи.

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

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