Как импортировать пулы подарочных карт

Подготовьте файл в корректном формате и загрузите его, чтобы массово создать пулы подарочных карт на проекте. Пул — это группа карт с общими параметрами: номиналом, сроком действия, правилами гашения. Каждая подарочная карта в Mindbox обязательно принадлежит какому-либо пулу.

Пулы позволяют:

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

Импорт выполняется в разделе Настройки → Импорт. Нажмите «Новый импорт» для перехода к настройкам:

Шаг 1. Выберите действие с даннымиШаг 1. Выберите действие с данными

1. Выберите тип импорта — «Лояльность → Пулы подарочных карт».
2. Выберите действие — «Добавить пулы подарочных карт».

Шаг 2. Подготовьте и загрузите файлШаг 2. Подготовьте и загрузите файл

1. Определите, какие поля нужно загрузить. В файле должны присутствовать все обязательные поля.

   Поле	Обязательно	Описание
   Название пула подарочных карт	✅	Отображаемое название пула в интерфейсе Mindbox
   Системное имя пула подарочных карт	✅	Уникальное системное имя пула. Используется при импорте подарочных карт и в интеграциях
   Поддерживает произвольную стоимость подарочных карт в пуле подарочных карт	✅	true — карты в пуле могут иметь произвольный номинал; false — карты имеют фиксированный номинал, указанный в поле «Стоимость карт в пуле»
   Поддерживает частичное гашение подарочных карт в пуле подарочных карт	✅	true — картой можно оплачивать заказ частично, остаток сохраняется на балансе; false — карта гасится полностью при первой оплате
   Внешний идентификатор продукта	✅	Внешний идентификатор технического продукта, который будет создан для пула
   Внешняя система технического продукта	✅	Внешняя система, к которой будет привязан технический продукт пула
   Бренд технического продукта	✅	Бренд, к которому будет привязан технический продукт пула
   Требование CVV для подарочных карт в пуле подарочных карт	✅	true — при операциях с картами требуется указывать CVV; false — CVV не требуется
   Стоимость карт в пуле подарочных карт	Обязательно для пулов с фиксированной стоимостью	Номинал карт
   Тип срока действия подарочных карт в пуле подарочных карт	❌	Допустимые значения: NoExpiration — без срока действия; Year — срок действия в годах. По умолчанию — NoExpiration
   Срок действия подарочных карт в пуле	❌	Целое число от 1 до 10. Используется, когда «Тип срока действия» = Year

   Параметры пула зафиксируются после импорта. Изменить их в дальнейшем будет нельзя — карты, выпущенные в пуле, унаследуют эти настройки.

2. Выгрузите данные из внешней системы и подготовьте файл для загрузки. В первой строке произвольно укажите названия полей.

   • Формат — .csv или .txt.
   • Рекомендуемая кодировка — UTF-8.
   • Проверьте, что значения соответствуют допустимым форматам, а системные имена пулов уникальны.

   

   Рекомендации по подготовке и сохранению файла.

3. Загрузите файл для импорта и нажмите «Продолжить»:

   

Шаг 3. Сопоставьте поля файлаШаг 3. Сопоставьте поля файла

Система автоматически сопоставляет колонки файла с полями в Mindbox. При необходимости скорректируйте сопоставление:

1. В колонке «Импорт» отметьте галочками поля, которые нужно загрузить. Колонки без галочки будут пропущены.
2. В колонке «Поле Mindbox» сопоставьте каждую колонку файла с полями проекта. Необязательные поля без сопоставления будут пропущены.
3. Нажмите «Продолжить»:

Шаг 4. Проверьте и запустите импортШаг 4. Проверьте и запустите импорт

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

Если все верно — нажмите «Запустить импорт».

Как отслеживать импортКак отслеживать импорт

После запуска импорт появится в списке на странице «Импорт». По каждой задаче отображаются:

• дата запуска,
• тип импорта,
• кто запустил.

Если в ходе импорта возникли ошибки — часть строк была пропущена. Откройте детали импорта, чтобы посмотреть, какие строки вызвали проблему и почему. Исправьте ошибки в файле и запустите импорт повторно.

Результат импортаРезультат импорта

После успешного завершения задачи пулы подарочных карт появятся в разделе Кампании → Лояльность → Пул подарочных карт. Для каждого пула автоматически создается технический продукт, который используется при продаже и оплате картами:

Далее можно загрузить в созданные пулы подарочные карты по инструкции.