Как импортировать подарочные карты

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

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

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

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

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

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

   Поле	Обязательно	Описание
   Номер карты	✅	Уникальный номер подарочной карты
   Системное имя пула	✅	Системное имя пула, к которому относится карта. Пул должен быть заранее создан на проекте
   CVV подарочной карты	❌	Обязательно для пулов, в которых включена передача CVV
   Баланс карты	✅	Для карт с фиксированным номиналом баланс должен быть равен номиналу пула
   Внешний идентификатор точки контакта	❌	Точка контакта, в которой была выдана карта. Используется при регистрации карт, проданных в прошлом
   Дата покупки карты в часовом поясе UTC	❌	Дата и время выдачи карты по UTC. Используется при регистрации карт, проданных в прошлом. Для пулов с фиксированным сроком действия срок действия карты считается от этой даты
   Статус подарочной карты	❌	Текущий статус карты. Если поле не передано, карте присваивается статус «Не активирована» Допустимые статусы карт: CanBeUsed — активирована. Карту можно использовать для оплаты заказа. Продавать такие карты нельзя. Inactive — не активирована. Карту можно продавать. После продажи карта станет активированной и ее можно будет использовать для оплаты заказа. Blocked — заблокирована. Карту нельзя продавать и использовать для оплаты.

   Чтобы зафиксировать выдачу карты в прошлом, передайте одновременно: точку контакта, дату покупки и статус CanBeUsed.

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

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

   

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

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

   

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

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

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

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

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

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

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

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

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

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

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

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