Импорт данных

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

Когда пригодится:

• миграция данных из другой системы,
• массовое исправление данных,
• загрузка данных для новых акций и кампаний.

Как работает импортКак работает импорт

1. Выберите тип импорта и действие с данными. См. раздел Виды импорта;

2. Определите, какие поля нужно передать:

   • Обязательные — основные данные, без них импорт не запустится;
   • «Обязательно, если» — нужно передать хотя бы одно поле из группы. Например, у клиента всегда быть указан email, мобильный телефон или один из идентификаторов;
   • Необязательные — дополнительные данные, необходимые в зависимости от задачи (дата рождения, дополнительные поля и т.п.).

3. Подготовьте файл импорта по требованиям;

4. Загрузите файл и сопоставьте его колонки с полями импорта.

   

5. Запустите импорт и отслеживайте его в списке импортов.

Требования к файлам импортаТребования к файлам импорта

Параметр файла	Значение
Формат	.csv или .txt
Кодировка	UTF-8, UTF-8 с BOM или Windows-1251
Разделитель	любой (например, запятая , или точка с запятой ;)
Текстовый квалификатор	любой (предпочтительнее двойные кавычки ")
Размер	до 1,5 ГБ
Имя файла	до 400 символов, не должно содержать символы \ / : * ? " < >

Доступ к предпросмотру файла и первым строкамДоступ к предпросмотру файла и первым строкам

На шаге Настройка и предпросмотр Mindbox показывает содержимое загруженного файла и первые строки данных.

Доступ к данным на вкладке есть:

• у автора импорта,
• у всех сотрудников с пермиссией «Просмотр и редактирование персональных данных».

Список импортовСписок импортов

В разделе Настройки → Импорт отображаются все импорты: завершенные, активные и черновики.

Для каждого импорта доступны действия:

• Поставить на паузу и возобновить активный импорт;
• Отменить запущенный импорт;
• Удалить черновик импорта;
• Скачать файл с результатами — отчет со статусом обработки строк и описанием ошибок.

Типы импортаТипы импорта

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

КлиентыКлиенты

Режим	Что происходит
Добавить новых клиентов	Новые клиенты будут добавлены, существующие останутся без изменений. ⚙️ Можно добавить клиентов в статический сегмент
Отредактировать существующих клиентов	Новые клиенты созданы не будут. ⚙️ Можно добавить клиентов в статический сегмент
Добавить и отредактировать клиентов	Новые клиенты будут созданы, существующие — обновлены. ⚙️ Можно добавить клиентов в статический сегмент
Объединить клиентов	Клиенты будут объединены по Mindbox ID
Удалить клиентов	Клиенты удаляются с проекта
Добавить и отредактировать карты и клиентов	Новые клиенты и карты создаются, существующие — обновляются. Карты привязываются к клиентам
Импорт черного списка	Добавить клиентов в черный список
Удаление из черного списка	Удалить клиентов из черного списка
Добавить клиентов в статический сегмент	Уже существующие клиенты добавляются в указанный статический сегмент
Удалить клиентов из статического сегмента	Клиенты удаляются из сегмента

Заказы и действияЗаказы и действия

Режим	Что происходит
Добавить и обновить заказы	Новые заказы создаются, существующие дополняются новым состоянием в историю
Добавить возвраты	Добавляет новое состояние к существующему заказу: указанные позиции получают статус «возвращено», остальные позиции остаются без изменений
Добавить действия	Для каждого клиента из файла создается новое действие. Существующие действия не затрагиваются

ПродуктыПродукты

Режим	Что происходит
Добавить и обновить продукты	Новые продукты создаются, существующие обновляются. Если продукт был ранее удален — восстанавливается
Удалить продукты	Продукт удаляется
Добавить и обновить категории продуктов	Новые категории создаются, существующие обновляются. Родительская категория, которой еще нет — создается
Удалить категории продуктов	Категория удаляется вместе со всеми дочерними на всех уровнях иерархии. Если категория где-то используется, удаление не выполняется
Добавить и обновить производителей	Новые производители создаются, существующие обновляются
Добавить и обновить региональные данные	Региональные данные продукта добавляются или обновляются для конкретной зоны. Если продукт или зона не найдены — создаются
Добавить продукты в статический сегмент	Продукты добавляются в указанный сегмент. Если продукт не найден в системе — создается. Если передана группа продуктов — в сегмент добавляются все продукты группы
Удалить продукты из сегмента	Продукты удаляются из сегмента

ЛояльностьЛояльность

Режим	Что происходит
Добавить и обновить дисконтные карты	Новые карты создаются и добавляются в систему, существующие обновляются
Открепить дисконтные карты	Карта открепляется от клиента
Удалить дисконтные карты	Карта удаляется из системы. Если карта еще привязана к клиенту — удаление не выполняется, сначала нужно ее открепить.
Добавить подарочные карты	Новые подарочные карты создаются в указанном пуле. По умолчанию карта создается со статусом «Неактивна» и недоступна для использования до явной активации
Удалить подарочные карты	Карта удаляется из системы
Добавить пулы подарочных карт	Новые пулы создаются. Если пул с таким системным именем уже существует — ничего не меняется. Изменить параметры существующего пула через импорт невозможно
Добавить и обновить промокоды в пулах	Новые промокоды создаются в указанном пуле, существующие — обновляются

СправочникиСправочники

Режим	Что происходит
Добавить и обновить зоны	Новые зоны создаются, существующие обновляются. Если указана родительская зона, которой нет в системе — она создается автоматически
Удалить зоны	Зона удаляется вместе со всеми дочерними на всех уровнях. Если зона используется в сегментации — удаление не выполняется.
Добавить и обновить точки контакта	Новые точки контакта создаются, существующие — обновляются
Добавить и обновить каналы	Новые каналы создаются, существующие — обновляются
Добавить точки контакта в статический сегмент	Точка контакта добавляется в указанный сегмент
Удалить точки контакта из статического сегмента	Точки контакта удаляются из статического сегмента
Добавить зоны в статический сегмент	Зона добавляется в указанный сегмент
Удалить зоны из статического сегмента	Зона удаляется из статического сегмента
Добавить персонал проекта	Новые сотрудники создаются. Обновление существующих через этот импорт невозможно — если логин или email уже занят, строка получит ошибку